@deepgram/sdk 5.0.0-alpha.2 → 5.0.0-alpha.3

package/dist/esm/CustomClient.mjs

@@ -37,13 +37,79 @@ catch (_a) {
     // ws not available (e.g., in browser)
     NodeWebSocket = undefined;
 }
+// Helper function to generate UUID that works in both Node.js and browser
+function generateUUID() {
+    // In Node.js, use the crypto module
+    if (RUNTIME.type === "node") {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const crypto = require("crypto");
+            return crypto.randomUUID();
+        }
+        catch (_a) {
+            // Fallback if crypto module is not available
+        }
+    }
+    // In browser or as fallback, use global crypto if available
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    // Fallback UUID generation (RFC4122 version 4)
+    // This is a simple fallback that should work everywhere
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Wrapper auth provider that checks for accessToken first (Bearer scheme)
+ * before falling back to the original auth provider (Token scheme for API keys).
+ */
+class AccessTokenAuthProviderWrapper {
+    constructor(originalProvider, accessToken) {
+        this.originalProvider = originalProvider;
+        this.accessToken = accessToken;
+    }
+    getAuthRequest(arg) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            // Check for access token first (highest priority)
+            // Access tokens use Bearer scheme, API keys use Token scheme
+            const accessToken = (_a = (yield core.Supplier.get(this.accessToken))) !== null && _a !== void 0 ? _a : (_b = process.env) === null || _b === void 0 ? void 0 : _b.DEEPGRAM_ACCESS_TOKEN;
+            if (accessToken != null) {
+                return {
+                    headers: { Authorization: `Bearer ${accessToken}` },
+                };
+            }
+            // Fall back to original provider (which handles API keys)
+            return this.originalProvider.getAuthRequest(arg);
+        });
+    }
+}
 /**
  * Custom wrapper around DeepgramClient that ensures the custom websocket implementation
  * from ws.ts is always used, even if the auto-generated code changes.
  */
 export class CustomDeepgramClient extends DeepgramClient {
     constructor(options = {}) {
-        super(options);
+        // Generate a UUID for the session ID
+        const sessionId = generateUUID();
+        // Add the session ID to headers so it's included in all REST requests
+        const optionsWithSessionId = Object.assign(Object.assign({}, options), { headers: Object.assign(Object.assign({}, options.headers), { "x-deepgram-session-id": sessionId }) });
+        super(optionsWithSessionId);
+        this._sessionId = sessionId;
+        // Wrap the auth provider to handle accessToken if provided
+        // This ensures accessToken takes priority over apiKey/env var
+        if (options.accessToken != null) {
+            this._options.authProvider = new AccessTokenAuthProviderWrapper(this._options.authProvider, options.accessToken);
+        }
+    }
+    /**
+     * Get the session ID that was generated for this client instance.
+     */
+    get sessionId() {
+        return this._sessionId;
     }
     /**
      * Override the agent getter to return a wrapped client that ensures
@@ -106,6 +172,25 @@ class WrappedSpeakClient extends SpeakClientImpl {
         return new WrappedSpeakV1Client(this._options);
     }
 }
+/**
+ * Helper function to resolve Suppliers in headers to their actual values.
+ */
+function resolveHeaders(headers) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const resolved = {};
+        for (const [key, value] of Object.entries(headers)) {
+            if (value == null) {
+                continue;
+            }
+            // Resolve Supplier if it's a Supplier, otherwise use the value directly
+            const resolvedValue = yield core.Supplier.get(value);
+            if (resolvedValue != null) {
+                resolved[key] = resolvedValue;
+            }
+        }
+        return resolved;
+    });
+}
 /**
  * Helper function to get WebSocket class and handle headers/protocols based on runtime.
  * In Node.js, use the 'ws' library which supports headers.
@@ -115,6 +200,8 @@ function getWebSocketOptions(headers) {
     const options = {};
     // Check if we're in a browser environment (browser or web-worker)
     const isBrowser = RUNTIME.type === "browser" || RUNTIME.type === "web-worker";
+    // Extract session ID header
+    const sessionIdHeader = headers["x-deepgram-session-id"] || headers["X-Deepgram-Session-Id"];
     // In Node.js, ensure we use the 'ws' library which supports headers
     if (RUNTIME.type === "node" && NodeWebSocket) {
         options.WebSocket = NodeWebSocket;
@@ -125,10 +212,14 @@ function getWebSocketOptions(headers) {
         // Extract Authorization header and use Sec-WebSocket-Protocol instead
         const authHeader = headers.Authorization || headers.authorization;
         const browserHeaders = Object.assign({}, headers);
-        // Remove Authorization from headers since it won't work in browser
+        // Remove Authorization and session ID from headers since they won't work in browser
         delete browserHeaders.Authorization;
         delete browserHeaders.authorization;
+        delete browserHeaders["x-deepgram-session-id"];
+        delete browserHeaders["X-Deepgram-Session-Id"];
         options.headers = browserHeaders;
+        // Build protocols array for browser WebSocket
+        const protocols = [];
         // If we have an Authorization header, extract the token and format as protocols
         // Deepgram expects:
         // - For API keys: Sec-WebSocket-Protocol: token,API_KEY_GOES_HERE
@@ -138,18 +229,25 @@ function getWebSocketOptions(headers) {
             if (authHeader.startsWith("Token ")) {
                 // API key: "Token API_KEY" -> ["token", "API_KEY"]
                 const apiKey = authHeader.substring(6); // Remove "Token " prefix
-                options.protocols = ["token", apiKey];
+                protocols.push("token", apiKey);
             }
             else if (authHeader.startsWith("Bearer ")) {
                 // Access token: "Bearer TOKEN" -> ["bearer", "TOKEN"]
                 const token = authHeader.substring(7); // Remove "Bearer " prefix
-                options.protocols = ["bearer", token];
+                protocols.push("bearer", token);
             }
             else {
                 // Fallback: use the entire header value if it doesn't match expected format
-                options.protocols = [authHeader];
+                protocols.push(authHeader);
             }
         }
+        // Add session ID as a protocol for browser WebSocket
+        if (sessionIdHeader && typeof sessionIdHeader === "string") {
+            protocols.push("x-deepgram-session-id", sessionIdHeader);
+        }
+        if (protocols.length > 0) {
+            options.protocols = protocols;
+        }
     }
     else {
         // Fallback for other environments
@@ -163,17 +261,20 @@ function getWebSocketOptions(headers) {
 class WrappedAgentV1Client extends AgentV1Client {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d, _e, _f;
             const { headers, debug, reconnectAttempts } = args;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
-            const _headers = mergeHeaders((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = mergeHeaders((_b = this._options.headers) !== null && _b !== void 0 ? _b : {}, (_c = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _c !== void 0 ? _c : {}, headers);
+            // Resolve any Suppliers in headers to actual values
+            const _headers = yield resolveHeaders(mergedHeaders);
             // Get WebSocket options with proper header handling
             const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
-                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).agent, "/v1/agent/converse"),
-                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.DeepgramEnvironment.Production).agent, "/v1/agent/converse"),
+                protocols: (_f = wsOptions.protocols) !== null && _f !== void 0 ? _f : [],
                 queryParameters: {},
                 headers: wsOptions.headers,
                 options: {
@@ -253,7 +354,7 @@ class WrappedAgentV1Socket extends AgentV1Socket {
 class WrappedListenV1Client extends ListenV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             // Extract all the args (same as the original implementation)
             const { callback, callback_method: callbackMethod, channels, diarize, dictation, encoding, endpointing, extra, interim_results: interimResults, keyterm, keywords, language, mip_opt_out: mipOptOut, model, multichannel, numerals, profanity_filter: profanityFilter, punctuate, redact, replace, sample_rate: sampleRate, search, smart_format: smartFormat, tag, utterance_end_ms: utteranceEndMs, vad_events: vadEvents, version, headers, debug, reconnectAttempts, } = args;
             // Build query params (same as original)
@@ -313,13 +414,16 @@ class WrappedListenV1Client extends ListenV1Client {
                 _queryParams.version = version;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(authRequest.headers, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = mergeHeaders((_a = this._options.headers) !== null && _a !== void 0 ? _a : {}, authRequest.headers, headers);
+            // Resolve any Suppliers in headers to actual values
+            const _headers = yield resolveHeaders(mergedHeaders);
             // Get WebSocket options with proper header handling
             const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
-                url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/listen"),
-                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.DeepgramEnvironment.Production).production, "/v1/listen"),
+                protocols: (_d = wsOptions.protocols) !== null && _d !== void 0 ? _d : [],
                 queryParameters: _queryParams,
                 headers: wsOptions.headers,
                 options: {
@@ -392,7 +496,7 @@ class WrappedListenV1Socket extends ListenV1Socket {
 class WrappedListenV2Client extends ListenV2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d, _e, _f;
             const { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, mip_opt_out: mipOptOut, tag, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             _queryParams.model = model;
@@ -414,13 +518,16 @@ class WrappedListenV2Client extends ListenV2Client {
                 _queryParams.tag = tag;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
-            const _headers = mergeHeaders((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = mergeHeaders((_b = this._options.headers) !== null && _b !== void 0 ? _b : {}, (_c = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _c !== void 0 ? _c : {}, headers);
+            // Resolve any Suppliers in headers to actual values
+            const _headers = yield resolveHeaders(mergedHeaders);
             // Get WebSocket options with proper header handling
             const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
-                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).production, "/v2/listen"),
-                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.DeepgramEnvironment.Production).production, "/v2/listen"),
+                protocols: (_f = wsOptions.protocols) !== null && _f !== void 0 ? _f : [],
                 queryParameters: _queryParams,
                 headers: wsOptions.headers,
                 options: {
@@ -493,7 +600,7 @@ class WrappedListenV2Socket extends ListenV2Socket {
 class WrappedSpeakV1Client extends SpeakV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             if (encoding != null)
@@ -506,13 +613,16 @@ class WrappedSpeakV1Client extends SpeakV1Client {
                 _queryParams.sample_rate = sampleRate;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(authRequest.headers, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = mergeHeaders((_a = this._options.headers) !== null && _a !== void 0 ? _a : {}, authRequest.headers, headers);
+            // Resolve any Suppliers in headers to actual values
+            const _headers = yield resolveHeaders(mergedHeaders);
             // Get WebSocket options with proper header handling
             const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
-                url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/speak"),
-                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.DeepgramEnvironment.Production).production, "/v1/speak"),
+                protocols: (_d = wsOptions.protocols) !== null && _d !== void 0 ? _d : [],
                 queryParameters: _queryParams,
                 headers: wsOptions.headers,
                 options: {

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1Settings.d.mts

@@ -73,7 +73,7 @@ export declare namespace AgentV1Settings {
         }
     }
     interface Agent {
-        /** Agent language */
+        /** Deprecated. Use `listen.provider.language` and `speak.provider.language` fields instead. */
         language?: string;
         /** Conversation context including the history of messages and function calls */
         context?: Agent.Context;
@@ -120,22 +120,10 @@ export declare namespace AgentV1Settings {
             }
         }
         interface Listen {
-            provider?: Listen.Provider;
-        }
-        namespace Listen {
-            interface Provider {
-                /** Provider type for speech-to-text */
-                type: "deepgram";
-                /** Model to use for speech to text */
-                model?: string;
-                /** Prompt key-term recognition (nova-3 'en' only) */
-                keyterms?: string[];
-                /** Applies smart formatting to improve transcript readability (Deepgram providers only) */
-                smart_format?: boolean;
-            }
+            provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider;
         }
         interface Think {
-            provider: Think.Provider;
+            provider: Deepgram.agent.AgentV1SettingsAgentThinkProvider;
             /** Optional for non-Deepgram LLM providers. When present, must include url field and headers object */
             endpoint?: Think.Endpoint;
             functions?: Think.Functions.Item[];
@@ -144,34 +132,6 @@ export declare namespace AgentV1Settings {
             context_length?: Think.ContextLength;
         }
         namespace Think {
-            type Provider = {
-                type?: "open_ai" | undefined;
-                model?: ("gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "gpt-4o" | "gpt-4o-mini") | undefined;
-                temperature?: number | undefined;
-            } | {
-                type?: "aws_bedrock" | undefined;
-                model?: ("anthropic/claude-3-5-sonnet-20240620-v1:0" | "anthropic/claude-3-5-haiku-20240307-v1:0") | undefined;
-                temperature?: number | undefined;
-                credentials?: {
-                    type?: ("sts" | "iam") | undefined;
-                    region?: string | undefined;
-                    access_key_id?: string | undefined;
-                    secret_access_key?: string | undefined;
-                    session_token?: string | undefined;
-                } | undefined;
-            } | {
-                type?: "anthropic" | undefined;
-                model?: ("claude-3-5-haiku-latest" | "claude-sonnet-4-20250514") | undefined;
-                temperature?: number | undefined;
-            } | {
-                type?: "google" | undefined;
-                model?: ("gemini-2.0-flash" | "gemini-2.0-flash-lite" | "gemini-2.5-flash") | undefined;
-                temperature?: number | undefined;
-            } | {
-                type?: "groq" | undefined;
-                model?: "openai/gpt-oss-20b" | undefined;
-                temperature?: number | undefined;
-            };
             /**
              * Optional for non-Deepgram LLM providers. When present, must include url field and headers object
              */

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.d.mts

@@ -0,0 +1,26 @@
+import type * as Deepgram from "../../../../../index.mjs";
+export type AgentV1SettingsAgentListenProvider = Deepgram.agent.AgentV1SettingsAgentListenProvider.V1 | Deepgram.agent.AgentV1SettingsAgentListenProvider.V2;
+export declare namespace AgentV1SettingsAgentListenProvider {
+    interface V1 {
+        version: "v1";
+        /** Provider type for speech-to-text */
+        type: "deepgram";
+        /** Model to use for speech to text using the V1 API (e.g. Nova-3, Nova-2) */
+        model?: string;
+        /** Language code to use for speech-to-text.  Can be a BCP-47 language tag (e.g. `en`), or `multi` for code-switching transcription */
+        language?: string;
+        /** Prompt keyterm recognition to improve Keyword Recall Rate */
+        keyterms?: string[];
+        /** Applies smart formatting to improve transcript readability */
+        smart_format?: boolean;
+    }
+    interface V2 {
+        version: "v2";
+        /** Provider type for speech-to-text */
+        type: "deepgram";
+        /** Model to use for speech to text using the V2 API (e.g. flux-general-en) */
+        model: string;
+        /** Prompt keyterm recognition to improve Keyword Recall Rate */
+        keyterms?: string[];
+    }
+}

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1SettingsAgentSpeakEndpointProvider.d.mts

@@ -3,10 +3,12 @@ export type AgentV1SettingsAgentSpeakEndpointProvider = Deepgram.agent.AgentV1Se
 export declare namespace AgentV1SettingsAgentSpeakEndpointProvider {
     interface Deepgram {
         type: "deepgram";
+        /** The REST API version for the Deepgram text-to-speech API */
+        version?: "v1";
         /** Deepgram TTS model */
-        model: AgentV1SettingsAgentSpeakEndpointProviderDeepgram.Model;
+        model: Deepgram.Model;
     }
-    namespace AgentV1SettingsAgentSpeakEndpointProviderDeepgram {
+    namespace Deepgram {
         /** Deepgram TTS model */
         const Model: {
             readonly AuraAsteriaEn: "aura-asteria-en";
@@ -77,12 +79,16 @@ export declare namespace AgentV1SettingsAgentSpeakEndpointProvider {
     }
     interface ElevenLabs {
         type: "eleven_labs";
+        /** The REST API version for the Deepgram text-to-speech API */
+        version?: "v1";
         /** Eleven Labs model ID */
-        model_id: AgentV1SettingsAgentSpeakEndpointProviderElevenLabs.ModelId;
-        /** Eleven Labs optional language code */
+        model_id: ElevenLabs.ModelId;
+        /** Optional language to use, e.g. 'en-US'.   Corresponds to the `language_code` parameter in the ElevenLabs API */
+        language?: string;
+        /** Use the `language` field instead. */
         language_code?: string;
     }
-    namespace AgentV1SettingsAgentSpeakEndpointProviderElevenLabs {
+    namespace ElevenLabs {
         /** Eleven Labs model ID */
         const ModelId: {
             readonly ElevenTurboV25: "eleven_turbo_v2_5";
@@ -93,13 +99,18 @@ export declare namespace AgentV1SettingsAgentSpeakEndpointProvider {
     }
     interface Cartesia {
         type: "cartesia";
+        /** The API version header for the Cartesia text-to-speech API */
+        version?: Cartesia.Version;
         /** Cartesia model ID */
-        model_id: AgentV1SettingsAgentSpeakEndpointProviderCartesia.ModelId;
-        voice: AgentV1SettingsAgentSpeakEndpointProviderCartesia.Voice;
+        model_id: Cartesia.ModelId;
+        voice: Cartesia.Voice;
         /** Cartesia language code */
         language?: string;
     }
-    namespace AgentV1SettingsAgentSpeakEndpointProviderCartesia {
+    namespace Cartesia {
+        /** The API version header for the Cartesia text-to-speech API */
+        const Version: {};
+        type Version = (typeof Version)[keyof typeof Version];
         /** Cartesia model ID */
         const ModelId: {
             readonly Sonic2: "sonic-2";
@@ -115,12 +126,14 @@ export declare namespace AgentV1SettingsAgentSpeakEndpointProvider {
     }
     interface OpenAi {
         type: "open_ai";
+        /** The REST API version for the OpenAI text-to-speech API */
+        version?: "v1";
         /** OpenAI TTS model */
-        model: AgentV1SettingsAgentSpeakEndpointProviderOpenAi.Model;
+        model: OpenAi.Model;
         /** OpenAI voice */
-        voice: AgentV1SettingsAgentSpeakEndpointProviderOpenAi.Voice;
+        voice: OpenAi.Voice;
     }
-    namespace AgentV1SettingsAgentSpeakEndpointProviderOpenAi {
+    namespace OpenAi {
         /** OpenAI TTS model */
         const Model: {
             readonly Tts1: "tts-1";
@@ -142,8 +155,10 @@ export declare namespace AgentV1SettingsAgentSpeakEndpointProvider {
         type: "aws_polly";
         /** AWS Polly voice name */
         voice: AgentV1SettingsAgentSpeakEndpointProviderAwsPolly.Voice;
-        /** Language code (e.g., "en-US") */
-        language_code: string;
+        /** Language to use, e.g. 'en-US'.   Corresponds to the `language_code` parameter in the AWS Polly API */
+        language: string;
+        /** Use the `language` field instead. */
+        language_code?: string;
         engine: AgentV1SettingsAgentSpeakEndpointProviderAwsPolly.Engine;
         credentials: AgentV1SettingsAgentSpeakEndpointProviderAwsPolly.Credentials;
     }

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1SettingsAgentSpeakEndpointProvider.mjs

@@ -1,10 +1,10 @@
 // This file was auto-generated by Fern from our API Definition.
 export var AgentV1SettingsAgentSpeakEndpointProvider;
 (function (AgentV1SettingsAgentSpeakEndpointProvider) {
-    let AgentV1SettingsAgentSpeakEndpointProviderDeepgram;
-    (function (AgentV1SettingsAgentSpeakEndpointProviderDeepgram) {
+    let Deepgram;
+    (function (Deepgram) {
         /** Deepgram TTS model */
-        AgentV1SettingsAgentSpeakEndpointProviderDeepgram.Model = {
+        Deepgram.Model = {
             AuraAsteriaEn: "aura-asteria-en",
             AuraLunaEn: "aura-luna-en",
             AuraStellaEn: "aura-stella-en",
@@ -69,33 +69,35 @@ export var AgentV1SettingsAgentSpeakEndpointProvider;
             Aura2EstrellaEs: "aura-2-estrella-es",
             Aura2JavierEs: "aura-2-javier-es",
         };
-    })(AgentV1SettingsAgentSpeakEndpointProviderDeepgram = AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderDeepgram || (AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderDeepgram = {}));
-    let AgentV1SettingsAgentSpeakEndpointProviderElevenLabs;
-    (function (AgentV1SettingsAgentSpeakEndpointProviderElevenLabs) {
+    })(Deepgram = AgentV1SettingsAgentSpeakEndpointProvider.Deepgram || (AgentV1SettingsAgentSpeakEndpointProvider.Deepgram = {}));
+    let ElevenLabs;
+    (function (ElevenLabs) {
         /** Eleven Labs model ID */
-        AgentV1SettingsAgentSpeakEndpointProviderElevenLabs.ModelId = {
+        ElevenLabs.ModelId = {
             ElevenTurboV25: "eleven_turbo_v2_5",
             ElevenMonolingualV1: "eleven_monolingual_v1",
             ElevenMultilingualV2: "eleven_multilingual_v2",
         };
-    })(AgentV1SettingsAgentSpeakEndpointProviderElevenLabs = AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderElevenLabs || (AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderElevenLabs = {}));
-    let AgentV1SettingsAgentSpeakEndpointProviderCartesia;
-    (function (AgentV1SettingsAgentSpeakEndpointProviderCartesia) {
+    })(ElevenLabs = AgentV1SettingsAgentSpeakEndpointProvider.ElevenLabs || (AgentV1SettingsAgentSpeakEndpointProvider.ElevenLabs = {}));
+    let Cartesia;
+    (function (Cartesia) {
+        /** The API version header for the Cartesia text-to-speech API */
+        Cartesia.Version = {};
         /** Cartesia model ID */
-        AgentV1SettingsAgentSpeakEndpointProviderCartesia.ModelId = {
+        Cartesia.ModelId = {
             Sonic2: "sonic-2",
             SonicMultilingual: "sonic-multilingual",
         };
-    })(AgentV1SettingsAgentSpeakEndpointProviderCartesia = AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderCartesia || (AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderCartesia = {}));
-    let AgentV1SettingsAgentSpeakEndpointProviderOpenAi;
-    (function (AgentV1SettingsAgentSpeakEndpointProviderOpenAi) {
+    })(Cartesia = AgentV1SettingsAgentSpeakEndpointProvider.Cartesia || (AgentV1SettingsAgentSpeakEndpointProvider.Cartesia = {}));
+    let OpenAi;
+    (function (OpenAi) {
         /** OpenAI TTS model */
-        AgentV1SettingsAgentSpeakEndpointProviderOpenAi.Model = {
+        OpenAi.Model = {
             Tts1: "tts-1",
             Tts1Hd: "tts-1-hd",
         };
         /** OpenAI voice */
-        AgentV1SettingsAgentSpeakEndpointProviderOpenAi.Voice = {
+        OpenAi.Voice = {
             Alloy: "alloy",
             Echo: "echo",
             Fable: "fable",
@@ -103,7 +105,7 @@ export var AgentV1SettingsAgentSpeakEndpointProvider;
             Nova: "nova",
             Shimmer: "shimmer",
         };
-    })(AgentV1SettingsAgentSpeakEndpointProviderOpenAi = AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderOpenAi || (AgentV1SettingsAgentSpeakEndpointProvider.AgentV1SettingsAgentSpeakEndpointProviderOpenAi = {}));
+    })(OpenAi = AgentV1SettingsAgentSpeakEndpointProvider.OpenAi || (AgentV1SettingsAgentSpeakEndpointProvider.OpenAi = {}));
     let AgentV1SettingsAgentSpeakEndpointProviderAwsPolly;
     (function (AgentV1SettingsAgentSpeakEndpointProviderAwsPolly) {
         /** AWS Polly voice name */

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1SettingsAgentSpeakOneItemProvider.d.mts

@@ -3,10 +3,12 @@ export type AgentV1SettingsAgentSpeakOneItemProvider = Deepgram.agent.AgentV1Set
 export declare namespace AgentV1SettingsAgentSpeakOneItemProvider {
     interface Deepgram {
         type: "deepgram";
+        /** The REST API version for the Deepgram text-to-speech API */
+        version?: "v1";
         /** Deepgram TTS model */
-        model: AgentV1SettingsAgentSpeakOneItemProviderDeepgram.Model;
+        model: Deepgram.Model;
     }
-    namespace AgentV1SettingsAgentSpeakOneItemProviderDeepgram {
+    namespace Deepgram {
         /** Deepgram TTS model */
         const Model: {
             readonly AuraAsteriaEn: "aura-asteria-en";
@@ -77,12 +79,16 @@ export declare namespace AgentV1SettingsAgentSpeakOneItemProvider {
     }
     interface ElevenLabs {
         type: "eleven_labs";
+        /** The REST API version for the Deepgram text-to-speech API */
+        version?: "v1";
         /** Eleven Labs model ID */
-        model_id: AgentV1SettingsAgentSpeakOneItemProviderElevenLabs.ModelId;
-        /** Eleven Labs optional language code */
+        model_id: ElevenLabs.ModelId;
+        /** Optional language to use, e.g. 'en-US'.   Corresponds to the `language_code` parameter in the ElevenLabs API */
+        language?: string;
+        /** Use the `language` field instead. */
         language_code?: string;
     }
-    namespace AgentV1SettingsAgentSpeakOneItemProviderElevenLabs {
+    namespace ElevenLabs {
         /** Eleven Labs model ID */
         const ModelId: {
             readonly ElevenTurboV25: "eleven_turbo_v2_5";
@@ -93,13 +99,18 @@ export declare namespace AgentV1SettingsAgentSpeakOneItemProvider {
     }
     interface Cartesia {
         type: "cartesia";
+        /** The API version header for the Cartesia text-to-speech API */
+        version?: Cartesia.Version;
         /** Cartesia model ID */
-        model_id: AgentV1SettingsAgentSpeakOneItemProviderCartesia.ModelId;
-        voice: AgentV1SettingsAgentSpeakOneItemProviderCartesia.Voice;
+        model_id: Cartesia.ModelId;
+        voice: Cartesia.Voice;
         /** Cartesia language code */
         language?: string;
     }
-    namespace AgentV1SettingsAgentSpeakOneItemProviderCartesia {
+    namespace Cartesia {
+        /** The API version header for the Cartesia text-to-speech API */
+        const Version: {};
+        type Version = (typeof Version)[keyof typeof Version];
         /** Cartesia model ID */
         const ModelId: {
             readonly Sonic2: "sonic-2";
@@ -115,12 +126,14 @@ export declare namespace AgentV1SettingsAgentSpeakOneItemProvider {
     }
     interface OpenAi {
         type: "open_ai";
+        /** The REST API version for the OpenAI text-to-speech API */
+        version?: "v1";
         /** OpenAI TTS model */
-        model: AgentV1SettingsAgentSpeakOneItemProviderOpenAi.Model;
+        model: OpenAi.Model;
         /** OpenAI voice */
-        voice: AgentV1SettingsAgentSpeakOneItemProviderOpenAi.Voice;
+        voice: OpenAi.Voice;
     }
-    namespace AgentV1SettingsAgentSpeakOneItemProviderOpenAi {
+    namespace OpenAi {
         /** OpenAI TTS model */
         const Model: {
             readonly Tts1: "tts-1";
@@ -142,8 +155,10 @@ export declare namespace AgentV1SettingsAgentSpeakOneItemProvider {
         type: "aws_polly";
         /** AWS Polly voice name */
         voice: AgentV1SettingsAgentSpeakOneItemProviderAwsPolly.Voice;
-        /** Language code (e.g., "en-US") */
-        language_code: string;
+        /** Language code to use, e.g. 'en-US'.   Corresponds to the `language_code` parameter in the AWS Polly API */
+        language: string;
+        /** Use the `language` field instead. */
+        language_code?: string;
         engine: AgentV1SettingsAgentSpeakOneItemProviderAwsPolly.Engine;
         credentials: AgentV1SettingsAgentSpeakOneItemProviderAwsPolly.Credentials;
     }