@deepgram/sdk 5.0.0 → 5.2.0

package/dist/esm/Client.d.mts

@@ -5,8 +5,10 @@ import { ManageClient } from "./api/resources/manage/client/Client.mjs";
 import { ReadClient } from "./api/resources/read/client/Client.mjs";
 import { SelfHostedClient } from "./api/resources/selfHosted/client/Client.mjs";
 import { SpeakClient } from "./api/resources/speak/client/Client.mjs";
+import { VoiceAgentClient } from "./api/resources/voiceAgent/client/Client.mjs";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.mjs";
+import * as core from "./core/index.mjs";
 export declare namespace DeepgramClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
@@ -21,6 +23,7 @@ export declare class DeepgramClient {
     protected _read: ReadClient | undefined;
     protected _selfHosted: SelfHostedClient | undefined;
     protected _speak: SpeakClient | undefined;
+    protected _voiceAgent: VoiceAgentClient | undefined;
     constructor(options?: DeepgramClient.Options);
     get agent(): AgentClient;
     get auth(): AuthClient;
@@ -29,4 +32,16 @@ export declare class DeepgramClient {
     get read(): ReadClient;
     get selfHosted(): SelfHostedClient;
     get speak(): SpeakClient;
+    get voiceAgent(): VoiceAgentClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
 }

package/dist/esm/Client.mjs

@@ -1,4 +1,13 @@
 // This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { AgentClient } from "./api/resources/agent/client/Client.mjs";
 import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { ListenClient } from "./api/resources/listen/client/Client.mjs";
@@ -6,7 +15,10 @@ import { ManageClient } from "./api/resources/manage/client/Client.mjs";
 import { ReadClient } from "./api/resources/read/client/Client.mjs";
 import { SelfHostedClient } from "./api/resources/selfHosted/client/Client.mjs";
 import { SpeakClient } from "./api/resources/speak/client/Client.mjs";
+import { VoiceAgentClient } from "./api/resources/voiceAgent/client/Client.mjs";
 import { normalizeClientOptionsWithAuth } from "./BaseClient.mjs";
+import * as core from "./core/index.mjs";
+import * as environments from "./environments.mjs";
 export class DeepgramClient {
     constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
@@ -39,4 +51,38 @@ export class DeepgramClient {
         var _a;
         return ((_a = this._speak) !== null && _a !== void 0 ? _a : (this._speak = new SpeakClient(this._options)));
     }
+    get voiceAgent() {
+        var _a;
+        return ((_a = this._voiceAgent) !== null && _a !== void 0 ? _a : (this._voiceAgent = new VoiceAgentClient(this._options)));
+    }
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input, init, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            return core.makePassthroughRequest(input, init, {
+                baseUrl: (_a = this._options.baseUrl) !== null && _a !== void 0 ? _a : (() => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    const env = yield core.Supplier.get(this._options.environment);
+                    return typeof env === "string"
+                        ? env
+                        : ((_a = env === null || env === void 0 ? void 0 : env.base) !== null && _a !== void 0 ? _a : environments.DeepgramEnvironment.Production.base);
+                })),
+                headers: this._options.headers,
+                timeoutInSeconds: this._options.timeoutInSeconds,
+                maxRetries: this._options.maxRetries,
+                fetch: this._options.fetch,
+                logging: this._options.logging,
+                getAuthHeaders: () => __awaiter(this, void 0, void 0, function* () { return (yield this._options.authProvider.getAuthRequest()).headers; }),
+            }, requestOptions);
+        });
+    }
 }

package/dist/esm/CustomClient.mjs

@@ -114,7 +114,9 @@ class ApiKeyAuthProviderWrapper {
             // If the header doesn't already have a scheme prefix, add "Token " prefix for API keys
             if (authHeader && typeof authHeader === "string") {
                 // Only add prefix if it doesn't already have Bearer or Token prefix
-                if (!authHeader.startsWith("Bearer ") && !authHeader.startsWith("Token ") && !authHeader.startsWith("token ")) {
+                if (!authHeader.startsWith("Bearer ") &&
+                    !authHeader.startsWith("Token ") &&
+                    !authHeader.startsWith("token ")) {
                     return {
                         headers: Object.assign(Object.assign({}, authRequest.headers), { Authorization: `Token ${authHeader}` }),
                     };
@@ -472,7 +474,7 @@ class WrappedAgentV1Client extends AgentV1Client {
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/agent/converse",
-                environmentKey: 'agent',
+                environmentKey: "agent",
                 queryParams: buildQueryParams(args),
                 headers,
                 debug,
@@ -525,7 +527,7 @@ class WrappedAgentV1Socket extends AgentV1Socket {
             handleOpen: socketAny.handleOpen,
             handleMessage: socketAny.handleMessage,
             handleClose: socketAny.handleClose,
-            handleError: socketAny.handleError
+            handleError: socketAny.handleError,
         });
         resetSocketConnectionState(this.socket);
         super.connect();
@@ -549,7 +551,7 @@ class WrappedListenV1Client extends ListenV1Client {
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/listen",
-                environmentKey: 'production',
+                environmentKey: "production",
                 queryParams: buildQueryParams(args),
                 headers,
                 debug,
@@ -602,7 +604,7 @@ class WrappedListenV1Socket extends ListenV1Socket {
             handleOpen: socketAny.handleOpen,
             handleMessage: socketAny.handleMessage,
             handleClose: socketAny.handleClose,
-            handleError: socketAny.handleError
+            handleError: socketAny.handleError,
         });
         resetSocketConnectionState(this.socket);
         super.connect();
@@ -625,7 +627,7 @@ class WrappedListenV2Client extends ListenV2Client {
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v2/listen",
-                environmentKey: 'production',
+                environmentKey: "production",
                 queryParams: buildQueryParams(args),
                 headers,
                 debug,
@@ -679,7 +681,7 @@ class WrappedListenV2Socket extends ListenV2Socket {
             handleOpen: socketAny.handleOpen,
             handleMessage: socketAny.handleMessage,
             handleClose: socketAny.handleClose,
-            handleError: socketAny.handleError
+            handleError: socketAny.handleError,
         });
         resetSocketConnectionState(this.socket);
         super.connect();
@@ -732,7 +734,7 @@ class WrappedSpeakV1Client extends SpeakV1Client {
             const socket = yield createWebSocketConnection({
                 options: this._options,
                 urlPath: "/v1/speak",
-                environmentKey: 'production',
+                environmentKey: "production",
                 queryParams: buildQueryParams(args),
                 headers,
                 debug,
@@ -792,7 +794,7 @@ class WrappedSpeakV1Socket extends SpeakV1Socket {
             handleOpen: socketAny.handleOpen,
             handleMessage: socketAny.handleMessage,
             handleClose: socketAny.handleClose,
-            handleError: socketAny.handleError
+            handleError: socketAny.handleError,
         });
         resetSocketConnectionState(this.socket);
         super.connect();

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

@@ -6,6 +6,8 @@ export declare namespace V1Client {
     type Options = BaseClientOptions;
     interface ConnectArgs {
         Authorization: string;
+        /** WebSocket subprotocols to use for the connection. */
+        protocols?: string | string[];
         /** Additional query parameters to send with the websocket connect request. */
         queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */

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

@@ -24,12 +24,12 @@ export class V1Client {
     }
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const { queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
-            const _headers = mergeHeaders(mergeOnlyDefinedHeaders({ Authorization: args.Authorization }), headers);
+            var _a, _b, _c;
+            const { protocols, queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal } = args;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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: [],
+                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).agent, "/v1/agent/converse"),
+                protocols: protocols !== null && protocols !== void 0 ? protocols : [],
                 queryParameters: queryParams !== null && queryParams !== void 0 ? queryParams : {},
                 headers: _headers,
                 options: {

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.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 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 | Deepgram.agent.AgentV1History | string;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -21,7 +21,7 @@ export declare class V1Socket {
     private handleError;
     constructor(args: V1Socket.Args);
     /** The current state of the connection; this is one of the readyState constants. */
-    get readyState(): number;
+    get readyState(): core.ReconnectingWebSocket.ReadyState;
     /**
      * @param event - The event to attach to.
      * @param callback - The callback to run when the event is triggered.
@@ -35,13 +35,13 @@ 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;
     sendKeepAlive(message: Deepgram.agent.AgentV1KeepAlive): void;
     sendUpdatePrompt(message: Deepgram.agent.AgentV1UpdatePrompt): void;
-    sendMedia(message: ArrayBufferLike | Blob | ArrayBufferView): void;
+    sendUpdateThink(message: Deepgram.agent.AgentV1UpdateThink): void;
+    sendMedia(message: ArrayBuffer | Blob | ArrayBufferView): void;
     /** Connect to the websocket and register event handlers. */
     connect(): V1Socket;
     /** Close the websocket and unregister event handlers. */
@@ -51,7 +51,7 @@ export declare class V1Socket {
     /** Asserts that the websocket is open. */
     private assertSocketIsOpen;
     /** Send a binary payload to the websocket. */
-    protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
+    protected sendBinary(payload: ArrayBuffer | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    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;
+    protected sendJson(payload: Deepgram.agent.AgentV1Settings | Deepgram.agent.AgentV1UpdateSpeak | Deepgram.agent.AgentV1InjectUserMessage | Deepgram.agent.AgentV1InjectAgentMessage | Deepgram.agent.AgentV1SendFunctionCallResponse | Deepgram.agent.AgentV1KeepAlive | Deepgram.agent.AgentV1UpdatePrompt | Deepgram.agent.AgentV1UpdateThink | string): void;
 }

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

@@ -62,10 +62,6 @@ export class V1Socket {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
-    sendUpdateThink(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
     sendInjectUserMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
@@ -86,6 +82,10 @@ export class V1Socket {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
+    sendUpdateThink(message) {
+        this.assertSocketIsOpen();
+        this.sendJson(message);
+    }
     sendMedia(message) {
         this.assertSocketIsOpen();
         this.sendBinary(message);
@@ -111,7 +111,7 @@ export class V1Socket {
     /** Returns a promise that resolves when the websocket is open. */
     waitForOpen() {
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.socket.readyState === core.ReconnectingWebSocket.OPEN) {
+            if (this.socket.readyState === core.ReconnectingWebSocket.ReadyState.OPEN) {
                 return this.socket;
             }
             return new Promise((resolve, reject) => {
@@ -129,7 +129,7 @@ export class V1Socket {
         if (!this.socket) {
             throw new Error("Socket is not connected.");
         }
-        if (this.socket.readyState !== core.ReconnectingWebSocket.OPEN) {
+        if (this.socket.readyState !== core.ReconnectingWebSocket.ReadyState.OPEN) {
             throw new Error("Socket is not open.");
         }
     }

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

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

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

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

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

@@ -40,7 +40,7 @@ export class ModelsClient {
                 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).base, "v1/agent/settings/think/models"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

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

@@ -5,6 +5,10 @@ export interface AgentV1ConversationText {
     role: AgentV1ConversationText.Role;
     /** The actual statement that was spoken */
     content: string;
+    /** The language hints that were active at the time of the turn. Only present on user-role messages when the listen model is flux-general-multi. */
+    languages_hinted?: string[] | undefined;
+    /** Languages detected in the user's speech, sorted by word count (descending). Only present on user-role messages when the listen model is flux-general-multi. */
+    languages?: string[] | undefined;
 }
 export declare namespace AgentV1ConversationText {
     /** Identifies who spoke the statement */

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

@@ -16,6 +16,8 @@ export declare namespace AgentV1FunctionCallRequest {
             arguments: string;
             /** Whether the function should be executed client-side */
             client_side: boolean;
+            /** Some Gemini models require this as an additional function call identifier */
+            thought_signature?: string | undefined;
         }
     }
 }

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

@@ -0,0 +1,24 @@
+/**
+ * A history message is either a conversational message or a function call
+ */
+export type AgentV1History = 
+/**
+ * Conversation text as part of the conversation history */
+{
+    type: "History";
+    role: "user" | "assistant" | string;
+    content: string;
+}
+/**
+ * Client-side or server-side function call request and response as part of the conversation history */
+ | {
+    type: "History";
+    function_calls: {
+        id: string;
+        name: string;
+        client_side: boolean;
+        arguments: string;
+        response: string;
+        thought_signature?: string | undefined;
+    }[];
+};

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

@@ -3,4 +3,24 @@ export interface AgentV1InjectAgentMessage {
     type: "InjectAgentMessage";
     /** The statement that the agent should say */
     message: string;
+    /**
+     * Controls how the injection interacts with any in-progress user or agent turn.
+     *
+     * * `default` — The agent speaks only if neither the user nor the agent is mid-turn. If a turn is in progress, the server replies with `InjectionRefused`.
+     * * `queue` — The message is appended after any already-queued `ConversationText` without interrupting the current agent turn or think response. If nothing is queued, the message plays immediately.
+     */
+    behavior?: AgentV1InjectAgentMessage.Behavior | undefined;
+}
+export declare namespace AgentV1InjectAgentMessage {
+    /**
+     * Controls how the injection interacts with any in-progress user or agent turn.
+     *
+     * * `default` — The agent speaks only if neither the user nor the agent is mid-turn. If a turn is in progress, the server replies with `InjectionRefused`.
+     * * `queue` — The message is appended after any already-queued `ConversationText` without interrupting the current agent turn or think response. If nothing is queued, the message plays immediately.
+     */
+    const Behavior: {
+        readonly Default: "default";
+        readonly Queue: "queue";
+    };
+    type Behavior = (typeof Behavior)[keyof typeof Behavior] | string;
 }

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

@@ -1,2 +1,14 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var AgentV1InjectAgentMessage;
+(function (AgentV1InjectAgentMessage) {
+    /**
+     * Controls how the injection interacts with any in-progress user or agent turn.
+     *
+     * * `default` — The agent speaks only if neither the user nor the agent is mid-turn. If a turn is in progress, the server replies with `InjectionRefused`.
+     * * `queue` — The message is appended after any already-queued `ConversationText` without interrupting the current agent turn or think response. If nothing is queued, the message plays immediately.
+     */
+    AgentV1InjectAgentMessage.Behavior = {
+        Default: "default",
+        Queue: "queue",
+    };
+})(AgentV1InjectAgentMessage || (AgentV1InjectAgentMessage = {}));

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

@@ -59,8 +59,8 @@ export declare namespace AgentV1Settings {
             sample_rate?: number | undefined;
             /** Audio bitrate in bits per second */
             bitrate?: number | undefined;
-            /** Audio container format. If omitted, defaults to 'none' */
-            container?: string | undefined;
+            /** Audio container format. */
+            container?: Output.Container | undefined;
         }
         namespace Output {
             /** Audio encoding format for streaming TTS output */
@@ -68,8 +68,19 @@ export declare namespace AgentV1Settings {
                 readonly Linear16: "linear16";
                 readonly Mulaw: "mulaw";
                 readonly Alaw: "alaw";
+                readonly Mp3: "mp3";
+                readonly Opus: "opus";
+                readonly Flac: "flac";
+                readonly Aac: "aac";
             };
             type Encoding = (typeof Encoding)[keyof typeof Encoding] | string;
+            /** Audio container format. */
+            const Container: {
+                readonly None: "none";
+                readonly Wav: "wav";
+                readonly Ogg: "ogg";
+            };
+            type Container = (typeof Container)[keyof typeof Container] | string;
         }
     }
     interface Agent {
@@ -95,7 +106,7 @@ export declare namespace AgentV1Settings {
             type Messages = Messages.Item[];
             namespace Messages {
                 /**
-                 * A message here is either a conversational message or a function call
+                 * A history message is either a conversational message or a function call
                  */
                 type Item = 
                 /**
@@ -115,14 +126,23 @@ export declare namespace AgentV1Settings {
                         client_side: boolean;
                         arguments: string;
                         response: string;
+                        thought_signature?: string | undefined;
                     }[];
                 };
             }
         }
         interface Listen {
-            provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider | undefined;
+            provider?: Deepgram.agent.AgentV1SettingsAgentContextListenProvider | undefined;
         }
         type Think = Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[];
         type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
     }
+    /**
+     * Opt-in alias for the agent-by-ID-string variant added by the 2026-05-06
+     * regen. The canonical `Agent` type is restored to the object-only
+     * interface for back-compat; use `AgentReference` if your code needs to
+     * accept either an `Agent` settings object or a string agent ID at the
+     * type level (e.g. when targeting the agent-builder ID flow).
+     */
+    type AgentReference = AgentV1Settings.Agent | string;
 }

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

@@ -27,6 +27,16 @@ export var AgentV1Settings;
                 Linear16: "linear16",
                 Mulaw: "mulaw",
                 Alaw: "alaw",
+                Mp3: "mp3",
+                Opus: "opus",
+                Flac: "flac",
+                Aac: "aac",
+            };
+            /** Audio container format. */
+            Output.Container = {
+                None: "none",
+                Wav: "wav",
+                Ogg: "ogg",
             };
         })(Output = Audio.Output || (Audio.Output = {}));
     })(Audio = AgentV1Settings.Audio || (AgentV1Settings.Audio = {}));

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

@@ -0,0 +1,34 @@
+import type * as Deepgram from "../../../../../index.mjs";
+export type AgentV1SettingsAgentContextListenProvider = Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V1 | Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V2;
+export declare namespace AgentV1SettingsAgentContextListenProvider {
+    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 | 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 | undefined;
+        /** Prompt keyterm recognition to improve Keyword Recall Rate */
+        keyterms?: string[] | undefined;
+        /** Applies smart formatting to improve transcript readability */
+        smart_format?: boolean | undefined;
+    }
+    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, flux-general-multi) */
+        model: string;
+        /** One or more BCP-47 language codes to bias the model toward specific languages. Only supported when model is flux-general-multi. Without hints, the model auto-detects the spoken language. See the Language Prompting guide for details. */
+        language_hint?: AgentV1SettingsAgentContextListenProviderV2.LanguageHint | undefined;
+        /** Prompt keyterm recognition to improve Keyword Recall Rate */
+        keyterms?: string[] | undefined;
+    }
+    namespace AgentV1SettingsAgentContextListenProviderV2 {
+        /**
+         * One or more BCP-47 language codes to bias the model toward specific languages. Only supported when model is flux-general-multi. Without hints, the model auto-detects the spoken language. See the Language Prompting guide for details.
+         */
+        type LanguageHint = string | string[];
+    }
+}

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

@@ -1,26 +1,6 @@
 import type * as Deepgram from "../../../../../index.mjs";
-export type AgentV1SettingsAgentListenProvider = Deepgram.agent.AgentV1SettingsAgentListenProvider.V1 | Deepgram.agent.AgentV1SettingsAgentListenProvider.V2;
+export type AgentV1SettingsAgentListenProvider = Deepgram.agent.AgentV1SettingsAgentContextListenProvider;
 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 | 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 | undefined;
-        /** Prompt keyterm recognition to improve Keyword Recall Rate */
-        keyterms?: string[] | undefined;
-        /** Applies smart formatting to improve transcript readability */
-        smart_format?: boolean | undefined;
-    }
-    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[] | undefined;
-    }
+    type V1 = Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V1;
+    type V2 = Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V2;
 }

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

@@ -1,2 +1,8 @@
-// This file was auto-generated by Fern from our API Definition.
+// Backward-compat alias for the type renamed by the 2026-05-06 regen to
+// `AgentV1SettingsAgentContextListenProvider`. The new V2 only adds an optional
+// `language_hint` field, so this alias is purely additive: every literal that
+// satisfied the old V2 still satisfies the new V2, and pinned-name callers
+// (`const p: AgentV1SettingsAgentListenProvider = ...`) keep compiling without
+// a cast. See AGENTS.md for the patch rationale; regression coverage in
+// tests/unit/compat-aliases.test.ts.
 export {};

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

@@ -4,6 +4,7 @@ export * from "./AgentV1AgentThinking.mjs";
 export * from "./AgentV1ConversationText.mjs";
 export * from "./AgentV1Error.mjs";
 export * from "./AgentV1FunctionCallRequest.mjs";
+export * from "./AgentV1History.mjs";
 export * from "./AgentV1InjectAgentMessage.mjs";
 export * from "./AgentV1InjectionRefused.mjs";
 export * from "./AgentV1InjectUserMessage.mjs";
@@ -12,6 +13,7 @@ export * from "./AgentV1PromptUpdated.mjs";
 export * from "./AgentV1ReceiveFunctionCallResponse.mjs";
 export * from "./AgentV1SendFunctionCallResponse.mjs";
 export * from "./AgentV1Settings.mjs";
+export * from "./AgentV1SettingsAgentContextListenProvider.mjs";
 export * from "./AgentV1SettingsAgentListenProvider.mjs";
 export * from "./AgentV1SettingsApplied.mjs";
 export * from "./AgentV1SpeakUpdated.mjs";

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

@@ -4,6 +4,7 @@ export * from "./AgentV1AgentThinking.mjs";
 export * from "./AgentV1ConversationText.mjs";
 export * from "./AgentV1Error.mjs";
 export * from "./AgentV1FunctionCallRequest.mjs";
+export * from "./AgentV1History.mjs";
 export * from "./AgentV1InjectAgentMessage.mjs";
 export * from "./AgentV1InjectionRefused.mjs";
 export * from "./AgentV1InjectUserMessage.mjs";
@@ -12,6 +13,7 @@ export * from "./AgentV1PromptUpdated.mjs";
 export * from "./AgentV1ReceiveFunctionCallResponse.mjs";
 export * from "./AgentV1SendFunctionCallResponse.mjs";
 export * from "./AgentV1Settings.mjs";
+export * from "./AgentV1SettingsAgentContextListenProvider.mjs";
 export * from "./AgentV1SettingsAgentListenProvider.mjs";
 export * from "./AgentV1SettingsApplied.mjs";
 export * from "./AgentV1SpeakUpdated.mjs";

package/dist/esm/api/resources/auth/resources/v1/resources/tokens/client/Client.mjs

@@ -43,7 +43,7 @@ export class TokensClient {
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: request,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,

package/dist/esm/api/resources/index.d.mts

@@ -5,3 +5,4 @@ export * as manage from "./manage/index.mjs";
 export * as read from "./read/index.mjs";
 export * as selfHosted from "./selfHosted/index.mjs";
 export * as speak from "./speak/index.mjs";
+export * as voiceAgent from "./voiceAgent/index.mjs";

package/dist/esm/api/resources/index.mjs

@@ -5,3 +5,4 @@ export * as manage from "./manage/index.mjs";
 export * as read from "./read/index.mjs";
 export * as selfHosted from "./selfHosted/index.mjs";
 export * as speak from "./speak/index.mjs";
+export * as voiceAgent from "./voiceAgent/index.mjs";