@openai/agents-openai 0.4.14 → 0.5.0

package/dist/responsesWebSocketConnection.mjs

@@ -0,0 +1,259 @@
+import { UserError } from '@openai/agents-core';
+import OpenAI from 'openai';
+export class ResponsesWebSocketInternalError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ResponsesWebSocketInternalError';
+        this.code = code;
+    }
+}
+export function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new OpenAI.APIUserAbortError();
+    }
+}
+export async function withAbortSignal(promise, signal) {
+    throwIfAborted(signal);
+    if (!signal) {
+        return promise;
+    }
+    return await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new OpenAI.APIUserAbortError());
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+export async function withTimeout(promise, timeoutMs, errorMessage) {
+    if (typeof timeoutMs !== 'number' ||
+        !Number.isFinite(timeoutMs) ||
+        timeoutMs <= 0) {
+        return await promise;
+    }
+    return await new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            reject(new Error(errorMessage));
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timeoutId);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+export async function webSocketFrameToText(frame) {
+    if (typeof frame === 'string') {
+        return frame;
+    }
+    if (typeof Blob !== 'undefined' && frame instanceof Blob) {
+        return await frame.text();
+    }
+    if (frame instanceof ArrayBuffer) {
+        return new TextDecoder().decode(new Uint8Array(frame));
+    }
+    if (ArrayBuffer.isView(frame)) {
+        return new TextDecoder().decode(new Uint8Array(frame.buffer, frame.byteOffset, frame.byteLength));
+    }
+    throw new Error('Unsupported websocket frame type for Responses API.');
+}
+export function shouldWrapNoEventWebSocketError(error) {
+    if (error instanceof ResponsesWebSocketInternalError) {
+        return (error.code === 'connection_closed_before_opening' ||
+            error.code === 'connection_closed_before_terminal_response_event');
+    }
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return (error.message === 'Responses websocket connection closed before opening.' ||
+        error.message ===
+            'Responses websocket connection closed before a terminal response event.');
+}
+export function isWebSocketNotOpenError(error) {
+    if (error instanceof ResponsesWebSocketInternalError) {
+        return error.code === 'socket_not_open';
+    }
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    if (error.message === 'Responses websocket is not open.') {
+        return true;
+    }
+    // Native WebSocket implementations can throw InvalidStateError/DOMException
+    // if the socket closes after the readyState check but before send().
+    if (error.name === 'InvalidStateError') {
+        return true;
+    }
+    // `ws` throws a plain Error with this message shape for send races.
+    if (error.message.startsWith('WebSocket is not open: readyState ')) {
+        return true;
+    }
+    return false;
+}
+export class ResponsesWebSocketConnection {
+    #socket;
+    #messages = [];
+    #waiters = [];
+    #closed = false;
+    #error;
+    #closedPromise;
+    #resolveClosed;
+    constructor(socket) {
+        this.#socket = socket;
+        this.#closedPromise = new Promise((resolve) => {
+            this.#resolveClosed = resolve;
+        });
+        this.#socket.addEventListener('message', this.#onMessage);
+        this.#socket.addEventListener('error', this.#onError);
+        this.#socket.addEventListener('close', this.#onClose);
+    }
+    static async connect(url, headers, signal, timeoutMs, timeoutErrorMessage) {
+        const WebSocketCtor = globalThis.WebSocket;
+        if (!WebSocketCtor) {
+            throw new UserError('Responses websocket transport requires a global WebSocket implementation.');
+        }
+        let socket;
+        try {
+            socket = new WebSocketCtor(url, { headers });
+        }
+        catch (error) {
+            const wrappedError = new UserError('Responses websocket transport requires a WebSocket implementation that supports custom headers.');
+            wrappedError.cause = error;
+            throw wrappedError;
+        }
+        const connection = new ResponsesWebSocketConnection(socket);
+        try {
+            await connection.waitForOpen(signal, timeoutMs, timeoutErrorMessage);
+        }
+        catch (error) {
+            await connection.close();
+            throw error;
+        }
+        return connection;
+    }
+    async waitForOpen(signal, timeoutMs, timeoutErrorMessage) {
+        if (this.#socket.readyState === this.#socket.OPEN) {
+            return;
+        }
+        if (this.#error) {
+            throw this.#error;
+        }
+        if (this.#closed ||
+            this.#socket.readyState === this.#socket.CLOSED ||
+            this.#socket.readyState === this.#socket.CLOSING) {
+            throw new ResponsesWebSocketInternalError('connection_closed_before_opening', 'Responses websocket connection closed before opening.');
+        }
+        const openPromise = new Promise((resolve, reject) => {
+            const onOpen = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = () => {
+                cleanup();
+                reject(this.#error ??
+                    new Error('Responses websocket connection failed to open.'));
+            };
+            const onClose = () => {
+                cleanup();
+                reject(this.#error ??
+                    new ResponsesWebSocketInternalError('connection_closed_before_opening', 'Responses websocket connection closed before opening.'));
+            };
+            const cleanup = () => {
+                this.#socket.removeEventListener('open', onOpen);
+                this.#socket.removeEventListener('error', onError);
+                this.#socket.removeEventListener('close', onClose);
+            };
+            this.#socket.addEventListener('open', onOpen);
+            this.#socket.addEventListener('error', onError);
+            this.#socket.addEventListener('close', onClose);
+        });
+        await withAbortSignal(withTimeout(openPromise, timeoutMs, timeoutErrorMessage ??
+            `Responses websocket connection timed out before opening after ${timeoutMs}ms.`), signal);
+    }
+    async send(data) {
+        if (this.#socket.readyState !== this.#socket.OPEN) {
+            throw new ResponsesWebSocketInternalError('socket_not_open', 'Responses websocket is not open.');
+        }
+        this.#socket.send(data);
+    }
+    isReusable() {
+        return (!this.#closed &&
+            !this.#error &&
+            this.#socket.readyState === this.#socket.OPEN);
+    }
+    async nextFrame(signal) {
+        throwIfAborted(signal);
+        return await withAbortSignal(this.#nextFrameInternal(), signal);
+    }
+    async close() {
+        if (!this.#closed) {
+            try {
+                this.#socket.close();
+            }
+            catch {
+                // Ignore close errors and wait for the socket to settle.
+            }
+        }
+        await this.#closedPromise;
+    }
+    async #nextFrameInternal() {
+        if (this.#messages.length > 0) {
+            return this.#messages.shift() ?? null;
+        }
+        if (this.#error) {
+            throw this.#error;
+        }
+        if (this.#closed) {
+            return null;
+        }
+        return await new Promise((resolve, reject) => {
+            this.#waiters.push({ resolve, reject });
+        });
+    }
+    #onMessage = (event) => {
+        const data = event.data;
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            waiter.resolve(data);
+            return;
+        }
+        this.#messages.push(data);
+    };
+    #onError = (event) => {
+        const maybeError = event?.error;
+        const maybeMessage = event?.message;
+        this.#error =
+            maybeError instanceof Error
+                ? maybeError
+                : new Error(typeof maybeMessage === 'string' && maybeMessage.length > 0
+                    ? maybeMessage
+                    : 'Responses websocket connection error.');
+        const waiters = this.#waiters.splice(0);
+        for (const waiter of waiters) {
+            waiter.reject(this.#error);
+        }
+    };
+    #onClose = () => {
+        this.#closed = true;
+        this.#resolveClosed();
+        const waiters = this.#waiters.splice(0);
+        for (const waiter of waiters) {
+            if (this.#error) {
+                waiter.reject(this.#error);
+            }
+            else {
+                waiter.resolve(null);
+            }
+        }
+    };
+}
+//# sourceMappingURL=responsesWebSocketConnection.mjs.map

package/dist/responsesWebSocketConnection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsesWebSocketConnection.mjs","sourceRoot":"","sources":["../src/responsesWebSocketConnection.ts"],"names":[],"mappings":"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"}

package/dist/responsesWebSocketSession.d.ts

@@ -0,0 +1,22 @@
+import { Runner, type RunConfig } from '@openai/agents-core';
+import { OpenAIProvider, type OpenAIProviderOptions } from './openaiProvider';
+export type ResponsesWebSocketSessionOptions = {
+    /**
+     * Options used to construct the session-scoped OpenAI provider.
+     */
+    providerOptions?: OpenAIProviderOptions;
+    /**
+     * Runner configuration for the session. modelProvider is controlled by this helper.
+     */
+    runnerConfig?: Omit<Partial<RunConfig>, 'modelProvider'>;
+};
+export type ResponsesWebSocketSession = {
+    provider: OpenAIProvider;
+    runner: Runner;
+    run: Runner['run'];
+};
+/**
+ * Runs a callback within a session-scoped Responses API websocket provider/runner and closes the
+ * provider afterwards so websocket connections do not keep the process alive.
+ */
+export declare function withResponsesWebSocketSession<T>(callback: (session: ResponsesWebSocketSession) => Promise<T> | T, options?: ResponsesWebSocketSessionOptions): Promise<T>;

package/dist/responsesWebSocketSession.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withResponsesWebSocketSession = withResponsesWebSocketSession;
+const agents_core_1 = require("@openai/agents-core");
+const openaiProvider_1 = require("./openaiProvider.js");
+function attachCleanupErrorToThrownError(callbackError, cleanupError) {
+    if (!(callbackError instanceof Error)) {
+        return;
+    }
+    const callbackErrorWithMetadata = callbackError;
+    if (typeof callbackErrorWithMetadata.cause === 'undefined') {
+        callbackErrorWithMetadata.cause = cleanupError;
+        return;
+    }
+    callbackErrorWithMetadata.cleanupError = cleanupError;
+}
+/**
+ * Runs a callback within a session-scoped Responses API websocket provider/runner and closes the
+ * provider afterwards so websocket connections do not keep the process alive.
+ */
+async function withResponsesWebSocketSession(callback, options = {}) {
+    const provider = new openaiProvider_1.OpenAIProvider({
+        ...(options.providerOptions ?? {}),
+        useResponses: true,
+        useResponsesWebSocket: true,
+    });
+    const runner = new agents_core_1.Runner({
+        ...(options.runnerConfig ?? {}),
+        modelProvider: provider,
+    });
+    const run = runner.run.bind(runner);
+    let callbackFailed = false;
+    let callbackError;
+    let callbackResult;
+    try {
+        callbackResult = await callback({ provider, runner, run });
+    }
+    catch (error) {
+        callbackFailed = true;
+        callbackError = error;
+    }
+    try {
+        await provider.close();
+    }
+    catch (closeError) {
+        if (!callbackFailed) {
+            throw closeError;
+        }
+        attachCleanupErrorToThrownError(callbackError, closeError);
+    }
+    if (callbackFailed) {
+        throw callbackError;
+    }
+    return callbackResult;
+}
+//# sourceMappingURL=responsesWebSocketSession.js.map

package/dist/responsesWebSocketSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsesWebSocketSession.js","sourceRoot":"","sources":["../src/responsesWebSocketSession.ts"],"names":[],"mappings":";;AA6CA,sEAwCC;AArFD,qDAA6D;AAC7D,wDAA8E;AAmB9E,SAAS,+BAA+B,CACtC,aAAsB,EACtB,YAAqB;IAErB,IAAI,CAAC,CAAC,aAAa,YAAY,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,yBAAyB,GAAG,aAGjC,CAAC;IAEF,IAAI,OAAO,yBAAyB,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC3D,yBAAyB,CAAC,KAAK,GAAG,YAAY,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,yBAAyB,CAAC,YAAY,GAAG,YAAY,CAAC;AACxD,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CACjD,QAAgE,EAChE,UAA4C,EAAE;IAE9C,MAAM,QAAQ,GAAG,IAAI,+BAAc,CAAC;QAClC,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;QAClC,YAAY,EAAE,IAAI;QAClB,qBAAqB,EAAE,IAAI;KAC5B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,oBAAM,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/B,aAAa,EAAE,QAAQ;KACxB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAkB,CAAC;IAErD,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,aAAsB,CAAC;IAC3B,IAAI,cAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,GAAG,IAAI,CAAC;QACtB,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,UAAU,CAAC;QACnB,CAAC;QACD,+BAA+B,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,aAAa,CAAC;IACtB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/responsesWebSocketSession.mjs

@@ -0,0 +1,53 @@
+import { Runner } from '@openai/agents-core';
+import { OpenAIProvider } from "./openaiProvider.mjs";
+function attachCleanupErrorToThrownError(callbackError, cleanupError) {
+    if (!(callbackError instanceof Error)) {
+        return;
+    }
+    const callbackErrorWithMetadata = callbackError;
+    if (typeof callbackErrorWithMetadata.cause === 'undefined') {
+        callbackErrorWithMetadata.cause = cleanupError;
+        return;
+    }
+    callbackErrorWithMetadata.cleanupError = cleanupError;
+}
+/**
+ * Runs a callback within a session-scoped Responses API websocket provider/runner and closes the
+ * provider afterwards so websocket connections do not keep the process alive.
+ */
+export async function withResponsesWebSocketSession(callback, options = {}) {
+    const provider = new OpenAIProvider({
+        ...(options.providerOptions ?? {}),
+        useResponses: true,
+        useResponsesWebSocket: true,
+    });
+    const runner = new Runner({
+        ...(options.runnerConfig ?? {}),
+        modelProvider: provider,
+    });
+    const run = runner.run.bind(runner);
+    let callbackFailed = false;
+    let callbackError;
+    let callbackResult;
+    try {
+        callbackResult = await callback({ provider, runner, run });
+    }
+    catch (error) {
+        callbackFailed = true;
+        callbackError = error;
+    }
+    try {
+        await provider.close();
+    }
+    catch (closeError) {
+        if (!callbackFailed) {
+            throw closeError;
+        }
+        attachCleanupErrorToThrownError(callbackError, closeError);
+    }
+    if (callbackFailed) {
+        throw callbackError;
+    }
+    return callbackResult;
+}
+//# sourceMappingURL=responsesWebSocketSession.mjs.map

package/dist/responsesWebSocketSession.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsesWebSocketSession.mjs","sourceRoot":"","sources":["../src/responsesWebSocketSession.ts"],"names":[],"mappings":"OAAO,EAAE,MAAM,EAAkB,MAAM,qBAAqB;OACrD,EAAE,cAAc,EAA8B;AAmBrD,SAAS,+BAA+B,CACtC,aAAsB,EACtB,YAAqB;IAErB,IAAI,CAAC,CAAC,aAAa,YAAY,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,yBAAyB,GAAG,aAGjC,CAAC;IAEF,IAAI,OAAO,yBAAyB,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC3D,yBAAyB,CAAC,KAAK,GAAG,YAAY,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,yBAAyB,CAAC,YAAY,GAAG,YAAY,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,QAAgE,EAChE,UAA4C,EAAE;IAE9C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;QAClC,YAAY,EAAE,IAAI;QAClB,qBAAqB,EAAE,IAAI;KAC5B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/B,aAAa,EAAE,QAAQ;KACxB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAkB,CAAC;IAErD,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,aAAsB,CAAC;IAC3B,IAAI,cAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,GAAG,IAAI,CAAC;QACtB,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,UAAU,CAAC;QACnB,CAAC;QACD,+BAA+B,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,aAAa,CAAC;IACtB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@openai/agents-openai",
   "repository": "https://github.com/openai/openai-agents-js",
   "homepage": "https://openai.github.io/openai-agents-js/",
-  "version": "0.4.14",
+  "version": "0.5.0",
   "description": "The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows.",
   "author": "OpenAI <support@openai.com>",
   "main": "dist/index.js",
@@ -17,7 +17,7 @@
   "dependencies": {
     "debug": "^4.4.0",
     "openai": "^6.20.0",
-    "@openai/agents-core": "0.4.14"
+    "@openai/agents-core": "0.5.0"
   },
   "keywords": [
     "openai",