@agentxjs/server 2.0.0 → 2.0.2

package/bin/server.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env bun
+
 /**
  * AgentX Server - Standalone server startup script
  *
@@ -14,11 +15,11 @@
  *   LOG_LEVEL - Log level: debug/info/warn/error (default: info)
  */
 
-import { createServer } from "../src";
-import { nodePlatform } from "@agentxjs/node-platform";
-import { createMonoDriver } from "@agentxjs/mono-driver";
 import type { CreateDriver } from "@agentxjs/core/driver";
+import { createMonoDriver } from "@agentxjs/mono-driver";
+import { nodePlatform } from "@agentxjs/node-platform";
 import { createLogger } from "commonxjs/logger";
+import { createServer } from "../src";
 
 const logger = createLogger("server/bin");
 

package/dist/index.d.ts

@@ -1,9 +1,61 @@
 import * as _agentxjs_core_network from '@agentxjs/core/network';
 import { RpcMethod } from '@agentxjs/core/network';
-import { AgentXPlatform, AgentXRuntime } from '@agentxjs/core/runtime';
+import { AgentXRuntime, AgentXPlatform } from '@agentxjs/core/runtime';
 import { CreateDriver } from '@agentxjs/core/driver';
 import { DeferredPlatformConfig } from '@agentxjs/node-platform';
 
+/**
+ * CommandHandler - Handles JSON-RPC requests directly
+ *
+ * No longer uses EventBus for request/response. Instead:
+ * - Receives RPC requests directly
+ * - Returns RPC responses directly
+ * - EventBus is only used for stream events (notifications)
+ */
+
+/**
+ * RPC Result type
+ */
+interface RpcResult<T = unknown> {
+    success: true;
+    data: T;
+}
+interface RpcError {
+    success: false;
+    code: number;
+    message: string;
+}
+type RpcResponse<T = unknown> = RpcResult<T> | RpcError;
+/**
+ * CommandHandler - Processes RPC requests directly
+ */
+declare class CommandHandler {
+    private readonly runtime;
+    constructor(runtime: AgentXRuntime);
+    /**
+     * Handle an RPC request and return response
+     */
+    handle(method: RpcMethod, params: unknown): Promise<RpcResponse>;
+    private handleContainerCreate;
+    private handleContainerGet;
+    private handleContainerList;
+    private handleImageCreate;
+    private handleImageGet;
+    private handleImageList;
+    private handleImageDelete;
+    private handleImageRun;
+    private handleImageStop;
+    private handleImageUpdate;
+    private handleImageMessages;
+    private handleAgentGet;
+    private handleAgentList;
+    private handleAgentDestroy;
+    private handleAgentDestroyAll;
+    private handleAgentInterrupt;
+    private handleMessageSend;
+    dispose(): void;
+}
+
 /**
  * Server Types
  */
@@ -31,6 +83,8 @@ interface AgentXServer {
 interface ServerConfig {
     /**
      * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)
+     *
+     * Must provide `channelServer` for accepting WebSocket connections.
      */
     platform: AgentXPlatform | DeferredPlatformConfig;
     /**
@@ -63,56 +117,4 @@ interface ServerConfig {
  */
 declare function createServer(config: ServerConfig): Promise<AgentXServer>;
 
-/**
- * CommandHandler - Handles JSON-RPC requests directly
- *
- * No longer uses EventBus for request/response. Instead:
- * - Receives RPC requests directly
- * - Returns RPC responses directly
- * - EventBus is only used for stream events (notifications)
- */
-
-/**
- * RPC Result type
- */
-interface RpcResult<T = unknown> {
-    success: true;
-    data: T;
-}
-interface RpcError {
-    success: false;
-    code: number;
-    message: string;
-}
-type RpcResponse<T = unknown> = RpcResult<T> | RpcError;
-/**
- * CommandHandler - Processes RPC requests directly
- */
-declare class CommandHandler {
-    private readonly runtime;
-    constructor(runtime: AgentXRuntime);
-    /**
-     * Handle an RPC request and return response
-     */
-    handle(method: RpcMethod, params: unknown): Promise<RpcResponse>;
-    private handleContainerCreate;
-    private handleContainerGet;
-    private handleContainerList;
-    private handleImageCreate;
-    private handleImageGet;
-    private handleImageList;
-    private handleImageDelete;
-    private handleImageRun;
-    private handleImageStop;
-    private handleImageUpdate;
-    private handleImageMessages;
-    private handleAgentGet;
-    private handleAgentList;
-    private handleAgentDestroy;
-    private handleAgentDestroyAll;
-    private handleAgentInterrupt;
-    private handleMessageSend;
-    dispose(): void;
-}
-
 export { type AgentXServer, CommandHandler, type ServerConfig, createServer };

package/dist/index.js

@@ -1,20 +1,3 @@
-// src/Server.ts
-import { createAgentXRuntime } from "@agentxjs/core/runtime";
-import {
-  parseMessage,
-  isRequest,
-  isNotification,
-  createSuccessResponse,
-  createErrorResponse,
-  createStreamEvent,
-  RpcErrorCodes
-} from "@agentxjs/core/network";
-import {
-  WebSocketServer,
-  isDeferredPlatform
-} from "@agentxjs/node-platform";
-import { createLogger as createLogger2 } from "commonxjs/logger";
-
 // src/CommandHandler.ts
 import { createLogger } from "commonxjs/logger";
 var logger = createLogger("server/CommandHandler");
@@ -299,16 +282,27 @@ var CommandHandler = class {
 };
 
 // src/Server.ts
+import {
+  createErrorResponse,
+  createStreamEvent,
+  createSuccessResponse,
+  isNotification,
+  isRequest,
+  parseMessage,
+  RpcErrorCodes
+} from "@agentxjs/core/network";
+import { createAgentXRuntime } from "@agentxjs/core/runtime";
+import { isDeferredPlatform } from "@agentxjs/node-platform";
+import { createLogger as createLogger2 } from "commonxjs/logger";
 var logger2 = createLogger2("server/Server");
 async function createServer(config) {
   const { wsPath = "/ws" } = config;
   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,
-    debug: config.debug
-  });
+  const wsServer = platform.channelServer;
+  if (!wsServer) {
+    throw new Error("Platform must provide channelServer for server mode");
+  }
   const commandHandler = new CommandHandler(runtime);
   const connections = /* @__PURE__ */ new Map();
   function subscribeToTopic(connectionId, topic) {

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 { 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"]}
+{"version":3,"sources":["../src/CommandHandler.ts","../src/Server.ts"],"sourcesContent":["/**\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 { UserContentPart } from \"@agentxjs/core/agent\";\nimport type { RpcMethod } from \"@agentxjs/core/network\";\nimport type { AgentXRuntime } from \"@agentxjs/core/runtime\";\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","/**\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 { CreateDriver } from \"@agentxjs/core/driver\";\nimport type { BusEvent, SystemEvent } from \"@agentxjs/core/event\";\nimport type { ChannelConnection } from \"@agentxjs/core/network\";\nimport {\n  createErrorResponse,\n  createStreamEvent,\n  createSuccessResponse,\n  isNotification,\n  isRequest,\n  parseMessage,\n  RpcErrorCodes,\n  type RpcMethod,\n} from \"@agentxjs/core/network\";\nimport type { AgentXPlatform } from \"@agentxjs/core/runtime\";\nimport { createAgentXRuntime } from \"@agentxjs/core/runtime\";\nimport { type DeferredPlatformConfig, isDeferredPlatform } 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   * Must provide `channelServer` for accepting WebSocket connections.\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  // Get channel server from platform\n  const wsServer = platform.channelServer;\n  if (!wsServer) {\n    throw new Error(\"Platform must provide channelServer for server mode\");\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"],"mappings":"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","names":["createLogger","logger","createLogger","err"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/server",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "AgentX Server - WebSocket server with Platform support",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,9 +27,9 @@
     "test": "echo 'No tests yet'"
   },
   "dependencies": {
-    "@agentxjs/core": "^2.0.0",
-    "@agentxjs/node-platform": "^2.0.0",
-    "@agentxjs/mono-driver": "^2.0.0",
+    "@agentxjs/core": "^2.0.2",
+    "@agentxjs/node-platform": "^2.0.2",
+    "@agentxjs/mono-driver": "^2.0.2",
     "commonxjs": "^0.1.1"
   },
   "devDependencies": {

package/src/CommandHandler.ts

@@ -7,9 +7,9 @@
  * - EventBus is only used for stream events (notifications)
  */
 
-import type { AgentXRuntime } from "@agentxjs/core/runtime";
 import type { UserContentPart } from "@agentxjs/core/agent";
 import type { RpcMethod } from "@agentxjs/core/network";
+import type { AgentXRuntime } from "@agentxjs/core/runtime";
 import { createLogger } from "commonxjs/logger";
 
 const logger = createLogger("server/CommandHandler");

package/src/Server.ts

@@ -11,26 +11,22 @@
  * - RPC Notification (no id): Server → Client (stream events)
  */
 
-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";
+import type { ChannelConnection } from "@agentxjs/core/network";
 import {
-  parseMessage,
-  isRequest,
-  isNotification,
-  createSuccessResponse,
   createErrorResponse,
   createStreamEvent,
+  createSuccessResponse,
+  isNotification,
+  isRequest,
+  parseMessage,
   RpcErrorCodes,
   type RpcMethod,
 } from "@agentxjs/core/network";
-import {
-  WebSocketServer,
-  isDeferredPlatform,
-  type DeferredPlatformConfig,
-} from "@agentxjs/node-platform";
+import type { AgentXPlatform } from "@agentxjs/core/runtime";
+import { createAgentXRuntime } from "@agentxjs/core/runtime";
+import { type DeferredPlatformConfig, isDeferredPlatform } from "@agentxjs/node-platform";
 import { createLogger } from "commonxjs/logger";
 import { CommandHandler } from "./CommandHandler";
 import type { AgentXServer } from "./types";
@@ -51,6 +47,8 @@ interface ConnectionState {
 export interface ServerConfig {
   /**
    * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)
+   *
+   * Must provide `channelServer` for accepting WebSocket connections.
    */
   platform: AgentXPlatform | DeferredPlatformConfig;
 
@@ -99,12 +97,11 @@ export async function createServer(config: ServerConfig): Promise<AgentXServer>
   // Create runtime from platform + driver
   const runtime = createAgentXRuntime(platform, config.createDriver);
 
-  // Create WebSocket server
-  const wsServer = new WebSocketServer({
-    heartbeat: true,
-    heartbeatInterval: 30000,
-    debug: config.debug,
-  });
+  // Get channel server from platform
+  const wsServer = platform.channelServer;
+  if (!wsServer) {
+    throw new Error("Platform must provide channelServer for server mode");
+  }
 
   // Create command handler (no longer needs eventBus)
   const commandHandler = new CommandHandler(runtime);

package/src/index.ts

@@ -20,6 +20,6 @@
  * ```
  */
 
+export { CommandHandler } from "./CommandHandler";
 export { createServer, type ServerConfig } from "./Server";
 export type { AgentXServer } from "./types";
-export { CommandHandler } from "./CommandHandler";