@elizaos/server 1.0.14 → 1.0.16

package/dist/index.d.ts

@@ -128,6 +128,12 @@ interface ServerOptions {
     dataDir?: string;
     postgresUrl?: string;
 }
+/**
+ * Determines if the web UI should be enabled based on environment variables.
+ *
+ * @returns {boolean} - Returns true if UI should be enabled, false otherwise
+ */
+declare function isWebUIEnabled(): boolean;
 /**
  * Class representing an agent server.
  */ /**
@@ -139,6 +145,7 @@ declare class AgentServer {
     server: http.Server;
     socketIO: Server;
     isInitialized: boolean;
+    private isWebUIEnabled;
     database: DatabaseAdapter;
     startAgent: (character: Character) => Promise<IAgentRuntime>;
     stopAgent: (runtime: IAgentRuntime) => void;
@@ -150,14 +157,6 @@ declare class AgentServer {
      * @constructor
      */
     constructor();
-    /**
-     * Dynamically resolves the client path based on the installation context.
-     * Handles both development and production scenarios.
-     *
-     * @returns {string} The resolved path to the client dist directory
-     * @throws {Error} If no valid client path can be found
-     */
-    private resolveClientPath;
     /**
      * Initializes the database and server.
      *
@@ -254,4 +253,4 @@ declare class AgentServer {
     getServersForAgent(agentId: UUID): Promise<UUID[]>;
 }
 
-export { AgentServer, type CentralRootMessage, type MessageChannel, type MessageServer, type MessageServiceStructure, type ServerMiddleware, type ServerOptions, expandTildePath, hasValidRemoteUrls, jsonToCharacter, loadCharacter, loadCharacterTryPath, loadCharacters, loadCharactersFromUrl, resolvePgliteDir, tryLoadFile };
+export { AgentServer, type CentralRootMessage, type MessageChannel, type MessageServer, type MessageServiceStructure, type ServerMiddleware, type ServerOptions, expandTildePath, hasValidRemoteUrls, isWebUIEnabled, jsonToCharacter, loadCharacter, loadCharacterTryPath, loadCharacters, loadCharactersFromUrl, resolvePgliteDir, tryLoadFile };

package/dist/index.js

@@ -4,13 +4,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
+var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __copyProps = (to, from, except, desc) => {
@@ -385,9 +379,10 @@ var require_lib = __commonJS({
 // src/index.ts
 var import_cors2 = __toESM(require_lib(), 1);
 import {
-  logger as logger29
+  logger as logger29,
+  parseBooleanFromText
 } from "@elizaos/core";
-import express30 from "express";
+import express31 from "express";
 import helmet2 from "helmet";
 import * as fs9 from "fs";
 import http from "http";
@@ -398,7 +393,7 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 var import_cors = __toESM(require_lib(), 1);
 import { logger as logger25, validateUuid as validateUuid21 } from "@elizaos/core";
 import bodyParser from "body-parser";
-import express29 from "express";
+import express30 from "express";
 import helmet from "helmet";
 import { match } from "path-to-regexp";
 import { Server as SocketIOServer } from "socket.io";
@@ -3701,7 +3696,7 @@ function teeRouter() {
 }
 
 // src/api/system/index.ts
-import express28 from "express";
+import express29 from "express";
 
 // src/api/system/environment.ts
 import { logger as logger23 } from "@elizaos/core";
@@ -3810,10 +3805,118 @@ function createEnvironmentRouter() {
   return router;
 }
 
+// src/api/system/version.ts
+import express28 from "express";
+
+// package.json
+var package_default = {
+  name: "@elizaos/server",
+  version: "1.0.15",
+  description: "ElizaOS Server - Core server infrastructure for ElizaOS agents",
+  publishConfig: {
+    access: "public",
+    workspaces: {
+      preserveIfPresent: true
+    }
+  },
+  license: "MIT",
+  author: {
+    name: "elizaOS",
+    url: "https://twitter.com/eliza_OS"
+  },
+  repository: {
+    type: "git",
+    url: "https://github.com/elizaOS/eliza.git",
+    directory: "packages/server"
+  },
+  files: [
+    "dist",
+    "templates"
+  ],
+  keywords: [],
+  type: "module",
+  exports: {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  scripts: {
+    build: "tsup",
+    "type-check": "tsc --project tsconfig.build.json --noEmit",
+    lint: "prettier --write ./src",
+    format: "prettier --write ./src",
+    "format:check": "prettier --check ./src",
+    clean: "rm -rf dist .turbo node_modules .turbo-tsconfig.json tsconfig.tsbuildinfo",
+    test: "bun test src/**/*.test.ts",
+    "test:unit": "bun test src/**/*.test.ts --exclude **/integration/**",
+    "test:integration": "bun test src/__tests__/integration/**/*.test.ts",
+    "test:coverage": "bun test --coverage",
+    "test:watch": "bun test --watch",
+    "test:cli": "bun test tests/commands/"
+  },
+  devDependencies: {
+    "@types/node": "^24.0.1",
+    dotenv: "^16.5.0",
+    prettier: "3.5.3",
+    tsup: "8.5.0",
+    tsx: "4.19.4",
+    typescript: "^5.5.4",
+    which: "^4.0.0",
+    ws: "^8.18.0"
+  },
+  gitHead: "d5bd5c43bfebeb7ac02f9e029f924cb6cd5c2ec7",
+  dependencies: {
+    "@elizaos/core": "workspace:*",
+    "@elizaos/plugin-sql": "workspace:*",
+    "@types/express": "^5.0.2",
+    "@types/helmet": "^4.0.0",
+    "@types/multer": "^1.4.13",
+    express: "^5.1.0",
+    "express-rate-limit": "^7.5.0",
+    helmet: "^8.1.0",
+    multer: "^2.0.1",
+    "path-to-regexp": "^8.2.0",
+    "socket.io": "^4.8.1"
+  }
+};
+
+// src/api/system/version.ts
+function getVersionInfo() {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  try {
+    return {
+      version: package_default.version,
+      source: "server",
+      timestamp,
+      environment: process.env.NODE_ENV || "development",
+      uptime: process.uptime()
+    };
+  } catch (error) {
+    console.error("Error getting version info:", error);
+    return {
+      version: "unknown",
+      source: "server",
+      timestamp,
+      environment: process.env.NODE_ENV || "development",
+      uptime: process.uptime(),
+      error: "Failed to retrieve version information"
+    };
+  }
+}
+function createVersionRouter() {
+  const router = express28.Router();
+  router.get("/", (_, res) => {
+    const versionInfo = getVersionInfo();
+    const statusCode = versionInfo.error ? 500 : 200;
+    res.status(statusCode).json(versionInfo);
+  });
+  return router;
+}
+
 // src/api/system/index.ts
 function systemRouter() {
-  const router = express28.Router();
+  const router = express29.Router();
   router.use("/env", createEnvironmentRouter());
+  router.use("/version", createVersionRouter());
   return router;
 }
 
@@ -4472,7 +4575,7 @@ function createPluginRouteHandler(agents) {
   };
 }
 function createApiRouter(agents, serverInstance) {
-  const router = express29.Router();
+  const router = express30.Router();
   router.use(
     helmet({
       // Disable CSP here - let main app handle it with environment awareness
@@ -4510,7 +4613,7 @@ function createApiRouter(agents, serverInstance) {
     })
   );
   router.use(
-    express29.json({
+    express30.json({
       limit: process.env.EXPRESS_MAX_PAYLOAD || "100kb"
     })
   );
@@ -5443,6 +5546,14 @@ function resolvePgliteDir(dir, fallbackDir) {
 }
 var __dirname2 = dirname(fileURLToPath2(import.meta.url));
 var DEFAULT_SERVER_ID5 = "00000000-0000-0000-0000-000000000000";
+function isWebUIEnabled() {
+  const isProduction = process.env.NODE_ENV === "production";
+  const uiEnabledEnv = process.env.ELIZA_UI_ENABLE;
+  if (uiEnabledEnv !== void 0 && uiEnabledEnv.trim() !== "") {
+    return parseBooleanFromText(uiEnabledEnv);
+  }
+  return !isProduction;
+}
 var AgentServer = class {
   app;
   agents;
@@ -5450,6 +5561,8 @@ var AgentServer = class {
   socketIO;
   isInitialized = false;
   // Flag to prevent double initialization
+  isWebUIEnabled = true;
+  // Default to enabled until initialized
   database;
   startAgent;
   stopAgent;
@@ -5471,46 +5584,6 @@ var AgentServer = class {
       throw error;
     }
   }
-  /**
-   * Dynamically resolves the client path based on the installation context.
-   * Handles both development and production scenarios.
-   *
-   * @returns {string} The resolved path to the client dist directory
-   * @throws {Error} If no valid client path can be found
-   */
-  resolveClientPath() {
-    try {
-      const cliPackageJson = __require.resolve("@elizaos/cli/package.json");
-      const cliDir = path9.dirname(cliPackageJson);
-      const cliDistPath = path9.join(cliDir, "dist");
-      if (fs9.existsSync(path9.join(cliDistPath, "index.html"))) {
-        logger29.debug(`[CLIENT PATH] Resolved client path from npm package: ${cliDistPath}`);
-        return cliDistPath;
-      }
-    } catch (e) {
-      logger29.debug("[CLIENT PATH] Could not resolve @elizaos/cli package, trying other methods");
-    }
-    const relativePath = path9.resolve(__dirname2, "../../cli/dist");
-    if (fs9.existsSync(path9.join(relativePath, "index.html"))) {
-      logger29.debug(`[CLIENT PATH] Resolved client path from relative path: ${relativePath}`);
-      return relativePath;
-    }
-    const cwdPath = path9.join(process.cwd(), "dist");
-    if (fs9.existsSync(path9.join(cwdPath, "index.html"))) {
-      logger29.debug(`[CLIENT PATH] Resolved client path from current directory: ${cwdPath}`);
-      return cwdPath;
-    }
-    if (process.env.ELIZA_CLIENT_PATH) {
-      const envPath = path9.resolve(process.env.ELIZA_CLIENT_PATH);
-      if (fs9.existsSync(path9.join(envPath, "index.html"))) {
-        logger29.debug(`[CLIENT PATH] Resolved client path from environment variable: ${envPath}`);
-        return envPath;
-      }
-    }
-    throw new Error(
-      "Unable to locate client files. Please ensure @elizaos/cli is properly installed."
-    );
-  }
   /**
    * Initializes the database and server.
    *
@@ -5631,7 +5704,7 @@ var AgentServer = class {
    */
   async initializeServer(options) {
     try {
-      this.app = express30();
+      this.app = express31();
       const isProd = process.env.NODE_ENV === "production";
       logger29.debug("Setting up security headers...");
       if (!isProd) {
@@ -5715,8 +5788,8 @@ var AgentServer = class {
         })
       );
       this.app.use(
-        express30.json({
-          limit: process.env.EXPRESS_MAX_PAYLOAD || "100kb"
+        express31.json({
+          limit: process.env.EXPRESS_MAX_PAYLOAD || "2mb"
         })
       );
       const serverAuthToken = process.env.ELIZA_SERVER_AUTH_TOKEN;
@@ -5730,6 +5803,17 @@ var AgentServer = class {
           "Server authentication is disabled. Set ELIZA_SERVER_AUTH_TOKEN environment variable to enable."
         );
       }
+      this.isWebUIEnabled = isWebUIEnabled();
+      if (this.isWebUIEnabled) {
+        logger29.info("Web UI enabled");
+      } else {
+        const uiEnabledEnv = process.env.ELIZA_UI_ENABLE;
+        if (uiEnabledEnv !== void 0 && uiEnabledEnv.trim() !== "") {
+          logger29.info(`Web UI disabled by environment variable (ELIZA_UI_ENABLE=${uiEnabledEnv})`);
+        } else {
+          logger29.info("Web UI disabled for security (production mode)");
+        }
+      }
       const uploadsBasePath = path9.join(process.cwd(), ".eliza", "data", "uploads", "agents");
       const generatedBasePath = path9.join(process.cwd(), ".eliza", "data", "generated");
       fs9.mkdirSync(uploadsBasePath, { recursive: true });
@@ -5854,13 +5938,9 @@ var AgentServer = class {
           }
         }
       };
-      try {
-        const clientPath = this.resolveClientPath();
-        this.app.use(express30.static(clientPath, staticOptions));
-        logger29.info(`[STATIC] Serving client files from: ${clientPath}`);
-      } catch (error) {
-        logger29.error("[STATIC] Failed to resolve client path:", error);
-        logger29.warn("[STATIC] Client UI will not be available. API endpoints will still work.");
+      if (this.isWebUIEnabled) {
+        const clientPath = path9.resolve(__dirname2, "../../cli/dist");
+        this.app.use(express31.static(clientPath, staticOptions));
       }
       const pluginRouteHandler = createPluginRouteHandler(this.agents);
       this.app.use(pluginRouteHandler);
@@ -5898,36 +5978,20 @@ var AgentServer = class {
           next();
         }
       });
-      this.app.use((req, res) => {
-        if (req.path.endsWith(".js") || req.path.includes(".js?") || req.path.match(/\/[a-zA-Z0-9_-]+-[A-Za-z0-9]{8}\.js/)) {
-          res.setHeader("Content-Type", "application/javascript");
-          return res.status(404).send(`// JavaScript module not found: ${req.path}`);
-        }
-        try {
-          const cliDistPath = this.resolveClientPath();
-          res.sendFile(path9.join(cliDistPath, "index.html"), (err) => {
-            if (err && !res.headersSent) {
-              logger29.error("[STATIC] Failed to serve index.html:", err);
-              res.status(404).json({
-                success: false,
-                error: {
-                  message: "Client UI not available. Please ensure @elizaos/cli is properly installed.",
-                  code: 404
-                }
-              });
-            }
-          });
-        } catch (error) {
-          logger29.error("[STATIC] Failed to resolve client path for fallback route:", error);
-          res.status(404).json({
-            success: false,
-            error: {
-              message: "Client UI not available. API endpoints are still accessible at /api/*",
-              code: 404
-            }
-          });
-        }
-      });
+      if (this.isWebUIEnabled) {
+        this.app.use((req, res) => {
+          if (req.path.endsWith(".js") || req.path.includes(".js?") || req.path.match(/\/[a-zA-Z0-9_-]+-[A-Za-z0-9]{8}\.js/)) {
+            res.setHeader("Content-Type", "application/javascript");
+            return res.status(404).send(`// JavaScript module not found: ${req.path}`);
+          }
+          const cliDistPath = path9.resolve(__dirname2, "../../cli/dist");
+          res.sendFile(path9.join(cliDistPath, "index.html"));
+        });
+      } else {
+        this.app.use((_req, res) => {
+          res.sendStatus(403);
+        });
+      }
       this.server = http.createServer(this.app);
       this.socketIO = setupSocketIO(this.server, this.agents, this);
       logger29.success("AgentServer HTTP server and Socket.IO initialized");
@@ -6054,11 +6118,21 @@ var AgentServer = class {
       logger29.debug(`Environment: ${process.env.NODE_ENV}`);
       const host = process.env.SERVER_HOST || "0.0.0.0";
       this.server.listen(port, host, () => {
-        if (process.env.NODE_ENV !== "development") {
+        if (this.isWebUIEnabled && process.env.NODE_ENV !== "development") {
           console.log(
             `\x1B[32mStartup successful!
 Go to the dashboard at \x1B[1mhttp://localhost:${port}\x1B[22m\x1B[0m`
           );
+        } else if (!this.isWebUIEnabled) {
+          const actualHost = host === "0.0.0.0" ? "localhost" : host;
+          const baseUrl = `http://${actualHost}:${port}`;
+          console.log(
+            `\x1B[32mStartup successful!\x1B[0m
+\x1B[33mWeb UI disabled.\x1B[0m \x1B[32mAPI endpoints available at:\x1B[0m
+  \x1B[1m${baseUrl}/api/server/ping\x1B[22m\x1B[0m
+  \x1B[1m${baseUrl}/api/agents\x1B[22m\x1B[0m
+  \x1B[1m${baseUrl}/api/messaging\x1B[22m\x1B[0m`
+          );
         }
         console.log(`AgentServer is listening on port ${port}`);
         logger29.success(
@@ -6264,6 +6338,7 @@ export {
   AgentServer,
   expandTildePath,
   hasValidRemoteUrls,
+  isWebUIEnabled,
   jsonToCharacter,
   loadCharacter,
   loadCharacterTryPath,