chore(main): release 0.5.0

[github-actions]

🤖 I have created a release beep boop

0.5.0 — what's in this release

This release bundles two Fern SDK regenerations (2026-05-14 and 2026-05-15) plus the manual patches re-applied on top of each.

See the full changelog: v0.4.0...v0.5.0.

⚠ Breaking changes

Environment constructor signature changed (3-arg → 4-arg) — #57 + #59

• New agentRest field, getAgentRestURL() getter, and Environment.Builder#agentRest(...) builder method.
• Environment.AGENT was dropped in favor of the dedicated agentRest REST host.
• This fixes a previously broken route: agent.v1.settings.think.models.list() now correctly targets env.agentRest instead of getAgentURL(). Any caller of that endpoint was already broken before; this is a corrective break.
• Callers building a custom Environment must add the new agentRest(...) slot via Environment.custom().

Listen-provider type refactor — #57

• AgentV1SettingsAgentContextListenProvider{V1, V2, V2LanguageHint} deleted in favor of canonical top-level types DeepgramListenProviderV1, DeepgramListenProviderV2, DeepgramListenProviderV2LanguageHint.
• AgentV1SettingsAgentListenProvider{V1, V2} subtypes also deleted (~958 lines removed across the two wrapper hierarchies, deduped against the canonical top-level types). The sealed-type wrappers AgentV1SettingsAgentContextListenProvider and AgentV1SettingsAgentListenProvider remain.

Features

Diarization v2 batch GA — #57

• New listen/media request types: ListenV1RequestUrl, MediaTranscribeRequestOctetStream, MediaTranscribeRequestDiarizeModel.
• AsyncRawMediaClient / RawMediaClient updated to surface the new diarize-model and octet-stream request paths.

Bug fixes

think/models routed to agentRest — #59

• RawModelsClient and AsyncRawModelsClient (under agent/v1/settings/think/models/) now resolve their base URL via environment().getAgentRestURL() instead of getAgentURL(). (Same root cause as the breaking change above.)

Patches preserved through regen

Both regens re-applied the same hand-maintained patches (still listed in .fernignore):

• ClientOptions — restored SDK identity headers (User-Agent, X-Fern-SDK-Name, X-Fern-SDK-Version) to the com.deepgram:deepgram-java-sdk values and re-added // x-release-please-version markers. Generator still overwrites these to the wrong artifact id (com.deepgram:deepgram-sdk / com.deepgram.fern:api-sdk) and strips the markers.
• ReconnectingWebSocketListener — re-applied the three fixes originally landed in fix(reconnect): listener bug fixes + transport factory policy hook #45:
  1. maxRetries(0) semantics: retryCount > maxRetries (initial connect attempt always proceeds; the cap applies only to retries).
  2. Configurable connectionTimeoutMs on ReconnectOptions (nested in the same file; default 4000 ms, previously hardcoded).
  3. applyOptionsOverride(...) runtime hook used by TransportWebSocketFactory to apply per-transport reconnect policy from DeepgramTransportFactory without editing generated WS clients.
  4. volatile qualifier on option-derived fields.

No patches were dropped this cycle — the generator has not caught up on any of the above.

Validation

• ./gradlew test compileExamples — BUILD SUCCESSFUL on both regen PRs.
• ReconnectingWebSocketListenerTest covers the re-applied WS patches.
• EnvironmentTest and ClientBuilderTest updated to build agent-shaped environments via Environment.custom().agentRest(...).

Cross-SDK reference

The agentRest env fix has equivalents in deepgram/deepgram-python-sdk#715 and deepgram/deepgram-js-sdk#499. The JS SDK additionally needed a client.fetch() passthrough patch; Java has no equivalent passthrough in DeepgramClient / DeepgramClientBuilder, so no analogous patch was required here.

---

This PR was generated with Release Please. See documentation.

[github-actions]

🤖 Created releases:

• v0.5.0

🌻