Skip to content

feat(regen): add nova-3 multilingual Listen V1 support - #813

Merged
GregHolmes merged 8 commits into
mainfrom
gh/sdk-gen-2026-10-23
Oct 23, 2026
Merged

GregHolmes merged 8 commits into
mainfrom
gh/sdk-gen-2026-10-23

Conversation

@GregHolmes

@GregHolmes GregHolmes commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Regenerated the Python SDK from the Nova-3 multilingual API-spec branch.
  • Reapplied required transport, compatibility, security, query-encoding, compatibility-export, and wire-coverage patches.
  • Restored coverage artifact ignores.
  • Dropped the manual Listen V1 Configure bridge: Fern now generates its models, Params, exports, response union, and ListenV1ConfigureFailureCode natively.
  • Added Nova-3 multilingual coverage for scalar/list hints across public and raw REST/WebSocket clients, barrel/type exports, Configure failure codes, and typed response fields.
  • Updated the Nova-3 advanced example with rollout-gated multilingual guidance.
  • Restored version markers to 7.14.0 so Release Please owns the feature-release bump.

Validation

  • Full pytest suite with coverage: 1115 passed, 4 skipped, 94.64% coverage.
  • mypy passed for src and tests/typecheck.
  • Ruff passed for reconciliation changes.
  • Poetry lock validation passed.
  • The source docs branch includes the canonical Nova language-prompting page; public docs deployment remains a rollout gate.

Full-repository Ruff retains existing generated/manual-example violations outside this reconciliation.

@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Code Coverage

Package Line Rate Branch Rate Complexity Health
src.deepgram 97% 94% 0 ✔
src.deepgram.agent 100% 100% 0 ✔
src.deepgram.agent.v1 98% 100% 0 ✔
src.deepgram.agent.v1.settings 100% 100% 0 ✔
src.deepgram.agent.v1.settings.think 100% 100% 0 ✔
src.deepgram.agent.v1.settings.think.models 97% 100% 0 ✔
src.deepgram.auth 100% 100% 0 ✔
src.deepgram.auth.v1 100% 100% 0 ✔
src.deepgram.auth.v1.tokens 97% 100% 0 ✔
src.deepgram.core 88% 81% 0 ➖
src.deepgram.errors 100% 100% 0 ✔
src.deepgram.helpers 98% 92% 0 ✔
src.deepgram.listen 100% 100% 0 ✔
src.deepgram.listen.v1 98% 93% 0 ✔
src.deepgram.listen.v1.media 97% 100% 0 ✔
src.deepgram.listen.v2 98% 93% 0 ✔
src.deepgram.manage 100% 100% 0 ✔
src.deepgram.manage.v1 100% 100% 0 ✔
src.deepgram.manage.v1.models 96% 100% 0 ✔
src.deepgram.manage.v1.projects 97% 100% 0 ✔
src.deepgram.manage.v1.projects.billing 100% 100% 0 ✔
src.deepgram.manage.v1.projects.billing.balances 96% 100% 0 ✔
src.deepgram.manage.v1.projects.billing.breakdown 97% 100% 0 ✔
src.deepgram.manage.v1.projects.billing.fields 97% 100% 0 ✔
src.deepgram.manage.v1.projects.billing.purchases 97% 100% 0 ✔
src.deepgram.manage.v1.projects.keys 96% 100% 0 ✔
src.deepgram.manage.v1.projects.members 97% 100% 0 ✔
src.deepgram.manage.v1.projects.members.invites 96% 100% 0 ✔
src.deepgram.manage.v1.projects.members.scopes 96% 100% 0 ✔
src.deepgram.manage.v1.projects.models 96% 100% 0 ✔
src.deepgram.manage.v1.projects.usage 98% 100% 0 ✔
src.deepgram.manage.v1.projects.usage.breakdown 97% 100% 0 ✔
src.deepgram.manage.v1.projects.usage.fields 97% 100% 0 ✔
src.deepgram.read 100% 100% 0 ✔
src.deepgram.read.v1 100% 100% 0 ✔
src.deepgram.read.v1.text 98% 100% 0 ✔
src.deepgram.self_hosted 100% 100% 0 ✔
src.deepgram.self_hosted.v1 100% 100% 0 ✔
src.deepgram.self_hosted.v1.distribution_credentials 96% 100% 0 ✔
src.deepgram.speak 100% 100% 0 ✔
src.deepgram.speak.v1 98% 97% 0 ✔
src.deepgram.speak.v1.audio 91% 80% 0 ✔
src.deepgram.speak.v2 98% 93% 0 ✔
src.deepgram.speak.v2.audio 100% 100% 0 ✔
src.deepgram.voice_agent 100% 100% 0 ✔
src.deepgram.voice_agent.configurations 95% 100% 0 ✔
src.deepgram.voice_agent.variables 95% 100% 0 ✔
Summary 95% (6560 / 6877) 91% (1438 / 1574) 0 ✔

Scope: hand-maintained SDK logic. Fern-generated data models (types/, requests/), package __init__.py files, version.py, and the unused core/http_sse/ scaffolding are excluded — see .coveragerc. Unscoped whole-package coverage is ~70%.

@GregHolmes GregHolmes changed the title chore: sdk regeneration 2026-10-23 feat(regen): add nova-3 multilingual language hints Oct 23, 2026
@GregHolmes GregHolmes changed the title feat(regen): add nova-3 multilingual language hints feat(regen): add nova-3 multilingual Listen V1 support Oct 23, 2026
…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 dg-coreylweathers left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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_hint today? No: 400 INVALID_QUERY_PARAMETER naming en, es as unsupported. Staging returns 200 with languages_hinted: ["en","es"]. That is the merge gate; re-run one REST request with language_hint=en&language_hint=es against 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 on src/ and tests/typecheck; 1,115 passed, 4 skipped, 94.64% coverage.
  • Additive only; every Configure export still at the same three import paths; V1SocketClientResponse keeps all members; new fields Optional[...] = 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.

@GregHolmes
GregHolmes merged commit b474446 into main Oct 23, 2026
10 checks passed
@GregHolmes
GregHolmes deleted the gh/sdk-gen-2026-10-23 branch October 23, 2026 11:53
GregHolmes added a commit that referenced this pull request Oct 23, 2026
🤖 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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants