openai 7.27.0 → 7.30.0

package/src/resources/audio/audio.ts

@@ -31,11 +31,14 @@ import {
   TranslationVerbose,
   Translations,
 } from './translations';
+import * as VoicesAPI from './voices';
+import { Voice, VoiceCreateParams, Voices } from './voices';
 
 export class Audio extends APIResource {
   transcriptions: TranscriptionsAPI.Transcriptions = new TranscriptionsAPI.Transcriptions(this._client);
   translations: TranslationsAPI.Translations = new TranslationsAPI.Translations(this._client);
   speech: SpeechAPI.Speech = new SpeechAPI.Speech(this._client);
+  voices: VoicesAPI.Voices = new VoicesAPI.Voices(this._client);
 }
 
 export type AudioModel =
@@ -58,6 +61,7 @@ export type AudioResponseFormat = 'json' | 'text' | 'srt' | 'verbose_json' | 'vt
 Audio.Transcriptions = Transcriptions;
 Audio.Translations = Translations;
 Audio.Speech = Speech;
+Audio.Voices = Voices;
 
 export declare namespace Audio {
   export { type AudioModel as AudioModel, type AudioResponseFormat as AudioResponseFormat };
@@ -91,4 +95,6 @@ export declare namespace Audio {
   };
 
   export { Speech as Speech, type SpeechModel as SpeechModel, type SpeechCreateParams as SpeechCreateParams };
+
+  export { Voices as Voices, type Voice as Voice, type VoiceCreateParams as VoiceCreateParams };
 }

package/src/resources/audio/index.ts

@@ -28,3 +28,4 @@ export {
   type TranslationCreateResponse,
   type TranslationCreateParams,
 } from './translations';
+export { Voices, type Voice, type VoiceCreateParams } from './voices';

package/src/resources/audio/speech.ts

@@ -69,6 +69,8 @@ export interface SpeechCreateParams {
    * object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
    * voices are available in the
    * [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
+   * Custom voices must be created from audio samples. Voices created from text
+   * prompts are supported only in Live.
    */
   voice:
     | string

package/src/resources/audio/voices.ts

@@ -0,0 +1,152 @@
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { type Uploadable } from '../../core/uploads';
+import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
+
+function resolveResourceRequestOptions(
+  options: RequestOptions | undefined,
+  buildOptions: (options: RequestOptions | undefined) => RequestOptions | Promise<RequestOptions>,
+): Promise<RequestOptions> {
+  return Promise.resolve(options).then(buildOptions);
+}
+
+/**
+ * Turn audio into text or text into audio.
+ */
+export class Voices extends APIResource {
+  /**
+   * Creates a voice from a text prompt or from a consent recording and an audio
+   * sample.
+   *
+   * For prompt-based creation, send `type: "prompt"` with a `name` and `prompt` as
+   * JSON or multipart form data. For creation from an audio sample, send
+   * `type: "audio_sample"` with a `name`, `audio_sample`, and `consent` recording ID
+   * as multipart form data. The type defaults to `audio_sample` when omitted.
+   *
+   * Returns the saved voice's metadata. Voices created from text prompts are
+   * supported only in Live, not in Realtime or the speech endpoint. The response
+   * does not include preview audio.
+   *
+   * @example
+   * ```ts
+   * const voice = await client.audio.voices.create({
+   *   audio_sample: fs.createReadStream('path/to/file'),
+   *   consent: 'consent',
+   *   name: 'x',
+   * });
+   * ```
+   */
+  create(body: VoiceCreateParams, options?: RequestOptions): APIPromise<Voice> {
+    return this._client.post(
+      '/audio/voices',
+      resolveResourceRequestOptions(options, (options) =>
+        multipartFormRequestOptions({ body, ...options, __security: { bearerAuth: true } }, this._client),
+      ),
+    );
+  }
+}
+
+/**
+ * A custom voice that can be used for audio output. Voices created from text
+ * prompts are supported only in Live.
+ */
+export interface Voice {
+  /**
+   * The voice identifier, which can be referenced in API endpoints.
+   */
+  id: string;
+
+  /**
+   * The Unix timestamp (in seconds) for when the voice was created.
+   */
+  created_at: number;
+
+  /**
+   * The name of the voice.
+   */
+  name: string;
+
+  /**
+   * The object type, which is always `audio.voice`.
+   */
+  object: 'audio.voice';
+
+  /**
+   * How the voice was created. Voices created from text prompts are supported only
+   * in Live.
+   */
+  type: 'audio_sample' | 'prompt';
+}
+
+export type VoiceCreateParams = VoiceCreateParams.Consent | VoiceCreateParams.Prompt;
+
+export declare namespace VoiceCreateParams {
+  /**
+   * Creates a voice from a consent recording and an audio sample. Requires
+   * multipart/form-data.
+   */
+  export interface Consent {
+    /**
+     * The sample audio recording file. Maximum size is 10 MiB.
+     *
+     * Supported MIME types: `audio/mpeg`, `audio/wav`, `audio/x-wav`, `audio/ogg`,
+     * `audio/aac`, `audio/flac`, `audio/webm`, `audio/mp4`.
+     */
+    audio_sample: Uploadable;
+
+    /**
+     * The consent recording ID (for example, `cons_1234`).
+     */
+    consent: string;
+
+    /**
+     * The name of the new voice.
+     */
+    name: string;
+
+    /**
+     * The voice creation method. Defaults to `audio_sample` when omitted.
+     */
+    type?: 'audio_sample';
+  }
+
+  /**
+   * Creates a synthetic voice from a text description. Supports application/json or
+   * multipart/form-data.
+   */
+  export interface Prompt {
+    /**
+     * The name of the new voice.
+     */
+    name: string;
+
+    /**
+     * A description of the desired voice. Must not contain only whitespace.
+     */
+    prompt: string;
+
+    /**
+     * Set to `prompt` to create a voice from a text description.
+     */
+    type: 'prompt';
+
+    /**
+     * The voice creation model to use. Defaults to `auto`.
+     */
+    model?: string | 'auto' | '2026-10-01';
+
+    /**
+     * Optional text for the voice to speak during creation. If omitted, a script is
+     * generated from the prompt. Must not be blank after trimming whitespace; scripts
+     * that are too short are rejected.
+     */
+    script_hint?: string;
+  }
+}
+
+export declare namespace Voices {
+  export { type Voice as Voice, type VoiceCreateParams as VoiceCreateParams };
+}

package/src/resources/beta/agents/agents.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../../core/resource';
 import * as AgentsAPI from './agents';
-import * as TurnsAPI from './sessions/turns';
+import * as TurnsAPI from './sessions/turns/turns';
 import * as EnvironmentsAPI from './environments/environments';
 import { EnvironmentInfo, Environments } from './environments/environments';
 import * as SessionsAPI from './sessions/sessions';
@@ -3825,8 +3825,8 @@ export namespace EnvironmentParam {
     files?: Array<AgentsAPI.HostedEnvironmentFileParam> | null;
 
     /**
-     * Network access policy for the environment. Defaults to disabled for GA requests
-     * and enabled for beta requests.
+     * Network access policy for the environment. If omitted, the API version
+     * determines whether network access is enabled or disabled.
      */
     network?: EnvironmentParamOpenAIHosted.Network | null;
 
@@ -3865,8 +3865,8 @@ export namespace EnvironmentParam {
     }
 
     /**
-     * Network access policy for the environment. Defaults to disabled for GA requests
-     * and enabled for beta requests.
+     * Network access policy for the environment. If omitted, the API version
+     * determines whether network access is enabled or disabled.
      */
     export interface Network {
       /**
@@ -5003,6 +5003,12 @@ export interface SessionTurnError {
    * - `session_budget_exceeded` - The session has reached its usage budget.
    * - `usage_limit_exceeded` - The organization has reached a usage, plan, or
    *   billing limit.
+   * - `project_spend_limit_exceeded` - The project has reached its enforced spend
+   *   limit.
+   * - `organization_spend_limit_exceeded` - The organization has reached its
+   *   enforced spend limit.
+   * - `organization_usage_limit_exceeded` - The organization has reached its
+   *   OpenAI-assigned usage limit.
    * - `credit_balance_exhausted` - The organization has no API credits remaining.
    * - `rate_limit_exceeded` - The request exceeds the available rate limit.
    * - `flex_unavailable` - Flex processing is temporarily unavailable.
@@ -5029,6 +5035,9 @@ export interface SessionTurnError {
     | 'context_length_exceeded'
     | 'session_budget_exceeded'
     | 'usage_limit_exceeded'
+    | 'project_spend_limit_exceeded'
+    | 'organization_spend_limit_exceeded'
+    | 'organization_usage_limit_exceeded'
     | 'credit_balance_exhausted'
     | 'rate_limit_exceeded'
     | 'flex_unavailable'
@@ -5372,9 +5381,8 @@ export interface AgentCreateParams {
    * - `flex` - Uses the flex service tier.
    * - `priority` - Uses the priority service tier.
    * - `fast` - Uses the fast service tier.
-   * - `ultrafast` - Uses the ultrafast service tier.
    */
-  service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | 'ultrafast' | null;
+  service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | null;
 
   /**
    * Configuration for generated text. Defaults to the `text` format and medium
@@ -5431,9 +5439,8 @@ export interface AgentUpdateParams {
    * - `flex` - Uses the flex service tier.
    * - `priority` - Uses the priority service tier.
    * - `fast` - Uses the fast service tier.
-   * - `ultrafast` - Uses the ultrafast service tier.
    */
-  service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | 'ultrafast' | null;
+  service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | null;
 
   /**
    * Configuration for text generated by the agent.

package/src/resources/beta/agents/environments/templates.ts

@@ -601,8 +601,8 @@ export interface TemplateCreateParams {
   name?: string | null;
 
   /**
-   * Network access policy for the environment. Defaults to disabled for GA requests
-   * and enabled for beta requests.
+   * Network access policy for the environment. If omitted, the API version
+   * determines whether network access is enabled or disabled.
    */
   network?: TemplateCreateParams.Network | null;
 
@@ -641,8 +641,8 @@ export namespace TemplateCreateParams {
   }
 
   /**
-   * Network access policy for the environment. Defaults to disabled for GA requests
-   * and enabled for beta requests.
+   * Network access policy for the environment. If omitted, the API version
+   * determines whether network access is enabled or disabled.
    */
   export interface Network {
     /**
@@ -716,8 +716,7 @@ export interface TemplateUpdateParams {
 
   /**
    * Network access available after setup completes. Omit to preserve the current
-   * policy, or pass `null` to reset to disabled for GA requests or enabled for beta
-   * requests.
+   * policy, or pass `null` to reset to the default policy.
    */
   network?: TemplateUpdateParams.Network | null;
 
@@ -755,8 +754,7 @@ export namespace TemplateUpdateParams {
 
   /**
    * Network access available after setup completes. Omit to preserve the current
-   * policy, or pass `null` to reset to disabled for GA requests or enabled for beta
-   * requests.
+   * policy, or pass `null` to reset to the default policy.
    */
   export interface Network {
     /**

package/src/resources/beta/agents/sessions/index.ts

@@ -22,4 +22,10 @@ export {
 } from './sessions';
 export { Subagents, type SubagentRetrieveParams, type SubagentListParams } from './subagents/index';
 export { Traces, type SessionTrace, type TraceListParams, type SessionTracesPage } from './traces';
-export { Turns, type Turn, type TurnRetrieveParams, type TurnListParams, type TurnsPage } from './turns';
+export {
+  Turns,
+  type Turn,
+  type TurnRetrieveParams,
+  type TurnListParams,
+  type TurnsPage,
+} from './turns/index';

package/src/resources/beta/agents/sessions/sessions.ts

@@ -3,10 +3,12 @@
 import {
   AgentSessionStream,
   type AgentSessionStreamParams,
+  type AgentToolHandler,
 } from '../../../../lib/agents/agent-session-stream';
 import {
   type AgentSessionCreateStream,
   withAgentTurnResult,
+  captureCreationTools,
 } from '../../../../lib/beta/agents/agent-session-create-stream';
 import type { AgentOutputFormat } from '../../../../lib/beta/agents/output-format-types';
 import { captureAgentOutput } from '../../../../lib/beta/agents/parse-result';
@@ -31,10 +33,10 @@ import * as ItemsAPI from './items';
 import { ItemListParams, Items } from './items';
 import * as TracesAPI from './traces';
 import { SessionTrace, SessionTracesPage, TraceListParams, Traces } from './traces';
-import * as TurnsAPI from './turns';
-import { Turn, TurnListParams, TurnRetrieveParams, Turns, TurnsPage } from './turns';
 import * as SubagentsAPI from './subagents/subagents';
 import { SubagentListParams, SubagentRetrieveParams, Subagents } from './subagents/subagents';
+import * as TurnsAPI from './turns/turns';
+import { Turn, TurnListParams, TurnRetrieveParams, Turns, TurnsPage } from './turns/turns';
 import { APIPromise } from '../../../../core/api-promise';
 import { CursorPage, type CursorPageParams, PagePromise } from '../../../../core/pagination';
 import type { Stream } from '../../../../core/streaming';
@@ -200,7 +202,8 @@ export class Sessions extends APIResource {
     body: SessionCreateParams,
     options?: RequestOptions,
   ): APIPromise<AgentsAPI.AgentSession> | APIPromise<AgentSessionCreateStream> {
-    const output = captureAgentOutput(body, options);
+    const creation = captureCreationTools(body, options);
+    const output = captureAgentOutput(creation.body, creation.options);
     return this._client
       .post<AgentsAPI.AgentSession | Stream<AgentsAPI.AgentSessionEvent>>(
         '/agents/sessions',
@@ -215,7 +218,13 @@ export class Sessions extends APIResource {
       ._thenUnwrap((data, { options }) =>
         // SAFETY: defaultParseResponse uses this same resolved flag to return the configured stream instance.
         options.stream
-          ? withAgentTurnResult(data as Stream<AgentsAPI.AgentSessionEvent>, output.format)
+          ? withAgentTurnResult(
+              data as Stream<AgentsAPI.AgentSessionEvent>,
+              output.format,
+              creation.handlers
+                ? { sessions: this, handlers: creation.handlers, options: output.options }
+                : undefined,
+            )
           : data,
       ) as APIPromise<AgentsAPI.AgentSession> | APIPromise<AgentSessionCreateStream>;
   }
@@ -495,9 +504,8 @@ export namespace SessionCreateParams {
      * - `flex` - Uses the flex service tier.
      * - `priority` - Uses the priority service tier.
      * - `fast` - Uses the fast service tier.
-     * - `ultrafast` - Uses the ultrafast service tier.
      */
-    service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | 'ultrafast' | null;
+    service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | null;
 
     /**
      * Configuration for text generated by the agent.
@@ -515,6 +523,7 @@ export namespace SessionCreateParams {
 }
 
 export interface SessionCreateParamsNonStreaming extends SessionCreateParamsBase {
+  toolHandlers?: never;
   /**
    * Whether to stream session events as server-sent events. Defaults to `false`.
    */
@@ -522,6 +531,8 @@ export interface SessionCreateParamsNonStreaming extends SessionCreateParamsBase
 }
 
 export interface SessionCreateParamsStreaming extends SessionCreateParamsBase {
+  /** Beta: local function handlers run during iteration and are never sent to the API. */
+  toolHandlers?: Record<string, AgentToolHandler>;
   /**
    * Whether to stream session events as server-sent events. Defaults to `false`.
    */
@@ -565,9 +576,8 @@ export namespace SessionUpdateParams {
      * - `flex` - Uses the flex service tier.
      * - `priority` - Uses the priority service tier.
      * - `fast` - Uses the fast service tier.
-     * - `ultrafast` - Uses the ultrafast service tier.
      */
-    service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | 'ultrafast' | null;
+    service_tier?: 'auto' | 'default' | 'flex' | 'priority' | 'fast' | null;
   }
 
   export namespace Agent {

package/src/resources/beta/agents/sessions/subagents/turns/turns.ts

@@ -1,8 +1,8 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../../../../core/resource';
-import * as TurnsAPI from '../../turns';
-import { TurnsPage } from '../../turns';
+import * as TurnsAPI from '../../turns/turns';
+import { TurnsPage } from '../../turns/turns';
 import * as ItemsAPI from './items';
 import { ItemListParams, Items } from './items';
 import { APIPromise } from '../../../../../../core/api-promise';

package/src/resources/beta/agents/sessions/turns/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+
+export { Items, type ItemListParams } from './items';
+export { Turns, type Turn, type TurnRetrieveParams, type TurnListParams, type TurnsPage } from './turns';

package/src/resources/beta/agents/sessions/turns/items.ts

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as AgentsAPI from '../../agents';
+import { AgentSessionItemsPage } from '../../agents';
+import {
+  ConversationCursorPage,
+  type ConversationCursorPageParams,
+  PagePromise,
+} from '../../../../../core/pagination';
+import { buildHeaders } from '../../../../../internal/headers';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
+
+function resolveResourceRequestOptions(
+  options: RequestOptions | undefined,
+  buildOptions: (options: RequestOptions | undefined) => RequestOptions | Promise<RequestOptions>,
+): Promise<RequestOptions> {
+  return Promise.resolve(options).then(buildOptions);
+}
+
+export class Items extends APIResource {
+  /**
+   * Lists items belonging to one root-agent turn, including its interactions with
+   * subagents. See
+   * [inspecting agent output](https://developers.openai.com/api/docs/guides/agents-api/observability).
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const agentSessionItem of client.beta.agents.sessions.turns.items.list(
+   *   'turn_id',
+   *   { session_id: 'session_id' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    turnID: string,
+    params: ItemListParams,
+    options?: RequestOptions,
+  ): PagePromise<AgentSessionItemsConversationCursorPage, AgentsAPI.AgentSessionItem> {
+    const { session_id, ...query } = params;
+    return this._client.getAPIList(
+      path`/agents/sessions/${session_id}/turns/${turnID}/items`,
+      ConversationCursorPage<AgentsAPI.AgentSessionItem>,
+      resolveResourceRequestOptions(options, (options) => ({
+        query,
+        ...options,
+        headers: buildHeaders([{ 'OpenAI-Beta': 'agents=v1' }, options?.headers]),
+        __security: { bearerAuth: true },
+      })),
+    );
+  }
+}
+
+export type AgentSessionItemsConversationCursorPage = ConversationCursorPage<AgentsAPI.AgentSessionItem>;
+
+export interface ItemListParams extends ConversationCursorPageParams {
+  /**
+   * Path param: The ID of the session that owns the turn.
+   */
+  session_id: string;
+
+  /**
+   * Query param: The order in which resources are returned. Defaults to `desc`.
+   *
+   * - `asc` - Returns resources in ascending order.
+   * - `desc` - Returns resources in descending order.
+   */
+  order?: 'asc' | 'desc';
+}
+
+export declare namespace Items {
+  export { type ItemListParams as ItemListParams };
+}
+
+export { type AgentSessionItemsPage };