mcp-server-framework 1.0.0

package/build/mcp/capabilities/registry/reset.js

@@ -0,0 +1,48 @@
+/**
+ * Registry Reset Utility
+ *
+ * Provides a lifecycle function to reset all global registries.
+ * Keeps the barrel file (index.ts) free of implementation logic.
+ *
+ * @module mcp/capabilities/registry/reset
+ */
+import { logger as baseLogger } from "../../../logger/index.js";
+import { globalToolRegistry } from "./tool-registry.js";
+import { globalResourceRegistry } from "./resource-registry.js";
+import { globalPromptRegistry } from "./prompt-registry.js";
+import { globalTaskToolRegistry } from "./task-tool-registry.js";
+// ============================================================================
+// Logger
+// ============================================================================
+const logger = baseLogger.child({ component: "registry" });
+// ============================================================================
+// Lifecycle Utilities
+// ============================================================================
+/**
+ * Reset all global registries.
+ *
+ * Clears all registered tools, resources, resource templates, and prompts
+ * from the global singleton registries. After calling this, all `define*()`
+ * calls must be re-executed to repopulate the registries.
+ *
+ * **Use cases:**
+ * - Hot-reload during development
+ * - Server restart / lifecycle management
+ * - Isolated testing scenarios
+ *
+ * @example
+ * ```typescript
+ * import { resetAllRegistries } from 'mcp-server-framework';
+ *
+ * // Before re-registering tools in a hot-reload scenario
+ * resetAllRegistries();
+ * ```
+ */
+export function resetAllRegistries() {
+    globalToolRegistry.clear();
+    globalResourceRegistry.clear();
+    globalPromptRegistry.clear();
+    globalTaskToolRegistry.clear();
+    logger.debug("All registries reset");
+}
+//# sourceMappingURL=reset.js.map

package/build/mcp/capabilities/registry/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../../src/mcp/capabilities/registry/reset.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;AAE3D,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB;IAChC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAC3B,sBAAsB,CAAC,KAAK,EAAE,CAAC;IAC/B,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAC7B,sBAAsB,CAAC,KAAK,EAAE,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AACvC,CAAC"}

package/build/mcp/capabilities/registry/resource-registry.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Resource Registry
+ *
+ * Global registry for MCP resources and resource templates that implements ResourceProvider.
+ * Uses composition with BaseRegistry for DRY CRUD operations.
+ *
+ * The registry is the single authority for resource definitions:
+ * - Storage: CRUD operations via BaseRegistry
+ * - SDK Binding: `bindToSdk()` registers resources with MCP SDK server instances
+ *
+ * @module mcp/capabilities/registry/resource-registry
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type z } from "zod";
+import type { ResourceStaticDefinition, ResourceTemplateDefinition, ResourceProvider } from "../../types/index.js";
+import type { Logger } from "../../../logger/index.js";
+/**
+ * Options for binding resources to an MCP SDK server.
+ * @internal
+ */
+export interface ResourceBindOptions {
+    readonly logger: Logger;
+}
+/**
+ * Composite registry for MCP resources and templates.
+ *
+ * Uses two internal BaseRegistry instances to eliminate code duplication
+ * while maintaining separate namespaces for resources and templates.
+ *
+ * Implements ResourceProvider for direct use with McpServerBuilder.
+ *
+ * @example
+ * ```typescript
+ * import { resourceRegistry, defineResource } from 'mcp-server-framework';
+ *
+ * // Resources are auto-registered via defineResource()
+ * defineResource({ name: 'config', uri: 'app://config', ... });
+ *
+ * // Registry can be used directly as a provider
+ * builder.withResourceProvider(resourceRegistry);
+ * ```
+ */
+export declare class ResourceRegistry implements ResourceProvider {
+    /** Internal registry for static resources */
+    private readonly resourceRegistry;
+    /** Internal registry for resource templates */
+    private readonly templateRegistry;
+    /**
+     * Creates an isolated ResourceRegistry (no shared global state).
+     *
+     * Used for testing.
+     */
+    static createIsolated(): ResourceRegistry;
+    /** Register a static resource. Throws if name exists. Warns on URI conflict. */
+    registerResource(resource: ResourceStaticDefinition): void;
+    /** Register a static resource, replacing any existing. Warns on URI conflict. */
+    registerOrReplaceResource(resource: ResourceStaticDefinition): void;
+    /** Unregister a resource by name. */
+    unregisterResource(name: string): boolean;
+    /** Get a resource by name. */
+    getResource(name: string): ResourceStaticDefinition | undefined;
+    /** Check if a resource exists. */
+    hasResource(name: string): boolean;
+    /** Register a resource template. Throws if name exists. */
+    registerTemplate(template: ResourceTemplateDefinition): void;
+    /** Register a template, replacing any existing. */
+    registerOrReplaceTemplate(template: ResourceTemplateDefinition): void;
+    /** Unregister a template by name. */
+    unregisterTemplate(name: string): boolean;
+    /** Get a template by name. */
+    getTemplate(name: string): ResourceTemplateDefinition | undefined;
+    /** Check if a template exists. */
+    hasTemplate(name: string): boolean;
+    /**
+     * Register a template from a generic factory function.
+     *
+     * Centralizes TypeScript generic variance handling. `ResourceTemplateDefinition<TInput>`
+     * is invariant — `TInput` appears in both covariant (input property) and
+     * contravariant (read parameter) positions via Zod's type mapping.
+     * TypeScript requires `as unknown as` because neither type sufficiently
+     * overlaps with the other (invariance).
+     *
+     * @internal Used by defineResourceTemplate() — prefer registerOrReplaceTemplate() for non-generic usage.
+     */
+    registerTemplateFromFactory<TInput extends z.AnyZodObject>(template: ResourceTemplateDefinition<TInput>): void;
+    /**
+     * Warn when a new resource registers a URI already in use by another resource.
+     * Name-based dedup is handled by BaseRegistry; this checks for URI-level conflicts
+     * across the static resource registry.
+     */
+    private warnOnDuplicateResourceUri;
+    /** Clear all resources. */
+    clearResources(): void;
+    /** Clear all templates. */
+    clearTemplates(): void;
+    /** Clear all resources and templates. */
+    clear(): void;
+    /** Number of registered resources. */
+    get resourceCount(): number;
+    /** Number of registered templates. */
+    get templateCount(): number;
+    /**
+     * Get all registered static resources.
+     */
+    getResources(): ReadonlyArray<ResourceStaticDefinition>;
+    /**
+     * Get all registered templates.
+     */
+    getTemplates(): ReadonlyArray<ResourceTemplateDefinition>;
+    /**
+     * Check if provider has any resources or templates.
+     */
+    hasResources(): boolean;
+    /**
+     * Registers all resources (static + templates) with an MCP SDK server instance.
+     *
+     * Each resource is registered with:
+     * - OpenTelemetry tracing spans for read operations
+     * - Structured error handling and logging
+     * - URI template variable extraction and completion callbacks
+     *
+     * @param sdk - The MCP SDK server instance
+     * @param resources - Static resource definitions
+     * @param templates - Resource template definitions
+     * @param options - Registration context (logger)
+     * @internal
+     */
+    static bindToSdk(sdk: McpServer, resources: readonly ResourceStaticDefinition[], templates: readonly ResourceTemplateDefinition[], options: ResourceBindOptions): void;
+    /**
+     * Extracts variable names from a URI template string (RFC 6570).
+     *
+     * @param uriTemplate - URI template pattern (e.g., 'notes://note/{noteId}')
+     * @returns Array of variable names (e.g., ['noteId'])
+     */
+    private static extractUriTemplateVariables;
+    /**
+     * Bridges framework's unified `complete(argName, argValue)` callback to SDK's
+     * per-variable `{ [variable]: (value) => string[] }` format.
+     *
+     * @sdk-constraint — SDK ResourceTemplate expects separate callbacks keyed by variable name.
+     * The framework provides a single callback to reduce boilerplate.
+     */
+    private static buildResourceCompleteCallbacks;
+}
+/**
+ * Global resource registry singleton.
+ *
+ * This instance is used by defineResource() and defineResourceTemplate()
+ * for auto-registration and by createServer() to discover all resources.
+ */
+export declare const globalResourceRegistry: ResourceRegistry;
+//# sourceMappingURL=resource-registry.d.ts.map

package/build/mcp/capabilities/registry/resource-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../../src/mcp/capabilities/registry/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,KAAK,CAAC,EAAY,MAAM,KAAK,CAAC;AAEvC,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAiCvD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA8BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgC;IAEjE,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IAMnE;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,gBAAgB;IAQzC,gFAAgF;IAChF,gBAAgB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAK1D,iFAAiF;IACjF,yBAAyB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAKnE,qCAAqC;IACrC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,8BAA8B;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAI/D,kCAAkC;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC,2DAA2D;IAC3D,gBAAgB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI;IAI5D,mDAAmD;IACnD,yBAAyB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI;IAIrE,qCAAqC;IACrC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,8BAA8B;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAIjE,kCAAkC;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;;;;;;;OAUG;IACH,2BAA2B,CAAC,MAAM,SAAS,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,0BAA0B,CAAC,MAAM,CAAC,GAAG,IAAI;IAa9G;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAalC,2BAA2B;IAC3B,cAAc,IAAI,IAAI;IAItB,2BAA2B;IAC3B,cAAc,IAAI,IAAI;IAItB,yCAAyC;IACzC,KAAK,IAAI,IAAI;IASb,sCAAsC;IACtC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,sCAAsC;IACtC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAMD;;OAEG;IACH,YAAY,IAAI,aAAa,CAAC,wBAAwB,CAAC;IAIvD;;OAEG;IACH,YAAY,IAAI,aAAa,CAAC,0BAA0B,CAAC;IAIzD;;OAEG;IACH,YAAY,IAAI,OAAO;IAQvB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,SAAS,CACd,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,SAAS,wBAAwB,EAAE,EAC9C,SAAS,EAAE,SAAS,0BAA0B,EAAE,EAChD,OAAO,EAAE,mBAAmB,GAC3B,IAAI;IA6KP;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAK1C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAyB9C;AAMD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,kBAAyB,CAAC"}

package/build/mcp/capabilities/registry/resource-registry.js

@@ -0,0 +1,430 @@
+/**
+ * Resource Registry
+ *
+ * Global registry for MCP resources and resource templates that implements ResourceProvider.
+ * Uses composition with BaseRegistry for DRY CRUD operations.
+ *
+ * The registry is the single authority for resource definitions:
+ * - Storage: CRUD operations via BaseRegistry
+ * - SDK Binding: `bindToSdk()` registers resources with MCP SDK server instances
+ *
+ * @module mcp/capabilities/registry/resource-registry
+ */
+import { ResourceTemplate as SdkResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { ZodError } from "zod";
+import { withSpan, MCP_ATTRIBUTES, SpanKind } from "../../../telemetry/index.js";
+import { BaseRegistry } from "./base-registry.js";
+import { enforceScopeOrThrow } from "./scope-enforcement.js";
+import { logger as baseLogger } from "../../../logger/index.js";
+const logger = baseLogger.child({ component: "resource-registry" });
+// ============================================================================
+// Constants
+// ============================================================================
+const SdkBindingMessages = {
+    RESOURCES_REGISTERED: "Registered %d resources and %d templates with SDK",
+    RESOURCE_REGISTERED: "Registered resource: %s (%s)",
+    TEMPLATE_REGISTERED: "Registered resource template: %s (%s)",
+    TEMPLATE_LIST_FAILED: "Failed to list resources for template %s: %s",
+    NO_RESOURCES: "No resources to register",
+    RESOURCE_READ_ERROR: "Error reading resource %s: %s",
+    TEMPLATE_READ_ERROR: "Error reading resource template %s: %s",
+    RESOURCE_READING: "Reading resource: %s",
+    TEMPLATE_READING: "Reading resource template: %s with variables %j",
+    TEMPLATE_VALIDATION_FAILED: "Resource template %s: parameter validation failed: %s",
+};
+const RegistryLogMessages = {
+    DUPLICATE_URI: 'Resource URI conflict: "%s" registers URI "%s" which is already used by "%s"',
+};
+// ============================================================================
+// Internal Registry Classes (extend BaseRegistry for CRUD)
+// ============================================================================
+/**
+ * Internal registry for static resources.
+ * @internal
+ */
+class StaticResourceRegistry extends BaseRegistry {
+    get itemTypeName() {
+        return "Resource";
+    }
+}
+/**
+ * Internal registry for resource templates.
+ * @internal
+ */
+class ResourceTemplateRegistry extends BaseRegistry {
+    get itemTypeName() {
+        return "Template";
+    }
+}
+// ============================================================================
+// Resource Registry Class
+// ============================================================================
+/**
+ * Composite registry for MCP resources and templates.
+ *
+ * Uses two internal BaseRegistry instances to eliminate code duplication
+ * while maintaining separate namespaces for resources and templates.
+ *
+ * Implements ResourceProvider for direct use with McpServerBuilder.
+ *
+ * @example
+ * ```typescript
+ * import { resourceRegistry, defineResource } from 'mcp-server-framework';
+ *
+ * // Resources are auto-registered via defineResource()
+ * defineResource({ name: 'config', uri: 'app://config', ... });
+ *
+ * // Registry can be used directly as a provider
+ * builder.withResourceProvider(resourceRegistry);
+ * ```
+ */
+export class ResourceRegistry {
+    /** Internal registry for static resources */
+    resourceRegistry = new StaticResourceRegistry();
+    /** Internal registry for resource templates */
+    templateRegistry = new ResourceTemplateRegistry();
+    // ──────────────────────────────────────────────────────────────────────────
+    // Factory
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Creates an isolated ResourceRegistry (no shared global state).
+     *
+     * Used for testing.
+     */
+    static createIsolated() {
+        return new ResourceRegistry();
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Resource Registration Methods (delegated to internal registry)
+    // ──────────────────────────────────────────────────────────────────────────
+    /** Register a static resource. Throws if name exists. Warns on URI conflict. */
+    registerResource(resource) {
+        this.warnOnDuplicateResourceUri(resource.name, resource.uri);
+        this.resourceRegistry.register(resource);
+    }
+    /** Register a static resource, replacing any existing. Warns on URI conflict. */
+    registerOrReplaceResource(resource) {
+        this.warnOnDuplicateResourceUri(resource.name, resource.uri);
+        this.resourceRegistry.registerOrReplace(resource);
+    }
+    /** Unregister a resource by name. */
+    unregisterResource(name) {
+        return this.resourceRegistry.unregister(name);
+    }
+    /** Get a resource by name. */
+    getResource(name) {
+        return this.resourceRegistry.get(name);
+    }
+    /** Check if a resource exists. */
+    hasResource(name) {
+        return this.resourceRegistry.has(name);
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Template Registration Methods (delegated to internal registry)
+    // ──────────────────────────────────────────────────────────────────────────
+    /** Register a resource template. Throws if name exists. */
+    registerTemplate(template) {
+        this.templateRegistry.register(template);
+    }
+    /** Register a template, replacing any existing. */
+    registerOrReplaceTemplate(template) {
+        this.templateRegistry.registerOrReplace(template);
+    }
+    /** Unregister a template by name. */
+    unregisterTemplate(name) {
+        return this.templateRegistry.unregister(name);
+    }
+    /** Get a template by name. */
+    getTemplate(name) {
+        return this.templateRegistry.get(name);
+    }
+    /** Check if a template exists. */
+    hasTemplate(name) {
+        return this.templateRegistry.has(name);
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Generic Registration (Variance-Safe)
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Register a template from a generic factory function.
+     *
+     * Centralizes TypeScript generic variance handling. `ResourceTemplateDefinition<TInput>`
+     * is invariant — `TInput` appears in both covariant (input property) and
+     * contravariant (read parameter) positions via Zod's type mapping.
+     * TypeScript requires `as unknown as` because neither type sufficiently
+     * overlaps with the other (invariance).
+     *
+     * @internal Used by defineResourceTemplate() — prefer registerOrReplaceTemplate() for non-generic usage.
+     */
+    registerTemplateFromFactory(template) {
+        // @type-variance — Generic input erased for homogeneous storage; SDK validates at runtime
+        this.templateRegistry.registerOrReplace(template);
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Clear Methods
+    // ──────────────────────────────────────────────────────────────────────────
+    // ──────────────────────────────────────────────────────────────────────────
+    // URI Conflict Detection
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Warn when a new resource registers a URI already in use by another resource.
+     * Name-based dedup is handled by BaseRegistry; this checks for URI-level conflicts
+     * across the static resource registry.
+     */
+    warnOnDuplicateResourceUri(newName, uri) {
+        for (const existing of this.resourceRegistry.getAll()) {
+            if (existing.uri === uri && existing.name !== newName) {
+                logger.warn(RegistryLogMessages.DUPLICATE_URI, newName, uri, existing.name);
+                return;
+            }
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Clear Methods
+    // ──────────────────────────────────────────────────────────────────────────
+    /** Clear all resources. */
+    clearResources() {
+        this.resourceRegistry.clear();
+    }
+    /** Clear all templates. */
+    clearTemplates() {
+        this.templateRegistry.clear();
+    }
+    /** Clear all resources and templates. */
+    clear() {
+        this.resourceRegistry.clear();
+        this.templateRegistry.clear();
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Size Properties (computed from internal registries)
+    // ──────────────────────────────────────────────────────────────────────────
+    /** Number of registered resources. */
+    get resourceCount() {
+        return this.resourceRegistry.size;
+    }
+    /** Number of registered templates. */
+    get templateCount() {
+        return this.templateRegistry.size;
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // ResourceProvider Implementation
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Get all registered static resources.
+     */
+    getResources() {
+        return this.resourceRegistry.getAll();
+    }
+    /**
+     * Get all registered templates.
+     */
+    getTemplates() {
+        return this.templateRegistry.getAll();
+    }
+    /**
+     * Check if provider has any resources or templates.
+     */
+    hasResources() {
+        return this.resourceRegistry.size > 0 || this.templateRegistry.size > 0;
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // SDK Binding
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Registers all resources (static + templates) with an MCP SDK server instance.
+     *
+     * Each resource is registered with:
+     * - OpenTelemetry tracing spans for read operations
+     * - Structured error handling and logging
+     * - URI template variable extraction and completion callbacks
+     *
+     * @param sdk - The MCP SDK server instance
+     * @param resources - Static resource definitions
+     * @param templates - Resource template definitions
+     * @param options - Registration context (logger)
+     * @internal
+     */
+    static bindToSdk(sdk, resources, templates, options) {
+        const { logger } = options;
+        if (resources.length === 0 && templates.length === 0) {
+            logger.trace(SdkBindingMessages.NO_RESOURCES);
+            return;
+        }
+        logger.trace(SdkBindingMessages.RESOURCES_REGISTERED, resources.length, templates.length);
+        // Register static resources
+        for (const resource of resources) {
+            sdk.registerResource(resource.name, resource.uri, { description: resource.description, mimeType: resource.mimeType }, async (_uri, extra) => {
+                // Scope enforcement (RBAC)
+                enforceScopeOrThrow(resource.requiredScopes, extra.authInfo, "Resource", resource.uri, logger);
+                return withSpan(`mcp.resource.read`, async (span) => {
+                    span.setAttributes({
+                        [MCP_ATTRIBUTES.RESOURCE_URI]: resource.uri,
+                        [MCP_ATTRIBUTES.OPERATION]: "resource_read",
+                    });
+                    logger.trace(SdkBindingMessages.RESOURCE_READING, resource.uri);
+                    try {
+                        const content = await resource.read();
+                        if (typeof content === "string") {
+                            return {
+                                contents: [
+                                    {
+                                        uri: resource.uri,
+                                        mimeType: resource.mimeType,
+                                        text: content,
+                                    },
+                                ],
+                            };
+                        }
+                        else {
+                            const base64 = Buffer.from(content).toString("base64");
+                            return {
+                                contents: [
+                                    {
+                                        uri: resource.uri,
+                                        mimeType: resource.mimeType,
+                                        blob: base64,
+                                    },
+                                ],
+                            };
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        logger.error(SdkBindingMessages.RESOURCE_READ_ERROR, resource.uri, msg);
+                        throw error;
+                    }
+                }, { kind: SpanKind.SERVER });
+            });
+            logger.trace(SdkBindingMessages.RESOURCE_REGISTERED, resource.name, resource.uri);
+        }
+        // Register templates
+        for (const template of templates) {
+            const completeCallbacks = template.complete
+                ? ResourceRegistry.buildResourceCompleteCallbacks(template.uriTemplate, template.complete)
+                : undefined;
+            const sdkTemplate = new SdkResourceTemplate(template.uriTemplate, {
+                list: template.list
+                    ? async () => {
+                        try {
+                            const items = await template.list();
+                            return {
+                                resources: items.map((item) => ({
+                                    uri: item.uri,
+                                    name: item.name ?? template.name,
+                                    description: item.description ?? template.description,
+                                    mimeType: item.mimeType ?? template.mimeType,
+                                })),
+                            };
+                        }
+                        catch (error) {
+                            const msg = error instanceof Error ? error.message : String(error);
+                            logger.error(SdkBindingMessages.TEMPLATE_LIST_FAILED, template.uriTemplate, msg);
+                            return { resources: [] };
+                        }
+                    }
+                    : undefined,
+                ...(completeCallbacks && { complete: completeCallbacks }),
+            });
+            sdk.registerResource(template.name, sdkTemplate, { description: template.description, mimeType: template.mimeType }, async (_uri, variables, extra) => {
+                // Scope enforcement (RBAC)
+                enforceScopeOrThrow(template.requiredScopes, extra.authInfo, "Resource", template.uriTemplate, logger);
+                return withSpan(`mcp.resource.read`, async (span) => {
+                    span.setAttributes({
+                        [MCP_ATTRIBUTES.RESOURCE_TEMPLATE]: template.uriTemplate,
+                        [MCP_ATTRIBUTES.OPERATION]: "resource_read",
+                    });
+                    logger.trace(SdkBindingMessages.TEMPLATE_READING, template.uriTemplate, variables);
+                    // Convert string[] to string for simple templates
+                    const params = {};
+                    for (const [key, value] of Object.entries(variables)) {
+                        params[key] = Array.isArray(value) ? (value[0] ?? "") : value;
+                    }
+                    // Validate params against Zod schema if provided (DD JSDoc contract)
+                    if (template.input) {
+                        try {
+                            await template.input.parseAsync(params);
+                        }
+                        catch (validationError) {
+                            const msg = validationError instanceof ZodError
+                                ? validationError.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")
+                                : String(validationError);
+                            logger.warn(SdkBindingMessages.TEMPLATE_VALIDATION_FAILED, template.uriTemplate, msg);
+                            throw new McpError(ErrorCode.InvalidParams, `Invalid resource template parameters: ${msg}`);
+                        }
+                    }
+                    try {
+                        const content = await template.read(params);
+                        // Construct URI from template for the response
+                        const uri = template.uriTemplate.replace(/\{(\w+)\}/g, (_, key) => params[key] ?? `{${key}}`);
+                        if (typeof content === "string") {
+                            return {
+                                contents: [{ uri, mimeType: template.mimeType, text: content }],
+                            };
+                        }
+                        else {
+                            const base64 = Buffer.from(content).toString("base64");
+                            return {
+                                contents: [{ uri, mimeType: template.mimeType, blob: base64 }],
+                            };
+                        }
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        logger.error(SdkBindingMessages.TEMPLATE_READ_ERROR, template.uriTemplate, msg);
+                        throw error;
+                    }
+                }, { kind: SpanKind.SERVER });
+            });
+            logger.trace(SdkBindingMessages.TEMPLATE_REGISTERED, template.name, template.uriTemplate);
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Private SDK Binding Helpers
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Extracts variable names from a URI template string (RFC 6570).
+     *
+     * @param uriTemplate - URI template pattern (e.g., 'notes://note/{noteId}')
+     * @returns Array of variable names (e.g., ['noteId'])
+     */
+    static extractUriTemplateVariables(uriTemplate) {
+        const matches = uriTemplate.matchAll(/\{(\w+)\}/g);
+        return [...matches].map((m) => m[1]);
+    }
+    /**
+     * Bridges framework's unified `complete(argName, argValue)` callback to SDK's
+     * per-variable `{ [variable]: (value) => string[] }` format.
+     *
+     * @sdk-constraint — SDK ResourceTemplate expects separate callbacks keyed by variable name.
+     * The framework provides a single callback to reduce boilerplate.
+     */
+    static buildResourceCompleteCallbacks(uriTemplate, complete) {
+        const variables = ResourceRegistry.extractUriTemplateVariables(uriTemplate);
+        const callbacks = {};
+        for (const variable of variables) {
+            callbacks[variable] = async (value) => {
+                try {
+                    const result = await complete(variable, value);
+                    return result.values;
+                }
+                catch (error) {
+                    logger.warn("Completion callback failed for variable '%s': %s", variable, error instanceof Error ? error.message : String(error));
+                    return [];
+                }
+            };
+        }
+        return callbacks;
+    }
+}
+// ============================================================================
+// Global Singleton Instance
+// ============================================================================
+/**
+ * Global resource registry singleton.
+ *
+ * This instance is used by defineResource() and defineResourceTemplate()
+ * for auto-registration and by createServer() to discover all resources.
+ */
+export const globalResourceRegistry = new ResourceRegistry();
+//# sourceMappingURL=resource-registry.js.map

package/build/mcp/capabilities/registry/resource-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.js","sourceRoot":"","sources":["../../../../src/mcp/capabilities/registry/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAElG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAU,QAAQ,EAAE,MAAM,KAAK,CAAC;AASvC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAEpE,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,kBAAkB,GAAG;IACzB,oBAAoB,EAAE,mDAAmD;IACzE,mBAAmB,EAAE,8BAA8B;IACnD,mBAAmB,EAAE,uCAAuC;IAC5D,oBAAoB,EAAE,8CAA8C;IACpE,YAAY,EAAE,0BAA0B;IACxC,mBAAmB,EAAE,+BAA+B;IACpD,mBAAmB,EAAE,wCAAwC;IAC7D,gBAAgB,EAAE,sBAAsB;IACxC,gBAAgB,EAAE,iDAAiD;IACnE,0BAA0B,EAAE,uDAAuD;CAC3E,CAAC;AAEX,MAAM,mBAAmB,GAAG;IAC1B,aAAa,EAAE,8EAA8E;CACrF,CAAC;AAcX,+EAA+E;AAC/E,2DAA2D;AAC3D,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,sBAAuB,SAAQ,YAAsC;IACzE,IAAuB,YAAY;QACjC,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,wBAAyB,SAAQ,YAAwC;IAC7E,IAAuB,YAAY;QACjC,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,6CAA6C;IAC5B,gBAAgB,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAEjE,+CAA+C;IAC9B,gBAAgB,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAEnE,6EAA6E;IAC7E,UAAU;IACV,6EAA6E;IAE7E;;;;OAIG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,iEAAiE;IACjE,6EAA6E;IAE7E,gFAAgF;IAChF,gBAAgB,CAAC,QAAkC;QACjD,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,iFAAiF;IACjF,yBAAyB,CAAC,QAAkC;QAC1D,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,qCAAqC;IACrC,kBAAkB,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,8BAA8B;IAC9B,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,kCAAkC;IAClC,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,6EAA6E;IAC7E,iEAAiE;IACjE,6EAA6E;IAE7E,2DAA2D;IAC3D,gBAAgB,CAAC,QAAoC;QACnD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,mDAAmD;IACnD,yBAAyB,CAAC,QAAoC;QAC5D,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,qCAAqC;IACrC,kBAAkB,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,8BAA8B;IAC9B,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,kCAAkC;IAClC,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,6EAA6E;IAC7E,uCAAuC;IACvC,6EAA6E;IAE7E;;;;;;;;;;OAUG;IACH,2BAA2B,CAAgC,QAA4C;QACrG,0FAA0F;QAC1F,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,QAAiD,CAAC,CAAC;IAC7F,CAAC;IAED,6EAA6E;IAC7E,gBAAgB;IAChB,6EAA6E;IAE7E,6EAA6E;IAC7E,yBAAyB;IACzB,6EAA6E;IAE7E;;;;OAIG;IACK,0BAA0B,CAAC,OAAe,EAAE,GAAW;QAC7D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;YACtD,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,gBAAgB;IAChB,6EAA6E;IAE7E,2BAA2B;IAC3B,cAAc;QACZ,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,2BAA2B;IAC3B,cAAc;QACZ,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,yCAAyC;IACzC,KAAK;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,sDAAsD;IACtD,6EAA6E;IAE7E,sCAAsC;IACtC,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,sCAAsC;IACtC,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,6EAA6E;IAC7E,kCAAkC;IAClC,6EAA6E;IAE7E;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,6EAA6E;IAC7E,cAAc;IACd,6EAA6E;IAE7E;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,SAAS,CACd,GAAc,EACd,SAA8C,EAC9C,SAAgD,EAChD,OAA4B;QAE5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAE3B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAE1F,4BAA4B;QAC5B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,GAAG,CAAC,gBAAgB,CAClB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,GAAG,EACZ,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAClE,KAAK,EAAE,IAAS,EAAE,KAAoD,EAAE,EAAE;gBACxE,2BAA2B;gBAC3B,mBAAmB,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAE/F,OAAO,QAAQ,CACb,mBAAmB,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE;oBACb,IAAI,CAAC,aAAa,CAAC;wBACjB,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,GAAG;wBAC3C,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,eAAe;qBAC5C,CAAC,CAAC;oBAEH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAEhE,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;wBAEtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;4BAChC,OAAO;gCACL,QAAQ,EAAE;oCACR;wCACE,GAAG,EAAE,QAAQ,CAAC,GAAG;wCACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wCAC3B,IAAI,EAAE,OAAO;qCACd;iCACF;6BACF,CAAC;wBACJ,CAAC;6BAAM,CAAC;4BACN,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;4BACvD,OAAO;gCACL,QAAQ,EAAE;oCACR;wCACE,GAAG,EAAE,QAAQ,CAAC,GAAG;wCACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wCAC3B,IAAI,EAAE,MAAM;qCACb;iCACF;6BACF,CAAC;wBACJ,CAAC;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;wBACxE,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC,EACD,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC1B,CAAC;YACJ,CAAC,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpF,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,QAAQ;gBACzC,CAAC,CAAC,gBAAgB,CAAC,8BAA8B,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBAC1F,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,WAAW,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAChE,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACjB,CAAC,CAAC,KAAK,IAAI,EAAE;wBACT,IAAI,CAAC;4BACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAK,EAAE,CAAC;4BACrC,OAAO;gCACL,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oCAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;oCACb,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;oCAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;oCACrD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;iCAC7C,CAAC,CAAC;6BACJ,CAAC;wBACJ,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;4BACjF,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBACH,CAAC,CAAC,SAAS;gBACb,GAAG,CAAC,iBAAiB,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;aAC1D,CAAC,CAAC;YAEH,GAAG,CAAC,gBAAgB,CAClB,QAAQ,CAAC,IAAI,EACb,WAAW,EACX,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAClE,KAAK,EACH,IAAS,EACT,SAA4C,EAC5C,KAAoD,EACpD,EAAE;gBACF,2BAA2B;gBAC3B,mBAAmB,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAEvG,OAAO,QAAQ,CACb,mBAAmB,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE;oBACb,IAAI,CAAC,aAAa,CAAC;wBACjB,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,WAAW;wBACxD,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,eAAe;qBAC5C,CAAC,CAAC;oBAEH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;oBAEnF,kDAAkD;oBAClD,MAAM,MAAM,GAA2B,EAAE,CAAC;oBAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;wBACrD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAChE,CAAC;oBAED,qEAAqE;oBACrE,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACnB,IAAI,CAAC;4BACH,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;wBAC1C,CAAC;wBAAC,OAAO,eAAe,EAAE,CAAC;4BACzB,MAAM,GAAG,GACP,eAAe,YAAY,QAAQ;gCACjC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCACnF,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;4BAC9B,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,0BAA0B,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;4BACtF,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,yCAAyC,GAAG,EAAE,CAAC,CAAC;wBAC9F,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAE5C,+CAA+C;wBAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;wBAE9F,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;4BAChC,OAAO;gCACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;6BAChE,CAAC;wBACJ,CAAC;6BAAM,CAAC;4BACN,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;4BACvD,OAAO;gCACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;6BAC/D,CAAC;wBACJ,CAAC;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;wBAChF,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC,EACD,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC1B,CAAC;YACJ,CAAC,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,8BAA8B;IAC9B,6EAA6E;IAE7E;;;;;OAKG;IACK,MAAM,CAAC,2BAA2B,CAAC,WAAmB;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,8BAA8B,CAC3C,WAAmB,EACnB,QAA4B;QAE5B,MAAM,SAAS,GAAG,gBAAgB,CAAC,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAoE,EAAE,CAAC;QAEtF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;gBAC5C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC/C,OAAO,MAAM,CAAC,MAAM,CAAC;gBACvB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,kDAAkD,EAClD,QAAQ,EACR,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;oBACF,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}