@nocobase/plugin-ai 2.1.6 → 2.1.8

package/dist/node_modules/openai/resources/responses/ws-base.js

@@ -0,0 +1,476 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponsesWSBase = void 0;
+const internal_base_1 = require("./internal-base.js");
+const EventEmitter_1 = require("../../core/EventEmitter.js");
+const sleep_1 = require("../../internal/utils/sleep.js");
+const ws_adapter_1 = require("../../internal/ws-adapter.js");
+const ws_1 = require("../../internal/ws.js");
+const error_1 = require("../../core/error.js");
+class ResponsesWSBase extends internal_base_1.ResponsesEmitter {
+    constructor(client, options) {
+        super();
+        this._isReconnecting = false;
+        this._intentionallyClosed = false;
+        this._closeCode = 1000;
+        this._closeReason = 'OK';
+        this._lastCloseCode = 1006;
+        this._lastCloseReason = '';
+        // Necessary to keep the public event interface clean while we manage reconnecting
+        this._internalEvents = new EventEmitter_1.InternalEventEmitter();
+        this._client = client;
+        this._parameters = undefined;
+        this._reconnectOptions = options?.reconnect ?? null;
+        this._sendQueue = new ws_1.SendQueue(options?.maxQueueSize);
+    }
+    /** Establishes the initial WebSocket connection. */
+    _connectInitial() {
+        this.url = (0, internal_base_1.buildURL)(this._client, {});
+        this.socket = this._connect();
+    }
+    send(event) {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        if (this._isReconnecting || this.socket.readyState === ws_adapter_1.ReadyState.CONNECTING) {
+            if (!this._sendQueue.enqueue(event)) {
+                this._onError(null, 'send queue is full, message discarded', undefined);
+            }
+            return;
+        }
+        if (this.socket.readyState !== ws_adapter_1.ReadyState.OPEN) {
+            this._onError(null, 'cannot send on a closed WebSocket', undefined);
+            return;
+        }
+        try {
+            this.socket.send(JSON.stringify(event));
+        }
+        catch (err) {
+            this._onError(null, 'could not send data', err);
+        }
+    }
+    sendRaw(data) {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        if (this._isReconnecting || this.socket.readyState === ws_adapter_1.ReadyState.CONNECTING) {
+            if (!this._sendQueue.enqueueRaw(data)) {
+                this._onError(null, 'send queue is full, message discarded', undefined);
+            }
+            return;
+        }
+        if (this.socket.readyState !== ws_adapter_1.ReadyState.OPEN) {
+            this._onError(null, 'cannot send on a closed WebSocket', undefined);
+            return;
+        }
+        try {
+            this.socket.send((0, ws_1.flattenRawData)(data));
+        }
+        catch (err) {
+            this._onError(null, 'could not send data', err);
+        }
+    }
+    close(props) {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        this._intentionallyClosed = true;
+        this._closeCode = props?.code ?? 1000;
+        this._closeReason = props?.reason ?? 'OK';
+        try {
+            this.socket.close(this._closeCode, this._closeReason);
+        }
+        catch (err) {
+            this._onError(null, 'could not close the connection', err);
+        }
+    }
+    /**
+     * Returns an async iterator over WebSocket lifecycle and message events,
+     * providing an alternative to the event-based `.on()` API.
+     * The iterator will exit if the socket closes but exiting the iterator
+     * does not close the socket.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.stream()) {
+     *   switch (event.type) {
+     *     case 'message':
+     *       console.log('received:', event.message);
+     *       break;
+     *     case 'error':
+     *       console.error(event.error);
+     *       break;
+     *     case 'close':
+     *       console.log('connection closed');
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    stream() {
+        return this[Symbol.asyncIterator]();
+    }
+    [Symbol.asyncIterator]() {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        // Two-queue async iterator: `queue` buffers incoming messages,
+        // `resolvers` buffers waiting next() calls. A push wakes the
+        // oldest next(); a next() drains the oldest message.
+        const queue = [];
+        const resolvers = [];
+        let done = false;
+        let currentSocket = this.socket;
+        const push = (msg) => {
+            queue.push(msg);
+            resolvers.shift()?.();
+        };
+        const onEvent = (event) => {
+            if (event.type === 'error')
+                return; // handled by onEmitterError
+            push({ type: 'message', message: event });
+        };
+        const onRaw = (data) => {
+            push({ type: 'raw', data });
+        };
+        // All errors (API + socket) funnel through _onError → 'error' event
+        const onEmitterError = (err) => {
+            push({ type: 'error', error: err });
+        };
+        const onOpen = () => {
+            push({ type: 'open' });
+        };
+        const onReconnecting = (evt) => {
+            push({ type: 'reconnecting', reconnect: evt });
+        };
+        const onReconnected = () => {
+            push({ type: 'reconnected' });
+        };
+        const flushResolvers = () => {
+            for (let resolver = resolvers.shift(); resolver; resolver = resolvers.shift()) {
+                resolver();
+            }
+        };
+        const onClose = (code, reason, unsent) => {
+            push({ type: 'close', code, reason, unsent });
+            done = true;
+            flushResolvers();
+            cleanup();
+        };
+        const onSocketSwap = (oldSocket, newSocket) => {
+            oldSocket.off('open', onOpen);
+            newSocket.on('open', onOpen);
+            currentSocket = newSocket;
+        };
+        const cleanup = () => {
+            this.off('event', onEvent);
+            this.off('raw', onRaw);
+            this.off('error', onEmitterError);
+            currentSocket.off('open', onOpen);
+            this._internalEvents.off('close', onClose);
+            this._internalEvents.off('socketSwap', onSocketSwap);
+            this._internalEvents.off('reconnecting', onReconnecting);
+            this._internalEvents.off('reconnected', onReconnected);
+        };
+        this.on('event', onEvent);
+        this.on('raw', onRaw);
+        this.on('error', onEmitterError);
+        this.socket.on('open', onOpen);
+        this._internalEvents.on('close', onClose);
+        this._internalEvents.on('socketSwap', onSocketSwap);
+        this._internalEvents.on('reconnecting', onReconnecting);
+        this._internalEvents.on('reconnected', onReconnected);
+        if (this._isReconnecting) {
+            // A reconnect is already in flight. The socket may be CLOSED but the
+            // instance is still alive. Emit 'reconnecting' so the iterator stays
+            // open and receives the upcoming reconnected/message events.
+            push({
+                type: 'reconnecting',
+                reconnect: { attempt: 0, maxAttempts: 0, delay: 0, closeCode: 0, parameters: undefined },
+            });
+        }
+        else {
+            switch (this.socket.readyState) {
+                case ws_adapter_1.ReadyState.CONNECTING:
+                    push({ type: 'connecting' });
+                    break;
+                case ws_adapter_1.ReadyState.OPEN:
+                    push({ type: 'open' });
+                    break;
+                case ws_adapter_1.ReadyState.CLOSING:
+                    push({ type: 'closing' });
+                    break;
+                case ws_adapter_1.ReadyState.CLOSED:
+                    push({
+                        type: 'close',
+                        code: this._lastCloseCode,
+                        reason: this._lastCloseReason,
+                        unsent: this._sendQueue.drain(),
+                    });
+                    done = true;
+                    cleanup();
+                    break;
+            }
+        }
+        const resolve = (res) => {
+            if (queue.length > 0) {
+                res({ value: queue.shift(), done: false });
+            }
+            else if (done) {
+                res({ value: undefined, done: true });
+            }
+            else {
+                return false;
+            }
+            return true;
+        };
+        const next = () => new Promise((res) => {
+            if (resolve(res))
+                return;
+            resolvers.push(() => {
+                resolve(res);
+            });
+        });
+        return {
+            next,
+            return: () => {
+                done = true;
+                cleanup();
+                flushResolvers();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+    _connect() {
+        this.url = (0, internal_base_1.buildURL)(this._client, this._parameters ?? {});
+        const socket = this._createSocket(this.url, this._authHeaders());
+        socket.on('message', (data, isBinary) => {
+            if (isBinary) {
+                this._emit('raw', data);
+                return;
+            }
+            // Coerce to string in case the adapter delivers a typed-array for text frames.
+            const text = typeof data === 'string' ? data : String(data);
+            let event;
+            try {
+                event = JSON.parse(text);
+            }
+            catch {
+                this._emit('raw', data);
+                return;
+            }
+            this._emit('event', event);
+            if (event.type === 'error') {
+                this._onError(event);
+            }
+            else {
+                // @ts-ignore TS isn't smart enough to get the relationship right here
+                this._emit(event.type, event);
+            }
+        });
+        socket.on('error', (err) => {
+            // Suppress transient errors during reconnection — the retry loop
+            // already handles them and will surface a close if retries exhaust.
+            if (this._isReconnecting)
+                return;
+            this._onError(null, err.message, err);
+        });
+        socket.on('open', () => {
+            this._flushSendQueue();
+        });
+        socket.on('close', (code, reason) => {
+            // Ignore close events from superseded sockets — a stale socket's
+            // late close must not kick off a second reconnect loop.
+            if (socket !== this.socket)
+                return;
+            if (!this._intentionallyClosed && this._canReconnect(code)) {
+                this._reconnect(code);
+            }
+            else if (!this._isReconnecting) {
+                this._emitPermanentClose(code, reason);
+            }
+        });
+        return socket;
+    }
+    // Reconnect is opt-in via onReconnecting so callers can pass
+    // state (e.g. session IDs) into the new connection.
+    _canReconnect(code) {
+        if (this._intentionallyClosed)
+            return false;
+        if (!this._reconnectOptions)
+            return false;
+        if (this._reconnectOptions.maxRetries === 0)
+            return false;
+        if (!this._reconnectOptions.onReconnecting)
+            return false;
+        return (0, ws_1.isRecoverableClose)(code);
+    }
+    async _reconnect(closeCode) {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        if (this._isReconnecting || !this._reconnectOptions)
+            return;
+        this._isReconnecting = true;
+        const maxRetries = this._reconnectOptions.maxRetries ?? 5;
+        const initialDelay = this._reconnectOptions.initialDelay ?? 500;
+        const maxDelay = this._reconnectOptions.maxDelay ?? 8000;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            if (!this._canReconnect(closeCode)) {
+                this._isReconnecting = false;
+                if (!this._intentionallyClosed) {
+                    this._onError(null, `WebSocket reconnect aborted: non-recoverable close code ${closeCode}`, undefined);
+                }
+                this._emitPermanentClose(this._intentionallyClosed ? this._closeCode : closeCode, this._intentionallyClosed ? this._closeReason : 'reconnect aborted');
+                return;
+            }
+            const baseDelay = Math.min(initialDelay * Math.pow(2, attempt - 1), maxDelay);
+            // Jitter: rand [0.75, 1.0] to spread out connection attempts without over-delaying
+            const jitter = 0.75 + Math.random() * 0.25;
+            const actualDelay = Math.round(baseDelay * jitter);
+            let reconnectingEvent = {
+                attempt,
+                maxAttempts: maxRetries,
+                delay: actualDelay,
+                closeCode,
+                parameters: this._parameters ? { ...this._parameters } : undefined,
+            };
+            let overrides;
+            try {
+                overrides = this._reconnectOptions.onReconnecting(reconnectingEvent);
+            }
+            catch (err) {
+                this._isReconnecting = false;
+                this._onError(null, 'onReconnecting callback threw', err);
+                this._emitPermanentClose(closeCode, 'onReconnecting callback threw');
+                return;
+            }
+            if (overrides && 'abort' in overrides && overrides.abort) {
+                this._isReconnecting = false;
+                this._emitPermanentClose(closeCode, 'reconnect aborted by handler');
+                return;
+            }
+            if (overrides && 'parameters' in overrides) {
+                this._parameters = overrides.parameters;
+                reconnectingEvent = { ...reconnectingEvent, parameters: this._parameters };
+            }
+            try {
+                this._emit('reconnecting', reconnectingEvent);
+            }
+            catch (err) {
+                this._onError(null, 'onReconnecting callback threw', err);
+            }
+            this._internalEvents._emit('reconnecting', reconnectingEvent);
+            if (!this._canReconnect(closeCode)) {
+                this._isReconnecting = false;
+                if (!this._intentionallyClosed) {
+                    this._onError(null, `WebSocket reconnect aborted: non-recoverable close code ${closeCode}`, undefined);
+                }
+                this._emitPermanentClose(this._intentionallyClosed ? this._closeCode : closeCode, this._intentionallyClosed ? this._closeReason : 'reconnect aborted');
+                return;
+            }
+            await (0, sleep_1.sleep)(actualDelay);
+            if (!this._canReconnect(closeCode)) {
+                this._isReconnecting = false;
+                if (!this._intentionallyClosed) {
+                    this._onError(null, `WebSocket reconnect aborted: non-recoverable close code ${closeCode}`, undefined);
+                }
+                this._emitPermanentClose(this._intentionallyClosed ? this._closeCode : closeCode, this._intentionallyClosed ? this._closeReason : 'reconnect aborted');
+                return;
+            }
+            let closeCodePromise;
+            try {
+                const oldSocket = this.socket;
+                this.socket = this._connect();
+                // Registered synchronously after _connect() and before any
+                // await so the code is captured even when ws emits 'close'
+                // in the same tick as 'error' (e.g. abortHandshake).
+                closeCodePromise = new Promise((resolve) => {
+                    this.socket.once('close', resolve);
+                });
+                await this._awaitOpen(this.socket);
+                this._internalEvents._emit('socketSwap', oldSocket, this.socket);
+                this._isReconnecting = false;
+                this._flushSendQueue();
+                this._emit('reconnected');
+                this._internalEvents._emit('reconnected');
+                return;
+            }
+            catch {
+                if (closeCodePromise) {
+                    // ws may emit 'error' before 'close', so await the code
+                    // rather than reading it synchronously.
+                    closeCode = await closeCodePromise;
+                }
+            }
+        }
+        // All retries exhausted — surface an error so consumers can
+        // distinguish retry failure from a clean close.
+        this._isReconnecting = false;
+        this._onError(null, `WebSocket reconnect failed after ${maxRetries} attempts (close code: ${closeCode})`, undefined);
+        this._emitPermanentClose(closeCode, `reconnect failed after ${maxRetries} attempts`);
+    }
+    /**
+     * Resolves once the socket is open, rejects if it errors or closes first
+     */
+    _awaitOpen(socket) {
+        return new Promise((resolve, reject) => {
+            const cleanup = () => {
+                socket.off('open', onOpen);
+                socket.off('error', onError);
+                socket.off('close', onFail);
+            };
+            const onOpen = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const onFail = () => {
+                cleanup();
+                reject(new Error('socket closed before open'));
+            };
+            socket.once('open', onOpen);
+            socket.once('error', onError);
+            socket.once('close', onFail);
+        });
+    }
+    _flushSendQueue() {
+        if (!this.socket) {
+            throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
+        }
+        try {
+            this._sendQueue.flush((data) => this.socket.send((0, ws_1.flattenRawData)(data)));
+        }
+        catch (err) {
+            this._onError(null, 'could not send queued data', err);
+        }
+    }
+    /**
+     * Emits the public `close` event with unsent messages and the internal
+     * `close` event used by the async iterator.
+     */
+    _emitPermanentClose(code, reason) {
+        this._lastCloseCode = code;
+        this._lastCloseReason = reason;
+        const unsent = this._sendQueue.drain();
+        // Internal close fires first so the async iterator is guaranteed to
+        // terminate even if a public 'close' listener throws.
+        this._internalEvents._emit('close', code, reason, unsent);
+        this._emit('close', code, reason, unsent);
+    }
+    _authHeaders() {
+        if (this._client.apiKey) {
+            return { Authorization: `Bearer ${this._client.apiKey}` };
+        }
+        return {};
+    }
+}
+exports.ResponsesWSBase = ResponsesWSBase;
+//# sourceMappingURL=ws-base.js.map

package/dist/node_modules/openai/resources/responses/ws.d.mts

@@ -0,0 +1,13 @@
+import * as WS from 'ws';
+import { NodeWebSocket } from "../../internal/ws-adapter-node.mjs";
+import { ResponsesWSBase, type ResponsesWSBaseOptions } from "./ws-base.mjs";
+import { OpenAI } from "../../client.mjs";
+export type { ResponsesWSReconnectOptions } from "./ws-base.mjs";
+export interface ResponsesWSClientOptions extends WS.ClientOptions, ResponsesWSBaseOptions {
+}
+export declare class ResponsesWS extends ResponsesWSBase<NodeWebSocket> {
+    private _wsOptions;
+    constructor(client: OpenAI, options?: ResponsesWSClientOptions | null | undefined);
+    protected _createSocket(url: URL, authHeaders: Record<string, string>): NodeWebSocket;
+}
+//# sourceMappingURL=ws.d.mts.map

package/dist/node_modules/openai/resources/responses/ws.d.ts

@@ -0,0 +1,13 @@
+import * as WS from 'ws';
+import { NodeWebSocket } from "../../internal/ws-adapter-node.js";
+import { ResponsesWSBase, type ResponsesWSBaseOptions } from "./ws-base.js";
+import { OpenAI } from "../../client.js";
+export type { ResponsesWSReconnectOptions } from "./ws-base.js";
+export interface ResponsesWSClientOptions extends WS.ClientOptions, ResponsesWSBaseOptions {
+}
+export declare class ResponsesWS extends ResponsesWSBase<NodeWebSocket> {
+    private _wsOptions;
+    constructor(client: OpenAI, options?: ResponsesWSClientOptions | null | undefined);
+    protected _createSocket(url: URL, authHeaders: Record<string, string>): NodeWebSocket;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/node_modules/openai/resources/responses/ws.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponsesWS = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const WS = tslib_1.__importStar(require("ws"));
+const ws_adapter_node_1 = require("../../internal/ws-adapter-node.js");
+const ws_base_1 = require("./ws-base.js");
+class ResponsesWS extends ws_base_1.ResponsesWSBase {
+    constructor(client, options) {
+        if (!WS?.WebSocket) {
+            throw new Error('ResponsesWS from "openai/resources/responses/ws" requires the "ws" package but it could not be loaded.');
+        }
+        const { reconnect, maxQueueSize, ...wsOptions } = options ?? {};
+        super(client, { reconnect, maxQueueSize });
+        this._wsOptions = wsOptions;
+        this._connectInitial();
+    }
+    _createSocket(url, authHeaders) {
+        const ws = new WS.WebSocket(url, {
+            ...this._wsOptions,
+            headers: {
+                ...authHeaders,
+                ...this._wsOptions?.headers,
+            },
+        });
+        return new ws_adapter_node_1.NodeWebSocket(ws);
+    }
+}
+exports.ResponsesWS = ResponsesWS;
+//# sourceMappingURL=ws.js.map

package/dist/node_modules/openai/resources/shared.d.mts

@@ -1,5 +1,5 @@
 export type AllModels = (string & {}) | ChatModel | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max';
-export type ChatModel = 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613';
+export type ChatModel = 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613';
 /**
  * A filter used to compare a specified attribute key to a given value using a
  * defined comparison operation.
@@ -22,7 +22,7 @@ export interface ComparisonFilter {
      * - `in`: in
      * - `nin`: not in
      */
-    type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte';
+    type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin';
     /**
      * The value to compare against the attribute key; supports string, number, or
      * boolean types.
@@ -134,6 +134,7 @@ export type FunctionParameters = {
 export type Metadata = {
     [key: string]: string;
 };
+export type OAuthErrorCode = 'invalid_grant' | 'invalid_subject_token' | (string & {});
 /**
  * **gpt-5 and o-series models only**
  *

package/dist/node_modules/openai/resources/shared.d.ts

@@ -1,5 +1,5 @@
 export type AllModels = (string & {}) | ChatModel | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max';
-export type ChatModel = 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613';
+export type ChatModel = 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613';
 /**
  * A filter used to compare a specified attribute key to a given value using a
  * defined comparison operation.
@@ -22,7 +22,7 @@ export interface ComparisonFilter {
      * - `in`: in
      * - `nin`: not in
      */
-    type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte';
+    type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin';
     /**
      * The value to compare against the attribute key; supports string, number, or
      * boolean types.
@@ -134,6 +134,7 @@ export type FunctionParameters = {
 export type Metadata = {
     [key: string]: string;
 };
+export type OAuthErrorCode = 'invalid_grant' | 'invalid_subject_token' | (string & {});
 /**
  * **gpt-5 and o-series models only**
  *

package/dist/node_modules/openai/resources/skills/content.d.mts

@@ -3,7 +3,7 @@ import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Content extends APIResource {
     /**
-     * Get Skill Content
+     * Download a skill zip bundle by its ID.
      */
     retrieve(skillID: string, options?: RequestOptions): APIPromise<Response>;
 }

package/dist/node_modules/openai/resources/skills/content.d.ts

@@ -3,7 +3,7 @@ import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Content extends APIResource {
     /**
-     * Get Skill Content
+     * Download a skill zip bundle by its ID.
      */
     retrieve(skillID: string, options?: RequestOptions): APIPromise<Response>;
 }

package/dist/node_modules/openai/resources/skills/content.js

@@ -7,12 +7,13 @@ const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 class Content extends resource_1.APIResource {
     /**
-     * Get Skill Content
+     * Download a skill zip bundle by its ID.
      */
     retrieve(skillID, options) {
         return this._client.get((0, path_1.path) `/skills/${skillID}/content`, {
             ...options,
             headers: (0, headers_1.buildHeaders)([{ Accept: 'application/binary' }, options?.headers]),
+            __security: { bearerAuth: true },
             __binaryResponse: true,
         });
     }

package/dist/node_modules/openai/resources/skills/skills.d.mts

@@ -11,23 +11,23 @@ export declare class Skills extends APIResource {
     content: ContentAPI.Content;
     versions: VersionsAPI.Versions;
     /**
-     * Create Skill
+     * Create a new skill.
      */
     create(body?: SkillCreateParams | null | undefined, options?: RequestOptions): APIPromise<Skill>;
     /**
-     * Get Skill
+     * Get a skill by its ID.
      */
     retrieve(skillID: string, options?: RequestOptions): APIPromise<Skill>;
     /**
-     * Update Skill Default Version
+     * Update the default version pointer for a skill.
      */
     update(skillID: string, body: SkillUpdateParams, options?: RequestOptions): APIPromise<Skill>;
     /**
-     * List Skills
+     * List all skills for the current project.
      */
     list(query?: SkillListParams | null | undefined, options?: RequestOptions): PagePromise<SkillsPage, Skill>;
     /**
-     * Delete Skill
+     * Delete a skill by its ID.
      */
     delete(skillID: string, options?: RequestOptions): APIPromise<DeletedSkill>;
 }