@openai/agents-realtime 0.7.2 → 0.8.1

package/dist/responseCreateSequencer.d.ts

@@ -0,0 +1,27 @@
+import type { RealtimeClientMessage } from './clientMessages';
+export type ResponseCreateControl = 'free' | 'create_requested' | 'cancel_requested';
+type ResponseCreateErrorEvent = {
+    error?: {
+        code?: unknown;
+        message?: unknown;
+        event_id?: unknown;
+    };
+};
+export declare class ResponseCreateSequencer {
+    #private;
+    private readonly sendEventNow;
+    private readonly onError?;
+    constructor(sendEventNow: (event: RealtimeClientMessage) => void, onError?: ((error: unknown) => void) | undefined);
+    get ongoingResponse(): boolean;
+    get responseControl(): ResponseCreateControl;
+    get pendingResponseCreateEventId(): string | null;
+    requestResponseCreate(event: RealtimeClientMessage, { manual }?: {
+        manual?: boolean;
+    }): void;
+    markResponseCreated(): void;
+    markResponseDone(): void;
+    releaseWaiters(): void;
+    beginCancelResponse(): boolean;
+    handleResponseCreateError(event: ResponseCreateErrorEvent): boolean;
+}
+export {};

package/dist/responseCreateSequencer.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseCreateSequencer = void 0;
+class ResponseCreateSequencer {
+    sendEventNow;
+    onError;
+    #ongoingResponse = false;
+    #responseControl = 'free';
+    #responseCreateRequestVersion = 0;
+    #responseCreateEventCounter = 0;
+    #pendingRequestVersions = new Set();
+    #manualResponseCreateVersions = new Set();
+    #pendingResponseCreate = null;
+    #waiters = new Set();
+    #generation = 0;
+    constructor(sendEventNow, onError) {
+        this.sendEventNow = sendEventNow;
+        this.onError = onError;
+    }
+    get ongoingResponse() {
+        return this.#ongoingResponse;
+    }
+    get responseControl() {
+        return this.#responseControl;
+    }
+    get pendingResponseCreateEventId() {
+        return this.#pendingResponseCreate?.eventId ?? null;
+    }
+    requestResponseCreate(event, { manual = false } = {}) {
+        const requestVersion = this.#reserveResponseCreateRequest(manual);
+        const generation = this.#generation;
+        const pending = this.#tryPrepareResponseCreate({
+            event,
+            manual,
+            requestVersion,
+        });
+        if (pending) {
+            this.#dispatchResponseCreate(pending, generation);
+            return;
+        }
+        void this.#startResponseCreate({
+            event,
+            manual,
+            requestVersion,
+            generation,
+        });
+    }
+    markResponseCreated() {
+        this.#ongoingResponse = true;
+        this.#clearAcceptedResponseCreate();
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    markResponseDone() {
+        this.#ongoingResponse = false;
+        this.#clearAcceptedResponseCreate();
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    releaseWaiters() {
+        this.#generation += 1;
+        this.#ongoingResponse = false;
+        this.#pendingRequestVersions.clear();
+        this.#manualResponseCreateVersions.clear();
+        this.#pendingResponseCreate = null;
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    beginCancelResponse() {
+        if (!this.#ongoingResponse ||
+            this.#responseControl === 'cancel_requested') {
+            return false;
+        }
+        this.#responseControl = 'cancel_requested';
+        this.#notifyWaiters();
+        return true;
+    }
+    handleResponseCreateError(event) {
+        const error = event.error;
+        const linkedEventId = typeof error?.event_id === 'string' ? error.event_id : undefined;
+        if (linkedEventId) {
+            return this.#clearPendingResponseCreate(linkedEventId);
+        }
+        if (this.#isResponseCreateLikeError(error)) {
+            return this.#clearPendingResponseCreate();
+        }
+        return false;
+    }
+    #reserveResponseCreateRequest(manual) {
+        this.#responseCreateRequestVersion += 1;
+        const requestVersion = this.#responseCreateRequestVersion;
+        this.#pendingRequestVersions.add(requestVersion);
+        if (manual) {
+            this.#manualResponseCreateVersions.add(requestVersion);
+        }
+        this.#notifyWaiters();
+        return requestVersion;
+    }
+    async #startResponseCreate({ event, manual, requestVersion, generation, }) {
+        const pending = await this.#waitForResponseCreateSlot({
+            event,
+            manual,
+            requestVersion,
+            generation,
+        });
+        if (!pending || generation !== this.#generation) {
+            return;
+        }
+        this.#dispatchResponseCreate(pending, generation);
+    }
+    #dispatchResponseCreate(pending, generation) {
+        if (generation !== this.#generation) {
+            return;
+        }
+        try {
+            this.sendEventNow(pending.event);
+        }
+        catch (error) {
+            this.#clearPendingResponseCreate(pending.eventId);
+            this.onError?.(error);
+            return;
+        }
+    }
+    async #waitForResponseCreateSlot({ event, manual, requestVersion, generation, }) {
+        while (generation === this.#generation) {
+            const pending = this.#tryPrepareResponseCreate({
+                event,
+                manual,
+                requestVersion,
+            });
+            if (pending) {
+                return pending;
+            }
+            await this.#waitForChange(generation);
+        }
+        return null;
+    }
+    #tryPrepareResponseCreate({ event, manual, requestVersion, }) {
+        if (!this.#pendingRequestVersions.has(requestVersion)) {
+            return null;
+        }
+        if (this.#ongoingResponse ||
+            this.#responseControl !== 'free' ||
+            this.#nextPendingRequestVersion() !== requestVersion) {
+            return null;
+        }
+        this.#responseControl = 'create_requested';
+        const eventId = typeof event.event_id === 'string'
+            ? event.event_id
+            : this.#nextResponseCreateEventId();
+        const targetVersion = manual
+            ? requestVersion
+            : this.#autoResponseCreateTargetVersion(requestVersion);
+        const pending = {
+            event: {
+                ...event,
+                event_id: eventId,
+            },
+            eventId,
+            requestVersion,
+            targetVersion,
+            manual,
+        };
+        this.#pendingResponseCreate = pending;
+        return pending;
+    }
+    #clearPendingResponseCreate(eventId) {
+        if (this.#responseControl !== 'create_requested' ||
+            this.#pendingResponseCreate === null) {
+            return false;
+        }
+        if (eventId && this.#pendingResponseCreate.eventId !== eventId) {
+            return false;
+        }
+        // Preserve later auto requests that were coalesced into the failed create
+        // so they can trigger a fresh response.create.
+        this.#restoreCoveredAutoRequestVersions(this.#pendingResponseCreate);
+        this.#pendingRequestVersions.delete(this.#pendingResponseCreate.requestVersion);
+        if (this.#pendingResponseCreate.manual) {
+            this.#manualResponseCreateVersions.delete(this.#pendingResponseCreate.requestVersion);
+        }
+        this.#pendingResponseCreate = null;
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+        return true;
+    }
+    #clearAcceptedResponseCreate() {
+        if (this.#pendingResponseCreate === null) {
+            return;
+        }
+        for (let version = this.#pendingResponseCreate.requestVersion; version <= this.#pendingResponseCreate.targetVersion; version += 1) {
+            this.#pendingRequestVersions.delete(version);
+            this.#manualResponseCreateVersions.delete(version);
+        }
+        this.#pendingResponseCreate = null;
+    }
+    #restoreCoveredAutoRequestVersions(pending) {
+        for (let version = pending.requestVersion + 1; version <= pending.targetVersion; version += 1) {
+            this.#pendingRequestVersions.add(version);
+        }
+    }
+    #nextPendingRequestVersion() {
+        if (this.#pendingRequestVersions.size === 0) {
+            return null;
+        }
+        return Math.min(...this.#pendingRequestVersions);
+    }
+    #autoResponseCreateTargetVersion(requestVersion) {
+        const nextManualVersion = Math.min(...Array.from(this.#manualResponseCreateVersions).filter((version) => version >= requestVersion));
+        const eligibleVersions = Number.isFinite(nextManualVersion)
+            ? Array.from(this.#pendingRequestVersions).filter((version) => version < nextManualVersion)
+            : Array.from(this.#pendingRequestVersions);
+        return Math.max(...eligibleVersions);
+    }
+    #nextResponseCreateEventId() {
+        this.#responseCreateEventCounter += 1;
+        return `agents_js_response_create_${this.#responseCreateEventCounter}`;
+    }
+    #isResponseCreateLikeError(error) {
+        const code = typeof error?.code === 'string' ? error.code : '';
+        if (code.includes('response_create')) {
+            return true;
+        }
+        const message = typeof error?.message === 'string' ? error.message : '';
+        return message.includes('response.create');
+    }
+    #notifyWaiters() {
+        const waiters = Array.from(this.#waiters);
+        this.#waiters.clear();
+        for (const resolve of waiters) {
+            resolve();
+        }
+    }
+    #waitForChange(generation) {
+        if (generation !== this.#generation) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.#waiters.add(resolve);
+        });
+    }
+}
+exports.ResponseCreateSequencer = ResponseCreateSequencer;
+//# sourceMappingURL=responseCreateSequencer.js.map

package/dist/responseCreateSequencer.js.map

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

package/dist/responseCreateSequencer.mjs

@@ -0,0 +1,240 @@
+export class ResponseCreateSequencer {
+    sendEventNow;
+    onError;
+    #ongoingResponse = false;
+    #responseControl = 'free';
+    #responseCreateRequestVersion = 0;
+    #responseCreateEventCounter = 0;
+    #pendingRequestVersions = new Set();
+    #manualResponseCreateVersions = new Set();
+    #pendingResponseCreate = null;
+    #waiters = new Set();
+    #generation = 0;
+    constructor(sendEventNow, onError) {
+        this.sendEventNow = sendEventNow;
+        this.onError = onError;
+    }
+    get ongoingResponse() {
+        return this.#ongoingResponse;
+    }
+    get responseControl() {
+        return this.#responseControl;
+    }
+    get pendingResponseCreateEventId() {
+        return this.#pendingResponseCreate?.eventId ?? null;
+    }
+    requestResponseCreate(event, { manual = false } = {}) {
+        const requestVersion = this.#reserveResponseCreateRequest(manual);
+        const generation = this.#generation;
+        const pending = this.#tryPrepareResponseCreate({
+            event,
+            manual,
+            requestVersion,
+        });
+        if (pending) {
+            this.#dispatchResponseCreate(pending, generation);
+            return;
+        }
+        void this.#startResponseCreate({
+            event,
+            manual,
+            requestVersion,
+            generation,
+        });
+    }
+    markResponseCreated() {
+        this.#ongoingResponse = true;
+        this.#clearAcceptedResponseCreate();
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    markResponseDone() {
+        this.#ongoingResponse = false;
+        this.#clearAcceptedResponseCreate();
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    releaseWaiters() {
+        this.#generation += 1;
+        this.#ongoingResponse = false;
+        this.#pendingRequestVersions.clear();
+        this.#manualResponseCreateVersions.clear();
+        this.#pendingResponseCreate = null;
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+    }
+    beginCancelResponse() {
+        if (!this.#ongoingResponse ||
+            this.#responseControl === 'cancel_requested') {
+            return false;
+        }
+        this.#responseControl = 'cancel_requested';
+        this.#notifyWaiters();
+        return true;
+    }
+    handleResponseCreateError(event) {
+        const error = event.error;
+        const linkedEventId = typeof error?.event_id === 'string' ? error.event_id : undefined;
+        if (linkedEventId) {
+            return this.#clearPendingResponseCreate(linkedEventId);
+        }
+        if (this.#isResponseCreateLikeError(error)) {
+            return this.#clearPendingResponseCreate();
+        }
+        return false;
+    }
+    #reserveResponseCreateRequest(manual) {
+        this.#responseCreateRequestVersion += 1;
+        const requestVersion = this.#responseCreateRequestVersion;
+        this.#pendingRequestVersions.add(requestVersion);
+        if (manual) {
+            this.#manualResponseCreateVersions.add(requestVersion);
+        }
+        this.#notifyWaiters();
+        return requestVersion;
+    }
+    async #startResponseCreate({ event, manual, requestVersion, generation, }) {
+        const pending = await this.#waitForResponseCreateSlot({
+            event,
+            manual,
+            requestVersion,
+            generation,
+        });
+        if (!pending || generation !== this.#generation) {
+            return;
+        }
+        this.#dispatchResponseCreate(pending, generation);
+    }
+    #dispatchResponseCreate(pending, generation) {
+        if (generation !== this.#generation) {
+            return;
+        }
+        try {
+            this.sendEventNow(pending.event);
+        }
+        catch (error) {
+            this.#clearPendingResponseCreate(pending.eventId);
+            this.onError?.(error);
+            return;
+        }
+    }
+    async #waitForResponseCreateSlot({ event, manual, requestVersion, generation, }) {
+        while (generation === this.#generation) {
+            const pending = this.#tryPrepareResponseCreate({
+                event,
+                manual,
+                requestVersion,
+            });
+            if (pending) {
+                return pending;
+            }
+            await this.#waitForChange(generation);
+        }
+        return null;
+    }
+    #tryPrepareResponseCreate({ event, manual, requestVersion, }) {
+        if (!this.#pendingRequestVersions.has(requestVersion)) {
+            return null;
+        }
+        if (this.#ongoingResponse ||
+            this.#responseControl !== 'free' ||
+            this.#nextPendingRequestVersion() !== requestVersion) {
+            return null;
+        }
+        this.#responseControl = 'create_requested';
+        const eventId = typeof event.event_id === 'string'
+            ? event.event_id
+            : this.#nextResponseCreateEventId();
+        const targetVersion = manual
+            ? requestVersion
+            : this.#autoResponseCreateTargetVersion(requestVersion);
+        const pending = {
+            event: {
+                ...event,
+                event_id: eventId,
+            },
+            eventId,
+            requestVersion,
+            targetVersion,
+            manual,
+        };
+        this.#pendingResponseCreate = pending;
+        return pending;
+    }
+    #clearPendingResponseCreate(eventId) {
+        if (this.#responseControl !== 'create_requested' ||
+            this.#pendingResponseCreate === null) {
+            return false;
+        }
+        if (eventId && this.#pendingResponseCreate.eventId !== eventId) {
+            return false;
+        }
+        // Preserve later auto requests that were coalesced into the failed create
+        // so they can trigger a fresh response.create.
+        this.#restoreCoveredAutoRequestVersions(this.#pendingResponseCreate);
+        this.#pendingRequestVersions.delete(this.#pendingResponseCreate.requestVersion);
+        if (this.#pendingResponseCreate.manual) {
+            this.#manualResponseCreateVersions.delete(this.#pendingResponseCreate.requestVersion);
+        }
+        this.#pendingResponseCreate = null;
+        this.#responseControl = 'free';
+        this.#notifyWaiters();
+        return true;
+    }
+    #clearAcceptedResponseCreate() {
+        if (this.#pendingResponseCreate === null) {
+            return;
+        }
+        for (let version = this.#pendingResponseCreate.requestVersion; version <= this.#pendingResponseCreate.targetVersion; version += 1) {
+            this.#pendingRequestVersions.delete(version);
+            this.#manualResponseCreateVersions.delete(version);
+        }
+        this.#pendingResponseCreate = null;
+    }
+    #restoreCoveredAutoRequestVersions(pending) {
+        for (let version = pending.requestVersion + 1; version <= pending.targetVersion; version += 1) {
+            this.#pendingRequestVersions.add(version);
+        }
+    }
+    #nextPendingRequestVersion() {
+        if (this.#pendingRequestVersions.size === 0) {
+            return null;
+        }
+        return Math.min(...this.#pendingRequestVersions);
+    }
+    #autoResponseCreateTargetVersion(requestVersion) {
+        const nextManualVersion = Math.min(...Array.from(this.#manualResponseCreateVersions).filter((version) => version >= requestVersion));
+        const eligibleVersions = Number.isFinite(nextManualVersion)
+            ? Array.from(this.#pendingRequestVersions).filter((version) => version < nextManualVersion)
+            : Array.from(this.#pendingRequestVersions);
+        return Math.max(...eligibleVersions);
+    }
+    #nextResponseCreateEventId() {
+        this.#responseCreateEventCounter += 1;
+        return `agents_js_response_create_${this.#responseCreateEventCounter}`;
+    }
+    #isResponseCreateLikeError(error) {
+        const code = typeof error?.code === 'string' ? error.code : '';
+        if (code.includes('response_create')) {
+            return true;
+        }
+        const message = typeof error?.message === 'string' ? error.message : '';
+        return message.includes('response.create');
+    }
+    #notifyWaiters() {
+        const waiters = Array.from(this.#waiters);
+        this.#waiters.clear();
+        for (const resolve of waiters) {
+            resolve();
+        }
+    }
+    #waitForChange(generation) {
+        if (generation !== this.#generation) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.#waiters.add(resolve);
+        });
+    }
+}
+//# sourceMappingURL=responseCreateSequencer.mjs.map

package/dist/responseCreateSequencer.mjs.map

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

package/dist/transportLayer.d.ts

@@ -53,6 +53,13 @@ export interface RealtimeTransportLayer extends EventEmitter<RealtimeTransportEv
      * @param event - The event to send
      */
     sendEvent(event: RealtimeClientMessage): void;
+    /**
+     * Requests a new response for the current conversation turn. Implementations may defer the
+     * underlying `response.create` until the server has fully finished the prior response.
+     *
+     * @param response - Optional one-off response override payload.
+     */
+    requestResponse?(response?: Record<string, any>): void;
     /**
      * Sends a text message to the model
      * @param message - The message to send

package/package.json

@@ -2,7 +2,7 @@
   "name": "@openai/agents-realtime",
   "repository": "https://github.com/openai/openai-agents-js",
   "homepage": "https://openai.github.io/openai-agents-js/",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. This package contains the logic for building realtime voice agents on the server or in the browser.",
   "author": "OpenAI <support@openai.com>",
   "main": "dist/index.js",
@@ -51,7 +51,7 @@
     "@types/ws": "^8.18.1",
     "debug": "^4.4.0",
     "ws": "^8.18.1",
-    "@openai/agents-core": "0.7.2"
+    "@openai/agents-core": "0.8.1"
   },
   "keywords": [
     "openai",