agent-world 0.4.6 → 0.5.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:**
@@ -126,58 +128,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
+## Project Structure
 
-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
-
-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
 

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');
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-world",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "main": "index.ts",
   "type": "module",
   "workspaces": [
@@ -16,12 +16,12 @@
     "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\" \"cd web && npm run dev\"",
     "test": "jest --config jest.config.js",
     "check": "tsc --noEmit",
     "build": "tsc && cd web && npm run build",
     "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": [
@@ -39,47 +39,43 @@
     "./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",
+    "@ai-sdk/anthropic": "^2.0.0",
+    "@ai-sdk/azure": "^2.0.2",
+    "@ai-sdk/google": "^2.0.1",
+    "@ai-sdk/openai": "^2.0.2",
+    "@ai-sdk/openai-compatible": "^1.0.1",
+    "@ai-sdk/xai": "^2.0.1",
+    "ai": "^5.0.2",
+    "chalk": "^5.5.0",
     "cors": "^2.8.5",
-    "dotenv": "^16.5.0",
+    "dotenv": "^17.2.1",
     "enquirer": "^2.4.1",
     "events": "^3.3.0",
     "express": "^4.21.2",
+    "nanoid": "^5.1.5",
     "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",
+    "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "uuid": "^11.1.0",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/chalk": "^0.4.31",
-    "@types/cors": "^2.8.14",
+    "@types/chalk": "^2.2.4",
+    "@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/sqlite3": "^5.1.0",
     "@types/tmp": "^0.2.0",
     "@types/uuid": "^10.0.0",
     "@types/ws": "^8.18.1",
     "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"
   },
   "engines": {