openai 7.14.0 → 7.16.0

package/internal/utils/abort.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retainRequestAbortCallback = retainRequestAbortCallback;
+exports.addRequestAbortListener = addRequestAbortListener;
+// Keep these optional runtime features out of the SDK's ES2020 type requirements.
+const weakGlobals = globalThis;
+const finalizer = typeof weakGlobals.FinalizationRegistry === 'function'
+    ? new weakGlobals.FinalizationRegistry((cleanup) => {
+        try {
+            cleanup();
+        }
+        catch {
+            // Caller-provided signal methods must not throw out of a GC callback.
+        }
+    })
+    : undefined;
+const callbackOwners = new WeakMap();
+const subscriptions = new WeakMap();
+// This scope receives only a weak reference, so its closures cannot retain the callback.
+function subscribeWeakly(signal, reference, registry) {
+    let subscription = subscriptions.get(signal);
+    if (!subscription) {
+        const callbacks = new Set();
+        const abort = () => {
+            subscriptions.delete(signal);
+            for (const callback of callbacks) {
+                registry.unregister(callback);
+                callback.deref()?.();
+            }
+            callbacks.clear();
+        };
+        subscription = { callbacks, abort };
+        signal.addEventListener('abort', abort, { once: true });
+        subscriptions.set(signal, subscription);
+    }
+    const owner = subscription;
+    owner.callbacks.add(reference);
+    return () => {
+        owner.callbacks.delete(reference);
+        registry.unregister(reference);
+        if (owner.callbacks.size === 0) {
+            if (subscriptions.get(signal) === owner) {
+                subscriptions.delete(signal);
+            }
+            signal.removeEventListener('abort', owner.abort);
+        }
+    };
+}
+// The listener must not retain the shared owner or its other request callbacks.
+function releaseOnAbort(signal, callbacks, abort) {
+    signal.addEventListener('abort', () => callbacks.deref()?.delete(abort), { once: true });
+}
+/** Keep cancellation alive until abort or collection of the response body or bodyless custom response. */
+function retainRequestAbortCallback(owner, abort, requestSignal) {
+    if (typeof weakGlobals.WeakRef === 'function' && finalizer && !requestSignal.aborted) {
+        let callbacks = callbackOwners.get(owner);
+        if (!callbacks) {
+            callbacks = new Set();
+            callbackOwners.set(owner, callbacks);
+        }
+        callbacks.add(abort);
+        releaseOnAbort(requestSignal, new weakGlobals.WeakRef(callbacks), abort);
+    }
+}
+/**
+ * Share one caller listener without it retaining completed requests. Collection removes
+ * weak subscriptions eventually; a live response body or custom response retains its callback.
+ * Runtimes without weak references keep the existing listener-based behavior.
+ */
+function addRequestAbortListener(signal, abort, requestSignal) {
+    if (signal.aborted) {
+        abort();
+        return () => {
+            // No listener was installed for an already aborted signal.
+        };
+    }
+    if (typeof weakGlobals.WeakRef !== 'function' || !finalizer) {
+        signal.addEventListener('abort', abort, { once: true });
+        return () => signal.removeEventListener('abort', abort);
+    }
+    const reference = new weakGlobals.WeakRef(abort);
+    const cleanup = subscribeWeakly(signal, reference, finalizer);
+    finalizer.register(abort, cleanup, reference);
+    retainRequestAbortCallback(requestSignal, abort, requestSignal);
+    return cleanup;
+}
+//# sourceMappingURL=abort.js.map

package/internal/utils/abort.js.map

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

package/internal/utils/abort.mjs

@@ -0,0 +1,83 @@
+// Keep these optional runtime features out of the SDK's ES2020 type requirements.
+const weakGlobals = globalThis;
+const finalizer = typeof weakGlobals.FinalizationRegistry === 'function'
+    ? new weakGlobals.FinalizationRegistry((cleanup) => {
+        try {
+            cleanup();
+        }
+        catch {
+            // Caller-provided signal methods must not throw out of a GC callback.
+        }
+    })
+    : undefined;
+const callbackOwners = new WeakMap();
+const subscriptions = new WeakMap();
+// This scope receives only a weak reference, so its closures cannot retain the callback.
+function subscribeWeakly(signal, reference, registry) {
+    let subscription = subscriptions.get(signal);
+    if (!subscription) {
+        const callbacks = new Set();
+        const abort = () => {
+            subscriptions.delete(signal);
+            for (const callback of callbacks) {
+                registry.unregister(callback);
+                callback.deref()?.();
+            }
+            callbacks.clear();
+        };
+        subscription = { callbacks, abort };
+        signal.addEventListener('abort', abort, { once: true });
+        subscriptions.set(signal, subscription);
+    }
+    const owner = subscription;
+    owner.callbacks.add(reference);
+    return () => {
+        owner.callbacks.delete(reference);
+        registry.unregister(reference);
+        if (owner.callbacks.size === 0) {
+            if (subscriptions.get(signal) === owner) {
+                subscriptions.delete(signal);
+            }
+            signal.removeEventListener('abort', owner.abort);
+        }
+    };
+}
+// The listener must not retain the shared owner or its other request callbacks.
+function releaseOnAbort(signal, callbacks, abort) {
+    signal.addEventListener('abort', () => callbacks.deref()?.delete(abort), { once: true });
+}
+/** Keep cancellation alive until abort or collection of the response body or bodyless custom response. */
+export function retainRequestAbortCallback(owner, abort, requestSignal) {
+    if (typeof weakGlobals.WeakRef === 'function' && finalizer && !requestSignal.aborted) {
+        let callbacks = callbackOwners.get(owner);
+        if (!callbacks) {
+            callbacks = new Set();
+            callbackOwners.set(owner, callbacks);
+        }
+        callbacks.add(abort);
+        releaseOnAbort(requestSignal, new weakGlobals.WeakRef(callbacks), abort);
+    }
+}
+/**
+ * Share one caller listener without it retaining completed requests. Collection removes
+ * weak subscriptions eventually; a live response body or custom response retains its callback.
+ * Runtimes without weak references keep the existing listener-based behavior.
+ */
+export function addRequestAbortListener(signal, abort, requestSignal) {
+    if (signal.aborted) {
+        abort();
+        return () => {
+            // No listener was installed for an already aborted signal.
+        };
+    }
+    if (typeof weakGlobals.WeakRef !== 'function' || !finalizer) {
+        signal.addEventListener('abort', abort, { once: true });
+        return () => signal.removeEventListener('abort', abort);
+    }
+    const reference = new weakGlobals.WeakRef(abort);
+    const cleanup = subscribeWeakly(signal, reference, finalizer);
+    finalizer.register(abort, cleanup, reference);
+    retainRequestAbortCallback(requestSignal, abort, requestSignal);
+    return cleanup;
+}
+//# sourceMappingURL=abort.mjs.map

package/internal/utils/abort.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.mjs","sourceRoot":"","sources":["../../src/internal/utils/abort.ts"],"names":[],"mappings":"AAUA,kFAAkF;AAClF,MAAM,WAAW,GAAG,UAGnB,CAAC;AACF,MAAM,SAAS,GACb,OAAO,WAAW,CAAC,oBAAoB,KAAK,UAAU;IACpD,CAAC,CAAC,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC,CAAC;IACJ,CAAC,CAAC,SAAS,CAAC;AAChB,MAAM,cAAc,GAAG,IAAI,OAAO,EAA8B,CAAC;AACjE,MAAM,aAAa,GAAG,IAAI,OAAO,EAA4E,CAAC;AAE9G,yFAAyF;AACzF,SAAS,eAAe,CAAC,MAAmB,EAAE,SAA4B,EAAE,QAAwB;IAClG,IAAI,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC/C,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC9B,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;YACvB,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC;QACF,YAAY,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACpC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC;IAC3B,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,OAAO,GAAG,EAAE;QACV,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;gBACxC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,cAAc,CACrB,MAAmB,EACnB,SAA4C,EAC5C,KAAoB;IAEpB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,0BAA0B,CACxC,KAAa,EACb,KAAoB,EACpB,aAA0B;IAE1B,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU,IAAI,SAAS,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QACrF,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,cAAc,CAAC,aAAa,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAmB,EACnB,KAAoB,EACpB,aAA0B;IAE1B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,EAAE,CAAC;QACR,OAAO,GAAG,EAAE;YACV,2DAA2D;QAC7D,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,0BAA0B,CAAC,aAAa,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/internal/ws.d.mts

@@ -1,3 +1,16 @@
+/** Options for an independently buffered WebSocket stream iterator. */
+export interface WebSocketStreamOptions {
+    /**
+     * Maximum queued records, including raw data, errors and lifecycle events.
+     * Must be a positive safe integer. Omitted means unlimited. Overflow discards
+     * this iterator's backlog and rejects its next() calls with a WebSocketError,
+     * without closing the shared socket or affecting other iterators.
+     * This bounds event count, not payload bytes or total memory.
+     */
+    maxBufferedEvents?: number | undefined;
+}
+/** Snapshots and validates the iterator's limit before listeners are attached. */
+export declare function getMaxBufferedEvents(options?: WebSocketStreamOptions): number | undefined;
 /** Reconnection event passed to the `onReconnecting` handler and event listeners. */
 export interface ReconnectingEvent<Parameters = Record<string, unknown>> {
     /** Which retry attempt this is (1-based). */

package/internal/ws.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.mts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,UAAU,4BAA4B;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAsBD,gGAAgG;AAChG,wBAAgB,8CAA8C,CAAC,OAAO,SAAS,4BAA4B,EACzG,OAAO,EAAE,OAAO,GACf,OAAO,CAWT;AAED,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IACE,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC;CACZ,GACD;IACE,+CAA+C;IAC/C,IAAI,EAAE,KAAK,CAAC;IAEZ,8EAA8E;IAC9E,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAaN;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAKnG;AA+BD;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,+DAA+D;gBACnD,QAAQ,SAAY;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAW5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDxD"}
+{"version":3,"file":"ws.d.mts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,SAAS,CAMzF;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,UAAU,4BAA4B;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAsBD,gGAAgG;AAChG,wBAAgB,8CAA8C,CAAC,OAAO,SAAS,4BAA4B,EACzG,OAAO,EAAE,OAAO,GACf,OAAO,CAWT;AAED,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IACE,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC;CACZ,GACD;IACE,+CAA+C;IAC/C,IAAI,EAAE,KAAK,CAAC;IAEZ,8EAA8E;IAC9E,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAaN;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAKnG;AA+BD;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,+DAA+D;gBACnD,QAAQ,SAAY;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAW5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDxD"}

package/internal/ws.d.ts

@@ -1,3 +1,16 @@
+/** Options for an independently buffered WebSocket stream iterator. */
+export interface WebSocketStreamOptions {
+    /**
+     * Maximum queued records, including raw data, errors and lifecycle events.
+     * Must be a positive safe integer. Omitted means unlimited. Overflow discards
+     * this iterator's backlog and rejects its next() calls with a WebSocketError,
+     * without closing the shared socket or affecting other iterators.
+     * This bounds event count, not payload bytes or total memory.
+     */
+    maxBufferedEvents?: number | undefined;
+}
+/** Snapshots and validates the iterator's limit before listeners are attached. */
+export declare function getMaxBufferedEvents(options?: WebSocketStreamOptions): number | undefined;
 /** Reconnection event passed to the `onReconnecting` handler and event listeners. */
 export interface ReconnectingEvent<Parameters = Record<string, unknown>> {
     /** Which retry attempt this is (1-based). */

package/internal/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,UAAU,4BAA4B;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAsBD,gGAAgG;AAChG,wBAAgB,8CAA8C,CAAC,OAAO,SAAS,4BAA4B,EACzG,OAAO,EAAE,OAAO,GACf,OAAO,CAWT;AAED,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IACE,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC;CACZ,GACD;IACE,+CAA+C;IAC/C,IAAI,EAAE,KAAK,CAAC;IAEZ,8EAA8E;IAC9E,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAaN;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAKnG;AA+BD;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,+DAA+D;gBACnD,QAAQ,SAAY;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAW5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDxD"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,SAAS,CAMzF;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,UAAU,4BAA4B;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAsBD,gGAAgG;AAChG,wBAAgB,8CAA8C,CAAC,OAAO,SAAS,4BAA4B,EACzG,OAAO,EAAE,OAAO,GACf,OAAO,CAWT;AAED,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IACE,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC;CACZ,GACD;IACE,+CAA+C;IAC/C,IAAI,EAAE,KAAK,CAAC;IAEZ,8EAA8E;IAC9E,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAaN;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAKnG;AA+BD;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,+DAA+D;gBACnD,QAAQ,SAAY;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAW5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDxD"}

package/internal/ws.js

@@ -1,10 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SendQueue = void 0;
+exports.getMaxBufferedEvents = getMaxBufferedEvents;
 exports.protectWebSocketOptionsFromCredentialRedirects = protectWebSocketOptionsFromCredentialRedirects;
 exports.flattenRawData = flattenRawData;
 exports.isRecoverableClose = isRecoverableClose;
 const bytes_1 = require("./utils/bytes.js");
+const error_1 = require("../core/error.js");
+/** Snapshots and validates the iterator's limit before listeners are attached. */
+function getMaxBufferedEvents(options) {
+    const limit = options?.maxBufferedEvents;
+    if (limit !== undefined && (!Number.isSafeInteger(limit) || limit <= 0)) {
+        throw new error_1.OpenAIError('maxBufferedEvents must be a positive safe integer');
+    }
+    return limit;
+}
 const REDIRECT_SAFE_WEBSOCKET_HEADERS = new Set([
     'connection',
     'host',

package/internal/ws.js.map

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

package/internal/ws.mjs

@@ -1,4 +1,13 @@
 import { concatBytes, encodeUTF8 } from "./utils/bytes.mjs";
+import { OpenAIError } from "../core/error.mjs";
+/** Snapshots and validates the iterator's limit before listeners are attached. */
+export function getMaxBufferedEvents(options) {
+    const limit = options?.maxBufferedEvents;
+    if (limit !== undefined && (!Number.isSafeInteger(limit) || limit <= 0)) {
+        throw new OpenAIError('maxBufferedEvents must be a positive safe integer');
+    }
+    return limit;
+}
 const REDIRECT_SAFE_WEBSOCKET_HEADERS = new Set([
     'connection',
     'host',

package/internal/ws.mjs.map

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

package/lib/agents/agent-session-stream.d.mts

@@ -0,0 +1,41 @@
+import type { RequestOptions } from "../../internal/request-options.mjs";
+import type { AgentFunctionCallOutputParam, AgentSessionEvent, AgentSessionInputMessageParam } from "../../resources/beta/agents/agents.mjs";
+import type { Sessions } from "../../resources/beta/agents/sessions/sessions.mjs";
+/** A function result; object results are serialized as JSON text. */
+export type AgentToolOutput = AgentFunctionCallOutputParam | object | null;
+/** Receives a detached JSON object and may return a result asynchronously. */
+export type AgentToolHandler = (arguments_: Record<string, unknown>) => AgentToolOutput | PromiseLike<AgentToolOutput>;
+/** Input and optional sequential tool handlers for one turn on an idle session. */
+export interface AgentSessionStreamParams {
+    /** User messages, or text normalized to a single user message. Must not be empty. */
+    input: string | AgentSessionInputMessageParam[];
+    /** Registered functions run after their call event is yielded; unknown functions remain manual. */
+    toolHandlers?: Record<string, AgentToolHandler>;
+    /** Key for the input submission only; request headers take precedence, case-insensitively. */
+    idempotencyKey?: string;
+}
+/**
+ * A single-use, lazy async iterable of original session events for one turn.
+ * Requires an idle session and a single input writer: the input endpoint does not
+ * return a turn ID. Subscribe-before-input avoids losing events; the first
+ * coordinator turn selects the turn to follow. Initial idle events and subagent
+ * completion do not end iteration. A selected turn's terminal event followed by
+ * session.idle, or session.failed, ends iteration. Unexpected EOF throws.
+ *
+ * Tool handlers run sequentially during iteration. Handler failures submit a
+ * generic error without exception text. Each submission has a distinct retry-safe
+ * idempotency key. Breaking iteration or calling abort closes local requests;
+ * neither cancels the backend turn. No work starts until iteration begins.
+ */
+export declare class AgentSessionStream implements AsyncIterable<AgentSessionEvent> {
+    #private;
+    /** Aborts local requests and iteration without cancelling the backend turn. */
+    readonly controller: AbortController;
+    /** Creates an unstarted helper. Prefer client.beta.agents.sessions.stream(). */
+    constructor(sessions: Sessions, sessionID: string, params: AgentSessionStreamParams, options?: RequestOptions);
+    /** Closes local requests without cancelling the turn; an optional reason becomes the abort error's cause. */
+    abort(reason?: unknown): void;
+    /** Starts iteration once; use for await to ensure early exits close the connection. */
+    [Symbol.asyncIterator](): AsyncIterator<AgentSessionEvent>;
+}
+//# sourceMappingURL=agent-session-stream.d.mts.map

package/lib/agents/agent-session-stream.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-stream.d.mts","sourceRoot":"","sources":["../../src/lib/agents/agent-session-stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,2CAAuC;AAGrE,OAAO,KAAK,EAEV,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAG9B,+CAA2C;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,0DAAsD;AAE9E,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,4BAA4B,GAAG,MAAM,GAAG,IAAI,CAAC;AAC3E,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEpD,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,6BAA6B,EAAE,CAAC;IAChD,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuDD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,aAAa,CAAC,iBAAiB,CAAC;;IACzE,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,kBAAyB;IAY5C,gFAAgF;gBAE9E,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc;IA0B1B,6GAA6G;IAC7G,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ7B,uFAAuF;IACvF,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,iBAAiB,CAAC;CA0K3D"}

package/lib/agents/agent-session-stream.d.ts

@@ -0,0 +1,41 @@
+import type { RequestOptions } from "../../internal/request-options.js";
+import type { AgentFunctionCallOutputParam, AgentSessionEvent, AgentSessionInputMessageParam } from "../../resources/beta/agents/agents.js";
+import type { Sessions } from "../../resources/beta/agents/sessions/sessions.js";
+/** A function result; object results are serialized as JSON text. */
+export type AgentToolOutput = AgentFunctionCallOutputParam | object | null;
+/** Receives a detached JSON object and may return a result asynchronously. */
+export type AgentToolHandler = (arguments_: Record<string, unknown>) => AgentToolOutput | PromiseLike<AgentToolOutput>;
+/** Input and optional sequential tool handlers for one turn on an idle session. */
+export interface AgentSessionStreamParams {
+    /** User messages, or text normalized to a single user message. Must not be empty. */
+    input: string | AgentSessionInputMessageParam[];
+    /** Registered functions run after their call event is yielded; unknown functions remain manual. */
+    toolHandlers?: Record<string, AgentToolHandler>;
+    /** Key for the input submission only; request headers take precedence, case-insensitively. */
+    idempotencyKey?: string;
+}
+/**
+ * A single-use, lazy async iterable of original session events for one turn.
+ * Requires an idle session and a single input writer: the input endpoint does not
+ * return a turn ID. Subscribe-before-input avoids losing events; the first
+ * coordinator turn selects the turn to follow. Initial idle events and subagent
+ * completion do not end iteration. A selected turn's terminal event followed by
+ * session.idle, or session.failed, ends iteration. Unexpected EOF throws.
+ *
+ * Tool handlers run sequentially during iteration. Handler failures submit a
+ * generic error without exception text. Each submission has a distinct retry-safe
+ * idempotency key. Breaking iteration or calling abort closes local requests;
+ * neither cancels the backend turn. No work starts until iteration begins.
+ */
+export declare class AgentSessionStream implements AsyncIterable<AgentSessionEvent> {
+    #private;
+    /** Aborts local requests and iteration without cancelling the backend turn. */
+    readonly controller: AbortController;
+    /** Creates an unstarted helper. Prefer client.beta.agents.sessions.stream(). */
+    constructor(sessions: Sessions, sessionID: string, params: AgentSessionStreamParams, options?: RequestOptions);
+    /** Closes local requests without cancelling the turn; an optional reason becomes the abort error's cause. */
+    abort(reason?: unknown): void;
+    /** Starts iteration once; use for await to ensure early exits close the connection. */
+    [Symbol.asyncIterator](): AsyncIterator<AgentSessionEvent>;
+}
+//# sourceMappingURL=agent-session-stream.d.ts.map

package/lib/agents/agent-session-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-stream.d.ts","sourceRoot":"","sources":["../../src/lib/agents/agent-session-stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,0CAAuC;AAGrE,OAAO,KAAK,EAEV,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAG9B,8CAA2C;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,yDAAsD;AAE9E,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,4BAA4B,GAAG,MAAM,GAAG,IAAI,CAAC;AAC3E,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEpD,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,6BAA6B,EAAE,CAAC;IAChD,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuDD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,aAAa,CAAC,iBAAiB,CAAC;;IACzE,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,kBAAyB;IAY5C,gFAAgF;gBAE9E,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc;IA0B1B,6GAA6G;IAC7G,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ7B,uFAAuF;IACvF,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,iBAAiB,CAAC;CA0K3D"}