@leanmcp/core 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -434,9 +434,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;
     }, {
@@ -445,12 +454,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;
     }>;
 }
@@ -469,9 +486,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;
     }, {
@@ -480,12 +506,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

@@ -434,9 +434,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;
     }, {
@@ -445,12 +454,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;
     }>;
 }
@@ -469,9 +486,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;
     }, {
@@ -480,12 +506,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

@@ -464,14 +464,55 @@ async function createHTTPServer(serverInput, options) {
     httpOptions.cors ? import("cors").catch(() => null) : Promise.resolve(null)
   ]);
   const app = express.default();
-  const port = httpOptions.port || 3001;
-  validatePort(port);
+  const basePort = httpOptions.port || 3001;
+  validatePort(basePort);
   const transports = {};
   let mcpServer = null;
   const logger = httpOptions.logger || new Logger({
     level: httpOptions.logging ? LogLevel.INFO : LogLevel.NONE,
     prefix: "HTTP"
   });
+  const logPrimary = /* @__PURE__ */ __name((message) => {
+    console.log(message);
+    logger.info?.(message);
+  }, "logPrimary");
+  const warnPrimary = /* @__PURE__ */ __name((message) => {
+    console.warn(message);
+    logger.warn?.(message);
+  }, "warnPrimary");
+  const startServerWithPortRetry = /* @__PURE__ */ __name(async () => {
+    const maxAttempts = 20;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      const portToTry = basePort + attempt;
+      const listener = await new Promise((resolve, reject) => {
+        const server = app.listen(portToTry);
+        const onListening = /* @__PURE__ */ __name(() => {
+          server.off("error", onError);
+          resolve(server);
+        }, "onListening");
+        const onError = /* @__PURE__ */ __name((error) => {
+          server.off("listening", onListening);
+          server.close();
+          reject(error);
+        }, "onError");
+        server.once("listening", onListening);
+        server.once("error", onError);
+      }).catch((error) => {
+        if (error?.code === "EADDRINUSE" && attempt < maxAttempts - 1) {
+          warnPrimary(`Port ${portToTry} in use, trying ${portToTry + 1}...`);
+          return null;
+        }
+        throw error;
+      });
+      if (listener) {
+        return {
+          listener,
+          port: portToTry
+        };
+      }
+    }
+    throw new Error(`No available port found in range ${basePort}-${basePort + maxAttempts - 1}`);
+  }, "startServerWithPortRetry");
   if (cors && httpOptions.cors) {
     const corsOptions = typeof httpOptions.cors === "object" ? {
       origin: httpOptions.cors.origin || false,
@@ -498,7 +539,7 @@ async function createHTTPServer(serverInput, options) {
     }
   }
   app.use(express.json());
-  logger.info("Starting LeanMCP HTTP Server...");
+  logPrimary("Starting LeanMCP HTTP Server...");
   app.get("/health", (req, res) => {
     res.json({
       status: "ok",
@@ -573,16 +614,22 @@ async function createHTTPServer(serverInput, options) {
   app.post("/mcp", handleMCPRequest);
   app.delete("/mcp", handleMCPRequest);
   return new Promise(async (resolve, reject) => {
+    let activeListener;
     try {
       mcpServer = await serverFactory();
       if (mcpServer && typeof mcpServer.waitForInit === "function") {
         await mcpServer.waitForInit();
       }
-      const listener = app.listen(port, () => {
-        logger.info(`Server running on http://localhost:${port}`);
-        logger.info(`MCP endpoint: http://localhost:${port}/mcp`);
-        logger.info(`Health check: http://localhost:${port}/health`);
-        resolve(listener);
+      const { listener, port } = await startServerWithPortRetry();
+      activeListener = listener;
+      process.env.PORT = String(port);
+      listener.port = port;
+      logPrimary(`Server running on http://localhost:${port}`);
+      logPrimary(`MCP endpoint: http://localhost:${port}/mcp`);
+      logPrimary(`Health check: http://localhost:${port}/health`);
+      resolve({
+        listener,
+        port
       });
       listener.on("error", (error) => {
         logger.error(`Server error: ${error.message}`);
@@ -591,7 +638,7 @@ async function createHTTPServer(serverInput, options) {
       const cleanup = /* @__PURE__ */ __name(() => {
         logger.info("\nShutting down server...");
         Object.values(transports).forEach((t) => t.close?.());
-        listener.close(() => {
+        activeListener?.close(() => {
           logger.info("Server closed");
           process.exit(0);
         });
@@ -769,24 +816,29 @@ var init_index = __esm({
           const stack = err.stack;
           for (let i = 0; i < stack.length; i++) {
             let fileName = stack[i].getFileName();
-            if (fileName && !fileName.includes("@leanmcp") && !fileName.includes("leanmcp-sdk\\packages\\core") && !fileName.includes("leanmcp-sdk/packages/core") && (fileName.endsWith(".ts") || fileName.endsWith(".js") || fileName.endsWith(".mjs"))) {
-              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);
-                  }
+            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;
             }
           }
+          this.logger.debug("No suitable caller file found in stack trace");
           return null;
         } finally {
           Error.prepareStackTrace = originalPrepareStackTrace;

package/dist/index.mjs

@@ -425,14 +425,55 @@ async function createHTTPServer(serverInput, options) {
     httpOptions.cors ? import("cors").catch(() => null) : Promise.resolve(null)
   ]);
   const app = express.default();
-  const port = httpOptions.port || 3001;
-  validatePort(port);
+  const basePort = httpOptions.port || 3001;
+  validatePort(basePort);
   const transports = {};
   let mcpServer = null;
   const logger = httpOptions.logger || new Logger({
     level: httpOptions.logging ? LogLevel.INFO : LogLevel.NONE,
     prefix: "HTTP"
   });
+  const logPrimary = /* @__PURE__ */ __name((message) => {
+    console.log(message);
+    logger.info?.(message);
+  }, "logPrimary");
+  const warnPrimary = /* @__PURE__ */ __name((message) => {
+    console.warn(message);
+    logger.warn?.(message);
+  }, "warnPrimary");
+  const startServerWithPortRetry = /* @__PURE__ */ __name(async () => {
+    const maxAttempts = 20;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      const portToTry = basePort + attempt;
+      const listener = await new Promise((resolve, reject) => {
+        const server = app.listen(portToTry);
+        const onListening = /* @__PURE__ */ __name(() => {
+          server.off("error", onError);
+          resolve(server);
+        }, "onListening");
+        const onError = /* @__PURE__ */ __name((error) => {
+          server.off("listening", onListening);
+          server.close();
+          reject(error);
+        }, "onError");
+        server.once("listening", onListening);
+        server.once("error", onError);
+      }).catch((error) => {
+        if (error?.code === "EADDRINUSE" && attempt < maxAttempts - 1) {
+          warnPrimary(`Port ${portToTry} in use, trying ${portToTry + 1}...`);
+          return null;
+        }
+        throw error;
+      });
+      if (listener) {
+        return {
+          listener,
+          port: portToTry
+        };
+      }
+    }
+    throw new Error(`No available port found in range ${basePort}-${basePort + maxAttempts - 1}`);
+  }, "startServerWithPortRetry");
   if (cors && httpOptions.cors) {
     const corsOptions = typeof httpOptions.cors === "object" ? {
       origin: httpOptions.cors.origin || false,
@@ -459,7 +500,7 @@ async function createHTTPServer(serverInput, options) {
     }
   }
   app.use(express.json());
-  logger.info("Starting LeanMCP HTTP Server...");
+  logPrimary("Starting LeanMCP HTTP Server...");
   app.get("/health", (req, res) => {
     res.json({
       status: "ok",
@@ -534,16 +575,22 @@ async function createHTTPServer(serverInput, options) {
   app.post("/mcp", handleMCPRequest);
   app.delete("/mcp", handleMCPRequest);
   return new Promise(async (resolve, reject) => {
+    let activeListener;
     try {
       mcpServer = await serverFactory();
       if (mcpServer && typeof mcpServer.waitForInit === "function") {
         await mcpServer.waitForInit();
       }
-      const listener = app.listen(port, () => {
-        logger.info(`Server running on http://localhost:${port}`);
-        logger.info(`MCP endpoint: http://localhost:${port}/mcp`);
-        logger.info(`Health check: http://localhost:${port}/health`);
-        resolve(listener);
+      const { listener, port } = await startServerWithPortRetry();
+      activeListener = listener;
+      process.env.PORT = String(port);
+      listener.port = port;
+      logPrimary(`Server running on http://localhost:${port}`);
+      logPrimary(`MCP endpoint: http://localhost:${port}/mcp`);
+      logPrimary(`Health check: http://localhost:${port}/health`);
+      resolve({
+        listener,
+        port
       });
       listener.on("error", (error) => {
         logger.error(`Server error: ${error.message}`);
@@ -552,7 +599,7 @@ async function createHTTPServer(serverInput, options) {
       const cleanup = /* @__PURE__ */ __name(() => {
         logger.info("\nShutting down server...");
         Object.values(transports).forEach((t) => t.close?.());
-        listener.close(() => {
+        activeListener?.close(() => {
           logger.info("Server closed");
           process.exit(0);
         });
@@ -666,24 +713,29 @@ var MCPServer = class {
       const stack = err.stack;
       for (let i = 0; i < stack.length; i++) {
         let fileName = stack[i].getFileName();
-        if (fileName && !fileName.includes("@leanmcp") && !fileName.includes("leanmcp-sdk\\packages\\core") && !fileName.includes("leanmcp-sdk/packages/core") && (fileName.endsWith(".ts") || fileName.endsWith(".js") || fileName.endsWith(".mjs"))) {
-          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);
-              }
+        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;
         }
       }
+      this.logger.debug("No suitable caller file found in stack trace");
       return null;
     } finally {
       Error.prepareStackTrace = originalPrepareStackTrace;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/core",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Core library implementing decorators, reflection, and MCP runtime server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",