@elizaos/server 1.0.15 → 1.0.17

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;
@@ -246,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

@@ -379,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";
@@ -392,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";
@@ -3695,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";
@@ -3804,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.16",
+  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;
 }
 
@@ -4466,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
@@ -4503,11 +4612,6 @@ function createApiRouter(agents, serverInstance) {
       limit: process.env.EXPRESS_MAX_PAYLOAD || "100kb"
     })
   );
-  router.use(
-    express29.json({
-      limit: process.env.EXPRESS_MAX_PAYLOAD || "100kb"
-    })
-  );
   router.use("/agents", agentsRouter(agents, serverInstance));
   router.use("/messaging", messagingRouter(agents, serverInstance));
   router.use("/memory", memoryRouter(agents, serverInstance));
@@ -5437,6 +5541,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;
@@ -5444,6 +5556,8 @@ var AgentServer = class {
   socketIO;
   isInitialized = false;
   // Flag to prevent double initialization
+  isWebUIEnabled = true;
+  // Default to enabled until initialized
   database;
   startAgent;
   stopAgent;
@@ -5585,7 +5699,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) {
@@ -5669,8 +5783,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;
@@ -5684,6 +5798,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 });
@@ -5808,8 +5933,10 @@ var AgentServer = class {
           }
         }
       };
-      const clientPath = path9.resolve(__dirname2, "../../cli/dist");
-      this.app.use(express30.static(clientPath, staticOptions));
+      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);
       const apiRouter = createApiRouter(this.agents, this);
@@ -5846,14 +5973,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}`);
-        }
-        const cliDistPath = path9.resolve(__dirname2, "../../cli/dist");
-        res.sendFile(path9.join(cliDistPath, "index.html"));
-      });
+      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");
@@ -5980,11 +6113,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(
@@ -6190,6 +6333,7 @@ export {
   AgentServer,
   expandTildePath,
   hasValidRemoteUrls,
+  isWebUIEnabled,
   jsonToCharacter,
   loadCharacter,
   loadCharacterTryPath,