fix: (regen) route think/models to env.agentRest (#59)

## Summary
SDK regeneration 2026-05-15. Both temporarily frozen files reviewed;
both patches re-applied (no patches dropped this cycle).

## Patches re-applied
- `src/main/java/com/deepgram/core/ClientOptions.java` — restored
correct `User-Agent` / `X-Fern-SDK-Name`
(`com.deepgram:deepgram-java-sdk`, version `0.4.0`) and the `//
x-release-please-version` markers. Generator regen still rewrites these
to the wrong artifact id (`com.deepgram:deepgram-sdk` /
`com.deepgram.fern:api-sdk`) and strips the markers.
- `src/main/java/com/deepgram/core/ReconnectingWebSocketListener.java` —
restored `applyOptionsOverride(...)` runtime hook (used by
`TransportWebSocketFactory` to apply
`DeepgramTransportFactory.reconnectOptions()` without editing generated
WS clients), `volatile` qualifier on option-derived fields, configurable
`connectionTimeoutMs` on `ReconnectOptions` (was hardcoded 4000ms), and
the `maxRetries(0)` "connect once, don't retry" semantics (`retryCount >
maxRetries`, not `>=`).

## Generator changes worth flagging
- `Environment` constructor signature changed from 3-arg to 4-arg with a
new `agentRest` field, plus `getAgentRestURL()` and
`Environment.Builder#agentRest(...)`.
-
`resources/agent/v1/settings/think/models/{Raw,AsyncRaw}ModelsClient.java`
now route via `environment().getAgentRestURL()` instead of
`getAgentURL()`.
- `.fern/metadata.json` bumped `sdkVersion: 0.4.1`.

## `Environment` change — intentional fix, not a break
The regen drops `Environment.AGENT` and adds a new `agentRest` slot to
`Environment` (with a 4-arg constructor and corresponding builder
method). This is fixing the previously broken
`agent.v1.settings.think.models.list()` route: the old `.AGENT` env
routed REST traffic to the wrong host, so any caller of that endpoint
was already broken. The new `agentRest` slot is the dedicated REST host
for agent-served endpoints.

Equivalent fix in Python SDK: deepgram/deepgram-python-sdk#715. JS SDK
equivalent (deepgram-js-sdk#499) additionally needed a `src/Client.ts`
patch because `client.fetch()` passthrough started defaulting to
`agentRest` instead of `base`. The Java SDK has no equivalent
passthrough in the hand-maintained
`DeepgramClient`/`DeepgramClientBuilder`, so no analogous patch is
needed here.

Hand-maintained tests that referenced `Environment.AGENT`
(`EnvironmentTest`'s `AGENT environment` nested class and
`ClientBuilderTest#testAgentEnvironment`) were updated to build an
agent-shaped environment via `Environment.custom().agentRest(...)`.

## Validation
- `./gradlew test compileExamples` → BUILD SUCCESSFUL
- `ReconnectingWebSocketListenerTest` covers the re-applied patches:
`applyOptionsOverride`, `maxRetries(0)` initial-attempt allowance,
`connectionTimeoutMs` configurability — all green
- All `.bak` files deleted; `.fernignore` paths restored to originals
for both still-patched files

## Test plan
- [x] Re-apply manual patches after regen.
- [x] Restore `.fernignore` originals; drop `.bak` shadow paths.
- [x] Delete all `.bak` files.
- [x] `./gradlew test compileExamples` validated.

---------

Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>

Author: GregHolmes

.fern/metadata.json

@@ -11,7 +11,7 @@
     },
     "enable-wire-tests": true
   },
-  "originGitCommit": "0052a020a7becd03b349857664c9f4a89b6c449a",
+  "originGitCommit": "d228f82e93aaa8aa77f978d458cf912f3daaa8c1",
   "originGitCommitIsDirty": true,
   "invokedBy": "manual",
   "sdkVersion": "0.4.1"

src/main/java/com/deepgram/core/Environment.java

@@ -4,22 +4,25 @@
 package com.deepgram.core;
 
 public final class Environment {
-    public static final Environment PRODUCTION =
-            new Environment("https://api.deepgram.com", "wss://api.deepgram.com", "wss://agent.deepgram.com");
-
-    public static final Environment AGENT =
-            new Environment("https://agent.deepgram.com", "wss://api.deepgram.com", "wss://agent.deepgram.com");
+    public static final Environment PRODUCTION = new Environment(
+            "https://api.deepgram.com",
+            "wss://api.deepgram.com",
+            "wss://agent.deepgram.com",
+            "https://agent.deepgram.com");
 
     private final String base;
 
     private final String production;
 
     private final String agent;
 
-    Environment(String base, String production, String agent) {
+    private final String agentRest;
+
+    Environment(String base, String production, String agent, String agentRest) {
         this.base = base;
         this.production = production;
         this.agent = agent;
+        this.agentRest = agentRest;
     }
 
     public String getBaseURL() {
@@ -34,6 +37,10 @@ public String getAgentURL() {
         return this.agent;
     }
 
+    public String getAgentRestURL() {
+        return this.agentRest;
+    }
+
     public static Builder custom() {
         return new Builder();
     }
@@ -45,6 +52,8 @@ public static class Builder {
 
         private String agent;
 
+        private String agentRest;
+
         public Builder base(String base) {
             this.base = base;
             return this;
@@ -60,8 +69,13 @@ public Builder agent(String agent) {
             return this;
         }
 
+        public Builder agentRest(String agentRest) {
+            this.agentRest = agentRest;
+            return this;
+        }
+
         public Environment build() {
-            return new Environment(base, production, agent);
+            return new Environment(base, production, agent, agentRest);
         }
     }
 }

src/main/java/com/deepgram/resources/agent/v1/settings/think/models/AsyncRawModelsClient.java

@@ -42,7 +42,7 @@ public CompletableFuture<DeepgramApiHttpResponse<AgentThinkModelsV1Response>> li
      * Retrieves the available think models that can be used for AI agent processing
      */
     public CompletableFuture<DeepgramApiHttpResponse<AgentThinkModelsV1Response>> list(RequestOptions requestOptions) {
-        HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getAgentURL())
+        HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getAgentRestURL())
                 .newBuilder()
                 .addPathSegments("v1/agent/settings/think/models");
         if (requestOptions != null) {

src/main/java/com/deepgram/resources/agent/v1/settings/think/models/RawModelsClient.java

@@ -38,7 +38,7 @@ public DeepgramApiHttpResponse<AgentThinkModelsV1Response> list() {
      * Retrieves the available think models that can be used for AI agent processing
      */
     public DeepgramApiHttpResponse<AgentThinkModelsV1Response> list(RequestOptions requestOptions) {
-        HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getAgentURL())
+        HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getAgentRestURL())
                 .newBuilder()
                 .addPathSegments("v1/agent/settings/think/models");
         if (requestOptions != null) {

src/test/java/com/deepgram/ClientBuilderTest.java

@@ -47,11 +47,18 @@ void testDefaultEnvironment() {
         }
 
         @Test
-        @DisplayName("accepts AGENT environment")
+        @DisplayName("accepts an agent-shaped environment")
         void testAgentEnvironment() {
+            Environment agent = Environment.custom()
+                    .base("https://agent.deepgram.com")
+                    .agent("wss://agent.deepgram.com")
+                    .production("wss://api.deepgram.com")
+                    .agentRest("https://agent.deepgram.com")
+                    .build();
+
             DeepgramClient client = DeepgramClient.builder()
                     .apiKey("test-key")
-                    .environment(Environment.AGENT)
+                    .environment(agent)
                     .build();
 
             assertThat(client).isNotNull();

src/test/java/com/deepgram/core/EnvironmentTest.java

@@ -33,25 +33,34 @@ void testProductionUrl() {
     }
 
     @Nested
-    @DisplayName("AGENT environment")
+    @DisplayName("Agent-shaped custom environment")
     class AgentEnvironment {
 
+        private Environment agent() {
+            return Environment.custom()
+                    .base("https://agent.deepgram.com")
+                    .agent("wss://agent.deepgram.com")
+                    .production("wss://api.deepgram.com")
+                    .agentRest("https://agent.deepgram.com")
+                    .build();
+        }
+
         @Test
         @DisplayName("base URL points to agent.deepgram.com")
         void testBaseUrl() {
-            assertThat(Environment.AGENT.getBaseURL()).isEqualTo("https://agent.deepgram.com");
+            assertThat(agent().getBaseURL()).isEqualTo("https://agent.deepgram.com");
         }
 
         @Test
         @DisplayName("agent URL points to wss://agent.deepgram.com")
         void testAgentUrl() {
-            assertThat(Environment.AGENT.getAgentURL()).isEqualTo("wss://agent.deepgram.com");
+            assertThat(agent().getAgentURL()).isEqualTo("wss://agent.deepgram.com");
         }
 
         @Test
         @DisplayName("production URL uses wss://api.deepgram.com")
         void testProductionUrl() {
-            assertThat(Environment.AGENT.getProductionURL()).isEqualTo("wss://api.deepgram.com");
+            assertThat(agent().getProductionURL()).isEqualTo("wss://api.deepgram.com");
         }
     }