@agentxjs/core 2.0.1 → 3.0.0

package/dist/network/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ControlAckParams, N as NotificationMethod, y as RpcClient, w as RpcClientConfig, x as RpcClientState, u as RpcErrorCodes, R as RpcErrorResponse, a as RpcMethod, b as RpcNotification, c as RpcRequest, d as RpcSuccessResponse, S as StreamEventParams, W as WebSocketFactory, e as createAckNotification, f as createErrorResponse, g as createNotification, h as createRequest, i as createStreamEvent, j as createSuccessResponse, k as eventTypeToRpcMethod, l as isControlAck, m as isErrorResponse, n as isInvalid, o as isNotification, p as isRequest, q as isStreamEvent, r as isSuccessResponse, s as parseMessage, t as parseMessageObject, v as rpcMethodToResponseType } from '../RpcClient-CMdhJxjS.js';
+export { A as ChannelClient, w as ChannelClientFactory, B as ChannelClientOptions, D as ChannelClientProvider, E as ChannelConnection, F as ChannelServer, G as ChannelServerOptions, H as ChannelServerProvider, I as ConnectionState, C as ControlAckParams, M as MinimalHTTPServer, N as NotificationMethod, z as RpcClient, x as RpcClientConfig, y as RpcClientState, u as RpcErrorCodes, R as RpcErrorResponse, a as RpcMethod, b as RpcNotification, c as RpcRequest, d as RpcSuccessResponse, J as SendReliableOptions, S as StreamEventParams, U as Unsubscribe, e as createAckNotification, f as createErrorResponse, g as createNotification, h as createRequest, i as createStreamEvent, j as createSuccessResponse, k as eventTypeToRpcMethod, l as isControlAck, m as isErrorResponse, n as isInvalid, o as isNotification, p as isRequest, q as isStreamEvent, r as isSuccessResponse, s as parseMessage, t as parseMessageObject, v as rpcMethodToResponseType } from '../types-CTV8Z9PI.js';
 export { JsonRpcError } from 'jsonrpc-lite';
 import '../base-m40r3Qgu.js';
 
@@ -58,222 +58,4 @@ declare function unwrapMessage(wrapper: ReliableWrapper): string;
  */
 declare function generateMessageId(): string;
 
-/**
- * Network Types - Channel interfaces for client-server communication
- *
- * Provides transport-agnostic interfaces that can be implemented with:
- * - WebSocket (Node.js, Browser)
- * - Durable Objects WebSocket (Cloudflare Workers)
- * - HTTP/2, gRPC, etc.
- */
-/**
- * Unsubscribe function type
- */
-type Unsubscribe = () => void;
-/**
- * Minimal HTTP server interface for attaching WebSocket
- * Avoids Node.js dependency in types package
- */
-interface MinimalHTTPServer {
-    on(event: "upgrade", listener: (request: unknown, socket: unknown, head: unknown) => void): void;
-}
-/**
- * Options for reliable message sending
- */
-interface SendReliableOptions {
-    /**
-     * Callback when client acknowledges receipt
-     */
-    onAck?: () => void;
-    /**
-     * Timeout in milliseconds (default: 5000)
-     */
-    timeout?: number;
-    /**
-     * Callback when ACK times out
-     */
-    onTimeout?: () => void;
-}
-/**
- * ChannelConnection - Server-side representation of a client connection
- */
-interface ChannelConnection {
-    /**
-     * Unique connection ID
-     */
-    readonly id: string;
-    /**
-     * Send message to this client (fire-and-forget)
-     */
-    send(message: string): void;
-    /**
-     * Send message with acknowledgment
-     *
-     * The message is wrapped with a unique ID. Client automatically sends ACK
-     * when received. Server triggers onAck callback upon receiving ACK.
-     *
-     * This is handled transparently by the Network layer.
-     */
-    sendReliable(message: string, options?: SendReliableOptions): void;
-    /**
-     * Register message handler
-     */
-    onMessage(handler: (message: string) => void): Unsubscribe;
-    /**
-     * Register close handler
-     */
-    onClose(handler: () => void): Unsubscribe;
-    /**
-     * Register error handler
-     */
-    onError(handler: (error: Error) => void): Unsubscribe;
-    /**
-     * Close this connection
-     */
-    close(): void;
-}
-/**
- * ChannelServer - Accepts client connections
- */
-interface ChannelServer {
-    /**
-     * Start listening on a port (standalone mode)
-     */
-    listen(port: number, host?: string): Promise<void>;
-    /**
-     * Attach to an existing HTTP server
-     */
-    attach(server: MinimalHTTPServer, path?: string): void;
-    /**
-     * Register connection handler
-     */
-    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
-    /**
-     * Broadcast message to all connected clients
-     */
-    broadcast(message: string): void;
-    /**
-     * Close server and all connections
-     */
-    close(): Promise<void>;
-    /**
-     * Dispose resources
-     */
-    dispose(): Promise<void>;
-}
-/**
- * ChannelServerOptions - Server configuration
- */
-interface ChannelServerOptions {
-    /**
-     * Enable heartbeat/ping-pong (default: true)
-     */
-    heartbeat?: boolean;
-    /**
-     * Heartbeat interval in ms (default: 30000)
-     */
-    heartbeatInterval?: number;
-    /**
-     * Enable debug logging (default: false)
-     */
-    debug?: boolean;
-}
-/**
- * Connection state
- */
-type ConnectionState = "connecting" | "open" | "closing" | "closed";
-/**
- * ChannelClient - Connects to server
- */
-interface ChannelClient {
-    /**
-     * Connection state
-     */
-    readonly readyState: ConnectionState;
-    /**
-     * Connect to server
-     */
-    connect(): Promise<void>;
-    /**
-     * Send message to server
-     */
-    send(message: string): void;
-    /**
-     * Register message handler
-     */
-    onMessage(handler: (message: string) => void): Unsubscribe;
-    /**
-     * Register open handler
-     */
-    onOpen(handler: () => void): Unsubscribe;
-    /**
-     * Register close handler
-     */
-    onClose(handler: () => void): Unsubscribe;
-    /**
-     * Register error handler
-     */
-    onError(handler: (error: Error) => void): Unsubscribe;
-    /**
-     * Close connection
-     */
-    close(): void;
-    /**
-     * Dispose resources
-     */
-    dispose(): void;
-}
-/**
- * ChannelClientOptions - Client configuration
- */
-interface ChannelClientOptions {
-    /**
-     * Server URL
-     */
-    serverUrl: string;
-    /**
-     * Enable auto-reconnect (default: true in browser, false in Node.js)
-     */
-    autoReconnect?: boolean;
-    /**
-     * Min reconnection delay in ms (default: 1000)
-     */
-    minReconnectionDelay?: number;
-    /**
-     * Max reconnection delay in ms (default: 10000)
-     */
-    maxReconnectionDelay?: number;
-    /**
-     * Max retry attempts (default: Infinity)
-     */
-    maxRetries?: number;
-    /**
-     * Connection timeout in ms (default: 4000)
-     */
-    connectionTimeout?: number;
-    /**
-     * Enable debug logging (default: false)
-     */
-    debug?: boolean;
-    /**
-     * Custom headers for WebSocket connection
-     *
-     * - Node.js: Headers are sent during WebSocket handshake
-     * - Browser: Headers are sent in first authentication message
-     */
-    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-}
-/**
- * ChannelServerProvider - Factory for creating ChannelServer instances
- */
-interface ChannelServerProvider {
-    createServer(options?: ChannelServerOptions): ChannelServer;
-}
-/**
- * ChannelClientProvider - Factory for creating ChannelClient instances
- */
-interface ChannelClientProvider {
-    createClient(options: ChannelClientOptions): ChannelClient;
-}
-
-export { type AckMessage, type ChannelClient, type ChannelClientOptions, type ChannelClientProvider, type ChannelConnection, type ChannelServer, type ChannelServerOptions, type ChannelServerProvider, type ConnectionState, type MinimalHTTPServer, type ReliableWrapper, type SendReliableOptions, type Unsubscribe, createAck, generateMessageId, isAckMessage, isReliableWrapper, unwrapMessage, wrapMessage };
+export { type AckMessage, type ReliableWrapper, createAck, generateMessageId, isAckMessage, isReliableWrapper, unwrapMessage, wrapMessage };

package/dist/network/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/network/jsonrpc.ts","../../src/network/protocol.ts","../../src/network/RpcClient.ts"],"sourcesContent":["/**\n * JSON-RPC 2.0 Protocol for AgentX Network Communication\n *\n * Uses jsonrpc-lite for message parsing/serialization.\n *\n * Message Types:\n * - Request: Client → Server (has id, expects response)\n * - Response: Server → Client (success or error)\n * - Notification: Server → Client (no id, stream events)\n *\n * @see https://www.jsonrpc.org/specification\n */\n\nimport type { IParsedObject, JsonRpc } from \"jsonrpc-lite\";\nimport {\n  JsonRpcError,\n  error as jsonrpcError,\n  notification as jsonrpcNotification,\n  parse as jsonrpcParse,\n  parseObject as jsonrpcParseObject,\n  request as jsonrpcRequest,\n  success as jsonrpcSuccess,\n} from \"jsonrpc-lite\";\nimport type { SystemEvent } from \"../event/types/base\";\n\n// ============================================================================\n// Re-export jsonrpc-lite types and functions\n// ============================================================================\n\nexport { JsonRpcError };\nexport type { IParsedObject, JsonRpc };\n\n// ============================================================================\n// RPC Method Names\n// ============================================================================\n\n/**\n * All RPC method names supported by AgentX\n */\nexport type RpcMethod =\n  // Container\n  | \"container.create\"\n  | \"container.get\"\n  | \"container.list\"\n  // Image\n  | \"image.create\"\n  | \"image.get\"\n  | \"image.list\"\n  | \"image.delete\"\n  | \"image.run\"\n  | \"image.stop\"\n  | \"image.update\"\n  | \"image.messages\"\n  // Agent\n  | \"agent.get\"\n  | \"agent.list\"\n  | \"agent.destroy\"\n  | \"agent.destroyAll\"\n  | \"agent.interrupt\"\n  // Message\n  | \"message.send\";\n\n/**\n * Notification method names (server push)\n */\nexport type NotificationMethod =\n  | \"stream.event\" // Stream events (text_delta, tool_call, etc.)\n  | \"control.ack\"; // ACK for reliable delivery\n\n// ============================================================================\n// Request/Response Type Definitions\n// ============================================================================\n\n/**\n * JSON-RPC Request structure\n */\nexport interface RpcRequest<M extends RpcMethod = RpcMethod, P = unknown> {\n  jsonrpc: \"2.0\";\n  method: M;\n  params: P;\n  id: string | number;\n}\n\n/**\n * JSON-RPC Success Response structure\n */\nexport interface RpcSuccessResponse<R = unknown> {\n  jsonrpc: \"2.0\";\n  result: R;\n  id: string | number;\n}\n\n/**\n * JSON-RPC Error Response structure\n */\nexport interface RpcErrorResponse {\n  jsonrpc: \"2.0\";\n  error: {\n    code: number;\n    message: string;\n    data?: unknown;\n  };\n  id: string | number | null;\n}\n\n/**\n * JSON-RPC Notification structure (no id, no response expected)\n */\nexport interface RpcNotification<M extends NotificationMethod = NotificationMethod, P = unknown> {\n  jsonrpc: \"2.0\";\n  method: M;\n  params: P;\n}\n\n/**\n * Stream event notification params\n */\nexport interface StreamEventParams {\n  topic: string;\n  event: SystemEvent;\n}\n\n/**\n * Control ACK notification params\n */\nexport interface ControlAckParams {\n  msgId: string;\n}\n\n// ============================================================================\n// Standard JSON-RPC Error Codes\n// ============================================================================\n\nexport const RpcErrorCodes = {\n  // Standard JSON-RPC errors\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n  // Server errors (reserved: -32000 to -32099)\n  SERVER_ERROR: -32000,\n  // Application errors (custom)\n  NOT_FOUND: 404,\n  UNAUTHORIZED: 401,\n  FORBIDDEN: 403,\n  TIMEOUT: 408,\n} as const;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Create a JSON-RPC request\n */\nexport function createRequest(\n  id: string | number,\n  method: RpcMethod | string,\n  params: unknown\n): JsonRpc {\n  return jsonrpcRequest(id, method, params as Record<string, unknown>);\n}\n\n/**\n * Create a JSON-RPC notification (no response expected)\n */\nexport function createNotification(method: NotificationMethod | string, params: unknown): JsonRpc {\n  return jsonrpcNotification(method, params as Record<string, unknown>);\n}\n\n/**\n * Create a stream event notification\n */\nexport function createStreamEvent(topic: string, event: SystemEvent): JsonRpc {\n  return jsonrpcNotification(\"stream.event\", { topic, event });\n}\n\n/**\n * Create an ACK notification\n */\nexport function createAckNotification(msgId: string): JsonRpc {\n  return jsonrpcNotification(\"control.ack\", { msgId });\n}\n\n/**\n * Create a success response\n */\nexport function createSuccessResponse(id: string | number, result: unknown): JsonRpc {\n  return jsonrpcSuccess(id, result as Record<string, unknown>);\n}\n\n/**\n * Create an error response\n */\nexport function createErrorResponse(\n  id: string | number | null,\n  code: number,\n  message: string,\n  data?: unknown\n): JsonRpc {\n  return jsonrpcError(id, new JsonRpcError(message, code, data));\n}\n\n/**\n * Parse a JSON-RPC message string\n */\nexport function parseMessage(message: string): IParsedObject | IParsedObject[] {\n  return jsonrpcParse(message);\n}\n\n/**\n * Parse a JSON-RPC message object\n */\nexport function parseMessageObject(obj: unknown): IParsedObject {\n  return jsonrpcParseObject(obj);\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Check if parsed message is a request\n */\nexport function isRequest(parsed: IParsedObject): boolean {\n  return parsed.type === \"request\";\n}\n\n/**\n * Check if parsed message is a notification\n */\nexport function isNotification(parsed: IParsedObject): boolean {\n  return parsed.type === \"notification\";\n}\n\n/**\n * Check if parsed message is a success response\n */\nexport function isSuccessResponse(parsed: IParsedObject): boolean {\n  return parsed.type === \"success\";\n}\n\n/**\n * Check if parsed message is an error response\n */\nexport function isErrorResponse(parsed: IParsedObject): boolean {\n  return parsed.type === \"error\";\n}\n\n/**\n * Check if parsed message is invalid\n */\nexport function isInvalid(parsed: IParsedObject): boolean {\n  return parsed.type === \"invalid\";\n}\n\n/**\n * Check if notification is a stream event\n */\nexport function isStreamEvent(parsed: IParsedObject): parsed is IParsedObject & {\n  payload: RpcNotification<\"stream.event\", StreamEventParams>;\n} {\n  if (parsed.type !== \"notification\") return false;\n  const payload = parsed.payload as RpcNotification;\n  return payload.method === \"stream.event\";\n}\n\n/**\n * Check if notification is a control ACK\n */\nexport function isControlAck(parsed: IParsedObject): parsed is IParsedObject & {\n  payload: RpcNotification<\"control.ack\", ControlAckParams>;\n} {\n  if (parsed.type !== \"notification\") return false;\n  const payload = parsed.payload as RpcNotification;\n  return payload.method === \"control.ack\";\n}\n\n// ============================================================================\n// Method Name Mapping (for backward compatibility)\n// ============================================================================\n\n/**\n * Map old event type names to new RPC method names\n */\nexport const eventTypeToRpcMethod: Record<string, RpcMethod> = {\n  // Container\n  container_create_request: \"container.create\",\n  container_get_request: \"container.get\",\n  container_list_request: \"container.list\",\n  // Image\n  image_create_request: \"image.create\",\n  image_get_request: \"image.get\",\n  image_list_request: \"image.list\",\n  image_delete_request: \"image.delete\",\n  image_run_request: \"image.run\",\n  image_stop_request: \"image.stop\",\n  image_update_request: \"image.update\",\n  image_messages_request: \"image.messages\",\n  // Agent\n  agent_get_request: \"agent.get\",\n  agent_list_request: \"agent.list\",\n  agent_destroy_request: \"agent.destroy\",\n  agent_destroy_all_request: \"agent.destroyAll\",\n  agent_interrupt_request: \"agent.interrupt\",\n  // Message\n  message_send_request: \"message.send\",\n};\n\n/**\n * Map RPC method names back to response event types\n */\nexport const rpcMethodToResponseType: Record<RpcMethod, string> = {\n  // Container\n  \"container.create\": \"container_create_response\",\n  \"container.get\": \"container_get_response\",\n  \"container.list\": \"container_list_response\",\n  // Image\n  \"image.create\": \"image_create_response\",\n  \"image.get\": \"image_get_response\",\n  \"image.list\": \"image_list_response\",\n  \"image.delete\": \"image_delete_response\",\n  \"image.run\": \"image_run_response\",\n  \"image.stop\": \"image_stop_response\",\n  \"image.update\": \"image_update_response\",\n  \"image.messages\": \"image_messages_response\",\n  // Agent\n  \"agent.get\": \"agent_get_response\",\n  \"agent.list\": \"agent_list_response\",\n  \"agent.destroy\": \"agent_destroy_response\",\n  \"agent.destroyAll\": \"agent_destroy_all_response\",\n  \"agent.interrupt\": \"agent_interrupt_response\",\n  // Message\n  \"message.send\": \"message_send_response\",\n};\n","/**\n * Reliable Message Protocol\n *\n * Internal protocol for message acknowledgment between server and client.\n * This is transparent to the application layer.\n *\n * Flow:\n * 1. Server sends: { __msgId: \"xxx\", __payload: \"actual message\" }\n * 2. Client receives, extracts payload, sends: { __ack: \"xxx\" }\n * 3. Server receives ACK, triggers onAck callback\n */\n\n// ============================================================================\n// Protocol Types\n// ============================================================================\n\n/**\n * ReliableWrapper - Wrapper for reliable messages (server → client)\n *\n * Contains the original message payload with a unique ID for tracking.\n */\nexport interface ReliableWrapper {\n  /** Unique message ID for tracking */\n  __msgId: string;\n  /** Original message payload */\n  __payload: string;\n}\n\n/**\n * AckMessage - Acknowledgment message (client → server)\n *\n * Sent automatically by client when receiving a reliable message.\n */\nexport interface AckMessage {\n  /** Message ID being acknowledged */\n  __ack: string;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Check if data is a ReliableWrapper\n */\nexport function isReliableWrapper(data: unknown): data is ReliableWrapper {\n  return typeof data === \"object\" && data !== null && \"__msgId\" in data && \"__payload\" in data;\n}\n\n/**\n * Check if data is an AckMessage\n */\nexport function isAckMessage(data: unknown): data is AckMessage {\n  return typeof data === \"object\" && data !== null && \"__ack\" in data;\n}\n\n// ============================================================================\n// Protocol Helpers\n// ============================================================================\n\n/**\n * Wrap a message for reliable delivery\n */\nexport function wrapMessage(msgId: string, payload: string): ReliableWrapper {\n  return { __msgId: msgId, __payload: payload };\n}\n\n/**\n * Create an ACK message\n */\nexport function createAck(msgId: string): AckMessage {\n  return { __ack: msgId };\n}\n\n/**\n * Unwrap a reliable message, returning the original payload\n */\nexport function unwrapMessage(wrapper: ReliableWrapper): string {\n  return wrapper.__payload;\n}\n\n/**\n * Generate a unique message ID\n */\nexport function generateMessageId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n","/**\n * RpcClient - JSON-RPC 2.0 Client over WebSocket\n *\n * Provides:\n * - Request/Response with automatic ID matching\n * - Notification handling (stream events)\n * - Timeout management\n * - Reconnection support\n *\n * @example\n * ```typescript\n * const client = new RpcClient({ url: \"ws://localhost:5200\" });\n * await client.connect();\n *\n * // RPC call\n * const result = await client.call(\"container.list\", {});\n *\n * // Stream events\n * client.onNotification(\"stream.event\", (params) => {\n *   console.log(\"Event:\", params.event);\n * });\n *\n * // Subscribe to topic\n * client.notify(\"subscribe\", { topic: \"session-123\" });\n * ```\n */\n\nimport type { SystemEvent } from \"../event/types/base\";\nimport {\n  createNotification,\n  createRequest,\n  isErrorResponse,\n  isNotification,\n  isStreamEvent,\n  isSuccessResponse,\n  type NotificationMethod,\n  parseMessage,\n  type RpcMethod,\n  type StreamEventParams,\n} from \"./jsonrpc\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Factory function for creating WebSocket instances.\n * Platform layer provides the implementation:\n * - Browser: native WebSocket (default)\n * - Node.js: ws library (via @agentxjs/node-platform)\n */\nexport type WebSocketFactory = (url: string) => WebSocket;\n\n/**\n * RpcClient configuration\n */\nexport interface RpcClientConfig {\n  /**\n   * WebSocket URL\n   */\n  url: string;\n\n  /**\n   * Factory for creating WebSocket instances.\n   * If not provided, falls back to the global WebSocket constructor.\n   */\n  createWebSocket?: WebSocketFactory;\n\n  /**\n   * Request timeout in milliseconds (default: 30000)\n   */\n  timeout?: number;\n\n  /**\n   * Auto reconnect on disconnect (default: true)\n   */\n  autoReconnect?: boolean;\n\n  /**\n   * Reconnect delay in milliseconds (default: 3000)\n   */\n  reconnectDelay?: number;\n\n  /**\n   * Headers for authentication (sent in first message after connection)\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n\n  /**\n   * Debug logging\n   */\n  debug?: boolean;\n}\n\n/**\n * Pending request state\n */\ninterface PendingRequest {\n  resolve: (result: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Notification handler\n */\ntype NotificationHandler = (method: string, params: unknown) => void;\n\n/**\n * Stream event handler\n */\ntype StreamEventHandler = (topic: string, event: SystemEvent) => void;\n\n/**\n * Connection state\n */\nexport type RpcClientState = \"disconnected\" | \"connecting\" | \"connected\";\n\n// ============================================================================\n// RpcClient Implementation\n// ============================================================================\n\n/**\n * JSON-RPC 2.0 Client\n */\nexport class RpcClient {\n  private readonly config: RpcClientConfig;\n  private readonly timeout: number;\n  private readonly pendingRequests = new Map<string | number, PendingRequest>();\n  private readonly notificationHandlers = new Set<NotificationHandler>();\n  private readonly streamEventHandlers = new Set<StreamEventHandler>();\n\n  private ws: WebSocket | null = null;\n  private state: RpcClientState = \"disconnected\";\n  private requestId = 0;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private disposed = false;\n\n  constructor(config: RpcClientConfig) {\n    this.config = config;\n    this.timeout = config.timeout ?? 30000;\n  }\n\n  // ==================== Properties ====================\n\n  /**\n   * Current connection state\n   */\n  get connectionState(): RpcClientState {\n    return this.state;\n  }\n\n  /**\n   * Whether client is connected\n   */\n  get connected(): boolean {\n    return this.state === \"connected\";\n  }\n\n  // ==================== Connection ====================\n\n  /**\n   * Connect to server\n   */\n  async connect(): Promise<void> {\n    if (this.disposed) {\n      throw new Error(\"Client has been disposed\");\n    }\n\n    if (this.state === \"connected\") {\n      return;\n    }\n\n    this.state = \"connecting\";\n\n    const url = this.config.url;\n\n    // Create WebSocket via injected factory or global WebSocket\n    const factory = this.config.createWebSocket ?? ((u: string) => new WebSocket(u));\n    const ws = factory(url);\n\n    this.ws = ws;\n\n    return new Promise((resolve, reject) => {\n      ws.onopen = async () => {\n        this.state = \"connected\";\n\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Connected to\", url);\n        }\n\n        // Send auth headers after connection (for environments where\n        // WebSocket constructor doesn't support headers, e.g. browser)\n        if (this.config.headers) {\n          const headers =\n            typeof this.config.headers === \"function\"\n              ? await this.config.headers()\n              : this.config.headers;\n          this.notify(\"auth\" as NotificationMethod, { headers });\n        }\n\n        resolve();\n      };\n\n      ws.onclose = () => {\n        this.state = \"disconnected\";\n\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Disconnected\");\n        }\n\n        // Auto reconnect\n        if (!this.disposed && this.config.autoReconnect !== false) {\n          this.scheduleReconnect();\n        }\n      };\n\n      ws.onerror = (err) => {\n        if (this.config.debug) {\n          console.error(\"[RpcClient] WebSocket error:\", err);\n        }\n\n        if (this.state === \"connecting\") {\n          this.state = \"disconnected\";\n          reject(new Error(\"Failed to connect to server\"));\n        }\n      };\n\n      ws.onmessage = (event) => {\n        this.handleMessage(event.data as string);\n      };\n    });\n  }\n\n  /**\n   * Disconnect from server\n   */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    this.state = \"disconnected\";\n  }\n\n  /**\n   * Dispose client and clean up resources\n   */\n  dispose(): void {\n    this.disposed = true;\n\n    // Reject all pending requests\n    for (const [id, pending] of this.pendingRequests) {\n      clearTimeout(pending.timer);\n      pending.reject(new Error(\"Client disposed\"));\n      this.pendingRequests.delete(id);\n    }\n\n    this.disconnect();\n    this.notificationHandlers.clear();\n    this.streamEventHandlers.clear();\n\n    if (this.config.debug) {\n      console.log(\"[RpcClient] Disposed\");\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectTimer) return;\n\n    const delay = this.config.reconnectDelay ?? 3000;\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = null;\n\n      if (!this.disposed && this.state === \"disconnected\") {\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Attempting to reconnect...\");\n        }\n\n        try {\n          await this.connect();\n        } catch {\n          this.scheduleReconnect();\n        }\n      }\n    }, delay);\n  }\n\n  // ==================== RPC Methods ====================\n\n  /**\n   * Call an RPC method and wait for response\n   */\n  async call<T = unknown>(method: RpcMethod, params: unknown): Promise<T> {\n    if (!this.connected || !this.ws) {\n      throw new Error(\"Not connected to server\");\n    }\n\n    const id = ++this.requestId;\n    const request = createRequest(id, method, params);\n\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pendingRequests.delete(id);\n        reject(new Error(`Request timeout: ${method}`));\n      }, this.timeout);\n\n      this.pendingRequests.set(id, {\n        resolve: resolve as (result: unknown) => void,\n        reject,\n        timer,\n      });\n\n      if (this.config.debug) {\n        console.log(\"[RpcClient] Sending request:\", method, params);\n      }\n\n      this.ws!.send(JSON.stringify(request));\n    });\n  }\n\n  /**\n   * Send a notification (no response expected)\n   */\n  notify(method: NotificationMethod | string, params: unknown): void {\n    if (!this.connected || !this.ws) {\n      if (this.config.debug) {\n        console.warn(\"[RpcClient] Cannot send notification: not connected\");\n      }\n      return;\n    }\n\n    const notification = createNotification(method as NotificationMethod, params);\n\n    if (this.config.debug) {\n      console.log(\"[RpcClient] Sending notification:\", method, params);\n    }\n\n    this.ws.send(JSON.stringify(notification));\n  }\n\n  /**\n   * Subscribe to a topic (convenience method)\n   */\n  subscribe(topic: string): void {\n    this.notify(\"subscribe\", { topic });\n  }\n\n  /**\n   * Unsubscribe from a topic (convenience method)\n   */\n  unsubscribe(topic: string): void {\n    this.notify(\"unsubscribe\", { topic });\n  }\n\n  // ==================== Event Handlers ====================\n\n  /**\n   * Register handler for all notifications\n   */\n  onNotification(handler: NotificationHandler): () => void {\n    this.notificationHandlers.add(handler);\n    return () => this.notificationHandlers.delete(handler);\n  }\n\n  /**\n   * Register handler for stream events\n   */\n  onStreamEvent(handler: StreamEventHandler): () => void {\n    this.streamEventHandlers.add(handler);\n    return () => this.streamEventHandlers.delete(handler);\n  }\n\n  // ==================== Message Handling ====================\n\n  private handleMessage(data: string): void {\n    try {\n      const parsed = parseMessage(data);\n\n      // Handle single message\n      if (!Array.isArray(parsed)) {\n        this.handleParsedMessage(parsed);\n      } else {\n        // Batch response (rare)\n        for (const item of parsed) {\n          this.handleParsedMessage(item);\n        }\n      }\n    } catch (err) {\n      if (this.config.debug) {\n        console.error(\"[RpcClient] Failed to parse message:\", err);\n      }\n    }\n  }\n\n  private handleParsedMessage(parsed: import(\"jsonrpc-lite\").IParsedObject): void {\n    if (isSuccessResponse(parsed)) {\n      // Success response - resolve pending request\n      const payload = parsed.payload as { id: string | number; result: unknown };\n      const pending = this.pendingRequests.get(payload.id);\n\n      if (pending) {\n        this.pendingRequests.delete(payload.id);\n        clearTimeout(pending.timer);\n        pending.resolve(payload.result);\n      }\n    } else if (isErrorResponse(parsed)) {\n      // Error response - reject pending request\n      const payload = parsed.payload as {\n        id: string | number | null;\n        error: { code: number; message: string; data?: unknown };\n      };\n\n      if (payload.id !== null) {\n        const pending = this.pendingRequests.get(payload.id);\n\n        if (pending) {\n          this.pendingRequests.delete(payload.id);\n          clearTimeout(pending.timer);\n          pending.reject(new Error(payload.error.message));\n        }\n      }\n    } else if (isNotification(parsed)) {\n      // Notification - stream event or control message\n      const payload = parsed.payload as { method: string; params: unknown };\n\n      if (this.config.debug) {\n        console.log(\"[RpcClient] Received notification:\", payload.method);\n      }\n\n      // Notify all handlers\n      for (const handler of this.notificationHandlers) {\n        handler(payload.method, payload.params);\n      }\n\n      // Handle stream events specially\n      if (isStreamEvent(parsed)) {\n        const streamPayload = parsed.payload as { params: StreamEventParams };\n        const { topic, event } = streamPayload.params;\n\n        for (const handler of this.streamEventHandlers) {\n          handler(topic, event);\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/network/jsonrpc.ts","../../src/network/protocol.ts","../../src/network/RpcClient.ts"],"sourcesContent":["/**\n * JSON-RPC 2.0 Protocol for AgentX Network Communication\n *\n * Uses jsonrpc-lite for message parsing/serialization.\n *\n * Message Types:\n * - Request: Client → Server (has id, expects response)\n * - Response: Server → Client (success or error)\n * - Notification: Server → Client (no id, stream events)\n *\n * @see https://www.jsonrpc.org/specification\n */\n\nimport type { IParsedObject, JsonRpc } from \"jsonrpc-lite\";\nimport {\n  JsonRpcError,\n  error as jsonrpcError,\n  notification as jsonrpcNotification,\n  parse as jsonrpcParse,\n  parseObject as jsonrpcParseObject,\n  request as jsonrpcRequest,\n  success as jsonrpcSuccess,\n} from \"jsonrpc-lite\";\nimport type { SystemEvent } from \"../event/types/base\";\n\n// ============================================================================\n// Re-export jsonrpc-lite types and functions\n// ============================================================================\n\nexport { JsonRpcError };\nexport type { IParsedObject, JsonRpc };\n\n// ============================================================================\n// RPC Method Names\n// ============================================================================\n\n/**\n * All RPC method names supported by AgentX\n */\nexport type RpcMethod =\n  // Container\n  | \"container.create\"\n  | \"container.get\"\n  | \"container.list\"\n  // Image\n  | \"image.create\"\n  | \"image.get\"\n  | \"image.list\"\n  | \"image.delete\"\n  | \"image.run\"\n  | \"image.stop\"\n  | \"image.update\"\n  | \"image.messages\"\n  // Agent\n  | \"agent.get\"\n  | \"agent.list\"\n  | \"agent.destroy\"\n  | \"agent.destroyAll\"\n  | \"agent.interrupt\"\n  // Message\n  | \"message.send\";\n\n/**\n * Notification method names (server push)\n */\nexport type NotificationMethod =\n  | \"stream.event\" // Stream events (text_delta, tool_call, etc.)\n  | \"control.ack\"; // ACK for reliable delivery\n\n// ============================================================================\n// Request/Response Type Definitions\n// ============================================================================\n\n/**\n * JSON-RPC Request structure\n */\nexport interface RpcRequest<M extends RpcMethod = RpcMethod, P = unknown> {\n  jsonrpc: \"2.0\";\n  method: M;\n  params: P;\n  id: string | number;\n}\n\n/**\n * JSON-RPC Success Response structure\n */\nexport interface RpcSuccessResponse<R = unknown> {\n  jsonrpc: \"2.0\";\n  result: R;\n  id: string | number;\n}\n\n/**\n * JSON-RPC Error Response structure\n */\nexport interface RpcErrorResponse {\n  jsonrpc: \"2.0\";\n  error: {\n    code: number;\n    message: string;\n    data?: unknown;\n  };\n  id: string | number | null;\n}\n\n/**\n * JSON-RPC Notification structure (no id, no response expected)\n */\nexport interface RpcNotification<M extends NotificationMethod = NotificationMethod, P = unknown> {\n  jsonrpc: \"2.0\";\n  method: M;\n  params: P;\n}\n\n/**\n * Stream event notification params\n */\nexport interface StreamEventParams {\n  topic: string;\n  event: SystemEvent;\n}\n\n/**\n * Control ACK notification params\n */\nexport interface ControlAckParams {\n  msgId: string;\n}\n\n// ============================================================================\n// Standard JSON-RPC Error Codes\n// ============================================================================\n\nexport const RpcErrorCodes = {\n  // Standard JSON-RPC errors\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n  // Server errors (reserved: -32000 to -32099)\n  SERVER_ERROR: -32000,\n  // Application errors (custom)\n  NOT_FOUND: 404,\n  UNAUTHORIZED: 401,\n  FORBIDDEN: 403,\n  TIMEOUT: 408,\n} as const;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Create a JSON-RPC request\n */\nexport function createRequest(\n  id: string | number,\n  method: RpcMethod | string,\n  params: unknown\n): JsonRpc {\n  return jsonrpcRequest(id, method, params as Record<string, unknown>);\n}\n\n/**\n * Create a JSON-RPC notification (no response expected)\n */\nexport function createNotification(method: NotificationMethod | string, params: unknown): JsonRpc {\n  return jsonrpcNotification(method, params as Record<string, unknown>);\n}\n\n/**\n * Create a stream event notification\n */\nexport function createStreamEvent(topic: string, event: SystemEvent): JsonRpc {\n  return jsonrpcNotification(\"stream.event\", { topic, event });\n}\n\n/**\n * Create an ACK notification\n */\nexport function createAckNotification(msgId: string): JsonRpc {\n  return jsonrpcNotification(\"control.ack\", { msgId });\n}\n\n/**\n * Create a success response\n */\nexport function createSuccessResponse(id: string | number, result: unknown): JsonRpc {\n  return jsonrpcSuccess(id, result as Record<string, unknown>);\n}\n\n/**\n * Create an error response\n */\nexport function createErrorResponse(\n  id: string | number | null,\n  code: number,\n  message: string,\n  data?: unknown\n): JsonRpc {\n  return jsonrpcError(id, new JsonRpcError(message, code, data));\n}\n\n/**\n * Parse a JSON-RPC message string\n */\nexport function parseMessage(message: string): IParsedObject | IParsedObject[] {\n  return jsonrpcParse(message);\n}\n\n/**\n * Parse a JSON-RPC message object\n */\nexport function parseMessageObject(obj: unknown): IParsedObject {\n  return jsonrpcParseObject(obj);\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Check if parsed message is a request\n */\nexport function isRequest(parsed: IParsedObject): boolean {\n  return parsed.type === \"request\";\n}\n\n/**\n * Check if parsed message is a notification\n */\nexport function isNotification(parsed: IParsedObject): boolean {\n  return parsed.type === \"notification\";\n}\n\n/**\n * Check if parsed message is a success response\n */\nexport function isSuccessResponse(parsed: IParsedObject): boolean {\n  return parsed.type === \"success\";\n}\n\n/**\n * Check if parsed message is an error response\n */\nexport function isErrorResponse(parsed: IParsedObject): boolean {\n  return parsed.type === \"error\";\n}\n\n/**\n * Check if parsed message is invalid\n */\nexport function isInvalid(parsed: IParsedObject): boolean {\n  return parsed.type === \"invalid\";\n}\n\n/**\n * Check if notification is a stream event\n */\nexport function isStreamEvent(parsed: IParsedObject): parsed is IParsedObject & {\n  payload: RpcNotification<\"stream.event\", StreamEventParams>;\n} {\n  if (parsed.type !== \"notification\") return false;\n  const payload = parsed.payload as RpcNotification;\n  return payload.method === \"stream.event\";\n}\n\n/**\n * Check if notification is a control ACK\n */\nexport function isControlAck(parsed: IParsedObject): parsed is IParsedObject & {\n  payload: RpcNotification<\"control.ack\", ControlAckParams>;\n} {\n  if (parsed.type !== \"notification\") return false;\n  const payload = parsed.payload as RpcNotification;\n  return payload.method === \"control.ack\";\n}\n\n// ============================================================================\n// Method Name Mapping (for backward compatibility)\n// ============================================================================\n\n/**\n * Map old event type names to new RPC method names\n */\nexport const eventTypeToRpcMethod: Record<string, RpcMethod> = {\n  // Container\n  container_create_request: \"container.create\",\n  container_get_request: \"container.get\",\n  container_list_request: \"container.list\",\n  // Image\n  image_create_request: \"image.create\",\n  image_get_request: \"image.get\",\n  image_list_request: \"image.list\",\n  image_delete_request: \"image.delete\",\n  image_run_request: \"image.run\",\n  image_stop_request: \"image.stop\",\n  image_update_request: \"image.update\",\n  image_messages_request: \"image.messages\",\n  // Agent\n  agent_get_request: \"agent.get\",\n  agent_list_request: \"agent.list\",\n  agent_destroy_request: \"agent.destroy\",\n  agent_destroy_all_request: \"agent.destroyAll\",\n  agent_interrupt_request: \"agent.interrupt\",\n  // Message\n  message_send_request: \"message.send\",\n};\n\n/**\n * Map RPC method names back to response event types\n */\nexport const rpcMethodToResponseType: Record<RpcMethod, string> = {\n  // Container\n  \"container.create\": \"container_create_response\",\n  \"container.get\": \"container_get_response\",\n  \"container.list\": \"container_list_response\",\n  // Image\n  \"image.create\": \"image_create_response\",\n  \"image.get\": \"image_get_response\",\n  \"image.list\": \"image_list_response\",\n  \"image.delete\": \"image_delete_response\",\n  \"image.run\": \"image_run_response\",\n  \"image.stop\": \"image_stop_response\",\n  \"image.update\": \"image_update_response\",\n  \"image.messages\": \"image_messages_response\",\n  // Agent\n  \"agent.get\": \"agent_get_response\",\n  \"agent.list\": \"agent_list_response\",\n  \"agent.destroy\": \"agent_destroy_response\",\n  \"agent.destroyAll\": \"agent_destroy_all_response\",\n  \"agent.interrupt\": \"agent_interrupt_response\",\n  // Message\n  \"message.send\": \"message_send_response\",\n};\n","/**\n * Reliable Message Protocol\n *\n * Internal protocol for message acknowledgment between server and client.\n * This is transparent to the application layer.\n *\n * Flow:\n * 1. Server sends: { __msgId: \"xxx\", __payload: \"actual message\" }\n * 2. Client receives, extracts payload, sends: { __ack: \"xxx\" }\n * 3. Server receives ACK, triggers onAck callback\n */\n\n// ============================================================================\n// Protocol Types\n// ============================================================================\n\n/**\n * ReliableWrapper - Wrapper for reliable messages (server → client)\n *\n * Contains the original message payload with a unique ID for tracking.\n */\nexport interface ReliableWrapper {\n  /** Unique message ID for tracking */\n  __msgId: string;\n  /** Original message payload */\n  __payload: string;\n}\n\n/**\n * AckMessage - Acknowledgment message (client → server)\n *\n * Sent automatically by client when receiving a reliable message.\n */\nexport interface AckMessage {\n  /** Message ID being acknowledged */\n  __ack: string;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Check if data is a ReliableWrapper\n */\nexport function isReliableWrapper(data: unknown): data is ReliableWrapper {\n  return typeof data === \"object\" && data !== null && \"__msgId\" in data && \"__payload\" in data;\n}\n\n/**\n * Check if data is an AckMessage\n */\nexport function isAckMessage(data: unknown): data is AckMessage {\n  return typeof data === \"object\" && data !== null && \"__ack\" in data;\n}\n\n// ============================================================================\n// Protocol Helpers\n// ============================================================================\n\n/**\n * Wrap a message for reliable delivery\n */\nexport function wrapMessage(msgId: string, payload: string): ReliableWrapper {\n  return { __msgId: msgId, __payload: payload };\n}\n\n/**\n * Create an ACK message\n */\nexport function createAck(msgId: string): AckMessage {\n  return { __ack: msgId };\n}\n\n/**\n * Unwrap a reliable message, returning the original payload\n */\nexport function unwrapMessage(wrapper: ReliableWrapper): string {\n  return wrapper.__payload;\n}\n\n/**\n * Generate a unique message ID\n */\nexport function generateMessageId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n","/**\n * RpcClient - JSON-RPC 2.0 Client over WebSocket\n *\n * Provides:\n * - Request/Response with automatic ID matching\n * - Notification handling (stream events)\n * - Timeout management\n * - Reconnection support\n *\n * @example\n * ```typescript\n * const client = new RpcClient({ url: \"ws://localhost:5200\" });\n * await client.connect();\n *\n * // RPC call\n * const result = await client.call(\"container.list\", {});\n *\n * // Stream events\n * client.onNotification(\"stream.event\", (params) => {\n *   console.log(\"Event:\", params.event);\n * });\n *\n * // Subscribe to topic\n * client.notify(\"subscribe\", { topic: \"session-123\" });\n * ```\n */\n\nimport type { SystemEvent } from \"../event/types/base\";\nimport {\n  createNotification,\n  createRequest,\n  isErrorResponse,\n  isNotification,\n  isStreamEvent,\n  isSuccessResponse,\n  type NotificationMethod,\n  parseMessage,\n  type RpcMethod,\n  type StreamEventParams,\n} from \"./jsonrpc\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Factory for creating client-side WebSocket connections.\n * Injected via Platform:\n * - Browser: native WebSocket (default fallback)\n * - Node.js: ws library (via @agentxjs/node-platform)\n */\nexport type ChannelClientFactory = (url: string) => WebSocket;\n\n/**\n * RpcClient configuration\n */\nexport interface RpcClientConfig {\n  /**\n   * WebSocket URL\n   */\n  url: string;\n\n  /**\n   * Factory for creating WebSocket instances.\n   * If not provided, falls back to the global WebSocket constructor.\n   */\n  createWebSocket?: ChannelClientFactory;\n\n  /**\n   * Request timeout in milliseconds (default: 30000)\n   */\n  timeout?: number;\n\n  /**\n   * Auto reconnect on disconnect (default: true)\n   */\n  autoReconnect?: boolean;\n\n  /**\n   * Reconnect delay in milliseconds (default: 3000)\n   */\n  reconnectDelay?: number;\n\n  /**\n   * Headers for authentication (sent in first message after connection)\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n\n  /**\n   * Debug logging\n   */\n  debug?: boolean;\n}\n\n/**\n * Pending request state\n */\ninterface PendingRequest {\n  resolve: (result: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Notification handler\n */\ntype NotificationHandler = (method: string, params: unknown) => void;\n\n/**\n * Stream event handler\n */\ntype StreamEventHandler = (topic: string, event: SystemEvent) => void;\n\n/**\n * Connection state\n */\nexport type RpcClientState = \"disconnected\" | \"connecting\" | \"connected\";\n\n// ============================================================================\n// RpcClient Implementation\n// ============================================================================\n\n/**\n * JSON-RPC 2.0 Client\n */\nexport class RpcClient {\n  private readonly config: RpcClientConfig;\n  private readonly timeout: number;\n  private readonly pendingRequests = new Map<string | number, PendingRequest>();\n  private readonly notificationHandlers = new Set<NotificationHandler>();\n  private readonly streamEventHandlers = new Set<StreamEventHandler>();\n\n  private ws: WebSocket | null = null;\n  private state: RpcClientState = \"disconnected\";\n  private requestId = 0;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private disposed = false;\n\n  constructor(config: RpcClientConfig) {\n    this.config = config;\n    this.timeout = config.timeout ?? 30000;\n  }\n\n  // ==================== Properties ====================\n\n  /**\n   * Current connection state\n   */\n  get connectionState(): RpcClientState {\n    return this.state;\n  }\n\n  /**\n   * Whether client is connected\n   */\n  get connected(): boolean {\n    return this.state === \"connected\";\n  }\n\n  // ==================== Connection ====================\n\n  /**\n   * Connect to server\n   */\n  async connect(): Promise<void> {\n    if (this.disposed) {\n      throw new Error(\"Client has been disposed\");\n    }\n\n    if (this.state === \"connected\") {\n      return;\n    }\n\n    this.state = \"connecting\";\n\n    const url = this.config.url;\n\n    // Create WebSocket via injected factory or global WebSocket\n    const factory = this.config.createWebSocket ?? ((u: string) => new WebSocket(u));\n    const ws = factory(url);\n\n    this.ws = ws;\n\n    return new Promise((resolve, reject) => {\n      ws.onopen = async () => {\n        this.state = \"connected\";\n\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Connected to\", url);\n        }\n\n        // Send auth headers after connection (for environments where\n        // WebSocket constructor doesn't support headers, e.g. browser)\n        if (this.config.headers) {\n          const headers =\n            typeof this.config.headers === \"function\"\n              ? await this.config.headers()\n              : this.config.headers;\n          this.notify(\"auth\" as NotificationMethod, { headers });\n        }\n\n        resolve();\n      };\n\n      ws.onclose = () => {\n        this.state = \"disconnected\";\n\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Disconnected\");\n        }\n\n        // Auto reconnect\n        if (!this.disposed && this.config.autoReconnect !== false) {\n          this.scheduleReconnect();\n        }\n      };\n\n      ws.onerror = (err) => {\n        if (this.config.debug) {\n          console.error(\"[RpcClient] WebSocket error:\", err);\n        }\n\n        if (this.state === \"connecting\") {\n          this.state = \"disconnected\";\n          reject(new Error(\"Failed to connect to server\"));\n        }\n      };\n\n      ws.onmessage = (event) => {\n        this.handleMessage(event.data as string);\n      };\n    });\n  }\n\n  /**\n   * Disconnect from server\n   */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    this.state = \"disconnected\";\n  }\n\n  /**\n   * Dispose client and clean up resources\n   */\n  dispose(): void {\n    this.disposed = true;\n\n    // Reject all pending requests\n    for (const [id, pending] of this.pendingRequests) {\n      clearTimeout(pending.timer);\n      pending.reject(new Error(\"Client disposed\"));\n      this.pendingRequests.delete(id);\n    }\n\n    this.disconnect();\n    this.notificationHandlers.clear();\n    this.streamEventHandlers.clear();\n\n    if (this.config.debug) {\n      console.log(\"[RpcClient] Disposed\");\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectTimer) return;\n\n    const delay = this.config.reconnectDelay ?? 3000;\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = null;\n\n      if (!this.disposed && this.state === \"disconnected\") {\n        if (this.config.debug) {\n          console.log(\"[RpcClient] Attempting to reconnect...\");\n        }\n\n        try {\n          await this.connect();\n        } catch {\n          this.scheduleReconnect();\n        }\n      }\n    }, delay);\n  }\n\n  // ==================== RPC Methods ====================\n\n  /**\n   * Call an RPC method and wait for response\n   */\n  async call<T = unknown>(method: RpcMethod, params: unknown): Promise<T> {\n    if (!this.connected || !this.ws) {\n      throw new Error(\"Not connected to server\");\n    }\n\n    const id = ++this.requestId;\n    const request = createRequest(id, method, params);\n\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pendingRequests.delete(id);\n        reject(new Error(`Request timeout: ${method}`));\n      }, this.timeout);\n\n      this.pendingRequests.set(id, {\n        resolve: resolve as (result: unknown) => void,\n        reject,\n        timer,\n      });\n\n      if (this.config.debug) {\n        console.log(\"[RpcClient] Sending request:\", method, params);\n      }\n\n      this.ws!.send(JSON.stringify(request));\n    });\n  }\n\n  /**\n   * Send a notification (no response expected)\n   */\n  notify(method: NotificationMethod | string, params: unknown): void {\n    if (!this.connected || !this.ws) {\n      if (this.config.debug) {\n        console.warn(\"[RpcClient] Cannot send notification: not connected\");\n      }\n      return;\n    }\n\n    const notification = createNotification(method as NotificationMethod, params);\n\n    if (this.config.debug) {\n      console.log(\"[RpcClient] Sending notification:\", method, params);\n    }\n\n    this.ws.send(JSON.stringify(notification));\n  }\n\n  /**\n   * Subscribe to a topic (convenience method)\n   */\n  subscribe(topic: string): void {\n    this.notify(\"subscribe\", { topic });\n  }\n\n  /**\n   * Unsubscribe from a topic (convenience method)\n   */\n  unsubscribe(topic: string): void {\n    this.notify(\"unsubscribe\", { topic });\n  }\n\n  // ==================== Event Handlers ====================\n\n  /**\n   * Register handler for all notifications\n   */\n  onNotification(handler: NotificationHandler): () => void {\n    this.notificationHandlers.add(handler);\n    return () => this.notificationHandlers.delete(handler);\n  }\n\n  /**\n   * Register handler for stream events\n   */\n  onStreamEvent(handler: StreamEventHandler): () => void {\n    this.streamEventHandlers.add(handler);\n    return () => this.streamEventHandlers.delete(handler);\n  }\n\n  // ==================== Message Handling ====================\n\n  private handleMessage(data: string): void {\n    try {\n      const parsed = parseMessage(data);\n\n      // Handle single message\n      if (!Array.isArray(parsed)) {\n        this.handleParsedMessage(parsed);\n      } else {\n        // Batch response (rare)\n        for (const item of parsed) {\n          this.handleParsedMessage(item);\n        }\n      }\n    } catch (err) {\n      if (this.config.debug) {\n        console.error(\"[RpcClient] Failed to parse message:\", err);\n      }\n    }\n  }\n\n  private handleParsedMessage(parsed: import(\"jsonrpc-lite\").IParsedObject): void {\n    if (isSuccessResponse(parsed)) {\n      // Success response - resolve pending request\n      const payload = parsed.payload as { id: string | number; result: unknown };\n      const pending = this.pendingRequests.get(payload.id);\n\n      if (pending) {\n        this.pendingRequests.delete(payload.id);\n        clearTimeout(pending.timer);\n        pending.resolve(payload.result);\n      }\n    } else if (isErrorResponse(parsed)) {\n      // Error response - reject pending request\n      const payload = parsed.payload as {\n        id: string | number | null;\n        error: { code: number; message: string; data?: unknown };\n      };\n\n      if (payload.id !== null) {\n        const pending = this.pendingRequests.get(payload.id);\n\n        if (pending) {\n          this.pendingRequests.delete(payload.id);\n          clearTimeout(pending.timer);\n          pending.reject(new Error(payload.error.message));\n        }\n      }\n    } else if (isNotification(parsed)) {\n      // Notification - stream event or control message\n      const payload = parsed.payload as { method: string; params: unknown };\n\n      if (this.config.debug) {\n        console.log(\"[RpcClient] Received notification:\", payload.method);\n      }\n\n      // Notify all handlers\n      for (const handler of this.notificationHandlers) {\n        handler(payload.method, payload.params);\n      }\n\n      // Handle stream events specially\n      if (isStreamEvent(parsed)) {\n        const streamPayload = parsed.payload as { params: StreamEventParams };\n        const { topic, event } = streamPayload.params;\n\n        for (const handler of this.streamEventHandlers) {\n          handler(topic, event);\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/platform/index.d.ts

@@ -1,7 +1,7 @@
 import { B as BashProvider } from '../types-Cb8tKM6Y.js';
 import { d as ContainerRepository, I as ImageRepository, c as SessionRepository } from '../index--gxNpY5W.js';
 import { E as EventBus } from '../bus-C9FLWIu8.js';
-import { W as WebSocketFactory } from '../RpcClient-CMdhJxjS.js';
+import { F as ChannelServer, w as ChannelClientFactory } from '../types-CTV8Z9PI.js';
 import '../message-Dn-I2vr0.js';
 import '../base-m40r3Qgu.js';
 import 'jsonrpc-lite';
@@ -65,12 +65,20 @@ interface AgentXPlatform {
      */
     readonly bashProvider?: BashProvider;
     /**
-     * WebSocket factory for creating client connections
+     * Channel server for accepting client connections (server-side)
+     *
+     * Optional — only needed for server scenarios.
+     * Node.js platform provides ws-based implementation.
+     * Cloudflare platform provides DO Hibernation API implementation.
+     */
+    readonly channelServer?: ChannelServer;
+    /**
+     * Channel client factory for creating connections (client-side)
      *
      * Optional — browser uses native WebSocket by default.
      * Node.js platform provides ws-based implementation.
      */
-    readonly webSocketFactory?: WebSocketFactory;
+    readonly channelClient?: ChannelClientFactory;
 }
 
 export type { AgentXPlatform };

package/dist/runtime/index.d.ts

@@ -4,7 +4,7 @@ import { B as BusEvent } from '../base-m40r3Qgu.js';
 import { AgentXPlatform } from '../platform/index.js';
 import '../types-Cb8tKM6Y.js';
 import '../bus-C9FLWIu8.js';
-import '../RpcClient-CMdhJxjS.js';
+import '../types-CTV8Z9PI.js';
 import 'jsonrpc-lite';
 
 /**

package/dist/{RpcClient-CMdhJxjS.d.ts → types-CTV8Z9PI.d.ts}

@@ -185,12 +185,12 @@ declare const rpcMethodToResponseType: Record<RpcMethod, string>;
  */
 
 /**
- * Factory function for creating WebSocket instances.
- * Platform layer provides the implementation:
- * - Browser: native WebSocket (default)
+ * Factory for creating client-side WebSocket connections.
+ * Injected via Platform:
+ * - Browser: native WebSocket (default fallback)
  * - Node.js: ws library (via @agentxjs/node-platform)
  */
-type WebSocketFactory = (url: string) => WebSocket;
+type ChannelClientFactory = (url: string) => WebSocket;
 /**
  * RpcClient configuration
  */
@@ -203,7 +203,7 @@ interface RpcClientConfig {
      * Factory for creating WebSocket instances.
      * If not provided, falls back to the global WebSocket constructor.
      */
-    createWebSocket?: WebSocketFactory;
+    createWebSocket?: ChannelClientFactory;
     /**
      * Request timeout in milliseconds (default: 30000)
      */
@@ -301,4 +301,222 @@ declare class RpcClient {
     private handleParsedMessage;
 }
 
-export { type ControlAckParams as C, type NotificationMethod as N, type RpcErrorResponse as R, type StreamEventParams as S, type WebSocketFactory as W, type RpcMethod as a, type RpcNotification as b, type RpcRequest as c, type RpcSuccessResponse as d, createAckNotification as e, createErrorResponse as f, createNotification as g, createRequest as h, createStreamEvent as i, createSuccessResponse as j, eventTypeToRpcMethod as k, isControlAck as l, isErrorResponse as m, isInvalid as n, isNotification as o, isRequest as p, isStreamEvent as q, isSuccessResponse as r, parseMessage as s, parseMessageObject as t, RpcErrorCodes as u, rpcMethodToResponseType as v, type RpcClientConfig as w, type RpcClientState as x, RpcClient as y };
+/**
+ * Network Types - Channel interfaces for client-server communication
+ *
+ * Provides transport-agnostic interfaces that can be implemented with:
+ * - WebSocket (Node.js, Browser)
+ * - Durable Objects WebSocket (Cloudflare Workers)
+ * - HTTP/2, gRPC, etc.
+ */
+/**
+ * Unsubscribe function type
+ */
+type Unsubscribe = () => void;
+/**
+ * Minimal HTTP server interface for attaching WebSocket
+ * Avoids Node.js dependency in types package
+ */
+interface MinimalHTTPServer {
+    on(event: "upgrade", listener: (request: unknown, socket: unknown, head: unknown) => void): void;
+}
+/**
+ * Options for reliable message sending
+ */
+interface SendReliableOptions {
+    /**
+     * Callback when client acknowledges receipt
+     */
+    onAck?: () => void;
+    /**
+     * Timeout in milliseconds (default: 5000)
+     */
+    timeout?: number;
+    /**
+     * Callback when ACK times out
+     */
+    onTimeout?: () => void;
+}
+/**
+ * ChannelConnection - Server-side representation of a client connection
+ */
+interface ChannelConnection {
+    /**
+     * Unique connection ID
+     */
+    readonly id: string;
+    /**
+     * Send message to this client (fire-and-forget)
+     */
+    send(message: string): void;
+    /**
+     * Send message with acknowledgment
+     *
+     * The message is wrapped with a unique ID. Client automatically sends ACK
+     * when received. Server triggers onAck callback upon receiving ACK.
+     *
+     * This is handled transparently by the Network layer.
+     */
+    sendReliable(message: string, options?: SendReliableOptions): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close this connection
+     */
+    close(): void;
+}
+/**
+ * ChannelServer - Accepts client connections
+ */
+interface ChannelServer {
+    /**
+     * Start listening on a port (standalone mode)
+     */
+    listen(port: number, host?: string): Promise<void>;
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server: MinimalHTTPServer, path?: string): void;
+    /**
+     * Register connection handler
+     */
+    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message: string): void;
+    /**
+     * Close server and all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Dispose resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * ChannelServerOptions - Server configuration
+ */
+interface ChannelServerOptions {
+    /**
+     * Enable heartbeat/ping-pong (default: true)
+     */
+    heartbeat?: boolean;
+    /**
+     * Heartbeat interval in ms (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+/**
+ * Connection state
+ */
+type ConnectionState = "connecting" | "open" | "closing" | "closed";
+/**
+ * ChannelClient - Connects to server
+ */
+interface ChannelClient {
+    /**
+     * Connection state
+     */
+    readonly readyState: ConnectionState;
+    /**
+     * Connect to server
+     */
+    connect(): Promise<void>;
+    /**
+     * Send message to server
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register open handler
+     */
+    onOpen(handler: () => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close connection
+     */
+    close(): void;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * ChannelClientOptions - Client configuration
+ */
+interface ChannelClientOptions {
+    /**
+     * Server URL
+     */
+    serverUrl: string;
+    /**
+     * Enable auto-reconnect (default: true in browser, false in Node.js)
+     */
+    autoReconnect?: boolean;
+    /**
+     * Min reconnection delay in ms (default: 1000)
+     */
+    minReconnectionDelay?: number;
+    /**
+     * Max reconnection delay in ms (default: 10000)
+     */
+    maxReconnectionDelay?: number;
+    /**
+     * Max retry attempts (default: Infinity)
+     */
+    maxRetries?: number;
+    /**
+     * Connection timeout in ms (default: 4000)
+     */
+    connectionTimeout?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+    /**
+     * Custom headers for WebSocket connection
+     *
+     * - Node.js: Headers are sent during WebSocket handshake
+     * - Browser: Headers are sent in first authentication message
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+}
+/**
+ * ChannelServerProvider - Factory for creating ChannelServer instances
+ */
+interface ChannelServerProvider {
+    createServer(options?: ChannelServerOptions): ChannelServer;
+}
+/**
+ * ChannelClientProvider - Factory for creating ChannelClient instances
+ */
+interface ChannelClientProvider {
+    createClient(options: ChannelClientOptions): ChannelClient;
+}
+
+export { type ChannelClient as A, type ChannelClientOptions as B, type ControlAckParams as C, type ChannelClientProvider as D, type ChannelConnection as E, type ChannelServer as F, type ChannelServerOptions as G, type ChannelServerProvider as H, type ConnectionState as I, type SendReliableOptions as J, type MinimalHTTPServer as M, type NotificationMethod as N, type RpcErrorResponse as R, type StreamEventParams as S, type Unsubscribe as U, type RpcMethod as a, type RpcNotification as b, type RpcRequest as c, type RpcSuccessResponse as d, createAckNotification as e, createErrorResponse as f, createNotification as g, createRequest as h, createStreamEvent as i, createSuccessResponse as j, eventTypeToRpcMethod as k, isControlAck as l, isErrorResponse as m, isInvalid as n, isNotification as o, isRequest as p, isStreamEvent as q, isSuccessResponse as r, parseMessage as s, parseMessageObject as t, RpcErrorCodes as u, rpcMethodToResponseType as v, type ChannelClientFactory as w, type RpcClientConfig as x, type RpcClientState as y, RpcClient as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/core",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/network/RpcClient.ts

@@ -44,12 +44,12 @@ import {
 // ============================================================================
 
 /**
- * Factory function for creating WebSocket instances.
- * Platform layer provides the implementation:
- * - Browser: native WebSocket (default)
+ * Factory for creating client-side WebSocket connections.
+ * Injected via Platform:
+ * - Browser: native WebSocket (default fallback)
  * - Node.js: ws library (via @agentxjs/node-platform)
  */
-export type WebSocketFactory = (url: string) => WebSocket;
+export type ChannelClientFactory = (url: string) => WebSocket;
 
 /**
  * RpcClient configuration
@@ -64,7 +64,7 @@ export interface RpcClientConfig {
    * Factory for creating WebSocket instances.
    * If not provided, falls back to the global WebSocket constructor.
    */
-  createWebSocket?: WebSocketFactory;
+  createWebSocket?: ChannelClientFactory;
 
   /**
    * Request timeout in milliseconds (default: 30000)

package/src/network/index.ts

@@ -55,7 +55,7 @@ export {
   wrapMessage,
 } from "./protocol";
 // RPC Client
-export type { RpcClientConfig, RpcClientState, WebSocketFactory } from "./RpcClient";
+export type { ChannelClientFactory, RpcClientConfig, RpcClientState } from "./RpcClient";
 export { RpcClient } from "./RpcClient";
 // Types
 export type {

package/src/platform/types.ts

@@ -23,7 +23,8 @@ import type { BashProvider } from "../bash/types";
 import type { ContainerRepository } from "../container/types";
 import type { EventBus } from "../event/types";
 import type { ImageRepository } from "../image/types";
-import type { WebSocketFactory } from "../network/RpcClient";
+import type { ChannelClientFactory } from "../network/RpcClient";
+import type { ChannelServer } from "../network/types";
 import type { SessionRepository } from "../session/types";
 
 // ============================================================================
@@ -75,10 +76,19 @@ export interface AgentXPlatform {
   readonly bashProvider?: BashProvider;
 
   /**
-   * WebSocket factory for creating client connections
+   * Channel server for accepting client connections (server-side)
+   *
+   * Optional — only needed for server scenarios.
+   * Node.js platform provides ws-based implementation.
+   * Cloudflare platform provides DO Hibernation API implementation.
+   */
+  readonly channelServer?: ChannelServer;
+
+  /**
+   * Channel client factory for creating connections (client-side)
    *
    * Optional — browser uses native WebSocket by default.
    * Node.js platform provides ws-based implementation.
    */
-  readonly webSocketFactory?: WebSocketFactory;
+  readonly channelClient?: ChannelClientFactory;
 }