Repository navigation
feat(regen): add nova-3 multilingual Listen V1 support - #813
Conversation
|
…ter rollout Replace the date-relative "rollout is expected later today" note with a stable description of what `language_hint` does (biases, does not restrict, applies only with `language="multi"`), point single-language callers at `en-US`, and read `languages` / `languages_hinted` as the typed Optional fields they are.
…ation The sync and async `send_raw` docstrings lost the notes that JSON strings are forwarded unchanged (for protocol-transparent bridges) and that whole-number floats are not converted to ints. Restore both from main, plus the issue reference on `_sanitize_numeric_types`.
dg-coreylweathers
left a comment
There was a problem hiding this comment.
Approving the content. Hold the merge until production serves the Nova-3 Mega model and deepgram-docs #1288 merges.
What this PR does. Regenerates the SDK from docs #1288 (3063c73): optional language_hint (str | sequence) on Listen V1 REST and connect, sync and async; Optional languages / languages_hinted / words[].language; drops the hand-written Configure bridge for Fern's native models with every import path preserved.
What I checked.
- Does production accept
language_hinttoday? No: 400INVALID_QUERY_PARAMETERnamingen, esas unsupported. Staging returns 200 withlanguages_hinted: ["en","es"]. That is the merge gate; re-run one REST request withlanguage_hint=en&language_hint=esagainst production before merging. - Does this build work against staging? Yes: REST URL + file, list and scalar hints, streaming hints on interim and final results, typed
ListenV1ConfigureSuccess. - Gate in Docker (
python:3.12, poetry 1.8.5, WireMock on the host): mypy clean onsrc/andtests/typecheck; 1,115 passed, 4 skipped, 94.64% coverage. - Additive only; every Configure export still at the same three import paths;
V1SocketClientResponsekeeps all members; new fieldsOptional[...] = None/NotRequired; repeated-key encoding tested on REST and WS; all frozen patches present.
Fixed in 60dae8e and 6617b2a (pushed to this branch). The advanced-options example said the rollout was "expected later today"; replaced with a stable note on what language_hint does and switched the getattr reads to the typed fields. The sync and async send_raw docstrings in agent/v1/socket_client.py lost the JSON-passthrough and whole-number-float notes during reconciliation; restored from main.
Follow-up, not a block (pre-existing): core/websocket_compat.py imports InvalidStatusCode first, which websockets 13+ still exports as the legacy class, so on the lockfile's websockets 16.1.1 a refused upgrade escapes as raw websockets.exceptions.InvalidStatus instead of ApiError. That is exactly the error a pre-rollout language_hint attempt produces. Prefer InvalidStatus in a separate PR and flag it to Fern.
Nit: the description says .fernignore adds pydantic_utilities.py; it was already frozen on main.
🤖 I have created a release *beep* *boop* --- ## [7.15.0](v7.14.0...v7.15.0) (2026-10-23) ### Features * **Listen V1 / Nova-3 multilingual:** Add optional language_hint support for synchronous and asynchronous URL/file transcription and WebSocket connections. Pass one BCP-47 hint as a string or several as a list; hints bias detection when model=nova-3 and language=multi. Transcription alternatives now expose typed languages and normalized languages_hinted fields, with per-word and utterance language metadata. ([#813](#813)) ([b474446](b474446)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Greg Holmes <greg.holmes@deepgram.com>
Summary
Validation
Full-repository Ruff retains existing generated/manual-example violations outside this reconciliation.