feat!: sdk regeneration 2026-04-29 (#47)

## Summary
- Regenerate the Java SDK with the latest Fern output and re-apply the
remaining manual patch to
`src/main/java/com/deepgram/core/ClientOptions.java`.
- Preserve repo-owned docs during regen by freezing `docs/` in
`.fernignore`, and add `README.md` to release-please config so future
version bumps update README dependency snippets automatically.
- Refresh README examples and build metadata so snippet validation
passes in both Gradle and Maven, including adding the SageMaker test
dependency to `pom.xml`.
## Breaking Changes
- Rename public agent history types:
  - `AgentV1HistoryContent` -> `ConversationHistoryMessage`
  - `AgentV1HistoryFunctionCalls` -> `FunctionCallHistoryMessage`
- `AgentV1SettingsAgentContextMessagesItemContent` ->
`ConversationHistoryMessage`
- `AgentV1SettingsAgentContextMessagesItemFunctionCalls` ->
`FunctionCallHistoryMessage`
- Rename public management request type:
  - `CreateKeyV1RequestOne` -> `CreateKeyV1Request`
- These changes affect public method signatures on `AgentV1History`,
`AgentV1SettingsAgentContextMessagesItem`, and project key creation
clients, so downstream Java consumers may need import and type updates.
## Additional Changes
- Add `AgentV1InjectAgentMessage.behavior` and
`AgentV1InjectAgentMessageBehavior`.
- Add `ListenV2LanguageHint` and `V2ConnectOptions.languageHint`.
- Update README dependency versions to `0.3.0`, fix the API docs link,
and clarify custom endpoint configuration for REST and WebSocket usage.
## Validation
- `./gradlew unitTest compileExamples`
- `./gradlew test compileExamples`
- `mvn test`

---------

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

Author: GregHolmes

.fern/metadata.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "4.92.0",
+  "cliVersion": "4.107.0",
   "generatorName": "fernapi/fern-java-sdk",
-  "generatorVersion": "4.6.1",
+  "generatorVersion": "4.6.2",
   "generatorConfig": {
     "package-prefix": "com.deepgram",
     "base-api-exception-class-name": "DeepgramHttpException",
@@ -11,8 +11,8 @@
     },
     "enable-wire-tests": true
   },
-  "originGitCommit": "0d16d3b0d2f3da69dc058ea78f235b2b11288371",
+  "originGitCommit": "05bd7add608b322a6278fa20da22f2ed501d50ef",
   "originGitCommitIsDirty": true,
   "invokedBy": "manual",
-  "sdkVersion": "0.3.0"
+  "sdkVersion": "0.3.1"
 }

.fernignore

@@ -33,6 +33,7 @@ README.md
 CHANGELOG.md
 CONTRIBUTING.md
 LICENSE
+docs/
 
 # Tests (manually maintained)
 src/test/

.github/release-please-config.json

@@ -19,6 +19,10 @@
           "type": "generic",
           "path": "build.gradle"
         },
+        {
+          "type": "generic",
+          "path": "README.md"
+        },
         {
           "type": "json",
           "path": ".fern/metadata.json",

AGENTS.md

@@ -27,7 +27,7 @@ Current permanently frozen files:
 - `src/main/java/com/deepgram/DeepgramClient.java`, `src/main/java/com/deepgram/AsyncDeepgramClient.java`, `src/main/java/com/deepgram/DeepgramClientBuilder.java`, `src/main/java/com/deepgram/AsyncDeepgramClientBuilder.java` - custom wrapper entrypoints that add Bearer auth, session ID support, and custom transport behavior on top of Fern's generated API client
 - `src/main/java/com/deepgram/core/transport/` - hand-written transport abstraction
 - `build.gradle`, `settings.gradle`, `gradle/`, `gradlew`, `gradlew.bat`, `pom.xml`, `Makefile` - build and project configuration
-- `README.md`, `CHANGELOG.md`, `CONTRIBUTING.md`, `LICENSE` - docs
+- `README.md`, `CHANGELOG.md`, `CONTRIBUTING.md`, `LICENSE`, `docs/` - docs
 - `src/test/` - manually maintained tests
 - `examples/` - manually maintained examples
 - `.editorconfig`, `.githooks/`, `.github/`, `.gitignore` - repo and CI configuration

README.md

@@ -26,7 +26,7 @@ Add the dependency to your `build.gradle`:
 
 ```groovy
 dependencies {
-    implementation 'com.deepgram:deepgram-java-sdk:0.2.1' // x-release-please-version
+    implementation 'com.deepgram:deepgram-java-sdk:0.3.0' // x-release-please-version
 }
 ```
 
@@ -38,7 +38,7 @@ Add the dependency to your `pom.xml`:
 <dependency>
     <groupId>com.deepgram</groupId>
     <artifactId>deepgram-java-sdk</artifactId>
-    <version>0.2.1</version> <!-- x-release-please-version -->
+    <version>0.3.0</version> <!-- x-release-please-version -->
 </dependency>
 ```
 
@@ -405,7 +405,7 @@ Use the separate [`deepgram-sagemaker`](https://github.com/deepgram/deepgram-jav
 
 ```groovy
 dependencies {
-    implementation 'com.deepgram:deepgram-java-sdk:0.2.1' // x-release-please-version
+    implementation 'com.deepgram:deepgram-java-sdk:0.3.0' // x-release-please-version
     implementation 'com.deepgram:deepgram-sagemaker:0.1.2'
 }
 ```
@@ -507,15 +507,17 @@ DeepgramClient client = DeepgramClient.builder()
 
 ### Custom Base URL
 
-For on-premises deployments or custom endpoints:
+For on-premises deployments or custom REST/WebSocket endpoints:
 
 ```java
 import com.deepgram.core.Environment;
 
 DeepgramClient client = DeepgramClient.builder()
     .apiKey("YOUR_DEEPGRAM_API_KEY")
     .environment(Environment.custom()
-        .base("https://your-custom-endpoint.com")
+        .base("https://your-rest-endpoint.com")
+        .production("wss://your-listen-websocket-endpoint.com")
+        .agent("wss://your-agent-websocket-endpoint.com")
         .build())
     .build();
 ```
@@ -700,7 +702,7 @@ make format            # auto-format code
 
 ## API Reference
 
-See [reference.md](reference.md) for complete API documentation.
+See [developers.deepgram.com](https://developers.deepgram.com) for complete API documentation.
 
 ## Getting Help
 

pom.xml

@@ -116,6 +116,12 @@
             <version>3.25.3</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>com.deepgram</groupId>
+            <artifactId>deepgram-sagemaker</artifactId>
+            <version>0.1.2</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/com/deepgram/resources/agent/v1/types/AgentV1History.java

@@ -33,9 +33,9 @@ public Object get() {
     @SuppressWarnings("unchecked")
     public <T> T visit(Visitor<T> visitor) {
         if (this.type == 0) {
-            return visitor.visit((AgentV1HistoryContent) this.value);
+            return visitor.visit((ConversationHistoryMessage) this.value);
         } else if (this.type == 1) {
-            return visitor.visit((AgentV1HistoryFunctionCalls) this.value);
+            return visitor.visit((FunctionCallHistoryMessage) this.value);
         }
         throw new IllegalStateException("Failed to visit value. This should never happen.");
     }
@@ -60,18 +60,18 @@ public String toString() {
         return this.value.toString();
     }
 
-    public static AgentV1History of(AgentV1HistoryContent value) {
+    public static AgentV1History of(ConversationHistoryMessage value) {
         return new AgentV1History(value, 0);
     }
 
-    public static AgentV1History of(AgentV1HistoryFunctionCalls value) {
+    public static AgentV1History of(FunctionCallHistoryMessage value) {
         return new AgentV1History(value, 1);
     }
 
     public interface Visitor<T> {
-        T visit(AgentV1HistoryContent value);
+        T visit(ConversationHistoryMessage value);
 
-        T visit(AgentV1HistoryFunctionCalls value);
+        T visit(FunctionCallHistoryMessage value);
     }
 
     static final class Deserializer extends StdDeserializer<AgentV1History> {
@@ -86,13 +86,13 @@ public AgentV1History deserialize(JsonParser p, DeserializationContext context)
                     && ((Map<?, ?>) value).containsKey("role")
                     && ((Map<?, ?>) value).containsKey("content")) {
                 try {
-                    return of(ObjectMappers.JSON_MAPPER.convertValue(value, AgentV1HistoryContent.class));
+                    return of(ObjectMappers.JSON_MAPPER.convertValue(value, ConversationHistoryMessage.class));
                 } catch (RuntimeException e) {
                 }
             }
             if (value instanceof Map<?, ?> && ((Map<?, ?>) value).containsKey("function_calls")) {
                 try {
-                    return of(ObjectMappers.JSON_MAPPER.convertValue(value, AgentV1HistoryFunctionCalls.class));
+                    return of(ObjectMappers.JSON_MAPPER.convertValue(value, FunctionCallHistoryMessage.class));
                 } catch (RuntimeException e) {
                 }
             }