@leanmcp/core 0.3.7 → 0.3.9

package/dist/index.d.mts

@@ -411,6 +411,7 @@ declare class MCPServer {
     private options;
     private initPromise;
     private autoDiscovered;
+    private manifestWatcher;
     constructor(options: MCPServerConstructorOptions);
     /**
      * Internal initialization - runs automatically in constructor
@@ -462,6 +463,14 @@ declare class MCPServer {
      * Register a service instance with decorated methods
      */
     registerService(instance: any): void;
+    /**
+     * Watch UI manifest for changes and reload resources dynamically
+     */
+    private watchUIManifest;
+    /**
+     * Reload UI manifest and update resource registrations
+     */
+    private reloadUIManifest;
     /**
      * Load UI manifest and auto-register resources for pre-built @UIApp components.
      * The manifest is generated by `leanmcp dev` or `leanmcp start` commands.
@@ -511,6 +520,10 @@ declare class MCPServer {
             } | undefined;
         } | undefined;
     }>;
+    /**
+     * Cleanup resources (call on server shutdown)
+     */
+    cleanup(): Promise<void>;
 }
 declare class MCPServerRuntime {
     private server;

package/dist/index.d.ts

@@ -411,6 +411,7 @@ declare class MCPServer {
     private options;
     private initPromise;
     private autoDiscovered;
+    private manifestWatcher;
     constructor(options: MCPServerConstructorOptions);
     /**
      * Internal initialization - runs automatically in constructor
@@ -462,6 +463,14 @@ declare class MCPServer {
      * Register a service instance with decorated methods
      */
     registerService(instance: any): void;
+    /**
+     * Watch UI manifest for changes and reload resources dynamically
+     */
+    private watchUIManifest;
+    /**
+     * Reload UI manifest and update resource registrations
+     */
+    private reloadUIManifest;
     /**
      * Load UI manifest and auto-register resources for pre-built @UIApp components.
      * The manifest is generated by `leanmcp dev` or `leanmcp start` commands.
@@ -511,6 +520,10 @@ declare class MCPServer {
             } | undefined;
         } | undefined;
     }>;
+    /**
+     * Cleanup resources (call on server shutdown)
+     */
+    cleanup(): Promise<void>;
 }
 declare class MCPServerRuntime {
     private server;

package/dist/index.js

@@ -812,8 +812,29 @@ async function createHTTPServer(serverInput, options) {
       }
     }
   }, "handleMCPRequestStateless");
-  if (isDashboardEnabled) {
-    app.get("/mcp", async (req, res) => {
+  app.get("/mcp", async (req, res) => {
+    const acceptHeader = req.headers["accept"] || "";
+    if (acceptHeader.includes("text/event-stream")) {
+      if (!isStateless) {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports[sessionId]) {
+          const transport = transports[sessionId];
+          logger.info(`GET /mcp SSE request (session: ${sessionId.substring(0, 8)}...)`);
+          await transport.handleRequest(req, res);
+          return;
+        }
+      }
+      res.status(405).json({
+        jsonrpc: "2.0",
+        error: {
+          code: -32e3,
+          message: "SSE streaming not supported in stateless mode or invalid session"
+        },
+        id: null
+      });
+      return;
+    }
+    if (isDashboardEnabled) {
       try {
         const html = await fetchDashboard();
         res.setHeader("Content-Type", "text/html");
@@ -821,8 +842,12 @@ async function createHTTPServer(serverInput, options) {
       } catch (error) {
         res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
       }
-    });
-  }
+    } else {
+      res.status(404).json({
+        error: "Dashboard disabled"
+      });
+    }
+  });
   if (isStateless) {
     app.post("/mcp", handleMCPRequestStateless);
     app.delete("/mcp", (_req, res) => {
@@ -965,6 +990,7 @@ var init_index = __esm({
       options;
       initPromise;
       autoDiscovered = false;
+      manifestWatcher = null;
       constructor(options) {
         this.options = options;
         this.logging = options.logging || false;
@@ -998,6 +1024,7 @@ var init_index = __esm({
           await this.autoDiscoverServices(options.mcpDir, options.serviceFactories);
         }
         await this.loadUIManifest();
+        this.watchUIManifest();
       }
       /**
       * Wait for initialization to complete
@@ -1395,6 +1422,113 @@ var init_index = __esm({
         }
       }
       /**
+      * Watch UI manifest for changes and reload resources dynamically
+      */
+      watchUIManifest() {
+        try {
+          const manifestPath = import_path.default.join(process.cwd(), "dist", "ui-manifest.json");
+          if (!import_fs.default.existsSync(manifestPath)) {
+            return;
+          }
+          if (this.logging) {
+            this.logger.debug(`Watching UI manifest: ${manifestPath}`);
+          }
+          import("chokidar").then(({ default: chokidar }) => {
+            this.manifestWatcher = chokidar.watch(manifestPath, {
+              ignoreInitial: true,
+              persistent: true,
+              awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50
+              }
+            });
+            this.manifestWatcher.on("change", async () => {
+              if (this.logging) {
+                this.logger.debug("UI manifest changed, reloading resources");
+              }
+              await this.reloadUIManifest();
+            });
+            this.manifestWatcher.on("error", (error) => {
+              if (this.logging) {
+                this.logger.warn(`Manifest watcher error: ${error.message}`);
+              }
+            });
+          }).catch((error) => {
+            if (this.logging) {
+              this.logger.warn(`Failed to initialize manifest watcher: ${error.message}`);
+            }
+          });
+        } catch (error) {
+          if (this.logging) {
+            this.logger.warn(`Failed to setup manifest watcher: ${error.message}`);
+          }
+        }
+      }
+      /**
+      * Reload UI manifest and update resource registrations
+      */
+      async reloadUIManifest() {
+        try {
+          const manifestPath = import_path.default.join(process.cwd(), "dist", "ui-manifest.json");
+          if (!import_fs.default.existsSync(manifestPath)) {
+            const uiResourceUris = Array.from(this.resources.keys()).filter((uri) => uri.startsWith("ui://"));
+            for (const uri of uiResourceUris) {
+              this.resources.delete(uri);
+              if (this.logging) {
+                this.logger.debug(`Removed UI resource: ${uri}`);
+              }
+            }
+            return;
+          }
+          const manifest = JSON.parse(import_fs.default.readFileSync(manifestPath, "utf-8"));
+          const currentUIUris = new Set(Object.keys(manifest));
+          const registeredUIUris = Array.from(this.resources.keys()).filter((uri) => uri.startsWith("ui://"));
+          for (const uri of registeredUIUris) {
+            if (!currentUIUris.has(uri)) {
+              this.resources.delete(uri);
+              if (this.logging) {
+                this.logger.debug(`Removed UI resource: ${uri}`);
+              }
+            }
+          }
+          for (const [uri, htmlPath] of Object.entries(manifest)) {
+            if (!import_fs.default.existsSync(htmlPath)) {
+              if (this.logging) {
+                this.logger.warn(`UI HTML file not found: ${htmlPath}`);
+              }
+              continue;
+            }
+            const wasRegistered = this.resources.has(uri);
+            this.resources.set(uri, {
+              uri,
+              name: uri.replace("ui://", "").replace(/\//g, "-"),
+              description: `Auto-generated UI resource from pre-built HTML`,
+              mimeType: "text/html;profile=mcp-app",
+              inputSchema: void 0,
+              method: /* @__PURE__ */ __name(async () => {
+                if (import_fs.default.existsSync(htmlPath)) {
+                  const html = import_fs.default.readFileSync(htmlPath, "utf-8");
+                  return {
+                    text: html
+                  };
+                }
+                throw new Error(`UI HTML file not found: ${htmlPath}`);
+              }, "method"),
+              instance: null,
+              propertyKey: "getUI"
+            });
+            if (this.logging) {
+              const action = wasRegistered ? "Updated" : "Registered";
+              this.logger.debug(`${action} UI resource: ${uri}`);
+            }
+          }
+        } catch (error) {
+          if (this.logging) {
+            this.logger.warn(`Failed to reload UI manifest: ${error.message}`);
+          }
+        }
+      }
+      /**
       * Load UI manifest and auto-register resources for pre-built @UIApp components.
       * The manifest is generated by `leanmcp dev` or `leanmcp start` commands.
       */
@@ -1449,6 +1583,15 @@ var init_index = __esm({
         this.server.waitForInit = () => this.waitForInit();
         return this.server;
       }
+      /**
+      * Cleanup resources (call on server shutdown)
+      */
+      async cleanup() {
+        if (this.manifestWatcher) {
+          await this.manifestWatcher.close();
+          this.manifestWatcher = null;
+        }
+      }
     };
     MCPServerRuntime = class {
       static {

package/dist/index.mjs

@@ -774,8 +774,29 @@ async function createHTTPServer(serverInput, options) {
       }
     }
   }, "handleMCPRequestStateless");
-  if (isDashboardEnabled) {
-    app.get("/mcp", async (req, res) => {
+  app.get("/mcp", async (req, res) => {
+    const acceptHeader = req.headers["accept"] || "";
+    if (acceptHeader.includes("text/event-stream")) {
+      if (!isStateless) {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports[sessionId]) {
+          const transport = transports[sessionId];
+          logger.info(`GET /mcp SSE request (session: ${sessionId.substring(0, 8)}...)`);
+          await transport.handleRequest(req, res);
+          return;
+        }
+      }
+      res.status(405).json({
+        jsonrpc: "2.0",
+        error: {
+          code: -32e3,
+          message: "SSE streaming not supported in stateless mode or invalid session"
+        },
+        id: null
+      });
+      return;
+    }
+    if (isDashboardEnabled) {
       try {
         const html = await fetchDashboard();
         res.setHeader("Content-Type", "text/html");
@@ -783,8 +804,12 @@ async function createHTTPServer(serverInput, options) {
       } catch (error) {
         res.status(500).send("<h1>Dashboard temporarily unavailable</h1><p>Please try again later.</p>");
       }
-    });
-  }
+    } else {
+      res.status(404).json({
+        error: "Dashboard disabled"
+      });
+    }
+  });
   if (isStateless) {
     app.post("/mcp", handleMCPRequestStateless);
     app.delete("/mcp", (_req, res) => {
@@ -862,6 +887,7 @@ var MCPServer = class {
   options;
   initPromise;
   autoDiscovered = false;
+  manifestWatcher = null;
   constructor(options) {
     this.options = options;
     this.logging = options.logging || false;
@@ -895,6 +921,7 @@ var MCPServer = class {
       await this.autoDiscoverServices(options.mcpDir, options.serviceFactories);
     }
     await this.loadUIManifest();
+    this.watchUIManifest();
   }
   /**
   * Wait for initialization to complete
@@ -1292,6 +1319,113 @@ var MCPServer = class {
     }
   }
   /**
+  * Watch UI manifest for changes and reload resources dynamically
+  */
+  watchUIManifest() {
+    try {
+      const manifestPath = path.join(process.cwd(), "dist", "ui-manifest.json");
+      if (!fs.existsSync(manifestPath)) {
+        return;
+      }
+      if (this.logging) {
+        this.logger.debug(`Watching UI manifest: ${manifestPath}`);
+      }
+      import("chokidar").then(({ default: chokidar }) => {
+        this.manifestWatcher = chokidar.watch(manifestPath, {
+          ignoreInitial: true,
+          persistent: true,
+          awaitWriteFinish: {
+            stabilityThreshold: 100,
+            pollInterval: 50
+          }
+        });
+        this.manifestWatcher.on("change", async () => {
+          if (this.logging) {
+            this.logger.debug("UI manifest changed, reloading resources");
+          }
+          await this.reloadUIManifest();
+        });
+        this.manifestWatcher.on("error", (error) => {
+          if (this.logging) {
+            this.logger.warn(`Manifest watcher error: ${error.message}`);
+          }
+        });
+      }).catch((error) => {
+        if (this.logging) {
+          this.logger.warn(`Failed to initialize manifest watcher: ${error.message}`);
+        }
+      });
+    } catch (error) {
+      if (this.logging) {
+        this.logger.warn(`Failed to setup manifest watcher: ${error.message}`);
+      }
+    }
+  }
+  /**
+  * Reload UI manifest and update resource registrations
+  */
+  async reloadUIManifest() {
+    try {
+      const manifestPath = path.join(process.cwd(), "dist", "ui-manifest.json");
+      if (!fs.existsSync(manifestPath)) {
+        const uiResourceUris = Array.from(this.resources.keys()).filter((uri) => uri.startsWith("ui://"));
+        for (const uri of uiResourceUris) {
+          this.resources.delete(uri);
+          if (this.logging) {
+            this.logger.debug(`Removed UI resource: ${uri}`);
+          }
+        }
+        return;
+      }
+      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+      const currentUIUris = new Set(Object.keys(manifest));
+      const registeredUIUris = Array.from(this.resources.keys()).filter((uri) => uri.startsWith("ui://"));
+      for (const uri of registeredUIUris) {
+        if (!currentUIUris.has(uri)) {
+          this.resources.delete(uri);
+          if (this.logging) {
+            this.logger.debug(`Removed UI resource: ${uri}`);
+          }
+        }
+      }
+      for (const [uri, htmlPath] of Object.entries(manifest)) {
+        if (!fs.existsSync(htmlPath)) {
+          if (this.logging) {
+            this.logger.warn(`UI HTML file not found: ${htmlPath}`);
+          }
+          continue;
+        }
+        const wasRegistered = this.resources.has(uri);
+        this.resources.set(uri, {
+          uri,
+          name: uri.replace("ui://", "").replace(/\//g, "-"),
+          description: `Auto-generated UI resource from pre-built HTML`,
+          mimeType: "text/html;profile=mcp-app",
+          inputSchema: void 0,
+          method: /* @__PURE__ */ __name(async () => {
+            if (fs.existsSync(htmlPath)) {
+              const html = fs.readFileSync(htmlPath, "utf-8");
+              return {
+                text: html
+              };
+            }
+            throw new Error(`UI HTML file not found: ${htmlPath}`);
+          }, "method"),
+          instance: null,
+          propertyKey: "getUI"
+        });
+        if (this.logging) {
+          const action = wasRegistered ? "Updated" : "Registered";
+          this.logger.debug(`${action} UI resource: ${uri}`);
+        }
+      }
+    } catch (error) {
+      if (this.logging) {
+        this.logger.warn(`Failed to reload UI manifest: ${error.message}`);
+      }
+    }
+  }
+  /**
   * Load UI manifest and auto-register resources for pre-built @UIApp components.
   * The manifest is generated by `leanmcp dev` or `leanmcp start` commands.
   */
@@ -1346,6 +1480,15 @@ var MCPServer = class {
     this.server.waitForInit = () => this.waitForInit();
     return this.server;
   }
+  /**
+  * Cleanup resources (call on server shutdown)
+  */
+  async cleanup() {
+    if (this.manifestWatcher) {
+      await this.manifestWatcher.close();
+      this.manifestWatcher = null;
+    }
+  }
 };
 var MCPServerRuntime = class {
   static {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/core",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Core library implementing decorators, reflection, and MCP runtime server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -26,6 +26,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "ajv": "^8.12.0",
+    "chokidar": "^4.0.0",
     "dotenv": "^16.3.1",
     "reflect-metadata": "^0.2.1"
   },