@openai/agents-extensions 0.1.2 → 0.1.5

package/dist/CloudflareRealtimeTransport.d.ts

@@ -0,0 +1,21 @@
+import { RealtimeTransportLayer, OpenAIRealtimeWebSocket, OpenAIRealtimeWebSocketOptions } from '@openai/agents/realtime';
+/**
+ * An adapter transport for Cloudflare Workers (workerd) environments.
+ *
+ * Cloudflare Workers cannot open outbound client WebSockets using the global `WebSocket`
+ * constructor. Instead, a `fetch()` request with `Upgrade: websocket` must be performed and the
+ * returned `response.webSocket` must be `accept()`ed. This transport encapsulates that pattern and
+ * plugs into the Realtime SDK via the factory-based `createWebSocket` option.
+ *
+ * It behaves like `OpenAIRealtimeWebSocket`, but establishes the connection using `fetch()` and
+ * sets `skipOpenEventListeners: true` since workerd sockets do not emit a traditional `open`
+ * event after acceptance.
+ *
+ * Reference: Response API — `response.webSocket` (Cloudflare Workers).
+ * https://developers.cloudflare.com/workers/runtime-apis/response/.
+ */
+export declare class CloudflareRealtimeTransportLayer extends OpenAIRealtimeWebSocket implements RealtimeTransportLayer {
+    #private;
+    protected _audioLengthMs: number;
+    constructor(options: OpenAIRealtimeWebSocketOptions);
+}

package/dist/CloudflareRealtimeTransport.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareRealtimeTransportLayer = void 0;
+const realtime_1 = require("@openai/agents/realtime");
+/**
+ * An adapter transport for Cloudflare Workers (workerd) environments.
+ *
+ * Cloudflare Workers cannot open outbound client WebSockets using the global `WebSocket`
+ * constructor. Instead, a `fetch()` request with `Upgrade: websocket` must be performed and the
+ * returned `response.webSocket` must be `accept()`ed. This transport encapsulates that pattern and
+ * plugs into the Realtime SDK via the factory-based `createWebSocket` option.
+ *
+ * It behaves like `OpenAIRealtimeWebSocket`, but establishes the connection using `fetch()` and
+ * sets `skipOpenEventListeners: true` since workerd sockets do not emit a traditional `open`
+ * event after acceptance.
+ *
+ * Reference: Response API — `response.webSocket` (Cloudflare Workers).
+ * https://developers.cloudflare.com/workers/runtime-apis/response/.
+ */
+class CloudflareRealtimeTransportLayer extends realtime_1.OpenAIRealtimeWebSocket {
+    _audioLengthMs = 0;
+    constructor(options) {
+        super({
+            ...options,
+            createWebSocket: async ({ url, apiKey }) => {
+                return await this.#buildCloudflareWebSocket({ url, apiKey });
+            },
+            skipOpenEventListeners: true,
+        });
+    }
+    /**
+     * Builds a WebSocket using Cloudflare's `fetch()` + `Upgrade: websocket` flow and accepts it.
+     * Transforms `ws(s)` to `http(s)` for the upgrade request and forwards standard headers.
+     */
+    async #buildCloudflareWebSocket({ url, apiKey, }) {
+        const transformedUrl = url.replace(/^ws/i, 'http');
+        if (!transformedUrl) {
+            throw new Error('Realtime URL is not defined');
+        }
+        const response = await fetch(transformedUrl, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'Sec-WebSocket-Protocol': 'realtime',
+                Connection: 'Upgrade',
+                Upgrade: 'websocket',
+                ...this.getCommonRequestHeaders(),
+            },
+        });
+        const upgradedSocket = response.webSocket;
+        if (!upgradedSocket) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`Failed to upgrade websocket: ${response.status} ${body}`);
+        }
+        upgradedSocket.accept();
+        return upgradedSocket;
+    }
+}
+exports.CloudflareRealtimeTransportLayer = CloudflareRealtimeTransportLayer;
+//# sourceMappingURL=CloudflareRealtimeTransport.js.map

package/dist/CloudflareRealtimeTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareRealtimeTransport.js","sourceRoot":"","sources":["../src/CloudflareRealtimeTransport.ts"],"names":[],"mappings":";;;AAAA,sDAIiC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAa,gCACX,SAAQ,kCAAuB;IAGrB,cAAc,GAAW,CAAC,CAAC;IAErC,YAAY,OAAuC;QACjD,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,eAAe,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACzC,OAAO,MAAM,IAAI,CAAC,yBAAyB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,sBAAsB,EAAE,IAAI;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB,CAAC,EAC9B,GAAG,EACH,MAAM,GAIP;QACC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,wBAAwB,EAAE,UAAU;gBACpC,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,WAAW;gBACpB,GAAG,IAAI,CAAC,uBAAuB,EAAE;aAClC;SACF,CAAC,CAAC;QAEH,MAAM,cAAc,GAAI,QAAgB,CAAC,SAAS,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,cAAc,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,cAAsC,CAAC;IAChD,CAAC;CACF;AAtDD,4EAsDC"}

package/dist/CloudflareRealtimeTransport.mjs

@@ -0,0 +1,56 @@
+import { OpenAIRealtimeWebSocket, } from '@openai/agents/realtime';
+/**
+ * An adapter transport for Cloudflare Workers (workerd) environments.
+ *
+ * Cloudflare Workers cannot open outbound client WebSockets using the global `WebSocket`
+ * constructor. Instead, a `fetch()` request with `Upgrade: websocket` must be performed and the
+ * returned `response.webSocket` must be `accept()`ed. This transport encapsulates that pattern and
+ * plugs into the Realtime SDK via the factory-based `createWebSocket` option.
+ *
+ * It behaves like `OpenAIRealtimeWebSocket`, but establishes the connection using `fetch()` and
+ * sets `skipOpenEventListeners: true` since workerd sockets do not emit a traditional `open`
+ * event after acceptance.
+ *
+ * Reference: Response API — `response.webSocket` (Cloudflare Workers).
+ * https://developers.cloudflare.com/workers/runtime-apis/response/.
+ */
+export class CloudflareRealtimeTransportLayer extends OpenAIRealtimeWebSocket {
+    _audioLengthMs = 0;
+    constructor(options) {
+        super({
+            ...options,
+            createWebSocket: async ({ url, apiKey }) => {
+                return await this.#buildCloudflareWebSocket({ url, apiKey });
+            },
+            skipOpenEventListeners: true,
+        });
+    }
+    /**
+     * Builds a WebSocket using Cloudflare's `fetch()` + `Upgrade: websocket` flow and accepts it.
+     * Transforms `ws(s)` to `http(s)` for the upgrade request and forwards standard headers.
+     */
+    async #buildCloudflareWebSocket({ url, apiKey, }) {
+        const transformedUrl = url.replace(/^ws/i, 'http');
+        if (!transformedUrl) {
+            throw new Error('Realtime URL is not defined');
+        }
+        const response = await fetch(transformedUrl, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'Sec-WebSocket-Protocol': 'realtime',
+                Connection: 'Upgrade',
+                Upgrade: 'websocket',
+                ...this.getCommonRequestHeaders(),
+            },
+        });
+        const upgradedSocket = response.webSocket;
+        if (!upgradedSocket) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`Failed to upgrade websocket: ${response.status} ${body}`);
+        }
+        upgradedSocket.accept();
+        return upgradedSocket;
+    }
+}
+//# sourceMappingURL=CloudflareRealtimeTransport.mjs.map

package/dist/CloudflareRealtimeTransport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareRealtimeTransport.mjs","sourceRoot":"","sources":["../src/CloudflareRealtimeTransport.ts"],"names":[],"mappings":"OAAO,EAEL,uBAAuB,GAExB,MAAM,yBAAyB;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,gCACX,SAAQ,uBAAuB;IAGrB,cAAc,GAAW,CAAC,CAAC;IAErC,YAAY,OAAuC;QACjD,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,eAAe,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACzC,OAAO,MAAM,IAAI,CAAC,yBAAyB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,sBAAsB,EAAE,IAAI;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB,CAAC,EAC9B,GAAG,EACH,MAAM,GAIP;QACC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,wBAAwB,EAAE,UAAU;gBACpC,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,WAAW;gBACpB,GAAG,IAAI,CAAC,uBAAuB,EAAE;aAClC;SACF,CAAC,CAAC;QAEH,MAAM,cAAc,GAAI,QAAgB,CAAC,SAAS,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,cAAc,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,cAAsC,CAAC;IAChD,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export * from './TwilioRealtimeTransport';
 export * from './aiSdk';
+export * from './CloudflareRealtimeTransport';
+export * from './TwilioRealtimeTransport';

package/dist/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./TwilioRealtimeTransport.js"), exports);
 __exportStar(require("./aiSdk.js"), exports);
+__exportStar(require("./CloudflareRealtimeTransport.js"), exports);
+__exportStar(require("./TwilioRealtimeTransport.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA0C;AAC1C,6CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAAwB;AACxB,mEAA8C;AAC9C,+DAA0C"}

package/dist/index.mjs

@@ -1,3 +1,4 @@
-export * from "./TwilioRealtimeTransport.mjs";
 export * from "./aiSdk.mjs";
+export * from "./CloudflareRealtimeTransport.mjs";
+export * from "./TwilioRealtimeTransport.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/metadata.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.METADATA = void 0;
 exports.METADATA = {
     "name": "@openai/agents-extensions",
-    "version": "0.1.2",
+    "version": "0.1.5",
     "versions": {
-        "@openai/agents-extensions": "0.1.2"
+        "@openai/agents-extensions": "0.1.5"
     }
 };
 exports.default = exports.METADATA;

package/dist/metadata.mjs

@@ -1,9 +1,9 @@
 // This file is automatically generated
 export const METADATA = {
     "name": "@openai/agents-extensions",
-    "version": "0.1.2",
+    "version": "0.1.5",
     "versions": {
-        "@openai/agents-extensions": "0.1.2"
+        "@openai/agents-extensions": "0.1.5"
     }
 };
 export default METADATA;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@openai/agents-extensions",
   "repository": "https://github.com/openai/openai-agents-js",
   "homepage": "https://openai.github.io/openai-agents-js/",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Extensions for the OpenAI Agents SDK",
   "author": "OpenAI <support@openai.com>",
   "main": "dist/index.js",