feat: add agent builder support and enhance project members API

fern-api[bot] · web-flow · commit 63788cba3b26 · 2026-03-18T20:08:39.000Z
Adds support for agent builder with simplified agent configuration using agent IDs, 
refactors agent settings structure for better type safety, and extends project members 
API with additional user information fields.

Key changes:
- Add agent builder support with string agent ID alternative to complex configuration
- Restructure Agent type to union of complex config or simple string ID
- Rename AgentV1SettingsAgentListenProvider to AgentV1SettingsAgentContextListenProvider
- Add scopes, first_name, and last_name fields to project members response
- Add comprehensive JSDoc comments to Listen V1/V2 and Speak V1 type definitions
- Remove deprecated context7.json configuration file

🌿 Generated with Fern
diff --git a/.fern/metadata.json b/.fern/metadata.json
@@ -1,5 +1,5 @@
 {
-    "cliVersion": "4.3.0",
+    "cliVersion": "4.34.1",
     "generatorName": "fernapi/fern-typescript-node-sdk",
     "generatorVersion": "3.53.3",
     "generatorConfig": {
@@ -9,10 +9,8 @@
         "skipResponseValidation": true,
         "includeApiReference": true,
         "shouldGenerateWebsocketClients": true,
-        "enableForwardCompatibleEnums": true,
-        "packageJson": {
-            "name": "@deepgram/sdk"
-        }
+        "enableForwardCompatibleEnums": true
     },
-    "sdkVersion": "5.0.0"
+    "originGitCommit": "aa3f3e3dced2b6d6c98cc8cf01ade234be6d8e98",
+    "sdkVersion": "6.0.0"
 }
diff --git a/changelog.md b/changelog.md
@@ -0,0 +1,3 @@
+## 6.0.0 - 2026-03-18
+* The Agent configuration type has been restructured as a union type that accepts either a detailed configuration object or a simple agent ID string for use with the agent builder. This change simplifies agent setup when using pre-built agents but requires updating existing code that accesses nested Agent properties. The AgentV1SettingsAgentListenProvider type has been renamed to AgentV1SettingsAgentContextListenProvider. Project members API now includes additional fields: scopes, first_name, and last_name.
+
diff --git a/context7.json b/context7.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@deepgram/sdk",
-    "version": "5.0.0",
+    "version": "6.0.0",
     "private": false,
     "repository": {
         "type": "git",
diff --git a/src/BaseClient.ts b/src/BaseClient.ts
@@ -52,8 +52,8 @@ export function normalizeClientOptions<T extends BaseClientOptions = BaseClientO
         {
             "X-Fern-Language": "JavaScript",
             "X-Fern-SDK-Name": "@deepgram/sdk",
-            "X-Fern-SDK-Version": "4.11.4",
-            "User-Agent": "@deepgram/sdk/4.11.4",
+            "X-Fern-SDK-Version": "6.0.0",
+            "User-Agent": "@deepgram/sdk/6.0.0",
             "X-Fern-Runtime": core.RUNTIME.type,
             "X-Fern-Runtime-Version": core.RUNTIME.version,
         },
diff --git a/src/api/resources/agent/resources/v1/types/AgentV1Settings.ts b/src/api/resources/agent/resources/v1/types/AgentV1Settings.ts
@@ -82,62 +82,42 @@ export namespace AgentV1Settings {
         }
     }
 
-    export interface Agent {
-        /** Deprecated. Use `listen.provider.language` and `speak.provider.language` fields instead. */
-        language?: string | undefined;
-        /** Conversation context including the history of messages and function calls */
-        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 | undefined;
-    }
-
-    export namespace Agent {
+    export type Agent =
+        | {
+              language?: string | undefined;
+              context?:
+                  | {
+                        messages?:
+                            | (
+                                  | {
+                                        type: "History";
+                                        role: "user" | "assistant" | string;
+                                        content: string;
+                                    }
+                                  | {
+                                        type: "History";
+                                        function_calls: {
+                                            id: string;
+                                            name: string;
+                                            client_side: boolean;
+                                            arguments: string;
+                                            response: string;
+                                        }[];
+                                    }
+                              )[]
+                            | undefined;
+                    }
+                  | undefined;
+              listen?:
+                  | {
+                        provider?: Deepgram.agent.AgentV1SettingsAgentContextListenProvider | undefined;
+                    }
+                  | undefined;
+              think?: (Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[]) | undefined;
+              speak?: (Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[]) | undefined;
+              greeting?: string | undefined;
+          }
         /**
-         * Conversation context including the history of messages and function calls
-         */
-        export interface Context {
-            /** Conversation history as a list of messages and function calls */
-            messages?: Context.Messages.Item[] | undefined;
-        }
-
-        export namespace Context {
-            export type Messages = Messages.Item[];
-
-            export namespace Messages {
-                /**
-                 * A message here is either a conversational message or a function call
-                 */
-                export type Item =
-                    /**
-                     * 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;
-                          }[];
-                      };
-            }
-        }
-
-        export interface Listen {
-            provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider | undefined;
-        }
-
-        export type Think = Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[];
-        export type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
-    }
+         * The ID of an agent created using the agent builder */
+        | string;
 }
diff --git a/src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentContextListenProvider.ts b/src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentContextListenProvider.ts
@@ -2,11 +2,11 @@
 
 import type * as Deepgram from "../../../../../index.js";
 
-export type AgentV1SettingsAgentListenProvider =
-    | Deepgram.agent.AgentV1SettingsAgentListenProvider.V1
-    | Deepgram.agent.AgentV1SettingsAgentListenProvider.V2;
+export type AgentV1SettingsAgentContextListenProvider =
+    | Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V1
+    | Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V2;
 
-export namespace AgentV1SettingsAgentListenProvider {
+export namespace AgentV1SettingsAgentContextListenProvider {
     export interface V1 {
         version: "v1";
         /** Provider type for speech-to-text */
@@ -15,7 +15,6 @@ export namespace AgentV1SettingsAgentListenProvider {
         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;
@@ -27,7 +26,8 @@ export namespace AgentV1SettingsAgentListenProvider {
         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;
+        eot_threshold?: Deepgram.ListenV2EotThreshold | undefined;
+        eager_eot_threshold?: Deepgram.ListenV2EagerEotThreshold | undefined;
     }
 }
diff --git a/src/api/resources/agent/resources/v1/types/index.ts b/src/api/resources/agent/resources/v1/types/index.ts
@@ -12,7 +12,7 @@ export * from "./AgentV1PromptUpdated.js";
 export * from "./AgentV1ReceiveFunctionCallResponse.js";
 export * from "./AgentV1SendFunctionCallResponse.js";
 export * from "./AgentV1Settings.js";
-export * from "./AgentV1SettingsAgentListenProvider.js";
+export * from "./AgentV1SettingsAgentContextListenProvider.js";
 export * from "./AgentV1SettingsApplied.js";
 export * from "./AgentV1SpeakUpdated.js";
 export * from "./AgentV1ThinkUpdated.js";
diff --git a/src/api/types/ListProjectMembersV1Response.ts b/src/api/types/ListProjectMembersV1Response.ts
@@ -11,7 +11,11 @@ export namespace ListProjectMembersV1Response {
         export interface Item {
             /** The unique identifier of the member */
             member_id?: string | undefined;
+            /** The API scopes of the member */
+            scopes?: string[] | undefined;
             email?: string | undefined;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
         }
     }
 }
diff --git a/src/api/types/ListenV1Callback.ts b/src/api/types/ListenV1Callback.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * URL to which we'll make the callback request
+ */
 export type ListenV1Callback = unknown;
diff --git a/src/api/types/ListenV1Channels.ts b/src/api/types/ListenV1Channels.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * The number of channels in the submitted audio
+ */
 export type ListenV1Channels = unknown;
diff --git a/src/api/types/ListenV1Endpointing.ts b/src/api/types/ListenV1Endpointing.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing
+ */
 export type ListenV1Endpointing = unknown;
diff --git a/src/api/types/ListenV1Extra.ts b/src/api/types/ListenV1Extra.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Arbitrary key-value pairs that are attached to the API response for usage in downstream processing
+ */
 export type ListenV1Extra = unknown;
diff --git a/src/api/types/ListenV1Keyterm.ts b/src/api/types/ListenV1Keyterm.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Key term prompting can boost specialized terminology and brands. Only compatible with Nova-3
+ */
 export type ListenV1Keyterm = unknown;
diff --git a/src/api/types/ListenV1Keywords.ts b/src/api/types/ListenV1Keywords.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Keywords can boost or suppress specialized terminology and brands
+ */
 export type ListenV1Keywords = unknown;
diff --git a/src/api/types/ListenV1Language.ts b/src/api/types/ListenV1Language.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available
+ */
 export type ListenV1Language = unknown;
diff --git a/src/api/types/ListenV1MipOptOut.ts b/src/api/types/ListenV1MipOptOut.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip
+ */
 export type ListenV1MipOptOut = unknown;
diff --git a/src/api/types/ListenV1Replace.ts b/src/api/types/ListenV1Replace.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Search for terms or phrases in submitted audio and replaces them
+ */
 export type ListenV1Replace = unknown;
diff --git a/src/api/types/ListenV1SampleRate.ts b/src/api/types/ListenV1SampleRate.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Sample rate of submitted audio. Required (and only read) when a value is provided for encoding
+ */
 export type ListenV1SampleRate = unknown;
diff --git a/src/api/types/ListenV1Search.ts b/src/api/types/ListenV1Search.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Search for terms or phrases in submitted audio
+ */
 export type ListenV1Search = unknown;
diff --git a/src/api/types/ListenV1Tag.ts b/src/api/types/ListenV1Tag.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Label your requests for the purpose of identification during usage reporting
+ */
 export type ListenV1Tag = unknown;
diff --git a/src/api/types/ListenV1UtteranceEndMs.ts b/src/api/types/ListenV1UtteranceEndMs.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results
+ */
 export type ListenV1UtteranceEndMs = unknown;
diff --git a/src/api/types/ListenV1Version.ts b/src/api/types/ListenV1Version.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Version of an AI model to use
+ */
 export type ListenV1Version = unknown;
diff --git a/src/api/types/ListenV2EagerEotThreshold.ts b/src/api/types/ListenV2EagerEotThreshold.ts
@@ -1,3 +1,8 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * End-of-turn confidence required to fire an eager end-of-turn event.
+ * When set, enables `EagerEndOfTurn` and `TurnResumed` events. Valid
+ * Values 0.3 - 0.9.
+ */
 export type ListenV2EagerEotThreshold = unknown;
diff --git a/src/api/types/ListenV2EotThreshold.ts b/src/api/types/ListenV2EotThreshold.ts
@@ -1,3 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * End-of-turn confidence required to finish a turn. Valid Values 0.5 -
+ * 0.9.
+ */
 export type ListenV2EotThreshold = unknown;
diff --git a/src/api/types/ListenV2EotTimeoutMs.ts b/src/api/types/ListenV2EotTimeoutMs.ts
@@ -1,3 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * A turn will be finished when this much time has passed after speech,
+ * regardless of EOT confidence.
+ */
 export type ListenV2EotTimeoutMs = unknown;
diff --git a/src/api/types/ListenV2MipOptOut.ts b/src/api/types/ListenV2MipOptOut.ts
@@ -1,3 +1,8 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Opts out requests from the Deepgram Model Improvement Program. Refer
+ * to our Docs for pricing impacts before setting this to true.
+ * https://dpgr.am/deepgram-mip
+ */
 export type ListenV2MipOptOut = unknown;
diff --git a/src/api/types/ListenV2SampleRate.ts b/src/api/types/ListenV2SampleRate.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Sample rate of the audio stream in Hz. Required if sending non-containerized/raw audio. If sending containerized audio, this parameter should be omitted.
+ */
 export type ListenV2SampleRate = unknown;
diff --git a/src/api/types/ListenV2Tag.ts b/src/api/types/ListenV2Tag.ts
@@ -1,3 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Label your requests for the purpose of identification during usage
+ * reporting
+ */
 export type ListenV2Tag = unknown;
diff --git a/src/api/types/SpeakV1MipOptOut.ts b/src/api/types/SpeakV1MipOptOut.ts
@@ -1,3 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
+/**
+ * Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip
+ */
 export type SpeakV1MipOptOut = unknown;
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const SDK_VERSION = "4.11.4";
+export const SDK_VERSION = "6.0.0";
diff --git a/tests/wire/manage/v1/projects/members.test.ts b/tests/wire/manage/v1/projects/members.test.ts
@@ -13,7 +13,17 @@ describe("MembersClient", () => {
             environment: { base: server.baseUrl, agent: server.baseUrl, production: server.baseUrl },
         });
 
-        const rawResponseBody = { members: [{ member_id: "member_id", email: "email" }] };
+        const rawResponseBody = {
+            members: [
+                {
+                    member_id: "member_id",
+                    scopes: ["scopes"],
+                    email: "email",
+                    first_name: "first_name",
+                    last_name: "last_name",
+                },
+            ],
+        };
         server
             .mockEndpoint()
             .get("/v1/projects/123456-7890-1234-5678-901234/members")
@@ -27,7 +37,10 @@ describe("MembersClient", () => {
             members: [
                 {
                     member_id: "member_id",
+                    scopes: ["scopes"],
                     email: "email",
+                    first_name: "first_name",
+                    last_name: "last_name",
                 },
             ],
         });

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+## 6.0.0 - 2026-03-18`
	`2`	+* The Agent configuration type has been restructured as a union type that accepts either a detailed configuration object or a simple agent ID string for use with the agent builder. This change simplifies agent setup when using pre-built agents but requires updating existing code that accesses nested Agent properties. The AgentV1SettingsAgentListenProvider type has been renamed to AgentV1SettingsAgentContextListenProvider. Project members API now includes additional fields: scopes, first_name, and last_name.
	`3`	`+`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@deepgram/sdk",`
`3`		`- "version": "5.0.0",`
	`3`	`+ "version": "6.0.0",`
`4`	`4`	`"private": false,`
`5`	`5`	`"repository": {`
`6`	`6`	`"type": "git",`
Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,11 @@ export namespace ListProjectMembersV1Response {`
`11`	`11`	`export interface Item {`
`12`	`12`	`/** The unique identifier of the member */`
`13`	`13`	`member_id?: string \| undefined;`
	`14`	`+ /** The API scopes of the member */`
	`15`	`+ scopes?: string[] \| undefined;`
`14`	`16`	`email?: string \| undefined;`
	`17`	`+ first_name?: string \| undefined;`
	`18`	`+ last_name?: string \| undefined;`
`15`	`19`	`}`
`16`	`20`	`}`
`17`	`21`	`}`