openai 6.33.0 → 6.34.0

package/src/core/error.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { castToError } from '../internal/errors';
+import type { OAuthErrorCode } from '../resources/shared';
 
 export class OpenAIError extends Error {}
 
@@ -158,3 +159,42 @@ export class InvalidWebhookSignatureError extends Error {
     super(message);
   }
 }
+
+/**
+ * Error thrown by the API server during OAuth token exchange.
+ * Can have status codes 400, 401, or 403.
+ * Other status codes from OAuth endpoints are raised as normal APIError types.
+ */
+export class OAuthError extends APIError<400 | 401 | 403, Headers> {
+  readonly error_code: OAuthErrorCode | undefined;
+
+  constructor(status: 400 | 401 | 403, error: Object | undefined, headers: Headers) {
+    let finalMessage = 'OAuth2 authentication error';
+    let error_code: OAuthErrorCode | undefined = undefined;
+
+    if (error && typeof error === 'object') {
+      const errorData = error as Record<string, any>;
+      error_code = errorData['error'];
+      const description = errorData['error_description'];
+      if (description && typeof description === 'string') {
+        finalMessage = description;
+      } else if (error_code) {
+        finalMessage = error_code;
+      }
+    }
+
+    super(status, error, finalMessage, headers);
+    this.error_code = error_code;
+  }
+}
+
+export class SubjectTokenProviderError extends OpenAIError {
+  readonly provider: string;
+  readonly cause: Error | undefined;
+
+  constructor(message: string, provider: string, cause?: Error) {
+    super(message);
+    this.provider = provider;
+    this.cause = cause;
+  }
+}

package/src/index.ts

@@ -21,6 +21,8 @@ export {
   PermissionDeniedError,
   UnprocessableEntityError,
   InvalidWebhookSignatureError,
+  OAuthError,
+  SubjectTokenProviderError,
 } from './core/error';
 
 export { AzureOpenAI } from './azure';

package/src/resources/conversations/conversations.ts

@@ -170,6 +170,14 @@ export interface Message {
    * The type of the message. Always set to `message`.
    */
   type: 'message';
+
+  /**
+   * Labels an `assistant` message as intermediate commentary (`commentary`) or the
+   * final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+   * sending follow-up requests, preserve and resend phase on all assistant messages
+   * — dropping it can degrade performance. Not used for user messages.
+   */
+  phase?: 'commentary' | 'final_answer' | null;
 }
 
 export namespace Message {

package/src/resources/realtime/calls.ts

@@ -172,8 +172,9 @@ export interface CallAcceptParams {
 
   /**
    * Realtime API can write session traces to the
-   * [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-   * tracing is enabled for a session, the configuration cannot be modified.
+   * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+   * disable tracing. Once tracing is enabled for a session, the configuration cannot
+   * be modified.
    *
    * `auto` will create a trace for the session with default values for the workflow
    * name, group id, and metadata.

package/src/resources/realtime/client-secrets.ts

@@ -153,8 +153,9 @@ export interface RealtimeSessionCreateResponse {
 
   /**
    * Realtime API can write session traces to the
-   * [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-   * tracing is enabled for a session, the configuration cannot be modified.
+   * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+   * disable tracing. Once tracing is enabled for a session, the configuration cannot
+   * be modified.
    *
    * `auto` will create a trace for the session with default values for the workflow
    * name, group id, and metadata.

package/src/resources/realtime/realtime.ts

@@ -3136,8 +3136,9 @@ export interface RealtimeSessionCreateRequest {
 
   /**
    * Realtime API can write session traces to the
-   * [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-   * tracing is enabled for a session, the configuration cannot be modified.
+   * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+   * disable tracing. Once tracing is enabled for a session, the configuration cannot
+   * be modified.
    *
    * `auto` will create a trace for the session with default values for the workflow
    * name, group id, and metadata.
@@ -3349,8 +3350,9 @@ export namespace RealtimeToolsConfigUnion {
 
 /**
  * Realtime API can write session traces to the
- * [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
- * tracing is enabled for a session, the configuration cannot be modified.
+ * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+ * disable tracing. Once tracing is enabled for a session, the configuration cannot
+ * be modified.
  *
  * `auto` will create a trace for the session with default values for the workflow
  * name, group id, and metadata.

package/src/resources/shared.ts

@@ -248,6 +248,8 @@ export type FunctionParameters = { [key: string]: unknown };
  */
 export type Metadata = { [key: string]: string };
 
+export type OAuthErrorCode = 'invalid_grant' | 'invalid_subject_token' | (string & {});
+
 /**
  * **gpt-5 and o-series models only**
  *

package/src/resources/vector-stores/file-batches.ts

@@ -274,8 +274,9 @@ export interface FileBatchCreateParams {
    * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
    * the vector store should use. Useful for tools like `file_search` that can access
    * files. If `attributes` or `chunking_strategy` are provided, they will be applied
-   * to all files in the batch. The maximum batch size is 2000 files. Mutually
-   * exclusive with `files`.
+   * to all files in the batch. The maximum batch size is 2000 files. This endpoint
+   * is recommended for multi-file ingestion and helps reduce per-vector-store write
+   * request pressure. Mutually exclusive with `files`.
    */
   file_ids?: Array<string>;
 
@@ -283,8 +284,9 @@ export interface FileBatchCreateParams {
    * A list of objects that each include a `file_id` plus optional `attributes` or
    * `chunking_strategy`. Use this when you need to override metadata for specific
    * files. The global `attributes` or `chunking_strategy` will be ignored and must
-   * be specified for each file. The maximum batch size is 2000 files. Mutually
-   * exclusive with `file_ids`.
+   * be specified for each file. The maximum batch size is 2000 files. This endpoint
+   * is recommended for multi-file ingestion and helps reduce per-vector-store write
+   * request pressure. Mutually exclusive with `file_ids`.
    */
   files?: Array<FileBatchCreateParams.File>;
 }
@@ -294,7 +296,9 @@ export namespace FileBatchCreateParams {
     /**
      * A [File](https://platform.openai.com/docs/api-reference/files) ID that the
      * vector store should use. Useful for tools like `file_search` that can access
-     * files.
+     * files. For multi-file ingestion, we recommend
+     * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+     * to minimize per-vector-store write requests.
      */
     file_id: string;
 

package/src/resources/vector-stores/files.ts

@@ -299,7 +299,9 @@ export interface FileCreateParams {
   /**
    * A [File](https://platform.openai.com/docs/api-reference/files) ID that the
    * vector store should use. Useful for tools like `file_search` that can access
-   * files.
+   * files. For multi-file ingestion, we recommend
+   * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+   * to minimize per-vector-store write requests.
    */
   file_id: string;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.33.0'; // x-release-please-version
+export const VERSION = '6.34.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.33.0";
+export declare const VERSION = "6.34.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.33.0";
+export declare const VERSION = "6.34.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.33.0'; // x-release-please-version
+exports.VERSION = '6.34.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.33.0'; // x-release-please-version
+export const VERSION = '6.34.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map