@leanmcp/core 0.3.14 → 0.3.16

package/dist/index.d.mts

@@ -1,5 +1,133 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
+/**
+ * Simple configurable logger for LeanMCP SDK
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    timestamps?: boolean;
+    /**
+     * Enable or disable ANSI colors. Defaults to true.
+     */
+    colorize?: boolean;
+    /**
+     * Provide additional metadata context (e.g. module name)
+     */
+    context?: string;
+    /**
+     * Optional third-party handlers (PostHog, Sentry, etc.)
+     * They receive the structured payload for easy integration.
+     */
+    handlers?: LoggerHandler[];
+}
+interface LogPayload {
+    level: LogLevel;
+    levelLabel: string;
+    message: string;
+    args: any[];
+    prefix?: string;
+    context?: string;
+    timestamp: string;
+}
+type LoggerHandler = (payload: LogPayload) => void;
+declare class Logger {
+    private level;
+    private prefix;
+    private timestamps;
+    private colorize;
+    private context?;
+    private handlers;
+    constructor(options?: LoggerOptions);
+    private format;
+    private shouldLog;
+    private emit;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+declare const defaultLogger: Logger;
+
+interface HTTPServerOptions {
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    logging?: boolean;
+    logger?: Logger;
+    sessionTimeout?: number;
+    stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) */
+    auth?: HTTPServerAuthOptions;
+}
+/**
+ * OAuth/Auth configuration for MCP server
+ *
+ * Enables MCP authorization spec compliance by exposing
+ * `/.well-known/oauth-protected-resource` (RFC 9728)
+ */
+interface HTTPServerAuthOptions {
+    /** Resource identifier (defaults to server URL) */
+    resource?: string;
+    /** Authorization servers (defaults to self) */
+    authorizationServers?: string[];
+    /** Supported OAuth scopes */
+    scopesSupported?: string[];
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Enable built-in OAuth authorization server */
+    enableOAuthServer?: boolean;
+    /** OAuth server options (when enableOAuthServer is true) */
+    oauthServerOptions?: {
+        /** Session secret for signing tokens/state */
+        sessionSecret: string;
+        /** JWT signing secret (defaults to sessionSecret if not provided) */
+        jwtSigningSecret?: string;
+        /** JWT encryption secret for encrypting upstream tokens */
+        jwtEncryptionSecret?: Buffer;
+        /** Issuer URL for JWTs */
+        issuer?: string;
+        /** Access token TTL in seconds (default: 3600) */
+        tokenTTL?: number;
+        /** Enable Dynamic Client Registration (DCR) */
+        enableDCR?: boolean;
+        /** Upstream OAuth provider configuration */
+        upstreamProvider?: {
+            id: string;
+            authorizationEndpoint: string;
+            tokenEndpoint: string;
+            clientId: string;
+            clientSecret: string;
+            scopes?: string[];
+            userInfoEndpoint?: string;
+        };
+    };
+}
+interface MCPServerFactory {
+    (): Server | Promise<Server>;
+}
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
+/**
+ * Create an HTTP server for MCP with Streamable HTTP transport
+ * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
+ */
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
+
 /**
  * Security scheme for MCP tools (per MCP authorization spec)
  *
@@ -220,132 +348,6 @@ declare function SchemaConstraint(constraints: {
  */
 declare function classToJsonSchemaWithConstraints(classConstructor: new () => any): any;
 
-/**
- * Simple configurable logger for LeanMCP SDK
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-interface LoggerOptions {
-    level?: LogLevel;
-    prefix?: string;
-    timestamps?: boolean;
-    /**
-     * Enable or disable ANSI colors. Defaults to true.
-     */
-    colorize?: boolean;
-    /**
-     * Provide additional metadata context (e.g. module name)
-     */
-    context?: string;
-    /**
-     * Optional third-party handlers (PostHog, Sentry, etc.)
-     * They receive the structured payload for easy integration.
-     */
-    handlers?: LoggerHandler[];
-}
-interface LogPayload {
-    level: LogLevel;
-    levelLabel: string;
-    message: string;
-    args: any[];
-    prefix?: string;
-    context?: string;
-    timestamp: string;
-}
-type LoggerHandler = (payload: LogPayload) => void;
-declare class Logger {
-    private level;
-    private prefix;
-    private timestamps;
-    private colorize;
-    private context?;
-    private handlers;
-    constructor(options?: LoggerOptions);
-    private format;
-    private shouldLog;
-    private emit;
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-}
-declare const defaultLogger: Logger;
-
-interface HTTPServerOptions {
-    port?: number;
-    cors?: boolean | {
-        origin?: string | string[];
-        credentials?: boolean;
-    };
-    logging?: boolean;
-    logger?: Logger;
-    sessionTimeout?: number;
-    stateless?: boolean;
-    dashboard?: boolean;
-    /** OAuth/Auth configuration (MCP authorization spec) */
-    auth?: HTTPServerAuthOptions;
-}
-/**
- * OAuth/Auth configuration for MCP server
- *
- * Enables MCP authorization spec compliance by exposing
- * `/.well-known/oauth-protected-resource` (RFC 9728)
- */
-interface HTTPServerAuthOptions {
-    /** Resource identifier (defaults to server URL) */
-    resource?: string;
-    /** Authorization servers (defaults to self) */
-    authorizationServers?: string[];
-    /** Supported OAuth scopes */
-    scopesSupported?: string[];
-    /** Documentation URL */
-    documentationUrl?: string;
-    /** Enable built-in OAuth authorization server */
-    enableOAuthServer?: boolean;
-    /** OAuth server options (when enableOAuthServer is true) */
-    oauthServerOptions?: {
-        /** Session secret for signing tokens/state */
-        sessionSecret: string;
-        /** JWT signing secret (defaults to sessionSecret if not provided) */
-        jwtSigningSecret?: string;
-        /** JWT encryption secret for encrypting upstream tokens */
-        jwtEncryptionSecret?: Buffer;
-        /** Issuer URL for JWTs */
-        issuer?: string;
-        /** Access token TTL in seconds (default: 3600) */
-        tokenTTL?: number;
-        /** Upstream OAuth provider configuration */
-        upstreamProvider?: {
-            id: string;
-            authorizationEndpoint: string;
-            tokenEndpoint: string;
-            clientId: string;
-            clientSecret: string;
-            scopes?: string[];
-            userInfoEndpoint?: string;
-        };
-    };
-}
-interface MCPServerFactory {
-    (): Server | Promise<Server>;
-}
-type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
-/**
- * Create an HTTP server for MCP with Streamable HTTP transport
- * Returns the HTTP server instance to keep the process alive
- *
- * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
- * @param options - HTTP server options (only used when serverInput is a factory function)
- */
-declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
-
 /**
  * Input validation utilities for LeanMCP
  * Provides secure validation for common input types
@@ -549,6 +551,7 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
     name: string;
@@ -668,10 +671,16 @@ declare class MCPServer {
         method: string;
         params?: {
             [x: string]: unknown;
+            task?: {
+                [x: string]: unknown;
+                ttl?: number | null | undefined;
+                pollInterval?: number | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
                 progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -682,8 +691,8 @@ declare class MCPServer {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
-                progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -692,8 +701,8 @@ declare class MCPServer {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
-            progressToken?: string | number | undefined;
             "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
                 taskId: string;
             } | undefined;
         } | undefined;
@@ -723,10 +732,16 @@ declare class MCPServerRuntime {
         method: string;
         params?: {
             [x: string]: unknown;
+            task?: {
+                [x: string]: unknown;
+                ttl?: number | null | undefined;
+                pollInterval?: number | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
                 progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -737,8 +752,8 @@ declare class MCPServerRuntime {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
-                progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -747,8 +762,8 @@ declare class MCPServerRuntime {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
-            progressToken?: string | number | undefined;
             "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
                 taskId: string;
             } | undefined;
         } | undefined;

package/dist/index.d.ts

@@ -1,5 +1,133 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
+/**
+ * Simple configurable logger for LeanMCP SDK
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    timestamps?: boolean;
+    /**
+     * Enable or disable ANSI colors. Defaults to true.
+     */
+    colorize?: boolean;
+    /**
+     * Provide additional metadata context (e.g. module name)
+     */
+    context?: string;
+    /**
+     * Optional third-party handlers (PostHog, Sentry, etc.)
+     * They receive the structured payload for easy integration.
+     */
+    handlers?: LoggerHandler[];
+}
+interface LogPayload {
+    level: LogLevel;
+    levelLabel: string;
+    message: string;
+    args: any[];
+    prefix?: string;
+    context?: string;
+    timestamp: string;
+}
+type LoggerHandler = (payload: LogPayload) => void;
+declare class Logger {
+    private level;
+    private prefix;
+    private timestamps;
+    private colorize;
+    private context?;
+    private handlers;
+    constructor(options?: LoggerOptions);
+    private format;
+    private shouldLog;
+    private emit;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+declare const defaultLogger: Logger;
+
+interface HTTPServerOptions {
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    logging?: boolean;
+    logger?: Logger;
+    sessionTimeout?: number;
+    stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) */
+    auth?: HTTPServerAuthOptions;
+}
+/**
+ * OAuth/Auth configuration for MCP server
+ *
+ * Enables MCP authorization spec compliance by exposing
+ * `/.well-known/oauth-protected-resource` (RFC 9728)
+ */
+interface HTTPServerAuthOptions {
+    /** Resource identifier (defaults to server URL) */
+    resource?: string;
+    /** Authorization servers (defaults to self) */
+    authorizationServers?: string[];
+    /** Supported OAuth scopes */
+    scopesSupported?: string[];
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Enable built-in OAuth authorization server */
+    enableOAuthServer?: boolean;
+    /** OAuth server options (when enableOAuthServer is true) */
+    oauthServerOptions?: {
+        /** Session secret for signing tokens/state */
+        sessionSecret: string;
+        /** JWT signing secret (defaults to sessionSecret if not provided) */
+        jwtSigningSecret?: string;
+        /** JWT encryption secret for encrypting upstream tokens */
+        jwtEncryptionSecret?: Buffer;
+        /** Issuer URL for JWTs */
+        issuer?: string;
+        /** Access token TTL in seconds (default: 3600) */
+        tokenTTL?: number;
+        /** Enable Dynamic Client Registration (DCR) */
+        enableDCR?: boolean;
+        /** Upstream OAuth provider configuration */
+        upstreamProvider?: {
+            id: string;
+            authorizationEndpoint: string;
+            tokenEndpoint: string;
+            clientId: string;
+            clientSecret: string;
+            scopes?: string[];
+            userInfoEndpoint?: string;
+        };
+    };
+}
+interface MCPServerFactory {
+    (): Server | Promise<Server>;
+}
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
+/**
+ * Create an HTTP server for MCP with Streamable HTTP transport
+ * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
+ */
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
+
 /**
  * Security scheme for MCP tools (per MCP authorization spec)
  *
@@ -220,132 +348,6 @@ declare function SchemaConstraint(constraints: {
  */
 declare function classToJsonSchemaWithConstraints(classConstructor: new () => any): any;
 
-/**
- * Simple configurable logger for LeanMCP SDK
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-interface LoggerOptions {
-    level?: LogLevel;
-    prefix?: string;
-    timestamps?: boolean;
-    /**
-     * Enable or disable ANSI colors. Defaults to true.
-     */
-    colorize?: boolean;
-    /**
-     * Provide additional metadata context (e.g. module name)
-     */
-    context?: string;
-    /**
-     * Optional third-party handlers (PostHog, Sentry, etc.)
-     * They receive the structured payload for easy integration.
-     */
-    handlers?: LoggerHandler[];
-}
-interface LogPayload {
-    level: LogLevel;
-    levelLabel: string;
-    message: string;
-    args: any[];
-    prefix?: string;
-    context?: string;
-    timestamp: string;
-}
-type LoggerHandler = (payload: LogPayload) => void;
-declare class Logger {
-    private level;
-    private prefix;
-    private timestamps;
-    private colorize;
-    private context?;
-    private handlers;
-    constructor(options?: LoggerOptions);
-    private format;
-    private shouldLog;
-    private emit;
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-}
-declare const defaultLogger: Logger;
-
-interface HTTPServerOptions {
-    port?: number;
-    cors?: boolean | {
-        origin?: string | string[];
-        credentials?: boolean;
-    };
-    logging?: boolean;
-    logger?: Logger;
-    sessionTimeout?: number;
-    stateless?: boolean;
-    dashboard?: boolean;
-    /** OAuth/Auth configuration (MCP authorization spec) */
-    auth?: HTTPServerAuthOptions;
-}
-/**
- * OAuth/Auth configuration for MCP server
- *
- * Enables MCP authorization spec compliance by exposing
- * `/.well-known/oauth-protected-resource` (RFC 9728)
- */
-interface HTTPServerAuthOptions {
-    /** Resource identifier (defaults to server URL) */
-    resource?: string;
-    /** Authorization servers (defaults to self) */
-    authorizationServers?: string[];
-    /** Supported OAuth scopes */
-    scopesSupported?: string[];
-    /** Documentation URL */
-    documentationUrl?: string;
-    /** Enable built-in OAuth authorization server */
-    enableOAuthServer?: boolean;
-    /** OAuth server options (when enableOAuthServer is true) */
-    oauthServerOptions?: {
-        /** Session secret for signing tokens/state */
-        sessionSecret: string;
-        /** JWT signing secret (defaults to sessionSecret if not provided) */
-        jwtSigningSecret?: string;
-        /** JWT encryption secret for encrypting upstream tokens */
-        jwtEncryptionSecret?: Buffer;
-        /** Issuer URL for JWTs */
-        issuer?: string;
-        /** Access token TTL in seconds (default: 3600) */
-        tokenTTL?: number;
-        /** Upstream OAuth provider configuration */
-        upstreamProvider?: {
-            id: string;
-            authorizationEndpoint: string;
-            tokenEndpoint: string;
-            clientId: string;
-            clientSecret: string;
-            scopes?: string[];
-            userInfoEndpoint?: string;
-        };
-    };
-}
-interface MCPServerFactory {
-    (): Server | Promise<Server>;
-}
-type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
-/**
- * Create an HTTP server for MCP with Streamable HTTP transport
- * Returns the HTTP server instance to keep the process alive
- *
- * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
- * @param options - HTTP server options (only used when serverInput is a factory function)
- */
-declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
-
 /**
  * Input validation utilities for LeanMCP
  * Provides secure validation for common input types
@@ -549,6 +551,7 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
     name: string;
@@ -668,10 +671,16 @@ declare class MCPServer {
         method: string;
         params?: {
             [x: string]: unknown;
+            task?: {
+                [x: string]: unknown;
+                ttl?: number | null | undefined;
+                pollInterval?: number | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
                 progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -682,8 +691,8 @@ declare class MCPServer {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
-                progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -692,8 +701,8 @@ declare class MCPServer {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
-            progressToken?: string | number | undefined;
             "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
                 taskId: string;
             } | undefined;
         } | undefined;
@@ -723,10 +732,16 @@ declare class MCPServerRuntime {
         method: string;
         params?: {
             [x: string]: unknown;
+            task?: {
+                [x: string]: unknown;
+                ttl?: number | null | undefined;
+                pollInterval?: number | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
                 progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -737,8 +752,8 @@ declare class MCPServerRuntime {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
-                progressToken?: string | number | undefined;
                 "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
                     taskId: string;
                 } | undefined;
             } | undefined;
@@ -747,8 +762,8 @@ declare class MCPServerRuntime {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
-            progressToken?: string | number | undefined;
             "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
                 taskId: string;
             } | undefined;
         } | undefined;