@deepgram/sdk 5.0.0-beta.3 → 5.0.0

package/dist/esm/CustomClient.mjs

@@ -27,17 +27,51 @@ import * as environments from "./environments.mjs";
 import { RUNTIME } from "./core/runtime/index.mjs";
 // Default WebSocket connection timeout in milliseconds
 const DEFAULT_CONNECTION_TIMEOUT_MS = 10000;
-// Import ws library for Node.js (will be undefined in browser)
+// Keys present in every ConnectArgs interface that control the WebSocket connection itself.
+// Every other key in ConnectArgs is treated as an API query parameter.
+const WEBSOCKET_OPTION_KEYS = new Set([
+    "Authorization",
+    "headers",
+    "debug",
+    "reconnectAttempts",
+    "connectionTimeoutInSeconds",
+    "abortSignal",
+    "queryParams",
+]);
+// ws for Node.js - loaded lazily to support CJS, ESM, and browser builds.
+// A static import of "module" (for createRequire) would break the browser bundle,
+// so we detect the environment at runtime and use an opaque dynamic import in ESM
+// Node so bundlers cannot statically analyse and reject it.
 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;
+let _wsInitialized = false;
+function loadNodeWebSocket() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (_wsInitialized)
+            return;
+        _wsInitialized = true;
+        try {
+            if (typeof require !== "undefined") {
+                // CJS: require is injected as a module-scoped binding
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                let ws = require("ws");
+                NodeWebSocket = ws.WebSocket || ws.default || ws;
+            }
+            else if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
+                // ESM Node: require is not defined. Wrap import() in new Function so
+                // bundlers (esbuild, webpack) cannot statically resolve or reject "ws".
+                // eslint-disable-next-line no-new-func
+                const dynamicImport = new Function("specifier", "return import(specifier)");
+                const ws = yield dynamicImport("ws");
+                NodeWebSocket = ws.WebSocket || ws.default || ws;
+            }
+            // Browser: process.versions?.node is undefined → NodeWebSocket stays undefined
+        }
+        catch (_b) {
+            // ws not available or failed to load
+            NodeWebSocket = undefined;
+        }
+    });
 }
 // Helper function to generate UUID that works in both Node.js and browser
 function generateUUID() {
@@ -237,6 +271,24 @@ function resolveHeaders(headers) {
         return resolved;
     });
 }
+/**
+ * Builds API query parameters from a ConnectArgs object, excluding all WebSocket
+ * infrastructure keys. This means any new typed parameter added to ConnectArgs by
+ * the generator is automatically included without needing manual updates here.
+ * An explicit `queryParams` override is merged in last.
+ */
+function buildQueryParams(args) {
+    const result = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (!WEBSOCKET_OPTION_KEYS.has(key) && value != null) {
+            result[key] = value;
+        }
+    }
+    if (args.queryParams != null && typeof args.queryParams === "object") {
+        Object.assign(result, args.queryParams);
+    }
+    return result;
+}
 /**
  * Helper function to get WebSocket class and handle headers/protocols based on runtime.
  * In Node.js, use the 'ws' library which supports headers.
@@ -374,8 +426,10 @@ function resetSocketConnectionState(socket) {
  * This reduces duplication across all Wrapped*Client classes.
  */
 function createWebSocketConnection(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ options, urlPath, environmentKey, queryParams, headers, debug, reconnectAttempts, }) {
+    return __awaiter(this, arguments, void 0, function* ({ options, urlPath, environmentKey, queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal, }) {
         var _b, _c, _d, _e, _f, _g;
+        // Ensure ws is loaded for Node.js environments (no-op after first call)
+        yield loadNodeWebSocket();
         // Get Authorization from authProvider (cast to any to access internal property)
         const authRequest = yield ((_b = options.authProvider) === null || _b === void 0 ? void 0 : _b.getAuthRequest());
         // Merge headers from options (which includes session ID), auth headers, and request headers
@@ -397,8 +451,9 @@ function createWebSocketConnection(_a) {
                 debug: debug !== null && debug !== void 0 ? debug : false,
                 maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                 startClosed: true,
-                connectionTimeout: DEFAULT_CONNECTION_TIMEOUT_MS,
+                connectionTimeout: connectionTimeoutInSeconds != null ? connectionTimeoutInSeconds * 1000 : DEFAULT_CONNECTION_TIMEOUT_MS,
             },
+            abortSignal,
         });
     });
 }
@@ -413,16 +468,17 @@ function createWebSocketConnection(_a) {
 class WrappedAgentV1Client extends AgentV1Client {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            const { headers, debug, reconnectAttempts } = args;
-            // Use shared connection helper
+            const { headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/agent/converse",
                 environmentKey: 'agent',
-                queryParams: {},
+                queryParams: buildQueryParams(args),
                 headers,
                 debug,
                 reconnectAttempts,
+                connectionTimeoutInSeconds,
+                abortSignal,
             });
             return new WrappedAgentV1Socket({ socket });
         });
@@ -489,72 +545,17 @@ class WrappedAgentV1Socket extends AgentV1Socket {
 class WrappedListenV1Client extends ListenV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            // 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)
-            const _queryParams = {};
-            if (callback != null)
-                _queryParams.callback = callback;
-            if (callbackMethod != null)
-                _queryParams.callback_method = callbackMethod;
-            if (channels != null)
-                _queryParams.channels = channels;
-            if (diarize != null)
-                _queryParams.diarize = diarize;
-            if (dictation != null)
-                _queryParams.dictation = dictation;
-            if (encoding != null)
-                _queryParams.encoding = encoding;
-            if (endpointing != null)
-                _queryParams.endpointing = endpointing;
-            if (extra != null)
-                _queryParams.extra = extra;
-            if (interimResults != null)
-                _queryParams.interim_results = interimResults;
-            if (keyterm != null)
-                _queryParams.keyterm = keyterm;
-            if (keywords != null)
-                _queryParams.keywords = keywords;
-            if (language != null)
-                _queryParams.language = language;
-            if (mipOptOut != null)
-                _queryParams.mip_opt_out = mipOptOut;
-            _queryParams.model = model;
-            if (multichannel != null)
-                _queryParams.multichannel = multichannel;
-            if (numerals != null)
-                _queryParams.numerals = numerals;
-            if (profanityFilter != null)
-                _queryParams.profanity_filter = profanityFilter;
-            if (punctuate != null)
-                _queryParams.punctuate = punctuate;
-            if (redact != null)
-                _queryParams.redact = redact;
-            if (replace != null)
-                _queryParams.replace = replace;
-            if (sampleRate != null)
-                _queryParams.sample_rate = sampleRate;
-            if (search != null)
-                _queryParams.search = search;
-            if (smartFormat != null)
-                _queryParams.smart_format = smartFormat;
-            if (tag != null)
-                _queryParams.tag = tag;
-            if (utteranceEndMs != null)
-                _queryParams.utterance_end_ms = utteranceEndMs;
-            if (vadEvents != null)
-                _queryParams.vad_events = vadEvents;
-            if (version != null)
-                _queryParams.version = version;
-            // Use shared connection helper
+            const { headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/listen",
                 environmentKey: 'production',
-                queryParams: _queryParams,
+                queryParams: buildQueryParams(args),
                 headers,
                 debug,
                 reconnectAttempts,
+                connectionTimeoutInSeconds,
+                abortSignal,
             });
             return new WrappedListenV1Socket({ socket });
         });
@@ -620,34 +621,17 @@ class WrappedListenV1Socket extends ListenV1Socket {
 class WrappedListenV2Client extends ListenV2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            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;
-            if (encoding != null)
-                _queryParams.encoding = encoding;
-            if (sampleRate != null)
-                _queryParams.sample_rate = sampleRate;
-            if (eagerEotThreshold != null)
-                _queryParams.eager_eot_threshold = eagerEotThreshold;
-            if (eotThreshold != null)
-                _queryParams.eot_threshold = eotThreshold;
-            if (eotTimeoutMs != null)
-                _queryParams.eot_timeout_ms = eotTimeoutMs;
-            if (keyterm != null)
-                _queryParams.keyterm = keyterm;
-            if (mipOptOut != null)
-                _queryParams.mip_opt_out = mipOptOut;
-            if (tag != null)
-                _queryParams.tag = tag;
-            // Use shared connection helper
+            const { headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v2/listen",
                 environmentKey: 'production',
-                queryParams: _queryParams,
+                queryParams: buildQueryParams(args),
                 headers,
                 debug,
                 reconnectAttempts,
+                connectionTimeoutInSeconds,
+                abortSignal,
             });
             return new WrappedListenV2Socket({ socket });
         });
@@ -744,25 +728,17 @@ class WrappedListenV2Socket extends ListenV2Socket {
 class WrappedSpeakV1Client extends SpeakV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
-            const _queryParams = {};
-            if (encoding != null)
-                _queryParams.encoding = encoding;
-            if (mipOptOut != null)
-                _queryParams.mip_opt_out = mipOptOut;
-            if (model != null)
-                _queryParams.model = model;
-            if (sampleRate != null)
-                _queryParams.sample_rate = sampleRate;
-            // Use shared connection helper
+            const { headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/speak",
                 environmentKey: 'production',
-                queryParams: _queryParams,
+                queryParams: buildQueryParams(args),
                 headers,
                 debug,
                 reconnectAttempts,
+                connectionTimeoutInSeconds,
+                abortSignal,
             });
             return new WrappedSpeakV1Socket({ socket });
         });
@@ -797,6 +773,13 @@ class WrappedSpeakV1Client extends SpeakV1Client {
 class WrappedSpeakV1Socket extends SpeakV1Socket {
     constructor(args) {
         super(args);
+        // CRITICAL: Remove the autogenerated handleMessage that tries to parse EVERYTHING as JSON!
+        // The autogenerated Socket class assumes all messages are text/JSON, but TTS sends binary audio.
+        // We must remove that broken handler immediately after the parent constructor runs.
+        const socketAny = this;
+        if (socketAny.handleMessage) {
+            this.socket.removeEventListener("message", socketAny.handleMessage);
+        }
         this.setupBinaryHandling();
     }
     setupBinaryHandling() {

package/dist/esm/api/resources/agent/exports.d.mts

@@ -0,0 +1,3 @@
+export { AgentClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/exports.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AgentClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/client/Client.d.mts

@@ -6,12 +6,18 @@ export declare namespace V1Client {
     type Options = BaseClientOptions;
     interface ConnectArgs {
         Authorization: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */
         debug?: boolean;
         /** Number of reconnect attempts. Defaults to 30. */
         reconnectAttempts?: number;
+        /** The timeout for establishing the WebSocket connection in seconds. */
+        connectionTimeoutInSeconds?: number;
+        /** A signal to abort the WebSocket connection. */
+        abortSignal?: AbortSignal;
     }
 }
 export declare class V1Client {

package/dist/esm/api/resources/agent/resources/v1/client/Client.mjs

@@ -25,14 +25,19 @@ export class V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            const { headers, debug, reconnectAttempts } = args;
+            const { queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
             const _headers = mergeHeaders(mergeOnlyDefinedHeaders({ Authorization: args.Authorization }), headers);
             const socket = new core.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).agent, "/v1/agent/converse"),
                 protocols: [],
-                queryParameters: {},
+                queryParameters: queryParams !== null && queryParams !== void 0 ? queryParams : {},
                 headers: _headers,
-                options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
+                options: {
+                    debug: debug !== null && debug !== void 0 ? debug : false,
+                    maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
+                    connectionTimeout: connectionTimeoutInSeconds != null ? connectionTimeoutInSeconds * 1000 : undefined,
+                },
+                abortSignal: abortSignal,
             });
             return new V1Socket({ socket });
         });

package/dist/esm/api/resources/agent/resources/v1/client/Socket.d.mts

@@ -4,7 +4,7 @@ export declare namespace V1Socket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Deepgram.agent.AgentV1ReceiveFunctionCallResponse | Deepgram.agent.AgentV1PromptUpdated | Deepgram.agent.AgentV1SpeakUpdated | Deepgram.agent.AgentV1InjectionRefused | Deepgram.agent.AgentV1Welcome | Deepgram.agent.AgentV1SettingsApplied | Deepgram.agent.AgentV1ConversationText | Deepgram.agent.AgentV1UserStartedSpeaking | Deepgram.agent.AgentV1AgentThinking | Deepgram.agent.AgentV1FunctionCallRequest | Deepgram.agent.AgentV1AgentStartedSpeaking | Deepgram.agent.AgentV1AgentAudioDone | Deepgram.agent.AgentV1Error | Deepgram.agent.AgentV1Warning | string;
+    type Response = Deepgram.agent.AgentV1ReceiveFunctionCallResponse | Deepgram.agent.AgentV1PromptUpdated | Deepgram.agent.AgentV1SpeakUpdated | Deepgram.agent.AgentV1ThinkUpdated | Deepgram.agent.AgentV1InjectionRefused | Deepgram.agent.AgentV1Welcome | Deepgram.agent.AgentV1SettingsApplied | Deepgram.agent.AgentV1ConversationText | Deepgram.agent.AgentV1UserStartedSpeaking | Deepgram.agent.AgentV1AgentThinking | Deepgram.agent.AgentV1FunctionCallRequest | Deepgram.agent.AgentV1AgentStartedSpeaking | Deepgram.agent.AgentV1AgentAudioDone | Deepgram.agent.AgentV1Error | Deepgram.agent.AgentV1Warning | string;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -35,6 +35,7 @@ export declare class V1Socket {
     on<T extends keyof V1Socket.EventHandlers>(event: T, callback: V1Socket.EventHandlers[T]): void;
     sendSettings(message: Deepgram.agent.AgentV1Settings): void;
     sendUpdateSpeak(message: Deepgram.agent.AgentV1UpdateSpeak): void;
+    sendUpdateThink(message: Deepgram.agent.AgentV1UpdateThink): void;
     sendInjectUserMessage(message: Deepgram.agent.AgentV1InjectUserMessage): void;
     sendInjectAgentMessage(message: Deepgram.agent.AgentV1InjectAgentMessage): void;
     sendFunctionCallResponse(message: Deepgram.agent.AgentV1SendFunctionCallResponse): void;
@@ -52,5 +53,5 @@ export declare class V1Socket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Deepgram.agent.AgentV1Settings | Deepgram.agent.AgentV1UpdateSpeak | Deepgram.agent.AgentV1InjectUserMessage | Deepgram.agent.AgentV1InjectAgentMessage | Deepgram.agent.AgentV1SendFunctionCallResponse | Deepgram.agent.AgentV1KeepAlive | Deepgram.agent.AgentV1UpdatePrompt | string): void;
+    protected sendJson(payload: Deepgram.agent.AgentV1Settings | Deepgram.agent.AgentV1UpdateSpeak | Deepgram.agent.AgentV1UpdateThink | Deepgram.agent.AgentV1InjectUserMessage | Deepgram.agent.AgentV1InjectAgentMessage | Deepgram.agent.AgentV1SendFunctionCallResponse | Deepgram.agent.AgentV1KeepAlive | Deepgram.agent.AgentV1UpdatePrompt | string): void;
 }

package/dist/esm/api/resources/agent/resources/v1/client/Socket.mjs

@@ -62,6 +62,10 @@ export class V1Socket {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
+    sendUpdateThink(message) {
+        this.assertSocketIsOpen();
+        this.sendJson(message);
+    }
     sendInjectUserMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);

package/dist/esm/api/resources/agent/resources/v1/exports.d.mts

@@ -0,0 +1,3 @@
+export { V1Client } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/exports.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { V1Client } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/exports.d.mts

@@ -0,0 +1,3 @@
+export { SettingsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/exports.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { SettingsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/resources/think/exports.d.mts

@@ -0,0 +1,3 @@
+export { ThinkClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/resources/think/exports.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { ThinkClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/resources/think/resources/models/exports.d.mts

@@ -0,0 +1,2 @@
+export { ModelsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/agent/resources/v1/resources/settings/resources/think/resources/models/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { ModelsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

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

@@ -20,7 +20,7 @@ export interface AgentV1ReceiveFunctionCallResponse {
      * • **Optional for server responses**: Server may omit when responding
      *   to internal function executions
      */
-    id?: string;
+    id?: string | undefined;
     /** The name of the function being called */
     name: string;
     /** The content or result of the function call */

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

@@ -20,7 +20,7 @@ export interface AgentV1SendFunctionCallResponse {
      * • **Optional for server responses**: Server may omit when responding
      *   to internal function executions
      */
-    id?: string;
+    id?: string | undefined;
     /** The name of the function being called */
     name: string;
     /** The content or result of the function call */

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

@@ -2,25 +2,25 @@ import type * as Deepgram from "../../../../../index.mjs";
 export interface AgentV1Settings {
     type: "Settings";
     /** Tags to associate with the request */
-    tags?: string[];
+    tags?: string[] | undefined;
     /** To enable experimental features */
-    experimental?: boolean;
-    flags?: AgentV1Settings.Flags;
+    experimental?: boolean | undefined;
+    flags?: AgentV1Settings.Flags | undefined;
     /** To opt out of Deepgram Model Improvement Program */
-    mip_opt_out?: boolean;
+    mip_opt_out?: boolean | undefined;
     audio: AgentV1Settings.Audio;
     agent: AgentV1Settings.Agent;
 }
 export declare namespace AgentV1Settings {
     interface Flags {
         /** Enable or disable history message reporting */
-        history?: boolean;
+        history?: boolean | undefined;
     }
     interface Audio {
         /** Audio input configuration settings. If omitted, defaults to encoding=linear16 and sample_rate=24000. Higher sample rates like 44100 Hz provide better audio quality. */
-        input?: Audio.Input;
+        input?: Audio.Input | undefined;
         /** Audio output configuration settings */
-        output?: Audio.Output;
+        output?: Audio.Output | undefined;
     }
     namespace Audio {
         /**
@@ -54,13 +54,13 @@ export declare namespace AgentV1Settings {
          */
         interface Output {
             /** Audio encoding format for streaming TTS output */
-            encoding?: Output.Encoding;
+            encoding?: Output.Encoding | undefined;
             /** Sample rate in Hz */
-            sample_rate?: number;
+            sample_rate?: number | undefined;
             /** Audio bitrate in bits per second */
-            bitrate?: number;
+            bitrate?: number | undefined;
             /** Audio container format. If omitted, defaults to 'none' */
-            container?: string;
+            container?: string | undefined;
         }
         namespace Output {
             /** Audio encoding format for streaming TTS output */
@@ -74,14 +74,14 @@ export declare namespace AgentV1Settings {
     }
     interface Agent {
         /** Deprecated. Use `listen.provider.language` and `speak.provider.language` fields instead. */
-        language?: string;
+        language?: string | undefined;
         /** Conversation context including the history of messages and function calls */
-        context?: Agent.Context;
-        listen?: Agent.Listen;
-        think?: Agent.Think;
-        speak?: Agent.Speak;
+        context?: Agent.Context | undefined;
+        listen?: Agent.Listen | undefined;
+        think?: Agent.Think | undefined;
+        speak?: Agent.Speak | undefined;
         /** Optional message that agent will speak at the start */
-        greeting?: string;
+        greeting?: string | undefined;
     }
     namespace Agent {
         /**
@@ -89,7 +89,7 @@ export declare namespace AgentV1Settings {
          */
         interface Context {
             /** Conversation history as a list of messages and function calls */
-            messages?: Context.Messages.Item[];
+            messages?: Context.Messages.Item[] | undefined;
         }
         namespace Context {
             type Messages = Messages.Item[];
@@ -120,39 +120,9 @@ export declare namespace AgentV1Settings {
             }
         }
         interface Listen {
-            provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider;
+            provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider | undefined;
         }
-        type Think = {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-            functions?: Record<string, unknown>[] | undefined;
-            prompt?: string | undefined;
-            context_length?: ("max" | number) | undefined;
-        } | {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-            functions?: Record<string, unknown>[] | undefined;
-            prompt?: string | undefined;
-            context_length?: ("max" | number) | undefined;
-        }[];
-        type Speak = {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-        } | {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-        }[];
+        type Think = Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[];
+        type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
     }
 }

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

@@ -6,13 +6,13 @@ export declare namespace AgentV1SettingsAgentListenProvider {
         /** 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;
+        model?: string | undefined;
         /** 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;
+        language?: string | undefined;
         /** Prompt keyterm recognition to improve Keyword Recall Rate */
-        keyterms?: string[];
+        keyterms?: string[] | undefined;
         /** Applies smart formatting to improve transcript readability */
-        smart_format?: boolean;
+        smart_format?: boolean | undefined;
     }
     interface V2 {
         version: "v2";
@@ -21,6 +21,6 @@ export declare namespace AgentV1SettingsAgentListenProvider {
         /** 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[];
+        keyterms?: string[] | undefined;
     }
 }

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

@@ -0,0 +1,4 @@
+export interface AgentV1ThinkUpdated {
+    /** Message type identifier for think update confirmation */
+    type: "ThinkUpdated";
+}

package/dist/esm/api/resources/agent/resources/v1/types/AgentV1ThinkUpdated.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/AgentV1UpdateSpeak.d.mts

@@ -1,18 +1,9 @@
+import type * as Deepgram from "../../../../../index.mjs";
 export interface AgentV1UpdateSpeak {
     /** Message type identifier for updating the speak model */
     type: "UpdateSpeak";
     speak: AgentV1UpdateSpeak.Speak;
 }
 export declare namespace AgentV1UpdateSpeak {
-    interface Speak {
-        /** TTS provider configuration (Deepgram, ElevenLabs, Cartesia, OpenAI, or AWS Polly) */
-        provider: Record<string, unknown>;
-        endpoint?: Speak.Endpoint;
-    }
-    namespace Speak {
-        interface Endpoint {
-            url?: string;
-            headers?: Record<string, string>;
-        }
-    }
+    type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
 }

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

@@ -0,0 +1,9 @@
+import type * as Deepgram from "../../../../../index.mjs";
+export interface AgentV1UpdateThink {
+    /** Message type identifier for updating the think model */
+    type: "UpdateThink";
+    think: AgentV1UpdateThink.Think;
+}
+export declare namespace AgentV1UpdateThink {
+    type Think = Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[];
+}

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

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