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

package/dist/tools/catalog/capabilities/retrieval/filter.js

@@ -0,0 +1,46 @@
+import { compareUnrealVersion } from '../version.js';
+import { compareById } from '../../../../utils/serialization/ordering.js';
+export const PILOT_PARENT_CATEGORIES = Object.freeze({
+    build_environment: 'world',
+    manage_asset: 'core',
+    manage_blueprint: 'core',
+    manage_sequence: 'utility',
+});
+function hasRequiredVersion(record, profile) {
+    return compareUnrealVersion(profile.unrealVersion, record.availability.unreal.min) >= 0
+        && compareUnrealVersion(profile.unrealVersion, record.availability.unreal.max) <= 0;
+}
+function hasRequiredPlugins(record, profile) {
+    const installed = new Set(profile.installedPlugins);
+    return record.availability.requiredPlugins.every((plugin) => installed.has(plugin));
+}
+function hasEnabledRoute(record, profile) {
+    const parent = record.routing.parentTool;
+    const category = PILOT_PARENT_CATEGORIES[parent];
+    return category !== undefined
+        && profile.enabledParents.includes(parent)
+        && profile.enabledCategories.includes(category);
+}
+function hasAuthorization(record, profile) {
+    return profile.authorizedScopes.includes('admin')
+        || profile.authorizedScopes.includes(record.policy.requiredScope);
+}
+function hasRequestedOutputs(record, profile) {
+    return profile.requiredOutputFields.every((field) => Object.hasOwn(record.schemas.output.properties, field));
+}
+export function isCapabilityAvailable(record, profile) {
+    return record.deprecation.status !== 'removed'
+        && hasRequiredVersion(record, profile)
+        && hasRequiredPlugins(record, profile)
+        && record.availability.editorStates.includes(profile.editorState)
+        && hasEnabledRoute(record, profile)
+        && hasAuthorization(record, profile)
+        && profile.requestedEffects.includes(record.behavior.effect)
+        && hasRequestedOutputs(record, profile);
+}
+export function filterCapabilityRecords(records, profile) {
+    return records
+        .filter((record) => isCapabilityAvailable(record, profile))
+        .sort(compareById);
+}
+//# sourceMappingURL=filter.js.map

package/dist/tools/catalog/capabilities/retrieval/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAClC,MAAM,CAAC,MAAM,CAAC;IACZ,iBAAiB,EAAE,OAAO;IAC1B,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,MAAM;IACxB,eAAe,EAAE,SAAS;CAC3B,CAAC,CAAC;AAEL,SAAS,kBAAkB,CACzB,MAAwB,EACxB,OAAiC;IAEjC,OAAO,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;WAClF,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAwB,EACxB,OAAiC;IAEjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,eAAe,CACtB,MAAwB,EACxB,OAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IACzC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,QAAQ,KAAK,SAAS;WACxB,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;WACvC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAwB,EACxB,OAAiC;IAEjC,OAAO,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC;WAC5C,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAwB,EACxB,OAAiC;IAEjC,OAAO,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAClD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAwB,EACxB,OAAiC;IAEjC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,SAAS;WACzC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC;WACnC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC;WACnC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;WAC9D,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;WAChC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;WACjC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;WACzD,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAoC,EACpC,OAAiC;IAEjC,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAC1D,IAAI,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/index.d.ts

@@ -0,0 +1,13 @@
+export type { CoreCapabilityCatalogSources, PilotCapabilityCatalogSources, } from './aggregate.js';
+export { CapabilityCatalogSizeError, CORE_CAPABILITY_CATALOG, CORE_CAPABILITY_RECORD_COUNT, createCoreCapabilityCatalog, createPilotCapabilityCatalog, PILOT_CAPABILITY_CATALOG, PILOT_CAPABILITY_RECORD_COUNT, } from './aggregate.js';
+export { DEFAULT_RESULT_LIMIT, MAX_MATCH_REASONS, MAX_REASON_TOKENS, MAX_RESULT_LIMIT, NEAR_TIE_RATIO, RETRIEVAL_FIELD_WEIGHTS, RETRIEVAL_PARITY_VECTOR_SCHEMA, RETRIEVAL_SCORE_CONSTANTS, RETRIEVAL_TOKENIZATION, SCORE_TIE_EPSILON, } from './constants.js';
+export { filterCapabilityRecords, isCapabilityAvailable, PILOT_PARENT_CATEGORIES, } from './filter.js';
+export type { CapabilityParityVectorInput } from './parity.js';
+export { createCapabilityRetrievalParityVector } from './parity.js';
+export { CAPABILITY_CATEGORIES, CapabilityRetrievalRequestSchema, CapabilityRuntimeProfileSchema, parseCapabilityRetrievalRequest, parseCapabilityRuntimeProfile, } from './request.js';
+export { createCapabilityRetriever, PILOT_CAPABILITY_RETRIEVER, retrieveCapabilities, } from './retriever.js';
+export type { CapabilitySearchIndex, RankedCapability, } from './scoring.js';
+export { createCapabilitySearchIndex, isNearTieScore, rankCapabilityRecords, } from './scoring.js';
+export { tokenizeCapabilityText, uniqueCapabilityTokens, } from './tokenize.js';
+export type { CapabilityAvailabilitySummary, CapabilityCategory, CapabilityDescribeNextCall, CapabilityEditorState, CapabilityEffect, CapabilityMatchField, CapabilityMatchReason, CapabilityPolicyScope, CapabilityRetrievalMatch, CapabilityRetrievalParityVector, CapabilityRetrievalRequest, CapabilityRetrievalResult, CapabilityRetriever, CapabilityRuntimeProfile, CapabilitySelection, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,qCAAqC,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,6BAA6B,EAC7B,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/index.js

@@ -0,0 +1,9 @@
+export { CapabilityCatalogSizeError, CORE_CAPABILITY_CATALOG, CORE_CAPABILITY_RECORD_COUNT, createCoreCapabilityCatalog, createPilotCapabilityCatalog, PILOT_CAPABILITY_CATALOG, PILOT_CAPABILITY_RECORD_COUNT, } from './aggregate.js';
+export { DEFAULT_RESULT_LIMIT, MAX_MATCH_REASONS, MAX_REASON_TOKENS, MAX_RESULT_LIMIT, NEAR_TIE_RATIO, RETRIEVAL_FIELD_WEIGHTS, RETRIEVAL_PARITY_VECTOR_SCHEMA, RETRIEVAL_SCORE_CONSTANTS, RETRIEVAL_TOKENIZATION, SCORE_TIE_EPSILON, } from './constants.js';
+export { filterCapabilityRecords, isCapabilityAvailable, PILOT_PARENT_CATEGORIES, } from './filter.js';
+export { createCapabilityRetrievalParityVector } from './parity.js';
+export { CAPABILITY_CATEGORIES, CapabilityRetrievalRequestSchema, CapabilityRuntimeProfileSchema, parseCapabilityRetrievalRequest, parseCapabilityRuntimeProfile, } from './request.js';
+export { createCapabilityRetriever, PILOT_CAPABILITY_RETRIEVER, retrieveCapabilities, } from './retriever.js';
+export { createCapabilitySearchIndex, isNearTieScore, rankCapabilityRecords, } from './scoring.js';
+export { tokenizeCapabilityText, uniqueCapabilityTokens, } from './tokenize.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/catalog/capabilities/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qCAAqC,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/parity.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilityRetrievalParityVector, CapabilityRetrievalResult } from './types.js';
+export type CapabilityParityVectorInput = {
+    readonly name: string;
+    readonly request: unknown;
+    readonly result: CapabilityRetrievalResult;
+};
+export declare function createCapabilityRetrievalParityVector(input: CapabilityParityVectorInput): CapabilityRetrievalParityVector;
+//# sourceMappingURL=parity.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/parity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;CAC5C,CAAC;AAEF,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,2BAA2B,GACjC,+BAA+B,CAYjC"}

package/dist/tools/catalog/capabilities/retrieval/parity.js

@@ -0,0 +1,16 @@
+import { RETRIEVAL_PARITY_VECTOR_SCHEMA } from './constants.js';
+import { parseCapabilityRetrievalRequest } from './request.js';
+export function createCapabilityRetrievalParityVector(input) {
+    const request = parseCapabilityRetrievalRequest(input.request);
+    return Object.freeze({
+        schema: RETRIEVAL_PARITY_VECTOR_SCHEMA,
+        name: input.name,
+        request,
+        expected: Object.freeze({
+            rankedCapabilityIds: Object.freeze(input.result.matches.map((match) => match.id)),
+            nearTieCapabilityIds: Object.freeze([...input.result.nearTieCapabilityIds]),
+            selection: input.result.selection,
+        }),
+    });
+}
+//# sourceMappingURL=parity.js.map

package/dist/tools/catalog/capabilities/retrieval/parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/parity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAY/D,MAAM,UAAU,qCAAqC,CACnD,KAAkC;IAElC,MAAM,OAAO,GAAG,+BAA+B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,8BAA8B;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjF,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC3E,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;SAClC,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/request.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import type { CapabilityRetrievalRequest, CapabilityRuntimeProfile } from './types.js';
+export declare const CAPABILITY_CATEGORIES: readonly ["core", "world", "gameplay", "utility"];
+export declare const CapabilityRuntimeProfileSchema: z.ZodReadonly<z.ZodObject<{
+    unrealVersion: z.ZodReadonly<z.ZodObject<{
+        major: z.ZodLiteral<5>;
+        minor: z.ZodNumber;
+        patch: z.ZodNumber;
+        channel: z.ZodEnum<{
+            stable: "stable";
+            preview: "preview";
+        }>;
+        preview: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    installedPlugins: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    editorState: z.ZodEnum<{
+        edit: "edit";
+        pie: "pie";
+        simulate: "simulate";
+    }>;
+    enabledParents: z.ZodReadonly<z.ZodArray<z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">>>;
+    enabledCategories: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        core: "core";
+        world: "world";
+        gameplay: "gameplay";
+        utility: "utility";
+    }>>>;
+    authorizedScopes: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        read: "read";
+        write: "write";
+        destructive: "destructive";
+        admin: "admin";
+    }>>>;
+    requestedEffects: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        read: "read";
+        write: "write";
+        destructive: "destructive";
+    }>>>;
+    requiredOutputFields: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>>;
+export declare const CapabilityRetrievalRequestSchema: z.ZodReadonly<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    profile: z.ZodReadonly<z.ZodObject<{
+        unrealVersion: z.ZodReadonly<z.ZodObject<{
+            major: z.ZodLiteral<5>;
+            minor: z.ZodNumber;
+            patch: z.ZodNumber;
+            channel: z.ZodEnum<{
+                stable: "stable";
+                preview: "preview";
+            }>;
+            preview: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        installedPlugins: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        editorState: z.ZodEnum<{
+            edit: "edit";
+            pie: "pie";
+            simulate: "simulate";
+        }>;
+        enabledParents: z.ZodReadonly<z.ZodArray<z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">>>;
+        enabledCategories: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            core: "core";
+            world: "world";
+            gameplay: "gameplay";
+            utility: "utility";
+        }>>>;
+        authorizedScopes: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            read: "read";
+            write: "write";
+            destructive: "destructive";
+            admin: "admin";
+        }>>>;
+        requestedEffects: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            read: "read";
+            write: "write";
+            destructive: "destructive";
+        }>>>;
+        requiredOutputFields: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare function parseCapabilityRuntimeProfile(input: unknown): CapabilityRuntimeProfile;
+export declare function parseCapabilityRetrievalRequest(input: unknown): CapabilityRetrievalRequest;
+//# sourceMappingURL=request.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,qBAAqB,mDAAoD,CAAC;AA2CvF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAS9B,CAAC;AAEd,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAIhC,CAAC;AAEd,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAEtF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAE1F"}

package/dist/tools/catalog/capabilities/retrieval/request.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { BEHAVIOR_EFFECTS, EDITOR_STATES, POLICY_SCOPES, } from '../constants.js';
+import { LegacyToolNameSchema, UnrealVersionSchema } from '../identifiers.js';
+import { DEFAULT_RESULT_LIMIT, MAX_RESULT_LIMIT, RETRIEVAL_TOKENIZATION, } from './constants.js';
+export const CAPABILITY_CATEGORIES = ['core', 'world', 'gameplay', 'utility'];
+function rejectDuplicates(values, context) {
+    const seen = new Set();
+    for (const [index, value] of values.entries()) {
+        if (seen.has(value)) {
+            context.addIssue({
+                code: 'custom',
+                path: [index],
+                message: `duplicate value: ${value}`,
+            });
+            continue;
+        }
+        seen.add(value);
+    }
+}
+const pluginListSchema = z.array(z.string().min(1).max(128))
+    .max(128)
+    .superRefine(rejectDuplicates)
+    .readonly();
+const parentListSchema = z.array(LegacyToolNameSchema)
+    .max(64)
+    .superRefine(rejectDuplicates)
+    .readonly();
+const categoryListSchema = z.array(z.enum(CAPABILITY_CATEGORIES))
+    .max(CAPABILITY_CATEGORIES.length)
+    .superRefine(rejectDuplicates)
+    .readonly();
+const scopeListSchema = z.array(z.enum(POLICY_SCOPES))
+    .max(POLICY_SCOPES.length)
+    .superRefine(rejectDuplicates)
+    .readonly();
+const effectListSchema = z.array(z.enum(BEHAVIOR_EFFECTS))
+    .min(1)
+    .max(BEHAVIOR_EFFECTS.length)
+    .superRefine(rejectDuplicates)
+    .readonly();
+const outputFieldListSchema = z.array(z.string().min(1).max(128))
+    .max(32)
+    .superRefine(rejectDuplicates)
+    .readonly();
+export const CapabilityRuntimeProfileSchema = z.strictObject({
+    unrealVersion: UnrealVersionSchema,
+    installedPlugins: pluginListSchema,
+    editorState: z.enum(EDITOR_STATES),
+    enabledParents: parentListSchema,
+    enabledCategories: categoryListSchema,
+    authorizedScopes: scopeListSchema,
+    requestedEffects: effectListSchema,
+    requiredOutputFields: outputFieldListSchema,
+}).readonly();
+export const CapabilityRetrievalRequestSchema = z.strictObject({
+    query: z.string().max(RETRIEVAL_TOKENIZATION.maxQueryLength),
+    limit: z.number().int().min(1).max(MAX_RESULT_LIMIT).default(DEFAULT_RESULT_LIMIT),
+    profile: CapabilityRuntimeProfileSchema,
+}).readonly();
+export function parseCapabilityRuntimeProfile(input) {
+    return CapabilityRuntimeProfileSchema.parse(input);
+}
+export function parseCapabilityRetrievalRequest(input) {
+    return CapabilityRetrievalRequestSchema.parse(input);
+}
+//# sourceMappingURL=request.js.map

package/dist/tools/catalog/capabilities/retrieval/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/request.ts"],"names":[],"mappings":"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"}

package/dist/tools/catalog/capabilities/retrieval/retriever.d.ts

@@ -0,0 +1,6 @@
+import type { CapabilityRecord } from '../model.js';
+import type { CapabilityRetrievalResult, CapabilityRetriever } from './types.js';
+export declare function createCapabilityRetriever(inputRecords: readonly CapabilityRecord[]): CapabilityRetriever;
+export declare const PILOT_CAPABILITY_RETRIEVER: CapabilityRetriever;
+export declare function retrieveCapabilities(input: unknown): CapabilityRetrievalResult;
+//# sourceMappingURL=retriever.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/retriever.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAapD,OAAO,KAAK,EAEV,yBAAyB,EACzB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAgDpB,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,SAAS,gBAAgB,EAAE,GACxC,mBAAmB,CA4BrB;AAED,eAAO,MAAM,0BAA0B,qBAEtC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAE9E"}

package/dist/tools/catalog/capabilities/retrieval/retriever.js

@@ -0,0 +1,81 @@
+import { parseCapabilityCatalog } from '../parser.js';
+import { PILOT_CAPABILITY_CATALOG } from './aggregate.js';
+import { RETRIEVAL_SCORE_CONSTANTS } from './constants.js';
+import { filterCapabilityRecords } from './filter.js';
+import { parseCapabilityRetrievalRequest } from './request.js';
+import { createCapabilitySearchIndex, isNearTieScore, rankCapabilityRecords, } from './scoring.js';
+import { uniqueCapabilityTokens } from './tokenize.js';
+import { compareAscii } from '../../../../utils/serialization/ordering.js';
+function toMatch(ranked) {
+    const record = ranked.record;
+    return Object.freeze({
+        id: record.id,
+        score: ranked.score,
+        confidence: ranked.confidence,
+        effect: record.behavior.effect,
+        reasons: ranked.reasons,
+        availability: Object.freeze({
+            status: 'available',
+            unreal: Object.freeze({
+                min: record.availability.unreal.min,
+                max: record.availability.unreal.max,
+            }),
+            requiredPlugins: Object.freeze([...record.availability.requiredPlugins].sort(compareAscii)),
+            editorStates: Object.freeze([...record.availability.editorStates].sort(compareAscii)),
+        }),
+        nextCall: Object.freeze({
+            operation: 'describe',
+            capability: record.id,
+        }),
+    });
+}
+function selectCapability(ranked, nearTies) {
+    const top = ranked[0];
+    if (top === undefined)
+        return Object.freeze({ kind: 'none', reason: 'no_match' });
+    const destructiveNearTie = nearTies.length >= 2
+        && nearTies.some((entry) => entry.record.behavior.effect === 'destructive');
+    if (destructiveNearTie) {
+        return Object.freeze({ kind: 'none', reason: 'destructive_near_tie' });
+    }
+    if (top.confidence < RETRIEVAL_SCORE_CONSTANTS.minimumAutoSelectConfidence) {
+        return Object.freeze({ kind: 'none', reason: 'low_confidence' });
+    }
+    return Object.freeze({
+        kind: 'selected',
+        capability: top.record.id,
+        requiresConfirmation: top.record.policy.consent !== 'none',
+    });
+}
+export function createCapabilityRetriever(inputRecords) {
+    const records = Object.freeze([...parseCapabilityCatalog([...inputRecords])]);
+    const index = createCapabilitySearchIndex(records);
+    return Object.freeze({
+        retrieve(input) {
+            const request = parseCapabilityRetrievalRequest(input);
+            if (uniqueCapabilityTokens(request.query).length === 0) {
+                return Object.freeze({
+                    matches: Object.freeze([]),
+                    nearTieCapabilityIds: Object.freeze([]),
+                    selection: Object.freeze({ kind: 'none', reason: 'empty_query' }),
+                });
+            }
+            const available = filterCapabilityRecords(records, request.profile);
+            const ranked = rankCapabilityRecords(index, available, request.query);
+            const top = ranked[0];
+            const nearTies = top === undefined
+                ? []
+                : ranked.filter((candidate) => isNearTieScore(top.score, candidate.score));
+            return Object.freeze({
+                matches: Object.freeze(ranked.slice(0, request.limit).map(toMatch)),
+                nearTieCapabilityIds: Object.freeze(nearTies.slice(0, request.limit).map((entry) => entry.record.id)),
+                selection: selectCapability(ranked, nearTies),
+            });
+        },
+    });
+}
+export const PILOT_CAPABILITY_RETRIEVER = createCapabilityRetriever(PILOT_CAPABILITY_CATALOG);
+export function retrieveCapabilities(input) {
+    return PILOT_CAPABILITY_RETRIEVER.retrieve(input);
+}
+//# sourceMappingURL=retriever.js.map

package/dist/tools/catalog/capabilities/retrieval/retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/retriever.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,2BAA2B,EAC3B,cAAc,EAEd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAOvD,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAE3E,SAAS,OAAO,CAAC,MAAwB;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,WAAoB;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACpB,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG;gBACnC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG;aACpC,CAAC;YACF,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3F,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SACtF,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,UAAmB;YAC9B,UAAU,EAAE,MAAM,CAAC,EAAE;SACtB,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAmC,EACnC,QAAqC;IAErC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClF,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC;WAC1C,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IAC9E,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,GAAG,yBAAyB,CAAC,2BAA2B,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;QACzB,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,YAAyC;IAEzC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,CAAC,KAAc;YACrB,MAAM,OAAO,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;iBAClE,CAAC,CAAC;YACL,CAAC;YACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,GAAG,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACnE,oBAAoB,EAAE,MAAM,CAAC,MAAM,CACjC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CACjE;gBACD,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CACjE,wBAAwB,CACzB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,0BAA0B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/scoring-index.d.ts

@@ -0,0 +1,4 @@
+import type { CapabilityRecord } from '../model.js';
+import { type CapabilitySearchIndex } from './scoring-types.js';
+export declare function createCapabilitySearchIndex(records: readonly CapabilityRecord[]): CapabilitySearchIndex;
+//# sourceMappingURL=scoring-index.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/scoring-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/scoring-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASpD,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,oBAAoB,CAAC;AA6G5B,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,qBAAqB,CAgEvB"}

package/dist/tools/catalog/capabilities/retrieval/scoring-index.js

@@ -0,0 +1,124 @@
+import { compareAscii as compareCanonicalCapabilityIds } from '../../../../utils/serialization/ordering.js';
+import { deriveAliasFold } from './alias-fold.js';
+import { RETRIEVAL_FIELD_WEIGHTS, RETRIEVAL_NAME_FIELDS, } from './constants.js';
+import { tokenizeCapabilityText, uniqueCapabilityTokens } from './tokenize.js';
+function aliasAction(alias) {
+    return alias.slice(alias.lastIndexOf('.') + 1);
+}
+function indexedField(field, values) {
+    const every = values.flatMap((value) => tokenizeCapabilityText(value));
+    const tokens = RETRIEVAL_NAME_FIELDS.has(field) ? [...new Set(every)] : every;
+    const counts = new Map();
+    for (const token of tokens)
+        counts.set(token, (counts.get(token) ?? 0) + 1);
+    return Object.freeze({ field, tokens: Object.freeze(tokens), counts });
+}
+function searchFields(record, absorbed) {
+    const foldedActions = new Set(record.legacyIds.filter((legacy) => legacy.folded !== undefined).map((legacy) => String(legacy.action)));
+    const declaredAliases = record.aliases.filter((alias) => !foldedActions.has(aliasAction(String(alias))));
+    return Object.freeze([
+        indexedField('canonical_id', [record.id]),
+        indexedField('alias', [
+            ...declaredAliases,
+            ...absorbed.map((alias) => String(alias.id)),
+            ...absorbed.flatMap((alias) => alias.aliases),
+        ]),
+        indexedField('legacy_tool', record.legacyIds.map((legacy) => legacy.tool)),
+        indexedField('legacy_action', [
+            ...record.legacyIds.map((legacy) => legacy.action),
+            ...absorbed.flatMap((alias) => alias.legacyIds.map((legacy) => legacy.action)),
+            ...record.aliases.map((alias) => aliasAction(String(alias))),
+        ]),
+        indexedField('domain', [record.discovery.domain]),
+        indexedField('family', [record.discovery.family]),
+        indexedField('topic', record.discovery.topics),
+        indexedField('summary', [record.discovery.summary]),
+        indexedField('when_to_use', record.discovery.whenToUse),
+        indexedField('when_not_to_use', record.discovery.whenNotToUse),
+    ]);
+}
+function projectionKey(field) {
+    return [...field.counts]
+        .sort(([left], [right]) => compareCanonicalCapabilityIds(left, right))
+        .map(([token, count]) => `${token}\u0000${count}`)
+        .join('\u0001');
+}
+function collapseProjections(fields) {
+    const strongest = new Map();
+    for (const field of fields) {
+        if (field.tokens.length === 0)
+            continue;
+        const key = projectionKey(field);
+        const held = strongest.get(key);
+        if (held === undefined || outranks(field, held))
+            strongest.set(key, field);
+    }
+    const kept = new Set(strongest.values());
+    return Object.freeze(fields.filter((field) => kept.has(field)));
+}
+function outranks(candidate, held) {
+    const difference = RETRIEVAL_FIELD_WEIGHTS[candidate.field] - RETRIEVAL_FIELD_WEIGHTS[held.field];
+    if (difference !== 0)
+        return difference > 0;
+    return compareCanonicalCapabilityIds(candidate.field, held.field) < 0;
+}
+function identifierSequences(record) {
+    return Object.freeze([
+        ...record.legacyIds.map((legacy) => tokenizeCapabilityText(legacy.action)),
+        ...record.aliases.map((alias) => tokenizeCapabilityText(aliasAction(String(alias)))),
+        tokenizeCapabilityText(record.id),
+    ]);
+}
+export function createCapabilitySearchIndex(records) {
+    const aliasFold = deriveAliasFold(records);
+    const documents = records
+        .filter((record) => !aliasFold.targets.has(String(record.id)))
+        .map((record) => {
+        const absorbed = aliasFold.absorbed.get(String(record.id)) ?? [];
+        const legacy = [...record.legacyIds, ...absorbed.flatMap((alias) => alias.legacyIds)];
+        const fields = searchFields(record, absorbed);
+        const aliases = [
+            ...record.aliases,
+            ...absorbed.map((alias) => String(alias.id)),
+            ...absorbed.flatMap((alias) => alias.aliases),
+        ];
+        return Object.freeze({
+            record,
+            fields,
+            scoredFields: collapseProjections(fields),
+            sequences: identifierSequences(record),
+            idTokens: tokenizeCapabilityText(record.id),
+            aliasTokens: Object.freeze(aliases.map((alias) => tokenizeCapabilityText(alias))),
+            aliasActionTokens: Object.freeze(aliases.map((alias) => tokenizeCapabilityText(aliasAction(alias)))),
+            legacyPairTokens: Object.freeze(legacy.map((entry) => tokenizeCapabilityText(`${entry.tool} ${entry.action}`))),
+            legacyActionTokens: Object.freeze(legacy.map((entry) => tokenizeCapabilityText(entry.action))),
+            actionTokenSets: Object.freeze([
+                ...record.legacyIds.map((entry) => uniqueCapabilityTokens(entry.action)),
+                ...record.aliases.map((alias) => uniqueCapabilityTokens(aliasAction(String(alias)))),
+            ]),
+        });
+    })
+        .sort((left, right) => compareCanonicalCapabilityIds(left.record.id, right.record.id));
+    const documentFrequency = new Map();
+    const fieldLengths = new Map();
+    for (const document of documents) {
+        const documentTokens = new Set(document.fields.flatMap((field) => field.tokens));
+        for (const token of documentTokens) {
+            documentFrequency.set(token, (documentFrequency.get(token) ?? 0) + 1);
+        }
+        for (const field of document.fields) {
+            fieldLengths.set(field.field, (fieldLengths.get(field.field) ?? 0) + field.tokens.length);
+        }
+    }
+    const averageFieldLengths = new Map();
+    for (const [field, length] of fieldLengths) {
+        averageFieldLengths.set(field, documents.length === 0 ? 1 : length / documents.length);
+    }
+    return Object.freeze({
+        documents: Object.freeze(documents),
+        documentFrequency,
+        averageFieldLengths,
+        aliasFold,
+    });
+}
+//# sourceMappingURL=scoring-index.js.map

package/dist/tools/catalog/capabilities/retrieval/scoring-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-index.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/scoring-index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,IAAI,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAS/E,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAMD,SAAS,YAAY,CAAC,KAA2B,EAAE,MAAyB;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACzE,CAAC;AAWD,SAAS,YAAY,CACnB,MAAwB,EACxB,QAAqC;IAKrC,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CACxG,CAAC;IACF,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,YAAY,CAAC,OAAO,EAAE;YACpB,GAAG,eAAe;YAClB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5C,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SAC9C,CAAC;QACF,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1E,YAAY,CAAC,eAAe,EAAE;YAC5B,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;YAClD,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9E,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;SAC7D,CAAC;QACF,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjD,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjD,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;QAC9C,YAAY,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QACvD,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAmB;IACxC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,KAAK,EAAE,CAAC;SACjD,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC;AAWD,SAAS,mBAAmB,CAAC,MAA+B;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACxC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,SAAuB,EAAE,IAAkB;IAC3D,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClG,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,UAAU,GAAG,CAAC,CAAC;IAC5C,OAAO,6BAA6B,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAQD,SAAS,mBAAmB,CAAC,MAAwB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1E,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpF,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAoC;IAEpC,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO;SACtB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;SAC7D,GAAG,CAAC,CAAC,MAAM,EAAqB,EAAE;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG;YACd,GAAG,MAAM,CAAC,OAAO;YACjB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5C,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SAC9C,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM;YACN,MAAM;YACN,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACzC,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACtC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CACnE;YACD,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAC/E;YACD,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAC5D;YAMD,eAAe,EAAE,MAAM,CAAC,MAAM,CAC5B;gBACE,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACxE,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACrF,CACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACzF,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC7D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACjF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAgC,CAAC;IACpE,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC3C,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,iBAAiB;QACjB,mBAAmB;QACnB,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/catalog/capabilities/retrieval/scoring-match.d.ts

@@ -0,0 +1,3 @@
+import { type IndexedCapability, type RankedCapability, type ScoreContext } from './scoring-types.js';
+export declare function scoreDocument(document: IndexedCapability, context: ScoreContext): RankedCapability | null;
+//# sourceMappingURL=scoring-match.d.ts.map

package/dist/tools/catalog/capabilities/retrieval/scoring-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-match.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/retrieval/scoring-match.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAsJ5B,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,YAAY,GACpB,gBAAgB,GAAG,IAAI,CAiCzB"}