feat!: sdk regeneration 2026-04-27 (#42)

* chore: initialize SDK regeneration branch

* chore: unfreeze files pending regen

* chore(repo): ignore agent docs and Claude skills in fern regen

* chore(regen): automate ClientOptions patch reapply

* SDK regeneration

* chore: re-apply manual patches after regen

  - Restore ClientOptions.java SDK header constants and release-please version markers (overwritten by Fern with com.deepgram.fern:api-sdk and version 0.2.2).
  - Restore context7.json and add it to .fernignore so future regens don't delete it.
  - Rewrite the Agent WebSocket README snippet for the upstream agent settings restructure: ThinkSettingsV1 and ThinkSettingsV1Provider replace the AgentV1SettingsAgentThinkOneItem wrappers, and OpenAiThinkProvider now requires .builder().model(...) instead of accepting a free-form Map.

* fix(examples): align Java examples with regenerated SDK types

* chore(regen): align Java patch workflow with backup-restore strategy

* chore(repo): dedupe agent entries in .fernignore

---------

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

Author: GregHolmes

.claude/skills/review-regen.md

@@ -14,7 +14,7 @@ Read AGENTS.md for full context on the regeneration workflow and freeze classifi
     - Patches still needed (must be re-applied)
     - New changes from the generator worth noting
 5. Wait for user direction on which patches to re-apply.
-6. Re-apply confirmed patches to the generated files.
+6. Re-apply confirmed patches to the generated files. If `src/main/java/com/deepgram/core/ClientOptions.java` still needs the patch, restore it through the standard `.bak` swap/restore workflow used for other temporarily frozen files.
 7. In `.fernignore`, replace each `.bak` path back to the original path for files that still need patches.
 8. Remove `.fernignore` entries entirely for files where patches are no longer needed.
 9. Delete all `.bak` files.

.fern/metadata.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "4.46.0",
+  "cliVersion": "4.92.0",
   "generatorName": "fernapi/fern-java-sdk",
-  "generatorVersion": "4.0.4",
+  "generatorVersion": "4.6.1",
   "generatorConfig": {
     "package-prefix": "com.deepgram",
     "base-api-exception-class-name": "DeepgramHttpException",
@@ -11,6 +11,8 @@
     },
     "enable-wire-tests": true
   },
-  "originGitCommit": "e994b5ab79ae6fe3560daff055acdf80d315b48e",
-  "sdkVersion": "0.2.1"
+  "originGitCommit": "0d16d3b0d2f3da69dc058ea78f235b2b11288371",
+  "originGitCommitIsDirty": true,
+  "invokedBy": "manual",
+  "sdkVersion": "0.2.2"
 }

.fernignore

@@ -45,11 +45,12 @@ examples/
 .githooks/
 .github/
 .gitignore
+context7.json
 
 # Build output
 target/
 
-# Agent files (Claude Code, OpenCode, other agent tools)
+# Agent files (Claude Code, OpenCode, and shared agent tooling)
 # .agents/skills/ holds agent-agnostic skills discoverable via `npx skills`.
 # CLAUDE.md is kept here defensively alongside AGENTS.md — some agent tooling
 # expects one name, some the other, and layouts vary across checkouts.

AGENTS.md

@@ -47,7 +47,7 @@ How to identify:
 
 Current temporarily frozen files:
 
-- `src/main/java/com/deepgram/core/ClientOptions.java` - preserves release-please version markers and correct SDK header constants that Fern currently overwrites
+- `src/main/java/com/deepgram/core/ClientOptions.java` - preserves release-please version markers and correct SDK header constants that Fern currently overwrites; use the standard `.bak` swap/restore workflow during regen review
 
 ### Prepare repo for regeneration
 
@@ -66,7 +66,7 @@ Current temporarily frozen files:
 The `.bak` files are our manually patched versions protected by `.fernignore`. The original paths now contain the freshly generated versions. By comparing the two, we can see what the generator now produces versus what we had patched.
 
 1. Diff each `.bak` file against the new generated version to understand what changed and whether our patches are still needed.
-2. Re-apply any patches that are still necessary to the newly generated files.
+2. Re-apply any patches that are still necessary to the newly generated files. For `src/main/java/com/deepgram/core/ClientOptions.java`, use the standard `.bak` restore flow if the generated output still overwrites the Deepgram SDK header constants and `// x-release-please-version` markers.
 3. In `.fernignore`, replace each `.bak` path back to the original path for files that still need patches.
 4. Remove `.fernignore` entries entirely for any files where the generator now produces correct output.
 5. Delete all `.bak` files once review is complete.

README.md

@@ -335,13 +335,12 @@ import com.deepgram.resources.agent.v1.types.AgentV1InjectUserMessage;
 import com.deepgram.resources.agent.v1.types.AgentV1Settings;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgent;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThink;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItem;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItemProvider;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAudio;
 import com.deepgram.resources.agent.v1.websocket.V1WebSocketClient;
 import com.deepgram.types.OpenAiThinkProvider;
-import java.util.List;
-import java.util.Map;
+import com.deepgram.types.OpenAiThinkProviderModel;
+import com.deepgram.types.ThinkSettingsV1;
+import com.deepgram.types.ThinkSettingsV1Provider;
 import java.util.concurrent.TimeUnit;
 
 DeepgramClient client = DeepgramClient.builder().build();
@@ -355,12 +354,14 @@ agentWs.onWelcome(welcome -> {
     agentWs.sendSettings(AgentV1Settings.builder()
         .audio(AgentV1SettingsAudio.builder().build())
         .agent(AgentV1SettingsAgent.builder()
-                .think(AgentV1SettingsAgentThink.of(List.of(
-                    AgentV1SettingsAgentThinkOneItem.builder()
-                        .provider(AgentV1SettingsAgentThinkOneItemProvider.of(
-                            OpenAiThinkProvider.of(Map.of("model", "gpt-4o-mini"))))
+                .think(AgentV1SettingsAgentThink.of(
+                    ThinkSettingsV1.builder()
+                        .provider(ThinkSettingsV1Provider.openAi(
+                            OpenAiThinkProvider.builder()
+                                .model(OpenAiThinkProviderModel.GPT4O_MINI)
+                                .build()))
                         .prompt("You are a helpful voice assistant. Keep responses brief.")
-                        .build())))
+                        .build()))
                 .greeting("Hello! How can I help you today?")
                 .build())
         .build());

build.gradle

@@ -80,10 +80,6 @@ sourceSets {
     examples {
         java {
             srcDir 'examples'
-            // Exclude examples that still need API updates.
-            exclude 'manage/ListModels.java'    // Duplicate class name with agent/ListModels
-            exclude 'manage/MemberPermissions.java' // getScopes() not in generated API
-            exclude 'manage/UsageBreakdown.java'    // getModels() return type mismatch
         }
         compileClasspath += sourceSets.main.output + configurations.runtimeClasspath
         runtimeClasspath += sourceSets.main.output + configurations.runtimeClasspath

examples/agent/CustomProviders.java

@@ -2,18 +2,17 @@
 import com.deepgram.resources.agent.v1.types.AgentV1Settings;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgent;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeak;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakEndpoint;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakEndpointProvider;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakOneItemProviderDeepgramModel;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThink;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItem;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItemProvider;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAudio;
-import com.deepgram.resources.agent.v1.types.Deepgram;
 import com.deepgram.resources.agent.v1.websocket.V1WebSocketClient;
 import com.deepgram.types.Anthropic;
-import java.util.List;
-import java.util.Map;
+import com.deepgram.types.AnthropicThinkProviderModel;
+import com.deepgram.types.Deepgram;
+import com.deepgram.types.DeepgramSpeakProviderModel;
+import com.deepgram.types.SpeakSettingsV1;
+import com.deepgram.types.SpeakSettingsV1Provider;
+import com.deepgram.types.ThinkSettingsV1;
+import com.deepgram.types.ThinkSettingsV1Provider;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -57,23 +56,24 @@ public static void main(String[] args) {
 
                 try {
                     // Configure Anthropic as the think provider
-                    Anthropic anthropicProvider = Anthropic.of(Map.of("model", "claude-sonnet-4-20250514"));
+                    Anthropic anthropicProvider = Anthropic.builder()
+                            .model(AnthropicThinkProviderModel.CLAUDE_SONNET420250514)
+                            .build();
 
                     // Configure Deepgram as the speak provider
                     Deepgram deepgramSpeakProvider = Deepgram.builder()
-                            .model(AgentV1SettingsAgentSpeakOneItemProviderDeepgramModel.AURA2ASTERIA_EN)
+                            .model(DeepgramSpeakProviderModel.AURA2ASTERIA_EN)
                             .build();
 
-                    AgentV1SettingsAgentSpeak speakSettings =
-                            AgentV1SettingsAgentSpeak.of(AgentV1SettingsAgentSpeakEndpoint.builder()
-                                    .provider(AgentV1SettingsAgentSpeakEndpointProvider.deepgram(deepgramSpeakProvider))
-                                    .build());
+                    AgentV1SettingsAgentSpeak speakSettings = AgentV1SettingsAgentSpeak.of(SpeakSettingsV1.builder()
+                            .provider(SpeakSettingsV1Provider.deepgram(deepgramSpeakProvider))
+                            .build());
 
                     AgentV1SettingsAgent agentConfig = AgentV1SettingsAgent.builder()
-                            .think(AgentV1SettingsAgentThink.of(List.of(AgentV1SettingsAgentThinkOneItem.builder()
-                                    .provider(AgentV1SettingsAgentThinkOneItemProvider.of(anthropicProvider))
+                            .think(AgentV1SettingsAgentThink.of(ThinkSettingsV1.builder()
+                                    .provider(ThinkSettingsV1Provider.anthropic(anthropicProvider))
                                     .prompt("You are a helpful assistant. Keep responses concise.")
-                                    .build())))
+                                    .build()))
                             .speak(speakSettings)
                             .greeting("Hello! I'm powered by Anthropic Claude with Deepgram voices.")
                             .build();

examples/agent/InjectMessage.java

@@ -4,13 +4,12 @@
 import com.deepgram.resources.agent.v1.types.AgentV1Settings;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgent;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThink;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItem;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItemProvider;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAudio;
 import com.deepgram.resources.agent.v1.websocket.V1WebSocketClient;
 import com.deepgram.types.OpenAiThinkProvider;
-import java.util.List;
-import java.util.Map;
+import com.deepgram.types.OpenAiThinkProviderModel;
+import com.deepgram.types.ThinkSettingsV1;
+import com.deepgram.types.ThinkSettingsV1Provider;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -52,18 +51,18 @@ public static void main(String[] args) {
 
                 try {
                     // Configure the agent
-                    OpenAiThinkProvider openAiProvider = OpenAiThinkProvider.of(Map.of("model", "gpt-4o-mini"));
+                    OpenAiThinkProvider openAiProvider = OpenAiThinkProvider.builder()
+                            .model(OpenAiThinkProviderModel.GPT4O_MINI)
+                            .build();
 
                     AgentV1Settings settings = AgentV1Settings.builder()
                             .audio(AgentV1SettingsAudio.builder().build())
                             .agent(AgentV1SettingsAgent.builder()
-                                    .think(AgentV1SettingsAgentThink.of(
-                                            List.of(AgentV1SettingsAgentThinkOneItem.builder()
-                                                    .provider(
-                                                            AgentV1SettingsAgentThinkOneItemProvider.of(openAiProvider))
-                                                    .prompt(
-                                                            "You are a helpful voice assistant. Keep responses brief and conversational.")
-                                                    .build())))
+                                    .think(AgentV1SettingsAgentThink.of(ThinkSettingsV1.builder()
+                                            .provider(ThinkSettingsV1Provider.openAi(openAiProvider))
+                                            .prompt(
+                                                    "You are a helpful voice assistant. Keep responses brief and conversational.")
+                                            .build()))
                                     .greeting("Hello! I'm ready to chat.")
                                     .build())
                             .build();

examples/agent/ProviderCombinations.java

@@ -1,17 +1,18 @@
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgent;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeak;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakEndpoint;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakEndpointProvider;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentSpeakOneItemProviderDeepgramModel;
 import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThink;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItem;
-import com.deepgram.resources.agent.v1.types.AgentV1SettingsAgentThinkOneItemProvider;
-import com.deepgram.resources.agent.v1.types.Deepgram;
 import com.deepgram.types.Anthropic;
+import com.deepgram.types.AnthropicThinkProviderModel;
+import com.deepgram.types.Deepgram;
+import com.deepgram.types.DeepgramSpeakProviderModel;
 import com.deepgram.types.Google;
+import com.deepgram.types.GoogleThinkProviderModel;
 import com.deepgram.types.OpenAiThinkProvider;
-import java.util.List;
-import java.util.Map;
+import com.deepgram.types.OpenAiThinkProviderModel;
+import com.deepgram.types.SpeakSettingsV1;
+import com.deepgram.types.SpeakSettingsV1Provider;
+import com.deepgram.types.ThinkSettingsV1;
+import com.deepgram.types.ThinkSettingsV1Provider;
 
 /**
  * Demonstrates building different provider combination configurations for comparison. Shows how to configure OpenAI,
@@ -27,22 +28,23 @@ public static void main(String[] args) {
 
         // Shared speak provider (Deepgram TTS)
         Deepgram deepgramSpeak = Deepgram.builder()
-                .model(AgentV1SettingsAgentSpeakOneItemProviderDeepgramModel.AURA2ASTERIA_EN)
+                .model(DeepgramSpeakProviderModel.AURA2ASTERIA_EN)
                 .build();
-        AgentV1SettingsAgentSpeak speakSettings =
-                AgentV1SettingsAgentSpeak.of(AgentV1SettingsAgentSpeakEndpoint.builder()
-                        .provider(AgentV1SettingsAgentSpeakEndpointProvider.deepgram(deepgramSpeak))
-                        .build());
+        AgentV1SettingsAgentSpeak speakSettings = AgentV1SettingsAgentSpeak.of(SpeakSettingsV1.builder()
+                .provider(SpeakSettingsV1Provider.deepgram(deepgramSpeak))
+                .build());
 
         // Combination 1: OpenAI GPT-4o Mini + Deepgram
         System.out.println("=== Combination 1: OpenAI + Deepgram ===");
-        OpenAiThinkProvider openAiProvider = OpenAiThinkProvider.of(Map.of("model", "gpt-4o-mini"));
+        OpenAiThinkProvider openAiProvider = OpenAiThinkProvider.builder()
+                .model(OpenAiThinkProviderModel.GPT4O_MINI)
+                .build();
 
         AgentV1SettingsAgent openAiConfig = AgentV1SettingsAgent.builder()
-                .think(AgentV1SettingsAgentThink.of(List.of(AgentV1SettingsAgentThinkOneItem.builder()
-                        .provider(AgentV1SettingsAgentThinkOneItemProvider.of(openAiProvider))
+                .think(AgentV1SettingsAgentThink.of(ThinkSettingsV1.builder()
+                        .provider(ThinkSettingsV1Provider.openAi(openAiProvider))
                         .prompt("You are a helpful assistant powered by OpenAI.")
-                        .build())))
+                        .build()))
                 .speak(speakSettings)
                 .greeting("Hello! I'm powered by OpenAI GPT-4o Mini.")
                 .build();
@@ -53,13 +55,15 @@ public static void main(String[] args) {
 
         // Combination 2: Anthropic Claude + Deepgram
         System.out.println("=== Combination 2: Anthropic + Deepgram ===");
-        Anthropic anthropicProvider = Anthropic.of(Map.of("model", "claude-sonnet-4-20250514"));
+        Anthropic anthropicProvider = Anthropic.builder()
+                .model(AnthropicThinkProviderModel.CLAUDE_SONNET420250514)
+                .build();
 
         AgentV1SettingsAgent anthropicConfig = AgentV1SettingsAgent.builder()
-                .think(AgentV1SettingsAgentThink.of(List.of(AgentV1SettingsAgentThinkOneItem.builder()
-                        .provider(AgentV1SettingsAgentThinkOneItemProvider.of(anthropicProvider))
+                .think(AgentV1SettingsAgentThink.of(ThinkSettingsV1.builder()
+                        .provider(ThinkSettingsV1Provider.anthropic(anthropicProvider))
                         .prompt("You are a helpful assistant powered by Anthropic Claude.")
-                        .build())))
+                        .build()))
                 .speak(speakSettings)
                 .greeting("Hello! I'm powered by Anthropic Claude.")
                 .build();
@@ -70,13 +74,14 @@ public static void main(String[] args) {
 
         // Combination 3: Google Gemini + Deepgram
         System.out.println("=== Combination 3: Google + Deepgram ===");
-        Google googleProvider = Google.of(Map.of("model", "gemini-2.5-flash"));
+        Google googleProvider =
+                Google.builder().model(GoogleThinkProviderModel.GEMINI25FLASH).build();
 
         AgentV1SettingsAgent googleConfig = AgentV1SettingsAgent.builder()
-                .think(AgentV1SettingsAgentThink.of(List.of(AgentV1SettingsAgentThinkOneItem.builder()
-                        .provider(AgentV1SettingsAgentThinkOneItemProvider.of(googleProvider))
+                .think(AgentV1SettingsAgentThink.of(ThinkSettingsV1.builder()
+                        .provider(ThinkSettingsV1Provider.google(googleProvider))
                         .prompt("You are a helpful assistant powered by Google Gemini.")
-                        .build())))
+                        .build()))
                 .speak(speakSettings)
                 .greeting("Hello! I'm powered by Google Gemini.")
                 .build();