feat(agent): support multi-provider speak/think configuration and typed listen parameters (#676)

## Summary

- **Agent multi-provider TTS**: Configurable speak providers (AWS Polly,
Cartesia, Deepgram, ElevenLabs, OpenAI) with endpoint settings and
runtime updates
- **Agent think restructured**: Multi-provider think settings with
per-item configuration
- **Typed listen parameters**: v1/v2 listen clients now use typed
aliases (`ListenV1Model`, `ListenV2Encoding`, etc.) instead of raw
strings — backward-compatible
- **Native unknown WS message handling**: Generator now includes
try/except with logging across all socket clients
- **Fern generator upgrade**: `4.57.2` → `4.62.0`, CLI `3.77.1` →
`4.46.0`

## Manual patches re-applied

- `float` → `int` type fixes for `speaker`, `channel`, `num_words`
fields (3 type files)
- `_sanitize_numeric_types` helper in agent socket client
- `construct_type` keyword arg fix — generator uses positional args but
function signature is keyword-only
- Broad `except Exception` catch in socket clients to support custom
transports

## Known issues

- 1 wire test failure (`test_manage_v1_projects_requests_list_`): Fern
datetime serialization drops milliseconds, mismatching its own WireMock
stub — Fern generator bug, not SDK

## Test plan

- [x] `ruff check` passes
- [x] `mypy` passes (844 source files)
- [x] 72 custom tests pass
- [x] 28/29 wire tests pass (1 Fern datetime bug)

---------

Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>

Author: lukeocodes

.fern/metadata.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "3.77.1",
+  "cliVersion": "4.46.0",
   "generatorName": "fernapi/fern-python-sdk",
-  "generatorVersion": "4.57.2",
+  "generatorVersion": "4.62.0",
   "generatorConfig": {
     "client": {
       "class_name": "BaseClient",
@@ -16,5 +16,6 @@
       "skip_validation": true
     }
   },
-  "sdkVersion": "6.0.1"
+  "originGitCommit": "879c76c78827f323e425c1640f76a6e50d6c68d3",
+  "sdkVersion": "6.0.2"
 }

.fernignore

@@ -4,36 +4,22 @@
 # This file is manually maintained and should not be regenerated
 src/deepgram/client.py
 
-# WireMock mappings: removed duplicate empty-body /v1/listen stub that causes
-# non-deterministic matching failures
-wiremock/wiremock-mappings.json
-
-# Wire test with manual fix: transcribe_file() requires request=bytes parameter
-tests/wire/test_listen_v1_media.py
-
 # WebSocket socket clients:
-# - Optional message parameter defaults for send_flush, send_close, send_clear,
-#   send_finalize, send_close_stream, send_keep_alive
-# - construct_type instead of parse_obj_as (skip_validation for unknown WS messages)
-# - except Exception (broad catch for custom transports)
+# - construct_type keyword args fix (generator uses positional, function requires keyword-only)
+# - except Exception broad catch (supports custom transports, generator narrows to WebSocketException)
 # - _sanitize_numeric_types in agent socket client (float→int for API)
-src/deepgram/speak/v1/socket_client.py
+# [temporarily frozen — generator bugs in construct_type call convention and exception handling]
+src/deepgram/agent/v1/socket_client.py
 src/deepgram/listen/v1/socket_client.py
 src/deepgram/listen/v2/socket_client.py
-src/deepgram/agent/v1/socket_client.py
+src/deepgram/speak/v1/socket_client.py
 
 # Type files with manual int type corrections (Fern generates float for speaker/channel/num_words)
+# [temporarily frozen — waiting on internal-api-specs#205]
 src/deepgram/types/listen_v1response_results_utterances_item.py
 src/deepgram/types/listen_v1response_results_utterances_item_words_item.py
 src/deepgram/types/listen_v1response_results_channels_item_alternatives_item_paragraphs_paragraphs_item.py
 
-# Redact type with Union[str, Sequence[str]] support (Fern narrows to Union[Literal, Any])
-src/deepgram/types/listen_v1redact.py
-
-# Listen client files with Union[str, Sequence[str]] array param support
-src/deepgram/listen/v1/client.py
-src/deepgram/listen/v2/client.py
-
 # Hand-written custom tests
 tests/custom/test_text_builder.py
 tests/custom/test_transport.py
@@ -75,4 +61,4 @@ AGENTS.md
 # Folders to ignore
 .github
 docs
-examples
+examples

poetry.lock

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "deepgram-sdk"
-version = "6.0.1"
+version = "6.0.2"
 description = ""
 readme = "README.md"
 authors = []