@leanmcp/core 0.3.8 → 0.3.10

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

@@ -889,20 +889,36 @@ async function createHTTPServer(serverInput, options) {
         logger.error(`Server error: ${error.message}`);
         reject(error);
       });
-      const cleanup = /* @__PURE__ */ __name(() => {
+      let isShuttingDown = false;
+      const cleanup = /* @__PURE__ */ __name(async () => {
+        if (isShuttingDown) return;
+        isShuttingDown = true;
         logger.info("\nShutting down server...");
-        Object.values(transports).forEach((t) => t.close?.());
-        activeListener?.close(() => {
-          logger.info("Server closed");
-          process.exit(0);
-        });
-        setTimeout(() => {
-          logger.warn("Forcing shutdown...");
-          process.exit(1);
-        }, 5e3);
+        for (const transport of Object.values(transports)) {
+          try {
+            transport.close?.();
+          } catch (e) {
+          }
+        }
+        if (activeListener) {
+          await new Promise((resolveClose) => {
+            activeListener.close((err) => {
+              if (err) {
+                logger.warn(`Error closing server: ${err.message}`);
+              } else {
+                logger.info("Server closed");
+              }
+              resolveClose();
+            });
+          });
+        }
       }, "cleanup");
-      process.on("SIGINT", cleanup);
-      process.on("SIGTERM", cleanup);
+      const handleShutdown = /* @__PURE__ */ __name(() => {
+        cleanup().finally(() => {
+        });
+      }, "handleShutdown");
+      process.once("SIGINT", handleShutdown);
+      process.once("SIGTERM", handleShutdown);
     } catch (error) {
       reject(error);
     }
@@ -990,6 +1006,7 @@ var init_index = __esm({
       options;
       initPromise;
       autoDiscovered = false;
+      manifestWatcher = null;
       constructor(options) {
         this.options = options;
         this.logging = options.logging || false;
@@ -1023,6 +1040,7 @@ var init_index = __esm({
           await this.autoDiscoverServices(options.mcpDir, options.serviceFactories);
         }
         await this.loadUIManifest();
+        this.watchUIManifest();
       }
       /**
       * Wait for initialization to complete
@@ -1420,6 +1438,125 @@ 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, entry] of Object.entries(manifest)) {
+            const isString = typeof entry === "string";
+            const htmlPath = isString ? entry : entry.htmlPath;
+            const isGPTApp = !isString && entry.isGPTApp;
+            const gptMeta = !isString ? entry.gptMeta : void 0;
+            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);
+            const mimeType = isGPTApp ? "text/html+skybridge" : "text/html;profile=mcp-app";
+            const _meta = {};
+            if (isGPTApp) {
+              _meta["openai/outputTemplate"] = uri;
+              if (gptMeta) Object.assign(_meta, gptMeta);
+              if (_meta["openai/widgetPrefersBorder"] === void 0) _meta["openai/widgetPrefersBorder"] = true;
+            }
+            this.resources.set(uri, {
+              uri,
+              name: uri.replace("ui://", "").replace(/\//g, "-"),
+              description: `Auto-generated UI resource from pre-built HTML`,
+              mimeType,
+              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,
+                    _meta: Object.keys(_meta).length > 0 ? _meta : void 0
+                  };
+                }
+                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.
       */
@@ -1430,7 +1567,11 @@ var init_index = __esm({
             return;
           }
           const manifest = JSON.parse(import_fs.default.readFileSync(manifestPath, "utf-8"));
-          for (const [uri, htmlPath] of Object.entries(manifest)) {
+          for (const [uri, entry] of Object.entries(manifest)) {
+            const isString = typeof entry === "string";
+            const htmlPath = isString ? entry : entry.htmlPath;
+            const isGPTApp = !isString && entry.isGPTApp;
+            const gptMeta = !isString ? entry.gptMeta : void 0;
             if (this.resources.has(uri)) {
               if (this.logging) {
                 this.logger.debug(`Skipping UI resource ${uri} - already registered`);
@@ -1444,14 +1585,22 @@ var init_index = __esm({
               continue;
             }
             const html = import_fs.default.readFileSync(htmlPath, "utf-8");
+            const mimeType = isGPTApp ? "text/html+skybridge" : "text/html;profile=mcp-app";
+            const _meta = {};
+            if (isGPTApp) {
+              _meta["openai/outputTemplate"] = uri;
+              if (gptMeta) Object.assign(_meta, gptMeta);
+              if (_meta["openai/widgetPrefersBorder"] === void 0) _meta["openai/widgetPrefersBorder"] = true;
+            }
             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",
+              mimeType,
               inputSchema: void 0,
               method: /* @__PURE__ */ __name(async () => ({
-                text: html
+                text: html,
+                _meta: Object.keys(_meta).length > 0 ? _meta : void 0
               }), "method"),
               instance: null,
               propertyKey: "getUI"
@@ -1474,6 +1623,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

@@ -851,20 +851,36 @@ async function createHTTPServer(serverInput, options) {
         logger.error(`Server error: ${error.message}`);
         reject(error);
       });
-      const cleanup = /* @__PURE__ */ __name(() => {
+      let isShuttingDown = false;
+      const cleanup = /* @__PURE__ */ __name(async () => {
+        if (isShuttingDown) return;
+        isShuttingDown = true;
         logger.info("\nShutting down server...");
-        Object.values(transports).forEach((t) => t.close?.());
-        activeListener?.close(() => {
-          logger.info("Server closed");
-          process.exit(0);
-        });
-        setTimeout(() => {
-          logger.warn("Forcing shutdown...");
-          process.exit(1);
-        }, 5e3);
+        for (const transport of Object.values(transports)) {
+          try {
+            transport.close?.();
+          } catch (e) {
+          }
+        }
+        if (activeListener) {
+          await new Promise((resolveClose) => {
+            activeListener.close((err) => {
+              if (err) {
+                logger.warn(`Error closing server: ${err.message}`);
+              } else {
+                logger.info("Server closed");
+              }
+              resolveClose();
+            });
+          });
+        }
       }, "cleanup");
-      process.on("SIGINT", cleanup);
-      process.on("SIGTERM", cleanup);
+      const handleShutdown = /* @__PURE__ */ __name(() => {
+        cleanup().finally(() => {
+        });
+      }, "handleShutdown");
+      process.once("SIGINT", handleShutdown);
+      process.once("SIGTERM", handleShutdown);
     } catch (error) {
       reject(error);
     }
@@ -887,6 +903,7 @@ var MCPServer = class {
   options;
   initPromise;
   autoDiscovered = false;
+  manifestWatcher = null;
   constructor(options) {
     this.options = options;
     this.logging = options.logging || false;
@@ -920,6 +937,7 @@ var MCPServer = class {
       await this.autoDiscoverServices(options.mcpDir, options.serviceFactories);
     }
     await this.loadUIManifest();
+    this.watchUIManifest();
   }
   /**
   * Wait for initialization to complete
@@ -1317,6 +1335,125 @@ 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, entry] of Object.entries(manifest)) {
+        const isString = typeof entry === "string";
+        const htmlPath = isString ? entry : entry.htmlPath;
+        const isGPTApp = !isString && entry.isGPTApp;
+        const gptMeta = !isString ? entry.gptMeta : void 0;
+        if (!fs.existsSync(htmlPath)) {
+          if (this.logging) {
+            this.logger.warn(`UI HTML file not found: ${htmlPath}`);
+          }
+          continue;
+        }
+        const wasRegistered = this.resources.has(uri);
+        const mimeType = isGPTApp ? "text/html+skybridge" : "text/html;profile=mcp-app";
+        const _meta = {};
+        if (isGPTApp) {
+          _meta["openai/outputTemplate"] = uri;
+          if (gptMeta) Object.assign(_meta, gptMeta);
+          if (_meta["openai/widgetPrefersBorder"] === void 0) _meta["openai/widgetPrefersBorder"] = true;
+        }
+        this.resources.set(uri, {
+          uri,
+          name: uri.replace("ui://", "").replace(/\//g, "-"),
+          description: `Auto-generated UI resource from pre-built HTML`,
+          mimeType,
+          inputSchema: void 0,
+          method: /* @__PURE__ */ __name(async () => {
+            if (fs.existsSync(htmlPath)) {
+              const html = fs.readFileSync(htmlPath, "utf-8");
+              return {
+                text: html,
+                _meta: Object.keys(_meta).length > 0 ? _meta : void 0
+              };
+            }
+            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.
   */
@@ -1327,7 +1464,11 @@ var MCPServer = class {
         return;
       }
       const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
-      for (const [uri, htmlPath] of Object.entries(manifest)) {
+      for (const [uri, entry] of Object.entries(manifest)) {
+        const isString = typeof entry === "string";
+        const htmlPath = isString ? entry : entry.htmlPath;
+        const isGPTApp = !isString && entry.isGPTApp;
+        const gptMeta = !isString ? entry.gptMeta : void 0;
         if (this.resources.has(uri)) {
           if (this.logging) {
             this.logger.debug(`Skipping UI resource ${uri} - already registered`);
@@ -1341,14 +1482,22 @@ var MCPServer = class {
           continue;
         }
         const html = fs.readFileSync(htmlPath, "utf-8");
+        const mimeType = isGPTApp ? "text/html+skybridge" : "text/html;profile=mcp-app";
+        const _meta = {};
+        if (isGPTApp) {
+          _meta["openai/outputTemplate"] = uri;
+          if (gptMeta) Object.assign(_meta, gptMeta);
+          if (_meta["openai/widgetPrefersBorder"] === void 0) _meta["openai/widgetPrefersBorder"] = true;
+        }
         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",
+          mimeType,
           inputSchema: void 0,
           method: /* @__PURE__ */ __name(async () => ({
-            text: html
+            text: html,
+            _meta: Object.keys(_meta).length > 0 ? _meta : void 0
           }), "method"),
           instance: null,
           propertyKey: "getUI"
@@ -1371,6 +1520,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.8",
+  "version": "0.3.10",
   "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"
   },