Skip to content

feat!: (regen) breaking flux timestamps req-double + close-stream/hints; diarize_model, profanity#66

Open
GregHolmes wants to merge 7 commits into
mainfrom
gh/sdk-gen-2026-06-15
Open

feat!: (regen) breaking flux timestamps req-double + close-stream/hints; diarize_model, profanity#66
GregHolmes wants to merge 7 commits into
mainfrom
gh/sdk-gen-2026-06-15

Conversation

@GregHolmes

@GregHolmes GregHolmes commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

SDK Regeneration — 2026-06-15

Generated from deepgram-docs branch devin/1781285195-flux-word-timestamps. The Java SDK was last regenerated 2026-05-15 (0.5.0), so this also catches up on doc changes merged since then.

⚠️ Breaking changes

  1. ListenV2CloseStreamtype removed; ListenV2CloseStreamType deleted. getType() is now a fixed "CloseStream" constant and the builder no longer accepts .type(...). Migration: ListenV2CloseStream.builder().build(). (docs #946)
  2. DeepgramListenProviderV2language_hintlanguage_hints. getLanguageHint()getLanguageHints(); type Optional<DeepgramListenProviderV2LanguageHint>Optional<List<String>> (now multi-value); DeepgramListenProviderV2LanguageHint deleted. (docs #856)

On-the-wire payloads are unchanged — these are source/compile-time breaks for SDK users, not protocol breaks.

Additive

  • Flux word timestampsListenV2TurnInfoWordsItem gains start/end as required double (getStart()/getEnd() return double; both are required builder stages). This is the primary change the source branch was for. (generation branch)
  • DiarizeModel (v1/latest), diarize_model on streaming requests; diarize deprecated. (docs #943)
  • ListenV2ProfanityFilter + profanity_filter query param. (docs #912)
  • V1ConnectOptions / V2ConnectOptions added.

Generator plumbing (Fern CLI 5.44.6, docs #940)

  • DateTimeDeserializer now falls back to space-separated timestamps (e.g. "2025-02-15 10:30:00+00:00").
  • WebSocket clients use the headers((RequestOptions) null) overload.
  • A batch of *ListRequest / *GetRequest files churned — javadoc/whitespace only, no signature changes.

Manual patches reconciled

  • core/ClientOptions.java — generator reverted to wrong SDK coordinates (com.deepgram.fern:api-sdk / com.deepgram:deepgram-sdk) and hardcoded 0.5.1, stripping the release-please markers. Restored com.deepgram:deepgram-java-sdk headers + // x-release-please-version markers at 0.5.0.
  • core/ReconnectingWebSocketListener.java — restored in full: maxRetries(0) "connect once, don't retry" (retryCount > maxRetries), configurable connectionTimeoutMs (was hardcoded 4000ms), and the applyOptionsOverride(...) hook used by TransportWebSocketFactory.
  • .fernignore — both paths restored to originals (stay frozen for next cycle); no entries dropped.
  • examples/listen/LiveStreamingV2.java — updated to the new close-stream API (dropped ListenV2CloseStreamType import + .type(...) call). Caught by compileExamples.
  • .bak files deleted.

Verification

./gradlew test compileExamplesBUILD SUCCESSFUL (unit/wire tests, README snippets, and hand-maintained examples all compile).

Release

Two breaking changes → feat! title so release-please cuts a minor bump (0.5.0 → 0.6.0) and owns the CHANGELOG in its own PR.

GregHolmes and others added 4 commits June 15, 2026 12:40
- ClientOptions.java: restore deepgram-java-sdk header constants + x-release-please-version markers (gen reverted to wrong SDK name and hardcoded 0.5.1)
- ReconnectingWebSocketListener.java: re-apply maxRetries(0) semantics, configurable connectionTimeoutMs, and applyOptionsOverride() hook
- .fernignore: restore both original paths (still frozen for next cycle)
- examples/listen/LiveStreamingV2.java: drop deleted ListenV2CloseStreamType; ListenV2CloseStream no longer takes a type
- remove transient .bak files
@GregHolmes GregHolmes changed the title chore: SDK regeneration 2026-06-15 feat!: (regen) flux word timestamps, diarize_model, profanity_filter; breaking v2 close-stream + language_hints Jun 15, 2026
@GregHolmes GregHolmes changed the title feat!: (regen) flux word timestamps, diarize_model, profanity_filter; breaking v2 close-stream + language_hints feat!: (regen) flux word timestamps, diarize_model, profanity_filter; breaking close-stream/hints Jun 15, 2026
@GregHolmes GregHolmes self-assigned this Jun 15, 2026
GregHolmes and others added 3 commits June 16, 2026 09:27
Re-prepare for a second regeneration on this branch (no new branch/PR).
Second regeneration on this branch. Notable generator change: ListenV2TurnInfoWordsItem start/end are now required double (was Optional<Float>).
- ClientOptions.java: restore deepgram-java-sdk header constants + x-release-please-version markers (gen reverted to wrong SDK name / 0.5.1)
- ReconnectingWebSocketListener.java: re-apply maxRetries(0) semantics, configurable connectionTimeoutMs, applyOptionsOverride() hook
- .fernignore: restore both original paths
- remove transient .bak files
@GregHolmes GregHolmes changed the title feat!: (regen) flux word timestamps, diarize_model, profanity_filter; breaking close-stream/hints feat!: (regen) breaking flux timestamps req-double + close-stream/hints; diarize_model, profanity Jun 16, 2026
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.

1 participant