Skip to content

Commit 41e8ad2

Browse files
refactor: reorganize agent context structure and add new types
Restructured the agent context configuration to move nested components from AgentV1SettingsAgent to AgentV1SettingsAgentContext, creating a cleaner hierarchical organization. Added new types for think updates and speak updates with dedicated parameter classes. Key changes: - Moved Listen, Speak, and Think types from AgentV1SettingsAgent to AgentV1SettingsAgentContext - Renamed context message types to include "Context" prefix for clarity - Added AgentV1ThinkUpdated and related parameter types - Added AgentV1UpdateSpeakSpeak and AgentV1UpdateThinkThink types - Updated documentation examples for authorization header format - Added new context parameter types and consolidated imports 🌿 Generated with Fern
1 parent 74f48c5 commit 41e8ad2

79 files changed

Lines changed: 1496 additions & 792 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.fern/metadata.json

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"cliVersion": "3.77.1",
2+
"cliVersion": "4.34.1",
33
"generatorName": "fernapi/fern-python-sdk",
44
"generatorVersion": "4.57.2",
55
"generatorConfig": {
@@ -16,5 +16,6 @@
1616
"skip_validation": true
1717
}
1818
},
19-
"sdkVersion": "6.0.1"
19+
"originGitCommit": "aa3f3e3dced2b6d6c98cc8cf01ade234be6d8e98",
20+
"sdkVersion": "7.0.0"
2021
}

changelog.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
## 7.0.0 - 2026-03-18
2+
* The SDK now supports end-of-turn threshold configuration with new `eot_threshold` and `eager_eot_threshold` fields in V2 listen providers. Agent settings have been restructured with improved type organization and new think update capabilities.
3+
* The agent API types have been restructured for better organization. Several type names have changed:
4+
* `AgentV1SettingsAgentListen``AgentV1SettingsAgentContextListen`
5+
* `AgentV1SettingsAgentSpeak``AgentV1SettingsAgentContextSpeak`
6+
* `AgentV1SettingsAgentThink``AgentV1SettingsAgentContextThink`
7+
* Context message types now include "Context" in their names (e.g., `AgentV1SettingsAgentContextMessagesItem``AgentV1SettingsAgentContextContextMessagesItem`)
8+
* Update your imports to use the new type names. The functionality remains the same, only the naming structure has changed to better reflect the hierarchical organization.
9+
* The SDK now includes enhanced agent configuration with restructured context settings and new think/speak update types. Listen websocket connections now use strongly-typed parameters instead of generic strings for better type safety and IDE support.
10+
* The WebSocket APIs now use specific type classes (ListenV2Encoding, SpeakV1Model, etc.) instead of generic strings for better type safety and IDE support. New agent configuration capabilities have been added, including support for listen, speak, and think provider settings with dynamic configuration updates.
11+
* New configuration message types for Listen v2 API enable dynamic adjustment of thresholds and keyterms during streaming sessions. Project member responses now include optional scopes, first_name, and last_name fields.
12+

poetry.lock

Lines changed: 133 additions & 117 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ dynamic = ["version"]
44

55
[tool.poetry]
66
name = "deepgram-sdk"
7-
version = "6.0.1"
7+
version = "7.0.0"
88
description = ""
99
readme = "README.md"
1010
authors = []

src/deepgram/agent/__init__.py

Lines changed: 105 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -40,33 +40,35 @@
4040
AgentV1Settings,
4141
AgentV1SettingsAgent,
4242
AgentV1SettingsAgentContext,
43-
AgentV1SettingsAgentContextMessagesItem,
44-
AgentV1SettingsAgentContextMessagesItemContent,
45-
AgentV1SettingsAgentContextMessagesItemContentParams,
46-
AgentV1SettingsAgentContextMessagesItemContentRole,
47-
AgentV1SettingsAgentContextMessagesItemFunctionCalls,
48-
AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItem,
49-
AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItemParams,
50-
AgentV1SettingsAgentContextMessagesItemFunctionCallsParams,
51-
AgentV1SettingsAgentContextMessagesItemParams,
43+
AgentV1SettingsAgentContextContext,
44+
AgentV1SettingsAgentContextContextMessagesItem,
45+
AgentV1SettingsAgentContextContextMessagesItemContent,
46+
AgentV1SettingsAgentContextContextMessagesItemContentParams,
47+
AgentV1SettingsAgentContextContextMessagesItemContentRole,
48+
AgentV1SettingsAgentContextContextMessagesItemFunctionCalls,
49+
AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItem,
50+
AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItemParams,
51+
AgentV1SettingsAgentContextContextMessagesItemFunctionCallsParams,
52+
AgentV1SettingsAgentContextContextMessagesItemParams,
53+
AgentV1SettingsAgentContextContextParams,
54+
AgentV1SettingsAgentContextListen,
55+
AgentV1SettingsAgentContextListenParams,
56+
AgentV1SettingsAgentContextListenProvider,
57+
AgentV1SettingsAgentContextListenProviderParams,
58+
AgentV1SettingsAgentContextListenProviderV1,
59+
AgentV1SettingsAgentContextListenProviderV1Params,
60+
AgentV1SettingsAgentContextListenProviderV2,
61+
AgentV1SettingsAgentContextListenProviderV2Params,
62+
AgentV1SettingsAgentContextListenProvider_V1,
63+
AgentV1SettingsAgentContextListenProvider_V1Params,
64+
AgentV1SettingsAgentContextListenProvider_V2,
65+
AgentV1SettingsAgentContextListenProvider_V2Params,
5266
AgentV1SettingsAgentContextParams,
53-
AgentV1SettingsAgentListen,
54-
AgentV1SettingsAgentListenParams,
55-
AgentV1SettingsAgentListenProvider,
56-
AgentV1SettingsAgentListenProviderParams,
57-
AgentV1SettingsAgentListenProviderV1,
58-
AgentV1SettingsAgentListenProviderV1Params,
59-
AgentV1SettingsAgentListenProviderV2,
60-
AgentV1SettingsAgentListenProviderV2Params,
61-
AgentV1SettingsAgentListenProvider_V1,
62-
AgentV1SettingsAgentListenProvider_V1Params,
63-
AgentV1SettingsAgentListenProvider_V2,
64-
AgentV1SettingsAgentListenProvider_V2Params,
67+
AgentV1SettingsAgentContextSpeak,
68+
AgentV1SettingsAgentContextSpeakParams,
69+
AgentV1SettingsAgentContextThink,
70+
AgentV1SettingsAgentContextThinkParams,
6571
AgentV1SettingsAgentParams,
66-
AgentV1SettingsAgentSpeak,
67-
AgentV1SettingsAgentSpeakParams,
68-
AgentV1SettingsAgentThink,
69-
AgentV1SettingsAgentThinkParams,
7072
AgentV1SettingsApplied,
7173
AgentV1SettingsAppliedParams,
7274
AgentV1SettingsAudio,
@@ -82,10 +84,18 @@
8284
AgentV1SettingsParams,
8385
AgentV1SpeakUpdated,
8486
AgentV1SpeakUpdatedParams,
87+
AgentV1ThinkUpdated,
88+
AgentV1ThinkUpdatedParams,
8589
AgentV1UpdatePrompt,
8690
AgentV1UpdatePromptParams,
8791
AgentV1UpdateSpeak,
8892
AgentV1UpdateSpeakParams,
93+
AgentV1UpdateSpeakSpeak,
94+
AgentV1UpdateSpeakSpeakParams,
95+
AgentV1UpdateThink,
96+
AgentV1UpdateThinkParams,
97+
AgentV1UpdateThinkThink,
98+
AgentV1UpdateThinkThinkParams,
8999
AgentV1UserStartedSpeaking,
90100
AgentV1UserStartedSpeakingParams,
91101
AgentV1Warning,
@@ -126,33 +136,35 @@
126136
"AgentV1Settings": ".v1",
127137
"AgentV1SettingsAgent": ".v1",
128138
"AgentV1SettingsAgentContext": ".v1",
129-
"AgentV1SettingsAgentContextMessagesItem": ".v1",
130-
"AgentV1SettingsAgentContextMessagesItemContent": ".v1",
131-
"AgentV1SettingsAgentContextMessagesItemContentParams": ".v1",
132-
"AgentV1SettingsAgentContextMessagesItemContentRole": ".v1",
133-
"AgentV1SettingsAgentContextMessagesItemFunctionCalls": ".v1",
134-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItem": ".v1",
135-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItemParams": ".v1",
136-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsParams": ".v1",
137-
"AgentV1SettingsAgentContextMessagesItemParams": ".v1",
139+
"AgentV1SettingsAgentContextContext": ".v1",
140+
"AgentV1SettingsAgentContextContextMessagesItem": ".v1",
141+
"AgentV1SettingsAgentContextContextMessagesItemContent": ".v1",
142+
"AgentV1SettingsAgentContextContextMessagesItemContentParams": ".v1",
143+
"AgentV1SettingsAgentContextContextMessagesItemContentRole": ".v1",
144+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCalls": ".v1",
145+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItem": ".v1",
146+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItemParams": ".v1",
147+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsParams": ".v1",
148+
"AgentV1SettingsAgentContextContextMessagesItemParams": ".v1",
149+
"AgentV1SettingsAgentContextContextParams": ".v1",
150+
"AgentV1SettingsAgentContextListen": ".v1",
151+
"AgentV1SettingsAgentContextListenParams": ".v1",
152+
"AgentV1SettingsAgentContextListenProvider": ".v1",
153+
"AgentV1SettingsAgentContextListenProviderParams": ".v1",
154+
"AgentV1SettingsAgentContextListenProviderV1": ".v1",
155+
"AgentV1SettingsAgentContextListenProviderV1Params": ".v1",
156+
"AgentV1SettingsAgentContextListenProviderV2": ".v1",
157+
"AgentV1SettingsAgentContextListenProviderV2Params": ".v1",
158+
"AgentV1SettingsAgentContextListenProvider_V1": ".v1",
159+
"AgentV1SettingsAgentContextListenProvider_V1Params": ".v1",
160+
"AgentV1SettingsAgentContextListenProvider_V2": ".v1",
161+
"AgentV1SettingsAgentContextListenProvider_V2Params": ".v1",
138162
"AgentV1SettingsAgentContextParams": ".v1",
139-
"AgentV1SettingsAgentListen": ".v1",
140-
"AgentV1SettingsAgentListenParams": ".v1",
141-
"AgentV1SettingsAgentListenProvider": ".v1",
142-
"AgentV1SettingsAgentListenProviderParams": ".v1",
143-
"AgentV1SettingsAgentListenProviderV1": ".v1",
144-
"AgentV1SettingsAgentListenProviderV1Params": ".v1",
145-
"AgentV1SettingsAgentListenProviderV2": ".v1",
146-
"AgentV1SettingsAgentListenProviderV2Params": ".v1",
147-
"AgentV1SettingsAgentListenProvider_V1": ".v1",
148-
"AgentV1SettingsAgentListenProvider_V1Params": ".v1",
149-
"AgentV1SettingsAgentListenProvider_V2": ".v1",
150-
"AgentV1SettingsAgentListenProvider_V2Params": ".v1",
163+
"AgentV1SettingsAgentContextSpeak": ".v1",
164+
"AgentV1SettingsAgentContextSpeakParams": ".v1",
165+
"AgentV1SettingsAgentContextThink": ".v1",
166+
"AgentV1SettingsAgentContextThinkParams": ".v1",
151167
"AgentV1SettingsAgentParams": ".v1",
152-
"AgentV1SettingsAgentSpeak": ".v1",
153-
"AgentV1SettingsAgentSpeakParams": ".v1",
154-
"AgentV1SettingsAgentThink": ".v1",
155-
"AgentV1SettingsAgentThinkParams": ".v1",
156168
"AgentV1SettingsApplied": ".v1",
157169
"AgentV1SettingsAppliedParams": ".v1",
158170
"AgentV1SettingsAudio": ".v1",
@@ -168,10 +180,18 @@
168180
"AgentV1SettingsParams": ".v1",
169181
"AgentV1SpeakUpdated": ".v1",
170182
"AgentV1SpeakUpdatedParams": ".v1",
183+
"AgentV1ThinkUpdated": ".v1",
184+
"AgentV1ThinkUpdatedParams": ".v1",
171185
"AgentV1UpdatePrompt": ".v1",
172186
"AgentV1UpdatePromptParams": ".v1",
173187
"AgentV1UpdateSpeak": ".v1",
174188
"AgentV1UpdateSpeakParams": ".v1",
189+
"AgentV1UpdateSpeakSpeak": ".v1",
190+
"AgentV1UpdateSpeakSpeakParams": ".v1",
191+
"AgentV1UpdateThink": ".v1",
192+
"AgentV1UpdateThinkParams": ".v1",
193+
"AgentV1UpdateThinkThink": ".v1",
194+
"AgentV1UpdateThinkThinkParams": ".v1",
175195
"AgentV1UserStartedSpeaking": ".v1",
176196
"AgentV1UserStartedSpeakingParams": ".v1",
177197
"AgentV1Warning": ".v1",
@@ -236,33 +256,35 @@ def __dir__():
236256
"AgentV1Settings",
237257
"AgentV1SettingsAgent",
238258
"AgentV1SettingsAgentContext",
239-
"AgentV1SettingsAgentContextMessagesItem",
240-
"AgentV1SettingsAgentContextMessagesItemContent",
241-
"AgentV1SettingsAgentContextMessagesItemContentParams",
242-
"AgentV1SettingsAgentContextMessagesItemContentRole",
243-
"AgentV1SettingsAgentContextMessagesItemFunctionCalls",
244-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItem",
245-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsFunctionCallsItemParams",
246-
"AgentV1SettingsAgentContextMessagesItemFunctionCallsParams",
247-
"AgentV1SettingsAgentContextMessagesItemParams",
259+
"AgentV1SettingsAgentContextContext",
260+
"AgentV1SettingsAgentContextContextMessagesItem",
261+
"AgentV1SettingsAgentContextContextMessagesItemContent",
262+
"AgentV1SettingsAgentContextContextMessagesItemContentParams",
263+
"AgentV1SettingsAgentContextContextMessagesItemContentRole",
264+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCalls",
265+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItem",
266+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsFunctionCallsItemParams",
267+
"AgentV1SettingsAgentContextContextMessagesItemFunctionCallsParams",
268+
"AgentV1SettingsAgentContextContextMessagesItemParams",
269+
"AgentV1SettingsAgentContextContextParams",
270+
"AgentV1SettingsAgentContextListen",
271+
"AgentV1SettingsAgentContextListenParams",
272+
"AgentV1SettingsAgentContextListenProvider",
273+
"AgentV1SettingsAgentContextListenProviderParams",
274+
"AgentV1SettingsAgentContextListenProviderV1",
275+
"AgentV1SettingsAgentContextListenProviderV1Params",
276+
"AgentV1SettingsAgentContextListenProviderV2",
277+
"AgentV1SettingsAgentContextListenProviderV2Params",
278+
"AgentV1SettingsAgentContextListenProvider_V1",
279+
"AgentV1SettingsAgentContextListenProvider_V1Params",
280+
"AgentV1SettingsAgentContextListenProvider_V2",
281+
"AgentV1SettingsAgentContextListenProvider_V2Params",
248282
"AgentV1SettingsAgentContextParams",
249-
"AgentV1SettingsAgentListen",
250-
"AgentV1SettingsAgentListenParams",
251-
"AgentV1SettingsAgentListenProvider",
252-
"AgentV1SettingsAgentListenProviderParams",
253-
"AgentV1SettingsAgentListenProviderV1",
254-
"AgentV1SettingsAgentListenProviderV1Params",
255-
"AgentV1SettingsAgentListenProviderV2",
256-
"AgentV1SettingsAgentListenProviderV2Params",
257-
"AgentV1SettingsAgentListenProvider_V1",
258-
"AgentV1SettingsAgentListenProvider_V1Params",
259-
"AgentV1SettingsAgentListenProvider_V2",
260-
"AgentV1SettingsAgentListenProvider_V2Params",
283+
"AgentV1SettingsAgentContextSpeak",
284+
"AgentV1SettingsAgentContextSpeakParams",
285+
"AgentV1SettingsAgentContextThink",
286+
"AgentV1SettingsAgentContextThinkParams",
261287
"AgentV1SettingsAgentParams",
262-
"AgentV1SettingsAgentSpeak",
263-
"AgentV1SettingsAgentSpeakParams",
264-
"AgentV1SettingsAgentThink",
265-
"AgentV1SettingsAgentThinkParams",
266288
"AgentV1SettingsApplied",
267289
"AgentV1SettingsAppliedParams",
268290
"AgentV1SettingsAudio",
@@ -278,10 +300,18 @@ def __dir__():
278300
"AgentV1SettingsParams",
279301
"AgentV1SpeakUpdated",
280302
"AgentV1SpeakUpdatedParams",
303+
"AgentV1ThinkUpdated",
304+
"AgentV1ThinkUpdatedParams",
281305
"AgentV1UpdatePrompt",
282306
"AgentV1UpdatePromptParams",
283307
"AgentV1UpdateSpeak",
284308
"AgentV1UpdateSpeakParams",
309+
"AgentV1UpdateSpeakSpeak",
310+
"AgentV1UpdateSpeakSpeakParams",
311+
"AgentV1UpdateThink",
312+
"AgentV1UpdateThinkParams",
313+
"AgentV1UpdateThinkThink",
314+
"AgentV1UpdateThinkThinkParams",
285315
"AgentV1UserStartedSpeaking",
286316
"AgentV1UserStartedSpeakingParams",
287317
"AgentV1Warning",

0 commit comments

Comments
 (0)