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

package/dist/automation/bridge-client.js

@@ -0,0 +1,217 @@
+import { WebSocket } from 'ws';
+import { MAX_WS_MESSAGE_SIZE_BYTES } from '../constants.js';
+import { redactImagePayloadTextForLog } from '../utils/logging/log-redaction.js';
+import { formatHostForUrl } from './bridge-config.js';
+import { getRawDataByteLength, rawDataToUtf8String } from './bridge-frame.js';
+import { REDACTED_AUTOMATION_CREDENTIAL, redactAutomationLogRecord, redactKnownAutomationCredentials } from './log-redaction.js';
+import { automationMessageSchema } from './message-schema.js';
+export class AutomationBridgeClient {
+    deps;
+    pendingConnectionSocket;
+    abortedConnectionSockets = new WeakSet();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getClientUrl() {
+        const scheme = this.deps.config.useTls ? 'wss' : 'ws';
+        return `${scheme}://${formatHostForUrl(this.deps.config.clientHost)}:${this.deps.config.clientPort}`;
+    }
+    startClient() {
+        try {
+            const url = this.getClientUrl();
+            this.deps.log.info(`Connecting to Unreal Engine automation server at ${url}`);
+            this.deps.log.debug(`Negotiated protocols: ${JSON.stringify(this.deps.config.negotiatedProtocols)}`);
+            const protocols = this.deps.config.negotiatedProtocols.length === 1
+                ? this.deps.config.negotiatedProtocols[0]
+                : this.deps.config.negotiatedProtocols;
+            this.deps.log.debug(`Using WebSocket protocols arg: ${JSON.stringify(protocols)}`);
+            const headers = this.deps.config.capabilityToken
+                ? {
+                    'X-MCP-Capability': this.deps.config.capabilityToken,
+                    'X-MCP-Capability-Token': this.deps.config.capabilityToken
+                }
+                : undefined;
+            const socket = new WebSocket(url, protocols, { headers, perMessageDeflate: false });
+            this.pendingConnectionSocket = socket;
+            this.handleClientConnection(socket);
+        }
+        catch (error) {
+            const errorObj = this.redactPeerError(error);
+            this.deps.state.lastError = { message: errorObj.message, at: new Date() };
+            this.deps.log.error('Failed to create WebSocket client connection', errorObj);
+            this.deps.emit('error', Object.assign(errorObj, { port: this.deps.config.clientPort }));
+        }
+    }
+    abortPendingConnection() {
+        const socket = this.pendingConnectionSocket;
+        this.pendingConnectionSocket = undefined;
+        if (socket && socket.readyState !== WebSocket.CLOSED && socket.readyState !== WebSocket.CLOSING) {
+            this.abortedConnectionSockets.add(socket);
+            try {
+                socket.terminate();
+            }
+            catch (error) {
+                this.deps.log.debug('Failed to terminate timed-out automation bridge socket', error instanceof Error ? error : String(error));
+            }
+        }
+    }
+    send(payload) {
+        const primarySocket = this.deps.connectionManager.getPrimarySocket();
+        if (!primarySocket || primarySocket.readyState !== WebSocket.OPEN) {
+            this.deps.log.warn('Attempted to send automation message without an active primary connection');
+            return false;
+        }
+        try {
+            primarySocket.send(JSON.stringify(payload));
+            return true;
+        }
+        catch (error) {
+            this.deps.log.error('Failed to send automation message', error);
+            const errorObj = error instanceof Error ? error : new Error(String(error));
+            const primaryInfo = this.deps.connectionManager.getActiveSockets().get(primarySocket);
+            this.deps.emit('error', Object.assign(errorObj, { port: primaryInfo?.port }));
+            return false;
+        }
+    }
+    broadcast(payload) {
+        const sockets = this.deps.connectionManager.getActiveSockets();
+        if (sockets.size === 0) {
+            this.deps.log.warn('Attempted to broadcast automation message without any active connections');
+            return false;
+        }
+        let sentCount = 0;
+        for (const [socket] of sockets) {
+            if (socket.readyState !== WebSocket.OPEN) {
+                continue;
+            }
+            try {
+                socket.send(JSON.stringify(payload));
+                sentCount++;
+            }
+            catch (error) {
+                this.deps.log.error('Failed to broadcast automation message to socket', error instanceof Error ? error : String(error));
+            }
+        }
+        return sentCount > 0;
+    }
+    async handleClientConnection(socket) {
+        socket.on('open', async () => {
+            this.deps.log.info('Automation bridge client connected, starting handshake');
+            try {
+                const metadata = await this.deps.handshakeHandler.initiateHandshake(socket, this.deps.config.connectionTimeoutMs);
+                this.clearPendingConnection(socket);
+                this.recordHandshakeSuccess(socket, metadata);
+                this.installMessageHandler(socket);
+            }
+            catch (error) {
+                this.clearPendingConnection(socket);
+                const err = this.redactPeerError(error);
+                this.deps.state.lastHandshakeFailure = { reason: err.message, at: new Date() };
+                this.deps.emit('handshakeFailed', { reason: err.message, port: this.deps.config.clientPort });
+            }
+        });
+        socket.on('error', (error) => {
+            this.clearPendingConnection(socket);
+            if (this.abortedConnectionSockets.has(socket)) {
+                this.deps.log.debug('Ignoring error from aborted automation bridge socket', error);
+                return;
+            }
+            const errorObj = this.redactPeerError(error);
+            this.deps.log.error('Automation bridge client socket error', errorObj);
+            this.deps.state.lastError = { message: errorObj.message, at: new Date() };
+            this.deps.emit('error', Object.assign(errorObj, { port: this.deps.config.clientPort }));
+        });
+        socket.on('close', (code, reasonBuffer) => {
+            this.clearPendingConnection(socket);
+            this.abortedConnectionSockets.delete(socket);
+            const reason = this.redactPeerText(reasonBuffer.toString('utf8'));
+            const socketInfo = this.deps.connectionManager.removeSocket(socket);
+            if (!socketInfo) {
+                return;
+            }
+            this.deps.state.lastDisconnect = { code, reason, at: new Date() };
+            this.deps.emit('disconnected', {
+                code,
+                reason,
+                port: socketInfo.port,
+                protocol: socketInfo.protocol || null
+            });
+            this.deps.log.info(`Automation bridge client socket closed (code=${code}, reason=${reason})`);
+            if (this.deps.connectionManager.isConnected()) {
+                this.deps.rejectOwnedRequests(socketInfo.connectionId, new Error('Automation bridge primary connection lost'));
+            }
+            if (!this.deps.connectionManager.isConnected()) {
+                const error = new Error(reason || 'Connection lost');
+                this.deps.rejectQueuedRequests(error);
+                this.deps.rejectPendingRequests(error);
+            }
+        });
+    }
+    recordHandshakeSuccess(socket, metadata) {
+        this.deps.state.lastHandshakeAt = new Date();
+        this.deps.state.lastHandshakeMetadata = metadata;
+        this.deps.state.lastHandshakeFailure = undefined;
+        this.deps.connectionManager.updateLastMessageTime();
+        const socketWithInternal = socket;
+        const underlying = socketWithInternal._socket || socketWithInternal.socket;
+        this.deps.connectionManager.registerSocket(socket, this.deps.config.clientPort, metadata, underlying?.remoteAddress ?? undefined, underlying?.remotePort ?? undefined);
+        this.deps.connectionManager.startHeartbeat();
+        this.deps.emit('connected', {
+            socket,
+            metadata: redactAutomationLogRecord(metadata),
+            port: this.deps.config.clientPort,
+            protocol: socket.protocol || null
+        });
+    }
+    installMessageHandler(socket) {
+        socket.on('message', (data) => {
+            try {
+                const byteLength = getRawDataByteLength(data);
+                if (byteLength > MAX_WS_MESSAGE_SIZE_BYTES) {
+                    this.deps.log.error(`Received oversized message (${byteLength} bytes, max: ${MAX_WS_MESSAGE_SIZE_BYTES}). Dropping.`);
+                    return;
+                }
+                const text = rawDataToUtf8String(data, byteLength);
+                this.deps.log.debug(`[AutomationBridge Client] Received message: ${redactImagePayloadTextForLog(text).substring(0, 1000)}`);
+                const parsed = JSON.parse(text);
+                if (!this.deps.connectionManager.recordInboundMessage(socket, false)) {
+                    this.deps.log.warn('Inbound message rate limit exceeded; closing connection.');
+                    socket.close(4008, 'Rate limit exceeded');
+                    return;
+                }
+                const validation = automationMessageSchema.safeParse(parsed);
+                if (!validation.success) {
+                    this.deps.log.warn('Dropped invalid automation message', validation.error.issues);
+                    return;
+                }
+                this.deps.connectionManager.updateLastMessageTime();
+                this.deps.messageHandler.handleMessage(validation.data);
+                this.deps.emit('message', validation.data);
+            }
+            catch (error) {
+                this.deps.log.error('Error handling message', error instanceof Error ? error : String(error));
+            }
+        });
+    }
+    clearPendingConnection(socket) {
+        if (this.pendingConnectionSocket === socket) {
+            this.pendingConnectionSocket = undefined;
+        }
+    }
+    redactPeerText(value) {
+        const knownCredentials = this.deps.config.capabilityToken
+            ? [this.deps.config.capabilityToken]
+            : [];
+        const redacted = redactKnownAutomationCredentials(value, knownCredentials);
+        return typeof redacted === 'string'
+            ? redacted
+            : REDACTED_AUTOMATION_CREDENTIAL;
+    }
+    redactPeerError(value) {
+        const source = value instanceof Error ? value : new Error(String(value));
+        const redacted = new Error(this.redactPeerText(source.message));
+        redacted.name = source.name;
+        return redacted;
+    }
+}
+//# sourceMappingURL=bridge-client.js.map

package/dist/automation/bridge-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.js","sourceRoot":"","sources":["../../src/automation/bridge-client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+import type { Logger } from '../utils/logging/logger.js';
+import type { AutomationBridgeOptions } from './types.js';
+type BridgeConfigLogger = Pick<Logger, 'debug' | 'warn' | 'error'>;
+export interface AutomationBridgeResolvedConfig {
+    readonly host: string;
+    readonly port: number;
+    readonly ports: number[];
+    readonly negotiatedProtocols: string[];
+    readonly capabilityToken?: string;
+    readonly enabled: boolean;
+    readonly serverName: string;
+    readonly serverVersion: string;
+    readonly clientHost: string;
+    readonly clientPort: number;
+    readonly serverLegacyEnabled: boolean;
+    readonly maxConcurrentConnections: number;
+    readonly maxQueuedRequests: number;
+    readonly maxPendingRequests: number;
+    readonly useTls: boolean;
+    readonly connectionTimeoutMs: number;
+    readonly heartbeatIntervalMs: number;
+    readonly maxInboundMessagesPerMinute: number;
+    readonly maxInboundAutomationRequestsPerMinute: number;
+}
+export type BridgeFailureReason = 'connection refused' | 'timed out' | 'host unreachable' | 'tls failure' | 'handshake rejected' | 'connection lost' | 'server stopped' | 'bridge disabled' | 'unknown failure';
+export declare function describeBridgeFailure(cause: unknown): BridgeFailureReason;
+export declare function bridgeNotConnectedMessage(target?: string, reason?: BridgeFailureReason): string;
+export declare function formatHostForUrl(host: string): string;
+export declare function resolveAutomationBridgeConfig(options: AutomationBridgeOptions, log: BridgeConfigLogger): AutomationBridgeResolvedConfig;
+export {};
+//# sourceMappingURL=bridge-config.d.ts.map

package/dist/automation/bridge-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-config.d.ts","sourceRoot":"","sources":["../../src/automation/bridge-config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAI1D,KAAK,kBAAkB,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAyCnE,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,qCAAqC,EAAE,MAAM,CAAC;CAC1D;AAED,MAAM,MAAM,mBAAmB,GACzB,oBAAoB,GACpB,WAAW,GACX,kBAAkB,GAClB,aAAa,GACb,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,CAAC;AASxB,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAgCzE;AASD,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAI/F;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,kBAAkB,GACxB,8BAA8B,CAkEhC"}

package/dist/automation/bridge-config.js

@@ -0,0 +1,265 @@
+import { createRequire } from 'node:module';
+import net from 'node:net';
+import { DEFAULT_AUTOMATION_HOST, DEFAULT_AUTOMATION_PORT, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_MAX_INBOUND_AUTOMATION_REQUESTS_PER_MINUTE, DEFAULT_MAX_INBOUND_MESSAGES_PER_MINUTE, DEFAULT_MAX_PENDING_REQUESTS, DEFAULT_MAX_QUEUED_REQUESTS, DEFAULT_NEGOTIATED_PROTOCOLS } from '../constants.js';
+import { config } from '../config.js';
+import { getProjectSettingSync } from '../utils/config/ini-reader.js';
+const requirePackage = createRequire(import.meta.url);
+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 = getProjectSettingSync(projectPath, BRIDGE_SETTINGS_CATEGORY, BRIDGE_SETTINGS_SECTION, 'ListenPorts');
+        if (typeof raw !== 'string') {
+            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;
+    }
+}
+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 codeToken = code.toUpperCase();
+    if (codeToken.includes('ECONNREFUSED'))
+        return 'connection refused';
+    if (/(ETIMEDOUT|UND_ERR_CONNECT_TIMEOUT)/.test(codeToken))
+        return 'timed out';
+    if (/(ENOTFOUND|EAI_AGAIN|EHOSTUNREACH|ENETUNREACH|EADDRNOTAVAIL)/.test(codeToken))
+        return 'host unreachable';
+    if (/(ERR_TLS|CERT|SELF_SIGNED)/.test(codeToken))
+        return 'tls failure';
+    if (/(ECONNRESET|EPIPE)/.test(codeToken))
+        return 'connection lost';
+    const token = `${code} ${message}`.toUpperCase();
+    if (/BRIDGE_ACK/.test(token))
+        return 'handshake rejected';
+    if (token.includes('ECONNREFUSED'))
+        return 'connection refused';
+    if (/UNEXPECTED SERVER RESPONSE|INCORRECT STATUS CODE/.test(token))
+        return 'handshake rejected';
+    if (/SERVER STOPPED/.test(token))
+        return 'server stopped';
+    if (/\bDISABLED\b/.test(token))
+        return 'bridge disabled';
+    if (/(ETIMEDOUT|UND_ERR_CONNECT_TIMEOUT|TIMEOUT)/.test(token))
+        return 'timed out';
+    if (/(ENOTFOUND|EAI_AGAIN|EHOSTUNREACH|ENETUNREACH|EADDRNOTAVAIL)/.test(token))
+        return 'host unreachable';
+    if (/(ERR_TLS|TLS|SSL|CERT|SELF_SIGNED)/.test(token))
+        return 'tls failure';
+    if (/(ECONNRESET|EPIPE|SOCKET HANG UP|SOCKET CLOSED)/.test(token))
+        return 'connection lost';
+    if (/(HANDSHAKE|BRIDGE_ACK|INVALID_CAPABILITY_TOKEN|CAPABILITY TOKEN)/.test(token))
+        return 'handshake rejected';
+    return '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 rawHost = options.host
+        ?? process.env.MCP_AUTOMATION_WS_HOST
+        ?? process.env.MCP_AUTOMATION_HOST
+        ?? DEFAULT_AUTOMATION_HOST;
+    const host = normalizeHost(rawHost, 'Automation bridge host', allowNonLoopback, log);
+    const configuredPortList = options.ports ?? readWsPortsEnv();
+    const hasExplicitPortBypass = configuredPortList.some((value) => sanitizePort(value) !== null)
+        || sanitizePort(options.clientPort) !== null
+        || sanitizePort(process.env.MCP_AUTOMATION_CLIENT_PORT) !== null;
+    const defaultPort = sanitizePort(options.port)
+        ?? sanitizePort(process.env.MCP_AUTOMATION_WS_PORT)
+        ?? sanitizePort(process.env.MCP_AUTOMATION_PORT)
+        ?? (hasExplicitPortBypass ? null : readProjectListenPort(log))
+        ?? DEFAULT_AUTOMATION_PORT;
+    const ports = resolvePorts(options.ports, defaultPort);
+    const packageInfo = readPackageInfo(log);
+    const heartbeatIntervalMs = (options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS) > 0
+        ? (options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS)
+        : 0;
+    const rawClientHost = options.clientHost
+        ?? process.env.MCP_AUTOMATION_CLIENT_HOST
+        ?? host;
+    return {
+        host,
+        port: ports[0] ?? DEFAULT_AUTOMATION_PORT,
+        ports,
+        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 ?? packageInfo.name ?? 'unreal-engine-mcp',
+        serverVersion: options.serverVersion
+            ?? process.env.MCP_SERVER_VERSION
+            ?? packageInfo.version
+            ?? process.env.npm_package_version
+            ?? '0.0.0',
+        clientHost: normalizeHost(rawClientHost, 'Automation bridge client host', allowNonLoopback, log),
+        clientPort: sanitizePort(options.clientPort) ?? sanitizePort(process.env.MCP_AUTOMATION_CLIENT_PORT) ?? defaultPort,
+        serverLegacyEnabled: options.serverLegacyEnabled ?? process.env.MCP_AUTOMATION_SERVER_LEGACY !== 'false',
+        maxConcurrentConnections: Math.max(1, options.maxConcurrentConnections ?? 10),
+        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),
+        maxInboundAutomationRequestsPerMinute: parseNonNegativeInt(options.maxInboundAutomationRequestsPerMinute ?? process.env.MCP_AUTOMATION_MAX_AUTOMATION_REQUESTS_PER_MINUTE, DEFAULT_MAX_INBOUND_AUTOMATION_REQUESTS_PER_MINUTE)
+    };
+}
+function resolvePorts(optionPorts, defaultPort) {
+    const envPorts = readWsPortsEnv();
+    const configuredPortValues = optionPorts
+        ?? (envPorts.length > 0 ? envPorts : undefined);
+    const sanitizedPorts = Array.isArray(configuredPortValues)
+        ? configuredPortValues
+            .map((value) => sanitizePort(value))
+            .filter((port) => port !== null)
+        : [];
+    if (!sanitizedPorts.includes(defaultPort)) {
+        sanitizedPorts.unshift(defaultPort);
+    }
+    if (sanitizedPorts.length === 0) {
+        sanitizedPorts.push(DEFAULT_AUTOMATION_PORT);
+    }
+    return Array.from(new Set(sanitizedPorts));
+}
+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 readWsPortsEnv() {
+    const raw = process.env.MCP_AUTOMATION_WS_PORTS;
+    if (!raw)
+        return [];
+    return raw.split(',').map((token) => token.trim()).filter((token) => token.length > 0);
+}
+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;
+}
+function readPackageInfo(log) {
+    try {
+        const loaded = requirePackage('../../package.json');
+        return parsePackageInfo(loaded);
+    }
+    catch (error) {
+        log.debug('Unable to read package.json for version info', error instanceof Error ? error : String(error));
+        return {};
+    }
+}
+function parsePackageInfo(value) {
+    if (!value || typeof value !== 'object') {
+        return {};
+    }
+    const record = value;
+    return {
+        name: typeof record.name === 'string' ? record.name : undefined,
+        version: typeof record.version === 'string' ? record.version : undefined
+    };
+}
+//# sourceMappingURL=bridge-config.js.map

package/dist/automation/bridge-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-config.js","sourceRoot":"","sources":["../../src/automation/bridge-config.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+export declare function getRawDataByteLength(data: unknown): number;
+export declare function rawDataToUtf8String(data: unknown, byteLengthHint?: number): string;
+//# sourceMappingURL=bridge-frame.d.ts.map

package/dist/automation/bridge-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-frame.d.ts","sourceRoot":"","sources":["../../src/automation/bridge-frame.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAsB1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BlF"}

package/dist/automation/bridge-frame.js

@@ -0,0 +1,41 @@
+export function getRawDataByteLength(data) {
+    if (typeof data === 'string') {
+        return Buffer.byteLength(data, 'utf8');
+    }
+    if (Buffer.isBuffer(data)) {
+        return data.length;
+    }
+    if (Array.isArray(data)) {
+        return data.reduce((total, item) => total + (Buffer.isBuffer(item) ? item.length : 0), 0);
+    }
+    if (data instanceof ArrayBuffer) {
+        return data.byteLength;
+    }
+    if (ArrayBuffer.isView(data)) {
+        return data.byteLength;
+    }
+    return 0;
+}
+export function rawDataToUtf8String(data, byteLengthHint) {
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (Buffer.isBuffer(data)) {
+        return data.toString('utf8');
+    }
+    if (Array.isArray(data)) {
+        const buffers = data.filter((item) => Buffer.isBuffer(item));
+        const totalLength = typeof byteLengthHint === 'number'
+            ? byteLengthHint
+            : buffers.reduce((total, item) => total + item.length, 0);
+        return Buffer.concat(buffers, totalLength).toString('utf8');
+    }
+    if (data instanceof ArrayBuffer) {
+        return Buffer.from(data).toString('utf8');
+    }
+    if (ArrayBuffer.isView(data)) {
+        return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString('utf8');
+    }
+    return '';
+}
+//# sourceMappingURL=bridge-frame.js.map

package/dist/automation/bridge-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-frame.js","sourceRoot":"","sources":["../../src/automation/bridge-frame.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa,EAAE,cAAuB;IACtE,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,MAAM,WAAW,GAAG,OAAO,cAAc,KAAK,QAAQ;YAClD,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC"}