agent-world 0.4.0 → 0.4.5

package/README.md

@@ -107,14 +107,23 @@ Each Agent World has a collection of agents that can communicate through a share
 
 ### Quick Start
 
-**Option 1: CLI Interface**
+**Option 1: Web Interface**
 ```bash
-npx agent-world
+npx agent-world-server
 ```
 
-**Option 2: Web Interface**
+**Option 2: CLI Interface**
+1. Interactive Mode
+```bash
+npx agent-world
+```
+2. Command Mode
+```bash
+npx agent-world -w default-world "hi" 
+```
+3. Pipeline Mode
 ```bash
-npx agent-world --server
+echo "hi" | npx agent-world -w default-world
 ```
 
 ## Project Structure (npm workspaces)

package/dist/cli/index.js

@@ -39,6 +39,7 @@ import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import readline from 'readline';
 import { listWorlds, subscribeWorld, createCategoryLogger, LLMProvider, initializeLogger, enableStreaming, disableStreaming } from '../core/index.js';
+import { getDefaultRootPath } from '../core/storage-factory.js';
 import { processCLIInput } from './commands.js';
 import { createStreamingState, handleWorldEventWithStreaming } from './stream.js';
 import { configureLLMProvider } from '../core/llm-config.js';
@@ -167,8 +168,8 @@ function configureLLMProvidersFromEnv() {
         logger.debug('Configured Ollama provider with default URL');
     }
 }
-const AGENT_WORLD_DATA_PATH = process.env.AGENT_WORLD_DATA_PATH || './data/worlds';
-const DEFAULT_ROOT_PATH = path.join(process.cwd(), AGENT_WORLD_DATA_PATH);
+// Get default root path from storage-factory (no local defaults)
+const DEFAULT_ROOT_PATH = getDefaultRootPath();
 // Pipeline mode execution with timer-based cleanup
 async function runPipelineMode(options, messageFromArgs) {
     const rootPath = options.root || DEFAULT_ROOT_PATH;

package/dist/server/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * Web Server - Express.js HTTP Server with REST API and SSE
+ *
+ * Features:
+ * - Express server with CORS, static files, and modular API routing
+ * - Environment-based LLM provider configuration
+ * - Category-based logging with configurable levels
+ * - Health check endpoint and proper error handling
+ * - Environment Variables: Automatically loads .env file for API keys and configuration
+ *
+ * Configuration: AGENT_WORLD_DATA_PATH, LOG_LEVEL, LLM provider keys
+ * Endpoints: /health + API routes from ./api.ts
+ */
+// Load environment variables from .env file
+import dotenv from 'dotenv';
+dotenv.config();
+import open from 'open';
+import { initializeLogger, createCategoryLogger, LLMProvider } from '../core/index.js';
+import { configureLLMProvider } from '../core/llm-config.js';
+import express from 'express';
+import cors from 'cors';
+import path from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+import apiRouter from './api.js';
+// ES modules setup
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Configuration
+const PORT = Number(process.env.PORT) || 0;
+const HOST = process.env.HOST || '127.0.0.1';
+const logLevel = (process.env.LOG_LEVEL || 'error');
+// Initialize logger (now synchronous)
+initializeLogger({ globalLevel: logLevel });
+const serverLogger = createCategoryLogger('server');
+serverLogger.debug('Server logger initialized', { logLevel });
+// LLM provider configuration
+function configureLLMProvidersFromEnv() {
+    const providers = [
+        { env: 'OPENAI_API_KEY', provider: LLMProvider.OPENAI, config: (key) => ({ apiKey: key }) },
+        { env: 'ANTHROPIC_API_KEY', provider: LLMProvider.ANTHROPIC, config: (key) => ({ apiKey: key }) },
+        { env: 'GOOGLE_API_KEY', provider: LLMProvider.GOOGLE, config: (key) => ({ apiKey: key }) },
+        { env: 'XAI_API_KEY', provider: LLMProvider.XAI, config: (key) => ({ apiKey: key }) }
+    ];
+    providers.forEach(({ env, provider, config }) => {
+        const key = process.env[env];
+        if (key) {
+            configureLLMProvider(provider, config(key));
+            serverLogger.debug(`Configured ${provider} provider from environment`);
+        }
+    });
+    // Azure (requires multiple env vars)
+    if (process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_ENDPOINT && process.env.AZURE_DEPLOYMENT) {
+        configureLLMProvider(LLMProvider.AZURE, {
+            apiKey: process.env.AZURE_OPENAI_API_KEY,
+            endpoint: process.env.AZURE_ENDPOINT,
+            deployment: process.env.AZURE_DEPLOYMENT,
+            apiVersion: process.env.AZURE_API_VERSION || '2023-12-01-preview'
+        });
+        serverLogger.debug('Configured Azure provider from environment');
+    }
+    // OpenAI Compatible
+    if (process.env.OPENAI_COMPATIBLE_API_KEY && process.env.OPENAI_COMPATIBLE_BASE_URL) {
+        configureLLMProvider(LLMProvider.OPENAI_COMPATIBLE, {
+            apiKey: process.env.OPENAI_COMPATIBLE_API_KEY,
+            baseUrl: process.env.OPENAI_COMPATIBLE_BASE_URL
+        });
+        serverLogger.debug('Configured OpenAI-Compatible provider from environment');
+    }
+    // Ollama
+    const ollamaUrl = process.env.OLLAMA_BASE_URL || 'http://localhost:11434/api';
+    configureLLMProvider(LLMProvider.OLLAMA, { baseUrl: ollamaUrl });
+    serverLogger.debug('Configured Ollama provider', { baseUrl: ollamaUrl });
+}
+// Express app setup
+const app = express();
+app.use(cors());
+app.use(express.json());
+// Request logging
+app.use((req, res, next) => {
+    console.log(`[${new Date().toISOString()}] ${req.method} ${req.path}`);
+    next();
+});
+// Static files and API routes
+app.use(express.static(path.join(__dirname, '../public')));
+app.use('/api', apiRouter);
+// Health check endpoint
+app.get('/health', (req, res) => {
+    try {
+        res.json({
+            status: 'healthy',
+            timestamp: new Date().toISOString(),
+            services: { express: 'running' }
+        });
+    }
+    catch (error) {
+        console.error('Error getting server health:', error);
+        res.status(500).json({
+            status: 'error',
+            timestamp: new Date().toISOString(),
+            error: 'Failed to get server health'
+        });
+    }
+});
+// SPA fallback - serve index.html for all non-API routes
+app.get('*', (req, res) => {
+    res.sendFile(path.join(__dirname, '../public/index.html'));
+});
+// Error handling middleware
+app.use((error, req, res, next) => {
+    console.error('Unhandled error:', error);
+    res.status(500).json({ error: 'Internal server error', code: 'INTERNAL_ERROR' });
+});
+// 404 handler
+app.use((req, res) => {
+    res.status(404).json({ error: 'Endpoint not found', code: 'NOT_FOUND' });
+});
+// Server startup function
+export function startWebServer(port = PORT, host = HOST) {
+    return new Promise((resolve, reject) => {
+        configureLLMProvidersFromEnv();
+        const server = app.listen(port, host, () => {
+            const serverAddress = server.address();
+            if (serverAddress && typeof serverAddress === 'object') {
+                const actualPort = serverAddress.port;
+                const url = `http://${host}:${actualPort}`;
+                console.log(`🌐 Web server running at ${url}`);
+                // console.log(`📁 Serving static files from: ${path.join(__dirname, '../public')}`);
+                // console.log(`🚀 HTTP server running with REST API and SSE chat`);
+                resolve(server);
+                open(url);
+            }
+        });
+        server.on('error', reject);
+    });
+}
+// Direct execution handling - check both direct execution and npm bin execution
+const currentFileUrl = import.meta.url;
+const entryPointUrl = pathToFileURL(path.resolve(process.argv[1])).href;
+const isDirectExecution = currentFileUrl === entryPointUrl;
+const isServerBinCommand = process.argv[1].includes('agent-world-server') || currentFileUrl.includes('server/index.js');
+if (isDirectExecution || isServerBinCommand) {
+    startWebServer()
+        .then(() => console.log('Server started successfully'))
+        .catch((error) => {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-world",
-  "version": "0.4.0",
+  "version": "0.4.5",
   "main": "index.ts",
   "type": "module",
   "workspaces": [
@@ -8,7 +8,8 @@
     "next"
   ],
   "bin": {
-    "agent-world": "dist/cli/index.js"
+    "agent-world": "dist/cli/index.js",
+    "agent-world-server": "dist/server/index.js"
   },
   "scripts": {
     "prestart": "npm run build",
@@ -49,6 +50,7 @@
     "chalk": "^4.1.2",
     "cors": "^2.8.5",
     "dotenv": "^16.5.0",
+    "enquirer": "^2.4.1",
     "events": "^3.3.0",
     "express": "^4.21.2",
     "ollama-ai-provider": "^1.2.0",