@leanmcp/core 0.3.5 → 0.3.7

package/dist/index.d.mts

@@ -252,6 +252,7 @@ interface HTTPServerOptions {
     logger?: Logger;
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
 }
 interface MCPServerFactory {
     (): Server | Promise<Server>;
@@ -474,9 +475,18 @@ 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;
         } | undefined;
     }, {
@@ -485,12 +495,20 @@ declare class MCPServer {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
+                "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
     }>;
 }
@@ -509,9 +527,18 @@ 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;
         } | undefined;
     }, {
@@ -520,12 +547,20 @@ declare class MCPServerRuntime {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
+                "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
     }>;
     getTools(): RegisteredTool[];

package/dist/index.d.ts

@@ -252,6 +252,7 @@ interface HTTPServerOptions {
     logger?: Logger;
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
 }
 interface MCPServerFactory {
     (): Server | Promise<Server>;
@@ -474,9 +475,18 @@ 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;
         } | undefined;
     }, {
@@ -485,12 +495,20 @@ declare class MCPServer {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
+                "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
     }>;
 }
@@ -509,9 +527,18 @@ 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;
         } | undefined;
     }, {
@@ -520,12 +547,20 @@ declare class MCPServerRuntime {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
+                "io.modelcontextprotocol/related-task"?: {
+                    [x: string]: unknown;
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
         } | undefined;
     }>;
     getTools(): RegisteredTool[];

package/dist/index.js

@@ -483,17 +483,66 @@ var init_validation = __esm({
 function isInitializeRequest(body) {
   return body && body.method === "initialize";
 }
+function getCallerFile() {
+  const originalPrepareStackTrace = Error.prepareStackTrace;
+  try {
+    const err = new Error();
+    Error.prepareStackTrace = (_, stack2) => stack2;
+    const stack = err.stack;
+    for (let i = 0; i < stack.length; i++) {
+      let fileName = stack[i].getFileName();
+      if (!fileName) continue;
+      if (fileName.startsWith("file://")) {
+        try {
+          const url = new URL(fileName);
+          fileName = decodeURIComponent(url.pathname);
+          if (process.platform === "win32" && fileName.startsWith("/")) {
+            fileName = fileName.substring(1);
+          }
+        } catch (e) {
+          fileName = fileName.replace("file://", "");
+          if (process.platform === "win32" && fileName.startsWith("/")) {
+            fileName = fileName.substring(1);
+          }
+        }
+      }
+      const normalizedPath = fileName.replace(/\\/g, "/");
+      const isLeanMCPCore = normalizedPath.includes("@leanmcp/core") || normalizedPath.includes("leanmcp-sdk/packages/core");
+      const isValidExtension = fileName.endsWith(".ts") || fileName.endsWith(".js") || fileName.endsWith(".mjs");
+      if (!isLeanMCPCore && isValidExtension) {
+        return fileName;
+      }
+    }
+    return null;
+  } finally {
+    Error.prepareStackTrace = originalPrepareStackTrace;
+  }
+}
 async function createHTTPServer(serverInput, options) {
   let serverFactory;
   let httpOptions;
+  let resolvedMcpDir;
   if (typeof serverInput === "function") {
     serverFactory = serverInput;
     httpOptions = options || {};
   } else {
     const serverOptions = serverInput;
     const { MCPServer: MCPServer2 } = await Promise.resolve().then(() => (init_index(), index_exports));
+    if (!serverOptions.mcpDir) {
+      const callerFile = getCallerFile();
+      if (callerFile) {
+        const path2 = await import("path");
+        const callerDir = path2.dirname(callerFile);
+        resolvedMcpDir = path2.join(callerDir, "mcp");
+      }
+    } else {
+      resolvedMcpDir = serverOptions.mcpDir;
+    }
     serverFactory = /* @__PURE__ */ __name(async () => {
-      const mcpServer2 = new MCPServer2(serverOptions);
+      const mcpServer2 = new MCPServer2({
+        ...serverOptions,
+        mcpDir: resolvedMcpDir || serverOptions.mcpDir
+      });
       return mcpServer2.getServer();
     }, "serverFactory");
     httpOptions = {
@@ -501,7 +550,8 @@ async function createHTTPServer(serverInput, options) {
       cors: serverOptions.cors,
       logging: serverOptions.logging,
       sessionTimeout: serverOptions.sessionTimeout,
-      stateless: serverOptions.stateless
+      stateless: serverOptions.stateless,
+      dashboard: serverOptions.dashboard
     };
   }
   const [express, { StreamableHTTPServerTransport }, cors] = await Promise.all([
@@ -521,6 +571,7 @@ async function createHTTPServer(serverInput, options) {
   validatePort(basePort);
   const transports = {};
   let mcpServer = null;
+  let statelessServerFactory = null;
   const logger = httpOptions.logger || new Logger({
     level: httpOptions.logging ? LogLevel.INFO : LogLevel.NONE,
     prefix: "HTTP"
@@ -618,6 +669,42 @@ async function createHTTPServer(serverInput, options) {
   app.use(express.json());
   const isStateless = httpOptions.stateless !== false;
   console.log(`Starting LeanMCP HTTP Server (${isStateless ? "STATELESS" : "STATEFUL"})...`);
+  const DASHBOARD_URL = process.env.DASHBOARD_URL || "https://s3-dashboard-build.s3.us-west-2.amazonaws.com/out/index.html";
+  let cachedDashboard = null;
+  let cacheTimestamp = 0;
+  const CACHE_DURATION = 5 * 60 * 1e3;
+  async function fetchDashboard() {
+    const now = Date.now();
+    if (cachedDashboard && now - cacheTimestamp < CACHE_DURATION) {
+      return cachedDashboard;
+    }
+    try {
+      const response = await fetch(DASHBOARD_URL);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch dashboard: ${response.status}`);
+      }
+      const html = await response.text();
+      cachedDashboard = html;
+      cacheTimestamp = now;
+      return html;
+    } catch (error) {
+      logger.error("Error fetching dashboard from S3:", error);
+      throw error;
+    }
+  }
+  __name(fetchDashboard, "fetchDashboard");
+  const isDashboardEnabled = httpOptions.dashboard !== false;
+  if (isDashboardEnabled) {
+    app.get("/", async (req, res) => {
+      try {
+        const html = await fetchDashboard();
+        res.setHeader("Content-Type", "text/html");
+        res.send(html);
+      } catch (error) {
+        res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
+      }
+    });
+  }
   app.get("/health", (req, res) => {
     res.json({
       status: "ok",
@@ -698,7 +785,7 @@ async function createHTTPServer(serverInput, options) {
     else if (params?.uri) logMessage += ` [${params.uri}]`;
     logger.info(logMessage);
     try {
-      const freshServer = await serverFactory();
+      const freshServer = await statelessServerFactory();
       if (freshServer && typeof freshServer.waitForInit === "function") {
         await freshServer.waitForInit();
       }
@@ -725,18 +812,19 @@ async function createHTTPServer(serverInput, options) {
       }
     }
   }, "handleMCPRequestStateless");
+  if (isDashboardEnabled) {
+    app.get("/mcp", async (req, res) => {
+      try {
+        const html = await fetchDashboard();
+        res.setHeader("Content-Type", "text/html");
+        res.send(html);
+      } catch (error) {
+        res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
+      }
+    });
+  }
   if (isStateless) {
     app.post("/mcp", handleMCPRequestStateless);
-    app.get("/mcp", (_req, res) => {
-      res.status(405).json({
-        jsonrpc: "2.0",
-        error: {
-          code: -32e3,
-          message: "Method not allowed (stateless mode)"
-        },
-        id: null
-      });
-    });
     app.delete("/mcp", (_req, res) => {
       res.status(405).json({
         jsonrpc: "2.0",
@@ -758,6 +846,9 @@ async function createHTTPServer(serverInput, options) {
       if (mcpServer && typeof mcpServer.waitForInit === "function") {
         await mcpServer.waitForInit();
       }
+      if (isStateless) {
+        statelessServerFactory = serverFactory;
+      }
       const { listener, port } = await startServerWithPortRetry();
       activeListener = listener;
       process.env.PORT = String(port);
@@ -800,6 +891,7 @@ var init_http_server = __esm({
     init_logger();
     init_validation();
     __name(isInitializeRequest, "isInitializeRequest");
+    __name(getCallerFile, "getCallerFile");
     __name(createHTTPServer, "createHTTPServer");
   }
 });

package/dist/index.mjs

@@ -444,17 +444,67 @@ function isInitializeRequest(body) {
   return body && body.method === "initialize";
 }
 __name(isInitializeRequest, "isInitializeRequest");
+function getCallerFile() {
+  const originalPrepareStackTrace = Error.prepareStackTrace;
+  try {
+    const err = new Error();
+    Error.prepareStackTrace = (_, stack2) => stack2;
+    const stack = err.stack;
+    for (let i = 0; i < stack.length; i++) {
+      let fileName = stack[i].getFileName();
+      if (!fileName) continue;
+      if (fileName.startsWith("file://")) {
+        try {
+          const url = new URL(fileName);
+          fileName = decodeURIComponent(url.pathname);
+          if (process.platform === "win32" && fileName.startsWith("/")) {
+            fileName = fileName.substring(1);
+          }
+        } catch (e) {
+          fileName = fileName.replace("file://", "");
+          if (process.platform === "win32" && fileName.startsWith("/")) {
+            fileName = fileName.substring(1);
+          }
+        }
+      }
+      const normalizedPath = fileName.replace(/\\/g, "/");
+      const isLeanMCPCore = normalizedPath.includes("@leanmcp/core") || normalizedPath.includes("leanmcp-sdk/packages/core");
+      const isValidExtension = fileName.endsWith(".ts") || fileName.endsWith(".js") || fileName.endsWith(".mjs");
+      if (!isLeanMCPCore && isValidExtension) {
+        return fileName;
+      }
+    }
+    return null;
+  } finally {
+    Error.prepareStackTrace = originalPrepareStackTrace;
+  }
+}
+__name(getCallerFile, "getCallerFile");
 async function createHTTPServer(serverInput, options) {
   let serverFactory;
   let httpOptions;
+  let resolvedMcpDir;
   if (typeof serverInput === "function") {
     serverFactory = serverInput;
     httpOptions = options || {};
   } else {
     const serverOptions = serverInput;
     const { MCPServer: MCPServer2 } = await import("./index.mjs");
+    if (!serverOptions.mcpDir) {
+      const callerFile = getCallerFile();
+      if (callerFile) {
+        const path2 = await import("path");
+        const callerDir = path2.dirname(callerFile);
+        resolvedMcpDir = path2.join(callerDir, "mcp");
+      }
+    } else {
+      resolvedMcpDir = serverOptions.mcpDir;
+    }
     serverFactory = /* @__PURE__ */ __name(async () => {
-      const mcpServer2 = new MCPServer2(serverOptions);
+      const mcpServer2 = new MCPServer2({
+        ...serverOptions,
+        mcpDir: resolvedMcpDir || serverOptions.mcpDir
+      });
       return mcpServer2.getServer();
     }, "serverFactory");
     httpOptions = {
@@ -462,7 +512,8 @@ async function createHTTPServer(serverInput, options) {
       cors: serverOptions.cors,
       logging: serverOptions.logging,
       sessionTimeout: serverOptions.sessionTimeout,
-      stateless: serverOptions.stateless
+      stateless: serverOptions.stateless,
+      dashboard: serverOptions.dashboard
     };
   }
   const [express, { StreamableHTTPServerTransport }, cors] = await Promise.all([
@@ -482,6 +533,7 @@ async function createHTTPServer(serverInput, options) {
   validatePort(basePort);
   const transports = {};
   let mcpServer = null;
+  let statelessServerFactory = null;
   const logger = httpOptions.logger || new Logger({
     level: httpOptions.logging ? LogLevel.INFO : LogLevel.NONE,
     prefix: "HTTP"
@@ -579,6 +631,42 @@ async function createHTTPServer(serverInput, options) {
   app.use(express.json());
   const isStateless = httpOptions.stateless !== false;
   console.log(`Starting LeanMCP HTTP Server (${isStateless ? "STATELESS" : "STATEFUL"})...`);
+  const DASHBOARD_URL = process.env.DASHBOARD_URL || "https://s3-dashboard-build.s3.us-west-2.amazonaws.com/out/index.html";
+  let cachedDashboard = null;
+  let cacheTimestamp = 0;
+  const CACHE_DURATION = 5 * 60 * 1e3;
+  async function fetchDashboard() {
+    const now = Date.now();
+    if (cachedDashboard && now - cacheTimestamp < CACHE_DURATION) {
+      return cachedDashboard;
+    }
+    try {
+      const response = await fetch(DASHBOARD_URL);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch dashboard: ${response.status}`);
+      }
+      const html = await response.text();
+      cachedDashboard = html;
+      cacheTimestamp = now;
+      return html;
+    } catch (error) {
+      logger.error("Error fetching dashboard from S3:", error);
+      throw error;
+    }
+  }
+  __name(fetchDashboard, "fetchDashboard");
+  const isDashboardEnabled = httpOptions.dashboard !== false;
+  if (isDashboardEnabled) {
+    app.get("/", async (req, res) => {
+      try {
+        const html = await fetchDashboard();
+        res.setHeader("Content-Type", "text/html");
+        res.send(html);
+      } catch (error) {
+        res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
+      }
+    });
+  }
   app.get("/health", (req, res) => {
     res.json({
       status: "ok",
@@ -659,7 +747,7 @@ async function createHTTPServer(serverInput, options) {
     else if (params?.uri) logMessage += ` [${params.uri}]`;
     logger.info(logMessage);
     try {
-      const freshServer = await serverFactory();
+      const freshServer = await statelessServerFactory();
       if (freshServer && typeof freshServer.waitForInit === "function") {
         await freshServer.waitForInit();
       }
@@ -686,18 +774,19 @@ async function createHTTPServer(serverInput, options) {
       }
     }
   }, "handleMCPRequestStateless");
+  if (isDashboardEnabled) {
+    app.get("/mcp", async (req, res) => {
+      try {
+        const html = await fetchDashboard();
+        res.setHeader("Content-Type", "text/html");
+        res.send(html);
+      } catch (error) {
+        res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
+      }
+    });
+  }
   if (isStateless) {
     app.post("/mcp", handleMCPRequestStateless);
-    app.get("/mcp", (_req, res) => {
-      res.status(405).json({
-        jsonrpc: "2.0",
-        error: {
-          code: -32e3,
-          message: "Method not allowed (stateless mode)"
-        },
-        id: null
-      });
-    });
     app.delete("/mcp", (_req, res) => {
       res.status(405).json({
         jsonrpc: "2.0",
@@ -719,6 +808,9 @@ async function createHTTPServer(serverInput, options) {
       if (mcpServer && typeof mcpServer.waitForInit === "function") {
         await mcpServer.waitForInit();
       }
+      if (isStateless) {
+        statelessServerFactory = serverFactory;
+      }
       const { listener, port } = await startServerWithPortRetry();
       activeListener = listener;
       process.env.PORT = String(port);

package/package.json

@@ -1,71 +1,71 @@
-{
-  "name": "@leanmcp/core",
-  "version": "0.3.5",
-  "description": "Core library implementing decorators, reflection, and MCP runtime server",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "jest --passWithNoTests",
-    "test:watch": "jest --watch"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "ajv": "^8.12.0",
-    "dotenv": "^16.3.1",
-    "reflect-metadata": "^0.2.1"
-  },
-  "peerDependencies": {
-    "cors": "^2.8.5",
-    "express": "^5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "express": {
-      "optional": true
-    },
-    "cors": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.0",
-    "@types/express": "^5.0.0",
-    "@types/node": "^20.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
-    "directory": "packages/core"
-  },
-  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
-  "bugs": {
-    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "typescript",
-    "decorators",
-    "server",
-    "runtime"
-  ],
-  "author": "LeanMCP <admin@leanmcp.com>",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@leanmcp/core",
+  "version": "0.3.7",
+  "description": "Core library implementing decorators, reflection, and MCP runtime server",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.12.0",
+    "dotenv": "^16.3.1",
+    "reflect-metadata": "^0.2.1"
+  },
+  "peerDependencies": {
+    "cors": "^2.8.5",
+    "express": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "cors": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typescript",
+    "decorators",
+    "server",
+    "runtime"
+  ],
+  "author": "LeanMCP <admin@leanmcp.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}