@agentxjs/server 1.9.10-dev → 2.0.0

package/README.md

@@ -0,0 +1,137 @@
+# @agentxjs/server
+
+WebSocket server for AgentX. Exposes a JSON-RPC 2.0 API for managing containers, images, agents, and messages. Stream events from running agents are broadcast to subscribed clients.
+
+## Overview
+
+`@agentxjs/server` creates a WebSocket server that accepts client connections, handles JSON-RPC requests via a `CommandHandler`, and broadcasts LLM stream events as JSON-RPC notifications. It supports two startup modes: standalone (own port) and attached (existing HTTP server).
+
+## Quick Start
+
+### Standalone Mode
+
+```typescript
+import { createServer } from "@agentxjs/server";
+import { nodePlatform } from "@agentxjs/node-platform";
+import { createMonoDriver } from "@agentxjs/mono-driver";
+import type { CreateDriver } from "@agentxjs/core/driver";
+
+const apiKey = process.env.ANTHROPIC_API_KEY!;
+
+const wrappedCreateDriver: CreateDriver = (config) => {
+  return createMonoDriver({
+    ...config,
+    apiKey,
+    options: { provider: "anthropic" },
+  });
+};
+
+const server = await createServer({
+  platform: nodePlatform({ dataPath: "./data" }),
+  createDriver: wrappedCreateDriver,
+  port: 5200,
+});
+
+await server.listen();
+// Server listening on ws://0.0.0.0:5200
+```
+
+### Attached Mode (Express / Next.js / Hono)
+
+Attach to an existing HTTP server instead of opening a new port:
+
+```typescript
+import { createServer as createHttpServer } from "http";
+import { createServer } from "@agentxjs/server";
+import { nodePlatform } from "@agentxjs/node-platform";
+
+const httpServer = createHttpServer();
+
+const server = await createServer({
+  platform: nodePlatform({ dataPath: "./data" }),
+  createDriver: wrappedCreateDriver,
+  server: httpServer, // attach here
+  wsPath: "/ws", // WebSocket upgrade path (default: "/ws")
+});
+
+// The HTTP server handles listen()
+httpServer.listen(3000);
+```
+
+### CLI Binary
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-xxx bun run packages/server/bin/server.ts
+```
+
+## API Reference
+
+### `createServer(config: ServerConfig): Promise<AgentXServer>`
+
+Creates and returns an AgentX server instance.
+
+### `AgentXServer`
+
+```typescript
+interface AgentXServer {
+  listen(port?: number, host?: string): Promise<void>; // standalone only
+  close(): Promise<void>;
+  dispose(): Promise<void>; // full cleanup
+}
+```
+
+### `CommandHandler`
+
+Maps JSON-RPC methods to runtime operations. Exported for advanced use (e.g., custom transports).
+
+```typescript
+import { CommandHandler } from "@agentxjs/server";
+```
+
+## Configuration
+
+### ServerConfig
+
+```typescript
+interface ServerConfig {
+  platform: AgentXPlatform | DeferredPlatformConfig;
+  createDriver: CreateDriver;
+  port?: number; // default: 5200
+  host?: string; // default: "0.0.0.0"
+  server?: MinimalHTTPServer; // attach to existing server
+  wsPath?: string; // default: "/ws" (attached mode)
+  debug?: boolean;
+}
+```
+
+| Field          | Type                                       | Default     | Description                                      |
+| -------------- | ------------------------------------------ | ----------- | ------------------------------------------------ |
+| `platform`     | `AgentXPlatform \| DeferredPlatformConfig` | --          | Platform with repositories and event bus         |
+| `createDriver` | `CreateDriver`                             | --          | Factory function that creates a Driver per agent |
+| `port`         | `number`                                   | `5200`      | Standalone listen port                           |
+| `host`         | `string`                                   | `"0.0.0.0"` | Standalone bind host                             |
+| `server`       | `MinimalHTTPServer`                        | --          | Existing HTTP server to attach to                |
+| `wsPath`       | `string`                                   | `"/ws"`     | WebSocket path in attached mode                  |
+| `debug`        | `boolean`                                  | `false`     | Enable debug logging                             |
+
+### Heartbeat
+
+WebSocket connections are automatically monitored with a ping/pong heartbeat (30-second interval). If a client fails to respond, the connection is terminated. This is always enabled and requires no configuration.
+
+```typescript
+// Heartbeat is automatic — no config needed
+// Server sends ping every 30s, client must respond with pong
+// Unresponsive clients are disconnected automatically
+```
+
+### Environment Variables (CLI)
+
+| Variable             | Required | Default            | Description                         |
+| -------------------- | -------- | ------------------ | ----------------------------------- |
+| `ANTHROPIC_API_KEY`  | Yes      | --                 | Claude API key                      |
+| `ANTHROPIC_BASE_URL` | No       | --                 | Custom API endpoint                 |
+| `PORT`               | No       | `5200`             | Server port                         |
+| `HOST`               | No       | `0.0.0.0`          | Server host                         |
+| `DATA_PATH`          | No       | `./data`           | Data storage directory              |
+| `LOG_DIR`            | No       | `<DATA_PATH>/logs` | Log file directory                  |
+| `LOG_LEVEL`          | No       | `info`             | `debug` / `info` / `warn` / `error` |

package/bin/server.ts

@@ -15,8 +15,9 @@
  */
 
 import { createServer } from "../src";
-import { nodeProvider } from "@agentxjs/node-provider";
-import { createClaudeDriverFactory } from "@agentxjs/claude-driver";
+import { nodePlatform } from "@agentxjs/node-platform";
+import { createMonoDriver } from "@agentxjs/mono-driver";
+import type { CreateDriver } from "@agentxjs/core/driver";
 import { createLogger } from "commonxjs/logger";
 
 const logger = createLogger("server/bin");
@@ -47,16 +48,24 @@ async function main() {
     debug,
   });
 
-  // Create driver factory
-  const driverFactory = createClaudeDriverFactory();
+  // Create driver factory that injects apiKey/baseUrl
+  const baseUrl = process.env.ANTHROPIC_BASE_URL;
+  const wrappedCreateDriver: CreateDriver = (config) => {
+    return createMonoDriver({
+      ...config,
+      apiKey,
+      baseUrl,
+      options: { provider: "anthropic" },
+    });
+  };
 
-  // Create server with nodeProvider
+  // Create server with nodePlatform + driver
   const server = await createServer({
-    provider: nodeProvider({
+    platform: nodePlatform({
       dataPath,
-      driverFactory,
       logDir,
     }),
+    createDriver: wrappedCreateDriver,
     port,
     host,
     debug,

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as _agentxjs_core_network from '@agentxjs/core/network';
 import { RpcMethod } from '@agentxjs/core/network';
-import { AgentXProvider, AgentXRuntime } from '@agentxjs/core/runtime';
-import { DeferredProviderConfig } from '@agentxjs/node-provider';
+import { AgentXPlatform, AgentXRuntime } from '@agentxjs/core/runtime';
+import { CreateDriver } from '@agentxjs/core/driver';
+import { DeferredPlatformConfig } from '@agentxjs/node-platform';
 
 /**
  * Server Types
@@ -25,13 +26,17 @@ interface AgentXServer {
 }
 
 /**
- * Server configuration (supports both immediate and deferred providers)
+ * Server configuration (supports both immediate and deferred platforms)
  */
 interface ServerConfig {
     /**
-     * AgentX Provider (can be AgentXProvider or DeferredProviderConfig)
+     * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)
      */
-    provider: AgentXProvider | DeferredProviderConfig;
+    platform: AgentXPlatform | DeferredPlatformConfig;
+    /**
+     * LLM Driver factory function - creates Driver per Agent
+     */
+    createDriver: CreateDriver;
     /**
      * Port to listen on (standalone mode)
      */

package/dist/index.js

@@ -11,8 +11,8 @@ import {
 } from "@agentxjs/core/network";
 import {
   WebSocketServer,
-  isDeferredProvider
-} from "@agentxjs/node-provider";
+  isDeferredPlatform
+} from "@agentxjs/node-platform";
 import { createLogger as createLogger2 } from "commonxjs/logger";
 
 // src/CommandHandler.ts
@@ -87,7 +87,7 @@ var CommandHandler = class {
   async handleContainerCreate(params) {
     const { containerId } = params;
     const { getOrCreateContainer } = await import("@agentxjs/core/container");
-    const { containerRepository, imageRepository, sessionRepository } = this.runtime.provider;
+    const { containerRepository, imageRepository, sessionRepository } = this.runtime.platform;
     const container = await getOrCreateContainer(containerId, {
       containerRepository,
       imageRepository,
@@ -97,20 +97,20 @@ var CommandHandler = class {
   }
   async handleContainerGet(params) {
     const { containerId } = params;
-    const exists = await this.runtime.provider.containerRepository.containerExists(containerId);
+    const exists = await this.runtime.platform.containerRepository.containerExists(containerId);
     return ok({ containerId, exists });
   }
   async handleContainerList(_params) {
-    const containers = await this.runtime.provider.containerRepository.findAllContainers();
+    const containers = await this.runtime.platform.containerRepository.findAllContainers();
     return ok({ containerIds: containers.map((c) => c.containerId) });
   }
   // ==================== Image Commands ====================
   async handleImageCreate(params) {
-    const { containerId, name, description, systemPrompt, mcpServers } = params;
-    const { imageRepository, sessionRepository } = this.runtime.provider;
+    const { containerId, name, description, systemPrompt, mcpServers, customData } = params;
+    const { imageRepository, sessionRepository } = this.runtime.platform;
     const { createImage } = await import("@agentxjs/core/image");
     const image = await createImage(
-      { containerId, name, description, systemPrompt, mcpServers },
+      { containerId, name, description, systemPrompt, mcpServers, customData },
       { imageRepository, sessionRepository }
     );
     return ok({
@@ -120,7 +120,7 @@ var CommandHandler = class {
   }
   async handleImageGet(params) {
     const { imageId } = params;
-    const record = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const record = await this.runtime.platform.imageRepository.findImageById(imageId);
     return ok({
       record,
       __subscriptions: record?.sessionId ? [record.sessionId] : void 0
@@ -128,7 +128,7 @@ var CommandHandler = class {
   }
   async handleImageList(params) {
     const { containerId } = params;
-    const records = containerId ? await this.runtime.provider.imageRepository.findImagesByContainerId(containerId) : await this.runtime.provider.imageRepository.findAllImages();
+    const records = containerId ? await this.runtime.platform.imageRepository.findImagesByContainerId(containerId) : await this.runtime.platform.imageRepository.findAllImages();
     return ok({
       records,
       __subscriptions: records.map((r) => r.sessionId)
@@ -137,7 +137,7 @@ var CommandHandler = class {
   async handleImageDelete(params) {
     const { imageId } = params;
     const { loadImage } = await import("@agentxjs/core/image");
-    const { imageRepository, sessionRepository } = this.runtime.provider;
+    const { imageRepository, sessionRepository } = this.runtime.platform;
     const image = await loadImage(imageId, { imageRepository, sessionRepository });
     if (image) {
       await image.delete();
@@ -189,7 +189,7 @@ var CommandHandler = class {
   }
   async handleImageUpdate(params) {
     const { imageId, updates } = params;
-    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);
     if (!imageRecord) {
       return err(404, `Image not found: ${imageId}`);
     }
@@ -198,17 +198,17 @@ var CommandHandler = class {
       ...updates,
       updatedAt: Date.now()
     };
-    await this.runtime.provider.imageRepository.saveImage(updatedRecord);
+    await this.runtime.platform.imageRepository.saveImage(updatedRecord);
     logger.info("Updated image", { imageId, updates });
     return ok({ record: updatedRecord });
   }
   async handleImageMessages(params) {
     const { imageId } = params;
-    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);
     if (!imageRecord) {
       return err(404, `Image not found: ${imageId}`);
     }
-    const messages = await this.runtime.provider.sessionRepository.getMessages(
+    const messages = await this.runtime.platform.sessionRepository.getMessages(
       imageRecord.sessionId
     );
     logger.debug("Got messages for image", { imageId, count: messages.length });
@@ -302,8 +302,8 @@ var CommandHandler = class {
 var logger2 = createLogger2("server/Server");
 async function createServer(config) {
   const { wsPath = "/ws" } = config;
-  const provider = isDeferredProvider(config.provider) ? await config.provider.resolve() : config.provider;
-  const runtime = createAgentXRuntime(provider);
+  const platform = isDeferredPlatform(config.platform) ? await config.platform.resolve() : config.platform;
+  const runtime = createAgentXRuntime(platform, config.createDriver);
   const wsServer = new WebSocketServer({
     heartbeat: true,
     heartbeatInterval: 3e4,
@@ -401,7 +401,7 @@ async function createServer(config) {
       logger2.warn("Received invalid JSON-RPC message");
     }
   }
-  provider.eventBus.onAny((event) => {
+  platform.eventBus.onAny((event) => {
     if (!shouldBroadcastEvent(event)) {
       return;
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Server.ts","../src/CommandHandler.ts"],"sourcesContent":["/**\n * AgentX Server Implementation (JSON-RPC 2.0)\n *\n * Creates a WebSocket server that:\n * 1. Accepts client connections\n * 2. Handles JSON-RPC requests directly via CommandHandler\n * 3. Broadcasts stream events as JSON-RPC notifications\n *\n * Message Types:\n * - RPC Request (has id): Client → Server → Client (direct response)\n * - RPC Notification (no id): Server → Client (stream events)\n */\n\nimport type { AgentXProvider } from \"@agentxjs/core/runtime\";\nimport type { ChannelConnection } from \"@agentxjs/core/network\";\nimport type { BusEvent, SystemEvent } from \"@agentxjs/core/event\";\nimport { createAgentXRuntime } from \"@agentxjs/core/runtime\";\nimport {\n  parseMessage,\n  isRequest,\n  isNotification,\n  createSuccessResponse,\n  createErrorResponse,\n  createStreamEvent,\n  RpcErrorCodes,\n  type RpcMethod,\n} from \"@agentxjs/core/network\";\nimport {\n  WebSocketServer,\n  isDeferredProvider,\n  type DeferredProviderConfig,\n} from \"@agentxjs/node-provider\";\nimport { createLogger } from \"commonxjs/logger\";\nimport { CommandHandler } from \"./CommandHandler\";\nimport type { AgentXServer } from \"./types\";\n\nconst logger = createLogger(\"server/Server\");\n\n/**\n * Connection state\n */\ninterface ConnectionState {\n  connection: ChannelConnection;\n  subscribedTopics: Set<string>;\n}\n\n/**\n * Server configuration (supports both immediate and deferred providers)\n */\nexport interface ServerConfig {\n  /**\n   * AgentX Provider (can be AgentXProvider or DeferredProviderConfig)\n   */\n  provider: AgentXProvider | DeferredProviderConfig;\n\n  /**\n   * Port to listen on (standalone mode)\n   */\n  port?: number;\n\n  /**\n   * Host to bind to (default: \"0.0.0.0\")\n   */\n  host?: string;\n\n  /**\n   * Existing HTTP server to attach to (attached mode)\n   */\n  server?: import(\"@agentxjs/core/network\").MinimalHTTPServer;\n\n  /**\n   * WebSocket path when attached (default: \"/ws\")\n   */\n  wsPath?: string;\n\n  /**\n   * Enable debug logging\n   */\n  debug?: boolean;\n}\n\n/**\n * Create an AgentX server\n */\nexport async function createServer(config: ServerConfig): Promise<AgentXServer> {\n  const { wsPath = \"/ws\" } = config;\n\n  // Resolve deferred provider if needed\n  const provider: AgentXProvider = isDeferredProvider(config.provider)\n    ? await config.provider.resolve()\n    : config.provider;\n\n  // Create runtime from provider\n  const runtime = createAgentXRuntime(provider);\n\n  // Create WebSocket server\n  const wsServer = new WebSocketServer({\n    heartbeat: true,\n    heartbeatInterval: 30000,\n    debug: config.debug,\n  });\n\n  // Create command handler (no longer needs eventBus)\n  const commandHandler = new CommandHandler(runtime);\n\n  // Track connections\n  const connections = new Map<string, ConnectionState>();\n\n  /**\n   * Subscribe connection to a topic\n   */\n  function subscribeToTopic(connectionId: string, topic: string): void {\n    const state = connections.get(connectionId);\n    if (!state || state.subscribedTopics.has(topic)) return;\n\n    state.subscribedTopics.add(topic);\n    logger.debug(\"Connection subscribed to topic\", { connectionId, topic });\n  }\n\n  /**\n   * Check if event should be sent to connection based on subscriptions\n   */\n  function shouldSendToConnection(state: ConnectionState, event: BusEvent): boolean {\n    // Skip internal driver events\n    if (event.source === \"driver\" && event.intent !== \"notification\") {\n      return false;\n    }\n\n    // Skip command events (they are handled via RPC, not broadcast)\n    if (event.source === \"command\") {\n      return false;\n    }\n\n    // Check if subscribed to event's session\n    const eventWithContext = event as BusEvent & { context?: { sessionId?: string } };\n    const sessionId = eventWithContext.context?.sessionId;\n    if (sessionId && state.subscribedTopics.has(sessionId)) {\n      return true;\n    }\n\n    // Send to global subscribers\n    return state.subscribedTopics.has(\"global\");\n  }\n\n  /**\n   * Send JSON-RPC response to a specific connection\n   */\n  function sendResponse(connection: ChannelConnection, id: string | number, result: unknown): void {\n    const response = createSuccessResponse(id, result);\n    connection.send(JSON.stringify(response));\n  }\n\n  /**\n   * Send JSON-RPC error to a specific connection\n   */\n  function sendError(\n    connection: ChannelConnection,\n    id: string | number | null,\n    code: number,\n    message: string\n  ): void {\n    const response = createErrorResponse(id, code, message);\n    connection.send(JSON.stringify(response));\n  }\n\n  // Handle new connections\n  wsServer.onConnection((connection) => {\n    const state: ConnectionState = {\n      connection,\n      subscribedTopics: new Set([\"global\"]),\n    };\n    connections.set(connection.id, state);\n\n    logger.info(\"Client connected\", {\n      connectionId: connection.id,\n      totalConnections: connections.size,\n    });\n\n    // Handle messages from client\n    connection.onMessage(async (message) => {\n      try {\n        const parsed = parseMessage(message);\n\n        // Handle single message (not batch)\n        if (!Array.isArray(parsed)) {\n          await handleParsedMessage(connection, state, parsed);\n        } else {\n          // Handle batch (not common, but supported by JSON-RPC 2.0)\n          for (const item of parsed) {\n            await handleParsedMessage(connection, state, item);\n          }\n        }\n      } catch (err) {\n        logger.error(\"Failed to parse message\", { error: (err as Error).message });\n        sendError(connection, null, RpcErrorCodes.PARSE_ERROR, \"Parse error\");\n      }\n    });\n\n    // Cleanup on disconnect\n    connection.onClose(() => {\n      connections.delete(connection.id);\n      logger.info(\"Client disconnected\", {\n        connectionId: connection.id,\n        totalConnections: connections.size,\n      });\n    });\n  });\n\n  /**\n   * Handle a parsed JSON-RPC message\n   */\n  async function handleParsedMessage(\n    connection: ChannelConnection,\n    state: ConnectionState,\n    parsed: import(\"jsonrpc-lite\").IParsedObject\n  ): Promise<void> {\n    if (isRequest(parsed)) {\n      // JSON-RPC Request - handle and respond directly\n      const payload = parsed.payload as {\n        id: string | number;\n        method: string;\n        params: unknown;\n      };\n      const { id, method, params } = payload;\n\n      logger.debug(\"Received RPC request\", { id, method });\n\n      // Call command handler\n      const result = await commandHandler.handle(method as RpcMethod, params);\n\n      if (result.success) {\n        sendResponse(connection, id, result.data);\n      } else {\n        sendError(connection, id, result.code, result.message);\n      }\n    } else if (isNotification(parsed)) {\n      // JSON-RPC Notification - control messages\n      const payload = parsed.payload as {\n        method: string;\n        params: unknown;\n      };\n      const { method, params } = payload;\n\n      logger.debug(\"Received notification\", { method });\n\n      if (method === \"subscribe\") {\n        const { topic } = params as { topic: string };\n        subscribeToTopic(connection.id, topic);\n      } else if (method === \"unsubscribe\") {\n        const { topic } = params as { topic: string };\n        state.subscribedTopics.delete(topic);\n        logger.debug(\"Connection unsubscribed from topic\", { connectionId: connection.id, topic });\n      } else if (method === \"control.ack\") {\n        // ACK for reliable delivery - handled by network layer\n        logger.debug(\"Received ACK notification\");\n      }\n    } else {\n      // Invalid message\n      logger.warn(\"Received invalid JSON-RPC message\");\n    }\n  }\n\n  // Route internal events to connected clients as JSON-RPC notifications\n  provider.eventBus.onAny((event) => {\n    // Only broadcast broadcastable events\n    if (!shouldBroadcastEvent(event)) {\n      return;\n    }\n\n    // Get topic from event context\n    const eventWithContext = event as BusEvent & { context?: { sessionId?: string } };\n    const topic = eventWithContext.context?.sessionId || \"global\";\n\n    // Wrap as JSON-RPC notification\n    const notification = createStreamEvent(topic, event as SystemEvent);\n    const message = JSON.stringify(notification);\n\n    for (const [connectionId, state] of connections) {\n      if (shouldSendToConnection(state, event)) {\n        state.connection.sendReliable(message, {\n          timeout: 10000,\n          onTimeout: () => {\n            logger.warn(\"Event ACK timeout\", {\n              connectionId,\n              eventType: event.type,\n            });\n          },\n        });\n      }\n    }\n  });\n\n  /**\n   * Check if event should be broadcast\n   */\n  function shouldBroadcastEvent(event: BusEvent): boolean {\n    // Skip internal driver events\n    if (event.source === \"driver\" && event.intent !== \"notification\") {\n      return false;\n    }\n\n    // Skip command events (handled via RPC)\n    if (event.source === \"command\") {\n      return false;\n    }\n\n    // Check broadcastable flag\n    const systemEvent = event as SystemEvent;\n    if (systemEvent.broadcastable === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  // Attach to existing server if provided\n  if (config.server) {\n    wsServer.attach(config.server, wsPath);\n    logger.info(\"WebSocket attached to existing server\", { path: wsPath });\n  }\n\n  return {\n    async listen(port?: number, host?: string) {\n      if (config.server) {\n        throw new Error(\n          \"Cannot listen when attached to existing server. The server should call listen() instead.\"\n        );\n      }\n\n      const listenPort = port ?? config.port ?? 5200;\n      const listenHost = host ?? config.host ?? \"0.0.0.0\";\n\n      await wsServer.listen(listenPort, listenHost);\n      logger.info(\"Server listening\", { port: listenPort, host: listenHost });\n    },\n\n    async close() {\n      await wsServer.close();\n      logger.info(\"Server closed\");\n    },\n\n    async dispose() {\n      // Cleanup in order\n      await wsServer.dispose();\n      commandHandler.dispose();\n      await runtime.shutdown();\n      logger.info(\"Server disposed\");\n    },\n  };\n}\n","/**\n * CommandHandler - Handles JSON-RPC requests directly\n *\n * No longer uses EventBus for request/response. Instead:\n * - Receives RPC requests directly\n * - Returns RPC responses directly\n * - EventBus is only used for stream events (notifications)\n */\n\nimport type { AgentXRuntime } from \"@agentxjs/core/runtime\";\nimport type { UserContentPart } from \"@agentxjs/core/agent\";\nimport type { RpcMethod } from \"@agentxjs/core/network\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"server/CommandHandler\");\n\n/**\n * RPC Result type\n */\nexport interface RpcResult<T = unknown> {\n  success: true;\n  data: T;\n}\n\nexport interface RpcError {\n  success: false;\n  code: number;\n  message: string;\n}\n\nexport type RpcResponse<T = unknown> = RpcResult<T> | RpcError;\n\n/**\n * Helper to create success result\n */\nfunction ok<T>(data: T): RpcResult<T> {\n  return { success: true, data };\n}\n\n/**\n * Helper to create error result\n */\nfunction err(code: number, message: string): RpcError {\n  return { success: false, code, message };\n}\n\n/**\n * CommandHandler - Processes RPC requests directly\n */\nexport class CommandHandler {\n  private readonly runtime: AgentXRuntime;\n\n  constructor(runtime: AgentXRuntime) {\n    this.runtime = runtime;\n    logger.debug(\"CommandHandler created\");\n  }\n\n  /**\n   * Handle an RPC request and return response\n   */\n  async handle(method: RpcMethod, params: unknown): Promise<RpcResponse> {\n    logger.debug(\"Handling RPC request\", { method });\n\n    try {\n      switch (method) {\n        // Container\n        case \"container.create\":\n          return await this.handleContainerCreate(params);\n        case \"container.get\":\n          return await this.handleContainerGet(params);\n        case \"container.list\":\n          return await this.handleContainerList(params);\n\n        // Image\n        case \"image.create\":\n          return await this.handleImageCreate(params);\n        case \"image.get\":\n          return await this.handleImageGet(params);\n        case \"image.list\":\n          return await this.handleImageList(params);\n        case \"image.delete\":\n          return await this.handleImageDelete(params);\n        case \"image.run\":\n          return await this.handleImageRun(params);\n        case \"image.stop\":\n          return await this.handleImageStop(params);\n        case \"image.update\":\n          return await this.handleImageUpdate(params);\n        case \"image.messages\":\n          return await this.handleImageMessages(params);\n\n        // Agent\n        case \"agent.get\":\n          return await this.handleAgentGet(params);\n        case \"agent.list\":\n          return await this.handleAgentList(params);\n        case \"agent.destroy\":\n          return await this.handleAgentDestroy(params);\n        case \"agent.destroyAll\":\n          return await this.handleAgentDestroyAll(params);\n        case \"agent.interrupt\":\n          return await this.handleAgentInterrupt(params);\n\n        // Message\n        case \"message.send\":\n          return await this.handleMessageSend(params);\n\n        default:\n          return err(-32601, `Method not found: ${method}`);\n      }\n    } catch (error) {\n      logger.error(\"RPC handler error\", { method, error });\n      return err(-32000, error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  // ==================== Container Commands ====================\n\n  private async handleContainerCreate(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const { getOrCreateContainer } = await import(\"@agentxjs/core/container\");\n    const { containerRepository, imageRepository, sessionRepository } = this.runtime.provider;\n\n    const container = await getOrCreateContainer(containerId, {\n      containerRepository,\n      imageRepository,\n      sessionRepository,\n    });\n\n    return ok({ containerId: container.containerId });\n  }\n\n  private async handleContainerGet(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const exists = await this.runtime.provider.containerRepository.containerExists(containerId);\n    return ok({ containerId, exists });\n  }\n\n  private async handleContainerList(_params: unknown): Promise<RpcResponse> {\n    const containers = await this.runtime.provider.containerRepository.findAllContainers();\n    return ok({ containerIds: containers.map((c) => c.containerId) });\n  }\n\n  // ==================== Image Commands ====================\n\n  private async handleImageCreate(params: unknown): Promise<RpcResponse> {\n    const { containerId, name, description, systemPrompt, mcpServers } = params as {\n      containerId: string;\n      name?: string;\n      description?: string;\n      systemPrompt?: string;\n      mcpServers?: Record<string, unknown>;\n    };\n\n    const { imageRepository, sessionRepository } = this.runtime.provider;\n    const { createImage } = await import(\"@agentxjs/core/image\");\n\n    const image = await createImage(\n      { containerId, name, description, systemPrompt, mcpServers: mcpServers as any },\n      { imageRepository, sessionRepository }\n    );\n\n    return ok({\n      record: image.toRecord(),\n      __subscriptions: [image.sessionId],\n    });\n  }\n\n  private async handleImageGet(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n    const record = await this.runtime.provider.imageRepository.findImageById(imageId);\n    return ok({\n      record,\n      __subscriptions: record?.sessionId ? [record.sessionId] : undefined,\n    });\n  }\n\n  private async handleImageList(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId?: string };\n    const records = containerId\n      ? await this.runtime.provider.imageRepository.findImagesByContainerId(containerId)\n      : await this.runtime.provider.imageRepository.findAllImages();\n\n    return ok({\n      records,\n      __subscriptions: records.map((r) => r.sessionId),\n    });\n  }\n\n  private async handleImageDelete(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n    const { loadImage } = await import(\"@agentxjs/core/image\");\n    const { imageRepository, sessionRepository } = this.runtime.provider;\n\n    const image = await loadImage(imageId, { imageRepository, sessionRepository });\n    if (image) {\n      await image.delete();\n    }\n\n    return ok({ imageId });\n  }\n\n  private async handleImageRun(params: unknown): Promise<RpcResponse> {\n    const { imageId, agentId: requestedAgentId } = params as {\n      imageId: string;\n      agentId?: string;\n    };\n\n    // Check if already have a running agent for this image\n    const existingAgent = this.runtime\n      .getAgents()\n      .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n    if (existingAgent) {\n      logger.debug(\"Reusing existing agent for image\", {\n        imageId,\n        agentId: existingAgent.agentId,\n      });\n      return ok({\n        imageId,\n        agentId: existingAgent.agentId,\n        sessionId: existingAgent.sessionId,\n        containerId: existingAgent.containerId,\n        reused: true,\n      });\n    }\n\n    // Create new agent (with optional custom agentId)\n    const agent = await this.runtime.createAgent({\n      imageId,\n      agentId: requestedAgentId,\n    });\n    logger.info(\"Created new agent for image\", {\n      imageId,\n      agentId: agent.agentId,\n    });\n\n    return ok({\n      imageId,\n      agentId: agent.agentId,\n      sessionId: agent.sessionId,\n      containerId: agent.containerId,\n      reused: false,\n    });\n  }\n\n  private async handleImageStop(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n\n    // Find running agent for this image\n    const agent = this.runtime\n      .getAgents()\n      .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n    if (agent) {\n      await this.runtime.stopAgent(agent.agentId);\n      logger.info(\"Stopped agent for image\", { imageId, agentId: agent.agentId });\n    } else {\n      logger.debug(\"No running agent found for image\", { imageId });\n    }\n\n    return ok({ imageId });\n  }\n\n  private async handleImageUpdate(params: unknown): Promise<RpcResponse> {\n    const { imageId, updates } = params as {\n      imageId: string;\n      updates: { name?: string; description?: string };\n    };\n\n    // Get existing image\n    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      return err(404, `Image not found: ${imageId}`);\n    }\n\n    // Update image record\n    const updatedRecord = {\n      ...imageRecord,\n      ...updates,\n      updatedAt: Date.now(),\n    };\n\n    await this.runtime.provider.imageRepository.saveImage(updatedRecord);\n\n    logger.info(\"Updated image\", { imageId, updates });\n\n    return ok({ record: updatedRecord });\n  }\n\n  private async handleImageMessages(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n\n    // Get image record to find sessionId\n    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      return err(404, `Image not found: ${imageId}`);\n    }\n\n    // Get messages from session\n    const messages = await this.runtime.provider.sessionRepository.getMessages(\n      imageRecord.sessionId\n    );\n\n    logger.debug(\"Got messages for image\", { imageId, count: messages.length });\n\n    return ok({ imageId, messages });\n  }\n\n  // ==================== Agent Commands ====================\n\n  private async handleAgentGet(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n    const agent = this.runtime.getAgent(agentId);\n\n    return ok({\n      agent: agent\n        ? {\n            agentId: agent.agentId,\n            imageId: agent.imageId,\n            containerId: agent.containerId,\n            sessionId: agent.sessionId,\n            lifecycle: agent.lifecycle,\n          }\n        : null,\n      exists: !!agent,\n    });\n  }\n\n  private async handleAgentList(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId?: string };\n    const agents = containerId\n      ? this.runtime.getAgentsByContainer(containerId)\n      : this.runtime.getAgents();\n\n    return ok({\n      agents: agents.map((a) => ({\n        agentId: a.agentId,\n        imageId: a.imageId,\n        containerId: a.containerId,\n        sessionId: a.sessionId,\n        lifecycle: a.lifecycle,\n      })),\n    });\n  }\n\n  private async handleAgentDestroy(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n\n    // Check if agent exists first\n    const agent = this.runtime.getAgent(agentId);\n    if (!agent) {\n      return ok({ agentId, success: false });\n    }\n\n    await this.runtime.destroyAgent(agentId);\n    return ok({ agentId, success: true });\n  }\n\n  private async handleAgentDestroyAll(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const agents = this.runtime.getAgentsByContainer(containerId);\n    for (const agent of agents) {\n      await this.runtime.destroyAgent(agent.agentId);\n    }\n    return ok({ containerId });\n  }\n\n  private async handleAgentInterrupt(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n    this.runtime.interrupt(agentId);\n    return ok({ agentId });\n  }\n\n  // ==================== Message Commands ====================\n\n  private async handleMessageSend(params: unknown): Promise<RpcResponse> {\n    const { agentId, imageId, content } = params as {\n      agentId?: string;\n      imageId?: string;\n      content: string | UserContentPart[];\n    };\n\n    let targetAgentId: string;\n\n    if (agentId) {\n      // Direct agent reference\n      targetAgentId = agentId;\n    } else if (imageId) {\n      // Auto-activate image: find or create agent\n      const existingAgent = this.runtime\n        .getAgents()\n        .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n      if (existingAgent) {\n        targetAgentId = existingAgent.agentId;\n        logger.debug(\"Using existing agent for message\", {\n          imageId,\n          agentId: targetAgentId,\n        });\n      } else {\n        // Create new agent for this image\n        const agent = await this.runtime.createAgent({ imageId });\n        targetAgentId = agent.agentId;\n        logger.info(\"Auto-created agent for message\", {\n          imageId,\n          agentId: targetAgentId,\n        });\n      }\n    } else {\n      return err(-32602, \"Either agentId or imageId is required\");\n    }\n\n    await this.runtime.receive(targetAgentId, content);\n    return ok({ agentId: targetAgentId, imageId });\n  }\n\n  // ==================== Lifecycle ====================\n\n  dispose(): void {\n    logger.debug(\"CommandHandler disposed\");\n  }\n}\n"],"mappings":"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","names":["createLogger","logger","createLogger","err"]}
+{"version":3,"sources":["../src/Server.ts","../src/CommandHandler.ts"],"sourcesContent":["/**\n * AgentX Server Implementation (JSON-RPC 2.0)\n *\n * Creates a WebSocket server that:\n * 1. Accepts client connections\n * 2. Handles JSON-RPC requests directly via CommandHandler\n * 3. Broadcasts stream events as JSON-RPC notifications\n *\n * Message Types:\n * - RPC Request (has id): Client → Server → Client (direct response)\n * - RPC Notification (no id): Server → Client (stream events)\n */\n\nimport type { AgentXPlatform } from \"@agentxjs/core/runtime\";\nimport type { CreateDriver } from \"@agentxjs/core/driver\";\nimport type { ChannelConnection } from \"@agentxjs/core/network\";\nimport type { BusEvent, SystemEvent } from \"@agentxjs/core/event\";\nimport { createAgentXRuntime } from \"@agentxjs/core/runtime\";\nimport {\n  parseMessage,\n  isRequest,\n  isNotification,\n  createSuccessResponse,\n  createErrorResponse,\n  createStreamEvent,\n  RpcErrorCodes,\n  type RpcMethod,\n} from \"@agentxjs/core/network\";\nimport {\n  WebSocketServer,\n  isDeferredPlatform,\n  type DeferredPlatformConfig,\n} from \"@agentxjs/node-platform\";\nimport { createLogger } from \"commonxjs/logger\";\nimport { CommandHandler } from \"./CommandHandler\";\nimport type { AgentXServer } from \"./types\";\n\nconst logger = createLogger(\"server/Server\");\n\n/**\n * Connection state\n */\ninterface ConnectionState {\n  connection: ChannelConnection;\n  subscribedTopics: Set<string>;\n}\n\n/**\n * Server configuration (supports both immediate and deferred platforms)\n */\nexport interface ServerConfig {\n  /**\n   * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)\n   */\n  platform: AgentXPlatform | DeferredPlatformConfig;\n\n  /**\n   * LLM Driver factory function - creates Driver per Agent\n   */\n  createDriver: CreateDriver;\n\n  /**\n   * Port to listen on (standalone mode)\n   */\n  port?: number;\n\n  /**\n   * Host to bind to (default: \"0.0.0.0\")\n   */\n  host?: string;\n\n  /**\n   * Existing HTTP server to attach to (attached mode)\n   */\n  server?: import(\"@agentxjs/core/network\").MinimalHTTPServer;\n\n  /**\n   * WebSocket path when attached (default: \"/ws\")\n   */\n  wsPath?: string;\n\n  /**\n   * Enable debug logging\n   */\n  debug?: boolean;\n}\n\n/**\n * Create an AgentX server\n */\nexport async function createServer(config: ServerConfig): Promise<AgentXServer> {\n  const { wsPath = \"/ws\" } = config;\n\n  // Resolve deferred platform if needed\n  const platform: AgentXPlatform = isDeferredPlatform(config.platform)\n    ? await config.platform.resolve()\n    : config.platform;\n\n  // Create runtime from platform + driver\n  const runtime = createAgentXRuntime(platform, config.createDriver);\n\n  // Create WebSocket server\n  const wsServer = new WebSocketServer({\n    heartbeat: true,\n    heartbeatInterval: 30000,\n    debug: config.debug,\n  });\n\n  // Create command handler (no longer needs eventBus)\n  const commandHandler = new CommandHandler(runtime);\n\n  // Track connections\n  const connections = new Map<string, ConnectionState>();\n\n  /**\n   * Subscribe connection to a topic\n   */\n  function subscribeToTopic(connectionId: string, topic: string): void {\n    const state = connections.get(connectionId);\n    if (!state || state.subscribedTopics.has(topic)) return;\n\n    state.subscribedTopics.add(topic);\n    logger.debug(\"Connection subscribed to topic\", { connectionId, topic });\n  }\n\n  /**\n   * Check if event should be sent to connection based on subscriptions\n   */\n  function shouldSendToConnection(state: ConnectionState, event: BusEvent): boolean {\n    // Skip internal driver events\n    if (event.source === \"driver\" && event.intent !== \"notification\") {\n      return false;\n    }\n\n    // Skip command events (they are handled via RPC, not broadcast)\n    if (event.source === \"command\") {\n      return false;\n    }\n\n    // Check if subscribed to event's session\n    const eventWithContext = event as BusEvent & { context?: { sessionId?: string } };\n    const sessionId = eventWithContext.context?.sessionId;\n    if (sessionId && state.subscribedTopics.has(sessionId)) {\n      return true;\n    }\n\n    // Send to global subscribers\n    return state.subscribedTopics.has(\"global\");\n  }\n\n  /**\n   * Send JSON-RPC response to a specific connection\n   */\n  function sendResponse(connection: ChannelConnection, id: string | number, result: unknown): void {\n    const response = createSuccessResponse(id, result);\n    connection.send(JSON.stringify(response));\n  }\n\n  /**\n   * Send JSON-RPC error to a specific connection\n   */\n  function sendError(\n    connection: ChannelConnection,\n    id: string | number | null,\n    code: number,\n    message: string\n  ): void {\n    const response = createErrorResponse(id, code, message);\n    connection.send(JSON.stringify(response));\n  }\n\n  // Handle new connections\n  wsServer.onConnection((connection) => {\n    const state: ConnectionState = {\n      connection,\n      subscribedTopics: new Set([\"global\"]),\n    };\n    connections.set(connection.id, state);\n\n    logger.info(\"Client connected\", {\n      connectionId: connection.id,\n      totalConnections: connections.size,\n    });\n\n    // Handle messages from client\n    connection.onMessage(async (message) => {\n      try {\n        const parsed = parseMessage(message);\n\n        // Handle single message (not batch)\n        if (!Array.isArray(parsed)) {\n          await handleParsedMessage(connection, state, parsed);\n        } else {\n          // Handle batch (not common, but supported by JSON-RPC 2.0)\n          for (const item of parsed) {\n            await handleParsedMessage(connection, state, item);\n          }\n        }\n      } catch (err) {\n        logger.error(\"Failed to parse message\", { error: (err as Error).message });\n        sendError(connection, null, RpcErrorCodes.PARSE_ERROR, \"Parse error\");\n      }\n    });\n\n    // Cleanup on disconnect\n    connection.onClose(() => {\n      connections.delete(connection.id);\n      logger.info(\"Client disconnected\", {\n        connectionId: connection.id,\n        totalConnections: connections.size,\n      });\n    });\n  });\n\n  /**\n   * Handle a parsed JSON-RPC message\n   */\n  async function handleParsedMessage(\n    connection: ChannelConnection,\n    state: ConnectionState,\n    parsed: import(\"jsonrpc-lite\").IParsedObject\n  ): Promise<void> {\n    if (isRequest(parsed)) {\n      // JSON-RPC Request - handle and respond directly\n      const payload = parsed.payload as {\n        id: string | number;\n        method: string;\n        params: unknown;\n      };\n      const { id, method, params } = payload;\n\n      logger.debug(\"Received RPC request\", { id, method });\n\n      // Call command handler\n      const result = await commandHandler.handle(method as RpcMethod, params);\n\n      if (result.success) {\n        sendResponse(connection, id, result.data);\n      } else {\n        sendError(connection, id, result.code, result.message);\n      }\n    } else if (isNotification(parsed)) {\n      // JSON-RPC Notification - control messages\n      const payload = parsed.payload as {\n        method: string;\n        params: unknown;\n      };\n      const { method, params } = payload;\n\n      logger.debug(\"Received notification\", { method });\n\n      if (method === \"subscribe\") {\n        const { topic } = params as { topic: string };\n        subscribeToTopic(connection.id, topic);\n      } else if (method === \"unsubscribe\") {\n        const { topic } = params as { topic: string };\n        state.subscribedTopics.delete(topic);\n        logger.debug(\"Connection unsubscribed from topic\", { connectionId: connection.id, topic });\n      } else if (method === \"control.ack\") {\n        // ACK for reliable delivery - handled by network layer\n        logger.debug(\"Received ACK notification\");\n      }\n    } else {\n      // Invalid message\n      logger.warn(\"Received invalid JSON-RPC message\");\n    }\n  }\n\n  // Route internal events to connected clients as JSON-RPC notifications\n  platform.eventBus.onAny((event) => {\n    // Only broadcast broadcastable events\n    if (!shouldBroadcastEvent(event)) {\n      return;\n    }\n\n    // Get topic from event context\n    const eventWithContext = event as BusEvent & { context?: { sessionId?: string } };\n    const topic = eventWithContext.context?.sessionId || \"global\";\n\n    // Wrap as JSON-RPC notification\n    const notification = createStreamEvent(topic, event as SystemEvent);\n    const message = JSON.stringify(notification);\n\n    for (const [connectionId, state] of connections) {\n      if (shouldSendToConnection(state, event)) {\n        state.connection.sendReliable(message, {\n          timeout: 10000,\n          onTimeout: () => {\n            logger.warn(\"Event ACK timeout\", {\n              connectionId,\n              eventType: event.type,\n            });\n          },\n        });\n      }\n    }\n  });\n\n  /**\n   * Check if event should be broadcast\n   */\n  function shouldBroadcastEvent(event: BusEvent): boolean {\n    // Skip internal driver events\n    if (event.source === \"driver\" && event.intent !== \"notification\") {\n      return false;\n    }\n\n    // Skip command events (handled via RPC)\n    if (event.source === \"command\") {\n      return false;\n    }\n\n    // Check broadcastable flag\n    const systemEvent = event as SystemEvent;\n    if (systemEvent.broadcastable === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  // Attach to existing server if provided\n  if (config.server) {\n    wsServer.attach(config.server, wsPath);\n    logger.info(\"WebSocket attached to existing server\", { path: wsPath });\n  }\n\n  return {\n    async listen(port?: number, host?: string) {\n      if (config.server) {\n        throw new Error(\n          \"Cannot listen when attached to existing server. The server should call listen() instead.\"\n        );\n      }\n\n      const listenPort = port ?? config.port ?? 5200;\n      const listenHost = host ?? config.host ?? \"0.0.0.0\";\n\n      await wsServer.listen(listenPort, listenHost);\n      logger.info(\"Server listening\", { port: listenPort, host: listenHost });\n    },\n\n    async close() {\n      await wsServer.close();\n      logger.info(\"Server closed\");\n    },\n\n    async dispose() {\n      // Cleanup in order\n      await wsServer.dispose();\n      commandHandler.dispose();\n      await runtime.shutdown();\n      logger.info(\"Server disposed\");\n    },\n  };\n}\n","/**\n * CommandHandler - Handles JSON-RPC requests directly\n *\n * No longer uses EventBus for request/response. Instead:\n * - Receives RPC requests directly\n * - Returns RPC responses directly\n * - EventBus is only used for stream events (notifications)\n */\n\nimport type { AgentXRuntime } from \"@agentxjs/core/runtime\";\nimport type { UserContentPart } from \"@agentxjs/core/agent\";\nimport type { RpcMethod } from \"@agentxjs/core/network\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"server/CommandHandler\");\n\n/**\n * RPC Result type\n */\nexport interface RpcResult<T = unknown> {\n  success: true;\n  data: T;\n}\n\nexport interface RpcError {\n  success: false;\n  code: number;\n  message: string;\n}\n\nexport type RpcResponse<T = unknown> = RpcResult<T> | RpcError;\n\n/**\n * Helper to create success result\n */\nfunction ok<T>(data: T): RpcResult<T> {\n  return { success: true, data };\n}\n\n/**\n * Helper to create error result\n */\nfunction err(code: number, message: string): RpcError {\n  return { success: false, code, message };\n}\n\n/**\n * CommandHandler - Processes RPC requests directly\n */\nexport class CommandHandler {\n  private readonly runtime: AgentXRuntime;\n\n  constructor(runtime: AgentXRuntime) {\n    this.runtime = runtime;\n    logger.debug(\"CommandHandler created\");\n  }\n\n  /**\n   * Handle an RPC request and return response\n   */\n  async handle(method: RpcMethod, params: unknown): Promise<RpcResponse> {\n    logger.debug(\"Handling RPC request\", { method });\n\n    try {\n      switch (method) {\n        // Container\n        case \"container.create\":\n          return await this.handleContainerCreate(params);\n        case \"container.get\":\n          return await this.handleContainerGet(params);\n        case \"container.list\":\n          return await this.handleContainerList(params);\n\n        // Image\n        case \"image.create\":\n          return await this.handleImageCreate(params);\n        case \"image.get\":\n          return await this.handleImageGet(params);\n        case \"image.list\":\n          return await this.handleImageList(params);\n        case \"image.delete\":\n          return await this.handleImageDelete(params);\n        case \"image.run\":\n          return await this.handleImageRun(params);\n        case \"image.stop\":\n          return await this.handleImageStop(params);\n        case \"image.update\":\n          return await this.handleImageUpdate(params);\n        case \"image.messages\":\n          return await this.handleImageMessages(params);\n\n        // Agent\n        case \"agent.get\":\n          return await this.handleAgentGet(params);\n        case \"agent.list\":\n          return await this.handleAgentList(params);\n        case \"agent.destroy\":\n          return await this.handleAgentDestroy(params);\n        case \"agent.destroyAll\":\n          return await this.handleAgentDestroyAll(params);\n        case \"agent.interrupt\":\n          return await this.handleAgentInterrupt(params);\n\n        // Message\n        case \"message.send\":\n          return await this.handleMessageSend(params);\n\n        default:\n          return err(-32601, `Method not found: ${method}`);\n      }\n    } catch (error) {\n      logger.error(\"RPC handler error\", { method, error });\n      return err(-32000, error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  // ==================== Container Commands ====================\n\n  private async handleContainerCreate(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const { getOrCreateContainer } = await import(\"@agentxjs/core/container\");\n    const { containerRepository, imageRepository, sessionRepository } = this.runtime.platform;\n\n    const container = await getOrCreateContainer(containerId, {\n      containerRepository,\n      imageRepository,\n      sessionRepository,\n    });\n\n    return ok({ containerId: container.containerId });\n  }\n\n  private async handleContainerGet(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const exists = await this.runtime.platform.containerRepository.containerExists(containerId);\n    return ok({ containerId, exists });\n  }\n\n  private async handleContainerList(_params: unknown): Promise<RpcResponse> {\n    const containers = await this.runtime.platform.containerRepository.findAllContainers();\n    return ok({ containerIds: containers.map((c) => c.containerId) });\n  }\n\n  // ==================== Image Commands ====================\n\n  private async handleImageCreate(params: unknown): Promise<RpcResponse> {\n    const { containerId, name, description, systemPrompt, mcpServers, customData } = params as {\n      containerId: string;\n      name?: string;\n      description?: string;\n      systemPrompt?: string;\n      mcpServers?: Record<string, unknown>;\n      customData?: Record<string, unknown>;\n    };\n\n    const { imageRepository, sessionRepository } = this.runtime.platform;\n    const { createImage } = await import(\"@agentxjs/core/image\");\n\n    const image = await createImage(\n      { containerId, name, description, systemPrompt, mcpServers: mcpServers as any, customData },\n      { imageRepository, sessionRepository }\n    );\n\n    return ok({\n      record: image.toRecord(),\n      __subscriptions: [image.sessionId],\n    });\n  }\n\n  private async handleImageGet(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n    const record = await this.runtime.platform.imageRepository.findImageById(imageId);\n    return ok({\n      record,\n      __subscriptions: record?.sessionId ? [record.sessionId] : undefined,\n    });\n  }\n\n  private async handleImageList(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId?: string };\n    const records = containerId\n      ? await this.runtime.platform.imageRepository.findImagesByContainerId(containerId)\n      : await this.runtime.platform.imageRepository.findAllImages();\n\n    return ok({\n      records,\n      __subscriptions: records.map((r) => r.sessionId),\n    });\n  }\n\n  private async handleImageDelete(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n    const { loadImage } = await import(\"@agentxjs/core/image\");\n    const { imageRepository, sessionRepository } = this.runtime.platform;\n\n    const image = await loadImage(imageId, { imageRepository, sessionRepository });\n    if (image) {\n      await image.delete();\n    }\n\n    return ok({ imageId });\n  }\n\n  private async handleImageRun(params: unknown): Promise<RpcResponse> {\n    const { imageId, agentId: requestedAgentId } = params as {\n      imageId: string;\n      agentId?: string;\n    };\n\n    // Check if already have a running agent for this image\n    const existingAgent = this.runtime\n      .getAgents()\n      .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n    if (existingAgent) {\n      logger.debug(\"Reusing existing agent for image\", {\n        imageId,\n        agentId: existingAgent.agentId,\n      });\n      return ok({\n        imageId,\n        agentId: existingAgent.agentId,\n        sessionId: existingAgent.sessionId,\n        containerId: existingAgent.containerId,\n        reused: true,\n      });\n    }\n\n    // Create new agent (with optional custom agentId)\n    const agent = await this.runtime.createAgent({\n      imageId,\n      agentId: requestedAgentId,\n    });\n    logger.info(\"Created new agent for image\", {\n      imageId,\n      agentId: agent.agentId,\n    });\n\n    return ok({\n      imageId,\n      agentId: agent.agentId,\n      sessionId: agent.sessionId,\n      containerId: agent.containerId,\n      reused: false,\n    });\n  }\n\n  private async handleImageStop(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n\n    // Find running agent for this image\n    const agent = this.runtime\n      .getAgents()\n      .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n    if (agent) {\n      await this.runtime.stopAgent(agent.agentId);\n      logger.info(\"Stopped agent for image\", { imageId, agentId: agent.agentId });\n    } else {\n      logger.debug(\"No running agent found for image\", { imageId });\n    }\n\n    return ok({ imageId });\n  }\n\n  private async handleImageUpdate(params: unknown): Promise<RpcResponse> {\n    const { imageId, updates } = params as {\n      imageId: string;\n      updates: { name?: string; description?: string; customData?: Record<string, unknown> };\n    };\n\n    // Get existing image\n    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      return err(404, `Image not found: ${imageId}`);\n    }\n\n    // Update image record\n    const updatedRecord = {\n      ...imageRecord,\n      ...updates,\n      updatedAt: Date.now(),\n    };\n\n    await this.runtime.platform.imageRepository.saveImage(updatedRecord);\n\n    logger.info(\"Updated image\", { imageId, updates });\n\n    return ok({ record: updatedRecord });\n  }\n\n  private async handleImageMessages(params: unknown): Promise<RpcResponse> {\n    const { imageId } = params as { imageId: string };\n\n    // Get image record to find sessionId\n    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      return err(404, `Image not found: ${imageId}`);\n    }\n\n    // Get messages from session\n    const messages = await this.runtime.platform.sessionRepository.getMessages(\n      imageRecord.sessionId\n    );\n\n    logger.debug(\"Got messages for image\", { imageId, count: messages.length });\n\n    return ok({ imageId, messages });\n  }\n\n  // ==================== Agent Commands ====================\n\n  private async handleAgentGet(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n    const agent = this.runtime.getAgent(agentId);\n\n    return ok({\n      agent: agent\n        ? {\n            agentId: agent.agentId,\n            imageId: agent.imageId,\n            containerId: agent.containerId,\n            sessionId: agent.sessionId,\n            lifecycle: agent.lifecycle,\n          }\n        : null,\n      exists: !!agent,\n    });\n  }\n\n  private async handleAgentList(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId?: string };\n    const agents = containerId\n      ? this.runtime.getAgentsByContainer(containerId)\n      : this.runtime.getAgents();\n\n    return ok({\n      agents: agents.map((a) => ({\n        agentId: a.agentId,\n        imageId: a.imageId,\n        containerId: a.containerId,\n        sessionId: a.sessionId,\n        lifecycle: a.lifecycle,\n      })),\n    });\n  }\n\n  private async handleAgentDestroy(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n\n    // Check if agent exists first\n    const agent = this.runtime.getAgent(agentId);\n    if (!agent) {\n      return ok({ agentId, success: false });\n    }\n\n    await this.runtime.destroyAgent(agentId);\n    return ok({ agentId, success: true });\n  }\n\n  private async handleAgentDestroyAll(params: unknown): Promise<RpcResponse> {\n    const { containerId } = params as { containerId: string };\n    const agents = this.runtime.getAgentsByContainer(containerId);\n    for (const agent of agents) {\n      await this.runtime.destroyAgent(agent.agentId);\n    }\n    return ok({ containerId });\n  }\n\n  private async handleAgentInterrupt(params: unknown): Promise<RpcResponse> {\n    const { agentId } = params as { agentId: string };\n    this.runtime.interrupt(agentId);\n    return ok({ agentId });\n  }\n\n  // ==================== Message Commands ====================\n\n  private async handleMessageSend(params: unknown): Promise<RpcResponse> {\n    const { agentId, imageId, content } = params as {\n      agentId?: string;\n      imageId?: string;\n      content: string | UserContentPart[];\n    };\n\n    let targetAgentId: string;\n\n    if (agentId) {\n      // Direct agent reference\n      targetAgentId = agentId;\n    } else if (imageId) {\n      // Auto-activate image: find or create agent\n      const existingAgent = this.runtime\n        .getAgents()\n        .find((a) => a.imageId === imageId && a.lifecycle === \"running\");\n\n      if (existingAgent) {\n        targetAgentId = existingAgent.agentId;\n        logger.debug(\"Using existing agent for message\", {\n          imageId,\n          agentId: targetAgentId,\n        });\n      } else {\n        // Create new agent for this image\n        const agent = await this.runtime.createAgent({ imageId });\n        targetAgentId = agent.agentId;\n        logger.info(\"Auto-created agent for message\", {\n          imageId,\n          agentId: targetAgentId,\n        });\n      }\n    } else {\n      return err(-32602, \"Either agentId or imageId is required\");\n    }\n\n    await this.runtime.receive(targetAgentId, content);\n    return ok({ agentId: targetAgentId, imageId });\n  }\n\n  // ==================== Lifecycle ====================\n\n  dispose(): void {\n    logger.debug(\"CommandHandler disposed\");\n  }\n}\n"],"mappings":"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","names":["createLogger","logger","createLogger","err"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentxjs/server",
-  "version": "1.9.10-dev",
-  "description": "AgentX Server - WebSocket server with Provider support",
+  "version": "2.0.0",
+  "description": "AgentX Server - WebSocket server with Platform support",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -24,12 +24,12 @@
     "build": "tsup",
     "dev": "bun run bin/server.ts",
     "typecheck": "tsc --noEmit",
-    "test": "bun test"
+    "test": "echo 'No tests yet'"
   },
   "dependencies": {
-    "@agentxjs/core": "1.9.10-dev",
-    "@agentxjs/node-provider": "1.9.10-dev",
-    "@agentxjs/claude-driver": "1.9.10-dev",
+    "@agentxjs/core": "^2.0.0",
+    "@agentxjs/node-platform": "^2.0.0",
+    "@agentxjs/mono-driver": "^2.0.0",
     "commonxjs": "^0.1.1"
   },
   "devDependencies": {

package/src/CommandHandler.ts

@@ -119,7 +119,7 @@ export class CommandHandler {
   private async handleContainerCreate(params: unknown): Promise<RpcResponse> {
     const { containerId } = params as { containerId: string };
     const { getOrCreateContainer } = await import("@agentxjs/core/container");
-    const { containerRepository, imageRepository, sessionRepository } = this.runtime.provider;
+    const { containerRepository, imageRepository, sessionRepository } = this.runtime.platform;
 
     const container = await getOrCreateContainer(containerId, {
       containerRepository,
@@ -132,31 +132,32 @@ export class CommandHandler {
 
   private async handleContainerGet(params: unknown): Promise<RpcResponse> {
     const { containerId } = params as { containerId: string };
-    const exists = await this.runtime.provider.containerRepository.containerExists(containerId);
+    const exists = await this.runtime.platform.containerRepository.containerExists(containerId);
     return ok({ containerId, exists });
   }
 
   private async handleContainerList(_params: unknown): Promise<RpcResponse> {
-    const containers = await this.runtime.provider.containerRepository.findAllContainers();
+    const containers = await this.runtime.platform.containerRepository.findAllContainers();
     return ok({ containerIds: containers.map((c) => c.containerId) });
   }
 
   // ==================== Image Commands ====================
 
   private async handleImageCreate(params: unknown): Promise<RpcResponse> {
-    const { containerId, name, description, systemPrompt, mcpServers } = params as {
+    const { containerId, name, description, systemPrompt, mcpServers, customData } = params as {
       containerId: string;
       name?: string;
       description?: string;
       systemPrompt?: string;
       mcpServers?: Record<string, unknown>;
+      customData?: Record<string, unknown>;
     };
 
-    const { imageRepository, sessionRepository } = this.runtime.provider;
+    const { imageRepository, sessionRepository } = this.runtime.platform;
     const { createImage } = await import("@agentxjs/core/image");
 
     const image = await createImage(
-      { containerId, name, description, systemPrompt, mcpServers: mcpServers as any },
+      { containerId, name, description, systemPrompt, mcpServers: mcpServers as any, customData },
       { imageRepository, sessionRepository }
     );
 
@@ -168,7 +169,7 @@ export class CommandHandler {
 
   private async handleImageGet(params: unknown): Promise<RpcResponse> {
     const { imageId } = params as { imageId: string };
-    const record = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const record = await this.runtime.platform.imageRepository.findImageById(imageId);
     return ok({
       record,
       __subscriptions: record?.sessionId ? [record.sessionId] : undefined,
@@ -178,8 +179,8 @@ export class CommandHandler {
   private async handleImageList(params: unknown): Promise<RpcResponse> {
     const { containerId } = params as { containerId?: string };
     const records = containerId
-      ? await this.runtime.provider.imageRepository.findImagesByContainerId(containerId)
-      : await this.runtime.provider.imageRepository.findAllImages();
+      ? await this.runtime.platform.imageRepository.findImagesByContainerId(containerId)
+      : await this.runtime.platform.imageRepository.findAllImages();
 
     return ok({
       records,
@@ -190,7 +191,7 @@ export class CommandHandler {
   private async handleImageDelete(params: unknown): Promise<RpcResponse> {
     const { imageId } = params as { imageId: string };
     const { loadImage } = await import("@agentxjs/core/image");
-    const { imageRepository, sessionRepository } = this.runtime.provider;
+    const { imageRepository, sessionRepository } = this.runtime.platform;
 
     const image = await loadImage(imageId, { imageRepository, sessionRepository });
     if (image) {
@@ -265,11 +266,11 @@ export class CommandHandler {
   private async handleImageUpdate(params: unknown): Promise<RpcResponse> {
     const { imageId, updates } = params as {
       imageId: string;
-      updates: { name?: string; description?: string };
+      updates: { name?: string; description?: string; customData?: Record<string, unknown> };
     };
 
     // Get existing image
-    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);
     if (!imageRecord) {
       return err(404, `Image not found: ${imageId}`);
     }
@@ -281,7 +282,7 @@ export class CommandHandler {
       updatedAt: Date.now(),
     };
 
-    await this.runtime.provider.imageRepository.saveImage(updatedRecord);
+    await this.runtime.platform.imageRepository.saveImage(updatedRecord);
 
     logger.info("Updated image", { imageId, updates });
 
@@ -292,13 +293,13 @@ export class CommandHandler {
     const { imageId } = params as { imageId: string };
 
     // Get image record to find sessionId
-    const imageRecord = await this.runtime.provider.imageRepository.findImageById(imageId);
+    const imageRecord = await this.runtime.platform.imageRepository.findImageById(imageId);
     if (!imageRecord) {
       return err(404, `Image not found: ${imageId}`);
     }
 
     // Get messages from session
-    const messages = await this.runtime.provider.sessionRepository.getMessages(
+    const messages = await this.runtime.platform.sessionRepository.getMessages(
       imageRecord.sessionId
     );
 

package/src/Server.ts

@@ -11,7 +11,8 @@
  * - RPC Notification (no id): Server → Client (stream events)
  */
 
-import type { AgentXProvider } from "@agentxjs/core/runtime";
+import type { AgentXPlatform } from "@agentxjs/core/runtime";
+import type { CreateDriver } from "@agentxjs/core/driver";
 import type { ChannelConnection } from "@agentxjs/core/network";
 import type { BusEvent, SystemEvent } from "@agentxjs/core/event";
 import { createAgentXRuntime } from "@agentxjs/core/runtime";
@@ -27,9 +28,9 @@ import {
 } from "@agentxjs/core/network";
 import {
   WebSocketServer,
-  isDeferredProvider,
-  type DeferredProviderConfig,
-} from "@agentxjs/node-provider";
+  isDeferredPlatform,
+  type DeferredPlatformConfig,
+} from "@agentxjs/node-platform";
 import { createLogger } from "commonxjs/logger";
 import { CommandHandler } from "./CommandHandler";
 import type { AgentXServer } from "./types";
@@ -45,13 +46,18 @@ interface ConnectionState {
 }
 
 /**
- * Server configuration (supports both immediate and deferred providers)
+ * Server configuration (supports both immediate and deferred platforms)
  */
 export interface ServerConfig {
   /**
-   * AgentX Provider (can be AgentXProvider or DeferredProviderConfig)
+   * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)
    */
-  provider: AgentXProvider | DeferredProviderConfig;
+  platform: AgentXPlatform | DeferredPlatformConfig;
+
+  /**
+   * LLM Driver factory function - creates Driver per Agent
+   */
+  createDriver: CreateDriver;
 
   /**
    * Port to listen on (standalone mode)
@@ -85,13 +91,13 @@ export interface ServerConfig {
 export async function createServer(config: ServerConfig): Promise<AgentXServer> {
   const { wsPath = "/ws" } = config;
 
-  // Resolve deferred provider if needed
-  const provider: AgentXProvider = isDeferredProvider(config.provider)
-    ? await config.provider.resolve()
-    : config.provider;
+  // Resolve deferred platform if needed
+  const platform: AgentXPlatform = isDeferredPlatform(config.platform)
+    ? await config.platform.resolve()
+    : config.platform;
 
-  // Create runtime from provider
-  const runtime = createAgentXRuntime(provider);
+  // Create runtime from platform + driver
+  const runtime = createAgentXRuntime(platform, config.createDriver);
 
   // Create WebSocket server
   const wsServer = new WebSocketServer({
@@ -261,7 +267,7 @@ export async function createServer(config: ServerConfig): Promise<AgentXServer>
   }
 
   // Route internal events to connected clients as JSON-RPC notifications
-  provider.eventBus.onAny((event) => {
+  platform.eventBus.onAny((event) => {
     // Only broadcast broadcastable events
     if (!shouldBroadcastEvent(event)) {
       return;

package/src/index.ts

@@ -1,36 +1,22 @@
 /**
  * @agentxjs/server
  *
- * AgentX Server - WebSocket server with Provider support.
+ * AgentX Server - WebSocket server with Platform support.
  *
  * @example
  * ```typescript
  * import { createServer } from "@agentxjs/server";
- * import { nodeProvider } from "@agentxjs/node-provider";
- * import { claudeDriver } from "@agentxjs/claude-driver";
+ * import { nodePlatform } from "@agentxjs/node-platform";
+ * import { createMonoDriver } from "@agentxjs/mono-driver";
  *
  * const server = await createServer({
- *   provider: nodeProvider({
- *     dataPath: "./data",
- *     driver: claudeDriver({ apiKey: process.env.ANTHROPIC_API_KEY }),
- *   }),
+ *   platform: nodePlatform({ dataPath: "./data" }),
+ *   createDriver: createMonoDriver,
  *   port: 5200,
  * });
  *
  * await server.listen();
  * console.log("Server listening on ws://localhost:5200");
- *
- * // Attach to existing HTTP server
- * import { createServer as createHttpServer } from "node:http";
- *
- * const httpServer = createHttpServer();
- * const agentxServer = await createServer({
- *   provider: nodeProvider({ ... }),
- *   server: httpServer,
- *   wsPath: "/ws",
- * });
- *
- * httpServer.listen(3000);
  * ```
  */