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

package/dist/server/mcp-primitives/session-configure-store.js

@@ -0,0 +1,131 @@
+import { consolidatedToolDefinitions } from '../../tools/catalog/consolidated-tool-definitions.js';
+import { countEnabledTools, isToolStateEnabled, listCategoryStates } from '../../tools/dynamic/dynamic-tool-queries.js';
+import { disableCategoryState, disableToolStates, enableCategoryState, enableToolStates, resetToolStates, } from '../../tools/dynamic/dynamic-tool-state-operations.js';
+import { BASELINE_CATALOG_STATE_REVISION } from './catalog-revision-reader.js';
+export const LIMIT_BOUNDS = Object.freeze({
+    maxResults: { min: 1, max: 1000 },
+    maxDepth: { min: 1, max: 32 },
+    pageSize: { min: 1, max: 200 },
+});
+export const MAX_PREFERENCE_KEYS = 16;
+export const MAX_PREFERENCE_VALUE_LENGTH = 256;
+export class SessionConfigureStore {
+    overlays = new Map();
+    seed;
+    constructor(seed = () => consolidatedToolDefinitions) {
+        this.seed = seed;
+    }
+    getCatalogStateRevision(sessionId) {
+        return this.overlays.get(sessionId)?.catalogStateRevision ?? BASELINE_CATALOG_STATE_REVISION;
+    }
+    hasSession(sessionId) {
+        return this.overlays.has(sessionId);
+    }
+    clearSession(sessionId) {
+        return this.overlays.delete(sessionId);
+    }
+    enableTools(sessionId, toolNames) {
+        const overlay = this.overlay(sessionId);
+        return this.applyMutation(overlay, () => enableToolStates(overlay.toolStates, overlay.categoryStates, toolNames));
+    }
+    disableTools(sessionId, toolNames) {
+        const overlay = this.overlay(sessionId);
+        return this.applyMutation(overlay, () => disableToolStates(overlay.toolStates, overlay.categoryStates, toolNames));
+    }
+    enableCategory(sessionId, category) {
+        const overlay = this.overlay(sessionId);
+        return this.applyMutation(overlay, () => enableCategoryState(overlay.toolStates, overlay.categoryStates, category));
+    }
+    disableCategory(sessionId, category) {
+        const overlay = this.overlay(sessionId);
+        return this.applyMutation(overlay, () => disableCategoryState(overlay.toolStates, overlay.categoryStates, category));
+    }
+    reset(sessionId) {
+        const overlay = this.overlay(sessionId);
+        const count = this.applyMutation(overlay, () => resetToolStates(overlay.toolStates, overlay.categoryStates));
+        return { enabled: count };
+    }
+    setLimit(sessionId, key, value) {
+        const bounds = LIMIT_BOUNDS[key];
+        if (bounds === undefined || !Number.isFinite(value)) {
+            return { accepted: false, key, value, clamped: false };
+        }
+        const clampedValue = Math.min(bounds.max, Math.max(bounds.min, Math.trunc(value)));
+        this.overlay(sessionId).limits.set(key, clampedValue);
+        return { accepted: true, key, value: clampedValue, clamped: clampedValue !== value };
+    }
+    setPreference(sessionId, key, value) {
+        if (typeof value !== 'string' || value.length > MAX_PREFERENCE_VALUE_LENGTH) {
+            return { accepted: false, key };
+        }
+        const preferences = this.overlay(sessionId).preferences;
+        if (!preferences.has(key) && preferences.size >= MAX_PREFERENCE_KEYS) {
+            return { accepted: false, key };
+        }
+        preferences.set(key, value);
+        return { accepted: true, key };
+    }
+    isToolEnabled(sessionId, toolName) {
+        const overlay = this.overlay(sessionId);
+        return isToolStateEnabled(overlay.toolStates, overlay.categoryStates, toolName);
+    }
+    listTools(sessionId) {
+        return Array.from(this.overlay(sessionId).toolStates.values());
+    }
+    listCategories(sessionId) {
+        const overlay = this.overlay(sessionId);
+        return listCategoryStates(overlay.toolStates, overlay.categoryStates);
+    }
+    getStatus(sessionId) {
+        const overlay = this.overlay(sessionId);
+        const tools = Array.from(overlay.toolStates.values());
+        const enabledCount = countEnabledTools(overlay.toolStates, overlay.categoryStates);
+        return {
+            totalTools: tools.length,
+            enabledTools: enabledCount,
+            disabledTools: tools.length - enabledCount,
+            categories: listCategoryStates(overlay.toolStates, overlay.categoryStates),
+            catalogStateRevision: overlay.catalogStateRevision,
+            preferences: Object.fromEntries(overlay.preferences),
+            limits: Object.fromEntries(overlay.limits),
+        };
+    }
+    static fingerprint(overlay) {
+        const tools = Array.from(overlay.toolStates.values(), state => `${state.name}=${state.enabled ? 1 : 0}`);
+        const categories = Array.from(overlay.categoryStates.values(), cat => `${cat.name}=${cat.enabled ? 1 : 0}`);
+        return `${tools.join(',')}|${categories.join(',')}`;
+    }
+    applyMutation(overlay, mutate) {
+        const before = SessionConfigureStore.fingerprint(overlay);
+        const result = mutate();
+        if (SessionConfigureStore.fingerprint(overlay) !== before) {
+            overlay.catalogStateRevision++;
+        }
+        return result;
+    }
+    overlay(sessionId) {
+        let overlay = this.overlays.get(sessionId);
+        if (overlay === undefined) {
+            overlay = this.buildOverlay();
+            this.overlays.set(sessionId, overlay);
+        }
+        return overlay;
+    }
+    buildOverlay() {
+        const toolStates = new Map();
+        const categoryStates = new Map();
+        for (const def of this.seed()) {
+            const category = def.category ?? 'utility';
+            toolStates.set(def.name, { name: def.name, category, enabled: true, description: def.description });
+            let catState = categoryStates.get(category);
+            if (catState === undefined) {
+                catState = { name: category, enabled: true, toolCount: 0, enabledCount: 0 };
+                categoryStates.set(category, catState);
+            }
+            catState.toolCount++;
+            catState.enabledCount++;
+        }
+        return { toolStates, categoryStates, catalogStateRevision: 0, preferences: new Map(), limits: new Map() };
+    }
+}
+//# sourceMappingURL=session-configure-store.js.map

package/dist/server/mcp-primitives/session-configure-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-configure-store.js","sourceRoot":"","sources":["../../../src/server/mcp-primitives/session-configure-store.ts"],"names":[],"mappings":"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"}

package/dist/server/mcp-primitives/subscriptions/notification-coalescer.d.ts

@@ -0,0 +1,39 @@
+import { type CatalogRevisionReader } from '../catalog-revision-reader.js';
+import type { RevisionProvider, SubscribableUri } from '../resource-revision.js';
+import type { SubscriptionStore } from './subscription-store.js';
+import { type NotificationSink, type SubscriptionClock } from './subscription-types.js';
+export type RecordSkipReason = 'NOT_SUBSCRIBED' | 'INVALID_CHANGE_KIND' | 'UNCHANGED';
+export interface RecordResult {
+    readonly recorded: boolean;
+    readonly reason: RecordSkipReason | null;
+}
+export interface NotificationCoalescerDeps {
+    readonly store: SubscriptionStore;
+    readonly revisions: RevisionProvider;
+    readonly catalog: CatalogRevisionReader;
+    readonly sink: NotificationSink;
+    readonly clock: SubscriptionClock;
+    readonly windowMs?: number;
+}
+export declare class NotificationCoalescer {
+    private readonly store;
+    private readonly revisions;
+    private readonly catalog;
+    private readonly sink;
+    private readonly clock;
+    private readonly windowMs;
+    private readonly pending;
+    private readonly lastEmitted;
+    private readonly catalogCursor;
+    constructor(deps: NotificationCoalescerDeps);
+    recordChange(sessionId: string, uri: string, changeKind?: string): RecordResult;
+    syncCatalog(sessionId: string): RecordResult;
+    recordGlobalChange(uri: string, changeKind?: string): number;
+    flushDue(now?: number): number;
+    nextDueAt(): number | null;
+    pendingCount(sessionId?: string): number;
+    dropPending(sessionId: string, uri: SubscribableUri): void;
+    clearSession(sessionId: string): void;
+    private static key;
+}
+//# sourceMappingURL=notification-coalescer.d.ts.map

package/dist/server/mcp-primitives/subscriptions/notification-coalescer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-coalescer.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/notification-coalescer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAmC,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,KAAK,EAAoB,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAIL,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,WAAW,CAAC;AAEtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAElC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAErC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAElC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAWD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE/C,IAAI,EAAE,yBAAyB;IAgB3C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAkB,GAAG,YAAY;IA4B1F,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAsB5C,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAkB,GAAG,MAAM;IAgBvE,QAAQ,CAAC,GAAG,GAAE,MAAqB,GAAG,MAAM;IAuB5C,SAAS,IAAI,MAAM,GAAG,IAAI;IAU1B,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAcxC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI;IAO1D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAerC,OAAO,CAAC,MAAM,CAAC,GAAG;CAGnB"}

package/dist/server/mcp-primitives/subscriptions/notification-coalescer.js

@@ -0,0 +1,131 @@
+import { BASELINE_CATALOG_STATE_REVISION } from '../catalog-revision-reader.js';
+import { CATALOG_SUBSCRIPTION_URI, DEFAULT_COALESCE_WINDOW_MS, isResourceChangeKind, } from './subscription-types.js';
+const KEY_SEPARATOR = '\u0000';
+export class NotificationCoalescer {
+    store;
+    revisions;
+    catalog;
+    sink;
+    clock;
+    windowMs;
+    pending = new Map();
+    lastEmitted = new Map();
+    catalogCursor = new Map();
+    constructor(deps) {
+        this.store = deps.store;
+        this.revisions = deps.revisions;
+        this.catalog = deps.catalog;
+        this.sink = deps.sink;
+        this.clock = deps.clock;
+        this.windowMs = deps.windowMs ?? DEFAULT_COALESCE_WINDOW_MS;
+    }
+    recordChange(sessionId, uri, changeKind = 'updated') {
+        if (!isResourceChangeKind(changeKind)) {
+            return { recorded: false, reason: 'INVALID_CHANGE_KIND' };
+        }
+        if (!this.store.isSubscribed(sessionId, uri)) {
+            return { recorded: false, reason: 'NOT_SUBSCRIBED' };
+        }
+        const subscribableUri = uri;
+        const key = NotificationCoalescer.key(sessionId, subscribableUri);
+        const existing = this.pending.get(key);
+        if (existing !== undefined) {
+            existing.changeKind = changeKind;
+        }
+        else {
+            this.pending.set(key, {
+                sessionId,
+                uri: subscribableUri,
+                changeKind,
+                dueAt: this.clock() + this.windowMs,
+            });
+        }
+        return { recorded: true, reason: null };
+    }
+    syncCatalog(sessionId) {
+        const current = this.catalog.getCatalogStateRevision(sessionId);
+        const last = this.catalogCursor.get(sessionId) ?? BASELINE_CATALOG_STATE_REVISION;
+        if (current <= last) {
+            return { recorded: false, reason: 'UNCHANGED' };
+        }
+        const result = this.recordChange(sessionId, CATALOG_SUBSCRIPTION_URI, 'updated');
+        if (result.recorded) {
+            this.catalogCursor.set(sessionId, current);
+        }
+        return result;
+    }
+    recordGlobalChange(uri, changeKind = 'updated') {
+        let recorded = 0;
+        for (const sessionId of this.store.sessionsSubscribedTo(uri)) {
+            if (this.recordChange(sessionId, uri, changeKind).recorded) {
+                recorded++;
+            }
+        }
+        return recorded;
+    }
+    flushDue(now = this.clock()) {
+        let emitted = 0;
+        for (const [key, change] of this.pending) {
+            if (change.dueAt > now) {
+                continue;
+            }
+            this.pending.delete(key);
+            if (!this.store.isSubscribed(change.sessionId, change.uri)) {
+                continue;
+            }
+            const revision = this.revisions.currentRevision(change.uri);
+            const previous = this.lastEmitted.get(key);
+            if (previous !== undefined && revision < previous) {
+                continue;
+            }
+            this.lastEmitted.set(key, revision);
+            this.sink(change.sessionId, { uri: change.uri, revision, changeKind: change.changeKind });
+            emitted++;
+        }
+        return emitted;
+    }
+    nextDueAt() {
+        let earliest = null;
+        for (const change of this.pending.values()) {
+            if (earliest === null || change.dueAt < earliest) {
+                earliest = change.dueAt;
+            }
+        }
+        return earliest;
+    }
+    pendingCount(sessionId) {
+        if (sessionId === undefined) {
+            return this.pending.size;
+        }
+        let count = 0;
+        for (const change of this.pending.values()) {
+            if (change.sessionId === sessionId) {
+                count++;
+            }
+        }
+        return count;
+    }
+    dropPending(sessionId, uri) {
+        const key = NotificationCoalescer.key(sessionId, uri);
+        this.pending.delete(key);
+        this.lastEmitted.delete(key);
+    }
+    clearSession(sessionId) {
+        const prefix = `${sessionId}${KEY_SEPARATOR}`;
+        for (const key of [...this.pending.keys()]) {
+            if (key.startsWith(prefix)) {
+                this.pending.delete(key);
+            }
+        }
+        for (const key of [...this.lastEmitted.keys()]) {
+            if (key.startsWith(prefix)) {
+                this.lastEmitted.delete(key);
+            }
+        }
+        this.catalogCursor.delete(sessionId);
+    }
+    static key(sessionId, uri) {
+        return `${sessionId}${KEY_SEPARATOR}${uri}`;
+    }
+}
+//# sourceMappingURL=notification-coalescer.js.map

package/dist/server/mcp-primitives/subscriptions/notification-coalescer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-coalescer.js","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/notification-coalescer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,+BAA+B,EAA8B,MAAM,+BAA+B,CAAC;AAG5G,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,GAIrB,MAAM,yBAAyB,CAAC;AAgCjC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B,MAAM,OAAO,qBAAqB;IACf,KAAK,CAAoB;IACzB,SAAS,CAAmB;IAC5B,OAAO,CAAwB;IAC/B,IAAI,CAAmB;IACvB,KAAK,CAAoB;IACzB,QAAQ,CAAS;IAEjB,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC3C,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3D,YAAY,IAA+B;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,0BAA0B,CAAC;IAC9D,CAAC;IASD,YAAY,CAAC,SAAiB,EAAE,GAAW,EAAE,aAAqB,SAAS;QACzE,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,eAAe,GAAG,GAAsB,CAAC;QAC/C,MAAM,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpB,SAAS;gBACT,GAAG,EAAE,eAAe;gBACpB,UAAU;gBACV,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ;aACpC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAOD,WAAW,CAAC,SAAiB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,+BAA+B,CAAC;QAClF,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAIpB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAClD,CAAC;QAMD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,wBAAwB,EAAE,SAAS,CAAC,CAAC;QACjF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAGD,kBAAkB,CAAC,GAAW,EAAE,aAAqB,SAAS;QAC5D,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3D,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAQD,QAAQ,CAAC,MAAc,IAAI,CAAC,KAAK,EAAE;QACjC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1F,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAGD,SAAS;QACP,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACjD,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAY,CAAC,SAAkB;QAC7B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACnC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,WAAW,CAAC,SAAiB,EAAE,GAAoB;QACjD,MAAM,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAGD,YAAY,CAAC,SAAiB;QAC5B,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,aAAa,EAAE,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAEO,MAAM,CAAC,GAAG,CAAC,SAAiB,EAAE,GAAoB;QACxD,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,GAAG,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/server/mcp-primitives/subscriptions/subscription-store.d.ts

@@ -0,0 +1,32 @@
+import { type SubscribableUri } from '../resource-revision.js';
+import { type SubscriptionReleaseHook } from './subscription-types.js';
+export type SubscribeRejectReason = 'NOT_SUBSCRIBABLE' | 'INVALID_SESSION';
+export interface SubscribeResult {
+    readonly accepted: boolean;
+    readonly alreadySubscribed: boolean;
+    readonly evicted: SubscribableUri | null;
+    readonly reason: SubscribeRejectReason | null;
+}
+export interface SubscriptionStoreOptions {
+    readonly maxPerSession?: number;
+    readonly onRelease?: SubscriptionReleaseHook;
+}
+export declare class SubscriptionStore {
+    private readonly sessions;
+    private readonly maxPerSession;
+    private readonly onRelease;
+    constructor(options?: SubscriptionStoreOptions);
+    subscribe(sessionId: string, uri: string): SubscribeResult;
+    unsubscribe(sessionId: string, uri: string): boolean;
+    isSubscribed(sessionId: string, uri: string): boolean;
+    subscriptions(sessionId: string): readonly SubscribableUri[];
+    count(sessionId: string): number;
+    hasSession(sessionId: string): boolean;
+    sessionCount(): number;
+    sessionsSubscribedTo(uri: string): string[];
+    clearSession(sessionId: string): number;
+    private ensureSession;
+    private release;
+    private static isValidSession;
+}
+//# sourceMappingURL=subscription-store.d.ts.map

package/dist/server/mcp-primitives/subscriptions/subscription-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-store.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/subscription-store.ts"],"names":[],"mappings":"AAWA,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAIjC,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAO3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IAEvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;CAC9C;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,OAAO,GAAE,wBAA6B;IAclD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe;IAqB1D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAapD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAKrD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE;IAK5D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,YAAY,IAAI,MAAM;IAKtB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAiB3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAcvC,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}

package/dist/server/mcp-primitives/subscriptions/subscription-store.js

@@ -0,0 +1,103 @@
+import { isSubscribableUri } from '../resource-revision.js';
+import { DEFAULT_MAX_SUBSCRIPTIONS_PER_SESSION, } from './subscription-types.js';
+import { evictOldestUntilUnder } from '../../../utils/collections/bounded.js';
+export class SubscriptionStore {
+    sessions = new Map();
+    maxPerSession;
+    onRelease;
+    constructor(options = {}) {
+        const cap = options.maxPerSession ?? DEFAULT_MAX_SUBSCRIPTIONS_PER_SESSION;
+        if (!Number.isInteger(cap) || cap < 1) {
+            throw new RangeError(`Invalid maxPerSession: ${String(cap)} (expected integer >= 1)`);
+        }
+        this.maxPerSession = cap;
+        this.onRelease = options.onRelease ?? null;
+    }
+    subscribe(sessionId, uri) {
+        if (!SubscriptionStore.isValidSession(sessionId)) {
+            return { accepted: false, alreadySubscribed: false, evicted: null, reason: 'INVALID_SESSION' };
+        }
+        if (!isSubscribableUri(uri)) {
+            return { accepted: false, alreadySubscribed: false, evicted: null, reason: 'NOT_SUBSCRIBABLE' };
+        }
+        const set = this.ensureSession(sessionId);
+        if (set.has(uri)) {
+            return { accepted: true, alreadySubscribed: true, evicted: null, reason: null };
+        }
+        let evicted = null;
+        evictOldestUntilUnder(set, this.maxPerSession, (uriEvicted) => {
+            evicted = uriEvicted;
+            this.release(sessionId, uriEvicted);
+        });
+        set.add(uri);
+        return { accepted: true, alreadySubscribed: false, evicted, reason: null };
+    }
+    unsubscribe(sessionId, uri) {
+        const set = this.sessions.get(sessionId);
+        if (set === undefined || !isSubscribableUri(uri) || !set.has(uri)) {
+            return false;
+        }
+        set.delete(uri);
+        this.release(sessionId, uri);
+        if (set.size === 0) {
+            this.sessions.delete(sessionId);
+        }
+        return true;
+    }
+    isSubscribed(sessionId, uri) {
+        return isSubscribableUri(uri) && (this.sessions.get(sessionId)?.has(uri) ?? false);
+    }
+    subscriptions(sessionId) {
+        const set = this.sessions.get(sessionId);
+        return set === undefined ? [] : [...set];
+    }
+    count(sessionId) {
+        return this.sessions.get(sessionId)?.size ?? 0;
+    }
+    hasSession(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    sessionCount() {
+        return this.sessions.size;
+    }
+    sessionsSubscribedTo(uri) {
+        if (!isSubscribableUri(uri)) {
+            return [];
+        }
+        const result = [];
+        for (const [sessionId, set] of this.sessions) {
+            if (set.has(uri)) {
+                result.push(sessionId);
+            }
+        }
+        return result;
+    }
+    clearSession(sessionId) {
+        const set = this.sessions.get(sessionId);
+        if (set === undefined) {
+            return 0;
+        }
+        let released = 0;
+        for (const uri of set) {
+            this.release(sessionId, uri);
+            released++;
+        }
+        this.sessions.delete(sessionId);
+        return released;
+    }
+    ensureSession(sessionId) {
+        let set = this.sessions.get(sessionId);
+        if (set === undefined) {
+            set = new Set();
+            this.sessions.set(sessionId, set);
+        }
+        return set;
+    }
+    release(sessionId, uri) {
+        this.onRelease?.(sessionId, uri);
+    }
+    static isValidSession(sessionId) {
+        return typeof sessionId === 'string' && sessionId.trim().length > 0;
+    }
+}
+//# sourceMappingURL=subscription-store.js.map

package/dist/server/mcp-primitives/subscriptions/subscription-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-store.js","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/subscription-store.ts"],"names":[],"mappings":"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"}

package/dist/server/mcp-primitives/subscriptions/subscription-types.d.ts

@@ -0,0 +1,16 @@
+import type { ResourceRevision, SubscribableUri } from '../resource-revision.js';
+export declare const RESOURCE_CHANGE_KINDS: readonly ["updated", "invalidated", "removed"];
+export type ResourceChangeKind = (typeof RESOURCE_CHANGE_KINDS)[number];
+export declare function isResourceChangeKind(value: string): value is ResourceChangeKind;
+export interface ResourceUpdatedPayload {
+    readonly uri: SubscribableUri;
+    readonly revision: ResourceRevision;
+    readonly changeKind: ResourceChangeKind;
+}
+export declare const CATALOG_SUBSCRIPTION_URI: SubscribableUri;
+export type SubscriptionClock = () => number;
+export type NotificationSink = (sessionId: string, payload: ResourceUpdatedPayload) => void;
+export type SubscriptionReleaseHook = (sessionId: string, uri: SubscribableUri) => void;
+export declare const DEFAULT_COALESCE_WINDOW_MS = 50;
+export declare const DEFAULT_MAX_SUBSCRIPTIONS_PER_SESSION = 9;
+//# sourceMappingURL=subscription-types.d.ts.map

package/dist/server/mcp-primitives/subscriptions/subscription-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-types.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/subscription-types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAOjF,eAAO,MAAM,qBAAqB,gDAAiD,CAAC;AAEpF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAKxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAOD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAGD,eAAO,MAAM,wBAAwB,EAAgC,eAAe,CAAC;AAMrF,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC;AAQ7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAQ5F,MAAM,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;AAGxF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAO7C,eAAO,MAAM,qCAAqC,IAAI,CAAC"}

package/dist/server/mcp-primitives/subscriptions/subscription-types.js

@@ -0,0 +1,9 @@
+export const RESOURCE_CHANGE_KINDS = ['updated', 'invalidated', 'removed'];
+const CHANGE_KIND_SET = new Set(RESOURCE_CHANGE_KINDS);
+export function isResourceChangeKind(value) {
+    return CHANGE_KIND_SET.has(value);
+}
+export const CATALOG_SUBSCRIPTION_URI = 'ue://capability/catalog';
+export const DEFAULT_COALESCE_WINDOW_MS = 50;
+export const DEFAULT_MAX_SUBSCRIPTIONS_PER_SESSION = 9;
+//# sourceMappingURL=subscription-types.js.map

package/dist/server/mcp-primitives/subscriptions/subscription-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-types.js","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/subscriptions/subscription-types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAU,CAAC;AAIpF,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAG5E,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAcD,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAA4C,CAAC;AAyBrF,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAO7C,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC"}

package/dist/server/mcp-primitives/task-checkpoint.d.ts

@@ -0,0 +1,14 @@
+import { McpError, type Result, type Task } from '@modelcontextprotocol/sdk/types.js';
+import type { RequestTaskStore } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CreateTaskOptions } from '@modelcontextprotocol/sdk/experimental/tasks/interfaces.js';
+export declare const TASK_CHECKPOINT_OPERATIONS: readonly ["search", "describe"];
+export declare const TASK_CHECKPOINT_REFUSED = "TASK_CHECKPOINT_NOT_AVAILABLE";
+export declare function taskCheckpointRefusal(toolName: string, args: Record<string, unknown>, taskStore: RequestTaskStore | undefined): McpError | undefined;
+export declare function runTaskCheckpoint(input: {
+    readonly taskStore: RequestTaskStore;
+    readonly taskCreation: CreateTaskOptions;
+    readonly run: () => Promise<Result>;
+}): Promise<{
+    task: Task;
+}>;
+//# sourceMappingURL=task-checkpoint.d.ts.map

package/dist/server/mcp-primitives/task-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-checkpoint.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/task-checkpoint.ts"],"names":[],"mappings":"AAeA,OAAO,EAAa,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAGpG,eAAO,MAAM,0BAA0B,iCAAkC,CAAC;AAE1E,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AASvE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,gBAAgB,GAAG,SAAS,GACtC,QAAQ,GAAG,SAAS,CAgCtB;AAcD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAuB1B"}

package/dist/server/mcp-primitives/task-checkpoint.js

@@ -0,0 +1,51 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+export const TASK_CHECKPOINT_OPERATIONS = ['search', 'describe'];
+export const TASK_CHECKPOINT_REFUSED = 'TASK_CHECKPOINT_NOT_AVAILABLE';
+const CHECKPOINTABLE = new Set(TASK_CHECKPOINT_OPERATIONS);
+export function taskCheckpointRefusal(toolName, args, taskStore) {
+    if (taskStore === undefined) {
+        return new McpError(ErrorCode.InternalError, 'Task creation was accepted at the capability level but this server has no task store configured.');
+    }
+    if (toolName !== 'unreal') {
+        return new McpError(ErrorCode.InvalidParams, `Task creation is not available for '${toolName}'. The only public tool is the 'unreal' gateway.`, { code: TASK_CHECKPOINT_REFUSED, nextCall: { method: 'tools/call', params: { name: 'unreal' } } });
+    }
+    const operation = typeof args.operation === 'string' ? args.operation : '';
+    if (!CHECKPOINTABLE.has(operation)) {
+        return new McpError(ErrorCode.InvalidParams, `MCP Tasks on this server are safe read-only checkpoints, so only ${TASK_CHECKPOINT_OPERATIONS.join(' and ')} ` +
+            `may be task-augmented; '${operation || 'unknown'}' may not. Cancelling a task cannot interrupt work already ` +
+            'dispatched to the editor, so a mutating operation is never handed back as a cancellable handle. ' +
+            'Re-send this call without params.task to run it synchronously.', {
+            code: TASK_CHECKPOINT_REFUSED,
+            taskableOperations: [...TASK_CHECKPOINT_OPERATIONS],
+            nextCall: { method: 'tools/call', params: { name: 'unreal', arguments: { operation } } },
+        });
+    }
+    return undefined;
+}
+function creationOptions(requested) {
+    return {
+        ...(requested.ttl === undefined ? {} : { ttl: requested.ttl }),
+        ...(typeof requested.pollInterval === 'number' ? { pollInterval: requested.pollInterval } : {}),
+    };
+}
+export async function runTaskCheckpoint(input) {
+    const created = await input.taskStore.createTask(creationOptions(input.taskCreation));
+    let status = 'completed';
+    let result;
+    try {
+        result = await input.run();
+        if (result.isError === true)
+            status = 'failed';
+    }
+    catch (error) {
+        status = 'failed';
+        result = { isError: true, message: error instanceof Error ? error.message : String(error) };
+    }
+    try {
+        await input.taskStore.storeTaskResult(created.taskId, status, result);
+    }
+    catch {
+    }
+    return { task: await input.taskStore.getTask(created.taskId) };
+}
+//# sourceMappingURL=task-checkpoint.js.map

package/dist/server/mcp-primitives/task-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-checkpoint.js","sourceRoot":"","sources":["../../../src/server/mcp-primitives/task-checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/server/resource-registry.d.ts

@@ -1,10 +1,23 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { UnrealBridge } from '../unreal-bridge.js';
 import { AutomationBridge } from '../automation/index.js';
 import { HealthMonitor } from '../services/health-monitor.js';
+import { type ResourceServer } from '../handlers/resource-handlers.js';
 import { AssetResources } from '../resources/assets.js';
 import { ActorResources } from '../resources/actors.js';
 import { LevelResources } from '../resources/levels.js';
+import { type ResourceDefinition, type ResourceTemplateDefinition } from '../resources/resource-catalog.js';
+type ListResourcesServer = {
+    setRequestHandler(schema: typeof ListResourcesRequestSchema, handler: () => Promise<{
+        resources: ResourceDefinition[];
+    }>): void;
+};
+type ListResourceTemplatesServer = {
+    setRequestHandler(schema: typeof ListResourceTemplatesRequestSchema, handler: () => Promise<{
+        resourceTemplates: ResourceTemplateDefinition[];
+    }>): void;
+};
+type ResourceRegistryServer = ResourceServer & ListResourcesServer & ListResourceTemplatesServer;
 export declare class ResourceRegistry {
     private server;
     private bridge;
@@ -14,7 +27,10 @@ export declare class ResourceRegistry {
     private levelResources;
     private healthMonitor;
     private ensureConnected;
-    constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, healthMonitor: HealthMonitor, ensureConnected: () => Promise<boolean>);
+    constructor(server: ResourceRegistryServer, bridge: UnrealBridge, automationBridge: AutomationBridge, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, healthMonitor: HealthMonitor, ensureConnected: () => Promise<boolean>);
     register(): void;
+    private buildExtendedReader;
+    private readEngineVersion;
 }
+export {};
 //# sourceMappingURL=resource-registry.d.ts.map