Release 17.7.0: add voice transcription

.fern/metadata.json

@@ -1,5 +1,5 @@
 {
-  "cliVersion": "5.50.1",
+  "cliVersion": "5.50.4",
   "generatorName": "fernapi/fern-java-sdk",
   "generatorVersion": "4.9.2",
   "generatorConfig": {
@@ -10,10 +10,10 @@
     "enable-wire-tests": true,
     "publish-to": "central"
   },
-  "originGitCommit": "fbaef4c66e97232edfaacb20d23d476aa286ecdd",
+  "originGitCommit": "e2c477c4583f8f9e7d0d1a5b5591c1aa8cabef10",
   "originGitCommitIsDirty": true,
   "invokedBy": "ci",
   "requestedVersion": "AUTO",
   "ciProvider": "unknown",
-  "sdkVersion": "17.6.0"
-}
+  "sdkVersion": "17.7.0"
+}

build.gradle

@@ -48,7 +48,7 @@ java {
 
 group = 'com.phenoml.maven'
 
-version = '17.6.0'
+version = '17.7.0'
 
 jar {
     dependsOn(":generatePomFileForMavenPublication")
@@ -79,7 +79,7 @@ publishing {
         maven(MavenPublication) {
             groupId = 'com.phenoml.maven'
             artifactId = 'phenoml-java-sdk'
-            version = '17.6.0'
+            version = '17.7.0'
             from components.java
             pom {
                 name = 'phenoml'

changelog.md

@@ -1,3 +1,11 @@
+## [17.7.0] - 2026-06-23
+### Added
+- **`PhenomlClient.voice().voice().transcribe(...)`** — new sync method that uploads raw audio bytes (WAV, FLAC, MP3, or OGG/WebM Opus) to `POST /transcribe` and returns a `TranscribeResponse`, supporting up to ~5 minutes of audio per request.
+- **`AsyncPhenomlClient.voice().voice().transcribe(...)`** — new async method for the same voice transcription endpoint.
+- **`TranscribeRequest`** — new request type carrying raw audio bytes plus an optional BCP-47 `language` list.
+- **`TranscribeResponse.getTranscript()`** — new response accessor exposing the full transcript returned by the voice service.
+- **Voice service errors** — new typed exceptions (`BadRequestError`, `UnauthorizedError`, `PaymentRequiredError`, `ContentTooLargeError`, `BadGatewayError`, `ServiceUnavailableError`, `GatewayTimeoutError`) thrown by the voice service.
+
 ## [17.6.0] - 2026-06-18
 ### Added
 - **`ConflictError`** — new typed exception thrown by `RawChatClient.send(...)`, `RawChatClient.stream(...)`, `AsyncRawChatClient.send(...)`, and `AsyncRawChatClient.stream(...)` for HTTP 409 responses when a session already has an active turn.

code-examples.json

@@ -2,8 +2,8 @@
   "metadata": {
     "language": "java",
     "packageName": "com.phenoml.maven:phenoml-java-sdk",
-    "sdkVersion": "17.6.0",
-    "specCommit": "fbaef4c66e97232edfaacb20d23d476aa286ecdd",
+    "sdkVersion": "17.7.0",
+    "specCommit": "e2c477c4583f8f9e7d0d1a5b5591c1aa8cabef10",
     "generatorName": "fernapi/fern-java-sdk"
   },
   "renderRules": {
@@ -4553,6 +4553,37 @@
         ]
       }
     },
+    "POST /transcribe": {
+      "httpMethod": "POST",
+      "httpPath": "/transcribe",
+      "request": {
+        "body": null
+      },
+      "response": {
+        "body": null
+      },
+      "render": {
+        "callTemplate": "client.voice().voice().transcribe(TranscribeRequest.builder(){{__body__}}.build())",
+        "params": [],
+        "body": {
+          "fieldSeparator": "",
+          "fields": [
+            {
+              "jsonKey": "language",
+              "fieldTemplate": ".language({{value}})",
+              "kind": "list",
+              "required": false,
+              "items": {
+                "jsonKey": "",
+                "fieldTemplate": "{{value}}",
+                "kind": "string",
+                "required": true
+              }
+            }
+          ]
+        }
+      }
+    },
     "GET /workflows": {
       "httpMethod": "GET",
       "httpPath": "/workflows",

reference.md

@@ -5490,6 +5490,7 @@ client.tools().mcpTools().delete("mcp_server_tool_id");
 </dl>
 </details>
 
+## Voice
 ## Workflows
 <details><summary><code>client.workflows.list() -> ListWorkflowsResponse</code></summary>
 <dl>

src/main/java/com/phenoml/api/AsyncPhenomlClient.java

@@ -15,6 +15,7 @@
 import com.phenoml.api.resources.lang2fhir.AsyncLang2FhirClient;
 import com.phenoml.api.resources.summary.AsyncSummaryClient;
 import com.phenoml.api.resources.tools.AsyncToolsClient;
+import com.phenoml.api.resources.voice.AsyncVoiceClient;
 import com.phenoml.api.resources.workflows.AsyncWorkflowsClient;
 import java.util.function.Supplier;
 
@@ -41,6 +42,8 @@ public class AsyncPhenomlClient {
 
     protected final Supplier<AsyncToolsClient> toolsClient;
 
+    protected final Supplier<AsyncVoiceClient> voiceClient;
+
     protected final Supplier<AsyncWorkflowsClient> workflowsClient;
 
     public AsyncPhenomlClient(ClientOptions clientOptions) {
@@ -55,6 +58,7 @@ public AsyncPhenomlClient(ClientOptions clientOptions) {
         this.lang2FhirClient = Suppliers.memoize(() -> new AsyncLang2FhirClient(clientOptions));
         this.summaryClient = Suppliers.memoize(() -> new AsyncSummaryClient(clientOptions));
         this.toolsClient = Suppliers.memoize(() -> new AsyncToolsClient(clientOptions));
+        this.voiceClient = Suppliers.memoize(() -> new AsyncVoiceClient(clientOptions));
         this.workflowsClient = Suppliers.memoize(() -> new AsyncWorkflowsClient(clientOptions));
     }
 
@@ -98,6 +102,10 @@ public AsyncToolsClient tools() {
         return this.toolsClient.get();
     }
 
+    public AsyncVoiceClient voice() {
+        return this.voiceClient.get();
+    }
+
     public AsyncWorkflowsClient workflows() {
         return this.workflowsClient.get();
     }

src/main/java/com/phenoml/api/PhenomlClient.java

@@ -15,6 +15,7 @@
 import com.phenoml.api.resources.lang2fhir.Lang2FhirClient;
 import com.phenoml.api.resources.summary.SummaryClient;
 import com.phenoml.api.resources.tools.ToolsClient;
+import com.phenoml.api.resources.voice.VoiceClient;
 import com.phenoml.api.resources.workflows.WorkflowsClient;
 import java.util.function.Supplier;
 
@@ -41,6 +42,8 @@ public class PhenomlClient {
 
     protected final Supplier<ToolsClient> toolsClient;
 
+    protected final Supplier<VoiceClient> voiceClient;
+
     protected final Supplier<WorkflowsClient> workflowsClient;
 
     public PhenomlClient(ClientOptions clientOptions) {
@@ -55,6 +58,7 @@ public PhenomlClient(ClientOptions clientOptions) {
         this.lang2FhirClient = Suppliers.memoize(() -> new Lang2FhirClient(clientOptions));
         this.summaryClient = Suppliers.memoize(() -> new SummaryClient(clientOptions));
         this.toolsClient = Suppliers.memoize(() -> new ToolsClient(clientOptions));
+        this.voiceClient = Suppliers.memoize(() -> new VoiceClient(clientOptions));
         this.workflowsClient = Suppliers.memoize(() -> new WorkflowsClient(clientOptions));
     }
 
@@ -98,6 +102,10 @@ public ToolsClient tools() {
         return this.toolsClient.get();
     }
 
+    public VoiceClient voice() {
+        return this.voiceClient.get();
+    }
+
     public WorkflowsClient workflows() {
         return this.workflowsClient.get();
     }

src/main/java/com/phenoml/api/core/ClientOptions.java

@@ -38,10 +38,10 @@ private ClientOptions(
         this.headers.putAll(headers);
         this.headers.putAll(new HashMap<String, String>() {
             {
-                put("User-Agent", "com.phenoml.maven:phenoml-java-sdk/17.6.0");
+                put("User-Agent", "com.phenoml.maven:phenoml-java-sdk/17.7.0");
                 put("X-Fern-Language", "JAVA");
                 put("X-Fern-SDK-Name", "com.phenoml.fern:api-sdk");
-                put("X-Fern-SDK-Version", "17.6.0");
+                put("X-Fern-SDK-Version", "17.7.0");
             }
         });
         this.headerSuppliers = headerSuppliers;

src/main/java/com/phenoml/api/resources/voice/AsyncVoiceClient.java

@@ -0,0 +1,24 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice;
+
+import com.phenoml.api.core.ClientOptions;
+import com.phenoml.api.core.Suppliers;
+import java.util.function.Supplier;
+
+public class AsyncVoiceClient {
+    protected final ClientOptions clientOptions;
+
+    protected final Supplier<com.phenoml.api.resources.voice.voice.AsyncVoiceClient> voiceClient;
+
+    public AsyncVoiceClient(ClientOptions clientOptions) {
+        this.clientOptions = clientOptions;
+        this.voiceClient =
+                Suppliers.memoize(() -> new com.phenoml.api.resources.voice.voice.AsyncVoiceClient(clientOptions));
+    }
+
+    public com.phenoml.api.resources.voice.voice.AsyncVoiceClient voice() {
+        return this.voiceClient.get();
+    }
+}

src/main/java/com/phenoml/api/resources/voice/VoiceClient.java

@@ -0,0 +1,24 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice;
+
+import com.phenoml.api.core.ClientOptions;
+import com.phenoml.api.core.Suppliers;
+import java.util.function.Supplier;
+
+public class VoiceClient {
+    protected final ClientOptions clientOptions;
+
+    protected final Supplier<com.phenoml.api.resources.voice.voice.VoiceClient> voiceClient;
+
+    public VoiceClient(ClientOptions clientOptions) {
+        this.clientOptions = clientOptions;
+        this.voiceClient =
+                Suppliers.memoize(() -> new com.phenoml.api.resources.voice.voice.VoiceClient(clientOptions));
+    }
+
+    public com.phenoml.api.resources.voice.voice.VoiceClient voice() {
+        return this.voiceClient.get();
+    }
+}

src/main/java/com/phenoml/api/resources/voice/errors/BadGatewayError.java

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice.errors;
+
+import com.phenoml.api.core.PhenomlClientApiException;
+import okhttp3.Response;
+
+public final class BadGatewayError extends PhenomlClientApiException {
+    /**
+     * The body of the response that triggered the exception.
+     */
+    private final Object body;
+
+    public BadGatewayError(Object body) {
+        super("BadGatewayError", 502, body);
+        this.body = body;
+    }
+
+    public BadGatewayError(Object body, Response rawResponse) {
+        super("BadGatewayError", 502, body, rawResponse);
+        this.body = body;
+    }
+
+    /**
+     * @return the body
+     */
+    @java.lang.Override
+    public Object body() {
+        return this.body;
+    }
+}

src/main/java/com/phenoml/api/resources/voice/errors/BadRequestError.java

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice.errors;
+
+import com.phenoml.api.core.PhenomlClientApiException;
+import okhttp3.Response;
+
+public final class BadRequestError extends PhenomlClientApiException {
+    /**
+     * The body of the response that triggered the exception.
+     */
+    private final Object body;
+
+    public BadRequestError(Object body) {
+        super("BadRequestError", 400, body);
+        this.body = body;
+    }
+
+    public BadRequestError(Object body, Response rawResponse) {
+        super("BadRequestError", 400, body, rawResponse);
+        this.body = body;
+    }
+
+    /**
+     * @return the body
+     */
+    @java.lang.Override
+    public Object body() {
+        return this.body;
+    }
+}

src/main/java/com/phenoml/api/resources/voice/errors/ContentTooLargeError.java

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice.errors;
+
+import com.phenoml.api.core.PhenomlClientApiException;
+import okhttp3.Response;
+
+public final class ContentTooLargeError extends PhenomlClientApiException {
+    /**
+     * The body of the response that triggered the exception.
+     */
+    private final Object body;
+
+    public ContentTooLargeError(Object body) {
+        super("ContentTooLargeError", 413, body);
+        this.body = body;
+    }
+
+    public ContentTooLargeError(Object body, Response rawResponse) {
+        super("ContentTooLargeError", 413, body, rawResponse);
+        this.body = body;
+    }
+
+    /**
+     * @return the body
+     */
+    @java.lang.Override
+    public Object body() {
+        return this.body;
+    }
+}

src/main/java/com/phenoml/api/resources/voice/errors/GatewayTimeoutError.java

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+package com.phenoml.api.resources.voice.errors;
+
+import com.phenoml.api.core.PhenomlClientApiException;
+import okhttp3.Response;
+
+public final class GatewayTimeoutError extends PhenomlClientApiException {
+    /**
+     * The body of the response that triggered the exception.
+     */
+    private final Object body;
+
+    public GatewayTimeoutError(Object body) {
+        super("GatewayTimeoutError", 504, body);
+        this.body = body;
+    }
+
+    public GatewayTimeoutError(Object body, Response rawResponse) {
+        super("GatewayTimeoutError", 504, body, rawResponse);
+        this.body = body;
+    }
+
+    /**
+     * @return the body
+     */
+    @java.lang.Override
+    public Object body() {
+        return this.body;
+    }
+}