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

package/dist/server/gateway/gateway-capability-view.js.map

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

package/dist/server/gateway/gateway-describe-browse.d.ts

@@ -0,0 +1,14 @@
+declare const DEFAULT_BROWSE_LIMIT = 50;
+type Page = {
+    readonly limit: number;
+    readonly offset: number;
+};
+export declare function describeCatalog(page: Page): Record<string, unknown>;
+export declare function unknownDomainError(domain: string): Record<string, unknown>;
+export declare function unknownFamilyError(domain: string, family: string): Record<string, unknown>;
+export declare function describeDomain(domain: string, page: Page): Record<string, unknown>;
+export declare function describeFamily(domain: string, family: string, page: Page): Record<string, unknown>;
+export declare function resolveDomainForFamily(family: string): string | undefined;
+export { DEFAULT_BROWSE_LIMIT };
+export type { Page };
+//# sourceMappingURL=gateway-describe-browse.d.ts.map

package/dist/server/gateway/gateway-describe-browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-describe-browse.d.ts","sourceRoot":"","sources":["../../../src/server/gateway/gateway-describe-browse.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,oBAAoB,KAAK,CAAC;AAEhC,KAAK,IAAI,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAWhE,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBnE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM1E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS1F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBlF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BlG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAChC,YAAY,EAAE,IAAI,EAAE,CAAC"}

package/dist/server/gateway/gateway-describe-browse.js

@@ -0,0 +1,110 @@
+import { capabilitiesInFamily, capabilityIndex, catalogRevision } from './gateway-capability-index.js';
+import { capabilityAvailability } from './gateway-availability.js';
+import { primaryExecutableAction } from './gateway-capability-view.js';
+import { closestMatches, MAX_SUGGESTIONS } from './gateway-guidance.js';
+import { gatewayError } from './gateway-shared.js';
+const DEFAULT_BROWSE_LIMIT = 50;
+function paged(entries, page) {
+    const rows = entries.slice(page.offset, page.offset + page.limit);
+    return { rows, hasMore: page.offset + rows.length < entries.length };
+}
+function browseEnvelope(scope, extra) {
+    return { success: true, operation: 'describe', catalogRevision: catalogRevision(), scope, ...extra };
+}
+export function describeCatalog(page) {
+    const index = capabilityIndex();
+    const counts = new Map();
+    for (const record of index.records) {
+        counts.set(record.discovery.domain, (counts.get(record.discovery.domain) ?? 0) + 1);
+    }
+    const { rows, hasMore } = paged(index.domains, page);
+    return browseEnvelope('catalog', {
+        domains: rows.map((domain) => ({
+            domain,
+            capabilityCount: counts.get(domain) ?? 0,
+            familyCount: (index.familiesByDomain.get(domain) ?? []).length,
+            nextCall: { operation: 'describe', domain }
+        })),
+        domainCount: index.domains.length,
+        domainOffset: page.offset,
+        domainLimit: page.limit,
+        domainHasMore: hasMore,
+        capabilityCount: index.records.length,
+        message: 'Catalog domains. Drill into a domain to list its families, then a family to list capabilities.'
+    });
+}
+export function unknownDomainError(domain) {
+    return {
+        ...gatewayError('describe', 'UNKNOWN_DOMAIN', `Unknown domain '${domain}'.`),
+        suggestions: closestMatches(domain, [...capabilityIndex().domains], MAX_SUGGESTIONS),
+        nextCall: { operation: 'describe' }
+    };
+}
+export function unknownFamilyError(domain, family) {
+    const families = capabilityIndex().familiesByDomain.get(domain) ?? [];
+    return {
+        ...gatewayError('describe', 'UNKNOWN_FAMILY', `Unknown family '${family}' in domain '${domain}'.`),
+        domain,
+        availableFamilies: families,
+        suggestions: closestMatches(family, [...families], MAX_SUGGESTIONS),
+        nextCall: { operation: 'describe', domain }
+    };
+}
+export function describeDomain(domain, page) {
+    const index = capabilityIndex();
+    if (!index.domains.includes(domain))
+        return unknownDomainError(domain);
+    const families = index.familiesByDomain.get(domain) ?? [];
+    const { rows, hasMore } = paged(families, page);
+    return browseEnvelope('domain', {
+        domain,
+        families: rows.map((family) => ({
+            family,
+            capabilityCount: capabilitiesInFamily(domain, family).length,
+            nextCall: { operation: 'describe', domain, family }
+        })),
+        familyCount: families.length,
+        familyOffset: page.offset,
+        familyLimit: page.limit,
+        familyHasMore: hasMore,
+        message: 'Domain families. Drill into a family to list its capabilities.'
+    });
+}
+export function describeFamily(domain, family, page) {
+    const index = capabilityIndex();
+    if (!index.domains.includes(domain))
+        return unknownDomainError(domain);
+    if (!(index.familiesByDomain.get(domain) ?? []).includes(family)) {
+        return unknownFamilyError(domain, family);
+    }
+    const records = capabilitiesInFamily(domain, family);
+    const { rows, hasMore } = paged(records, page);
+    return browseEnvelope('family', {
+        domain,
+        family,
+        capabilities: rows.map((record) => ({
+            capability: record.id,
+            parentTool: record.routing.parentTool,
+            action: primaryExecutableAction(record),
+            summary: record.discovery.summary,
+            effect: record.behavior.effect,
+            availability: capabilityAvailability(record).status,
+            nextCall: { operation: 'describe', capability: record.id }
+        })),
+        capabilityCount: records.length,
+        capabilityOffset: page.offset,
+        capabilityLimit: page.limit,
+        capabilityHasMore: hasMore,
+        message: 'Family capabilities. Drill into a capability for its exact contract.'
+    });
+}
+export function resolveDomainForFamily(family) {
+    const index = capabilityIndex();
+    for (const domain of index.domains) {
+        if ((index.familiesByDomain.get(domain) ?? []).includes(family))
+            return domain;
+    }
+    return undefined;
+}
+export { DEFAULT_BROWSE_LIMIT };
+//# sourceMappingURL=gateway-describe-browse.js.map

package/dist/server/gateway/gateway-describe-browse.js.map

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

package/dist/server/gateway/gateway-describe-capability.d.ts

@@ -0,0 +1,6 @@
+import type { CapabilityRecord } from '../../tools/catalog/capabilities/model.js';
+export declare function unknownCapabilityError(reference: string): Record<string, unknown>;
+export declare function describeCapabilityRecord(record: CapabilityRecord, origin: Record<string, unknown>): Record<string, unknown>;
+export declare function describeCapabilityParameter(record: CapabilityRecord, param: string, origin: Record<string, unknown>): Record<string, unknown>;
+export declare function describeCapabilityReference(reference: string, param: string | undefined): Record<string, unknown>;
+//# sourceMappingURL=gateway-describe-capability.d.ts.map

package/dist/server/gateway/gateway-describe-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-describe-capability.d.ts","sourceRoot":"","sources":["../../../src/server/gateway/gateway-describe-capability.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAalF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/server/gateway/gateway-describe-capability.js

@@ -0,0 +1,72 @@
+import { catalogRevision, resolveCapability, allCapabilityIds } from './gateway-capability-index.js';
+import { capabilityConsentGrant, capabilityContract, declaredParameterNames, isRequiredParameter, parameterSchema, primaryExecutableAction } from './gateway-capability-view.js';
+import { closestMatches, MAX_SUGGESTIONS } from './gateway-guidance.js';
+import { gatewayError } from './gateway-shared.js';
+export function unknownCapabilityError(reference) {
+    const suggestions = closestMatches(reference, [...allCapabilityIds()], MAX_SUGGESTIONS);
+    const nextCall = suggestions.length > 0
+        ? { operation: 'describe', capability: suggestions[0] }
+        : { operation: 'search', query: reference };
+    return {
+        ...gatewayError('describe', 'UNKNOWN_CAPABILITY', `Unknown capability '${reference}'. Call search to find canonical capability IDs.`),
+        suggestions,
+        nextCall
+    };
+}
+function unknownParamError(record, param) {
+    const declared = declaredParameterNames(record);
+    const suggestions = closestMatches(param, [...declared], MAX_SUGGESTIONS);
+    const nextCall = { operation: 'describe', capability: record.id };
+    if (suggestions.length > 0)
+        nextCall.param = suggestions[0];
+    return {
+        ...gatewayError('describe', 'UNKNOWN_PARAM', `Unknown parameter '${param}' for capability '${record.id}'.`),
+        capability: record.id,
+        availableParameters: declared,
+        suggestions,
+        nextCall
+    };
+}
+export function describeCapabilityRecord(record, origin) {
+    return {
+        success: true,
+        operation: 'describe',
+        catalogRevision: catalogRevision(),
+        ...capabilityContract(record),
+        ...origin,
+        message: 'Exact capability contract. inputSchema declares every parameter this action accepts.'
+    };
+}
+export function describeCapabilityParameter(record, param, origin) {
+    if (!declaredParameterNames(record).includes(param))
+        return unknownParamError(record, param);
+    const consentGrant = capabilityConsentGrant(record);
+    return {
+        success: true,
+        operation: 'describe',
+        catalogRevision: catalogRevision(),
+        scope: 'parameter',
+        capability: record.id,
+        ...(consentGrant ? { consentGrant } : {}),
+        parentTool: record.routing.parentTool,
+        action: primaryExecutableAction(record),
+        param,
+        required: isRequiredParameter(record, param),
+        schema: parameterSchema(record, param) ?? {},
+        perActionSchemas: true,
+        ...origin,
+        message: 'Single parameter schema for this capability. Pass it with the exact casing shown.'
+    };
+}
+export function describeCapabilityReference(reference, param) {
+    const resolved = resolveCapability(reference);
+    if (resolved.kind === 'unknown')
+        return unknownCapabilityError(reference);
+    const origin = resolved.kind === 'alias'
+        ? { resolvedFromAlias: resolved.alias }
+        : {};
+    return param === undefined
+        ? describeCapabilityRecord(resolved.record, origin)
+        : describeCapabilityParameter(resolved.record, param, origin);
+}
+//# sourceMappingURL=gateway-describe-capability.js.map

package/dist/server/gateway/gateway-describe-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-describe-capability.js","sourceRoot":"","sources":["../../../src/server/gateway/gateway-describe-capability.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACrG,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE;QACvD,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9C,OAAO;QACL,GAAG,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,uBAAuB,SAAS,kDAAkD,CAAC;QACrI,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwB,EAAE,KAAa;IAChE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAA4B,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IAC3F,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO;QACL,GAAG,YAAY,CAAC,UAAU,EAAE,eAAe,EAAE,sBAAsB,KAAK,qBAAqB,MAAM,CAAC,EAAE,IAAI,CAAC;QAC3G,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,mBAAmB,EAAE,QAAQ;QAC7B,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAwB,EACxB,MAA+B;IAE/B,OAAO;QACL,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,UAAU;QACrB,eAAe,EAAE,eAAe,EAAE;QAClC,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,MAAM;QACT,OAAO,EAAE,sFAAsF;KAChG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAwB,EACxB,KAAa,EACb,MAA+B;IAE/B,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAI7F,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,UAAU;QACrB,eAAe,EAAE,eAAe,EAAE;QAClC,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU;QACrC,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC;QACvC,KAAK;QACL,QAAQ,EAAE,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC;QAC5C,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE;QAC5C,gBAAgB,EAAE,IAAI;QACtB,GAAG,MAAM;QACT,OAAO,EAAE,mFAAmF;KAC7F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,KAAyB;IAEzB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC1E,MAAM,MAAM,GAA4B,QAAQ,CAAC,IAAI,KAAK,OAAO;QAC/D,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,KAAK,EAAE;QACvC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,wBAAwB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACnD,CAAC,CAAC,2BAA2B,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAClE,CAAC"}

package/dist/server/gateway/gateway-describe.d.ts

@@ -0,0 +1,2 @@
+export declare function describeGatewayCapability(args: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=gateway-describe.d.ts.map

package/dist/server/gateway/gateway-describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-describe.d.ts","sourceRoot":"","sources":["../../../src/server/gateway/gateway-describe.ts"],"names":[],"mappings":"AAqKA,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BhG"}

package/dist/server/gateway/gateway-describe.js

@@ -0,0 +1,111 @@
+import { dynamicToolManager } from '../../tools/dynamic/dynamic-tool-manager.js';
+import { resolveLegacyPair, resolveToolNamespace } from './gateway-capability-index.js';
+import { describeCapabilityParameter, describeCapabilityRecord, describeCapabilityReference } from './gateway-describe-capability.js';
+import { DEFAULT_BROWSE_LIMIT, describeCatalog, describeDomain, describeFamily, resolveDomainForFamily, unknownFamilyError } from './gateway-describe-browse.js';
+import { getString, getBoundedInteger, getOptionalBoundedInteger, gatewayError, findTool, allToolNames, getActionValues } from './gateway-shared.js';
+import { closestMatches, buildNextCall, MAX_SUGGESTIONS } from './gateway-guidance.js';
+const MAX_DESCRIBE_LIMIT = 50;
+function unknownToolError(toolArg) {
+    const error = gatewayError('describe', 'UNKNOWN_TOOL', 'Unknown tool. Call search to retrieve canonical tool names.');
+    const suggestions = closestMatches(toolArg ?? '', allToolNames(), MAX_SUGGESTIONS);
+    const nextCall = suggestions.length > 0
+        ? buildNextCall({ operation: 'describe', tool: suggestions[0] })
+        : buildNextCall({ operation: 'search' });
+    return { ...error, suggestions, nextCall };
+}
+function unknownActionError(toolName, actionArg, actions) {
+    const error = gatewayError('describe', 'UNKNOWN_ACTION', `Unknown action '${actionArg}' for ${toolName}.`);
+    const suggestions = closestMatches(actionArg, actions, MAX_SUGGESTIONS);
+    const nextCall = suggestions.length > 0
+        ? buildNextCall({ operation: 'describe', tool: toolName, action: suggestions[0] })
+        : buildNextCall({ operation: 'describe', tool: toolName });
+    return { ...error, tool: toolName, availableActions: actions, suggestions, nextCall };
+}
+function describeToolSummary(tool, query, requestedLimit, offset) {
+    const actions = getActionValues(tool);
+    const filtered = query.length === 0
+        ? actions
+        : actions.filter((name) => name.toLowerCase().includes(query));
+    const limit = requestedLimit ?? filtered.length;
+    const paged = filtered.slice(offset, offset + limit);
+    const first = paged[0] ?? actions[0];
+    return {
+        success: true,
+        operation: 'describe',
+        tool: tool.name,
+        category: tool.category,
+        description: tool.description,
+        enabled: dynamicToolManager.isToolEnabled(tool.name),
+        actions: paged,
+        actionCount: filtered.length,
+        actionOffset: offset,
+        actionLimit: limit,
+        actionHasMore: offset + paged.length < filtered.length,
+        scope: 'tool',
+        perActionSchemas: false,
+        drillDown: buildNextCall({ operation: 'describe', tool: tool.name, action: first }),
+        browse: { operation: 'search', tool: tool.name },
+        message: 'Legacy parent-tool summary: action names only. To choose one, send the browse call (search filtered to this tool; add query words and read the row summaries), or drill into an action for its exact contract.'
+    };
+}
+function describeLegacyPair(toolName, action, param) {
+    const resolved = resolveLegacyPair(toolName, action);
+    if (resolved.kind === 'unknown') {
+        const tool = findTool(toolName);
+        return tool === undefined
+            ? unknownToolError(toolName)
+            : unknownActionError(tool.name, action, getActionValues(tool));
+    }
+    const origin = { migratedFrom: { tool: toolName, action } };
+    return param === undefined
+        ? describeCapabilityRecord(resolved.record, origin)
+        : describeCapabilityParameter(resolved.record, param, origin);
+}
+function describeLegacyTool(toolName, args, page, query) {
+    const namespaceOwner = findTool(toolName) === undefined ? resolveToolNamespace(toolName) : undefined;
+    const resolvedName = namespaceOwner ?? toolName;
+    const action = getString(args, 'action');
+    if (action !== undefined)
+        return describeLegacyPair(resolvedName, action, getString(args, 'param'));
+    const tool = findTool(resolvedName);
+    if (tool === undefined)
+        return unknownToolError(toolName);
+    const requestedLimit = getOptionalBoundedInteger(args.limit, 1, MAX_DESCRIBE_LIMIT);
+    const summary = describeToolSummary(tool, query, requestedLimit, page.offset);
+    return namespaceOwner === undefined ? summary : { ...summary, resolvedFromNamespace: toolName };
+}
+function describeBrowse(domain, family, page) {
+    if (family !== undefined) {
+        const owningDomain = domain ?? resolveDomainForFamily(family);
+        if (owningDomain === undefined)
+            return unknownFamilyError(domain ?? '', family);
+        return describeFamily(owningDomain, family, page);
+    }
+    if (domain !== undefined)
+        return describeDomain(domain, page);
+    return describeCatalog(page);
+}
+function paramWithoutCapabilityError(toolArg) {
+    const error = gatewayError('describe', 'MISSING_ACTION', 'param selects one parameter of one capability, so it needs a capability, or a tool with an action.');
+    const nextCall = toolArg === undefined
+        ? buildNextCall({ operation: 'search' })
+        : buildNextCall({ operation: 'describe', tool: toolArg });
+    return { ...error, nextCall };
+}
+export function describeGatewayCapability(args) {
+    const query = (getString(args, 'query') ?? '').toLowerCase();
+    const offset = getBoundedInteger(args.offset ?? args.actionOffset, 0, 0, Number.MAX_SAFE_INTEGER);
+    const limit = getBoundedInteger(args.limit, DEFAULT_BROWSE_LIMIT, 1, MAX_DESCRIBE_LIMIT);
+    const page = { limit, offset };
+    const capability = getString(args, 'capability');
+    if (capability !== undefined)
+        return describeCapabilityReference(capability, getString(args, 'param'));
+    const toolArg = getString(args, 'tool');
+    if (getString(args, 'param') !== undefined && getString(args, 'action') === undefined) {
+        return paramWithoutCapabilityError(toolArg);
+    }
+    if (toolArg !== undefined)
+        return describeLegacyTool(toolArg, args, page, query);
+    return describeBrowse(getString(args, 'domain'), getString(args, 'family'), page);
+}
+//# sourceMappingURL=gateway-describe.js.map

package/dist/server/gateway/gateway-describe.js.map

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

package/dist/server/gateway/gateway-dispatch-by.d.ts

@@ -0,0 +1,7 @@
+import type { CapabilityRecord, LegacyCapabilityId } from '../../tools/catalog/capabilities/model.js';
+import type { ExecuteTarget } from './gateway-execute-resolve.js';
+export declare function requestedAction(target: ExecuteTarget): string | undefined;
+export declare function foldedPairFor(record: CapabilityRecord, action: string | undefined): LegacyCapabilityId | undefined;
+export declare function applyFoldedPins(target: ExecuteTarget, params: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function resolveDispatchAction(target: ExecuteTarget, params: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=gateway-dispatch-by.d.ts.map

package/dist/server/gateway/gateway-dispatch-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-dispatch-by.d.ts","sourceRoot":"","sources":["../../../src/server/gateway/gateway-dispatch-by.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEtG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,kBAAkB,GAAG,SAAS,CAGhC;AAcD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYrC;AAUD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,SAAS,CAUpB"}

package/dist/server/gateway/gateway-dispatch-by.js

@@ -0,0 +1,44 @@
+import { hasOwn } from '../../utils/validation/type-guards.js';
+export function requestedAction(target) {
+    if (target.migratedFrom !== undefined)
+        return target.migratedFrom.action;
+    if (target.resolvedFromAlias !== undefined) {
+        const alias = target.resolvedFromAlias;
+        return alias.slice(alias.lastIndexOf('.') + 1);
+    }
+    return undefined;
+}
+export function foldedPairFor(record, action) {
+    if (action === undefined)
+        return undefined;
+    return record.legacyIds.find((entry) => entry.action === action && entry.folded !== undefined);
+}
+export function applyFoldedPins(target, params) {
+    const folded = foldedPairFor(target.record, requestedAction(target));
+    if (folded?.folded === undefined)
+        return params;
+    const pinned = { ...params };
+    for (const [name, value] of Object.entries(folded.folded)) {
+        if (hasOwn(pinned, name)) {
+            if (pinned[name] !== value)
+                return undefined;
+            continue;
+        }
+        pinned[name] = value;
+    }
+    return pinned;
+}
+export function resolveDispatchAction(target, params) {
+    const folded = foldedPairFor(target.record, requestedAction(target));
+    if (folded !== undefined)
+        return folded.action;
+    const dispatchBy = target.record.routing.dispatchBy;
+    if (dispatchBy === undefined)
+        return target.legacy.action;
+    const value = params[dispatchBy.param];
+    const mapped = typeof value === 'string' && hasOwn(dispatchBy.actions, value)
+        ? dispatchBy.actions[value]
+        : undefined;
+    return mapped;
+}
+//# sourceMappingURL=gateway-dispatch-by.js.map

package/dist/server/gateway/gateway-dispatch-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-dispatch-by.js","sourceRoot":"","sources":["../../../src/server/gateway/gateway-dispatch-by.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAI/D,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;IACzE,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACvC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAwB,EACxB,MAA0B;IAE1B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;AACjG,CAAC;AAcD,MAAM,UAAU,eAAe,CAC7B,MAAqB,EACrB,MAA+B;IAE/B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAChD,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD,MAAM,UAAU,qBAAqB,CACnC,MAAqB,EACrB,MAA+B;IAE/B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IACpD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;QAC3E,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/gateway/gateway-execute-dispatch.d.ts

@@ -0,0 +1,12 @@
+import type { ITools } from '../../types/tools/tool-interfaces.js';
+import { Logger } from '../../utils/logging/logger.js';
+import type { ExecuteTarget } from './gateway-execute-resolve.js';
+import type { GatewayReceiptContext } from './gateway-receipt-context.js';
+export type GatewayContext = {
+    tools: ITools;
+    logger: Logger;
+    elicitationTimeoutMs: number;
+    ensureConnected: () => Promise<boolean>;
+};
+export declare function dispatchAndValidate(target: ExecuteTarget, params: Record<string, unknown>, options: Record<string, unknown> | undefined, context: GatewayContext, receiptContext: GatewayReceiptContext): Promise<Record<string, unknown>>;
+//# sourceMappingURL=gateway-execute-dispatch.d.ts.map

package/dist/server/gateway/gateway-execute-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-execute-dispatch.d.ts","sourceRoot":"","sources":["../../../src/server/gateway/gateway-execute-dispatch.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAInE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAkB1E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC,CAAC;AA2FF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,qBAAqB,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyGlC"}

package/dist/server/gateway/gateway-execute-dispatch.js

@@ -0,0 +1,160 @@
+import { cleanObject } from '../../utils/serialization/safe-json.js';
+import { isRecord } from '../../utils/validation/type-guards.js';
+import { maybeElicitMissingArgs } from '../tool-registry-elicitation.js';
+import { handleConsolidatedToolCall } from '../../tools/orchestration/consolidated-tool-handlers.js';
+import { validateAgainstCapabilitySchema } from './gateway-execute-validate.js';
+import { resolveDispatchAction } from './gateway-dispatch-by.js';
+import { buildNextCall } from './gateway-guidance.js';
+import { executeSuccessEnvelope, refuseWithTarget } from './gateway-execute-envelope.js';
+const MAX_EXECUTION_RESULT_CHARS = 100_000;
+const MAX_IMAGE_RESULT_CHARS = 6_000_000;
+const IMAGE_PAYLOAD_CAPABILITIES = new Set([
+    'control_editor.screenshot',
+    'control_editor.take_screenshot',
+    'system_control.screenshot'
+]);
+function projectCanonicalOutput(result, schema) {
+    if (!isRecord(result))
+        return result;
+    if (!isRecord(schema.properties))
+        return {};
+    const payload = isRecord(result.data) ? result.data : undefined;
+    const projected = {};
+    for (const name of Object.keys(schema.properties)) {
+        if (name in result)
+            projected[name] = result[name];
+        else if (payload !== undefined && name in payload)
+            projected[name] = payload[name];
+    }
+    if ('details' in schema.properties) {
+        const existing = isRecord(projected.details) ? projected.details : undefined;
+        const details = existing ? { ...existing } : {};
+        const fold = (source) => {
+            for (const [name, value] of Object.entries(source)) {
+                if (name === 'data' || name === 'requestId' || name === 'type' || name in schema.properties)
+                    continue;
+                if (!(name in details))
+                    details[name] = value;
+            }
+        };
+        fold(result);
+        if (payload !== undefined)
+            fold(payload);
+        if (Object.keys(details).length > 0)
+            projected.details = details;
+    }
+    return projected;
+}
+function handlerReportedFailure(result) {
+    return isRecord(result) && (result.success === false || result.isError === true);
+}
+function failureMessage(result) {
+    return isRecord(result) && typeof result.message === 'string'
+        ? result.message
+        : 'Unreal reported a failed execution.';
+}
+function failureString(result, key) {
+    if (!isRecord(result))
+        return undefined;
+    const value = result[key];
+    if (typeof value === 'string')
+        return value;
+    return typeof value === 'number' ? String(value) : undefined;
+}
+function deprecationWarnings(record) {
+    return record.deprecation.status === 'deprecated'
+        ? [`Capability '${record.id}' is deprecated: ${record.deprecation.guidance}`]
+        : [];
+}
+const HANDLER_CODE = /^[A-Z][A-Z0-9_]{0,63}$/;
+function readHandlerCode(result) {
+    for (const field of ['errorCode', 'error']) {
+        const value = failureString(result, field);
+        if (value !== undefined && HANDLER_CODE.test(value))
+            return value;
+    }
+    return undefined;
+}
+const NARROWING_PARAM = /filter|name|path|kind|type|limit|offset|page|cursor|count|max|top|depth/i;
+function narrowingGuidance(record, target) {
+    const properties = record.schemas.input.properties;
+    const filters = properties === undefined
+        ? []
+        : Object.keys(properties).filter((key) => NARROWING_PARAM.test(key)).slice(0, 6);
+    return {
+        ...(filters.length === 0 ? {} : { suggestions: filters.map((name) => `narrow with '${name}'`) }),
+        nextCall: buildNextCall({
+            operation: 'describe',
+            tool: record.routing.parentTool,
+            action: target.legacy.action
+        })
+    };
+}
+export async function dispatchAndValidate(target, params, options, context, receiptContext) {
+    const record = target.record;
+    const action = resolveDispatchAction(target, params);
+    if (action === undefined) {
+        return refuseWithTarget(target, {
+            errorCode: 'INVALID_PARAMETER_VALUE',
+            message: 'The selector value does not map to an action on this capability.',
+            nextCall: buildNextCall({
+                operation: 'describe',
+                tool: record.routing.parentTool,
+                action: target.legacy.action
+            })
+        }, receiptContext);
+    }
+    const targetArgs = await maybeElicitMissingArgs(record.routing.parentTool, { ...params, action, subAction: action }, context.tools.elicit, context.elicitationTimeoutMs, context.logger);
+    const result = cleanObject(await handleConsolidatedToolCall(record.routing.parentTool, targetArgs, context.tools));
+    const serialized = JSON.stringify(result);
+    const resultCharBudget = IMAGE_PAYLOAD_CAPABILITIES.has(record.id)
+        ? MAX_IMAGE_RESULT_CHARS
+        : MAX_EXECUTION_RESULT_CHARS;
+    const oversized = serialized !== undefined && serialized.length > resultCharBudget;
+    if (handlerReportedFailure(result)) {
+        const currentRevision = failureString(result, 'currentRevision');
+        const expectedRevision = failureString(result, 'expectedRevision');
+        const staleState = failureString(result, 'errorCode') === 'STALE_STATE'
+            || failureString(result, 'error') === 'STALE_STATE';
+        const handlerCode = staleState ? undefined : readHandlerCode(result);
+        return refuseWithTarget(target, {
+            errorCode: staleState ? 'STALE_STATE' : handlerCode ?? 'UNREAL_EXECUTION_ERROR',
+            message: failureMessage(result),
+            ...(handlerCode === undefined ? {} : { handlerCode }),
+            ...(staleState && currentRevision !== undefined ? { currentRevision } : {}),
+            ...(staleState && expectedRevision !== undefined ? { expectedRevision } : {}),
+            ...(oversized
+                ? { detailOmitted: true, resultChars: serialized?.length ?? 0 }
+                : { detail: result })
+        }, receiptContext);
+    }
+    if (oversized) {
+        const resultChars = serialized?.length ?? 0;
+        return refuseWithTarget(target, {
+            errorCode: 'RESULT_TOO_LARGE',
+            message: `Result exceeded the gateway safety limit (${resultChars} chars). Narrow the request with one of this capability's own filter parameters, then retry.`,
+            resultChars,
+            ...narrowingGuidance(record, target)
+        }, receiptContext);
+    }
+    const canonicalOutput = projectCanonicalOutput(result, record.schemas.output);
+    const violation = validateAgainstCapabilitySchema(canonicalOutput, record.schemas.output);
+    if (violation !== undefined) {
+        return refuseWithTarget(target, {
+            errorCode: 'OUTPUT_SCHEMA_VIOLATION',
+            message: `${record.id} returned a result that violates its declared output contract: ${violation.message}`,
+            pointer: violation.pointer,
+            detail: result
+        }, receiptContext);
+    }
+    return executeSuccessEnvelope({
+        record,
+        result,
+        canonicalOutput,
+        resolvedFromAlias: target.resolvedFromAlias,
+        migratedFrom: target.migratedFrom,
+        options,
+        warnings: deprecationWarnings(record)
+    }, receiptContext);
+}
+//# sourceMappingURL=gateway-execute-dispatch.js.map