feat(regen)!: flux stt numerals + aura-2 voices; remove AgentV1LatencyReport.stt_latency - #78
Merged
Merged
Conversation
GregHolmes
requested review from
deepgram-kiley and
dg-coreylweathers
as code owners
July 20, 2026 09:57
dg-coreylweathers
approved these changes
Jul 21, 2026
dg-coreylweathers
left a comment
Contributor
There was a problem hiding this comment.
Verified: build gate (81 tests, 0 failures) + live numerals behavior (23 / 5 5 5 1 2 3 4 with numerals=true, spelled-out without). Approving; S1 (metadata.json 0.6.2) and the Java/Python changelog divergence are non-blocking.
GregHolmes
pushed a commit
that referenced
this pull request
Jul 22, 2026
🤖 I have created a release *beep* *boop* --- ## [0.7.0](v0.6.1...v0.7.0) (2026-07-22) ### ⚠ BREAKING CHANGES * **regen:** flux stt numerals + aura-2 voices; remove AgentV1LatencyReport.stt_latency ([#78](#78)) ### Features * **regen:** flux stt numerals + aura-2 voices; remove AgentV1LatencyReport.stt_latency ([#78](#78)) ([5cafdac](5cafdac)) #### What's in this release SDK regeneration for the **2026-07-20** Fern run (java-sdk generator `4.10.1`, CLI `5.44.6`, spec `ff8fd2b7`). **⚠ Breaking: `AgentV1LatencyReport.getSttLatency()` removed** - The API spec removed `stt_latency` from the LatencyReport schema (docs #1006). The `getSttLatency()` getter, the `sttLatency(...)` builder methods, and the constructor arg are gone. - `AgentV1LatencyReport` is a **server-emitted, read-only** message, so there is **no request/wire impact** — but this is **source-breaking** for any caller of `getSttLatency()`. Any inbound `stt_latency` now lands in `additionalProperties` rather than a typed getter. - Unlike the Python SDK (which re-added the field as a read-side compat shim), the Java 0.x line permits breaking changes across minor bumps (precedent: #66 → 0.6.0), so the removal is accepted here and shipped as a **minor** bump. - Migration guide: `docs/Migrating-v0.6-to-v0.7.md` (before/after), linked from the README. **Flux STT `numerals` (additive)** - New `types/ListenV2Numerals.java` (`true` / `false`, forward-compatible enum) plus a `numerals` query param on `listen().v2().v2WebSocket().connect(...)` via the new `V2ConnectOptions`. Connection-time only. - New wire test `ListenV2ConnectWireTest.java` pins that `/v2/listen` serializes `numerals=true` when set and omits it when absent (the handshake previously had no wire test). Demonstrated in `examples/listen/LiveStreamingV2.java`. **New Aura-2 multilingual TTS voices (additive)** - `SpeakV1Model` and `AudioGenerateRequestModel` each grow 63 → 103 constants (es / de / nl / fr / it / ja). Zero removed constants/enum members. #### Verification - `./gradlew test compileExamples` — **BUILD SUCCESSFUL**: 81 tests, 0 failures, 0 errors, 1 skipped; examples compile. - Numerals verified end-to-end against the live API: identical Flux input rendered digits with `numerals=true` and spelled-out words without it. --- 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
SDK regeneration for the 2026-07-20 Fern generator run (java-sdk generator 4.10.1, CLI 5.44.6, spec
ff8fd2b7). Targets a 0.7.0 minor release.⚠ BREAKING CHANGE
AgentV1LatencyReport.getSttLatency()removed (plus thesttLatency(...)builder methods and constructor arg). The API spec removedstt_latencyfrom the LatencyReport schema (deepgram-docs #1006).AgentV1LatencyReportis a server-emitted, read-only message, so there is no request/wire impact — but this is source-breaking for any caller ofgetSttLatency(). Inboundstt_latency(if a server ever sends it) now lands inadditionalPropertiesrather than a typed getter.!in the commit type.Features (additive)
numerals— newtypes/ListenV2Numerals.java(true/false, forward-compatible enum) plus anumeralsquery param onlisten().v2().v2WebSocket().connect(...)via the newV2ConnectOptions. Connection-time only.src/test/java/com/deepgram/ListenV2ConnectWireTest.javapins that/v2/listenserializesnumerals=truewhen set and omits it when absent (the handshake previously had no wire test). Demonstrated inexamples/listen/LiveStreamingV2.java.SpeakV1ModelandAudioGenerateRequestModeleach grow 63 → 103 constants (es/de/nl/fr/it/ja). Additive only; zero removed constants/enum members.Documentation
docs/Migrating-v0.6-to-v0.7.md— migration guide covering thestt_latencyremoval (with before/after) plus the additive numerals + Aura-2 voice features.Manual patches reconciled
All 15 previously-frozen patches were still needed and re-applied byte-identical to
main(the behavioral files do not appear in the netmain...HEADdiff):ClientOptions(SDK identity + release-please markers, held at 0.6.1 for release-please to bump),ReconnectingWebSocketListener, bothV2WebSocketClientforward-compat no-ops, and 11 fields-lesshashCode()fixes. The listenV2WebSocketClientre-apply preserved the generator’s newnumeralsblock. All.bakfiles deleted;AgentV1LatencyReportleft unfrozen (generator-owned).Generator input
originGitCommit:ff8fd2b74fdd5c081e9f111d59d3619f7e286dd8,originGitCommitIsDirty: true— this regen was cut from an uncommitted API-definition state. Verified: thestt_latencyremoval is an intentional schema change (deepgram-docs #1006, merged 2026-07-14) and is an ancestor offf8fd2b7, so it is in the regen’s committed spec base — the dirty flag reflects other uncommitted working-tree changes, not this removal. Note any spec change after this commit forces a re-regen.Verification
./gradlew test compileExamples— BUILD SUCCESSFUL: 81 tests, 0 failures, 0 errors, 1 skipped (incl. forward-compat, reconnect, hashCode, and new numerals wire guards); examples compile.numerals=true(23,5 5 5 1 2 3 4) and spelled-out words without it.