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

package/dist/server/mcp-primitives/completions/completion-types.d.ts

@@ -0,0 +1,70 @@
+export interface PromptReference {
+    readonly type: 'ref/prompt';
+    readonly name: string;
+}
+export interface ResourceReference {
+    readonly type: 'ref/resource';
+    readonly uri: string;
+}
+export type CompletionReference = PromptReference | ResourceReference;
+export interface CompletionArgument {
+    readonly name: string;
+    readonly value: string;
+}
+export interface CompletionContext {
+    readonly arguments?: Readonly<Record<string, string>>;
+}
+export interface CompletionRequest {
+    readonly ref: CompletionReference;
+    readonly argument: CompletionArgument;
+    readonly context?: CompletionContext;
+}
+export interface CompletionResult {
+    readonly values: readonly string[];
+    readonly total: number;
+    readonly hasMore: boolean;
+}
+export declare const MAX_COMPLETION_ITEMS = 100;
+export declare const MAX_COMPLETION_BYTES = 8192;
+export declare const MAX_PREFIX_LENGTH = 128;
+export declare const CANDIDATE_KINDS: readonly ["capability", "legacy-id", "enum", "project-handle"];
+export type CandidateKind = (typeof CANDIDATE_KINDS)[number];
+export interface CompletionCandidate {
+    readonly value: string;
+    readonly kind: CandidateKind;
+    readonly capabilityId?: string;
+}
+export declare const SLOT_KINDS: readonly ["capability", "enum", "project-handle"];
+export type SlotKind = (typeof SLOT_KINDS)[number];
+export interface CompletionSlot {
+    readonly refType: CompletionReference['type'];
+    readonly refId: string;
+    readonly argumentName: string;
+    readonly kind: SlotKind;
+    readonly capabilityScoped: boolean;
+}
+export interface CompletionCandidateSource {
+    capabilityCandidates(): readonly CompletionCandidate[];
+    enumCandidates(slot: CompletionSlot): readonly CompletionCandidate[];
+    projectHandleCandidates(slot: CompletionSlot): readonly CompletionCandidate[];
+}
+export declare const COMPLETION_GUIDANCE_CODES: {
+    readonly SECRET_FIELD: "COMPLETION_SECRET_FIELD";
+    readonly DESTRUCTIVE_FIELD: "COMPLETION_DESTRUCTIVE_FIELD";
+    readonly UNBOUNDED_PREFIX: "COMPLETION_UNBOUNDED_PREFIX";
+    readonly UNBOUNDED_PATH: "COMPLETION_UNBOUNDED_PATH";
+    readonly UNAVAILABLE: "COMPLETION_UNAVAILABLE";
+    readonly NO_MATCH: "COMPLETION_NO_MATCH";
+};
+export type CompletionGuidanceCode = (typeof COMPLETION_GUIDANCE_CODES)[keyof typeof COMPLETION_GUIDANCE_CODES];
+export interface CompletionGuidance {
+    readonly code: CompletionGuidanceCode;
+    readonly reason: string;
+    readonly nextCall?: Readonly<Record<string, unknown>>;
+}
+export interface CompletionOutcome {
+    readonly completion: CompletionResult;
+    readonly guidance?: CompletionGuidance;
+}
+export declare const EMPTY_COMPLETION: CompletionResult;
+//# sourceMappingURL=completion-types.d.ts.map

package/dist/server/mcp-primitives/completions/completion-types.d.ts.map

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

package/dist/server/mcp-primitives/completions/completion-types.js

@@ -0,0 +1,19 @@
+export const MAX_COMPLETION_ITEMS = 100;
+export const MAX_COMPLETION_BYTES = 8192;
+export const MAX_PREFIX_LENGTH = 128;
+export const CANDIDATE_KINDS = ['capability', 'legacy-id', 'enum', 'project-handle'];
+export const SLOT_KINDS = ['capability', 'enum', 'project-handle'];
+export const COMPLETION_GUIDANCE_CODES = {
+    SECRET_FIELD: 'COMPLETION_SECRET_FIELD',
+    DESTRUCTIVE_FIELD: 'COMPLETION_DESTRUCTIVE_FIELD',
+    UNBOUNDED_PREFIX: 'COMPLETION_UNBOUNDED_PREFIX',
+    UNBOUNDED_PATH: 'COMPLETION_UNBOUNDED_PATH',
+    UNAVAILABLE: 'COMPLETION_UNAVAILABLE',
+    NO_MATCH: 'COMPLETION_NO_MATCH',
+};
+export const EMPTY_COMPLETION = Object.freeze({
+    values: Object.freeze([]),
+    total: 0,
+    hasMore: false,
+});
+//# sourceMappingURL=completion-types.js.map

package/dist/server/mcp-primitives/completions/completion-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-types.js","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/completions/completion-types.ts"],"names":[],"mappings":"AA6DA,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAKrC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,CAAU,CAAC;AAgB9F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAU,CAAC;AAoC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EAAE,8BAA8B;IACjD,gBAAgB,EAAE,6BAA6B;IAC/C,cAAc,EAAE,2BAA2B;IAC3C,WAAW,EAAE,wBAAwB;IACrC,QAAQ,EAAE,qBAAqB;CACvB,CAAC;AA4BX,MAAM,CAAC,MAAM,gBAAgB,GAAqB,MAAM,CAAC,MAAM,CAAC;IAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAsB;IAC9C,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,KAAK;CACf,CAAC,CAAC"}

package/dist/server/mcp-primitives/completions/index.d.ts

@@ -0,0 +1,6 @@
+export { complete } from './completion-provider.js';
+export { createStaticCompletionSource } from './completion-sources.js';
+export { applyBudget, rankCandidates } from './completion-ranking.js';
+export { COMPLETION_SLOTS, classifyUnsafe, refIdOf, resolveSlot, } from './completion-slots.js';
+export { COMPLETION_GUIDANCE_CODES, EMPTY_COMPLETION, MAX_COMPLETION_BYTES, MAX_COMPLETION_ITEMS, MAX_PREFIX_LENGTH, type CandidateKind, type CompletionArgument, type CompletionCandidate, type CompletionCandidateSource, type CompletionContext, type CompletionGuidance, type CompletionGuidanceCode, type CompletionOutcome, type CompletionReference, type CompletionRequest, type CompletionResult, type CompletionSlot, type PromptReference, type ResourceReference, type SlotKind, } from './completion-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/mcp-primitives/completions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/completions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,uBAAuB,CAAC"}

package/dist/server/mcp-primitives/completions/index.js

@@ -0,0 +1,6 @@
+export { complete } from './completion-provider.js';
+export { createStaticCompletionSource } from './completion-sources.js';
+export { applyBudget, rankCandidates } from './completion-ranking.js';
+export { COMPLETION_SLOTS, classifyUnsafe, refIdOf, resolveSlot, } from './completion-slots.js';
+export { COMPLETION_GUIDANCE_CODES, EMPTY_COMPLETION, MAX_COMPLETION_BYTES, MAX_COMPLETION_ITEMS, MAX_PREFIX_LENGTH, } from './completion-types.js';
+//# sourceMappingURL=index.js.map

package/dist/server/mcp-primitives/completions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/mcp-primitives/completions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAgBlB,MAAM,uBAAuB,CAAC"}

package/dist/server/mcp-primitives/fallback-pointers.d.ts

@@ -0,0 +1,14 @@
+import type { ClientCapabilityProfile } from './session-capability-profile.js';
+export declare const FALLBACK_PRIMITIVES: readonly ["resources", "prompts", "completions", "subscriptions", "tasks"];
+export type FallbackPrimitive = (typeof FALLBACK_PRIMITIVES)[number];
+export declare const SERVER_BACKED_PRIMITIVES: readonly ["resources", "prompts", "completions", "subscriptions", "tasks"];
+export type ServerBackedPrimitive = (typeof SERVER_BACKED_PRIMITIVES)[number];
+export interface FallbackPointer {
+    readonly primitive: FallbackPrimitive;
+    readonly mode: 'native' | 'gateway';
+    readonly hint: string;
+    readonly nextCall: Readonly<Record<string, unknown>>;
+}
+export declare function fallbackPointerFor(profile: ClientCapabilityProfile, primitive: FallbackPrimitive): FallbackPointer;
+export declare function missingPrimitivePointers(profile: ClientCapabilityProfile): FallbackPointer[];
+//# sourceMappingURL=fallback-pointers.d.ts.map

package/dist/server/mcp-primitives/fallback-pointers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-pointers.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/fallback-pointers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,eAAO,MAAM,mBAAmB,4EAA6E,CAAC;AAC9G,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAQrE,eAAO,MAAM,wBAAwB,4EAA6E,CAAC;AACnH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AA4DD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,iBAAiB,GAAG,eAAe,CAIlH;AAID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,eAAe,EAAE,CAI5F"}

package/dist/server/mcp-primitives/fallback-pointers.js

@@ -0,0 +1,57 @@
+export const FALLBACK_PRIMITIVES = ['resources', 'prompts', 'completions', 'subscriptions', 'tasks'];
+export const SERVER_BACKED_PRIMITIVES = ['resources', 'prompts', 'completions', 'subscriptions', 'tasks'];
+const NATIVE_METHOD = {
+    resources: 'resources/list',
+    prompts: 'prompts/list',
+    completions: 'completion/complete',
+    subscriptions: 'resources/subscribe',
+    tasks: 'tasks/list',
+};
+const GATEWAY_OPERATION = {
+    resources: 'search',
+    prompts: 'describe',
+    completions: 'search',
+    subscriptions: 'search',
+    tasks: 'execute',
+};
+const GATEWAY_HINT = {
+    resources: 'No MCP resources on this client; discover the same state through the unreal gateway search operation.',
+    prompts: 'No MCP prompts on this client; get the equivalent guided workflow through the unreal gateway describe operation.',
+    completions: 'No MCP completions on this client; discover valid values through the unreal gateway search operation.',
+    subscriptions: 'No subscriptions on this client; poll for changes by re-running the unreal gateway search operation.',
+    tasks: 'No MCP Tasks on this client; run the action synchronously through the unreal gateway execute operation and read its receipt.',
+};
+const NATIVE_HINT = {
+    resources: 'This client supports MCP resources; use the native resources methods.',
+    prompts: 'This client supports MCP prompts; use the native prompts methods.',
+    completions: 'This client supports MCP completions; use the native completion method.',
+    subscriptions: 'This client supports resource subscriptions; use the native subscribe method.',
+    tasks: 'This client supports MCP Tasks; use the native tasks methods to poll and retrieve retained results.',
+};
+function assertNever(value) {
+    throw new Error(`Unhandled fallback primitive: ${String(value)}`);
+}
+function profileSupports(profile, primitive) {
+    switch (primitive) {
+        case 'resources': return profile.hasResources;
+        case 'prompts': return profile.hasPrompts;
+        case 'completions': return profile.hasCompletions;
+        case 'subscriptions': return profile.hasSubscriptions;
+        case 'tasks': return profile.hasTasks;
+        default: return assertNever(primitive);
+    }
+}
+function isServerBacked(primitive) {
+    return SERVER_BACKED_PRIMITIVES.includes(primitive);
+}
+export function fallbackPointerFor(profile, primitive) {
+    return isServerBacked(primitive) && profileSupports(profile, primitive)
+        ? { primitive, mode: 'native', hint: NATIVE_HINT[primitive], nextCall: { method: NATIVE_METHOD[primitive] } }
+        : { primitive, mode: 'gateway', hint: GATEWAY_HINT[primitive], nextCall: { operation: GATEWAY_OPERATION[primitive] } };
+}
+export function missingPrimitivePointers(profile) {
+    return FALLBACK_PRIMITIVES
+        .filter((primitive) => !profileSupports(profile, primitive))
+        .map((primitive) => fallbackPointerFor(profile, primitive));
+}
+//# sourceMappingURL=fallback-pointers.js.map

package/dist/server/mcp-primitives/fallback-pointers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-pointers.js","sourceRoot":"","sources":["../../../src/server/mcp-primitives/fallback-pointers.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,CAAU,CAAC;AAS9G,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,CAAU,CAAC;AAYnH,MAAM,aAAa,GAA0C;IAC3D,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,qBAAqB;IAClC,aAAa,EAAE,qBAAqB;IACpC,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,MAAM,iBAAiB,GAAsC;IAC3D,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,UAAU;IACnB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,QAAQ;IACvB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,YAAY,GAAsC;IACtD,SAAS,EAAE,uGAAuG;IAClH,OAAO,EAAE,kHAAkH;IAC3H,WAAW,EAAE,uGAAuG;IACpH,aAAa,EAAE,sGAAsG;IACrH,KAAK,EAAE,8HAA8H;CACtI,CAAC;AAEF,MAAM,WAAW,GAA0C;IACzD,SAAS,EAAE,uEAAuE;IAClF,OAAO,EAAE,mEAAmE;IAC5E,WAAW,EAAE,yEAAyE;IACtF,aAAa,EAAE,+EAA+E;IAC9F,KAAK,EAAE,qGAAqG;CAC7G,CAAC;AAEF,SAAS,WAAW,CAAC,KAAY;IAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,eAAe,CAAC,OAAgC,EAAE,SAA4B;IACrF,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9C,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,UAAU,CAAC;QAC1C,KAAK,aAAa,CAAC,CAAC,OAAO,OAAO,CAAC,cAAc,CAAC;QAClD,KAAK,eAAe,CAAC,CAAC,OAAO,OAAO,CAAC,gBAAgB,CAAC;QACtD,KAAK,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAID,SAAS,cAAc,CAAC,SAA4B;IAClD,OAAQ,wBAAyD,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxF,CAAC;AAOD,MAAM,UAAU,kBAAkB,CAAC,OAAgC,EAAE,SAA4B;IAC/F,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;QACrE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE;QAC7G,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;AAC3H,CAAC;AAID,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,OAAO,mBAAmB;SACvB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/mcp-primitives/primitive-handlers.d.ts

@@ -0,0 +1,16 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { CompletionCandidateSource } from './completions/index.js';
+import type { PromptReferenceValidator } from './prompts/index.js';
+import type { SessionCapabilityProfile } from './session-capability-profile.js';
+import type { SubscriptionStore } from './subscriptions/subscription-store.js';
+export interface PrimitiveHandlerDeps {
+    readonly server: Server;
+    readonly store: SubscriptionStore;
+    readonly resolveSessionId: () => string;
+    readonly promptValidator: PromptReferenceValidator;
+    readonly completionSource: CompletionCandidateSource;
+    readonly resolveProfile: (sessionId: string) => SessionCapabilityProfile;
+}
+export declare const REGISTERED_PRIMITIVE_METHODS: readonly ["resources/subscribe", "resources/unsubscribe", "prompts/list", "prompts/get", "completion/complete"];
+export declare function registerPrimitiveHandlers(deps: PrimitiveHandlerDeps): ReadonlySet<string>;
+//# sourceMappingURL=primitive-handlers.d.ts.map

package/dist/server/mcp-primitives/primitive-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-handlers.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/primitive-handlers.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,OAAO,KAAK,EAAE,yBAAyB,EAA0C,MAAM,wBAAwB,CAAC;AAEhH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,MAAM,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IACrD,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,wBAAwB,CAAC;CAC1E;AAID,eAAO,MAAM,4BAA4B,iHAM/B,CAAC;AAkBX,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,CA2DzF"}

package/dist/server/mcp-primitives/primitive-handlers.js

@@ -0,0 +1,76 @@
+import { CompleteRequestSchema, ErrorCode, GetPromptRequestSchema, ListPromptsRequestSchema, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { complete } from './completions/index.js';
+import { PromptError, getPrompt, listPrompts } from './prompts/index.js';
+export const REGISTERED_PRIMITIVE_METHODS = [
+    'resources/subscribe',
+    'resources/unsubscribe',
+    'prompts/list',
+    'prompts/get',
+    'completion/complete',
+];
+function toCompletionRef(ref) {
+    return ref.type === 'ref/prompt'
+        ? { type: 'ref/prompt', name: ref.name ?? '' }
+        : { type: 'ref/resource', uri: ref.uri ?? '' };
+}
+function promptErrorToMcp(error) {
+    if (error instanceof PromptError) {
+        return new McpError(ErrorCode.InvalidParams, error.message, { code: error.code });
+    }
+    return error instanceof McpError
+        ? error
+        : new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : String(error));
+}
+export function registerPrimitiveHandlers(deps) {
+    const { server, store, resolveSessionId, promptValidator, completionSource, resolveProfile } = deps;
+    server.setRequestHandler(SubscribeRequestSchema, (request) => {
+        const result = store.subscribe(resolveSessionId(), request.params.uri);
+        if (!result.accepted) {
+            throw new McpError(ErrorCode.InvalidParams, `Resource is not subscribable: ${request.params.uri}`);
+        }
+        return {};
+    });
+    server.setRequestHandler(UnsubscribeRequestSchema, (request) => {
+        store.unsubscribe(resolveSessionId(), request.params.uri);
+        return {};
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, () => ({
+        prompts: listPrompts().map((entry) => ({
+            name: entry.name,
+            title: entry.title,
+            description: entry.description,
+            arguments: entry.arguments.map((argument) => ({
+                name: argument.name,
+                description: argument.description,
+                required: argument.required,
+            })),
+        })),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, (request) => {
+        try {
+            const rendered = getPrompt(request.params.name, request.params.arguments ?? {}, promptValidator);
+            return { description: rendered.description, messages: [...rendered.messages] };
+        }
+        catch (error) {
+            throw promptErrorToMcp(error);
+        }
+    });
+    server.setRequestHandler(CompleteRequestSchema, (request) => {
+        const sessionId = resolveSessionId();
+        const completionRequest = {
+            ref: toCompletionRef(request.params.ref),
+            argument: { name: request.params.argument.name, value: request.params.argument.value },
+        };
+        const outcome = complete(completionRequest, sessionId, resolveProfile(sessionId), completionSource);
+        return {
+            completion: {
+                values: [...outcome.completion.values],
+                total: outcome.completion.total,
+                hasMore: outcome.completion.hasMore,
+            },
+            ...(outcome.guidance !== undefined ? { _meta: { guidance: outcome.guidance } } : {}),
+        };
+    });
+    return new Set(REGISTERED_PRIMITIVE_METHODS);
+}
+//# sourceMappingURL=primitive-handlers.js.map

package/dist/server/mcp-primitives/primitive-handlers.js.map

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

package/dist/server/mcp-primitives/primitive-notifications.d.ts

@@ -0,0 +1,32 @@
+import { SubscriptionStore } from './subscriptions/subscription-store.js';
+import type { CatalogRevisionReader } from './catalog-revision-reader.js';
+import type { RevisionProvider } from './resource-revision.js';
+export interface NotifyingServer {
+    notification(notification: {
+        method: string;
+        params?: Record<string, unknown>;
+    }): Promise<void>;
+}
+export interface PrimitiveNotificationDeps {
+    readonly server: NotifyingServer;
+    readonly revisions: RevisionProvider;
+    readonly catalog: CatalogRevisionReader;
+    readonly clock?: () => number;
+}
+export declare class PrimitiveNotificationDriver {
+    readonly store: SubscriptionStore;
+    private readonly server;
+    private readonly coalescer;
+    private readonly clock;
+    private flushTimer;
+    private disposed;
+    constructor(deps: PrimitiveNotificationDeps);
+    syncCatalog(sessionId: string): void;
+    releaseSession(sessionId: string): void;
+    dispose(): void;
+    private deliver;
+    private arm;
+    private flush;
+    private clearTimer;
+}
+//# sourceMappingURL=primitive-notifications.d.ts.map

package/dist/server/mcp-primitives/primitive-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-notifications.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/primitive-notifications.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjG;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,qBAAa,2BAA2B;IAEtC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,yBAAyB;IA4B3C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAapC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQvC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,GAAG;IAgBX,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,UAAU;CAMnB"}

package/dist/server/mcp-primitives/primitive-notifications.js

@@ -0,0 +1,86 @@
+import { NotificationCoalescer } from './subscriptions/notification-coalescer.js';
+import { SubscriptionStore } from './subscriptions/subscription-store.js';
+export class PrimitiveNotificationDriver {
+    store;
+    server;
+    coalescer;
+    clock;
+    flushTimer;
+    disposed = false;
+    constructor(deps) {
+        this.server = deps.server;
+        this.clock = deps.clock ?? (() => Date.now());
+        this.store = new SubscriptionStore({
+            onRelease: (sessionId, uri) => {
+                this.coalescer.dropPending(sessionId, uri);
+            },
+        });
+        this.coalescer = new NotificationCoalescer({
+            store: this.store,
+            revisions: deps.revisions,
+            catalog: deps.catalog,
+            sink: (sessionId, payload) => {
+                this.deliver(sessionId, payload);
+            },
+            clock: this.clock,
+        });
+    }
+    syncCatalog(sessionId) {
+        if (this.disposed) {
+            return;
+        }
+        this.coalescer.syncCatalog(sessionId);
+        this.arm();
+    }
+    releaseSession(sessionId) {
+        this.store.clearSession(sessionId);
+        this.coalescer.clearSession(sessionId);
+        this.clearTimer();
+        this.arm();
+    }
+    dispose() {
+        this.disposed = true;
+        this.clearTimer();
+    }
+    deliver(_sessionId, payload) {
+        if (this.disposed) {
+            return;
+        }
+        void this.server
+            .notification({
+            method: 'notifications/resources/updated',
+            params: { uri: payload.uri },
+        })
+            .catch(() => {
+        });
+    }
+    arm() {
+        if (this.disposed || this.flushTimer !== undefined) {
+            return;
+        }
+        const dueAt = this.coalescer.nextDueAt();
+        if (dueAt === null) {
+            return;
+        }
+        const delay = Math.max(0, dueAt - this.clock());
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = undefined;
+            this.flush();
+        }, delay);
+        this.flushTimer.unref?.();
+    }
+    flush() {
+        if (this.disposed) {
+            return;
+        }
+        this.coalescer.flushDue(this.clock());
+        this.arm();
+    }
+    clearTimer() {
+        if (this.flushTimer !== undefined) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=primitive-notifications.js.map

package/dist/server/mcp-primitives/primitive-notifications.js.map

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

package/dist/server/mcp-primitives/primitive-registry.d.ts

@@ -0,0 +1,18 @@
+import type { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+export declare const ADVERTISED_SESSION_CAPABILITIES: ServerCapabilities;
+export interface CreatePrimitiveRegistryInput {
+    readonly handlers: ReadonlyMap<string, unknown>;
+    readonly capabilities: ServerCapabilities;
+}
+export interface PrimitiveRegistry {
+    readonly capabilities: ServerCapabilities;
+}
+export declare class PrimitiveRegistrationError extends Error {
+    readonly code = "PRIMITIVE_HANDLER_MISSING";
+    readonly capability: string;
+    readonly method: string;
+    constructor(capability: string, method: string);
+}
+export declare function deriveAdvertisedCapabilities(handlers: ReadonlyMap<string, unknown>): ServerCapabilities;
+export declare function createPrimitiveRegistry(input: CreatePrimitiveRegistryInput): PrimitiveRegistry;
+//# sourceMappingURL=primitive-registry.d.ts.map

package/dist/server/mcp-primitives/primitive-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-registry.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/primitive-registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAoB7E,eAAO,MAAM,+BAA+B,EAAE,kBAM7C,CAAC;AAGF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C;AAOD,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAW/C;AAYD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAuBvG;AAwCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,iBAAiB,CAQ9F"}

package/dist/server/mcp-primitives/primitive-registry.js

@@ -0,0 +1,90 @@
+const TOOLS_METHODS = ['tools/list', 'tools/call'];
+const RESOURCES_READ_METHODS = ['resources/list', 'resources/templates/list', 'resources/read'];
+const RESOURCES_SUBSCRIBE_METHODS = ['resources/subscribe', 'resources/unsubscribe'];
+const PROMPTS_METHODS = ['prompts/list', 'prompts/get'];
+const COMPLETIONS_METHODS = ['completion/complete'];
+const TASKS_METHODS = ['tasks/get', 'tasks/list', 'tasks/cancel', 'tasks/result'];
+export const ADVERTISED_SESSION_CAPABILITIES = {
+    tools: {},
+    resources: { subscribe: true },
+    prompts: {},
+    completions: {},
+    tasks: { list: {}, cancel: {}, requests: { tools: { call: {} } } },
+};
+export class PrimitiveRegistrationError extends Error {
+    code = 'PRIMITIVE_HANDLER_MISSING';
+    capability;
+    method;
+    constructor(capability, method) {
+        super(`Advertised capability '${capability}' is missing its backing handler for '${method}'. ` +
+            'Register the handler before connect or drop the capability.');
+        this.name = 'PrimitiveRegistrationError';
+        this.capability = capability;
+        this.method = method;
+        Object.setPrototypeOf(this, PrimitiveRegistrationError.prototype);
+    }
+}
+function hasAll(handlers, methods) {
+    return methods.every((method) => handlers.has(method));
+}
+export function deriveAdvertisedCapabilities(handlers) {
+    const capabilities = {};
+    if (hasAll(handlers, TOOLS_METHODS)) {
+        capabilities.tools = {};
+    }
+    if (hasAll(handlers, RESOURCES_READ_METHODS)) {
+        capabilities.resources = hasAll(handlers, RESOURCES_SUBSCRIBE_METHODS) ? { subscribe: true } : {};
+    }
+    if (hasAll(handlers, PROMPTS_METHODS)) {
+        capabilities.prompts = {};
+    }
+    if (hasAll(handlers, COMPLETIONS_METHODS)) {
+        capabilities.completions = {};
+    }
+    if (hasAll(handlers, TASKS_METHODS)) {
+        capabilities.tasks = hasAll(handlers, TOOLS_METHODS)
+            ? { list: {}, cancel: {}, requests: { tools: { call: {} } } }
+            : { list: {}, cancel: {} };
+    }
+    return capabilities;
+}
+function requiredMethods(capabilities) {
+    const required = [];
+    const push = (capability, methods) => {
+        for (const method of methods) {
+            required.push({ capability, method });
+        }
+    };
+    if (capabilities.tools !== undefined) {
+        push('tools', TOOLS_METHODS);
+    }
+    if (capabilities.resources !== undefined) {
+        push('resources', RESOURCES_READ_METHODS);
+        if (capabilities.resources.subscribe === true) {
+            push('resources', RESOURCES_SUBSCRIBE_METHODS);
+        }
+    }
+    if (capabilities.prompts !== undefined) {
+        push('prompts', PROMPTS_METHODS);
+    }
+    if (capabilities.completions !== undefined) {
+        push('completions', COMPLETIONS_METHODS);
+    }
+    if (capabilities.tasks !== undefined) {
+        push('tasks', TASKS_METHODS);
+        if (capabilities.tasks.requests?.tools?.call !== undefined) {
+            push('tasks', TOOLS_METHODS);
+        }
+    }
+    return required;
+}
+export function createPrimitiveRegistry(input) {
+    const { handlers, capabilities } = input;
+    for (const { capability, method } of requiredMethods(capabilities)) {
+        if (!handlers.has(method)) {
+            throw new PrimitiveRegistrationError(capability, method);
+        }
+    }
+    return { capabilities };
+}
+//# sourceMappingURL=primitive-registry.js.map

package/dist/server/mcp-primitives/primitive-registry.js.map

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

package/dist/server/mcp-primitives/primitive-sources.d.ts

@@ -0,0 +1,7 @@
+import type { CatalogRevisionReader } from './catalog-revision-reader.js';
+import type { EnabledCapabilityProvider } from './session-capability-profile.js';
+import type { PromptReferenceValidator } from './prompts/index.js';
+export declare function buildCatalogRevisionReader(): CatalogRevisionReader;
+export declare function buildEnabledCapabilityProvider(): EnabledCapabilityProvider;
+export declare function buildPromptReferenceValidator(): PromptReferenceValidator;
+//# sourceMappingURL=primitive-sources.d.ts.map

package/dist/server/mcp-primitives/primitive-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-sources.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-primitives/primitive-sources.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAuCnE,wBAAgB,0BAA0B,IAAI,qBAAqB,CAQlE;AAOD,wBAAgB,8BAA8B,IAAI,yBAAyB,CAY1E;AAOD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAUxE"}