fix(api): narrow types

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 11
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/dedalus-labs%2Fdedalus-sdk-2158e2dd12dc5bc533e872e1fa4a9bd1627c2f15b0e417aa4645554e045d7054.yml
-openapi_spec_hash: 30d4d077bf498b7634b3e14deb9d0a1d
-config_hash: c520c6ec7d9767224157d03e00c54985
+configured_endpoints: 12
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/dedalus-labs%2Fdedalus-sdk-3330faa66a188880e45bcc35fa1b899365424c079dfd79b45c4da710eeccab10.yml
+openapi_spec_hash: 542937ce78a5c4ee4dbe54ab837151d2
+config_hash: 2b25f3d3742dd0d7790fd4339f500a29

api.md

@@ -18,6 +18,7 @@ Types:
 - <code><a href="./src/resources/shared.ts">ResponseFormatJSONSchema</a></code>
 - <code><a href="./src/resources/shared.ts">ResponseFormatText</a></code>
 - <code><a href="./src/resources/shared.ts">ToolChoice</a></code>
+- <code><a href="./src/resources/shared.ts">VoiceIDsOrCustomVoice</a></code>
 
 # Models
 
@@ -97,6 +98,17 @@ Methods:
 
 - <code title="post /v1/ocr">client.ocr.<a href="./src/resources/ocr.ts">process</a>({ ...params }) -> OCRResponse</code>
 
+# Responses
+
+Types:
+
+- <code><a href="./src/resources/responses.ts">Response</a></code>
+- <code><a href="./src/resources/responses.ts">ResponseCreateParams</a></code>
+
+Methods:
+
+- <code title="post /v1/responses">client.responses.<a href="./src/resources/responses.ts">create</a>({ ...params }) -> Response</code>
+
 # Chat
 
 ## Completions

packages/mcp-server/src/methods.ts

@@ -68,6 +68,12 @@ export const sdkMethods: SdkMethod[] = [
     httpMethod: 'post',
     httpPath: '/v1/ocr',
   },
+  {
+    clientCallName: 'client.responses.create',
+    fullyQualifiedName: 'responses.create',
+    httpMethod: 'post',
+    httpPath: '/v1/responses',
+  },
   {
     clientCallName: 'client.chat.completions.create',
     fullyQualifiedName: 'chat.completions.create',

src/client.ts

@@ -33,6 +33,7 @@ import {
 } from './resources/images';
 import { ListModelsResponse, Model, Models } from './resources/models';
 import { OCR, OCRDocument, OCRPage, OCRProcessParams, OCRRequest, OCRResponse } from './resources/ocr';
+import { Response, ResponseCreateParams, Responses } from './resources/responses';
 import { Audio } from './resources/audio/audio';
 import { Chat } from './resources/chat/chat';
 import { type Fetch } from './internal/builtin-types';
@@ -873,6 +874,7 @@ export class Dedalus {
   audio: API.Audio = new API.Audio(this);
   images: API.Images = new API.Images(this);
   ocr: API.OCR = new API.OCR(this);
+  responses: API.Responses = new API.Responses(this);
   chat: API.Chat = new API.Chat(this);
 }
 
@@ -881,6 +883,7 @@ Dedalus.Embeddings = Embeddings;
 Dedalus.Audio = Audio;
 Dedalus.Images = Images;
 Dedalus.OCR = OCR;
+Dedalus.Responses = Responses;
 Dedalus.Chat = Chat;
 
 export declare namespace Dedalus {
@@ -916,6 +919,12 @@ export declare namespace Dedalus {
     type OCRProcessParams as OCRProcessParams,
   };
 
+  export {
+    Responses as Responses,
+    type Response as Response,
+    type ResponseCreateParams as ResponseCreateParams,
+  };
+
   export { Chat as Chat };
 
   export type Credential = API.Credential;
@@ -934,4 +943,5 @@ export declare namespace Dedalus {
   export type ResponseFormatJSONSchema = API.ResponseFormatJSONSchema;
   export type ResponseFormatText = API.ResponseFormatText;
   export type ToolChoice = API.ToolChoice;
+  export type VoiceIDsOrCustomVoice = API.VoiceIDsOrCustomVoice;
 }

src/resources/audio/speech.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -32,19 +33,21 @@ export interface SpeechCreateParams {
   input: string;
 
   /**
-   * One of the available [TTS models](https://platform.openai.com/docs/models#tts):
-   * `tts-1`, `tts-1-hd` or `gpt-4o-mini-tts`.
+   * One of the available [TTS models](/docs/models#tts): `tts-1`, `tts-1-hd`,
+   * `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
    */
-  model: (string & {}) | 'tts-1' | 'tts-1-hd' | 'gpt-4o-mini-tts';
+  model: (string & {}) | 'tts-1' | 'tts-1-hd' | 'gpt-4o-mini-tts' | 'gpt-4o-mini-tts-2025-12-15';
 
   /**
-   * The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-   * `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-   * `verse`. Previews of the voices are available in the
-   * [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+   * The voice to use when generating the audio. Supported built-in voices are
+   * `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+   * `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
+   * object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
+   * voices are available in the
+   * [Text to speech guide](/docs/guides/text-to-speech#voice-options).
    */
   voice:
-    | (string & {})
+    | string
     | 'alloy'
     | 'ash'
     | 'ballad'
@@ -54,7 +57,8 @@ export interface SpeechCreateParams {
     | 'shimmer'
     | 'verse'
     | 'marin'
-    | 'cedar';
+    | 'cedar'
+    | Shared.VoiceIDsOrCustomVoice;
 
   /**
    * Control the voice of your generated audio with additional instructions. Does not

src/resources/audio/transcriptions.ts

@@ -96,7 +96,7 @@ export namespace TranscriptionCreateResponse {
 
   export namespace CreateTranscriptionResponseVerboseJSON {
     /**
-     * Fields:
+     * Fields: # noqa: D415.
      *
      * - id (required): int
      * - seek (required): int
@@ -180,7 +180,7 @@ export namespace TranscriptionCreateResponse {
     }
 
     /**
-     * Fields:
+     * Fields: # noqa: D415.
      *
      * - word (required): str
      * - start (required): float
@@ -237,7 +237,7 @@ export namespace TranscriptionCreateResponse {
 
   export namespace CreateTranscriptionResponseJSON {
     /**
-     * Fields:
+     * Fields: # noqa: D415.
      *
      * - token (optional): str
      * - logprob (optional): float

src/resources/audio/translations.ts

@@ -30,7 +30,7 @@ export class Translations extends APIResource {
 }
 
 /**
- * Fields:
+ * Fields: # noqa: D415.
  *
  * - language (required): str
  * - duration (required): float
@@ -43,7 +43,7 @@ export type TranslationCreateResponse =
 
 export namespace TranslationCreateResponse {
   /**
-   * Fields:
+   * Fields: # noqa: D415.
    *
    * - language (required): str
    * - duration (required): float
@@ -74,7 +74,7 @@ export namespace TranslationCreateResponse {
 
   export namespace CreateTranslationResponseVerboseJSON {
     /**
-     * Fields:
+     * Fields: # noqa: D415.
      *
      * - id (required): int
      * - seek (required): int
@@ -144,7 +144,7 @@ export namespace TranslationCreateResponse {
   }
 
   /**
-   * Fields:
+   * Fields: # noqa: D415.
    *
    * - text (required): str
    */