@charivo/realtime-provider-openai 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zeikar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @charivo/realtime-provider-openai
+
+Server-side OpenAI realtime provider for Charivo.
+
+This package owns the OpenAI realtime session bootstrap call. In browser apps,
+pair it with a server route and consume that route through
+`@charivo/realtime-client-remote`.
+
+## Install
+
+```bash
+pnpm add @charivo/realtime-provider-openai
+```
+
+## Usage
+
+```ts
+import { createOpenAIRealtimeProvider } from "@charivo/realtime-provider-openai";
+
+const provider = createOpenAIRealtimeProvider({
+  apiKey: process.env.OPENAI_API_KEY!,
+});
+
+const session = await provider.createSession({
+  transport: "webrtc",
+  sdpOffer: "offer-sdp",
+  session: {
+    provider: "openai",
+    model: "gpt-realtime-mini",
+    voice: "marin",
+  },
+});
+```
+
+Returned bootstrap:
+
+```json
+{
+  "adapter": "openai-webrtc",
+  "transport": "webrtc",
+  "answerSdp": "..."
+}
+```
+
+## Config
+
+- `apiKey`
+- `baseUrl?` defaults to `https://api.openai.com/v1`
+- `dangerouslyAllowBrowser?` testing only

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { RealtimeProvider, RealtimeSessionRequest, RealtimeSessionBootstrap } from '@charivo/core';
+
+interface OpenAIRealtimeProviderConfig {
+    apiKey: string;
+    baseUrl?: string;
+    dangerouslyAllowBrowser?: boolean;
+}
+declare class OpenAIRealtimeProvider implements RealtimeProvider {
+    private config;
+    private endpoint;
+    constructor(config: OpenAIRealtimeProviderConfig);
+    createSession(request: RealtimeSessionRequest): Promise<RealtimeSessionBootstrap>;
+}
+declare function createOpenAIRealtimeProvider(config: OpenAIRealtimeProviderConfig): OpenAIRealtimeProvider;
+
+export { OpenAIRealtimeProvider, type OpenAIRealtimeProviderConfig, createOpenAIRealtimeProvider };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { RealtimeProvider, RealtimeSessionRequest, RealtimeSessionBootstrap } from '@charivo/core';
+
+interface OpenAIRealtimeProviderConfig {
+    apiKey: string;
+    baseUrl?: string;
+    dangerouslyAllowBrowser?: boolean;
+}
+declare class OpenAIRealtimeProvider implements RealtimeProvider {
+    private config;
+    private endpoint;
+    constructor(config: OpenAIRealtimeProviderConfig);
+    createSession(request: RealtimeSessionRequest): Promise<RealtimeSessionBootstrap>;
+}
+declare function createOpenAIRealtimeProvider(config: OpenAIRealtimeProviderConfig): OpenAIRealtimeProvider;
+
+export { OpenAIRealtimeProvider, type OpenAIRealtimeProviderConfig, createOpenAIRealtimeProvider };

package/dist/index.js

@@ -0,0 +1,96 @@
+'use strict';
+
+var core = require('@charivo/core');
+var shared = require('@charivo/shared');
+
+// src/index.ts
+var DEFAULT_REALTIME_URL = "https://api.openai.com/v1/realtime/calls";
+var OpenAIRealtimeProvider = class {
+  constructor(config) {
+    this.config = config;
+    if (typeof window !== "undefined" && !config.dangerouslyAllowBrowser) {
+      throw new Error(
+        "OpenAI realtime provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing"
+      );
+    }
+    this.endpoint = config.baseUrl ? `${config.baseUrl.replace(/\/$/, "")}/realtime/calls` : DEFAULT_REALTIME_URL;
+  }
+  endpoint;
+  async createSession(request) {
+    if (request.session.provider !== void 0 && request.session.provider !== "openai") {
+      throw new Error(
+        `OpenAI realtime provider only supports provider "openai", received ${request.session.provider}`
+      );
+    }
+    if (request.transport !== "webrtc") {
+      throw new Error(
+        `OpenAI realtime provider only supports webrtc transport, received ${request.transport}`
+      );
+    }
+    if (!request.sdpOffer) {
+      throw new Error("SDP offer is required for WebRTC realtime sessions");
+    }
+    const response = await shared.fetchWithTimeout(
+      this.endpoint,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`
+        },
+        body: toRealtimeFormData(request)
+      },
+      `OpenAI realtime request timed out after ${shared.DEFAULT_REQUEST_TIMEOUT_MS}ms`
+    );
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`OpenAI Realtime Error: ${errorText}`);
+    }
+    return {
+      adapter: core.OPENAI_REALTIME_ADAPTER,
+      transport: "webrtc",
+      answerSdp: await response.text()
+    };
+  }
+};
+function createOpenAIRealtimeProvider(config) {
+  return new OpenAIRealtimeProvider(config);
+}
+function toRealtimeFormData(request) {
+  const formData = new FormData();
+  formData.set("sdp", request.sdpOffer || "");
+  formData.set(
+    "session",
+    JSON.stringify(toOpenAIRealtimeSession(request.session))
+  );
+  return formData;
+}
+function toOpenAIRealtimeSession(session) {
+  const payload = {
+    type: "realtime",
+    model: session.model || "gpt-realtime-mini",
+    audio: {
+      output: {
+        voice: session.voice || "marin"
+      }
+    },
+    tool_choice: session.toolChoice ?? "auto"
+  };
+  if (session.instructions) {
+    payload.instructions = session.instructions;
+  }
+  if (session.temperature !== void 0) {
+    payload.temperature = session.temperature;
+  }
+  if (session.maxTokens !== void 0) {
+    payload.max_response_output_tokens = session.maxTokens;
+  }
+  if (session.tools?.length) {
+    payload.tools = session.tools;
+  }
+  return payload;
+}
+
+exports.OpenAIRealtimeProvider = OpenAIRealtimeProvider;
+exports.createOpenAIRealtimeProvider = createOpenAIRealtimeProvider;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["fetchWithTimeout","DEFAULT_REQUEST_TIMEOUT_MS","OPENAI_REALTIME_ADAPTER"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  RealtimeProvider,\n  RealtimeSessionBootstrap,\n  RealtimeSessionConfig,\n  RealtimeSessionRequest,\n} from \"@charivo/core\";\nimport { OPENAI_REALTIME_ADAPTER } from \"@charivo/core\";\nimport { DEFAULT_REQUEST_TIMEOUT_MS, fetchWithTimeout } from \"@charivo/shared\";\n\nconst DEFAULT_REALTIME_URL = \"https://api.openai.com/v1/realtime/calls\";\n\nexport interface OpenAIRealtimeProviderConfig {\n  apiKey: string;\n  baseUrl?: string;\n  dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAIRealtimeProvider implements RealtimeProvider {\n  private endpoint: string;\n\n  constructor(private config: OpenAIRealtimeProviderConfig) {\n    if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n      throw new Error(\n        \"OpenAI realtime provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n      );\n    }\n\n    this.endpoint = config.baseUrl\n      ? `${config.baseUrl.replace(/\\/$/, \"\")}/realtime/calls`\n      : DEFAULT_REALTIME_URL;\n  }\n\n  async createSession(\n    request: RealtimeSessionRequest,\n  ): Promise<RealtimeSessionBootstrap> {\n    if (\n      request.session.provider !== undefined &&\n      request.session.provider !== \"openai\"\n    ) {\n      throw new Error(\n        `OpenAI realtime provider only supports provider \"openai\", received ${request.session.provider}`,\n      );\n    }\n\n    if (request.transport !== \"webrtc\") {\n      throw new Error(\n        `OpenAI realtime provider only supports webrtc transport, received ${request.transport}`,\n      );\n    }\n\n    if (!request.sdpOffer) {\n      throw new Error(\"SDP offer is required for WebRTC realtime sessions\");\n    }\n\n    const response = await fetchWithTimeout(\n      this.endpoint,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.apiKey}`,\n        },\n        body: toRealtimeFormData(request),\n      },\n      `OpenAI realtime request timed out after ${DEFAULT_REQUEST_TIMEOUT_MS}ms`,\n    );\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw new Error(`OpenAI Realtime Error: ${errorText}`);\n    }\n\n    return {\n      adapter: OPENAI_REALTIME_ADAPTER,\n      transport: \"webrtc\",\n      answerSdp: await response.text(),\n    };\n  }\n}\n\nexport function createOpenAIRealtimeProvider(\n  config: OpenAIRealtimeProviderConfig,\n): OpenAIRealtimeProvider {\n  return new OpenAIRealtimeProvider(config);\n}\n\nfunction toRealtimeFormData(request: RealtimeSessionRequest): FormData {\n  const formData = new FormData();\n  formData.set(\"sdp\", request.sdpOffer || \"\");\n  formData.set(\n    \"session\",\n    JSON.stringify(toOpenAIRealtimeSession(request.session)),\n  );\n  return formData;\n}\n\nfunction toOpenAIRealtimeSession(\n  session: RealtimeSessionConfig,\n): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    type: \"realtime\",\n    model: session.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: session.voice || \"marin\",\n      },\n    },\n    tool_choice: session.toolChoice ?? \"auto\",\n  };\n\n  if (session.instructions) {\n    payload.instructions = session.instructions;\n  }\n\n  if (session.temperature !== undefined) {\n    payload.temperature = session.temperature;\n  }\n\n  if (session.maxTokens !== undefined) {\n    payload.max_response_output_tokens = session.maxTokens;\n  }\n\n  if (session.tools?.length) {\n    payload.tools = session.tools;\n  }\n\n  return payload;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,93 @@
+import { OPENAI_REALTIME_ADAPTER } from '@charivo/core';
+import { fetchWithTimeout, DEFAULT_REQUEST_TIMEOUT_MS } from '@charivo/shared';
+
+// src/index.ts
+var DEFAULT_REALTIME_URL = "https://api.openai.com/v1/realtime/calls";
+var OpenAIRealtimeProvider = class {
+  constructor(config) {
+    this.config = config;
+    if (typeof window !== "undefined" && !config.dangerouslyAllowBrowser) {
+      throw new Error(
+        "OpenAI realtime provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing"
+      );
+    }
+    this.endpoint = config.baseUrl ? `${config.baseUrl.replace(/\/$/, "")}/realtime/calls` : DEFAULT_REALTIME_URL;
+  }
+  endpoint;
+  async createSession(request) {
+    if (request.session.provider !== void 0 && request.session.provider !== "openai") {
+      throw new Error(
+        `OpenAI realtime provider only supports provider "openai", received ${request.session.provider}`
+      );
+    }
+    if (request.transport !== "webrtc") {
+      throw new Error(
+        `OpenAI realtime provider only supports webrtc transport, received ${request.transport}`
+      );
+    }
+    if (!request.sdpOffer) {
+      throw new Error("SDP offer is required for WebRTC realtime sessions");
+    }
+    const response = await fetchWithTimeout(
+      this.endpoint,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`
+        },
+        body: toRealtimeFormData(request)
+      },
+      `OpenAI realtime request timed out after ${DEFAULT_REQUEST_TIMEOUT_MS}ms`
+    );
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`OpenAI Realtime Error: ${errorText}`);
+    }
+    return {
+      adapter: OPENAI_REALTIME_ADAPTER,
+      transport: "webrtc",
+      answerSdp: await response.text()
+    };
+  }
+};
+function createOpenAIRealtimeProvider(config) {
+  return new OpenAIRealtimeProvider(config);
+}
+function toRealtimeFormData(request) {
+  const formData = new FormData();
+  formData.set("sdp", request.sdpOffer || "");
+  formData.set(
+    "session",
+    JSON.stringify(toOpenAIRealtimeSession(request.session))
+  );
+  return formData;
+}
+function toOpenAIRealtimeSession(session) {
+  const payload = {
+    type: "realtime",
+    model: session.model || "gpt-realtime-mini",
+    audio: {
+      output: {
+        voice: session.voice || "marin"
+      }
+    },
+    tool_choice: session.toolChoice ?? "auto"
+  };
+  if (session.instructions) {
+    payload.instructions = session.instructions;
+  }
+  if (session.temperature !== void 0) {
+    payload.temperature = session.temperature;
+  }
+  if (session.maxTokens !== void 0) {
+    payload.max_response_output_tokens = session.maxTokens;
+  }
+  if (session.tools?.length) {
+    payload.tools = session.tools;
+  }
+  return payload;
+}
+
+export { OpenAIRealtimeProvider, createOpenAIRealtimeProvider };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type {\n  RealtimeProvider,\n  RealtimeSessionBootstrap,\n  RealtimeSessionConfig,\n  RealtimeSessionRequest,\n} from \"@charivo/core\";\nimport { OPENAI_REALTIME_ADAPTER } from \"@charivo/core\";\nimport { DEFAULT_REQUEST_TIMEOUT_MS, fetchWithTimeout } from \"@charivo/shared\";\n\nconst DEFAULT_REALTIME_URL = \"https://api.openai.com/v1/realtime/calls\";\n\nexport interface OpenAIRealtimeProviderConfig {\n  apiKey: string;\n  baseUrl?: string;\n  dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAIRealtimeProvider implements RealtimeProvider {\n  private endpoint: string;\n\n  constructor(private config: OpenAIRealtimeProviderConfig) {\n    if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n      throw new Error(\n        \"OpenAI realtime provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n      );\n    }\n\n    this.endpoint = config.baseUrl\n      ? `${config.baseUrl.replace(/\\/$/, \"\")}/realtime/calls`\n      : DEFAULT_REALTIME_URL;\n  }\n\n  async createSession(\n    request: RealtimeSessionRequest,\n  ): Promise<RealtimeSessionBootstrap> {\n    if (\n      request.session.provider !== undefined &&\n      request.session.provider !== \"openai\"\n    ) {\n      throw new Error(\n        `OpenAI realtime provider only supports provider \"openai\", received ${request.session.provider}`,\n      );\n    }\n\n    if (request.transport !== \"webrtc\") {\n      throw new Error(\n        `OpenAI realtime provider only supports webrtc transport, received ${request.transport}`,\n      );\n    }\n\n    if (!request.sdpOffer) {\n      throw new Error(\"SDP offer is required for WebRTC realtime sessions\");\n    }\n\n    const response = await fetchWithTimeout(\n      this.endpoint,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.apiKey}`,\n        },\n        body: toRealtimeFormData(request),\n      },\n      `OpenAI realtime request timed out after ${DEFAULT_REQUEST_TIMEOUT_MS}ms`,\n    );\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw new Error(`OpenAI Realtime Error: ${errorText}`);\n    }\n\n    return {\n      adapter: OPENAI_REALTIME_ADAPTER,\n      transport: \"webrtc\",\n      answerSdp: await response.text(),\n    };\n  }\n}\n\nexport function createOpenAIRealtimeProvider(\n  config: OpenAIRealtimeProviderConfig,\n): OpenAIRealtimeProvider {\n  return new OpenAIRealtimeProvider(config);\n}\n\nfunction toRealtimeFormData(request: RealtimeSessionRequest): FormData {\n  const formData = new FormData();\n  formData.set(\"sdp\", request.sdpOffer || \"\");\n  formData.set(\n    \"session\",\n    JSON.stringify(toOpenAIRealtimeSession(request.session)),\n  );\n  return formData;\n}\n\nfunction toOpenAIRealtimeSession(\n  session: RealtimeSessionConfig,\n): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    type: \"realtime\",\n    model: session.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: session.voice || \"marin\",\n      },\n    },\n    tool_choice: session.toolChoice ?? \"auto\",\n  };\n\n  if (session.instructions) {\n    payload.instructions = session.instructions;\n  }\n\n  if (session.temperature !== undefined) {\n    payload.temperature = session.temperature;\n  }\n\n  if (session.maxTokens !== undefined) {\n    payload.max_response_output_tokens = session.maxTokens;\n  }\n\n  if (session.tools?.length) {\n    payload.tools = session.tools;\n  }\n\n  return payload;\n}\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@charivo/realtime-provider-openai",
+  "version": "0.2.0",
+  "description": "OpenAI realtime provider for Charivo (server-side)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@charivo/core": "0.3.0",
+    "@charivo/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zeikar/charivo.git",
+    "directory": "packages/realtime-provider-openai"
+  },
+  "author": {
+    "name": "Zeikar",
+    "url": "https://github.com/zeikar"
+  },
+  "homepage": "https://github.com/zeikar/charivo#readme",
+  "bugs": {
+    "url": "https://github.com/zeikar/charivo/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}