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

package/dist/automation/bridge-config.js

@@ -1,182 +0,0 @@
-import net from 'node:net';
-import { DEFAULT_AUTOMATION_HOST, DEFAULT_AUTOMATION_PORT, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_MAX_INBOUND_MESSAGES_PER_MINUTE, DEFAULT_MAX_PENDING_REQUESTS, DEFAULT_MAX_QUEUED_REQUESTS, DEFAULT_NEGOTIATED_PROTOCOLS, PACKAGE } from '../constants.js';
-import { config } from '../config.js';
-import { readProjectIniValue } from '../utils/config/ini-reader.js';
-const BRIDGE_SETTINGS_SECTION = '/Script/McpAutomationBridge.McpAutomationBridgeSettings';
-const BRIDGE_SETTINGS_CATEGORY = 'Game';
-function readProjectListenPort(log) {
-    const projectPath = process.env.UE_PROJECT_PATH;
-    if (!projectPath) {
-        return null;
-    }
-    try {
-        const raw = readProjectIniValue(projectPath, BRIDGE_SETTINGS_CATEGORY, BRIDGE_SETTINGS_SECTION, 'ListenPorts');
-        if (raw === undefined) {
-            return null;
-        }
-        const port = sanitizePort(raw.split(',')[0]?.trim());
-        if (port === null) {
-            return null;
-        }
-        log.debug(`Resolved automation bridge port ${port} from ${projectPath} ListenPorts.`);
-        return port;
-    }
-    catch {
-        return null;
-    }
-}
-const FAILURE_PATTERNS = [
-    [/BRIDGE_ACK/, 'handshake rejected'],
-    [/ECONNREFUSED/, 'connection refused'],
-    [/UNEXPECTED SERVER RESPONSE|INCORRECT STATUS CODE/, 'handshake rejected'],
-    [/SERVER STOPPED/, 'server stopped'],
-    [/\bDISABLED\b/, 'bridge disabled'],
-    [/ETIMEDOUT|UND_ERR_CONNECT_TIMEOUT|TIMEOUT/, 'timed out'],
-    [/ENOTFOUND|EAI_AGAIN|EHOSTUNREACH|ENETUNREACH|EADDRNOTAVAIL/, 'host unreachable'],
-    [/ERR_TLS|TLS|SSL|CERT|SELF_SIGNED/, 'tls failure'],
-    [/ECONNRESET|EPIPE|SOCKET HANG UP|SOCKET CLOSED/, 'connection lost'],
-    [/HANDSHAKE|INVALID_CAPABILITY_TOKEN|CAPABILITY TOKEN/, 'handshake rejected'],
-];
-export function describeBridgeFailure(cause) {
-    const code = typeof cause === 'object' && cause !== null && 'code' in cause
-        ? String(cause.code ?? '')
-        : '';
-    const message = cause instanceof Error ? cause.message : String(cause ?? '');
-    const match = (text) => FAILURE_PATTERNS.find(([pattern]) => pattern.test(text))?.[1];
-    return (code ? match(code.toUpperCase()) : undefined) ?? match(`${code} ${message}`.toUpperCase()) ?? 'unknown failure';
-}
-export function bridgeNotConnectedMessage(target, reason) {
-    const where = target ? ` at ${target}` : '';
-    const why = reason ? `: ${reason}` : '';
-    return `Automation bridge not connected${where}${why}. Ensure the Unreal Editor is running with the automation bridge listening.`;
-}
-export function formatHostForUrl(host) {
-    if (!host.includes(':')) {
-        return host;
-    }
-    const zoneIndex = host.indexOf('%');
-    const hostWithoutZone = zoneIndex >= 0 ? host.slice(0, zoneIndex) : host;
-    return `[${hostWithoutZone}]`;
-}
-export function resolveAutomationBridgeConfig(options, log) {
-    const allowNonLoopback = options.allowNonLoopback
-        ?? (process.env.MCP_AUTOMATION_ALLOW_NON_LOOPBACK?.toLowerCase() === 'true');
-    const host = normalizeHost(options.host
-        ?? process.env.MCP_AUTOMATION_CLIENT_HOST
-        ?? process.env.MCP_AUTOMATION_WS_HOST
-        ?? process.env.MCP_AUTOMATION_HOST
-        ?? DEFAULT_AUTOMATION_HOST, 'Automation bridge host', allowNonLoopback, log);
-    const port = sanitizePort(options.port)
-        ?? sanitizePort(process.env.MCP_AUTOMATION_CLIENT_PORT)
-        ?? sanitizePort(process.env.MCP_AUTOMATION_WS_PORT)
-        ?? sanitizePort(process.env.MCP_AUTOMATION_PORT)
-        ?? readProjectListenPort(log)
-        ?? DEFAULT_AUTOMATION_PORT;
-    const requestedHeartbeatMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
-    const heartbeatIntervalMs = requestedHeartbeatMs > 0 ? requestedHeartbeatMs : 0;
-    return {
-        host,
-        port,
-        negotiatedProtocols: resolveProtocols(options.protocols),
-        capabilityToken: options.capabilityToken ?? process.env.MCP_AUTOMATION_CAPABILITY_TOKEN ?? undefined,
-        enabled: options.enabled ?? process.env.MCP_AUTOMATION_BRIDGE_ENABLED !== 'false',
-        serverName: options.serverName ?? process.env.MCP_SERVER_NAME ?? PACKAGE.name,
-        serverVersion: options.serverVersion ?? process.env.MCP_SERVER_VERSION ?? PACKAGE.version,
-        maxQueuedRequests: Math.max(0, options.maxQueuedRequests ?? DEFAULT_MAX_QUEUED_REQUESTS),
-        maxPendingRequests: Math.max(1, options.maxPendingRequests ?? DEFAULT_MAX_PENDING_REQUESTS),
-        useTls: parseBoolean(options.useTls ?? process.env.MCP_AUTOMATION_USE_TLS, false),
-        connectionTimeoutMs: Math.max(1, parseNonNegativeInt(options.connectionTimeoutMs ?? config.MCP_CONNECTION_TIMEOUT_MS, config.MCP_CONNECTION_TIMEOUT_MS)),
-        heartbeatIntervalMs,
-        maxInboundMessagesPerMinute: parseNonNegativeInt(options.maxInboundMessagesPerMinute ?? process.env.MCP_AUTOMATION_MAX_MESSAGES_PER_MINUTE, DEFAULT_MAX_INBOUND_MESSAGES_PER_MINUTE)
-    };
-}
-function resolveProtocols(optionProtocols) {
-    const userProtocols = Array.isArray(optionProtocols)
-        ? optionProtocols.filter((proto) => typeof proto === 'string' && proto.trim().length > 0)
-        : [];
-    const envProtocols = process.env.MCP_AUTOMATION_WS_PROTOCOLS
-        ? process.env.MCP_AUTOMATION_WS_PROTOCOLS.split(',')
-            .map((token) => token.trim())
-            .filter((token) => token.length > 0)
-        : [];
-    return Array.from(new Set([...userProtocols, ...envProtocols, ...DEFAULT_NEGOTIATED_PROTOCOLS]));
-}
-function normalizeHost(value, label, allowNonLoopback, log) {
-    const stringValue = typeof value === 'string' ? value : value === undefined || value === null ? '' : String(value);
-    const trimmed = stringValue.trim();
-    if (trimmed.length === 0) {
-        return DEFAULT_AUTOMATION_HOST;
-    }
-    const lower = trimmed.toLowerCase();
-    if (lower === 'localhost' || lower === '127.0.0.1')
-        return '127.0.0.1';
-    if (lower === '::1' || lower === '[::1]')
-        return '::1';
-    if (allowNonLoopback) {
-        const normalizedAddress = trimIpv6Brackets(trimmed);
-        const addressWithoutZone = normalizedAddress.split('%')[0] ?? normalizedAddress;
-        const ipVersion = net.isIP(addressWithoutZone);
-        if (ipVersion === 4 || ipVersion === 6) {
-            log.warn(`SECURITY: ${label} set to non-loopback address '${trimmed}'. The automation bridge will be accessible from your local network.`);
-            return normalizedAddress;
-        }
-        if (isValidHostname(trimmed)) {
-            log.warn(`SECURITY: ${label} set to hostname '${trimmed}'. The automation bridge will be accessible from your local network.`);
-            return trimmed;
-        }
-        log.error(`${label} '${trimmed}' is not a valid IPv4/IPv6 address or hostname. Falling back to ${DEFAULT_AUTOMATION_HOST}.`);
-        return DEFAULT_AUTOMATION_HOST;
-    }
-    log.warn(`${label} '${trimmed}' is not a loopback address and MCP_AUTOMATION_ALLOW_NON_LOOPBACK is not set. Falling back to ${DEFAULT_AUTOMATION_HOST}. Set MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true for LAN access.`);
-    return DEFAULT_AUTOMATION_HOST;
-}
-function trimIpv6Brackets(value) {
-    return value.startsWith('[') && value.endsWith(']') ? value.slice(1, -1) : value;
-}
-function isValidHostname(value) {
-    if (!/[a-zA-Z]/.test(value)) {
-        return false;
-    }
-    return value
-        .split('.')
-        .every((label) => label.length > 0 && /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(label));
-}
-function sanitizePort(value) {
-    if (typeof value === 'number' && Number.isInteger(value)) {
-        return value > 0 && value <= 65535 ? value : null;
-    }
-    if (typeof value === 'string' && value.trim().length > 0) {
-        const trimmed = value.trim();
-        if (!/^\d+$/.test(trimmed))
-            return null;
-        const parsed = Number(trimmed);
-        return Number.isInteger(parsed) && parsed > 0 && parsed <= 65535 ? parsed : null;
-    }
-    return null;
-}
-function parseNonNegativeInt(value, fallback) {
-    if (typeof value === 'number' && Number.isInteger(value)) {
-        return value >= 0 ? value : fallback;
-    }
-    if (typeof value === 'string' && value.trim().length > 0) {
-        const trimmed = value.trim();
-        if (!/^\d+$/.test(trimmed))
-            return fallback;
-        const parsed = Number(trimmed);
-        return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback;
-    }
-    return fallback;
-}
-function parseBoolean(value, defaultValue) {
-    if (typeof value === 'boolean')
-        return value;
-    if (typeof value === 'string') {
-        const normalized = value.trim().toLowerCase();
-        if (normalized === 'true')
-            return true;
-        if (normalized === 'false')
-            return false;
-    }
-    return defaultValue;
-}
-//# sourceMappingURL=bridge-config.js.map

package/dist/automation/bridge-request-dispatcher.d.ts

@@ -1,28 +0,0 @@
-import type { RequestTracker } from './request-tracker.js';
-import type { AutomationBridgeMessage, AutomationBridgeResponseMessage, AutomationRequestOptions, ConnectionControlDependencies } from './types.js';
-export interface AutomationRequestDispatcherDependencies extends ConnectionControlDependencies {
-    readonly enabled: boolean;
-    readonly maxQueuedRequests: number;
-    readonly connectionTimeoutMs: number;
-    readonly requestTracker: RequestTracker;
-    readonly isConnected: () => boolean;
-    readonly send: (payload: AutomationBridgeMessage) => boolean;
-}
-export declare class AutomationRequestDispatcher {
-    private readonly deps;
-    private queuedRequestItems;
-    private readonly correlation;
-    private readonly connection;
-    constructor(deps: AutomationRequestDispatcherDependencies);
-    connect(): Promise<void>;
-    sendAutomationRequest<T = AutomationBridgeResponseMessage>(action: string, payload?: Record<string, unknown>, options?: AutomationRequestOptions): Promise<T>;
-    mcpRequestIdsForAuto(autoId: string): string[];
-    stop(reason: Error): void;
-    rejectQueuedRequests(error: Error): void;
-    rejectPendingRequests(error: Error): void;
-    cancelMcpRequest(mcpRequestId: string, reason: string): void;
-    private handleNaturalTimeout;
-    private sendRequestInternal;
-    private processRequestQueue;
-}
-//# sourceMappingURL=bridge-request-dispatcher.d.ts.map

package/dist/automation/bridge-request-dispatcher.js

@@ -1,152 +0,0 @@
-import { DEFAULT_REQUEST_TIMEOUT_MS, requestTimeoutOverrideMs } from '../config.js';
-import { bridgeNotConnectedMessage } from './bridge-config.js';
-import { McpRequestCancelledError } from './request-cancellation-error.js';
-import { ConnectionLifecycle } from './connection-lifecycle.js';
-import { RequestCorrelation } from './request-correlation.js';
-export class AutomationRequestDispatcher {
-    deps;
-    queuedRequestItems = [];
-    correlation = new RequestCorrelation();
-    connection;
-    constructor(deps) {
-        this.deps = deps;
-        this.connection = new ConnectionLifecycle({
-            enabled: deps.enabled,
-            connectionTimeoutMs: deps.connectionTimeoutMs,
-            log: deps.log,
-            startClient: deps.startClient,
-            abortPendingConnection: deps.abortPendingConnection,
-            describeTarget: deps.describeTarget,
-            once: deps.once,
-            off: deps.off
-        });
-        deps.requestTracker.setNaturalTimeoutObserver((notification) => this.handleNaturalTimeout(notification));
-    }
-    connect() {
-        return this.connection.ensureConnected();
-    }
-    async sendAutomationRequest(action, payload = {}, options = {}) {
-        if (!this.deps.isConnected()) {
-            await this.connection.ensureConnected();
-        }
-        if (!this.deps.isConnected()) {
-            throw new Error(bridgeNotConnectedMessage(this.deps.describeTarget?.()));
-        }
-        if (this.deps.requestTracker.getPendingCount() >= this.deps.requestTracker.getMaxPendingRequests()) {
-            if (this.queuedRequestItems.length >= this.deps.maxQueuedRequests) {
-                throw new Error(`Automation bridge request queue is full (max: ${this.deps.maxQueuedRequests}). Please retry later.`);
-            }
-            return new Promise((resolve, reject) => {
-                const item = {
-                    resolve: resolve,
-                    reject: reject,
-                    action,
-                    payload,
-                    options,
-                    mcpRequestId: options.mcpRequestId
-                };
-                this.queuedRequestItems.push(item);
-                this.correlation.registerQueued(options.mcpRequestId, item);
-            });
-        }
-        return this.sendRequestInternal(action, payload, options);
-    }
-    mcpRequestIdsForAuto(autoId) {
-        return this.correlation.mcpRequestIdsForAuto(autoId);
-    }
-    stop(reason) {
-        this.connection.abort(reason);
-        this.rejectQueuedRequests(reason);
-        this.deps.requestTracker.rejectAll(reason);
-        this.correlation.clear();
-    }
-    rejectQueuedRequests(error) {
-        for (const item of this.queuedRequestItems.splice(0)) {
-            item.reject(error);
-        }
-    }
-    rejectPendingRequests(error) {
-        this.deps.requestTracker.rejectAll(error);
-    }
-    cancelMcpRequest(mcpRequestId, reason) {
-        if (!mcpRequestId)
-            return;
-        const queued = this.correlation.takeQueued(mcpRequestId);
-        if (queued.length > 0) {
-            this.queuedRequestItems = this.queuedRequestItems.filter((it) => !queued.includes(it));
-            const error = new McpRequestCancelledError(`MCP request cancelled: ${reason}`, reason);
-            for (const it of queued)
-                it.reject(error);
-        }
-        this.correlation.cancel(mcpRequestId, {
-            sendFrame: (autoId) => this.deps.send({ type: 'cancel_request', requestId: autoId, reason }),
-            rejectUnderlying: (autoId) => this.deps.requestTracker.rejectRequest(autoId, new McpRequestCancelledError(`MCP request cancelled: ${reason}`, reason)),
-            log: this.deps.log
-        });
-    }
-    handleNaturalTimeout(notification) {
-        this.correlation.settle(notification.requestId);
-        try {
-            this.deps.send({ type: 'cancel_request', requestId: notification.requestId, reason: `natural timeout (${notification.kind})` });
-        }
-        catch {
-            this.deps.log.warn('Failed to deliver natural-timeout cancel_request frame to Unreal', {
-                requestId: notification.requestId,
-                kind: notification.kind
-            });
-        }
-    }
-    async sendRequestInternal(action, payload, options) {
-        const timeoutMs = options.timeoutMs ?? requestTimeoutOverrideMs() ?? DEFAULT_REQUEST_TIMEOUT_MS;
-        const hasAction = typeof payload.action === 'string' && payload.action.length > 0;
-        const hasSubAction = typeof payload.subAction === 'string' && payload.subAction.length > 0;
-        const reconciledPayload = hasSubAction && (!hasAction || payload.action !== payload.subAction)
-            ? { ...payload, action: payload.subAction }
-            : hasAction && !hasSubAction
-                ? { ...payload, subAction: payload.action }
-                : payload;
-        const { requestId, promise } = this.deps.requestTracker.createRequest({ action, payload: reconciledPayload, timeoutMs });
-        const resultPromise = promise;
-        void resultPromise
-            .then(() => this.processRequestQueue(), () => this.processRequestQueue())
-            .finally(() => this.correlation.settle(requestId))
-            .catch(() => undefined);
-        const envelope = { type: 'automation_request', requestId, action, payload: reconciledPayload };
-        if (options.correlationId !== undefined)
-            envelope.correlationId = options.correlationId;
-        if (options.consent !== undefined)
-            envelope.consent = options.consent;
-        if (options.expectedRevisions !== undefined)
-            envelope.expectedRevisions = options.expectedRevisions;
-        if (this.deps.send(envelope)) {
-            this.deps.requestTracker.updateLastRequestSentAt();
-            this.correlation.register(options.mcpRequestId, requestId);
-            return resultPromise;
-        }
-        this.deps.requestTracker.rejectRequest(requestId, new Error('Failed to send request'));
-        throw new Error('Failed to send request');
-    }
-    processRequestQueue() {
-        if (this.queuedRequestItems.length === 0)
-            return;
-        if (!this.deps.isConnected()) {
-            this.rejectQueuedRequests(new Error('Connection lost'));
-            return;
-        }
-        while (this.queuedRequestItems.length > 0 &&
-            this.deps.requestTracker.getPendingCount() < this.deps.requestTracker.getMaxPendingRequests()) {
-            const item = this.queuedRequestItems.shift();
-            if (!item)
-                continue;
-            this.correlation.detachQueued(item);
-            try {
-                const requestPromise = this.sendRequestInternal(item.action, item.payload, item.options);
-                requestPromise.then(item.resolve, item.reject);
-            }
-            catch (error) {
-                item.reject(error);
-            }
-        }
-    }
-}
-//# sourceMappingURL=bridge-request-dispatcher.js.map

package/dist/automation/bridge-state.d.ts

@@ -1,18 +0,0 @@
-export interface AutomationBridgeRuntimeState {
-    lastHandshakeAt?: Date;
-    lastHandshakeMetadata?: Record<string, unknown>;
-    lastHandshakeFailure?: {
-        reason: string;
-        at: Date;
-    };
-    lastDisconnect?: {
-        code: number;
-        reason: string;
-        at: Date;
-    };
-    lastError?: {
-        message: string;
-        at: Date;
-    };
-}
-//# sourceMappingURL=bridge-state.d.ts.map

package/dist/automation/bridge-state.js

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

package/dist/automation/bridge-status.d.ts

@@ -1,15 +0,0 @@
-import type { AutomationBridgeResolvedConfig } from './bridge-config.js';
-import type { AutomationBridgeRuntimeState } from './bridge-state.js';
-import type { ConnectionManager } from './connection-manager.js';
-import type { RequestTracker } from './request-tracker.js';
-import type { AutomationBridgeStatus } from './types.js';
-interface AutomationBridgeStatusDependencies {
-    readonly config: AutomationBridgeResolvedConfig;
-    readonly state: AutomationBridgeRuntimeState;
-    readonly connectionManager: ConnectionManager;
-    readonly requestTracker: RequestTracker;
-    readonly connected: boolean;
-}
-export declare function buildAutomationBridgeStatus(deps: AutomationBridgeStatusDependencies): AutomationBridgeStatus;
-export {};
-//# sourceMappingURL=bridge-status.d.ts.map

package/dist/automation/bridge-status.js

@@ -1,47 +0,0 @@
-export function buildAutomationBridgeStatus(deps) {
-    const socket = deps.connectionManager.getSocket();
-    const info = deps.connectionManager.getSocketInfo();
-    const connectionInfos = socket && info ? [{
-            connectionId: info.connectionId,
-            sessionId: info.sessionId ?? null,
-            remoteAddress: info.remoteAddress ?? null,
-            remotePort: info.remotePort ?? null,
-            port: info.port,
-            connectedAt: info.connectedAt.toISOString(),
-            protocol: info.protocol || null,
-            readyState: socket.readyState,
-            isPrimary: true
-        }] : [];
-    return {
-        enabled: deps.config.enabled,
-        host: deps.config.host,
-        port: deps.config.port,
-        connected: deps.connected,
-        connectedAt: connectionInfos.length > 0 ? connectionInfos[0]?.connectedAt ?? null : null,
-        activePort: connectionInfos.length > 0 ? connectionInfos[0]?.port ?? null : null,
-        negotiatedProtocol: connectionInfos.length > 0 ? connectionInfos[0]?.protocol ?? null : null,
-        supportedProtocols: [...deps.config.negotiatedProtocols],
-        capabilityTokenRequired: Boolean(deps.config.capabilityToken),
-        lastHandshakeAt: deps.state.lastHandshakeAt?.toISOString() ?? null,
-        lastHandshakeMetadata: deps.state.lastHandshakeMetadata ?? null,
-        lastHandshakeFailure: deps.state.lastHandshakeFailure
-            ? { reason: deps.state.lastHandshakeFailure.reason, at: deps.state.lastHandshakeFailure.at.toISOString() }
-            : null,
-        lastDisconnect: deps.state.lastDisconnect
-            ? { code: deps.state.lastDisconnect.code, reason: deps.state.lastDisconnect.reason, at: deps.state.lastDisconnect.at.toISOString() }
-            : null,
-        lastError: deps.state.lastError
-            ? { message: deps.state.lastError.message, at: deps.state.lastError.at.toISOString() }
-            : null,
-        lastMessageAt: deps.connectionManager.getLastMessageTime()?.toISOString() ?? null,
-        lastRequestSentAt: deps.requestTracker.getLastRequestSentAt()?.toISOString() ?? null,
-        pendingRequests: deps.requestTracker.getPendingCount(),
-        pendingRequestDetails: deps.requestTracker.getPendingDetails(),
-        connections: connectionInfos,
-        serverName: deps.config.serverName,
-        serverVersion: deps.config.serverVersion,
-        maxPendingRequests: deps.requestTracker.getMaxPendingRequests(),
-        heartbeatIntervalMs: deps.connectionManager.getHeartbeatIntervalMs()
-    };
-}
-//# sourceMappingURL=bridge-status.js.map

package/dist/automation/bridge.d.ts

@@ -1,48 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { type BridgeAuthority } from './message-schema.js';
-import type { ExpectedRevisions } from '../tools/catalog/capabilities/semantic/execution-options.js';
-import type { AutomationBridgeEvents, AutomationBridgeMessage, AutomationBridgeOptions, AutomationBridgeResponseMessage, AutomationBridgeStatus, AutomationProgressListener, AutomationProgressUpdate } from './types.js';
-export declare class AutomationBridge extends EventEmitter {
-    private readonly config;
-    private readonly state;
-    private readonly connectionManager;
-    private readonly requestTracker;
-    private readonly capabilityTokenProvider;
-    private readonly handshakeHandler;
-    private readonly messageHandler;
-    private readonly client;
-    private readonly requestDispatcher;
-    private readonly log;
-    private progressListener;
-    private cancelledListener;
-    constructor(options?: AutomationBridgeOptions);
-    on<K extends keyof AutomationBridgeEvents>(event: K, listener: AutomationBridgeEvents[K]): this;
-    once<K extends keyof AutomationBridgeEvents>(event: K, listener: AutomationBridgeEvents[K]): this;
-    off<K extends keyof AutomationBridgeEvents>(event: K, listener: AutomationBridgeEvents[K]): this;
-    start(): void;
-    setRequestProgressListener(listener: AutomationProgressListener | undefined): void;
-    reportRequestProgress(mcpRequestId: string, update: AutomationProgressUpdate): void;
-    setRequestCancelledListener(listener: ((mcpRequestId: string) => void) | undefined): void;
-    private forwardAutomationProgress;
-    stop(): void;
-    connect(): Promise<boolean>;
-    isConnected(): boolean;
-    getStatus(): AutomationBridgeStatus;
-    getClientUrl(): string;
-    getAuthority(): BridgeAuthority | undefined;
-    getVersionMismatch(): string | undefined;
-    sendAutomationRequest<T = AutomationBridgeResponseMessage>(action: string, payload?: Record<string, unknown>, options?: {
-        timeoutMs?: number;
-        mcpRequestId?: string;
-        correlationId?: string;
-        consent?: {
-            capability: string;
-            acknowledge: 'explicit' | 'elevated';
-        };
-        expectedRevisions?: ExpectedRevisions;
-    }): Promise<T>;
-    cancelMcpRequest(requestId: string, reason: string): void;
-    send(payload: AutomationBridgeMessage): boolean;
-    private emitAutomation;
-}
-//# sourceMappingURL=bridge.d.ts.map

package/dist/automation/bridge.js

@@ -1,152 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { AutomationBridgeClient } from './bridge-client.js';
-import { resolveAutomationBridgeConfig } from './bridge-config.js';
-import { AutomationRequestDispatcher } from './bridge-request-dispatcher.js';
-import { buildAutomationBridgeStatus } from './bridge-status.js';
-import { CapabilityTokenProvider } from './capability-token-provider.js';
-import { ConnectionManager } from './connection-manager.js';
-import { HandshakeHandler } from './handshake.js';
-import { AutomationLogger } from './log-redaction.js';
-import { CONTENT_ROOTS_CHANGED_EVENT, pluginVersionMismatch, readBridgeAuthority, readContentRoots } from './message-schema.js';
-import { MessageHandler } from './message-handler.js';
-import { RequestTracker } from './request-tracker.js';
-import { clearEditorContentRoots, setEditorContentRoots } from '../utils/paths/path-security.js';
-export class AutomationBridge extends EventEmitter {
-    config;
-    state = {};
-    connectionManager;
-    requestTracker;
-    capabilityTokenProvider;
-    handshakeHandler;
-    messageHandler;
-    client;
-    requestDispatcher;
-    log = new AutomationLogger('AutomationBridge');
-    progressListener;
-    cancelledListener;
-    constructor(options = {}) {
-        super();
-        this.config = resolveAutomationBridgeConfig(options, this.log);
-        this.connectionManager = new ConnectionManager(this.config.heartbeatIntervalMs, this.config.maxInboundMessagesPerMinute);
-        this.requestTracker = new RequestTracker(this.config.maxPendingRequests);
-        this.capabilityTokenProvider = new CapabilityTokenProvider(this.config.capabilityToken, this.log);
-        this.handshakeHandler = new HandshakeHandler(this.config.capabilityToken, () => this.capabilityTokenProvider.resolve());
-        this.messageHandler = new MessageHandler(this.requestTracker, (event) => {
-            if (event.event === CONTENT_ROOTS_CHANGED_EVENT) {
-                setEditorContentRoots(readContentRoots(event.payload));
-                return;
-            }
-            this.emitAutomation('automationEvent', event);
-        }, (autoId, update) => this.forwardAutomationProgress(autoId, update));
-        this.client = new AutomationBridgeClient({
-            config: this.config,
-            state: this.state,
-            connectionManager: this.connectionManager,
-            handshakeHandler: this.handshakeHandler,
-            messageHandler: this.messageHandler,
-            log: this.log,
-            emit: (event, ...args) => this.emitAutomation(event, ...args),
-            rejectQueuedRequests: (error) => this.requestDispatcher.rejectQueuedRequests(error),
-            rejectPendingRequests: (error) => this.requestDispatcher.rejectPendingRequests(error)
-        });
-        this.requestDispatcher = new AutomationRequestDispatcher({
-            enabled: this.config.enabled,
-            maxQueuedRequests: this.config.maxQueuedRequests,
-            connectionTimeoutMs: this.config.connectionTimeoutMs,
-            requestTracker: this.requestTracker,
-            log: this.log,
-            isConnected: () => this.isConnected(),
-            send: (payload) => this.client.send(payload),
-            startClient: () => this.client.startClient(),
-            abortPendingConnection: () => this.client.abortPendingConnection(),
-            describeTarget: () => this.getClientUrl(),
-            once: (event, listener) => {
-                this.once(event, listener);
-            },
-            off: (event, listener) => {
-                this.off(event, listener);
-            }
-        });
-    }
-    on(event, listener) {
-        return super.on(event, listener);
-    }
-    once(event, listener) {
-        return super.once(event, listener);
-    }
-    off(event, listener) {
-        return super.off(event, listener);
-    }
-    start() {
-        if (!this.config.enabled) {
-            this.log.info('Automation bridge disabled by configuration.');
-            return;
-        }
-        this.log.info(`Automation bridge connecting to Unreal server at ${this.getClientUrl()}`);
-        this.client.startClient();
-    }
-    setRequestProgressListener(listener) {
-        this.progressListener = listener;
-    }
-    reportRequestProgress(mcpRequestId, update) {
-        if (!mcpRequestId)
-            return;
-        this.progressListener?.(mcpRequestId, update);
-    }
-    setRequestCancelledListener(listener) {
-        this.cancelledListener = listener;
-    }
-    forwardAutomationProgress(autoId, update) {
-        for (const mcpRequestId of this.requestDispatcher.mcpRequestIdsForAuto(autoId)) {
-            this.reportRequestProgress(mcpRequestId, update);
-        }
-    }
-    stop() {
-        const stopError = new Error('Automation bridge server stopped');
-        this.requestDispatcher.stop(stopError);
-        this.connectionManager.close(1001, 'Server shutdown');
-        clearEditorContentRoots();
-    }
-    async connect() {
-        if (!this.isConnected()) {
-            await this.requestDispatcher.connect().catch(() => undefined);
-        }
-        return this.isConnected();
-    }
-    isConnected() {
-        return this.connectionManager.isConnected();
-    }
-    getStatus() {
-        return buildAutomationBridgeStatus({
-            config: this.config,
-            state: this.state,
-            connectionManager: this.connectionManager,
-            requestTracker: this.requestTracker,
-            connected: this.isConnected()
-        });
-    }
-    getClientUrl() {
-        return this.client.getClientUrl();
-    }
-    getAuthority() {
-        return readBridgeAuthority(this.state.lastHandshakeMetadata);
-    }
-    getVersionMismatch() {
-        return this.isConnected() ? pluginVersionMismatch(this.state.lastHandshakeMetadata) : undefined;
-    }
-    async sendAutomationRequest(action, payload = {}, options = {}) {
-        return this.requestDispatcher.sendAutomationRequest(action, payload, options);
-    }
-    cancelMcpRequest(requestId, reason) {
-        this.requestDispatcher.cancelMcpRequest(requestId, reason);
-        if (requestId)
-            this.cancelledListener?.(requestId);
-    }
-    send(payload) {
-        return this.client.send(payload);
-    }
-    emitAutomation(event, ...args) {
-        this.emit(event, ...args);
-    }
-}
-//# sourceMappingURL=bridge.js.map

package/dist/automation/capability-token-provider.d.ts

@@ -1,11 +0,0 @@
-import type { Logger } from '../utils/logging/logger.js';
-export declare class CapabilityTokenProvider {
-    private readonly explicitToken;
-    private readonly log;
-    private warnedAboutMissingProjectPath;
-    private warnedAboutFileIssue;
-    constructor(explicitToken: string | undefined, log: Logger);
-    resolve(): Promise<string | undefined>;
-    private resolveFromFile;
-}
-//# sourceMappingURL=capability-token-provider.d.ts.map