@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/mcp-server/tools/utils/newToolDefinition.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview New-style tool definition types and `tool()` builder function.
+ * Uses the Phase 3 field names: `handler`, `input`, `output`, `format`, `auth`, `task`.
+ * Coexists with the legacy `ToolDefinition` during migration.
+ * @module src/mcp-server/tools/utils/newToolDefinition
+ */
+import type { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
+import type { ZodObject, ZodRawShape, z } from 'zod';
+import type { Context } from '../../../context.js';
+import type { ToolAnnotations } from '../../../mcp-server/tools/utils/toolDefinition.js';
+export type { ToolAnnotations };
+/**
+ * New-style tool definition with simplified field names.
+ * Produced by the `tool()` builder or constructed directly.
+ */
+export interface NewToolDefinition<TInput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>, TOutput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>> {
+    /** Protocol-level metadata (e.g., MCP Apps extension). */
+    _meta?: Record<string, unknown>;
+    /** UI/behavior hints for clients. */
+    annotations?: ToolAnnotations;
+    /** Required auth scopes. Checked by handler factory before calling handler. */
+    auth?: string[];
+    /** LLM-facing description. */
+    description: string;
+    /**
+     * Optional formatter mapping output to ContentBlock[].
+     * If omitted, the handler factory JSON-stringifies the output.
+     */
+    format?: (result: z.infer<TOutput>) => ContentBlock[];
+    /**
+     * The core handler function. Receives validated input and unified Context.
+     * Throw McpError on failure — no try/catch needed.
+     */
+    handler: (input: z.infer<TInput>, ctx: Context) => Promise<z.infer<TOutput>> | z.infer<TOutput>;
+    /** Zod schema for input validation. All fields need `.describe()`. */
+    input: TInput;
+    /** Programmatic unique name (snake_case). */
+    name: string;
+    /** Zod schema for output validation. */
+    output?: TOutput;
+    /** When true, the framework manages task lifecycle automatically. */
+    task?: boolean;
+    /** Human-readable title for UI display. */
+    title?: string;
+}
+/** Type-erased union for mixed arrays passed to createApp(). */
+export type AnyNewToolDefinition = NewToolDefinition<ZodObject<ZodRawShape>, ZodObject<ZodRawShape>>;
+/**
+ * Type guard: is this a new-style tool definition?
+ * Distinguishes from legacy ToolDefinition (which has `logic` + `inputSchema`)
+ * and TaskToolDefinition (which has `taskHandlers`).
+ */
+export declare function isNewToolDefinition(def: unknown): def is AnyNewToolDefinition;
+/**
+ * Creates a new-style tool definition with full type inference from Zod schemas.
+ *
+ * @example
+ * ```ts
+ * const myTool = tool('my_tool', {
+ *   description: 'Does something useful.',
+ *   input: z.object({ query: z.string().describe('Search query') }),
+ *   output: z.object({ result: z.string().describe('Search result') }),
+ *   auth: ['tool:my_tool:read'],
+ *   annotations: { readOnlyHint: true },
+ *   async handler(input, ctx) {
+ *     ctx.log.info('Processing', { query: input.query });
+ *     return { result: `Found: ${input.query}` };
+ *   },
+ * });
+ * ```
+ */
+export declare function tool<TInput extends ZodObject<ZodRawShape>, TOutput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>>(name: string, options: Omit<NewToolDefinition<TInput, TOutput>, 'name'>): NewToolDefinition<TInput, TOutput>;
+//# sourceMappingURL=newToolDefinition.d.ts.map

package/dist/mcp-server/tools/utils/newToolDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newToolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/newToolDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAGlF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAChC,MAAM,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,EAC9D,OAAO,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC;IAE/D,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qCAAqC;IACrC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,YAAY,EAAE,CAAC;IACtD;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChG,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAClD,SAAS,CAAC,WAAW,CAAC,EACtB,SAAS,CAAC,WAAW,CAAC,CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAU7E;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAClB,MAAM,SAAS,SAAS,CAAC,WAAW,CAAC,EACrC,OAAO,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,EAE/D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,GACxD,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpC"}

package/dist/mcp-server/tools/utils/newToolDefinition.js

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview New-style tool definition types and `tool()` builder function.
+ * Uses the Phase 3 field names: `handler`, `input`, `output`, `format`, `auth`, `task`.
+ * Coexists with the legacy `ToolDefinition` during migration.
+ * @module src/mcp-server/tools/utils/newToolDefinition
+ */
+/**
+ * Type guard: is this a new-style tool definition?
+ * Distinguishes from legacy ToolDefinition (which has `logic` + `inputSchema`)
+ * and TaskToolDefinition (which has `taskHandlers`).
+ */
+export function isNewToolDefinition(def) {
+    return (def !== null &&
+        typeof def === 'object' &&
+        'handler' in def &&
+        typeof def.handler === 'function' &&
+        'input' in def &&
+        !('taskHandlers' in def) &&
+        !('logic' in def));
+}
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new-style tool definition with full type inference from Zod schemas.
+ *
+ * @example
+ * ```ts
+ * const myTool = tool('my_tool', {
+ *   description: 'Does something useful.',
+ *   input: z.object({ query: z.string().describe('Search query') }),
+ *   output: z.object({ result: z.string().describe('Search result') }),
+ *   auth: ['tool:my_tool:read'],
+ *   annotations: { readOnlyHint: true },
+ *   async handler(input, ctx) {
+ *     ctx.log.info('Processing', { query: input.query });
+ *     return { result: `Found: ${input.query}` };
+ *   },
+ * });
+ * ```
+ */
+export function tool(name, options) {
+    return { name, ...options };
+}
+//# sourceMappingURL=newToolDefinition.js.map

package/dist/mcp-server/tools/utils/newToolDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newToolDefinition.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/newToolDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,SAAS,IAAI,GAAG;QAChB,OAAQ,GAA+B,CAAC,OAAO,KAAK,UAAU;QAC9D,OAAO,IAAI,GAAG;QACd,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC;QACxB,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,CAClB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAIlB,IAAY,EACZ,OAAyD;IAEzD,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/mcp-server/tools/utils/newToolHandlerFactory.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Handler factory for new-style tool definitions.
+ * Constructs Context, checks inline auth, measures execution, formats response.
+ * @module src/mcp-server/tools/utils/newToolHandlerFactory
+ */
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CallToolResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { StorageService } from '../../../storage/core/StorageService.js';
+import type { Logger } from '../../../utils/internal/logger.js';
+import type { AnyNewToolDefinition } from './newToolDefinition.js';
+type SdkExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+/** Services required by the handler factory to construct Context. */
+export interface HandlerFactoryServices {
+    logger: Logger;
+    storage: StorageService;
+}
+/**
+ * Creates an MCP tool handler from a new-style tool definition.
+ * The returned function is compatible with the MCP SDK's ToolCallback type.
+ *
+ * Responsibilities:
+ * - Creates RequestContext from SDK context (for tracing)
+ * - Creates unified Context (for the handler)
+ * - Checks inline `auth` scopes if defined
+ * - Validates input via Zod schema
+ * - Measures execution time
+ * - Formats response via `format` or JSON default
+ * - Catches errors and returns `isError: true`
+ */
+export declare function createNewToolHandler(def: AnyNewToolDefinition, services: HandlerFactoryServices): (input: z.input<typeof def.input>, extra: SdkExtra) => Promise<CallToolResult>;
+export {};
+//# sourceMappingURL=newToolHandlerFactory.d.ts.map

package/dist/mcp-server/tools/utils/newToolHandlerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newToolHandlerFactory.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/newToolHandlerFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,cAAc,EAEd,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAA0B,CAAC,EAAE,MAAM,KAAK,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAMnE,KAAK,QAAQ,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAWvE,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,CAsEhF"}

package/dist/mcp-server/tools/utils/newToolHandlerFactory.js

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Handler factory for new-style tool definitions.
+ * Constructs Context, checks inline auth, measures execution, formats response.
+ * @module src/mcp-server/tools/utils/newToolHandlerFactory
+ */
+import { createContext } from '../../../context.js';
+import { withRequiredScopes } from '../../../mcp-server/transports/auth/lib/authUtils.js';
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { ErrorHandler } from '../../../utils/internal/error-handler/errorHandler.js';
+import { measureToolExecution } from '../../../utils/internal/performance.js';
+import { requestContextService } from '../../../utils/internal/requestContext.js';
+// ---------------------------------------------------------------------------
+// Default formatter
+// ---------------------------------------------------------------------------
+const defaultResponseFormatter = (result) => [
+    { type: 'text', text: JSON.stringify(result, null, 2) },
+];
+// ---------------------------------------------------------------------------
+// Capability detection helpers
+// ---------------------------------------------------------------------------
+function wrapElicit(sdkContext) {
+    if (typeof sdkContext.elicitInput !== 'function')
+        return;
+    const fn = sdkContext.elicitInput;
+    return (msg, schema) => fn({ message: msg, requestedSchema: schema });
+}
+function wrapSample(sdkContext) {
+    if (typeof sdkContext.createMessage !== 'function')
+        return;
+    const fn = sdkContext.createMessage;
+    return (msgs, opts) => fn({ messages: msgs, ...opts });
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates an MCP tool handler from a new-style tool definition.
+ * The returned function is compatible with the MCP SDK's ToolCallback type.
+ *
+ * Responsibilities:
+ * - Creates RequestContext from SDK context (for tracing)
+ * - Creates unified Context (for the handler)
+ * - Checks inline `auth` scopes if defined
+ * - Validates input via Zod schema
+ * - Measures execution time
+ * - Formats response via `format` or JSON default
+ * - Catches errors and returns `isError: true`
+ */
+export function createNewToolHandler(def, services) {
+    const formatter = def.format ?? defaultResponseFormatter;
+    return async (input, callContext) => {
+        // The SDK types `extra` as Record<string, unknown> at the boundary
+        const sdkContext = callContext;
+        const sdkCaps = callContext;
+        const sessionId = typeof sdkContext?.sessionId === 'string' ? sdkContext.sessionId : undefined;
+        // Create internal RequestContext for tracing
+        const appContext = requestContextService.createRequestContext({
+            parentContext: {
+                ...(typeof sdkContext?.requestId === 'string' ? { requestId: sdkContext.requestId } : {}),
+                ...(sessionId ? { sessionId } : {}),
+            },
+            operation: 'HandleToolRequest',
+            additionalContext: { toolName: def.name, sessionId, input },
+        });
+        try {
+            // Check inline auth scopes
+            if (def.auth && def.auth.length > 0) {
+                withRequiredScopes(def.auth, appContext);
+            }
+            // Validate input
+            const validatedInput = def.input.parse(input);
+            // Construct Context with detected capabilities
+            const ctx = createContext({
+                appContext,
+                logger: services.logger,
+                storage: services.storage,
+                signal: sdkContext.signal,
+                elicit: wrapElicit(sdkCaps),
+                sample: wrapSample(sdkCaps),
+            });
+            // Execute handler with performance measurement.
+            // Wrap with Promise.resolve — handler may return sync or async.
+            const result = await measureToolExecution(() => Promise.resolve(def.handler(validatedInput, ctx)), { ...appContext, toolName: def.name }, validatedInput);
+            return {
+                structuredContent: result,
+                content: formatter(result),
+            };
+        }
+        catch (error) {
+            const handled = ErrorHandler.handleError(error, {
+                operation: `tool:${def.name}`,
+                context: appContext,
+                input,
+            });
+            const mcpError = handled instanceof McpError
+                ? handled
+                : new McpError(JsonRpcErrorCode.InternalError, handled.message, {
+                    originalError: handled.name,
+                });
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Error: ${mcpError.message}` }],
+            };
+        }
+    };
+}
+//# sourceMappingURL=newToolHandlerFactory.js.map

package/dist/mcp-server/tools/utils/newToolHandlerFactory.js.map

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

package/dist/mcp-server/tools/utils/toolDefinition.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Defines the standard structure for a declarative tool definition.
+ * This interface ensures that all tools provide the necessary metadata (name, schemas)
+ * and logic in a consistent, self-contained format, aligned with MCP specifications.
+ * @module mcp-server/tools/utils/toolDefinition
+ */
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ContentBlock, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { ZodObject, ZodRawShape, z } from 'zod';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+/**
+ * Defines the annotations that provide hints about a tool's behavior.
+ * These are not guarantees but are useful for client-side rendering and decision-making.
+ * The index signature `[key: string]: unknown;` ensures compatibility with the MCP SDK.
+ */
+export interface ToolAnnotations {
+    /**
+     * A hint indicating that the tool may destroy or modify data in a way that cannot
+     * be undone. Only meaningful when `readOnlyHint` is false (the default).
+     * Defaults to `true` when unset.
+     */
+    destructiveHint?: boolean;
+    /**
+     * A hint indicating that repeated calls with the same arguments have no additional
+     * effect beyond the first call. Only meaningful when `readOnlyHint` is false.
+     * Defaults to `false` when unset.
+     */
+    idempotentHint?: boolean;
+    /**
+     * A hint indicating that the tool may interact with external, unpredictable,
+     * or dynamic systems (e.g., fetching from a live API, web search).
+     */
+    openWorldHint?: boolean;
+    /**
+     * A hint indicating that the tool does not modify any state.
+     * For example, a "read" operation.
+     */
+    readOnlyHint?: boolean;
+    /**
+     * An optional human-readable name for the tool, optimized for UI display.
+     * If provided, it may be used by clients instead of the programmatic `name`.
+     */
+    title?: string;
+    [key: string]: unknown;
+}
+/**
+ * A type alias for the SDK's `RequestHandlerExtra` context, making it more
+ * specific and easier to reference in our tool logic signatures.
+ */
+export type SdkContext = RequestHandlerExtra<ServerRequest, ServerNotification>;
+/**
+ * Represents the complete, self-contained definition of an MCP tool.
+ */
+export interface ToolDefinition<TInputSchema extends ZodObject<ZodRawShape>, TOutputSchema extends ZodObject<ZodRawShape>> {
+    /**
+     * Optional protocol-level metadata passed alongside the tool registration.
+     * Extensions use namespaced keys within `_meta` to attach additional semantics.
+     *
+     * Currently used by the MCP Apps extension (`io.modelcontextprotocol/ui`)
+     * to link a tool to an interactive UI resource.
+     */
+    _meta?: Record<string, unknown>;
+    /**
+     * Optional metadata providing hints about the tool's behavior.
+     */
+    annotations?: ToolAnnotations;
+    /**
+     * A clear, concise description of what the tool does.
+     * This is sent to the LLM to help it decide when to use the tool.
+     */
+    description: string;
+    /**
+     * The Zod schema for validating the tool's input parameters.
+     */
+    inputSchema: TInputSchema;
+    /**
+     * The core business logic function for the tool. It receives the validated
+     * input and two context objects, and returns a structured output or throws an McpError.
+     *
+     * @param input The validated tool input, conforming to `inputSchema`.
+     *
+     * @param appContext The application's internal `RequestContext`. This should be
+     * passed to any internal services (like the logger) for consistent tracing and
+     * session management. It contains IDs (`requestId`, `sessionId`, `traceId`)
+     * and scoping information (`clientId`, `tenantId`, `scopes`).
+     *
+     * @param sdkContext The raw `SdkContext` (`RequestHandlerExtra`) from the MCP
+     * SDK. This provides access to lower-level protocol capabilities:
+     * - `signal`: An `AbortSignal` for handling request cancellation.
+     * - `sendNotification`: Send a notification back to the client.
+     * - `sendRequest`: Send a new request to the client (e.g., for elicitation).
+     * - `authInfo`: Raw, validated authentication information.
+     *
+     * @returns A promise that resolves with the structured output, conforming to `outputSchema`.
+     */
+    logic: (input: z.infer<TInputSchema>, appContext: RequestContext, sdkContext: SdkContext) => Promise<z.infer<TOutputSchema>>;
+    /**
+     * The programmatic, unique name for the tool (e.g., 'echo_message').
+     */
+    name: string;
+    /**
+     * The Zod schema for validating the tool's successful output structure.
+     */
+    outputSchema: TOutputSchema;
+    /**
+     * An optional function to format the successful output into an array of ContentBlocks
+     * for the `CallToolResult`. If not provided, a default JSON stringifier is used.
+     * @param result The successful output from the logic function.
+     * @returns An array of ContentBlocks to be sent to the client.
+     */
+    responseFormatter?: (result: z.infer<TOutputSchema>) => ContentBlock[];
+    /**
+     * An optional, human-readable title for the tool. This is preferred for display in UIs.
+     * If not provided, the `name` or `annotations.title` may be used as a fallback.
+     */
+    title?: string;
+}
+//# sourceMappingURL=toolDefinition.d.ts.map

package/dist/mcp-server/tools/utils/toolDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,cAAc,CAC7B,YAAY,SAAS,SAAS,CAAC,WAAW,CAAC,EAC3C,aAAa,SAAS,SAAS,CAAC,WAAW,CAAC;IAE5C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,YAAY,CAAC;IAC1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,EAAE,CACL,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,EAAE,aAAa,CAAC;IAC5B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,YAAY,EAAE,CAAC;IACvE;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/mcp-server/tools/utils/toolDefinition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolDefinition.js.map

package/dist/mcp-server/tools/utils/toolDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDefinition.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolDefinition.ts"],"names":[],"mappings":""}

package/dist/mcp-server/tools/utils/toolHandlerFactory.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview A factory for creating standardized MCP tool handlers.
+ * This module abstracts away the boilerplate of error handling, context creation,
+ * performance measurement, and response formatting for tool handlers.
+ * @module mcp-server/tools/utils/toolHandlerFactory
+ */
+import type { AnySchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CallToolResult, ContentBlock, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+import type { SdkContext } from './toolDefinition.js';
+/**
+ * Options for creating an MCP tool handler via the factory.
+ * Uses `AnySchema` from the SDK for Zod 3/4 compatibility.
+ */
+export type ToolHandlerFactoryOptions<TInputSchema extends AnySchema, TOutput extends Record<string, unknown>> = {
+    toolName: string;
+    /** The input schema, captured for type inference (not used at runtime). */
+    inputSchema: TInputSchema;
+    logic: (input: z.infer<TInputSchema>, appContext: RequestContext, sdkContext: SdkContext) => Promise<TOutput>;
+    responseFormatter?: (result: TOutput) => ContentBlock[];
+};
+/**
+ * Creates a standardized MCP tool handler.
+ * This factory encapsulates context creation, performance measurement,
+ * error handling, and response formatting. It separates the app's internal
+ * RequestContext from the SDK's `callContext` (which we type as `SdkContext`).
+ *
+ * @param options - Factory options including toolName, inputSchema, logic, and optional responseFormatter
+ * @returns A handler function compatible with the MCP SDK's ToolCallback type
+ */
+export declare function createMcpToolHandler<TInputSchema extends AnySchema, TOutput extends Record<string, unknown>>({ toolName, inputSchema, logic, responseFormatter, }: ToolHandlerFactoryOptions<TInputSchema, TOutput>): (input: z.infer<TInputSchema>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<CallToolResult>;
+//# sourceMappingURL=toolHandlerFactory.d.ts.map

package/dist/mcp-server/tools/utils/toolHandlerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHandlerFactory.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolHandlerFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD;;;GAGG;AACH,MAAM,MAAM,yBAAyB,CACnC,YAAY,SAAS,SAAS,EAC9B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACrC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,YAAY,CAAC;IAC1B,KAAK,EAAE,CACL,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,YAAY,EAAE,CAAC;CACzD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,SAAS,SAAS,EAC9B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,EACA,QAAQ,EACR,WAAW,EACX,KAAK,EACL,iBAA4C,GAC7C,EAAE,yBAAyB,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,KAAK,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,KAC1D,OAAO,CAAC,cAAc,CAAC,CA+D3B"}

package/dist/mcp-server/tools/utils/toolHandlerFactory.js

@@ -0,0 +1,68 @@
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { ErrorHandler } from '../../../utils/internal/error-handler/errorHandler.js';
+import { measureToolExecution } from '../../../utils/internal/performance.js';
+import { requestContextService } from '../../../utils/internal/requestContext.js';
+// Default formatter for successful responses
+const defaultResponseFormatter = (result) => [
+    { type: 'text', text: JSON.stringify(result, null, 2) },
+];
+/**
+ * Creates a standardized MCP tool handler.
+ * This factory encapsulates context creation, performance measurement,
+ * error handling, and response formatting. It separates the app's internal
+ * RequestContext from the SDK's `callContext` (which we type as `SdkContext`).
+ *
+ * @param options - Factory options including toolName, inputSchema, logic, and optional responseFormatter
+ * @returns A handler function compatible with the MCP SDK's ToolCallback type
+ */
+export function createMcpToolHandler({ toolName, inputSchema, logic, responseFormatter = defaultResponseFormatter, }) {
+    return async (input, callContext) => {
+        // The SDK types `extra` as `Record<string, unknown>` at this boundary, but the
+        // runtime object always carries the full SdkContext shape (signal, sendNotification,
+        // sendRequest, authInfo, and optional capabilities like elicitInput/createMessage).
+        // This cast is unavoidable at the SDK/app type boundary.
+        const sdkContext = callContext;
+        const sessionId = typeof sdkContext?.sessionId === 'string' ? sdkContext.sessionId : undefined;
+        // Extract only plain-data fields from sdkContext — spreading the raw SDK
+        // object copies native objects (AbortSignal) that crash Pino serialization.
+        const appContext = requestContextService.createRequestContext({
+            parentContext: {
+                ...(typeof sdkContext?.requestId === 'string' ? { requestId: sdkContext.requestId } : {}),
+                ...(sessionId ? { sessionId } : {}),
+            },
+            operation: 'HandleToolRequest',
+            additionalContext: { toolName, sessionId, input },
+        });
+        try {
+            // Defense-in-depth: validate input even though the SDK should have already parsed it.
+            // AnySchema is the SDK's Zod 3/4 compat type — cast to access .parse() at runtime.
+            const validatedInput = inputSchema.parse(input);
+            const result = await measureToolExecution(
+            // Pass both the app's internal context and the full SDK context to the logic.
+            () => logic(validatedInput, appContext, sdkContext), { ...appContext, toolName }, validatedInput);
+            return {
+                structuredContent: result,
+                content: responseFormatter(result),
+            };
+        }
+        catch (error) {
+            // handleError always returns McpError when no errorMapper is provided,
+            // but its declared return type is the broader Error. Narrow with instanceof.
+            const handled = ErrorHandler.handleError(error, {
+                operation: `tool:${toolName}`,
+                context: appContext,
+                input,
+            });
+            const mcpError = handled instanceof McpError
+                ? handled
+                : new McpError(JsonRpcErrorCode.InternalError, handled.message, {
+                    originalError: handled.name,
+                });
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Error: ${mcpError.message}` }],
+            };
+        }
+    };
+}
+//# sourceMappingURL=toolHandlerFactory.js.map

package/dist/mcp-server/tools/utils/toolHandlerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHandlerFactory.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolHandlerFactory.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,6CAA6C;AAC7C,MAAM,wBAAwB,GAAG,CAAC,MAAe,EAAkB,EAAE,CAAC;IACpE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;CACxD,CAAC;AAqBF;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAGlC,EACA,QAAQ,EACR,WAAW,EACX,KAAK,EACL,iBAAiB,GAAG,wBAAwB,GACK;IAIjD,OAAO,KAAK,EACV,KAA4B,EAC5B,WAAoC,EACX,EAAE;QAC3B,+EAA+E;QAC/E,qFAAqF;QACrF,oFAAoF;QACpF,yDAAyD;QACzD,MAAM,UAAU,GAAG,WAAyB,CAAC;QAE7C,MAAM,SAAS,GAAG,OAAO,UAAU,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/F,yEAAyE;QACzE,4EAA4E;QAC5E,MAAM,UAAU,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YAC5D,aAAa,EAAE;gBACb,GAAG,CAAC,OAAO,UAAU,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC;YACD,SAAS,EAAE,mBAAmB;YAC9B,iBAAiB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;SAClD,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,sFAAsF;YACtF,mFAAmF;YACnF,MAAM,cAAc,GAAI,WAAoC,CAAC,KAAK,CAChE,KAAK,CACmB,CAAC;YAE3B,MAAM,MAAM,GAAG,MAAM,oBAAoB;YACvC,8EAA8E;YAC9E,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,CAAC,EACnD,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,EAC3B,cAAc,CACf,CAAC;YAEF,OAAO;gBACL,iBAAiB,EAAE,MAAM;gBACzB,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,uEAAuE;YACvE,6EAA6E;YAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE;gBAC9C,SAAS,EAAE,QAAQ,QAAQ,EAAE;gBAC7B,OAAO,EAAE,UAAU;gBACnB,KAAK;aACN,CAAC,CAAC;YACH,MAAM,QAAQ,GACZ,OAAO,YAAY,QAAQ;gBACzB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE;oBAC5D,aAAa,EAAE,OAAO,CAAC,IAAI;iBAC5B,CAAC,CAAC;YAET,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;aAChE,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp-server/transports/ITransport.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Defines transport-related types.
+ * @module src/mcp-server/transports/ITransport
+ */
+import type { ServerType } from '@hono/node-server';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export type TransportServer = ServerType | McpServer;
+/**
+ * Transport lifecycle contract for HTTP and stdio transports.
+ */
+export interface ITransport {
+    start(): Promise<TransportServer>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=ITransport.d.ts.map

package/dist/mcp-server/transports/ITransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/ITransport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/mcp-server/transports/ITransport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ITransport.js.map

package/dist/mcp-server/transports/ITransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/ITransport.ts"],"names":[],"mappings":""}

package/dist/mcp-server/transports/auth/authFactory.d.ts

@@ -0,0 +1,11 @@
+import type { AuthStrategy } from '../../../mcp-server/transports/auth/strategies/authStrategy.js';
+/**
+ * Creates and returns an authentication strategy instance based on the
+ * application's configuration (`config.mcpAuthMode`).
+ *
+ * @returns An instance of a class that implements the `AuthStrategy` interface,
+ *          or `null` if authentication is disabled (`none`).
+ * @throws {Error} If the auth mode is unknown or misconfigured.
+ */
+export declare function createAuthStrategy(): AuthStrategy | null;
+//# sourceMappingURL=authFactory.d.ts.map

package/dist/mcp-server/transports/auth/authFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authFactory.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/auth/authFactory.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AAM5F;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAuBxD"}

package/dist/mcp-server/transports/auth/authFactory.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Factory for creating an authentication strategy based on configuration.
+ * This module centralizes the logic for selecting and instantiating the correct
+ * authentication strategy, promoting loose coupling and easy extensibility.
+ * @module src/mcp-server/transports/auth/authFactory
+ */
+import { config } from '../../../config/index.js';
+import { JwtStrategy } from '../../../mcp-server/transports/auth/strategies/jwtStrategy.js';
+import { OauthStrategy } from '../../../mcp-server/transports/auth/strategies/oauthStrategy.js';
+import { logger } from '../../../utils/internal/logger.js';
+import { requestContextService } from '../../../utils/internal/requestContext.js';
+/**
+ * Creates and returns an authentication strategy instance based on the
+ * application's configuration (`config.mcpAuthMode`).
+ *
+ * @returns An instance of a class that implements the `AuthStrategy` interface,
+ *          or `null` if authentication is disabled (`none`).
+ * @throws {Error} If the auth mode is unknown or misconfigured.
+ */
+export function createAuthStrategy() {
+    const context = requestContextService.createRequestContext({
+        operation: 'createAuthStrategy',
+        authMode: config.mcpAuthMode,
+    });
+    logger.info('Creating authentication strategy...', context);
+    switch (config.mcpAuthMode) {
+        case 'jwt':
+            logger.debug('Creating JWT strategy.', context);
+            return new JwtStrategy(config, logger);
+        case 'oauth':
+            logger.debug('Creating OAuth strategy.', context);
+            return new OauthStrategy(config, logger);
+        case 'none':
+            logger.info("Authentication is disabled ('none' mode).", context);
+            return null; // No authentication
+        default:
+            // This ensures that if a new auth mode is added to the config type
+            // but not to this factory, we get a compile-time or runtime error.
+            logger.error(`Unknown authentication mode: ${String(config.mcpAuthMode)}`, context);
+            throw new Error(`Unknown authentication mode: ${String(config.mcpAuthMode)}`);
+    }
+}
+//# sourceMappingURL=authFactory.js.map

package/dist/mcp-server/transports/auth/authFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authFactory.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/auth/authFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,wDAAwD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,0DAA0D,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;QACzD,SAAS,EAAE,oBAAoB;QAC/B,QAAQ,EAAE,MAAM,CAAC,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,OAAO,CAAC,CAAC;IAE5D,QAAQ,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3B,KAAK,KAAK;YACR,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,KAAK,OAAO;YACV,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,MAAM;YACT,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC,CAAC,oBAAoB;QACnC;YACE,mEAAmE;YACnE,mEAAmE;YACnE,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}