agent-world 0.4.6 → 0.6.0

package/README.md

@@ -6,6 +6,8 @@
 
 Traditional AI frameworks force you to write hundreds of lines of code just to make agents talk to each other. Agent World lets you create intelligent agent teams using nothing but plain natural language.
 
+https://github.com/user-attachments/assets/cc507c95-01a4-4c27-975a-f8f67d8cf0d7
+
 Audio introduction: [Listen here](https://yysun.github.io/agent-world)
 
 **Other frameworks:**
@@ -80,13 +82,14 @@ Each Agent World has a collection of agents that can communicate through a share
 | **Direct mention** | `@alice Can you help?` | Only @alice |
 | **Paragraph mention** | `Please review this:\n@alice` | Only @alice |
 | **Mid-text mention** | `I think @alice should help` | Nobody (saved to memory) |
+| **Stop World** | `<world>pass</world>` | No agents |
 
 ### Agent Behavior
 
 **Agents always respond to:**
 - Human messages (unless mentioned agents exist)
 - Direct @mentions at paragraph start
-- System messages
+- World messages
 
 **Agents never respond to:**
 - Their own messages
@@ -126,58 +129,9 @@ npx agent-world -w default-world "hi"
 echo "hi" | npx agent-world -w default-world
 ```
 
-## Project Structure (npm workspaces)
-
-This project uses npm workspaces with two main packages:
-
-- **`core/`** - Reusable agent management library
-  - World-mediated agent management system
-  - Event-driven architecture
-  - LLM provider abstraction
-  - Cross-platform compatibility (Node.js/Browser)
-
-- **`next/`** - Next.js web application
-  - React frontend with Tailwind CSS
-  - API routes for CRUD operations
-  - Real-time chat with streaming support
-  - Modern, minimalistic UI
-
-### Cross-workspace imports
-```typescript
-// In next/ workspace
-import { createWorld, listAgents, publishMessage } from '@agent-world/core';
-```
-
-### Web Interface Features
-
-The Next.js workspace provides a modern web interface with:
-
-- **Home Page**: World selector and creator with clean card-based UI
-- **World Page**: Chat interface with agent management sidebar
-  - Real-time messaging with agents
-  - Toggle between streaming and non-streaming modes
-  - Agent creation with custom system prompts
-  - Responsive design with Tailwind CSS
-
-### API Endpoints
+## Project Structure
 
-The Next.js workspace exposes REST APIs for integration:
-
-```
-GET    /api/worlds                     # List all worlds
-POST   /api/worlds                     # Create new world
-GET    /api/worlds/:id                 # Get world details
-PUT    /api/worlds/:id                 # Update world
-DELETE /api/worlds/:id                 # Delete world
-
-GET    /api/worlds/:id/agents          # List agents in world
-POST   /api/worlds/:id/agents          # Create new agent
-GET    /api/worlds/:id/agents/:agentId # Get agent details
-PUT    /api/worlds/:id/agents/:agentId # Update agent
-DELETE /api/worlds/:id/agents/:agentId # Delete agent
-
-POST   /api/worlds/:id/chat            # Send message (streaming/non-streaming)
-```
+See [Project Structure Documentation](project.md)
 
 ### Environment Setup
 
@@ -219,11 +173,30 @@ export AGENT_WORLD_DATA_PATH=./data/worlds
 - **[Building Agents with Just Words](docs/Building%20Agents%20with%20Just%20Words.md)** - Complete guide with examples
 
 
+## Experimental Features
+
+- **MCP Support** - *Currently in experiment* - Model Context Protocol integration for tools like search and code execution. e.g.,
+
+```json
+{
+	"servers": {
+		"playwright": {
+			"command": "npx",
+			"args": [
+				"@playwright/mcp@latest"
+			]
+		}
+	}
+}
+```
+
+It supports transport types `stdio` and `http`.
+
+
 ## Future Plans
 
 - **Long Run Worlds** - Worlds can run for days or weeks, with agents evolving over time
 - **Dynamic Worlds** - Worlds can provide real-time data to agents, e.g. date and time
-- **Tools / MCP Support** - Worlds can have tools for agents to use, like search or code execution
 - **Agent Learning** - Agents will evolve based on interactions
 - **Agent Replication** - Agents can create new agents
 

package/dist/cli/index.js

@@ -39,9 +39,9 @@ import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import readline from 'readline';
 import { listWorlds, subscribeWorld, createCategoryLogger, LLMProvider, enableStreaming, disableStreaming } from '../core/index.js';
-import { getDefaultRootPath } from '../core/storage-factory.js';
+import { getDefaultRootPath } from '../core/storage/storage-factory.js';
 import { processCLIInput } from './commands.js';
-import { createStreamingState, handleWorldEventWithStreaming } from './stream.js';
+import { createStreamingState, handleWorldEventWithStreaming, } from './stream.js';
 import { configureLLMProvider } from '../core/llm-config.js';
 // Create CLI category logger after logger auto-initialization
 const logger = createCategoryLogger('cli');
@@ -100,12 +100,12 @@ function configureLLMProvidersFromEnv() {
         logger.debug('Configured Google provider from environment');
     }
     // Azure
-    if (process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_ENDPOINT && process.env.AZURE_DEPLOYMENT) {
+    if (process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_RESOURCE_NAME && process.env.AZURE_DEPLOYMENT) {
         configureLLMProvider(LLMProvider.AZURE, {
             apiKey: process.env.AZURE_OPENAI_API_KEY,
-            endpoint: process.env.AZURE_ENDPOINT,
+            resourceName: process.env.AZURE_RESOURCE_NAME,
             deployment: process.env.AZURE_DEPLOYMENT,
-            apiVersion: process.env.AZURE_API_VERSION || '2023-12-01-preview'
+            apiVersion: process.env.AZURE_API_VERSION || '2024-10-21-preview'
         });
         logger.debug('Configured Azure provider from environment');
     }
@@ -124,19 +124,19 @@ function configureLLMProvidersFromEnv() {
         });
         logger.debug('Configured OpenAI-Compatible provider from environment');
     }
-    // Ollama
+    // Ollama (OpenAI-compatible endpoint)
     if (process.env.OLLAMA_BASE_URL) {
         configureLLMProvider(LLMProvider.OLLAMA, {
             baseUrl: process.env.OLLAMA_BASE_URL
         });
-        logger.debug('Configured Ollama provider from environment');
+        logger.debug('Configured Ollama provider (OpenAI-compatible) from environment');
     }
     else {
-        // Configure Ollama with default URL if not specified
+        // Configure Ollama with default OpenAI-compatible URL if not specified
         configureLLMProvider(LLMProvider.OLLAMA, {
-            baseUrl: 'http://localhost:11434/api'
+            baseUrl: 'http://localhost:11434/v1'
         });
-        logger.debug('Configured Ollama provider with default URL');
+        logger.debug('Configured Ollama provider (OpenAI-compatible) with default URL');
     }
 }
 // Get default root path from storage-factory (no local defaults)
@@ -158,7 +158,6 @@ function printCLIResult(result) {
 }
 // Pipeline mode execution with timer-based cleanup
 async function runPipelineMode(options, messageFromArgs) {
-    const rootPath = options.root || DEFAULT_ROOT_PATH;
     disableStreaming();
     try {
         let world = null;
@@ -198,7 +197,7 @@ async function runPipelineMode(options, messageFromArgs) {
             }, delay);
         };
         if (options.world) {
-            worldSubscription = await subscribeWorld(options.world, rootPath, pipelineClient);
+            worldSubscription = await subscribeWorld(options.world, pipelineClient);
             if (!worldSubscription) {
                 console.error(boldRed(`Error: World '${options.world}' not found`));
                 process.exit(1);
@@ -211,7 +210,7 @@ async function runPipelineMode(options, messageFromArgs) {
                 console.error(boldRed('Error: World must be specified to send user messages'));
                 process.exit(1);
             }
-            const result = await processCLIInput(options.command, world, rootPath, 'HUMAN');
+            const result = await processCLIInput(options.command, world, 'HUMAN');
             printCLIResult(result);
             // Only set timer if sending message to world (not for commands)
             if (!options.command.startsWith('/') && world) {
@@ -234,7 +233,7 @@ async function runPipelineMode(options, messageFromArgs) {
                 console.error(boldRed('Error: World must be specified to send user messages'));
                 process.exit(1);
             }
-            const result = await processCLIInput(messageFromArgs, world, rootPath, 'HUMAN');
+            const result = await processCLIInput(messageFromArgs, world, 'HUMAN');
             printCLIResult(result);
             // Set timer with longer delay for message processing (always needed for messages)
             setupExitTimer(8000);
@@ -254,7 +253,7 @@ async function runPipelineMode(options, messageFromArgs) {
                     console.error(boldRed('Error: World must be specified to send user messages'));
                     process.exit(1);
                 }
-                const result = await processCLIInput(input.trim(), world, rootPath, 'HUMAN');
+                const result = await processCLIInput(input.trim(), world, 'HUMAN');
                 printCLIResult(result);
                 // Set timer with longer delay for message processing (always needed for stdin messages)
                 setupExitTimer(8000);
@@ -290,7 +289,7 @@ async function handleSubscribe(rootPath, worldName, streaming, globalState, rl)
             console.log(red(`Error: ${error}`));
         }
     };
-    const subscription = await subscribeWorld(worldName, rootPath, cliClient);
+    const subscription = await subscribeWorld(worldName, cliClient);
     if (!subscription)
         throw new Error('Failed to load world');
     return { subscription, world: subscription.world };
@@ -313,7 +312,7 @@ function handleWorldEvent(eventType, eventData, streaming, globalState, rl) {
 // World discovery and selection
 async function getAvailableWorldNames(rootPath) {
     try {
-        const worldInfos = await listWorlds(rootPath);
+        const worldInfos = await listWorlds();
         return worldInfos.map(info => info.id);
     }
     catch (error) {
@@ -469,11 +468,10 @@ async function runInteractiveMode(options) {
                     cleanupWorldSubscription(worldState);
                 rl.close();
                 process.exit(0);
-                return;
             }
             console.log(`\n${boldYellow('● you:')} ${trimmedInput}`);
             try {
-                const result = await processCLIInput(trimmedInput, worldState?.world || null, rootPath, 'HUMAN');
+                const result = await processCLIInput(trimmedInput, worldState?.world || null, 'HUMAN');
                 // Handle exit commands from result (redundant, but keep for safety)
                 if (result.data?.exit) {
                     if (isExiting)
@@ -487,7 +485,6 @@ async function runInteractiveMode(options) {
                         cleanupWorldSubscription(worldState);
                     rl.close();
                     process.exit(0);
-                    return;
                 }
                 // Handle world selection command
                 if (result.data?.selectWorld) {
@@ -600,6 +597,7 @@ async function runInteractiveMode(options) {
             if (isExiting)
                 return; // Prevent duplicate cleanup
             isExiting = true;
+            console.log(`\n${boldCyan('Shutting down...')}`);
             clearPromptTimer(globalState);
             if (streaming.stopWait)
                 streaming.stopWait();

package/{index.ts → dist/index.js}

@@ -10,13 +10,11 @@
  *
  * This module re-exports the core functionality of Agent World for npm package usage.
  */
-
 // Re-export all core functionality
 export * from './core/index';
-
 // Package information
 export const PACKAGE_INFO = {
-  name: 'agent-world',
-  version: '0.3.0',
-  description: 'A agent management system for building AI agent teams with just words.',
-} as const;
+    name: 'agent-world',
+    version: '0.5.0',
+    description: 'A agent management system for building AI agent teams with just words.',
+};

package/dist/server/index.js

@@ -23,6 +23,7 @@ import cors from 'cors';
 import path from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
 import apiRouter from './api.js';
+import { initializeMCPRegistry, shutdownAllMCPServers } from '../core/mcp-server-registry.js';
 // ES modules setup
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -47,12 +48,12 @@ function configureLLMProvidersFromEnv() {
         }
     });
     // Azure (requires multiple env vars)
-    if (process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_ENDPOINT && process.env.AZURE_DEPLOYMENT) {
+    if (process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_RESOURCE_NAME && process.env.AZURE_DEPLOYMENT) {
         configureLLMProvider(LLMProvider.AZURE, {
             apiKey: process.env.AZURE_OPENAI_API_KEY,
-            endpoint: process.env.AZURE_ENDPOINT,
+            resourceName: process.env.AZURE_RESOURCE_NAME,
             deployment: process.env.AZURE_DEPLOYMENT,
-            apiVersion: process.env.AZURE_API_VERSION || '2023-12-01-preview'
+            apiVersion: process.env.AZURE_API_VERSION || '2024-10-21-preview'
         });
         serverLogger.debug('Configured Azure provider from environment');
     }
@@ -64,10 +65,10 @@ function configureLLMProvidersFromEnv() {
         });
         serverLogger.debug('Configured OpenAI-Compatible provider from environment');
     }
-    // Ollama
-    const ollamaUrl = process.env.OLLAMA_BASE_URL || 'http://localhost:11434/api';
+    // Ollama (OpenAI-compatible endpoint)
+    const ollamaUrl = process.env.OLLAMA_BASE_URL || 'http://localhost:11434/v1';
     configureLLMProvider(LLMProvider.OLLAMA, { baseUrl: ollamaUrl });
-    serverLogger.debug('Configured Ollama provider', { baseUrl: ollamaUrl });
+    serverLogger.debug('Configured Ollama provider (OpenAI-compatible)', { baseUrl: ollamaUrl });
 }
 // Express app setup
 const app = express();
@@ -116,6 +117,9 @@ app.use((req, res) => {
 export function startWebServer(port = PORT, host = HOST) {
     return new Promise((resolve, reject) => {
         configureLLMProvidersFromEnv();
+        // Initialize MCP registry
+        initializeMCPRegistry();
+        serverLogger.info('MCP registry initialized');
         const server = app.listen(port, host, () => {
             const serverAddress = server.address();
             if (serverAddress && typeof serverAddress === 'object') {
@@ -129,6 +133,46 @@ export function startWebServer(port = PORT, host = HOST) {
             }
         });
         server.on('error', reject);
+        // Setup graceful shutdown handlers
+        const gracefulShutdown = async (signal) => {
+            serverLogger.info(`Received ${signal}, initiating graceful shutdown`);
+            try {
+                // Shutdown MCP servers first
+                await shutdownAllMCPServers();
+                serverLogger.info('MCP servers shut down');
+                // Close Express server
+                server.close((err) => {
+                    if (err) {
+                        serverLogger.error('Error closing server', { error: err.message });
+                        process.exit(1);
+                    }
+                    else {
+                        serverLogger.info('Express server closed');
+                        process.exit(0);
+                    }
+                });
+            }
+            catch (error) {
+                serverLogger.error('Error during graceful shutdown', {
+                    error: error instanceof Error ? error.message : error
+                });
+                process.exit(1);
+            }
+        };
+        // Register shutdown handlers
+        process.on('SIGTERM', () => gracefulShutdown('SIGTERM'));
+        process.on('SIGINT', () => gracefulShutdown('SIGINT'));
+        // Handle uncaught exceptions and unhandled rejections
+        process.on('uncaughtException', (error) => {
+            serverLogger.error('Uncaught exception', { error: error.message });
+            gracefulShutdown('uncaughtException');
+        });
+        process.on('unhandledRejection', (reason, promise) => {
+            serverLogger.error('Unhandled rejection', {
+                reason: reason instanceof Error ? reason.message : reason,
+                promise: promise.toString()
+            });
+        });
     });
 }
 // Direct execution handling - check both direct execution and npm bin execution

package/package.json

@@ -1,11 +1,24 @@
 {
   "name": "agent-world",
-  "version": "0.4.6",
-  "main": "index.ts",
+  "version": "0.6.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./core": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
   "type": "module",
   "workspaces": [
     "core",
-    "next"
+    "next",
+    "web"
   ],
   "bin": {
     "agent-world": "dist/cli/index.js",
@@ -16,12 +29,13 @@
     "start": "node dist/server/index.js",
     "cli": "npx tsx cli/index.ts",
     "server": "npx tsx server/index.ts",
-    "dev-web": "concurrently \"npm run server\" \"cd web && npm run dev\"",
+    "dev": "concurrently \"npm run server\" \"npm run dev --workspace=web\"",
     "test": "jest --config jest.config.js",
-    "check": "tsc --noEmit",
-    "build": "tsc && cd web && npm run build",
+    "test:db": "npx tsx tests/db/migration-tests.ts",
+    "check": "tsc --noEmit && npm run check --workspace=web",
+    "build": "npm run build --workspace=core && tsc --project tsconfig.build.json && npm run build --workspace=web",
     "pkill": "pkill -f tsx",
-    "dev": "cd next && npm run dev"
+    "dev-next": "cd next && npm run dev"
   },
   "description": "World-mediated agent management system with clean API surface",
   "keywords": [
@@ -34,53 +48,24 @@
   ],
   "author": "",
   "license": "ISC",
-  "exports": {
-    ".": "./index.ts",
-    "./package.json": "./package.json"
-  },
   "dependencies": {
-    "@ai-sdk/anthropic": "^1.2.12",
-    "@ai-sdk/azure": "^1.3.23",
-    "@ai-sdk/google": "^1.2.19",
-    "@ai-sdk/openai": "^1.3.22",
-    "@ai-sdk/openai-compatible": "^0.2.14",
-    "@ai-sdk/xai": "^1.2.16",
-    "@types/terminal-kit": "^2.5.7",
-    "ai": "^4.3.16",
-    "chalk": "^4.1.2",
+    "chalk": "^5.5.0",
     "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",
     "open": "^10.2.0",
-    "pino": "^9.7.0",
-    "pino-pretty": "^13.0.0",
-    "sqlite3": "^5.1.7",
-    "tsx": "^4.19.2",
-    "typescript": "^5.8.3",
-    "uuid": "^11.1.0",
-    "zod": "^3.25.67"
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@types/chalk": "^0.4.31",
-    "@types/cors": "^2.8.14",
+    "@types/cors": "^2.8.19",
     "@types/express": "^4.17.23",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.19.9",
-    "@types/pino": "^7.0.4",
-    "@types/sqlite3": "^3.1.11",
-    "@types/tmp": "^0.2.0",
-    "@types/uuid": "^10.0.0",
-    "@types/ws": "^8.18.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.3.0",
     "commander": "^14.0.0",
-    "concurrently": "^9.1.2",
-    "esbuild": "^0.21.5",
-    "jest": "^29.5.0",
-    "nodemon": "^3.1.10",
-    "tmp": "^0.2.0",
-    "ts-jest": "^29.1.0"
+    "concurrently": "^9.2.0",
+    "jest": "^30.0.5",
+    "ts-jest": "^29.4.1"
   },
   "engines": {
     "node": ">=20.0.0"