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

package/dist/cjs/api/types/ListenV1Diarize.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1Diarize: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1Diarize = (typeof ListenV1Diarize)[keyof typeof ListenV1Diarize];
+export type ListenV1Diarize = (typeof ListenV1Diarize)[keyof typeof ListenV1Diarize] | string;

package/dist/cjs/api/types/ListenV1Dictation.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1Dictation: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1Dictation = (typeof ListenV1Dictation)[keyof typeof ListenV1Dictation];
+export type ListenV1Dictation = (typeof ListenV1Dictation)[keyof typeof ListenV1Dictation] | string;

package/dist/cjs/api/types/ListenV1Encoding.d.ts

@@ -12,4 +12,4 @@ export declare const ListenV1Encoding: {
     readonly Speex: "speex";
     readonly G729: "g729";
 };
-export type ListenV1Encoding = (typeof ListenV1Encoding)[keyof typeof ListenV1Encoding];
+export type ListenV1Encoding = (typeof ListenV1Encoding)[keyof typeof ListenV1Encoding] | string;

package/dist/cjs/api/types/ListenV1InterimResults.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1InterimResults: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1InterimResults = (typeof ListenV1InterimResults)[keyof typeof ListenV1InterimResults];
+export type ListenV1InterimResults = (typeof ListenV1InterimResults)[keyof typeof ListenV1InterimResults] | string;

package/dist/cjs/api/types/ListenV1Model.d.ts

@@ -31,4 +31,4 @@ export declare const ListenV1Model: {
     readonly Video: "video";
     readonly Custom: "custom";
 };
-export type ListenV1Model = (typeof ListenV1Model)[keyof typeof ListenV1Model];
+export type ListenV1Model = (typeof ListenV1Model)[keyof typeof ListenV1Model] | string;

package/dist/cjs/api/types/ListenV1Multichannel.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1Multichannel: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1Multichannel = (typeof ListenV1Multichannel)[keyof typeof ListenV1Multichannel];
+export type ListenV1Multichannel = (typeof ListenV1Multichannel)[keyof typeof ListenV1Multichannel] | string;

package/dist/cjs/api/types/ListenV1Numerals.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1Numerals: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1Numerals = (typeof ListenV1Numerals)[keyof typeof ListenV1Numerals];
+export type ListenV1Numerals = (typeof ListenV1Numerals)[keyof typeof ListenV1Numerals] | string;

package/dist/cjs/api/types/ListenV1ProfanityFilter.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1ProfanityFilter: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1ProfanityFilter = (typeof ListenV1ProfanityFilter)[keyof typeof ListenV1ProfanityFilter];
+export type ListenV1ProfanityFilter = (typeof ListenV1ProfanityFilter)[keyof typeof ListenV1ProfanityFilter] | string;

package/dist/cjs/api/types/ListenV1Punctuate.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1Punctuate: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1Punctuate = (typeof ListenV1Punctuate)[keyof typeof ListenV1Punctuate];
+export type ListenV1Punctuate = (typeof ListenV1Punctuate)[keyof typeof ListenV1Punctuate] | string;

package/dist/cjs/api/types/ListenV1Redact.d.ts

@@ -7,4 +7,4 @@ export declare const ListenV1Redact: {
     readonly AggressiveNumbers: "aggressive_numbers";
     readonly Ssn: "ssn";
 };
-export type ListenV1Redact = (typeof ListenV1Redact)[keyof typeof ListenV1Redact];
+export type ListenV1Redact = (typeof ListenV1Redact)[keyof typeof ListenV1Redact] | string;

package/dist/cjs/api/types/ListenV1ResponseResultsChannelsItem.d.ts

@@ -29,6 +29,7 @@ export declare namespace ListenV1ResponseResultsChannelsItem {
             confidence?: number;
             words?: Item.Words.Item[];
             paragraphs?: Item.Paragraphs;
+            entities?: Item.Entities.Item[];
             summaries?: Item.Summaries.Item[];
             topics?: Item.Topics.Item[];
         }
@@ -68,6 +69,17 @@ export declare namespace ListenV1ResponseResultsChannelsItem {
                     }
                 }
             }
+            type Entities = Entities.Item[];
+            namespace Entities {
+                interface Item {
+                    label?: string;
+                    value?: string;
+                    raw_value?: string;
+                    confidence?: number;
+                    start_word?: number;
+                    end_word?: number;
+                }
+            }
             type Summaries = Summaries.Item[];
             namespace Summaries {
                 interface Item {

package/dist/cjs/api/types/ListenV1SmartFormat.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1SmartFormat: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1SmartFormat = (typeof ListenV1SmartFormat)[keyof typeof ListenV1SmartFormat];
+export type ListenV1SmartFormat = (typeof ListenV1SmartFormat)[keyof typeof ListenV1SmartFormat] | string;

package/dist/cjs/api/types/ListenV1VadEvents.d.ts

@@ -3,4 +3,4 @@ export declare const ListenV1VadEvents: {
     readonly True: "true";
     readonly False: "false";
 };
-export type ListenV1VadEvents = (typeof ListenV1VadEvents)[keyof typeof ListenV1VadEvents];
+export type ListenV1VadEvents = (typeof ListenV1VadEvents)[keyof typeof ListenV1VadEvents] | string;

package/dist/cjs/api/types/ListenV2Encoding.d.ts

@@ -7,4 +7,4 @@ export declare const ListenV2Encoding: {
     readonly Opus: "opus";
     readonly OggOpus: "ogg-opus";
 };
-export type ListenV2Encoding = (typeof ListenV2Encoding)[keyof typeof ListenV2Encoding];
+export type ListenV2Encoding = (typeof ListenV2Encoding)[keyof typeof ListenV2Encoding] | string;

package/dist/cjs/api/types/OpenAi.d.ts

@@ -0,0 +1,27 @@
+export interface OpenAi {
+    type: "open_ai";
+    /** The REST API version for the OpenAI text-to-speech API */
+    version?: "v1";
+    /** OpenAI TTS model */
+    model: OpenAi.Model;
+    /** OpenAI voice */
+    voice: OpenAi.Voice;
+}
+export declare namespace OpenAi {
+    /** OpenAI TTS model */
+    const Model: {
+        readonly Tts1: "tts-1";
+        readonly Tts1Hd: "tts-1-hd";
+    };
+    type Model = (typeof Model)[keyof typeof Model] | string;
+    /** OpenAI voice */
+    const Voice: {
+        readonly Alloy: "alloy";
+        readonly Echo: "echo";
+        readonly Fable: "fable";
+        readonly Onyx: "onyx";
+        readonly Nova: "nova";
+        readonly Shimmer: "shimmer";
+    };
+    type Voice = (typeof Voice)[keyof typeof Voice] | string;
+}

package/dist/cjs/api/types/OpenAi.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAi = void 0;
+var OpenAi;
+(function (OpenAi) {
+    /** OpenAI TTS model */
+    OpenAi.Model = {
+        Tts1: "tts-1",
+        Tts1Hd: "tts-1-hd",
+    };
+    /** OpenAI voice */
+    OpenAi.Voice = {
+        Alloy: "alloy",
+        Echo: "echo",
+        Fable: "fable",
+        Onyx: "onyx",
+        Nova: "nova",
+        Shimmer: "shimmer",
+    };
+})(OpenAi || (exports.OpenAi = OpenAi = {}));

package/dist/cjs/api/types/SpeakSettingsV1.d.ts

@@ -0,0 +1,20 @@
+import type * as Deepgram from "../index.js";
+export interface SpeakSettingsV1 {
+    provider: Deepgram.SpeakSettingsV1Provider;
+    /**
+     * Optional if provider is Deepgram. Required for non-Deepgram TTS providers.
+     * When present, must include url field and headers object. Valid schemes are https and wss with wss only supported for Eleven Labs.
+     */
+    endpoint?: SpeakSettingsV1.Endpoint;
+}
+export declare namespace SpeakSettingsV1 {
+    /**
+     * Optional if provider is Deepgram. Required for non-Deepgram TTS providers.
+     * When present, must include url field and headers object. Valid schemes are https and wss with wss only supported for Eleven Labs.
+     */
+    interface Endpoint {
+        /** Custom TTS endpoint URL. Cannot contain `output_format` or `model_id` query parameters when the provider is Eleven Labs. */
+        url?: string;
+        headers?: Record<string, string>;
+    }
+}

package/dist/cjs/api/types/SpeakSettingsV1.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/types/SpeakSettingsV1Provider.d.ts

@@ -0,0 +1,19 @@
+import type * as Deepgram from "../index.js";
+export type SpeakSettingsV1Provider = Deepgram.SpeakSettingsV1Provider.Deepgram | Deepgram.SpeakSettingsV1Provider.ElevenLabs | Deepgram.SpeakSettingsV1Provider.Cartesia | Deepgram.SpeakSettingsV1Provider.OpenAi | Deepgram.SpeakSettingsV1Provider.AwsPolly;
+export declare namespace SpeakSettingsV1Provider {
+    interface Deepgram extends Deepgram.Deepgram {
+        type: "deepgram";
+    }
+    interface ElevenLabs extends Deepgram.ElevenLabsSpeakProvider {
+        type: "eleven_labs";
+    }
+    interface Cartesia extends Deepgram.Cartesia {
+        type: "cartesia";
+    }
+    interface OpenAi extends Deepgram.OpenAi {
+        type: "open_ai";
+    }
+    interface AwsPolly extends Deepgram.AwsPollySpeakProvider {
+        type: "aws_polly";
+    }
+}

package/dist/cjs/api/types/SpeakSettingsV1Provider.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/types/SpeakV1Encoding.d.ts

@@ -4,4 +4,4 @@ export declare const SpeakV1Encoding: {
     readonly Mulaw: "mulaw";
     readonly Alaw: "alaw";
 };
-export type SpeakV1Encoding = (typeof SpeakV1Encoding)[keyof typeof SpeakV1Encoding];
+export type SpeakV1Encoding = (typeof SpeakV1Encoding)[keyof typeof SpeakV1Encoding] | string;

package/dist/cjs/api/types/SpeakV1Model.d.ts

@@ -64,4 +64,4 @@ export declare const SpeakV1Model: {
     readonly Aura2EstrellaEs: "aura-2-estrella-es";
     readonly Aura2JavierEs: "aura-2-javier-es";
 };
-export type SpeakV1Model = (typeof SpeakV1Model)[keyof typeof SpeakV1Model];
+export type SpeakV1Model = (typeof SpeakV1Model)[keyof typeof SpeakV1Model] | string;

package/dist/cjs/api/types/SpeakV1SampleRate.d.ts

@@ -6,4 +6,4 @@ export declare const SpeakV1SampleRate: {
     readonly ThirtyTwoThousand: "32000";
     readonly FortyEightThousand: "48000";
 };
-export type SpeakV1SampleRate = (typeof SpeakV1SampleRate)[keyof typeof SpeakV1SampleRate];
+export type SpeakV1SampleRate = (typeof SpeakV1SampleRate)[keyof typeof SpeakV1SampleRate] | string;

package/dist/cjs/api/types/ThinkSettingsV1.d.ts

@@ -0,0 +1,50 @@
+export interface ThinkSettingsV1 {
+    /** Think provider configuration (OpenAI, AWS Bedrock, Anthropic, Google, or Groq) */
+    provider: Record<string, unknown>;
+    /** Optional for non-Deepgram LLM providers. When present, must include url field and headers object */
+    endpoint?: ThinkSettingsV1.Endpoint;
+    functions?: ThinkSettingsV1.Functions.Item[];
+    prompt?: string;
+    /** Specifies the number of characters retained in context between user messages, agent responses, and function calls. This setting is only configurable when a custom think endpoint is used */
+    context_length?: ThinkSettingsV1.ContextLength;
+}
+export declare namespace ThinkSettingsV1 {
+    /**
+     * Optional for non-Deepgram LLM providers. When present, must include url field and headers object
+     */
+    interface Endpoint {
+        /** Custom LLM endpoint URL */
+        url?: string;
+        /** Custom headers for the endpoint */
+        headers?: Record<string, string>;
+    }
+    type Functions = Functions.Item[];
+    namespace Functions {
+        interface Item {
+            /** Function name */
+            name?: string;
+            /** Function description */
+            description?: string;
+            /** Function parameters */
+            parameters?: Record<string, unknown>;
+            /** The Function endpoint to call. if not passed, function is called client-side */
+            endpoint?: Item.Endpoint;
+        }
+        namespace Item {
+            /**
+             * The Function endpoint to call. if not passed, function is called client-side
+             */
+            interface Endpoint {
+                /** Endpoint URL */
+                url?: string;
+                /** HTTP method */
+                method?: string;
+                headers?: Record<string, string>;
+            }
+        }
+    }
+    /**
+     * Specifies the number of characters retained in context between user messages, agent responses, and function calls. This setting is only configurable when a custom think endpoint is used
+     */
+    type ContextLength = "max" | number;
+}

package/dist/cjs/api/types/ThinkSettingsV1.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/types/index.d.ts

@@ -1,13 +1,19 @@
 export * from "./AgentThinkModelsV1Response.js";
+export * from "./Anthropic.js";
+export * from "./AwsBedrockThinkProvider.js";
+export * from "./AwsPollySpeakProvider.js";
 export * from "./BillingBreakdownV1Response.js";
+export * from "./Cartesia.js";
 export * from "./CreateKeyV1RequestOne.js";
 export * from "./CreateKeyV1Response.js";
 export * from "./CreateProjectDistributionCredentialsV1Response.js";
 export * from "./CreateProjectInviteV1Response.js";
+export * from "./Deepgram.js";
 export * from "./DeleteProjectInviteV1Response.js";
 export * from "./DeleteProjectKeyV1Response.js";
 export * from "./DeleteProjectMemberV1Response.js";
 export * from "./DeleteProjectV1Response.js";
+export * from "./ElevenLabsSpeakProvider.js";
 export * from "./ErrorResponse.js";
 export * from "./ErrorResponseLegacyError.js";
 export * from "./ErrorResponseModernError.js";
@@ -18,13 +24,16 @@ export * from "./GetProjectDistributionCredentialsV1Response.js";
 export * from "./GetProjectKeyV1Response.js";
 export * from "./GetProjectRequestV1Response.js";
 export * from "./GetProjectV1Response.js";
+export * from "./Google.js";
 export * from "./GrantV1Response.js";
+export * from "./Groq.js";
 export * from "./LeaveProjectV1Response.js";
 export * from "./ListBillingFieldsV1Response.js";
 export * from "./ListenV1AcceptedResponse.js";
 export * from "./ListenV1Callback.js";
 export * from "./ListenV1CallbackMethod.js";
 export * from "./ListenV1Channels.js";
+export * from "./ListenV1DetectEntities.js";
 export * from "./ListenV1Diarize.js";
 export * from "./ListenV1Dictation.js";
 export * from "./ListenV1Encoding.js";
@@ -79,6 +88,7 @@ export * from "./ListProjectMembersV1Response.js";
 export * from "./ListProjectPurchasesV1Response.js";
 export * from "./ListProjectRequestsV1Response.js";
 export * from "./ListProjectsV1Response.js";
+export * from "./OpenAi.js";
 export * from "./ProjectRequestResponse.js";
 export * from "./ReadV1Request.js";
 export * from "./ReadV1RequestText.js";
@@ -90,11 +100,14 @@ export * from "./ReadV1ResponseResultsSummary.js";
 export * from "./SharedIntents.js";
 export * from "./SharedSentiments.js";
 export * from "./SharedTopics.js";
+export * from "./SpeakSettingsV1.js";
+export * from "./SpeakSettingsV1Provider.js";
 export * from "./SpeakV1Encoding.js";
 export * from "./SpeakV1MipOptOut.js";
 export * from "./SpeakV1Model.js";
 export * from "./SpeakV1Response.js";
 export * from "./SpeakV1SampleRate.js";
+export * from "./ThinkSettingsV1.js";
 export * from "./UpdateProjectMemberScopesV1Response.js";
 export * from "./UpdateProjectV1Response.js";
 export * from "./UsageBreakdownV1Response.js";

package/dist/cjs/api/types/index.js

@@ -15,15 +15,21 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AgentThinkModelsV1Response.js"), exports);
+__exportStar(require("./Anthropic.js"), exports);
+__exportStar(require("./AwsBedrockThinkProvider.js"), exports);
+__exportStar(require("./AwsPollySpeakProvider.js"), exports);
 __exportStar(require("./BillingBreakdownV1Response.js"), exports);
+__exportStar(require("./Cartesia.js"), exports);
 __exportStar(require("./CreateKeyV1RequestOne.js"), exports);
 __exportStar(require("./CreateKeyV1Response.js"), exports);
 __exportStar(require("./CreateProjectDistributionCredentialsV1Response.js"), exports);
 __exportStar(require("./CreateProjectInviteV1Response.js"), exports);
+__exportStar(require("./Deepgram.js"), exports);
 __exportStar(require("./DeleteProjectInviteV1Response.js"), exports);
 __exportStar(require("./DeleteProjectKeyV1Response.js"), exports);
 __exportStar(require("./DeleteProjectMemberV1Response.js"), exports);
 __exportStar(require("./DeleteProjectV1Response.js"), exports);
+__exportStar(require("./ElevenLabsSpeakProvider.js"), exports);
 __exportStar(require("./ErrorResponse.js"), exports);
 __exportStar(require("./ErrorResponseLegacyError.js"), exports);
 __exportStar(require("./ErrorResponseModernError.js"), exports);
@@ -34,13 +40,16 @@ __exportStar(require("./GetProjectDistributionCredentialsV1Response.js"), export
 __exportStar(require("./GetProjectKeyV1Response.js"), exports);
 __exportStar(require("./GetProjectRequestV1Response.js"), exports);
 __exportStar(require("./GetProjectV1Response.js"), exports);
+__exportStar(require("./Google.js"), exports);
 __exportStar(require("./GrantV1Response.js"), exports);
+__exportStar(require("./Groq.js"), exports);
 __exportStar(require("./LeaveProjectV1Response.js"), exports);
 __exportStar(require("./ListBillingFieldsV1Response.js"), exports);
 __exportStar(require("./ListenV1AcceptedResponse.js"), exports);
 __exportStar(require("./ListenV1Callback.js"), exports);
 __exportStar(require("./ListenV1CallbackMethod.js"), exports);
 __exportStar(require("./ListenV1Channels.js"), exports);
+__exportStar(require("./ListenV1DetectEntities.js"), exports);
 __exportStar(require("./ListenV1Diarize.js"), exports);
 __exportStar(require("./ListenV1Dictation.js"), exports);
 __exportStar(require("./ListenV1Encoding.js"), exports);
@@ -95,6 +104,7 @@ __exportStar(require("./ListProjectMembersV1Response.js"), exports);
 __exportStar(require("./ListProjectPurchasesV1Response.js"), exports);
 __exportStar(require("./ListProjectRequestsV1Response.js"), exports);
 __exportStar(require("./ListProjectsV1Response.js"), exports);
+__exportStar(require("./OpenAi.js"), exports);
 __exportStar(require("./ProjectRequestResponse.js"), exports);
 __exportStar(require("./ReadV1Request.js"), exports);
 __exportStar(require("./ReadV1RequestText.js"), exports);
@@ -106,11 +116,14 @@ __exportStar(require("./ReadV1ResponseResultsSummary.js"), exports);
 __exportStar(require("./SharedIntents.js"), exports);
 __exportStar(require("./SharedSentiments.js"), exports);
 __exportStar(require("./SharedTopics.js"), exports);
+__exportStar(require("./SpeakSettingsV1.js"), exports);
+__exportStar(require("./SpeakSettingsV1Provider.js"), exports);
 __exportStar(require("./SpeakV1Encoding.js"), exports);
 __exportStar(require("./SpeakV1MipOptOut.js"), exports);
 __exportStar(require("./SpeakV1Model.js"), exports);
 __exportStar(require("./SpeakV1Response.js"), exports);
 __exportStar(require("./SpeakV1SampleRate.js"), exports);
+__exportStar(require("./ThinkSettingsV1.js"), exports);
 __exportStar(require("./UpdateProjectMemberScopesV1Response.js"), exports);
 __exportStar(require("./UpdateProjectV1Response.js"), exports);
 __exportStar(require("./UsageBreakdownV1Response.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.0.259";
+export declare const SDK_VERSION = "0.0.283";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.0.259";
+exports.SDK_VERSION = "0.0.283";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "",
-        "X-Fern-SDK-Version": "0.0.259",
-        "User-Agent": "/0.0.259",
+        "X-Fern-SDK-Version": "0.0.283",
+        "User-Agent": "/0.0.283",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/CustomClient.mjs

@@ -337,6 +337,26 @@ function setupBinaryHandling(socket, eventHandlers) {
     socket.addEventListener("message", binaryAwareHandler);
     return binaryAwareHandler;
 }
+/**
+ * Helper to prevent duplicate event listeners on WebSocket connections.
+ * This removes all event listeners that were registered by the auto-generated
+ * Socket class constructor, preventing duplicate event firing when connect() is called.
+ */
+function preventDuplicateEventListeners(socket, handlers) {
+    // Remove the handlers that were added by the auto-generated constructor
+    if (handlers.handleOpen) {
+        socket.removeEventListener("open", handlers.handleOpen);
+    }
+    if (handlers.handleMessage) {
+        socket.removeEventListener("message", handlers.handleMessage);
+    }
+    if (handlers.handleClose) {
+        socket.removeEventListener("close", handlers.handleClose);
+    }
+    if (handlers.handleError) {
+        socket.removeEventListener("error", handlers.handleError);
+    }
+}
 /**
  * Helper function to reset socket connection state before connecting.
  * Ensures _connectLock is reset if the socket is in CLOSED state.
@@ -407,6 +427,24 @@ class WrappedAgentV1Client extends AgentV1Client {
             return new WrappedAgentV1Socket({ socket });
         });
     }
+    /**
+     * Creates a WebSocket connection object without actually connecting.
+     * This is an alias for connect() with clearer naming - the returned socket
+     * is not connected until you call socket.connect().
+     *
+     * Usage:
+     * ```typescript
+     * const socket = await client.agent.v1.createConnection();
+     * socket.on('open', () => console.log('Connected!'));
+     * socket.on('message', (msg) => console.log('Message:', msg));
+     * socket.connect(); // Actually initiates the connection
+     * ```
+     */
+    createConnection() {
+        return __awaiter(this, arguments, void 0, function* (args = {}) {
+            return this.connect(args);
+        });
+    }
 }
 /**
  * Wrapper for Agent V1Socket that handles binary messages correctly.
@@ -425,6 +463,14 @@ class WrappedAgentV1Socket extends AgentV1Socket {
         this.binaryAwareHandler = setupBinaryHandling(this.socket, this.eventHandlers);
     }
     connect() {
+        // Remove duplicate listeners before calling super.connect()
+        const socketAny = this;
+        preventDuplicateEventListeners(this.socket, {
+            handleOpen: socketAny.handleOpen,
+            handleMessage: socketAny.handleMessage,
+            handleClose: socketAny.handleClose,
+            handleError: socketAny.handleError
+        });
         resetSocketConnectionState(this.socket);
         super.connect();
         // Re-setup binary handling in case connect() re-registered handlers
@@ -513,6 +559,24 @@ class WrappedListenV1Client extends ListenV1Client {
             return new WrappedListenV1Socket({ socket });
         });
     }
+    /**
+     * Creates a WebSocket connection object without actually connecting.
+     * This is an alias for connect() with clearer naming - the returned socket
+     * is not connected until you call socket.connect().
+     *
+     * Usage:
+     * ```typescript
+     * const socket = await client.listen.v1.createConnection({ model: 'nova-3' });
+     * socket.on('open', () => console.log('Connected!'));
+     * socket.on('message', (msg) => console.log('Transcript:', msg));
+     * socket.connect(); // Actually initiates the connection
+     * ```
+     */
+    createConnection(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.connect(args);
+        });
+    }
 }
 /**
  * Wrapper for Listen V1Socket that handles binary messages correctly.
@@ -531,6 +595,14 @@ class WrappedListenV1Socket extends ListenV1Socket {
         this.binaryAwareHandler = setupBinaryHandling(this.socket, this.eventHandlers);
     }
     connect() {
+        // Remove duplicate listeners before calling super.connect()
+        const socketAny = this;
+        preventDuplicateEventListeners(this.socket, {
+            handleOpen: socketAny.handleOpen,
+            handleMessage: socketAny.handleMessage,
+            handleClose: socketAny.handleClose,
+            handleError: socketAny.handleError
+        });
         resetSocketConnectionState(this.socket);
         super.connect();
         this.setupBinaryHandling();
@@ -580,6 +652,24 @@ class WrappedListenV2Client extends ListenV2Client {
             return new WrappedListenV2Socket({ socket });
         });
     }
+    /**
+     * Creates a WebSocket connection object without actually connecting.
+     * This is an alias for connect() with clearer naming - the returned socket
+     * is not connected until you call socket.connect().
+     *
+     * Usage:
+     * ```typescript
+     * const socket = await client.listen.v2.createConnection({ model: 'flux-general-en' });
+     * socket.on('open', () => console.log('Connected!'));
+     * socket.on('message', (msg) => console.log('Transcript:', msg));
+     * socket.connect(); // Actually initiates the connection
+     * ```
+     */
+    createConnection(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.connect(args);
+        });
+    }
 }
 /**
  * Wrapper for Listen V2Socket that handles binary messages correctly and adds ping support.
@@ -599,6 +689,14 @@ class WrappedListenV2Socket extends ListenV2Socket {
         this.binaryAwareHandler = setupBinaryHandling(this.socket, this.eventHandlers);
     }
     connect() {
+        // Remove duplicate listeners before calling super.connect()
+        const socketAny = this;
+        preventDuplicateEventListeners(this.socket, {
+            handleOpen: socketAny.handleOpen,
+            handleMessage: socketAny.handleMessage,
+            handleClose: socketAny.handleClose,
+            handleError: socketAny.handleError
+        });
         resetSocketConnectionState(this.socket);
         super.connect();
         this.setupBinaryHandling();
@@ -669,6 +767,24 @@ class WrappedSpeakV1Client extends SpeakV1Client {
             return new WrappedSpeakV1Socket({ socket });
         });
     }
+    /**
+     * Creates a WebSocket connection object without actually connecting.
+     * This is an alias for connect() with clearer naming - the returned socket
+     * is not connected until you call socket.connect().
+     *
+     * Usage:
+     * ```typescript
+     * const socket = await client.speak.v1.createConnection({ model: 'aura-asteria-en' });
+     * socket.on('open', () => console.log('Connected!'));
+     * socket.on('message', (audioData) => console.log('Audio received'));
+     * socket.connect(); // Actually initiates the connection
+     * ```
+     */
+    createConnection(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.connect(args);
+        });
+    }
 }
 /**
  * Wrapper for Speak V1Socket that handles binary messages correctly.
@@ -687,6 +803,14 @@ class WrappedSpeakV1Socket extends SpeakV1Socket {
         this.binaryAwareHandler = setupBinaryHandling(this.socket, this.eventHandlers);
     }
     connect() {
+        // Remove duplicate listeners before calling super.connect()
+        const socketAny = this;
+        preventDuplicateEventListeners(this.socket, {
+            handleOpen: socketAny.handleOpen,
+            handleMessage: socketAny.handleMessage,
+            handleClose: socketAny.handleClose,
+            handleError: socketAny.handleError
+        });
         resetSocketConnectionState(this.socket);
         super.connect();
         this.setupBinaryHandling();

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

@@ -12,5 +12,5 @@ export declare namespace AgentV1ConversationText {
         readonly User: "user";
         readonly Assistant: "assistant";
     };
-    type Role = (typeof Role)[keyof typeof Role];
+    type Role = (typeof Role)[keyof typeof Role] | string;
 }