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

package/dist/gateway/gateway-manifest.js

@@ -1,19 +0,0 @@
-import gatewayManifest from './gateway-manifest.generated.json' with { type: 'json' };
-import { GatewayManifestSchema } from './gateway-manifest-types.js';
-const manifest = GatewayManifestSchema.parse(gatewayManifest);
-export function getGatewayManifest() {
-    return manifest;
-}
-export function getGatewayManifestTools() {
-    return manifest.tools;
-}
-export function getManifestToolDefinitions() {
-    return manifest.tools.map((tool) => ({
-        name: tool.name,
-        category: tool.category ?? undefined,
-        description: tool.description,
-        inputSchema: tool.inputSchema,
-        actions: tool.actions,
-    }));
-}
-//# sourceMappingURL=gateway-manifest.js.map

package/dist/handlers/resource-handlers.d.ts

@@ -1,46 +0,0 @@
-import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { AssetResources } from '../resources/assets.js';
-import { HealthMonitor } from '../services/health-monitor.js';
-import type { AutomationRequestBridge, AutomationStatusBridge } from '../types/tools/tool-interfaces.js';
-import { ResourceReadRouter } from '../resources/resource-read-router.js';
-import { type ResourceDefinition, type ResourceTemplateDefinition } from '../resources/resource-catalog.js';
-interface ResourceBridge {
-    readonly isConnected: boolean;
-    getEngineVersion(): Promise<unknown>;
-    getFeatureFlags(): unknown;
-}
-export type ResourceServer = {
-    setRequestHandler(schema: typeof ReadResourceRequestSchema, handler: (request: {
-        params: {
-            uri: string;
-        };
-    }) => Promise<{
-        contents: Array<{
-            uri: string;
-            mimeType: string;
-            text: string;
-        }>;
-    }>): void;
-    setRequestHandler(schema: typeof ListResourcesRequestSchema, handler: () => Promise<{
-        resources: ResourceDefinition[];
-    }>): void;
-    setRequestHandler(schema: typeof ListResourceTemplatesRequestSchema, handler: () => Promise<{
-        resourceTemplates: ResourceTemplateDefinition[];
-    }>): void;
-};
-export declare class ResourceHandler {
-    private server;
-    private bridge;
-    private automationBridge;
-    private assetResources;
-    private healthMonitor;
-    private ensureConnected;
-    private router;
-    constructor(server: ResourceServer, bridge: ResourceBridge, automationBridge: AutomationStatusBridge & AutomationRequestBridge, assetResources: AssetResources, healthMonitor: HealthMonitor, ensureConnected: () => Promise<boolean>, router?: ResourceReadRouter);
-    registerHandlers(): void;
-    private whenConnected;
-    private health;
-    private bridgeStatus;
-}
-export {};
-//# sourceMappingURL=resource-handlers.d.ts.map

package/dist/handlers/resource-handlers.js

@@ -1,177 +0,0 @@
-import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { readDiagnosticsSnapshots } from '../automation/diagnostics-snapshot-reader.js';
-import { AutomationLogger } from '../automation/log-redaction.js';
-import { listActors } from '../resources/actors.js';
-import { createDefaultReadinessProbes, evaluateReadiness } from '../services/readiness.js';
-import { ResourceReadRouter } from '../resources/resource-read-router.js';
-import { config } from '../config.js';
-import { sharedRevisionProvider } from '../server/mcp-primitives/resource-revision.js';
-import { NEW_RESOURCE_DEFINITIONS, RESOURCE_TEMPLATES, } from '../resources/resource-catalog.js';
-import { redactProjectName } from '../resources/resource-errors.js';
-import { CapabilityResources, GatewayManifestCapabilitySource } from '../resources/capability-resources.js';
-import { BridgeEditorStateSource, EditorStateResources } from '../resources/editor-state-resources.js';
-import { KnowledgeResources } from '../resources/knowledge-resources.js';
-const diagnosticsReaderLogger = new AutomationLogger('DiagnosticsSnapshot');
-const RESOURCE_DEFINITIONS = [
-    { uri: 'ue://assets', name: 'Assets', description: 'Project assets', mimeType: 'application/json' },
-    { uri: 'ue://actors', name: 'Actors', description: 'Actors in the current level', mimeType: 'application/json' },
-    { uri: 'ue://health', name: 'Health Status', description: 'Server health and performance metrics', mimeType: 'application/json' },
-    { uri: 'ue://automation-bridge', name: 'Automation Bridge', description: 'Automation bridge diagnostics and recent activity', mimeType: 'application/json' }
-];
-function buildResourceReadRouter(bridge, automationBridge, ensureConnected) {
-    const revisions = sharedRevisionProvider();
-    const readEngineVersion = async () => {
-        try {
-            const info = objectDetails(await bridge.getEngineVersion());
-            return typeof info.version === 'string' ? info.version : null;
-        }
-        catch {
-            return null;
-        }
-    };
-    const editorState = new EditorStateResources(new BridgeEditorStateSource(automationBridge, ensureConnected, readEngineVersion), revisions, redactProjectName(config.UE_PROJECT_PATH) ?? null);
-    return new ResourceReadRouter(new CapabilityResources(new GatewayManifestCapabilitySource(), revisions), editorState, new KnowledgeResources(automationBridge, ensureConnected, revisions));
-}
-function resourceContent(uri, mimeType, text) {
-    return { contents: [{ uri, mimeType, text }] };
-}
-function jsonResource(uri, value) {
-    return resourceContent(uri, 'application/json', JSON.stringify(value, null, 2));
-}
-function disconnectedResource(uri) {
-    return resourceContent(uri, 'text/plain', 'Unreal Engine not connected (after 3 attempts).');
-}
-function redactRecentErrors(errors) {
-    return errors.map(error => ({
-        time: error.time,
-        scope: error.scope,
-        type: error.type,
-        retriable: error.retriable
-    }));
-}
-function objectDetails(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value)
-        ? value
-        : {};
-}
-export class ResourceHandler {
-    server;
-    bridge;
-    automationBridge;
-    assetResources;
-    healthMonitor;
-    ensureConnected;
-    router;
-    constructor(server, bridge, automationBridge, assetResources, healthMonitor, ensureConnected, router = buildResourceReadRouter(bridge, automationBridge, ensureConnected)) {
-        this.server = server;
-        this.bridge = bridge;
-        this.automationBridge = automationBridge;
-        this.assetResources = assetResources;
-        this.healthMonitor = healthMonitor;
-        this.ensureConnected = ensureConnected;
-        this.router = router;
-    }
-    registerHandlers() {
-        this.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
-            resources: [...RESOURCE_DEFINITIONS, ...NEW_RESOURCE_DEFINITIONS]
-        }));
-        this.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
-            resourceTemplates: [...RESOURCE_TEMPLATES]
-        }));
-        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-            const uri = request.params.uri;
-            switch (uri) {
-                case 'ue://assets': return this.whenConnected(uri, () => this.assetResources.list('/Game'));
-                case 'ue://actors': return this.whenConnected(uri, () => listActors(this.automationBridge));
-                case 'ue://health': return jsonResource(uri, await this.health());
-                case 'ue://automation-bridge': return jsonResource(uri, await this.bridgeStatus());
-                default: return this.router.read(uri);
-            }
-        });
-    }
-    async whenConnected(uri, fetch) {
-        return (await this.ensureConnected()) ? jsonResource(uri, await fetch()) : disconnectedResource(uri);
-    }
-    async health() {
-        const snapshots = await readDiagnosticsSnapshots(diagnosticsReaderLogger);
-        const uptimeMs = Date.now() - this.healthMonitor.metrics.uptime;
-        const automationStatus = this.automationBridge.getStatus();
-        let versionInfo = {};
-        let featureFlags = {};
-        if (this.bridge.isConnected) {
-            try {
-                versionInfo = objectDetails(await this.bridge.getEngineVersion());
-            }
-            catch {
-                versionInfo = {};
-            }
-            try {
-                featureFlags = objectDetails(await this.bridge.getFeatureFlags());
-            }
-            catch {
-                featureFlags = {};
-            }
-        }
-        const automationSummary = {
-            connected: automationStatus.connected,
-            activePort: automationStatus.activePort,
-            pendingRequests: automationStatus.pendingRequests,
-            lastHandshakeAt: automationStatus.lastHandshakeAt,
-            lastRequestSentAt: automationStatus.lastRequestSentAt,
-            maxPendingRequests: automationStatus.maxPendingRequests
-        };
-        const readiness = evaluateReadiness(createDefaultReadinessProbes({
-            automationBridge: this.automationBridge,
-            healthMonitor: this.healthMonitor
-        }));
-        const health = {
-            status: this.healthMonitor.metrics.connectionStatus,
-            uptimeSeconds: Math.floor(uptimeMs / 1000),
-            lastHealthCheckIso: this.healthMonitor.metrics.lastHealthCheck.toISOString(),
-            unrealConnection: {
-                status: this.bridge.isConnected ? 'connected' : 'disconnected',
-                transport: 'automation_bridge',
-                engineVersion: versionInfo,
-                features: {
-                    pythonEnabled: false,
-                    subsystems: objectDetails(featureFlags.subsystems),
-                    automationBridgeConnected: automationStatus.connected
-                }
-            },
-            recentErrors: redactRecentErrors(this.healthMonitor.metrics.recentErrors.slice(-10)),
-            automationBridge: automationSummary,
-            readiness,
-            diagnostics: this.healthMonitor.telemetry.snapshot(),
-            currentSession: snapshots.current,
-            previousSession: snapshots.previous,
-            metricsExposition: this.healthMonitor.telemetry.render(readiness)
-        };
-        return health;
-    }
-    async bridgeStatus() {
-        const snapshots = await readDiagnosticsSnapshots(diagnosticsReaderLogger);
-        const status = this.automationBridge.getStatus();
-        return {
-            summary: {
-                enabled: status.enabled,
-                connected: status.connected,
-                host: status.host,
-                port: status.port,
-                capabilityTokenRequired: status.capabilityTokenRequired,
-                pendingRequests: status.pendingRequests
-            },
-            timestamps: {
-                connectedAt: status.connectedAt,
-                lastHandshakeAt: status.lastHandshakeAt,
-                lastMessageAt: status.lastMessageAt,
-                lastRequestSentAt: status.lastRequestSentAt
-            },
-            lastDisconnect: status.lastDisconnect ? { code: status.lastDisconnect.code, at: status.lastDisconnect.at } : null,
-            lastHandshakeFailure: status.lastHandshakeFailure ? { at: status.lastHandshakeFailure.at } : null,
-            lastError: status.lastError ? { at: status.lastError.at } : null,
-            currentSession: snapshots.current,
-            previousSession: snapshots.previous
-        };
-    }
-}
-//# sourceMappingURL=resource-handlers.js.map

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-import { createServer } from './server/server-factory.js';
-import { startStdioServer } from './server/stdio-lifecycle.js';
-export { createServer, startStdioServer, };
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +0,0 @@
-import { createServer, routeStdoutLogsToStderr, } from './server/server-factory.js';
-import { startStdioServer } from './server/stdio-lifecycle.js';
-routeStdoutLogsToStderr();
-export { createServer, startStdioServer, };
-//# sourceMappingURL=index.js.map

package/dist/proxy/native-proxy.d.ts

@@ -1,12 +0,0 @@
-import type { Readable, Writable } from 'node:stream';
-export interface NativeProxyOptions {
-    upstream?: string;
-    cacheFile?: string;
-    input?: Readable;
-    output?: Writable;
-    token?: () => Promise<string | undefined>;
-}
-export declare function startNativeProxy(options?: NativeProxyOptions): {
-    close: () => void;
-};
-//# sourceMappingURL=native-proxy.d.ts.map

package/dist/resources/actors.d.ts

@@ -1,3 +0,0 @@
-import type { AutomationRequestBridge } from '../types/tools/tool-interfaces.js';
-export declare function listActors(automationBridge: AutomationRequestBridge | undefined): Promise<Record<string, unknown>>;
-//# sourceMappingURL=actors.d.ts.map

package/dist/resources/actors.js

@@ -1,20 +0,0 @@
-import { coerceNumber } from '../utils/validation/type-guards.js';
-export async function listActors(automationBridge) {
-    if (!automationBridge || typeof automationBridge.sendAutomationRequest !== 'function') {
-        return { success: false, error: 'Automation bridge is not available. Please ensure Unreal Engine is running with the MCP Automation Bridge plugin.' };
-    }
-    try {
-        const resp = await automationBridge.sendAutomationRequest('control_actor', { action: 'list' });
-        const result = resp?.result;
-        const data = result?.data;
-        const actors = [resp?.actors, result?.actors, data, data?.actors].find(Array.isArray);
-        if (resp && resp.success !== false && actors) {
-            return { success: true, count: coerceNumber(resp.count) ?? coerceNumber(result?.count) ?? actors.length, actors };
-        }
-        return { success: false, error: 'Failed to retrieve actor list from automation bridge' };
-    }
-    catch (err) {
-        return { success: false, error: `Failed to list actors: ${err instanceof Error ? err.message : String(err)}` };
-    }
-}
-//# sourceMappingURL=actors.js.map

package/dist/resources/assets.d.ts

@@ -1,7 +0,0 @@
-import type { UnrealBridge } from '../unreal-bridge.js';
-export declare class AssetResources {
-    private readonly bridge;
-    constructor(bridge: UnrealBridge);
-    list(dir?: string, limit?: number): Promise<Record<string, unknown>>;
-}
-//# sourceMappingURL=assets.d.ts.map

package/dist/resources/assets.js

@@ -1,58 +0,0 @@
-import { coerceString } from '../utils/validation/type-guards.js';
-import { Logger } from '../utils/logging/logger.js';
-import { normalizeAndSanitizeAssetPath } from '../utils/validation/validation.js';
-const log = new Logger('AssetResources');
-const toRow = (entry, fallbackClass) => ({
-    Name: coerceString(entry?.n ?? entry?.Name ?? entry?.name) ?? '',
-    Path: coerceString(entry?.p ?? entry?.Path ?? entry?.path) ?? '',
-    Class: coerceString(entry?.c ?? entry?.Class ?? entry?.class) ?? fallbackClass,
-});
-export class AssetResources {
-    bridge;
-    constructor(bridge) {
-        this.bridge = bridge;
-    }
-    async list(dir = '/Game', limit = 50) {
-        if (!this.bridge.isConnected) {
-            return {
-                success: false,
-                assets: [],
-                warning: 'Unreal Engine is not connected. Please ensure Unreal Engine is running with the MCP server enabled.',
-                connectionStatus: 'disconnected'
-            };
-        }
-        const path = normalizeAndSanitizeAssetPath(dir);
-        try {
-            const response = await this.bridge.getAutomationBridge().sendAutomationRequest('manage_asset', { action: 'list', path, limit, recursive: false }, { timeoutMs: 30000 });
-            if (response.success !== false && response.result) {
-                const payload = response.result;
-                const folders = Array.isArray(payload.folders_list)
-                    ? payload.folders_list.map((entry) => ({ ...toRow(entry, 'Folder'), Class: 'Folder', isFolder: true }))
-                    : [];
-                const assets = Array.isArray(payload.assets) ? payload.assets.map((entry) => toRow(entry, 'Object')) : [];
-                return {
-                    success: true,
-                    assets: [...folders, ...assets],
-                    count: folders.length + assets.length,
-                    folders: folders.length,
-                    files: assets.length,
-                    path,
-                    recursive: false,
-                    method: 'automation_bridge'
-                };
-            }
-        }
-        catch (error) {
-            log.debug('AssetRegistry list via automation bridge failed', error instanceof Error ? error : String(error));
-        }
-        return {
-            success: false,
-            path,
-            assets: [],
-            error: 'Asset registry returned no payload.',
-            warning: 'No items returned from AssetRegistry request.',
-            method: 'automation_bridge'
-        };
-    }
-}
-//# sourceMappingURL=assets.js.map

package/dist/resources/capability-resources.d.ts

@@ -1,37 +0,0 @@
-import type { GatewayManifest } from '../gateway/gateway-manifest-types.js';
-import { type RevisionProvider, type RevisionedResource } from '../server/mcp-primitives/resource-revision.js';
-export interface CapabilityCatalogEntry {
-    readonly id: string;
-    readonly category: string | null;
-    readonly actionCount: number;
-}
-export interface CapabilityCatalogData {
-    readonly count: number;
-    readonly totalCount: number;
-    readonly truncated: boolean;
-    readonly capabilities: readonly CapabilityCatalogEntry[];
-}
-export interface CapabilityRecordData {
-    readonly id: string;
-    readonly category: string | null;
-    readonly actionCount: number;
-    readonly parameterCount: number;
-    readonly truncated: boolean;
-    readonly actions: readonly string[];
-}
-export declare class GatewayManifestCapabilitySource {
-    private readonly manifest;
-    constructor(manifest?: GatewayManifest);
-    entries(): readonly CapabilityCatalogEntry[];
-    record(id: string): CapabilityRecordData | undefined;
-    private canonicalRecord;
-}
-export declare class CapabilityResources {
-    private readonly source;
-    private readonly revisions;
-    constructor(source: GatewayManifestCapabilitySource, revisions: RevisionProvider);
-    private catalogRevision;
-    readCatalog(): RevisionedResource<CapabilityCatalogData>;
-    readRecord(uri: string, id: string): RevisionedResource<CapabilityRecordData>;
-}
-//# sourceMappingURL=capability-resources.d.ts.map

package/dist/resources/capability-resources.js

@@ -1,86 +0,0 @@
-import { getGatewayManifest } from '../gateway/gateway-manifest.js';
-import { capabilityIndex, legacyPairKey } from '../server/gateway/gateway-capability-index.js';
-import { RESOURCE_ERROR_CODES, ResourceError } from './resource-errors.js';
-import { getParentToolMetadata } from '../tools/catalog/capabilities/records/parent-metadata.js';
-const CATALOG_URI = 'ue://capability/catalog';
-const MAX_CATALOG_ENTRIES = 64;
-const MAX_RECORD_ACTIONS = 200;
-export class GatewayManifestCapabilitySource {
-    manifest;
-    constructor(manifest = getGatewayManifest()) {
-        this.manifest = manifest;
-    }
-    entries() {
-        return this.manifest.tools.map((tool) => ({
-            id: tool.name,
-            category: tool.category,
-            actionCount: tool.actions.length,
-        }));
-    }
-    record(id) {
-        const tool = this.manifest.tools.find((candidate) => candidate.name === id);
-        if (tool === undefined) {
-            return this.canonicalRecord(id);
-        }
-        const actions = tool.actions.slice(0, MAX_RECORD_ACTIONS);
-        return {
-            id: tool.name,
-            category: tool.category,
-            actionCount: tool.actions.length,
-            parameterCount: tool.parameterNames.length,
-            truncated: tool.actions.length > actions.length,
-            actions,
-        };
-    }
-    canonicalRecord(id) {
-        const index = capabilityIndex();
-        const dot = id.indexOf('.');
-        const record = index.byId.get(id)
-            ?? index.byAlias.get(id)
-            ?? (dot > 0 ? index.byLegacyPair.get(legacyPairKey(id.slice(0, dot), id.slice(dot + 1))) : undefined);
-        if (record === undefined) {
-            return undefined;
-        }
-        return {
-            id: record.id,
-            category: getParentToolMetadata(record.routing.parentTool).category,
-            actionCount: 1,
-            parameterCount: Object.keys(record.schemas.input.properties).length,
-            truncated: false,
-            actions: [record.routing.dispatchAction],
-        };
-    }
-}
-export class CapabilityResources {
-    source;
-    revisions;
-    constructor(source, revisions) {
-        this.source = source;
-        this.revisions = revisions;
-    }
-    catalogRevision() {
-        return this.revisions.currentRevision('ue://capability/catalog');
-    }
-    readCatalog() {
-        const all = this.source.entries();
-        const capped = all.slice(0, MAX_CATALOG_ENTRIES);
-        return {
-            uri: CATALOG_URI,
-            revision: this.catalogRevision(),
-            data: {
-                count: capped.length,
-                totalCount: all.length,
-                truncated: all.length > capped.length,
-                capabilities: capped,
-            },
-        };
-    }
-    readRecord(uri, id) {
-        const record = this.source.record(id);
-        if (record === undefined) {
-            throw new ResourceError(RESOURCE_ERROR_CODES.NOT_FOUND, uri, `Unknown capability: ${id}`);
-        }
-        return { uri, revision: this.catalogRevision(), data: record };
-    }
-}
-//# sourceMappingURL=capability-resources.js.map

package/dist/resources/editor-state-resources.d.ts

@@ -1,65 +0,0 @@
-import type { AutomationRequestBridge } from '../types/tools/tool-interfaces.js';
-import { type RevisionProvider, type RevisionedResource } from '../server/mcp-primitives/resource-revision.js';
-import { type LiveStateRevisions } from '../tools/catalog/capabilities/semantic/live-state-revisions.js';
-export interface ProjectData {
-    readonly projectName: string | null;
-    readonly engineVersion: string | null;
-    readonly contentRoot: string;
-    readonly connected: boolean;
-}
-export interface EditorData {
-    readonly pieActive: boolean;
-    readonly currentLevel: {
-        readonly name: string;
-        readonly path: string;
-    };
-}
-export interface SelectionEntry {
-    readonly name: string;
-    readonly path: string;
-}
-export interface SelectionData {
-    readonly count: number;
-    readonly totalCount: number;
-    readonly truncated: boolean;
-    readonly actors: readonly SelectionEntry[];
-}
-export interface EditorStateSource {
-    isAvailable(): Promise<boolean>;
-    engineVersion(): Promise<string | null>;
-    pieActive(): Promise<boolean>;
-    currentLevel(): Promise<{
-        name: string;
-        path: string;
-    }>;
-    selectedActors(): Promise<readonly SelectionEntry[]>;
-    liveRevisions(): Promise<LiveStateRevisions | undefined>;
-}
-export declare class EditorStateResources {
-    private readonly source;
-    private readonly revisions;
-    private readonly projectName;
-    constructor(source: EditorStateSource, revisions: RevisionProvider, projectName: string | null);
-    readProject(): Promise<RevisionedResource<ProjectData>>;
-    readEditor(): Promise<RevisionedResource<EditorData>>;
-    readSelection(): Promise<RevisionedResource<SelectionData>>;
-    readStateRevisions(): Promise<RevisionedResource<LiveStateRevisions>>;
-}
-export declare class BridgeEditorStateSource implements EditorStateSource {
-    private readonly automationBridge;
-    private readonly ensureConnected;
-    private readonly engineVersionProvider;
-    constructor(automationBridge: AutomationRequestBridge | undefined, ensureConnected: () => Promise<boolean>, engineVersionProvider: () => Promise<string | null>);
-    isAvailable(): Promise<boolean>;
-    engineVersion(): Promise<string | null>;
-    pieActive(): Promise<boolean>;
-    currentLevel(): Promise<{
-        name: string;
-        path: string;
-    }>;
-    selectedActors(): Promise<readonly SelectionEntry[]>;
-    liveRevisions(): Promise<LiveStateRevisions | undefined>;
-    private request;
-    private nested;
-}
-//# sourceMappingURL=editor-state-resources.d.ts.map