@agentxjs/core 1.9.10-dev → 2.0.1

package/dist/network/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/network/protocol.ts","../../src/network/jsonrpc.ts","../../src/network/RpcClient.ts"],"sourcesContent":["/**\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 * 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 {\n  request as jsonrpcRequest,\n  notification as jsonrpcNotification,\n  success as jsonrpcSuccess,\n  error as jsonrpcError,\n  parse as jsonrpcParse,\n  parseObject as jsonrpcParseObject,\n  JsonRpcError,\n} from \"jsonrpc-lite\";\nimport type { IParsedObject, JsonRpc } 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 * 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 {\n  createRequest,\n  createNotification,\n  parseMessage,\n  isSuccessResponse,\n  isErrorResponse,\n  isNotification,\n  isStreamEvent,\n  type RpcMethod,\n  type NotificationMethod,\n  type StreamEventParams,\n} from \"./jsonrpc\";\nimport type { SystemEvent } from \"../event/types/base\";\n\n/**\n * Check if running in browser environment\n */\nfunction isBrowser(): boolean {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const globalWindow = typeof globalThis !== \"undefined\" ? (globalThis as any).window : undefined;\n  return globalWindow?.document !== undefined;\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * RpcClient configuration\n */\nexport interface RpcClientConfig {\n  /**\n   * WebSocket URL\n   */\n  url: string;\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 (Node.js only, sent in first message for browser)\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 (browser or Node.js)\n    let ws: WebSocket;\n    if (isBrowser()) {\n      ws = new WebSocket(url);\n    } else {\n      const { default: WS } = await import(\"ws\");\n      ws = new WS(url) as unknown as WebSocket;\n    }\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 if in browser (headers not supported in WebSocket API)\n        if (isBrowser() && 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 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":[]}

package/dist/persistence/index.d.ts

@@ -1,155 +1,2 @@
-import { M as Message } from '../message-BMrMm1pq.js';
-import { McpServerConfig } from '../driver/index.js';
-
-/**
- * Persistence Types - Repository interfaces and record types
- *
- * Defines standard interfaces for data persistence.
- * Implementations are provided by platform packages (node, cloudflare).
- */
-
-/**
- * Container configuration (extensible)
- */
-interface ContainerConfig {
-    [key: string]: unknown;
-}
-/**
- * ContainerRecord - Persistent container data
- *
- * Represents a logical container (resource isolation unit).
- * Each container provides an isolated environment for running Agents.
- */
-interface ContainerRecord {
-    /** Unique container identifier */
-    containerId: string;
-    /** Container creation timestamp (Unix milliseconds) */
-    createdAt: number;
-    /** Last update timestamp (Unix milliseconds) */
-    updatedAt: number;
-    /** Container configuration (extensible) */
-    config?: ContainerConfig;
-}
-/**
- * Image metadata for storing provider-specific data
- */
-interface ImageMetadata {
-    /** Claude SDK session ID for conversation resume */
-    claudeSdkSessionId?: string;
-}
-/**
- * ImageRecord - Persistent representation of a conversation
- *
- * Image is the primary entity users interact with (displayed as "conversation").
- * Agent is a transient runtime instance created from Image.
- *
- * Lifecycle:
- * - image_create → ImageRecord (persistent)
- * - image_run → Agent (runtime, in-memory)
- * - image_stop / server restart → Agent destroyed, Image remains
- */
-interface ImageRecord {
-    /** Unique image identifier (pattern: `img_${nanoid()}`) */
-    imageId: string;
-    /** Container ID (user isolation boundary) */
-    containerId: string;
-    /** Session ID for message storage */
-    sessionId: string;
-    /** Conversation name (displayed to user) */
-    name: string;
-    /** Conversation description (optional) */
-    description?: string;
-    /** System prompt - controls agent behavior */
-    systemPrompt?: string;
-    /** Parent image ID (for fork/branch feature) */
-    parentImageId?: string;
-    /** MCP servers configuration */
-    mcpServers?: Record<string, McpServerConfig>;
-    /** Provider-specific metadata */
-    metadata?: ImageMetadata;
-    /** Creation timestamp (Unix milliseconds) */
-    createdAt: number;
-    /** Last update timestamp (Unix milliseconds) */
-    updatedAt: number;
-}
-/**
- * SessionRecord - Storage schema for Session persistence
- *
- * Session stores conversation messages for an Image.
- * Each Image has exactly one Session.
- */
-interface SessionRecord {
-    /** Unique session identifier */
-    sessionId: string;
-    /** Associated image ID (owner of this session) */
-    imageId: string;
-    /** Container this session belongs to */
-    containerId: string;
-    /** Creation timestamp (Unix milliseconds) */
-    createdAt: number;
-    /** Last update timestamp (Unix milliseconds) */
-    updatedAt: number;
-}
-/**
- * ContainerRepository - Storage operations for containers
- */
-interface ContainerRepository {
-    /** Save a container record (create or update) */
-    saveContainer(record: ContainerRecord): Promise<void>;
-    /** Find container by ID */
-    findContainerById(containerId: string): Promise<ContainerRecord | null>;
-    /** Find all containers */
-    findAllContainers(): Promise<ContainerRecord[]>;
-    /** Delete container by ID */
-    deleteContainer(containerId: string): Promise<void>;
-    /** Check if container exists */
-    containerExists(containerId: string): Promise<boolean>;
-}
-/**
- * ImageRepository - Storage operations for images
- */
-interface ImageRepository {
-    /** Save an image record (create or update) */
-    saveImage(record: ImageRecord): Promise<void>;
-    /** Find image by ID */
-    findImageById(imageId: string): Promise<ImageRecord | null>;
-    /** Find all images */
-    findAllImages(): Promise<ImageRecord[]>;
-    /** Find images by agent name */
-    findImagesByName(name: string): Promise<ImageRecord[]>;
-    /** Find images by container ID */
-    findImagesByContainerId(containerId: string): Promise<ImageRecord[]>;
-    /** Delete image by ID */
-    deleteImage(imageId: string): Promise<void>;
-    /** Check if image exists */
-    imageExists(imageId: string): Promise<boolean>;
-    /** Update image metadata (merges with existing) */
-    updateMetadata(imageId: string, metadata: Partial<ImageMetadata>): Promise<void>;
-}
-/**
- * SessionRepository - Storage operations for sessions
- */
-interface SessionRepository {
-    /** Save a session record (create or update) */
-    saveSession(record: SessionRecord): Promise<void>;
-    /** Find session by ID */
-    findSessionById(sessionId: string): Promise<SessionRecord | null>;
-    /** Find session by image ID */
-    findSessionByImageId(imageId: string): Promise<SessionRecord | null>;
-    /** Find all sessions for a container */
-    findSessionsByContainerId(containerId: string): Promise<SessionRecord[]>;
-    /** Find all sessions */
-    findAllSessions(): Promise<SessionRecord[]>;
-    /** Delete session by ID */
-    deleteSession(sessionId: string): Promise<void>;
-    /** Check if session exists */
-    sessionExists(sessionId: string): Promise<boolean>;
-    /** Add a message to a session */
-    addMessage(sessionId: string, message: Message): Promise<void>;
-    /** Get all messages for a session */
-    getMessages(sessionId: string): Promise<Message[]>;
-    /** Clear all messages for a session */
-    clearMessages(sessionId: string): Promise<void>;
-}
-
-export { type ContainerConfig, type ContainerRecord, type ContainerRepository, type ImageMetadata, type ImageRecord, type ImageRepository, McpServerConfig, type SessionRecord, type SessionRepository };
+export { e as ContainerConfig, C as ContainerRecord, d as ContainerRepository, g as ImageMetadata, f as ImageRecord, I as ImageRepository, M as McpServerConfig, b as SessionRecord, c as SessionRepository } from '../index--gxNpY5W.js';
+import '../message-Dn-I2vr0.js';

package/dist/platform/index.d.ts

@@ -0,0 +1,76 @@
+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 '../message-Dn-I2vr0.js';
+import '../base-m40r3Qgu.js';
+import 'jsonrpc-lite';
+
+/**
+ * Platform Types
+ *
+ * AgentXPlatform - Dependency injection container for platform capabilities.
+ * Platform packages (node-platform, etc.) provide implementations.
+ *
+ * ```
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                      AgentXPlatform                         │
+ * │  (Dependency Injection - Platform provides implementations) │
+ * │                                                             │
+ * │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐          │
+ * │  │ Repositories│ │  EventBus   │ │  Providers  │          │
+ * │  │  Container  │ │             │ │  Bash (opt) │          │
+ * │  │  Image      │ │             │ │             │          │
+ * │  │  Session    │ │             │ │             │          │
+ * │  └─────────────┘ └─────────────┘ └─────────────┘          │
+ * └─────────────────────────────────────────────────────────────┘
+ * ```
+ */
+
+/**
+ * AgentXPlatform - Collects all dependencies for runtime
+ *
+ * Platform packages provide implementations of these interfaces.
+ * The platform is passed to AgentXRuntime for integration.
+ *
+ * Required capabilities:
+ * - containerRepository, imageRepository, sessionRepository — persistence
+ * - eventBus — pub/sub
+ *
+ * Optional capabilities:
+ * - bashProvider — command execution (not all platforms support this)
+ */
+interface AgentXPlatform {
+    /**
+     * Container repository for persistence
+     */
+    readonly containerRepository: ContainerRepository;
+    /**
+     * Image repository for persistence
+     */
+    readonly imageRepository: ImageRepository;
+    /**
+     * Session repository for persistence
+     */
+    readonly sessionRepository: SessionRepository;
+    /**
+     * Event bus for pub/sub
+     */
+    readonly eventBus: EventBus;
+    /**
+     * Bash provider for command execution
+     *
+     * Optional — not all platforms support shell execution.
+     * Node.js platform provides child_process based implementation.
+     */
+    readonly bashProvider?: BashProvider;
+    /**
+     * WebSocket factory for creating client connections
+     *
+     * Optional — browser uses native WebSocket by default.
+     * Node.js platform provides ws-based implementation.
+     */
+    readonly webSocketFactory?: WebSocketFactory;
+}
+
+export type { AgentXPlatform };

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/index.d.ts

@@ -1,34 +1,28 @@
-import { ContainerRepository, ImageRepository, SessionRepository } from '../persistence/index.js';
-import { CreateDriver } from '../driver/index.js';
-import { c as UserContentPart } from '../message-BMrMm1pq.js';
-import { WorkspaceProvider } from '../workspace/index.js';
+import { b as UserContentPart } from '../message-Dn-I2vr0.js';
+import { h as CreateDriver } from '../index--gxNpY5W.js';
 import { B as BusEvent } from '../base-m40r3Qgu.js';
-import { E as EventBus } from '../bus-uF1DM2ox.js';
+import { AgentXPlatform } from '../platform/index.js';
+import '../types-Cb8tKM6Y.js';
+import '../bus-C9FLWIu8.js';
+import '../RpcClient-CMdhJxjS.js';
+import 'jsonrpc-lite';
 
 /**
  * Runtime Types
  *
- * AgentXProvider - Dependency injection container
  * AgentXRuntime - Runtime integration layer
  *
  * Architecture:
  * ```
  * ┌─────────────────────────────────────────────────────────────┐
- * │                      AgentXProvider                         │
- * │  (Dependency Injection - Platform provides implementations) │
- * │                                                             │
- * │  ┌─────────────┐ ┌─────────────┐ ┌───────────────┐         │
- * │  │ Repositories│ │  Workspace  │ │ DriverFactory │         │
- * │  │  Container  │ │  Provider   │ │ (per-Agent)   │         │
- * │  │  Image      │ │             │ │             │           │
- * │  │  Session    │ │             │ │             │           │
- * │  └─────────────┘ └─────────────┘ └─────────────┘           │
+ * │                      AgentXPlatform                         │
+ * │           (see @agentxjs/core/platform)                     │
  * └─────────────────────────────────────────────────────────────┘
  *                              │
  *                              ▼
  * ┌─────────────────────────────────────────────────────────────┐
  * │                      AgentXRuntime                          │
- * │           (Integration - Uses Provider dependencies)        │
+ * │           (Integration - Uses Platform dependencies)        │
  * │                                                             │
  * │  ┌─────────────────────────────────────────────────────┐   │
  * │  │  Agent Lifecycle: create / get / destroy            │   │
@@ -55,38 +49,6 @@ interface RuntimeAgent {
     readonly lifecycle: AgentLifecycle;
     readonly createdAt: number;
 }
-/**
- * AgentXProvider - Collects all dependencies for runtime
- *
- * Platform packages provide implementations of these interfaces.
- * The provider is passed to AgentXRuntime for integration.
- */
-interface AgentXProvider {
-    /**
-     * Container repository for persistence
-     */
-    readonly containerRepository: ContainerRepository;
-    /**
-     * Image repository for persistence
-     */
-    readonly imageRepository: ImageRepository;
-    /**
-     * Session repository for persistence
-     */
-    readonly sessionRepository: SessionRepository;
-    /**
-     * Workspace provider for isolated environments
-     */
-    readonly workspaceProvider: WorkspaceProvider;
-    /**
-     * LLM Driver factory function - creates Driver per Agent
-     */
-    readonly createDriver: CreateDriver;
-    /**
-     * Event bus for pub/sub
-     */
-    readonly eventBus: EventBus;
-}
 /**
  * Agent creation options
  */
@@ -118,9 +80,9 @@ interface Subscription {
  */
 interface AgentXRuntime {
     /**
-     * The provider containing all dependencies
+     * The platform containing all dependencies
      */
-    readonly provider: AgentXProvider;
+    readonly platform: AgentXPlatform;
     /**
      * Create and start an agent from an image
      */
@@ -176,7 +138,7 @@ interface AgentXRuntime {
  * Configuration for creating AgentXRuntime
  */
 interface AgentXRuntimeConfig {
-    provider: AgentXProvider;
+    platform: AgentXPlatform;
 }
 /**
  * Factory function type for creating AgentXRuntime
@@ -187,23 +149,25 @@ type CreateAgentXRuntime = (config: AgentXRuntimeConfig) => AgentXRuntime;
  * AgentXRuntimeImpl - Runtime integration implementation
  *
  * Integrates all components to provide agent lifecycle management.
- * Uses Provider dependencies to coordinate Session, Image, Container, etc.
+ * Uses Platform dependencies to coordinate Session, Image, Container, etc.
  *
- * New Design:
+ * Architecture:
  * - Driver.receive() returns AsyncIterable<DriverStreamEvent>
- * - Runtime processes events and emits to EventBus
- * - No more EventBus-based communication with Driver
+ * - Runtime emits raw stream events to EventBus
+ * - Runtime pushes events through AgentEngine (MealyMachine → Presenter)
+ * - Presenter emits message/state/turn events and persists messages
  */
 
 /**
  * AgentXRuntimeImpl - Runtime implementation
  */
 declare class AgentXRuntimeImpl implements AgentXRuntime {
-    readonly provider: AgentXProvider;
+    readonly platform: AgentXPlatform;
+    private readonly createDriver;
     private agents;
     private globalSubscriptions;
     private isShutdown;
-    constructor(provider: AgentXProvider);
+    constructor(platform: AgentXPlatform, createDriver: CreateDriver);
     createAgent(options: CreateAgentOptions): Promise<RuntimeAgent>;
     getAgent(agentId: string): RuntimeAgent | undefined;
     getAgents(): RuntimeAgent[];
@@ -234,7 +198,10 @@ declare class AgentXRuntimeImpl implements AgentXRuntime {
 }
 /**
  * Create an AgentXRuntime instance
+ *
+ * @param platform - AgentXPlatform with repositories and event bus
+ * @param createDriver - Factory function for creating Driver instances per Agent
  */
-declare function createAgentXRuntime(provider: AgentXProvider): AgentXRuntime;
+declare function createAgentXRuntime(platform: AgentXPlatform, createDriver: CreateDriver): AgentXRuntime;
 
-export { type AgentEventHandler, type AgentLifecycle, type AgentXProvider, type AgentXRuntime, type AgentXRuntimeConfig, AgentXRuntimeImpl, type CreateAgentOptions, type CreateAgentXRuntime, type RuntimeAgent, type Subscription, createAgentXRuntime };
+export { type AgentEventHandler, type AgentLifecycle, AgentXPlatform, type AgentXRuntime, type AgentXRuntimeConfig, AgentXRuntimeImpl, type CreateAgentOptions, type CreateAgentXRuntime, type RuntimeAgent, type Subscription, createAgentXRuntime };