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

package/dist/cjs/BaseClient.js

@@ -42,6 +42,9 @@ const core = __importStar(require("./core/index.js"));
 function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
+        "X-Fern-SDK-Name": "",
+        "X-Fern-SDK-Version": "0.0.228",
+        "User-Agent": "/0.0.228",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/CustomClient.d.ts

@@ -2,6 +2,7 @@ import { DeepgramClient } from "./Client";
 import type { AgentClient } from "./api/resources/agent/client/Client.js";
 import type { ListenClient } from "./api/resources/listen/client/Client.js";
 import type { SpeakClient } from "./api/resources/speak/client/Client.js";
+import * as core from "./core/index.js";
 /**
  * Custom wrapper around DeepgramClient that ensures the custom websocket implementation
  * from ws.ts is always used, even if the auto-generated code changes.
@@ -10,7 +11,14 @@ export declare class CustomDeepgramClient extends DeepgramClient {
     private _customAgent;
     private _customListen;
     private _customSpeak;
-    constructor(options?: DeepgramClient.Options);
+    private readonly _sessionId;
+    constructor(options?: DeepgramClient.Options & {
+        accessToken?: core.Supplier<string | undefined>;
+    });
+    /**
+     * Get the session ID that was generated for this client instance.
+     */
+    get sessionId(): string;
     /**
      * Override the agent getter to return a wrapped client that ensures
      * the custom websocket implementation is used.

package/dist/cjs/CustomClient.js

@@ -60,13 +60,92 @@ const headers_js_1 = require("./core/headers.js");
 const json_js_1 = require("./core/json.js");
 const core = __importStar(require("./core/index.js"));
 const environments = __importStar(require("./environments.js"));
+const index_js_1 = require("./core/runtime/index.js");
+// Import ws library for Node.js (will be undefined in browser)
+let NodeWebSocket;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    NodeWebSocket = require("ws");
+    // Handle both default export and named export
+    NodeWebSocket = NodeWebSocket.WebSocket || NodeWebSocket.default || NodeWebSocket;
+}
+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 (index_js_1.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.
  */
 class CustomDeepgramClient extends Client_1.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
@@ -130,24 +209,113 @@ class WrappedSpeakClient extends Client_js_3.SpeakClient {
         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.
+ * In browser, use Sec-WebSocket-Protocol for authentication since headers aren't supported.
+ */
+function getWebSocketOptions(headers) {
+    const options = {};
+    // Check if we're in a browser environment (browser or web-worker)
+    const isBrowser = index_js_1.RUNTIME.type === "browser" || index_js_1.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 (index_js_1.RUNTIME.type === "node" && NodeWebSocket) {
+        options.WebSocket = NodeWebSocket;
+        options.headers = headers;
+    }
+    else if (isBrowser) {
+        // In browser, native WebSocket doesn't support custom headers
+        // Extract Authorization header and use Sec-WebSocket-Protocol instead
+        const authHeader = headers.Authorization || headers.authorization;
+        const browserHeaders = Object.assign({}, headers);
+        // 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
+        // - For Bearer tokens: Sec-WebSocket-Protocol: bearer,TOKEN_GOES_HERE
+        // The comma separates multiple protocols, so we pass them as an array
+        if (authHeader && typeof authHeader === "string") {
+            if (authHeader.startsWith("Token ")) {
+                // API key: "Token API_KEY" -> ["token", "API_KEY"]
+                const apiKey = authHeader.substring(6); // Remove "Token " prefix
+                protocols.push("token", apiKey);
+            }
+            else if (authHeader.startsWith("Bearer ")) {
+                // Access token: "Bearer TOKEN" -> ["bearer", "TOKEN"]
+                const token = authHeader.substring(7); // Remove "Bearer " prefix
+                protocols.push("bearer", token);
+            }
+            else {
+                // Fallback: use the entire header value if it doesn't match expected format
+                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
+        options.headers = headers;
+    }
+    return options;
+}
 /**
  * Wrapper for Agent V1Client that overrides connect to use custom websocket.
  */
 class WrappedAgentV1Client extends Client_js_4.V1Client {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            var _a, _b, _c, _d;
+            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 = (0, headers_js_1.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 = (0, headers_js_1.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 ws_js_1.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: [],
+                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: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -203,6 +371,13 @@ class WrappedAgentV1Socket extends Socket_js_1.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        // by closing and reconnecting
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         // Call parent connect, but then ensure our binary handler is still active
         super.connect();
         // Re-setup binary handling in case connect() re-registered handlers
@@ -216,7 +391,7 @@ class WrappedAgentV1Socket extends Socket_js_1.V1Socket {
 class WrappedListenV1Client extends Client_js_5.V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            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)
@@ -276,14 +451,20 @@ class WrappedListenV1Client extends Client_js_5.V1Client {
                 _queryParams.version = version;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(authRequest.headers, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = (0, headers_js_1.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 ws_js_1.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: [],
+                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: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -335,6 +516,12 @@ class WrappedListenV1Socket extends Socket_js_2.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -346,7 +533,7 @@ class WrappedListenV1Socket extends Socket_js_2.V1Socket {
 class WrappedListenV2Client extends Client_js_6.V2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            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;
@@ -368,14 +555,20 @@ class WrappedListenV2Client extends Client_js_6.V2Client {
                 _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 = (0, headers_js_1.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 = (0, headers_js_1.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 ws_js_1.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: [],
+                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: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -427,6 +620,12 @@ class WrappedListenV2Socket extends Socket_js_3.V2Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -438,7 +637,7 @@ class WrappedListenV2Socket extends Socket_js_3.V2Socket {
 class WrappedSpeakV1Client extends Client_js_7.V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c, _d;
             const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             if (encoding != null)
@@ -451,14 +650,20 @@ class WrappedSpeakV1Client extends Client_js_7.V1Client {
                 _queryParams.sample_rate = sampleRate;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(authRequest.headers, headers);
+            // Merge headers from options (which includes session ID), auth headers, and request headers
+            const mergedHeaders = (0, headers_js_1.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 ws_js_1.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: [],
+                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: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -510,6 +715,12 @@ class WrappedSpeakV1Socket extends Socket_js_4.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;

package/dist/cjs/api/resources/agent/resources/v1/types/AgentV1Settings.d.ts

@@ -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/cjs/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.d.ts

@@ -0,0 +1,26 @@
+import type * as Deepgram from "../../../../../index.js";
+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/cjs/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agent/resources/v1/types/AgentV1SettingsAgentSpeakEndpointProvider.d.ts

@@ -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;
     }