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

package/dist/automation/capability-token-provider.js

@@ -1,62 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { projectRootFromEnv } from '../utils/config/ini-reader.js';
-export class CapabilityTokenProvider {
-    explicitToken;
-    log;
-    warnedAboutMissingProjectPath = false;
-    warnedAboutFileIssue = false;
-    constructor(explicitToken, log) {
-        this.explicitToken = explicitToken;
-        this.log = log;
-    }
-    async resolve() {
-        if (this.explicitToken !== undefined && this.explicitToken.length > 0) {
-            return this.explicitToken;
-        }
-        const envToken = process.env.MCP_AUTOMATION_CAPABILITY_TOKEN;
-        if (envToken !== undefined && envToken.length > 0) {
-            return envToken;
-        }
-        return this.resolveFromFile();
-    }
-    async resolveFromFile() {
-        const projectRoot = projectRootFromEnv();
-        if (projectRoot === undefined) {
-            if (!this.warnedAboutMissingProjectPath) {
-                this.warnedAboutMissingProjectPath = true;
-                this.log.warn('[CapabilityTokenProvider] UE_PROJECT_PATH is not set; cannot locate the capability-token file. If the plugin requires a capability token (default), the handshake will be refused.');
-            }
-            return undefined;
-        }
-        const filePath = join(projectRoot, 'Saved', 'MCP', 'capability-token');
-        let content;
-        try {
-            content = await readFile(filePath, { encoding: 'utf8' });
-        }
-        catch {
-            if (!this.warnedAboutFileIssue) {
-                this.warnedAboutFileIssue = true;
-                this.log.warn(`[CapabilityTokenProvider] Token file not readable: ${filePath}`);
-            }
-            return undefined;
-        }
-        const trimmed = content.toLowerCase().trim();
-        if (trimmed.length === 0) {
-            if (!this.warnedAboutFileIssue) {
-                this.warnedAboutFileIssue = true;
-                this.log.warn(`[CapabilityTokenProvider] Token file is empty: ${filePath}`);
-            }
-            return undefined;
-        }
-        if (!/^[0-9a-f]{64}$/.test(trimmed)) {
-            if (!this.warnedAboutFileIssue) {
-                this.warnedAboutFileIssue = true;
-                this.log.warn(`[CapabilityTokenProvider] Token file has invalid format (expected 64 lowercase hex chars): ${filePath}`);
-            }
-            return undefined;
-        }
-        return trimmed;
-    }
-}
-//# sourceMappingURL=capability-token-provider.js.map

package/dist/automation/connection-lifecycle.d.ts

@@ -1,19 +0,0 @@
-import type { ConnectionControlDependencies } from './types.js';
-export interface ConnectionLifecycleDependencies extends ConnectionControlDependencies {
-    readonly enabled: boolean;
-    readonly connectionTimeoutMs: number;
-}
-export declare class ConnectionLifecycle {
-    private readonly deps;
-    private connectionPromise?;
-    private connectionLock;
-    private connectionAttemptCleanup?;
-    private connectionAttemptReject?;
-    private connectionAttemptSettled;
-    constructor(deps: ConnectionLifecycleDependencies);
-    ensureConnected(): Promise<void>;
-    abort(reason: Error): void;
-    private createConnectionPromise;
-    private waitForConnection;
-}
-//# sourceMappingURL=connection-lifecycle.d.ts.map

package/dist/automation/connection-lifecycle.js

@@ -1,109 +0,0 @@
-import { bridgeNotConnectedMessage, describeBridgeFailure } from './bridge-config.js';
-export class ConnectionLifecycle {
-    deps;
-    connectionPromise;
-    connectionLock = false;
-    connectionAttemptCleanup;
-    connectionAttemptReject;
-    connectionAttemptSettled = false;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async ensureConnected() {
-        if (!this.deps.enabled) {
-            throw new Error('Automation bridge disabled');
-        }
-        this.deps.log.info('Automation bridge not connected, attempting lazy connection...');
-        let attempt = this.connectionPromise;
-        if (!attempt && !this.connectionLock) {
-            this.connectionLock = true;
-            this.connectionAttemptSettled = false;
-            attempt = this.createConnectionPromise();
-            if (!this.connectionAttemptSettled)
-                this.connectionPromise = attempt;
-        }
-        try {
-            await this.waitForConnection(attempt);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            if (message === 'Lazy connection timeout') {
-                this.abort(new Error('Lazy connection timeout'));
-            }
-            this.deps.log.error('Lazy connection failed', error);
-            throw new Error(bridgeNotConnectedMessage(this.deps.describeTarget?.(), describeBridgeFailure(error)));
-        }
-    }
-    abort(reason) {
-        const rejectConnectionAttempt = this.connectionAttemptReject;
-        const cleanup = this.connectionAttemptCleanup;
-        if (cleanup) {
-            cleanup();
-        }
-        else {
-            this.connectionLock = false;
-            this.connectionPromise = undefined;
-            this.connectionAttemptReject = undefined;
-        }
-        if (rejectConnectionAttempt) {
-            rejectConnectionAttempt(reason);
-        }
-        this.deps.abortPendingConnection(reason);
-    }
-    createConnectionPromise() {
-        return new Promise((resolve, reject) => {
-            const onConnect = () => {
-                cleanup();
-                resolve();
-            };
-            const onError = (error) => {
-                cleanup();
-                reject(error);
-            };
-            const onHandshakeFail = (info) => {
-                cleanup();
-                reject(new Error(`Handshake failed: ${String(info.reason)}`));
-            };
-            const cleanup = () => {
-                this.deps.off('connected', onConnect);
-                this.deps.off('error', onError);
-                this.deps.off('handshakeFailed', onHandshakeFail);
-                this.connectionAttemptSettled = true;
-                this.connectionLock = false;
-                this.connectionPromise = undefined;
-                if (this.connectionAttemptCleanup === cleanup) {
-                    this.connectionAttemptCleanup = undefined;
-                    this.connectionAttemptReject = undefined;
-                }
-            };
-            this.connectionAttemptCleanup = cleanup;
-            this.connectionAttemptReject = reject;
-            this.deps.once('connected', onConnect);
-            this.deps.once('error', onError);
-            this.deps.once('handshakeFailed', onHandshakeFail);
-            try {
-                this.deps.startClient();
-            }
-            catch (error) {
-                onError(error instanceof Error ? error : new Error(String(error)));
-            }
-        });
-    }
-    async waitForConnection(attempt) {
-        if (!attempt) {
-            throw new Error('No connection attempt in flight');
-        }
-        let timeoutId;
-        const timeoutPromise = new Promise((_, reject) => {
-            timeoutId = setTimeout(() => reject(new Error('Lazy connection timeout')), this.deps.connectionTimeoutMs);
-        });
-        try {
-            await Promise.race([attempt, timeoutPromise]);
-        }
-        finally {
-            if (timeoutId)
-                clearTimeout(timeoutId);
-        }
-    }
-}
-//# sourceMappingURL=connection-lifecycle.js.map

package/dist/automation/connection-manager.d.ts

@@ -1,40 +0,0 @@
-import { EventEmitter } from 'node:events';
-import type { SocketInfo } from './types.js';
-type AutomationSocketListener = (() => void) | ((data: Buffer | string) => void) | ((error: Error) => void);
-export interface AutomationSocket {
-    readonly protocol: string;
-    readonly readyState: number;
-    ping(): void;
-    send(data: string): void;
-    close(code?: number, data?: string): void;
-    removeAllListeners(): this;
-    on(eventName: string | symbol, listener: AutomationSocketListener): this;
-    once(eventName: string | symbol, listener: AutomationSocketListener): this;
-    off(eventName: string | symbol, listener: AutomationSocketListener): this;
-}
-export declare class ConnectionManager extends EventEmitter {
-    private heartbeatIntervalMs;
-    private maxMessagesPerMinute;
-    private socket?;
-    private info?;
-    private heartbeatTimer?;
-    private lastMessageAt?;
-    private log;
-    private rateWindowStartMs;
-    private rateMessageCount;
-    constructor(heartbeatIntervalMs: number, maxMessagesPerMinute: number);
-    getHeartbeatIntervalMs(): number;
-    registerSocket(socket: AutomationSocket, port: number, metadata?: Record<string, unknown>, remoteAddress?: string, remotePort?: number): void;
-    removeSocket(socket: AutomationSocket): SocketInfo | undefined;
-    recordInboundMessage(socket: AutomationSocket): boolean;
-    getSocket(): AutomationSocket | undefined;
-    getSocketInfo(): SocketInfo | undefined;
-    isConnected(): boolean;
-    startHeartbeat(): void;
-    stopHeartbeat(): void;
-    updateLastMessageTime(): void;
-    getLastMessageTime(): Date | undefined;
-    close(code?: number, reason?: string): void;
-}
-export {};
-//# sourceMappingURL=connection-manager.d.ts.map

package/dist/automation/connection-manager.js

@@ -1,127 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { EventEmitter } from 'node:events';
-import { WebSocket } from 'ws';
-import { AutomationLogger } from './log-redaction.js';
-const RATE_LIMIT_WINDOW_MS = 60_000;
-export class ConnectionManager extends EventEmitter {
-    heartbeatIntervalMs;
-    maxMessagesPerMinute;
-    socket;
-    info;
-    heartbeatTimer;
-    lastMessageAt;
-    log = new AutomationLogger('ConnectionManager');
-    rateWindowStartMs = 0;
-    rateMessageCount = 0;
-    constructor(heartbeatIntervalMs, maxMessagesPerMinute) {
-        super();
-        this.heartbeatIntervalMs = heartbeatIntervalMs;
-        this.maxMessagesPerMinute = maxMessagesPerMinute;
-    }
-    getHeartbeatIntervalMs() {
-        return this.heartbeatIntervalMs;
-    }
-    registerSocket(socket, port, metadata, remoteAddress, remotePort) {
-        this.socket = socket;
-        this.info = {
-            connectionId: randomUUID(),
-            port,
-            connectedAt: new Date(),
-            protocol: socket.protocol || undefined,
-            sessionId: metadata && typeof metadata.sessionId === 'string' ? metadata.sessionId : undefined,
-            remoteAddress: remoteAddress ?? undefined,
-            remotePort: typeof remotePort === 'number' ? remotePort : undefined
-        };
-        this.rateWindowStartMs = Date.now();
-        this.rateMessageCount = 0;
-        socket.on('pong', () => {
-            this.lastMessageAt = new Date();
-        });
-        socket.once('close', () => {
-            this.removeSocket(socket);
-        });
-        socket.once('error', (error) => {
-            this.log.error('Socket error in ConnectionManager', error);
-            this.removeSocket(socket);
-        });
-    }
-    removeSocket(socket) {
-        if (socket !== this.socket)
-            return undefined;
-        const info = this.info;
-        this.socket = undefined;
-        this.info = undefined;
-        this.stopHeartbeat();
-        return info;
-    }
-    recordInboundMessage(socket) {
-        if (socket !== this.socket)
-            return false;
-        if (this.maxMessagesPerMinute <= 0)
-            return true;
-        const nowMs = Date.now();
-        if (nowMs - this.rateWindowStartMs >= RATE_LIMIT_WINDOW_MS) {
-            this.rateWindowStartMs = nowMs;
-            this.rateMessageCount = 0;
-        }
-        this.rateMessageCount += 1;
-        if (this.rateMessageCount > this.maxMessagesPerMinute) {
-            this.log.warn(`Inbound message rate exceeded (${this.rateMessageCount}/${this.maxMessagesPerMinute} per minute).`);
-            return false;
-        }
-        return true;
-    }
-    getSocket() {
-        return this.socket;
-    }
-    getSocketInfo() {
-        return this.info;
-    }
-    isConnected() {
-        return this.socket !== undefined;
-    }
-    startHeartbeat() {
-        if (this.heartbeatIntervalMs <= 0)
-            return;
-        if (this.heartbeatTimer)
-            clearInterval(this.heartbeatTimer);
-        this.heartbeatTimer = setInterval(() => {
-            const socket = this.socket;
-            if (!socket) {
-                this.stopHeartbeat();
-                return;
-            }
-            if (socket.readyState !== WebSocket.OPEN)
-                return;
-            try {
-                socket.ping();
-            }
-            catch (error) {
-                this.log.error('Failed to send heartbeat', error instanceof Error ? error : String(error));
-            }
-        }, this.heartbeatIntervalMs);
-    }
-    stopHeartbeat() {
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = undefined;
-        }
-    }
-    updateLastMessageTime() {
-        this.lastMessageAt = new Date();
-    }
-    getLastMessageTime() {
-        return this.lastMessageAt;
-    }
-    close(code, reason) {
-        this.stopHeartbeat();
-        const socket = this.socket;
-        this.socket = undefined;
-        this.info = undefined;
-        if (socket) {
-            socket.removeAllListeners();
-            socket.close(code, reason);
-        }
-    }
-}
-//# sourceMappingURL=connection-manager.js.map

package/dist/automation/diagnostics-snapshot-reader.d.ts

@@ -1,76 +0,0 @@
-import { z } from 'zod';
-import type { Logger } from '../utils/logging/logger.js';
-export declare const MAX_SNAPSHOT_BYTES: number;
-export declare const SNAPSHOT_SCHEMA_VERSION = 1;
-declare const SnapshotSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    instance: z.ZodObject<{
-        instanceId: z.ZodString;
-        pid: z.ZodNumber;
-        startTimeUtc: z.ZodString;
-    }, z.core.$strip>;
-    counters: z.ZodObject<{
-        requests: z.ZodNumber;
-        failures: z.ZodNumber;
-        refusals: z.ZodNumber;
-        queueWaitMs: z.ZodNumber;
-    }, z.core.$strip>;
-    lastRequest: z.ZodObject<{
-        requestId: z.ZodNullable<z.ZodString>;
-        correlationId: z.ZodNullable<z.ZodString>;
-        canonicalAction: z.ZodNullable<z.ZodString>;
-        origin: z.ZodNullable<z.ZodString>;
-        queueDepth: z.ZodNumber;
-        enqueueAt: z.ZodNullable<z.ZodString>;
-        dispatchAt: z.ZodNullable<z.ZodString>;
-        terminalAt: z.ZodNullable<z.ZodString>;
-        terminalClass: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
-    lastHandshake: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        at: z.ZodNullable<z.ZodString>;
-        ok: z.ZodBoolean;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        at: string | null;
-        ok: boolean;
-    } | null, {
-        at: string | null;
-        ok: boolean;
-    } | null | undefined>>;
-    lastDisconnect: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        at: z.ZodNullable<z.ZodString>;
-        reason: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        at: string | null;
-        reason: string | null;
-    } | null, {
-        at: string | null;
-        reason: string | null;
-    } | null | undefined>>;
-    session: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        created: z.ZodNumber;
-        closed: z.ZodNumber;
-        active: z.ZodNumber;
-        lastIdentitySha256: z.ZodNullable<z.ZodString>;
-        at: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        created: number;
-        closed: number;
-        active: number;
-        lastIdentitySha256: string | null;
-        at: string | null;
-    } | null, {
-        created: number;
-        closed: number;
-        active: number;
-        lastIdentitySha256: string | null;
-        at: string | null;
-    } | null | undefined>>;
-}, z.core.$strip>;
-export type DiagnosticsSnapshotSummary = z.output<typeof SnapshotSchema>;
-export interface DiagnosticsSnapshotsResult {
-    current: DiagnosticsSnapshotSummary | null;
-    previous: DiagnosticsSnapshotSummary | null;
-}
-export declare function readDiagnosticsSnapshots(log: Logger): Promise<DiagnosticsSnapshotsResult>;
-export {};
-//# sourceMappingURL=diagnostics-snapshot-reader.d.ts.map

package/dist/automation/diagnostics-snapshot-reader.js

@@ -1,86 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { z } from 'zod';
-import { projectRootFromEnv } from '../utils/config/ini-reader.js';
-export const MAX_SNAPSHOT_BYTES = 64 * 1024;
-export const SNAPSHOT_SCHEMA_VERSION = 1;
-const nullableString = z.string().nullable();
-const count = z.number();
-const SnapshotSchema = z.object({
-    schemaVersion: z.literal(SNAPSHOT_SCHEMA_VERSION),
-    instance: z.object({ instanceId: z.string(), pid: count, startTimeUtc: z.string() }),
-    counters: z.object({ requests: count, failures: count, refusals: count, queueWaitMs: count }),
-    lastRequest: z.object({
-        requestId: nullableString,
-        correlationId: nullableString,
-        canonicalAction: nullableString,
-        origin: nullableString,
-        queueDepth: count,
-        enqueueAt: nullableString,
-        dispatchAt: nullableString,
-        terminalAt: nullableString,
-        terminalClass: nullableString,
-    }),
-    lastHandshake: z.object({ at: nullableString, ok: z.boolean() }).nullish().transform((v) => v ?? null),
-    lastDisconnect: z.object({ at: nullableString, reason: nullableString }).nullish().transform((v) => v ?? null),
-    session: z.object({
-        created: count,
-        closed: count,
-        active: count,
-        lastIdentitySha256: nullableString,
-        at: nullableString,
-    }).nullish().transform((v) => v ?? null),
-});
-const warnedFor = new Set();
-function warnOnce(log, fileName, reason, filePath) {
-    const key = `${fileName}:${reason}`;
-    if (warnedFor.has(key)) {
-        return;
-    }
-    warnedFor.add(key);
-    log.warn(`[DiagnosticsSnapshotReader] Ignoring ${reason} diagnostics snapshot: ${filePath}`);
-}
-async function readSnapshotFile(log, fileName, dir) {
-    const filePath = join(dir, fileName);
-    let content;
-    try {
-        content = await readFile(filePath, { encoding: 'utf8' });
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT') {
-            warnOnce(log, fileName, 'unreadable', filePath);
-        }
-        return null;
-    }
-    if (Buffer.byteLength(content, 'utf8') > MAX_SNAPSHOT_BYTES) {
-        warnOnce(log, fileName, 'oversized', filePath);
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch {
-        warnOnce(log, fileName, 'corrupt', filePath);
-        return null;
-    }
-    const summary = SnapshotSchema.safeParse(parsed);
-    if (!summary.success) {
-        warnOnce(log, fileName, 'corrupt', filePath);
-        return null;
-    }
-    return summary.data;
-}
-export async function readDiagnosticsSnapshots(log) {
-    const projectRoot = projectRootFromEnv();
-    if (projectRoot === undefined) {
-        return { current: null, previous: null };
-    }
-    const dir = join(projectRoot, 'Saved', 'MCP', 'diagnostics');
-    const [current, previous] = await Promise.all([
-        readSnapshotFile(log, 'current-session.json', dir),
-        readSnapshotFile(log, 'previous-session.json', dir)
-    ]);
-    return { current, previous };
-}
-//# sourceMappingURL=diagnostics-snapshot-reader.js.map

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

@@ -1,9 +0,0 @@
-import { AutomationRequestDispatcher, type AutomationRequestDispatcherDependencies } from './bridge-request-dispatcher.js';
-import type { RequestTracker } from './request-tracker.js';
-export declare function createDispatcher(tracker: RequestTracker, overrides?: Partial<AutomationRequestDispatcherDependencies>): {
-    dispatcher: AutomationRequestDispatcher;
-    sent: Record<string, unknown>[];
-};
-export declare const automationRequests: (sent: Array<Record<string, unknown>>) => Record<string, unknown>[];
-export declare const cancelRequests: (sent: Array<Record<string, unknown>>) => Record<string, unknown>[];
-//# sourceMappingURL=dispatcher.test-support.d.ts.map

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

@@ -1,26 +0,0 @@
-import { Logger } from '../utils/logging/logger.js';
-import { AutomationRequestDispatcher, } from './bridge-request-dispatcher.js';
-export function createDispatcher(tracker, overrides = {}) {
-    const sent = [];
-    const deps = {
-        enabled: true,
-        maxQueuedRequests: 5,
-        connectionTimeoutMs: 1000,
-        requestTracker: tracker,
-        log: new Logger('test'),
-        isConnected: () => true,
-        send: (payload) => {
-            sent.push(payload);
-            return true;
-        },
-        startClient: () => { },
-        abortPendingConnection: () => { },
-        once: () => { },
-        off: () => { },
-        ...overrides,
-    };
-    return { dispatcher: new AutomationRequestDispatcher(deps), sent };
-}
-export const automationRequests = (sent) => sent.filter((m) => m.type === 'automation_request');
-export const cancelRequests = (sent) => sent.filter((m) => m.type === 'cancel_request');
-//# sourceMappingURL=dispatcher.test-support.js.map

package/dist/automation/handshake.d.ts

@@ -1,11 +0,0 @@
-import type { AutomationSocket } from './connection-manager.js';
-export declare class HandshakeHandler {
-    private readonly capabilityToken?;
-    private readonly resolveToken?;
-    private log;
-    private readonly DEFAULT_HANDSHAKE_TIMEOUT_MS;
-    constructor(capabilityToken?: string | undefined, resolveToken?: (() => Promise<string | undefined>) | undefined);
-    initiateHandshake(socket: AutomationSocket, timeoutMs?: number, onAcknowledged?: (metadata: Record<string, unknown>) => void): Promise<Record<string, unknown>>;
-    private sanitizeHandshakeMetadata;
-}
-//# sourceMappingURL=handshake.d.ts.map