@agentxjs/core 1.9.5-dev → 1.9.7-dev

package/dist/network/index.js

@@ -0,0 +1,435 @@
+import "../chunk-7D4SUZUM.js";
+
+// src/network/protocol.ts
+function isReliableWrapper(data) {
+  return typeof data === "object" && data !== null && "__msgId" in data && "__payload" in data;
+}
+function isAckMessage(data) {
+  return typeof data === "object" && data !== null && "__ack" in data;
+}
+function wrapMessage(msgId, payload) {
+  return { __msgId: msgId, __payload: payload };
+}
+function createAck(msgId) {
+  return { __ack: msgId };
+}
+function unwrapMessage(wrapper) {
+  return wrapper.__payload;
+}
+function generateMessageId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+
+// src/network/jsonrpc.ts
+import {
+  request as jsonrpcRequest,
+  notification as jsonrpcNotification,
+  success as jsonrpcSuccess,
+  error as jsonrpcError,
+  parse as jsonrpcParse,
+  parseObject as jsonrpcParseObject,
+  JsonRpcError
+} from "jsonrpc-lite";
+var RpcErrorCodes = {
+  // Standard JSON-RPC errors
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603,
+  // Server errors (reserved: -32000 to -32099)
+  SERVER_ERROR: -32e3,
+  // Application errors (custom)
+  NOT_FOUND: 404,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  TIMEOUT: 408
+};
+function createRequest(id, method, params) {
+  return jsonrpcRequest(id, method, params);
+}
+function createNotification(method, params) {
+  return jsonrpcNotification(method, params);
+}
+function createStreamEvent(topic, event) {
+  return jsonrpcNotification("stream.event", { topic, event });
+}
+function createAckNotification(msgId) {
+  return jsonrpcNotification("control.ack", { msgId });
+}
+function createSuccessResponse(id, result) {
+  return jsonrpcSuccess(id, result);
+}
+function createErrorResponse(id, code, message, data) {
+  return jsonrpcError(id, new JsonRpcError(message, code, data));
+}
+function parseMessage(message) {
+  return jsonrpcParse(message);
+}
+function parseMessageObject(obj) {
+  return jsonrpcParseObject(obj);
+}
+function isRequest(parsed) {
+  return parsed.type === "request";
+}
+function isNotification(parsed) {
+  return parsed.type === "notification";
+}
+function isSuccessResponse(parsed) {
+  return parsed.type === "success";
+}
+function isErrorResponse(parsed) {
+  return parsed.type === "error";
+}
+function isInvalid(parsed) {
+  return parsed.type === "invalid";
+}
+function isStreamEvent(parsed) {
+  if (parsed.type !== "notification") return false;
+  const payload = parsed.payload;
+  return payload.method === "stream.event";
+}
+function isControlAck(parsed) {
+  if (parsed.type !== "notification") return false;
+  const payload = parsed.payload;
+  return payload.method === "control.ack";
+}
+var eventTypeToRpcMethod = {
+  // Container
+  container_create_request: "container.create",
+  container_get_request: "container.get",
+  container_list_request: "container.list",
+  // Image
+  image_create_request: "image.create",
+  image_get_request: "image.get",
+  image_list_request: "image.list",
+  image_delete_request: "image.delete",
+  image_run_request: "image.run",
+  image_stop_request: "image.stop",
+  image_update_request: "image.update",
+  image_messages_request: "image.messages",
+  // Agent
+  agent_get_request: "agent.get",
+  agent_list_request: "agent.list",
+  agent_destroy_request: "agent.destroy",
+  agent_destroy_all_request: "agent.destroyAll",
+  agent_interrupt_request: "agent.interrupt",
+  // Message
+  message_send_request: "message.send"
+};
+var rpcMethodToResponseType = {
+  // Container
+  "container.create": "container_create_response",
+  "container.get": "container_get_response",
+  "container.list": "container_list_response",
+  // Image
+  "image.create": "image_create_response",
+  "image.get": "image_get_response",
+  "image.list": "image_list_response",
+  "image.delete": "image_delete_response",
+  "image.run": "image_run_response",
+  "image.stop": "image_stop_response",
+  "image.update": "image_update_response",
+  "image.messages": "image_messages_response",
+  // Agent
+  "agent.get": "agent_get_response",
+  "agent.list": "agent_list_response",
+  "agent.destroy": "agent_destroy_response",
+  "agent.destroyAll": "agent_destroy_all_response",
+  "agent.interrupt": "agent_interrupt_response",
+  // Message
+  "message.send": "message_send_response"
+};
+
+// src/network/RpcClient.ts
+function isBrowser() {
+  const globalWindow = typeof globalThis !== "undefined" ? globalThis.window : void 0;
+  return globalWindow?.document !== void 0;
+}
+var RpcClient = class {
+  config;
+  timeout;
+  pendingRequests = /* @__PURE__ */ new Map();
+  notificationHandlers = /* @__PURE__ */ new Set();
+  streamEventHandlers = /* @__PURE__ */ new Set();
+  ws = null;
+  state = "disconnected";
+  requestId = 0;
+  reconnectTimer = null;
+  disposed = false;
+  constructor(config) {
+    this.config = config;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  // ==================== Properties ====================
+  /**
+   * Current connection state
+   */
+  get connectionState() {
+    return this.state;
+  }
+  /**
+   * Whether client is connected
+   */
+  get connected() {
+    return this.state === "connected";
+  }
+  // ==================== Connection ====================
+  /**
+   * Connect to server
+   */
+  async connect() {
+    if (this.disposed) {
+      throw new Error("Client has been disposed");
+    }
+    if (this.state === "connected") {
+      return;
+    }
+    this.state = "connecting";
+    const url = this.config.url;
+    let ws;
+    if (isBrowser()) {
+      ws = new WebSocket(url);
+    } else {
+      const { default: WS } = await import("../wrapper-Y3UTVU2E.js");
+      ws = new WS(url);
+    }
+    this.ws = ws;
+    return new Promise((resolve, reject) => {
+      ws.onopen = async () => {
+        this.state = "connected";
+        if (this.config.debug) {
+          console.log("[RpcClient] Connected to", url);
+        }
+        if (isBrowser() && this.config.headers) {
+          const headers = typeof this.config.headers === "function" ? await this.config.headers() : this.config.headers;
+          this.notify("auth", { headers });
+        }
+        resolve();
+      };
+      ws.onclose = () => {
+        this.state = "disconnected";
+        if (this.config.debug) {
+          console.log("[RpcClient] Disconnected");
+        }
+        if (!this.disposed && this.config.autoReconnect !== false) {
+          this.scheduleReconnect();
+        }
+      };
+      ws.onerror = (err) => {
+        if (this.config.debug) {
+          console.error("[RpcClient] WebSocket error:", err);
+        }
+        if (this.state === "connecting") {
+          this.state = "disconnected";
+          reject(new Error("Failed to connect to server"));
+        }
+      };
+      ws.onmessage = (event) => {
+        this.handleMessage(event.data);
+      };
+    });
+  }
+  /**
+   * Disconnect from server
+   */
+  disconnect() {
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.state = "disconnected";
+  }
+  /**
+   * Dispose client and clean up resources
+   */
+  dispose() {
+    this.disposed = true;
+    for (const [id, pending] of this.pendingRequests) {
+      clearTimeout(pending.timer);
+      pending.reject(new Error("Client disposed"));
+      this.pendingRequests.delete(id);
+    }
+    this.disconnect();
+    this.notificationHandlers.clear();
+    this.streamEventHandlers.clear();
+    if (this.config.debug) {
+      console.log("[RpcClient] Disposed");
+    }
+  }
+  scheduleReconnect() {
+    if (this.reconnectTimer) return;
+    const delay = this.config.reconnectDelay ?? 3e3;
+    this.reconnectTimer = setTimeout(async () => {
+      this.reconnectTimer = null;
+      if (!this.disposed && this.state === "disconnected") {
+        if (this.config.debug) {
+          console.log("[RpcClient] Attempting to reconnect...");
+        }
+        try {
+          await this.connect();
+        } catch {
+          this.scheduleReconnect();
+        }
+      }
+    }, delay);
+  }
+  // ==================== RPC Methods ====================
+  /**
+   * Call an RPC method and wait for response
+   */
+  async call(method, params) {
+    if (!this.connected || !this.ws) {
+      throw new Error("Not connected to server");
+    }
+    const id = ++this.requestId;
+    const request = createRequest(id, method, params);
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pendingRequests.delete(id);
+        reject(new Error(`Request timeout: ${method}`));
+      }, this.timeout);
+      this.pendingRequests.set(id, {
+        resolve,
+        reject,
+        timer
+      });
+      if (this.config.debug) {
+        console.log("[RpcClient] Sending request:", method, params);
+      }
+      this.ws.send(JSON.stringify(request));
+    });
+  }
+  /**
+   * Send a notification (no response expected)
+   */
+  notify(method, params) {
+    if (!this.connected || !this.ws) {
+      if (this.config.debug) {
+        console.warn("[RpcClient] Cannot send notification: not connected");
+      }
+      return;
+    }
+    const notification = createNotification(method, params);
+    if (this.config.debug) {
+      console.log("[RpcClient] Sending notification:", method, params);
+    }
+    this.ws.send(JSON.stringify(notification));
+  }
+  /**
+   * Subscribe to a topic (convenience method)
+   */
+  subscribe(topic) {
+    this.notify("subscribe", { topic });
+  }
+  /**
+   * Unsubscribe from a topic (convenience method)
+   */
+  unsubscribe(topic) {
+    this.notify("unsubscribe", { topic });
+  }
+  // ==================== Event Handlers ====================
+  /**
+   * Register handler for all notifications
+   */
+  onNotification(handler) {
+    this.notificationHandlers.add(handler);
+    return () => this.notificationHandlers.delete(handler);
+  }
+  /**
+   * Register handler for stream events
+   */
+  onStreamEvent(handler) {
+    this.streamEventHandlers.add(handler);
+    return () => this.streamEventHandlers.delete(handler);
+  }
+  // ==================== Message Handling ====================
+  handleMessage(data) {
+    try {
+      const parsed = parseMessage(data);
+      if (!Array.isArray(parsed)) {
+        this.handleParsedMessage(parsed);
+      } else {
+        for (const item of parsed) {
+          this.handleParsedMessage(item);
+        }
+      }
+    } catch (err) {
+      if (this.config.debug) {
+        console.error("[RpcClient] Failed to parse message:", err);
+      }
+    }
+  }
+  handleParsedMessage(parsed) {
+    if (isSuccessResponse(parsed)) {
+      const payload = parsed.payload;
+      const pending = this.pendingRequests.get(payload.id);
+      if (pending) {
+        this.pendingRequests.delete(payload.id);
+        clearTimeout(pending.timer);
+        pending.resolve(payload.result);
+      }
+    } else if (isErrorResponse(parsed)) {
+      const payload = parsed.payload;
+      if (payload.id !== null) {
+        const pending = this.pendingRequests.get(payload.id);
+        if (pending) {
+          this.pendingRequests.delete(payload.id);
+          clearTimeout(pending.timer);
+          pending.reject(new Error(payload.error.message));
+        }
+      }
+    } else if (isNotification(parsed)) {
+      const payload = parsed.payload;
+      if (this.config.debug) {
+        console.log("[RpcClient] Received notification:", payload.method);
+      }
+      for (const handler of this.notificationHandlers) {
+        handler(payload.method, payload.params);
+      }
+      if (isStreamEvent(parsed)) {
+        const streamPayload = parsed.payload;
+        const { topic, event } = streamPayload.params;
+        for (const handler of this.streamEventHandlers) {
+          handler(topic, event);
+        }
+      }
+    }
+  }
+};
+export {
+  JsonRpcError,
+  RpcClient,
+  RpcErrorCodes,
+  createAck,
+  createAckNotification,
+  createErrorResponse,
+  createNotification,
+  createRequest,
+  createStreamEvent,
+  createSuccessResponse,
+  eventTypeToRpcMethod,
+  generateMessageId,
+  isAckMessage,
+  isControlAck,
+  isErrorResponse,
+  isInvalid,
+  isNotification,
+  isReliableWrapper,
+  isRequest,
+  isStreamEvent,
+  isSuccessResponse,
+  parseMessage,
+  parseMessageObject,
+  rpcMethodToResponseType,
+  unwrapMessage,
+  wrapMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/network/index.js.map

@@ -0,0 +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":";;;AA6CO,SAAS,kBAAkB,MAAwC;AACxE,SAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,aAAa,QAAQ,eAAe;AAC1F;AAKO,SAAS,aAAa,MAAmC;AAC9D,SAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,WAAW;AACjE;AASO,SAAS,YAAY,OAAe,SAAkC;AAC3E,SAAO,EAAE,SAAS,OAAO,WAAW,QAAQ;AAC9C;AAKO,SAAS,UAAU,OAA2B;AACnD,SAAO,EAAE,OAAO,MAAM;AACxB;AAKO,SAAS,cAAc,SAAkC;AAC9D,SAAO,QAAQ;AACjB;AAKO,SAAS,oBAA4B;AAC1C,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACjE;;;AC5EA;AAAA,EACE,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,eAAe;AAAA,EACf;AAAA,OACK;AAgHA,IAAM,gBAAgB;AAAA;AAAA,EAE3B,aAAa;AAAA,EACb,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA;AAAA,EAEhB,cAAc;AAAA;AAAA,EAEd,WAAW;AAAA,EACX,cAAc;AAAA,EACd,WAAW;AAAA,EACX,SAAS;AACX;AASO,SAAS,cACd,IACA,QACA,QACS;AACT,SAAO,eAAe,IAAI,QAAQ,MAAiC;AACrE;AAKO,SAAS,mBAAmB,QAAqC,QAA0B;AAChG,SAAO,oBAAoB,QAAQ,MAAiC;AACtE;AAKO,SAAS,kBAAkB,OAAe,OAA6B;AAC5E,SAAO,oBAAoB,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAC7D;AAKO,SAAS,sBAAsB,OAAwB;AAC5D,SAAO,oBAAoB,eAAe,EAAE,MAAM,CAAC;AACrD;AAKO,SAAS,sBAAsB,IAAqB,QAA0B;AACnF,SAAO,eAAe,IAAI,MAAiC;AAC7D;AAKO,SAAS,oBACd,IACA,MACA,SACA,MACS;AACT,SAAO,aAAa,IAAI,IAAI,aAAa,SAAS,MAAM,IAAI,CAAC;AAC/D;AAKO,SAAS,aAAa,SAAkD;AAC7E,SAAO,aAAa,OAAO;AAC7B;AAKO,SAAS,mBAAmB,KAA6B;AAC9D,SAAO,mBAAmB,GAAG;AAC/B;AASO,SAAS,UAAU,QAAgC;AACxD,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,eAAe,QAAgC;AAC7D,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,kBAAkB,QAAgC;AAChE,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,gBAAgB,QAAgC;AAC9D,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,UAAU,QAAgC;AACxD,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,cAAc,QAE5B;AACA,MAAI,OAAO,SAAS,eAAgB,QAAO;AAC3C,QAAM,UAAU,OAAO;AACvB,SAAO,QAAQ,WAAW;AAC5B;AAKO,SAAS,aAAa,QAE3B;AACA,MAAI,OAAO,SAAS,eAAgB,QAAO;AAC3C,QAAM,UAAU,OAAO;AACvB,SAAO,QAAQ,WAAW;AAC5B;AASO,IAAM,uBAAkD;AAAA;AAAA,EAE7D,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,wBAAwB;AAAA;AAAA,EAExB,sBAAsB;AAAA,EACtB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,sBAAsB;AAAA,EACtB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,sBAAsB;AAAA,EACtB,wBAAwB;AAAA;AAAA,EAExB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,2BAA2B;AAAA,EAC3B,yBAAyB;AAAA;AAAA,EAEzB,sBAAsB;AACxB;AAKO,IAAM,0BAAqD;AAAA;AAAA,EAEhE,oBAAoB;AAAA,EACpB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA;AAAA,EAElB,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,kBAAkB;AAAA;AAAA,EAElB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA;AAAA,EAEnB,gBAAgB;AAClB;;;ACnSA,SAAS,YAAqB;AAE5B,QAAM,eAAe,OAAO,eAAe,cAAe,WAAmB,SAAS;AACtF,SAAO,cAAc,aAAa;AACpC;AA0EO,IAAM,YAAN,MAAgB;AAAA,EACJ;AAAA,EACA;AAAA,EACA,kBAAkB,oBAAI,IAAqC;AAAA,EAC3D,uBAAuB,oBAAI,IAAyB;AAAA,EACpD,sBAAsB,oBAAI,IAAwB;AAAA,EAE3D,KAAuB;AAAA,EACvB,QAAwB;AAAA,EACxB,YAAY;AAAA,EACZ,iBAAuD;AAAA,EACvD,WAAW;AAAA,EAEnB,YAAY,QAAyB;AACnC,SAAK,SAAS;AACd,SAAK,UAAU,OAAO,WAAW;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,kBAAkC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAqB;AACvB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAyB;AAC7B,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AAEA,QAAI,KAAK,UAAU,aAAa;AAC9B;AAAA,IACF;AAEA,SAAK,QAAQ;AAEb,UAAM,MAAM,KAAK,OAAO;AAGxB,QAAI;AACJ,QAAI,UAAU,GAAG;AACf,WAAK,IAAI,UAAU,GAAG;AAAA,IACxB,OAAO;AACL,YAAM,EAAE,SAAS,GAAG,IAAI,MAAM,OAAO,wBAAI;AACzC,WAAK,IAAI,GAAG,GAAG;AAAA,IACjB;AAEA,SAAK,KAAK;AAEV,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,SAAG,SAAS,YAAY;AACtB,aAAK,QAAQ;AAEb,YAAI,KAAK,OAAO,OAAO;AACrB,kBAAQ,IAAI,4BAA4B,GAAG;AAAA,QAC7C;AAGA,YAAI,UAAU,KAAK,KAAK,OAAO,SAAS;AACtC,gBAAM,UACJ,OAAO,KAAK,OAAO,YAAY,aAC3B,MAAM,KAAK,OAAO,QAAQ,IAC1B,KAAK,OAAO;AAClB,eAAK,OAAO,QAA8B,EAAE,QAAQ,CAAC;AAAA,QACvD;AAEA,gBAAQ;AAAA,MACV;AAEA,SAAG,UAAU,MAAM;AACjB,aAAK,QAAQ;AAEb,YAAI,KAAK,OAAO,OAAO;AACrB,kBAAQ,IAAI,0BAA0B;AAAA,QACxC;AAGA,YAAI,CAAC,KAAK,YAAY,KAAK,OAAO,kBAAkB,OAAO;AACzD,eAAK,kBAAkB;AAAA,QACzB;AAAA,MACF;AAEA,SAAG,UAAU,CAAC,QAAQ;AACpB,YAAI,KAAK,OAAO,OAAO;AACrB,kBAAQ,MAAM,gCAAgC,GAAG;AAAA,QACnD;AAEA,YAAI,KAAK,UAAU,cAAc;AAC/B,eAAK,QAAQ;AACb,iBAAO,IAAI,MAAM,6BAA6B,CAAC;AAAA,QACjD;AAAA,MACF;AAEA,SAAG,YAAY,CAAC,UAAU;AACxB,aAAK,cAAc,MAAM,IAAc;AAAA,MACzC;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,QAAI,KAAK,gBAAgB;AACvB,mBAAa,KAAK,cAAc;AAChC,WAAK,iBAAiB;AAAA,IACxB;AAEA,QAAI,KAAK,IAAI;AACX,WAAK,GAAG,MAAM;AACd,WAAK,KAAK;AAAA,IACZ;AAEA,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,WAAW;AAGhB,eAAW,CAAC,IAAI,OAAO,KAAK,KAAK,iBAAiB;AAChD,mBAAa,QAAQ,KAAK;AAC1B,cAAQ,OAAO,IAAI,MAAM,iBAAiB,CAAC;AAC3C,WAAK,gBAAgB,OAAO,EAAE;AAAA,IAChC;AAEA,SAAK,WAAW;AAChB,SAAK,qBAAqB,MAAM;AAChC,SAAK,oBAAoB,MAAM;AAE/B,QAAI,KAAK,OAAO,OAAO;AACrB,cAAQ,IAAI,sBAAsB;AAAA,IACpC;AAAA,EACF;AAAA,EAEQ,oBAA0B;AAChC,QAAI,KAAK,eAAgB;AAEzB,UAAM,QAAQ,KAAK,OAAO,kBAAkB;AAE5C,SAAK,iBAAiB,WAAW,YAAY;AAC3C,WAAK,iBAAiB;AAEtB,UAAI,CAAC,KAAK,YAAY,KAAK,UAAU,gBAAgB;AACnD,YAAI,KAAK,OAAO,OAAO;AACrB,kBAAQ,IAAI,wCAAwC;AAAA,QACtD;AAEA,YAAI;AACF,gBAAM,KAAK,QAAQ;AAAA,QACrB,QAAQ;AACN,eAAK,kBAAkB;AAAA,QACzB;AAAA,MACF;AAAA,IACF,GAAG,KAAK;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAkB,QAAmB,QAA6B;AACtE,QAAI,CAAC,KAAK,aAAa,CAAC,KAAK,IAAI;AAC/B,YAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAEA,UAAM,KAAK,EAAE,KAAK;AAClB,UAAM,UAAU,cAAc,IAAI,QAAQ,MAAM;AAEhD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,QAAQ,WAAW,MAAM;AAC7B,aAAK,gBAAgB,OAAO,EAAE;AAC9B,eAAO,IAAI,MAAM,oBAAoB,MAAM,EAAE,CAAC;AAAA,MAChD,GAAG,KAAK,OAAO;AAEf,WAAK,gBAAgB,IAAI,IAAI;AAAA,QAC3B;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,UAAI,KAAK,OAAO,OAAO;AACrB,gBAAQ,IAAI,gCAAgC,QAAQ,MAAM;AAAA,MAC5D;AAEA,WAAK,GAAI,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACvC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAqC,QAAuB;AACjE,QAAI,CAAC,KAAK,aAAa,CAAC,KAAK,IAAI;AAC/B,UAAI,KAAK,OAAO,OAAO;AACrB,gBAAQ,KAAK,qDAAqD;AAAA,MACpE;AACA;AAAA,IACF;AAEA,UAAM,eAAe,mBAAmB,QAA8B,MAAM;AAE5E,QAAI,KAAK,OAAO,OAAO;AACrB,cAAQ,IAAI,qCAAqC,QAAQ,MAAM;AAAA,IACjE;AAEA,SAAK,GAAG,KAAK,KAAK,UAAU,YAAY,CAAC;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,OAAqB;AAC7B,SAAK,OAAO,aAAa,EAAE,MAAM,CAAC;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,OAAqB;AAC/B,SAAK,OAAO,eAAe,EAAE,MAAM,CAAC;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,eAAe,SAA0C;AACvD,SAAK,qBAAqB,IAAI,OAAO;AACrC,WAAO,MAAM,KAAK,qBAAqB,OAAO,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,SAAyC;AACrD,SAAK,oBAAoB,IAAI,OAAO;AACpC,WAAO,MAAM,KAAK,oBAAoB,OAAO,OAAO;AAAA,EACtD;AAAA;AAAA,EAIQ,cAAc,MAAoB;AACxC,QAAI;AACF,YAAM,SAAS,aAAa,IAAI;AAGhC,UAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,aAAK,oBAAoB,MAAM;AAAA,MACjC,OAAO;AAEL,mBAAW,QAAQ,QAAQ;AACzB,eAAK,oBAAoB,IAAI;AAAA,QAC/B;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,KAAK,OAAO,OAAO;AACrB,gBAAQ,MAAM,wCAAwC,GAAG;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,oBAAoB,QAAoD;AAC9E,QAAI,kBAAkB,MAAM,GAAG;AAE7B,YAAM,UAAU,OAAO;AACvB,YAAM,UAAU,KAAK,gBAAgB,IAAI,QAAQ,EAAE;AAEnD,UAAI,SAAS;AACX,aAAK,gBAAgB,OAAO,QAAQ,EAAE;AACtC,qBAAa,QAAQ,KAAK;AAC1B,gBAAQ,QAAQ,QAAQ,MAAM;AAAA,MAChC;AAAA,IACF,WAAW,gBAAgB,MAAM,GAAG;AAElC,YAAM,UAAU,OAAO;AAKvB,UAAI,QAAQ,OAAO,MAAM;AACvB,cAAM,UAAU,KAAK,gBAAgB,IAAI,QAAQ,EAAE;AAEnD,YAAI,SAAS;AACX,eAAK,gBAAgB,OAAO,QAAQ,EAAE;AACtC,uBAAa,QAAQ,KAAK;AAC1B,kBAAQ,OAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,CAAC;AAAA,QACjD;AAAA,MACF;AAAA,IACF,WAAW,eAAe,MAAM,GAAG;AAEjC,YAAM,UAAU,OAAO;AAEvB,UAAI,KAAK,OAAO,OAAO;AACrB,gBAAQ,IAAI,sCAAsC,QAAQ,MAAM;AAAA,MAClE;AAGA,iBAAW,WAAW,KAAK,sBAAsB;AAC/C,gBAAQ,QAAQ,QAAQ,QAAQ,MAAM;AAAA,MACxC;AAGA,UAAI,cAAc,MAAM,GAAG;AACzB,cAAM,gBAAgB,OAAO;AAC7B,cAAM,EAAE,OAAO,MAAM,IAAI,cAAc;AAEvC,mBAAW,WAAW,KAAK,qBAAqB;AAC9C,kBAAQ,OAAO,KAAK;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/persistence/index.d.ts

@@ -0,0 +1,155 @@
+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 };

package/dist/persistence/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

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