Skip to content

πŸ™Œ OpenHands: AI-Driven Development

4.5 KB
Raw Blame
/**
 * Extracts the base host from conversation URL
 * @param conversationUrl The conversation URL containing host/port (e.g., "http://localhost:3000/api/conversations/123")
 * @returns Base host (e.g., "localhost:3000") or window.location.host as fallback
 */
function extractBaseHost(conversationUrl: string | null | undefined): string {
  if (conversationUrl && !conversationUrl.startsWith("/")) {
    try {
      const url = new URL(conversationUrl);
      // If the conversation URL points to localhost but we're accessing from external,
      // use the browser's hostname with the conversation URL's port
      const urlHostname = url.hostname;
      const browserHostname =
        window.location.hostname ?? window.location.host?.split(":")[0];
      if (
        browserHostname &&
        (urlHostname === "localhost" || urlHostname === "127.0.0.1") &&
        browserHostname !== "localhost" &&
        browserHostname !== "127.0.0.1"
      ) {
        return `${browserHostname}:${url.port}`;
      }
      return url.host; // e.g., "localhost:3000"
    } catch {
      return window.location.host;
    }
  }
  return window.location.host;
}

/**
 * Extracts the path prefix from conversation URL (everything before /api/conversations)
 * This is needed for proxy deployments where agent-servers are accessed via paths like /runtime/{port}/
 * @param conversationUrl The conversation URL (e.g., "http://localhost:3000/runtime/55313/api/conversations/123")
 * @returns Path prefix without trailing slash (e.g., "/runtime/55313") or empty string
 */
function extractPathPrefix(conversationUrl: string | null | undefined): string {
  if (conversationUrl && !conversationUrl.startsWith("/")) {
    try {
      const url = new URL(conversationUrl);
      const pathBeforeApi = url.pathname.split("/api/conversations")[0] || "";
      return pathBeforeApi.replace(/\/$/, ""); // Remove trailing slash
    } catch {
      return "";
    }
  }
  return "";
}

/**
 * Builds the HTTP base URL for V1 API calls
 * @param conversationUrl The conversation URL containing host/port
 * @returns HTTP base URL (e.g., "http://localhost:3000" or "http://localhost:3000/runtime/55313")
 */
export function buildHttpBaseUrl(
  conversationUrl: string | null | undefined,
): string {
  const baseHost = extractBaseHost(conversationUrl);
  const pathPrefix = extractPathPrefix(conversationUrl);
  const pageIsSecure = window.location.protocol === "https:";
  const targetIsSecure =
    getConversationUrlProtocol(conversationUrl) === "https:";
  const protocol = pageIsSecure || targetIsSecure ? "https:" : "http:";
  return `${protocol}//${baseHost}${pathPrefix}`;
}

function getConversationUrlProtocol(
  conversationUrl: string | null | undefined,
): string | null {
  if (!conversationUrl || conversationUrl.startsWith("/")) {
    return null;
  }

  try {
    return new URL(conversationUrl).protocol;
  } catch {
    return null;
  }
}

/**
 * Builds the WebSocket URL for V1 conversations (without query params)
 * @param conversationId The conversation ID
 * @param conversationUrl The conversation URL containing host/port (e.g., "http://localhost:3000/api/conversations/123")
 * @returns WebSocket URL or null if inputs are invalid
 */
export function buildWebSocketUrl(
  conversationId: string | undefined,
  conversationUrl: string | null | undefined,
): string | null {
  if (!conversationId) {
    return null;
  }

  const baseHost = extractBaseHost(conversationUrl);
  const pathPrefix = extractPathPrefix(conversationUrl);

  // Build WebSocket URL: ws://host:port[/path-prefix]/sockets/session/{conversationId}
  // The session endpoint speaks the envelope protocol (durable events plus
  // stream-progress frames); the legacy /sockets/events endpoint is frozen.
  // The path prefix (e.g., /runtime/55313) is needed for proxy deployments
  // Note: Query params should be passed via the useWebSocket hook options
  //
  // Protocol selection follows the actual HTTP access path. A page served
  // over HTTPS must use WSS, but an HTTP page that reaches a remote dev ingress
  // over plain HTTP (for example a Tailscale hostname) must use WS; forcing WSS
  // sends a TLS handshake to the HTTP-only ingress and Node reports it as a
  // malformed HTTP method.
  const pageIsSecure = window.location.protocol === "https:";
  const targetIsSecure =
    getConversationUrlProtocol(conversationUrl) === "https:";
  const protocol = pageIsSecure || targetIsSecure ? "wss:" : "ws:";

  return `${protocol}//${baseHost}${pathPrefix}/sockets/session/${conversationId}`;
}