/** Convert only the HTTP scheme; preserve the resolved endpoint path and query. */ export function toWebSocketUrl(url: string): string { const parsed = new URL(url); if (parsed.protocol === "https:") { parsed.protocol = "wss:"; } else if (parsed.protocol === "http:") { parsed.protocol = "ws:"; } return parsed.toString(); } function toHeaderRecord(value: unknown): Record | null { if (!value || typeof value !== "object") return null; const headers: Record = {}; for (const [key, entry] of Object.entries(value as Record)) { if (typeof entry === "string") { headers[key] = entry; } else if (Array.isArray(entry) && entry.every(item => typeof item === "string")) { headers[key] = entry.join(","); } else if (typeof entry === "number" || typeof entry === "boolean") { headers[key] = String(entry); } } return Object.keys(headers).length > 0 ? headers : null; } export function toWebSocketHeaders(value: unknown): Headers | undefined { if (!value) return undefined; if (value instanceof Headers) return value; if (Array.isArray(value)) { try { return new Headers(value as Array<[string, string]>); } catch { return undefined; } } const record = toHeaderRecord(value); if (!record) return undefined; return new Headers(record); } /** Bun versions expose upgrade headers in different places; absence is legitimate. */ export function extractWebSocketHandshakeHeaders(socket: Bun.WebSocket, openEvent?: Event): Headers | undefined { const eventRecord = openEvent as Record | undefined; const eventResponse = eventRecord?.response as Record | undefined; const socketRecord = socket as unknown as Record; const socketResponse = socketRecord.response as Record | undefined; const socketHandshake = socketRecord.handshake as Record | undefined; return ( toWebSocketHeaders(eventRecord?.responseHeaders) ?? toWebSocketHeaders(eventRecord?.headers) ?? toWebSocketHeaders(eventResponse?.headers) ?? toWebSocketHeaders(socketRecord.responseHeaders) ?? toWebSocketHeaders(socketRecord.handshakeHeaders) ?? toWebSocketHeaders(socketResponse?.headers) ?? toWebSocketHeaders(socketHandshake?.headers) ); } const OPENAI_RESPONSES_PROGRESS_EVENT_TYPES: ReadonlySet = new Set([ "response.created", "response.output_item.added", "response.reasoning_summary_part.added", "response.reasoning_summary_text.delta", "response.reasoning_summary_text.done", "response.reasoning_summary_part.done", "response.reasoning_text.delta", "response.content_part.added", "response.output_text.delta", "response.refusal.delta", "response.function_call_arguments.delta", "response.function_call_arguments.done", "response.custom_tool_call_input.delta", "response.custom_tool_call_input.done", "response.output_item.done", "response.completed", "response.incomplete", "response.failed", "error", ]); export function isOpenAIResponsesProgressEvent(event: unknown): boolean { if (!event || typeof event !== "object") return false; const type = (event as { type?: unknown }).type; return typeof type === "string" && OPENAI_RESPONSES_PROGRESS_EVENT_TYPES.has(type); }