@leanmcp/core 0.3.16 → 0.3.18-alpha.6.6dae082

package/README.md

@@ -27,6 +27,10 @@
   <a href="https://x.com/LeanMcp">
     <img src="https://img.shields.io/badge/@LeanMCP-f5f5f5?logo=x&logoColor=000000" />
   </a>
+  <a href="https://leanmcp.com/">
+    <img src="https://img.shields.io/badge/Website-leanmcp-0A66C2?" />
+  </a>
+  <a href="https://deepwiki.com/LeanMCP/leanmcp-sdk"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
 ## Features
@@ -46,6 +50,7 @@ npm install @leanmcp/core
 ```
 
 For HTTP server support:
+
 ```bash
 npm install express cors
 ```
@@ -57,20 +62,21 @@ npm install express cors
 The simplest way to create an MCP server with auto-discovery:
 
 ```typescript
-import { createHTTPServer } from "@leanmcp/core";
+import { createHTTPServer } from '@leanmcp/core';
 
 await createHTTPServer({
-  name: "my-mcp-server",
-  version: "1.0.0",
+  name: 'my-mcp-server',
+  version: '1.0.0',
   port: 3001,
   cors: true,
-  logging: true
+  logging: true,
 });
 
 // Services are automatically discovered from ./mcp directory
 ```
 
 **Directory Structure:**
+
 ```
 your-project/
 ├── main.ts
@@ -86,12 +92,12 @@ your-project/
 
 ```typescript
 // mcp/sentiment/index.ts
-import { Tool, SchemaConstraint, Optional } from "@leanmcp/core";
+import { Tool, SchemaConstraint, Optional } from '@leanmcp/core';
 
 class AnalyzeSentimentInput {
   @SchemaConstraint({
     description: 'Text to analyze',
-    minLength: 1
+    minLength: 1,
   })
   text!: string;
 
@@ -99,20 +105,20 @@ class AnalyzeSentimentInput {
   @SchemaConstraint({
     description: 'Language code',
     enum: ['en', 'es', 'fr'],
-    default: 'en'
+    default: 'en',
   })
   language?: string;
 }
 
 export class SentimentService {
-  @Tool({ 
+  @Tool({
     description: 'Analyze sentiment of text',
-    inputClass: AnalyzeSentimentInput
+    inputClass: AnalyzeSentimentInput,
   })
   async analyzeSentiment(input: AnalyzeSentimentInput) {
     return {
       sentiment: 'positive',
-      score: 0.8
+      score: 0.8,
     };
   }
 }
@@ -130,12 +136,12 @@ Marks a method as a callable MCP tool.
 class CalculateInput {
   @SchemaConstraint({ description: 'First number' })
   a!: number;
-  
+
   @SchemaConstraint({ description: 'Second number' })
   b!: number;
 }
 
-@Tool({ 
+@Tool({
   description: 'Calculate sum of two numbers',
   inputClass: CalculateInput
 })
@@ -146,10 +152,10 @@ async calculate(input: CalculateInput) {
 
 **Options:**
 
-| Option | Type | Description |
-|--------|------|-------------|
+| Option        | Type     | Description                 |
+| ------------- | -------- | --------------------------- |
 | `description` | `string` | Tool description for the AI |
-| `inputClass` | `Class` | Class defining input schema |
+| `inputClass`  | `Class`  | Class defining input schema |
 
 ### @Prompt
 
@@ -159,7 +165,7 @@ Marks a method as a reusable prompt template.
 class CodeReviewInput {
   @SchemaConstraint({ description: 'Code to review' })
   code!: string;
-  
+
   @SchemaConstraint({ description: 'Programming language' })
   language!: string;
 }
@@ -183,9 +189,9 @@ codeReview(input: CodeReviewInput) {
 Marks a method as an MCP resource (data source).
 
 ```typescript
-@Resource({ 
-  description: 'Get system configuration', 
-  mimeType: 'application/json' 
+@Resource({
+  description: 'Get system configuration',
+  mimeType: 'application/json'
 })
 async getConfig() {
   return {
@@ -205,14 +211,14 @@ class UserInput {
     description: 'User email',
     format: 'email',
     minLength: 5,
-    maxLength: 100
+    maxLength: 100,
   })
   email!: string;
 
   @SchemaConstraint({
     description: 'User age',
     minimum: 18,
-    maximum: 120
+    maximum: 120,
   })
   age!: number;
 
@@ -220,13 +226,14 @@ class UserInput {
   @SchemaConstraint({
     description: 'User role',
     enum: ['admin', 'user', 'guest'],
-    default: 'user'
+    default: 'user',
   })
   role?: string;
 }
 ```
 
 **Common constraints:**
+
 - `description`, `default` — Documentation
 - `minLength`, `maxLength` — String length
 - `minimum`, `maximum` — Number range
@@ -258,6 +265,7 @@ class SearchInput {
 Create and start an HTTP server with auto-discovery.
 
 **Simplified API (Recommended):**
+
 ```typescript
 await createHTTPServer({
   name: string;              // Server name (required)
@@ -275,21 +283,22 @@ await createHTTPServer({
 ```
 
 **Factory Pattern (Advanced):**
+
 ```typescript
 const serverFactory = async () => {
   const server = new MCPServer({
-    name: "my-server",
-    version: "1.0.0",
-    autoDiscover: false  // Disable for manual registration
+    name: 'my-server',
+    version: '1.0.0',
+    autoDiscover: false, // Disable for manual registration
   });
-  
+
   server.registerService(new MyService());
   return server.getServer();
 };
 
 await createHTTPServer(serverFactory, {
   port: 3001,
-  cors: true
+  cors: true,
 });
 ```
 
@@ -329,12 +338,12 @@ For services needing shared configuration (auth, database, etc.), create a `conf
 
 ```typescript
 // mcp/config.ts
-import { AuthProvider } from "@leanmcp/auth";
+import { AuthProvider } from '@leanmcp/auth';
 
 export const authProvider = new AuthProvider('cognito', {
   region: process.env.AWS_REGION,
   userPoolId: process.env.COGNITO_USER_POOL_ID,
-  clientId: process.env.COGNITO_CLIENT_ID
+  clientId: process.env.COGNITO_CLIENT_ID,
 });
 
 await authProvider.init();
@@ -344,9 +353,9 @@ Then import in your services:
 
 ```typescript
 // mcp/slack/index.ts
-import { Tool } from "@leanmcp/core";
-import { Authenticated } from "@leanmcp/auth";
-import { authProvider } from "../config.js";
+import { Tool } from '@leanmcp/core';
+import { Authenticated } from '@leanmcp/auth';
+import { authProvider } from '../config.js';
 
 @Authenticated(authProvider)
 export class SlackService {
@@ -388,7 +397,7 @@ If your tool returns a manual MCP response (with `content` array), the SDK extra
 
 ```typescript
 return {
-  content: [{ type: 'text', text: JSON.stringify({ channels }) }]
+  content: [{ type: 'text', text: JSON.stringify({ channels }) }],
 };
 // structuredContent will be { channels: [...] }
 ```
@@ -397,11 +406,11 @@ return {
 
 ## HTTP Endpoints
 
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/mcp` | POST | MCP protocol endpoint (JSON-RPC 2.0) |
-| `/health` | GET | Health check |
-| `/` | GET | Welcome message |
+| Endpoint  | Method | Description                          |
+| --------- | ------ | ------------------------------------ |
+| `/mcp`    | POST   | MCP protocol endpoint (JSON-RPC 2.0) |
+| `/health` | GET    | Health check                         |
+| `/`       | GET    | Welcome message                      |
 
 ## Error Handling
 
@@ -418,9 +427,10 @@ async divide(input: DivideInput) {
 ```
 
 Returns:
+
 ```json
 {
-  "content": [{"type": "text", "text": "Error: Division by zero"}],
+  "content": [{ "type": "text", "text": "Error: Division by zero" }],
   "isError": true
 }
 ```
@@ -435,6 +445,7 @@ NODE_ENV=production    # Environment
 ## TypeScript Support
 
 **Key Points:**
+
 - Input schema is defined via `inputClass` in the decorator
 - Output type is inferred from the return type
 - For tools with no input, omit `inputClass`

package/dist/index.d.mts

@@ -101,7 +101,7 @@ interface HTTPServerAuthOptions {
         issuer?: string;
         /** Access token TTL in seconds (default: 3600) */
         tokenTTL?: number;
-        /** Enable Dynamic Client Registration (DCR) */
+        /** Enable Dynamic Client Registration (for ChatGPT etc.) */
         enableDCR?: boolean;
         /** Upstream OAuth provider configuration */
         upstreamProvider?: {
@@ -551,6 +551,8 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) - passed to HTTPServerOptions */
     auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
@@ -671,16 +673,10 @@ 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;
@@ -691,8 +687,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;
@@ -701,8 +697,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;
@@ -732,16 +728,10 @@ 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;
@@ -752,8 +742,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;
@@ -762,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;

package/dist/index.d.ts

@@ -101,7 +101,7 @@ interface HTTPServerAuthOptions {
         issuer?: string;
         /** Access token TTL in seconds (default: 3600) */
         tokenTTL?: number;
-        /** Enable Dynamic Client Registration (DCR) */
+        /** Enable Dynamic Client Registration (for ChatGPT etc.) */
         enableDCR?: boolean;
         /** Upstream OAuth provider configuration */
         upstreamProvider?: {
@@ -551,6 +551,8 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) - passed to HTTPServerOptions */
     auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
@@ -671,16 +673,10 @@ 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;
@@ -691,8 +687,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;
@@ -701,8 +697,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;
@@ -732,16 +728,10 @@ 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;
@@ -752,8 +742,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;
@@ -762,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;

package/dist/index.js

@@ -1454,14 +1454,14 @@ var init_index = __esm({
       /**
       * Auto-register all services from the mcp directory
       * Scans the directory recursively and registers all exported classes
-      * 
+      *
       * @param mcpDir - Path to the mcp directory containing service files
       * @param serviceFactories - Optional map of service class names to factory functions for dependency injection
-      * 
+      *
       * @example
       * // Auto-register services with no dependencies
       * await server.autoRegisterServices('./mcp');
-      * 
+      *
       * @example
       * // Auto-register with dependency injection
       * await server.autoRegisterServices('./mcp', {
@@ -1614,7 +1614,7 @@ var init_index = __esm({
       }
       /**
       * Watch UI manifest for changes and reload resources dynamically
-      * 
+      *
       * CRITICAL: Only for stateful mode. In stateless mode, each request
       * creates a fresh server that reads the manifest directly, making
       * watchers both unnecessary and a memory leak source.

package/dist/index.mjs

@@ -1341,14 +1341,14 @@ var MCPServer = class {
   /**
   * Auto-register all services from the mcp directory
   * Scans the directory recursively and registers all exported classes
-  * 
+  *
   * @param mcpDir - Path to the mcp directory containing service files
   * @param serviceFactories - Optional map of service class names to factory functions for dependency injection
-  * 
+  *
   * @example
   * // Auto-register services with no dependencies
   * await server.autoRegisterServices('./mcp');
-  * 
+  *
   * @example
   * // Auto-register with dependency injection
   * await server.autoRegisterServices('./mcp', {
@@ -1501,7 +1501,7 @@ var MCPServer = class {
   }
   /**
   * Watch UI manifest for changes and reload resources dynamically
-  * 
+  *
   * CRITICAL: Only for stateful mode. In stateless mode, each request
   * creates a fresh server that reads the manifest directly, making
   * watchers both unnecessary and a memory leak source.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/core",
-  "version": "0.3.16",
+  "version": "0.3.18-alpha.6.6dae082",
   "description": "Core library implementing decorators, reflection, and MCP runtime server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -49,8 +49,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.0",
     "@types/express": "^5.0.0",
-    "@types/node": "^20.0.0",
-    "@leanmcp/auth": "^0.4.0"
+    "@types/node": "^20.0.0"
   },
   "repository": {
     "type": "git",