🌿 Fern Regeneration -- December 4, 2023 (#32)

* SDK regeneration

* update manual code with renames

* fix readme

---------

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

Author: fern-api[bot]

README.md

@@ -116,9 +116,9 @@ method on `CreateTranscriptParameters` until you have specified the mandatory
 audioUrl variable.
 
 ```java
-import com.assemblyai.api.CreateTranscriptParams;
+import com.assemblyai.api.TranscriptParams;
 
-CreateTranscriptParameters params = CreateTranscriptParameters.builder()
+TranscriptParams params = TranscriptParams.builder()
   .audioUrl("https://...")
   .build();
 ```

build.gradle

@@ -47,7 +47,7 @@ publishing {
         maven(MavenPublication) {
             groupId = 'com.assemblyai'
             artifactId = 'assemblyai-java'
-            version = '0.0.5-beta5'
+            version = '0.0.5-beta8'
             from components.java
         }
     }

sample-app/src/main/java/sample/App.java

@@ -3,8 +3,8 @@
 import com.assemblyai.api.AssemblyAI;
 import com.assemblyai.api.RealtimeTranscriber;
 import com.assemblyai.api.Transcriber;
-import com.assemblyai.api.resources.transcript.requests.CreateTranscriptParameters;
-import com.assemblyai.api.resources.transcript.requests.TranscriptWordSearchRequest;
+import com.assemblyai.api.resources.transcripts.requests.TranscriptParams;
+import com.assemblyai.api.resources.transcripts.requests.TranscriptsWordSearchRequest;
 import com.assemblyai.api.types.ParagraphsResponse;
 import com.assemblyai.api.types.SentencesResponse;
 import com.assemblyai.api.types.SubtitleFormat;
@@ -44,7 +44,7 @@ public static void main(String... args) throws IOException {
         String vtt = aai.transcript().getSubtitles(transcript.getId(), SubtitleFormat.VTT);
         System.out.println("Get transcript vtt. " + vtt);
 
-        WordSearchResponse search = aai.transcript().wordSearch(transcript.getId(), TranscriptWordSearchRequest.builder()
+        WordSearchResponse search = aai.transcript().wordSearch(transcript.getId(), TranscriptsWordSearchRequest.builder()
                 .words("NBC")
                 .build());
         System.out.println("Search transcript. " + search);
@@ -56,12 +56,12 @@ public static void main(String... args) throws IOException {
         UploadedFile uploadedFile = aai.files().upload(Files.readAllBytes(file.toPath()));
         System.out.println("Uploaded file" + uploadedFile);
 
-        transcript = aai.transcript().create(CreateTranscriptParameters.builder()
+        transcript = aai.transcript().create(TranscriptParams.builder()
                 .audioUrl("https://storage.googleapis.com/aai-docs-samples/nbc.mp3")
                 .build(), true);
         System.out.println("Created and polled transcript " + transcript);
 
-        transcript = aai.transcript().create(CreateTranscriptParameters.builder()
+        transcript = aai.transcript().create(TranscriptParams.builder()
                 .audioUrl("https://storage.googleapis.com/aai-docs-samples/nbc.mp3")
                 .build());
         System.out.println("Created transcript " + transcript);

src/main/java/com/assemblyai/api/AssemblyAI.java

@@ -8,7 +8,6 @@
 import com.assemblyai.api.resources.files.FilesClient;
 import com.assemblyai.api.resources.lemur.LemurClient;
 import com.assemblyai.api.resources.realtime.RealtimeClient;
-import com.assemblyai.api.resources.transcript.TranscriptClient;
 import java.util.function.Supplier;
 
 public class AssemblyAI {

src/main/java/com/assemblyai/api/PollingTranscriptClient.java

@@ -1,11 +1,11 @@
 package com.assemblyai.api;
 
 import com.assemblyai.api.core.ClientOptions;
-import com.assemblyai.api.resources.transcript.TranscriptClient;
-import com.assemblyai.api.resources.transcript.requests.CreateTranscriptParameters;
+import com.assemblyai.api.resources.transcripts.TranscriptsClient;
+import com.assemblyai.api.resources.transcripts.requests.TranscriptParams;
 import com.assemblyai.api.types.Transcript;
 
-public class PollingTranscriptClient extends TranscriptClient {
+public class PollingTranscriptClient extends TranscriptsClient {
 
     private final Transcriber transcriber;
 
@@ -17,7 +17,7 @@ public PollingTranscriptClient(ClientOptions clientOptions, Transcriber transcri
     /**
      * Create a transcript from an audio or video file that is accessible via a URL.
      */
-    public Transcript create(CreateTranscriptParameters request, boolean poll) {
+    public Transcript create(TranscriptParams request, boolean poll) {
         return transcriber.transcribe(request.getAudioUrl(), request, poll);
     }
 

src/main/java/com/assemblyai/api/Transcriber.java

@@ -1,10 +1,10 @@
 package com.assemblyai.api;
 
 import com.assemblyai.api.core.Environment;
-import com.assemblyai.api.resources.transcript.requests.CreateTranscriptParameters;
-import com.assemblyai.api.types.CreateTranscriptOptionalParameters;
-import com.assemblyai.api.types.ICreateTranscriptOptionalParameters;
+import com.assemblyai.api.resources.transcripts.requests.TranscriptParams;
+import com.assemblyai.api.types.ITranscriptOptionalParams;
 import com.assemblyai.api.types.Transcript;
+import com.assemblyai.api.types.TranscriptOptionalParams;
 import com.assemblyai.api.types.TranscriptStatus;
 import com.assemblyai.api.types.UploadedFile;
 import java.io.File;
@@ -24,14 +24,14 @@ public final class Transcriber {
      * Polls until transcription is done.
      */
     public Transcript transcribe(String url) {
-        return transcribe(url, CreateTranscriptOptionalParameters.builder().build(), true);
+        return transcribe(url, TranscriptOptionalParams.builder().build(), true);
     }
 
     /**
      * Transcribes an audio file whose location can be specified via a URL.
      * Polls until transcription is done.
      */
-    public Transcript transcribe(String url, CreateTranscriptOptionalParameters transcriptRequest) {
+    public Transcript transcribe(String url, TranscriptOptionalParams transcriptRequest) {
         return transcribe(url, transcriptRequest, true);
     }
 
@@ -40,9 +40,9 @@ public Transcript transcribe(String url, CreateTranscriptOptionalParameters tran
      */
     public Transcript transcribe(
             String url,
-            ICreateTranscriptOptionalParameters transcriptRequest,
+            ITranscriptOptionalParams transcriptRequest,
             boolean poll) {
-        CreateTranscriptParameters createTranscript = CreateTranscriptParameters.builder()
+        TranscriptParams createTranscript = TranscriptParams.builder()
                 .audioUrl(url)
                 .languageCode(transcriptRequest.getLanguageCode())
                 .punctuate(transcriptRequest.getPunctuate())
@@ -91,21 +91,21 @@ public Transcript transcribe(
      * Polls until transcription is done.
      */
     public Transcript transcribe(File data) throws IOException {
-        return transcribe(data, CreateTranscriptOptionalParameters.builder().build(), true);
+        return transcribe(data, TranscriptOptionalParams.builder().build(), true);
     }
 
     /**
      * Transcribes an audio file whose location can be specified via a filepath.
      * Polls until transcription is done.
      */
-    public Transcript transcribe(File data, CreateTranscriptOptionalParameters transcriptRequest) throws IOException {
+    public Transcript transcribe(File data, TranscriptOptionalParams transcriptRequest) throws IOException {
         return transcribe(data, transcriptRequest, true);
     }
 
     /**
      * Transcribes an audio file whose location can be specified via a filepath.
      */
-    public Transcript transcribe(File data, CreateTranscriptOptionalParameters transcriptRequest, boolean poll)
+    public Transcript transcribe(File data, TranscriptOptionalParams transcriptRequest, boolean poll)
             throws IOException {
         UploadedFile uploadedFile = this.client.files().upload(Files.readAllBytes(data.toPath()));
         return transcribe(uploadedFile.getUploadUrl(), transcriptRequest, poll);

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

@@ -29,7 +29,7 @@ private ClientOptions(
                 "X-Fern-SDK-Name",
                 "com.assemblyai.fern:api-sdk",
                 "X-Fern-SDK-Version",
-                "0.0.5-beta5",
+                "0.0.5-beta8",
                 "X-Fern-Language",
                 "JAVA"));
         this.headerSuppliers = headerSuppliers;

src/main/java/com/assemblyai/api/resources/lemur/LemurClient.java

@@ -7,11 +7,11 @@
 import com.assemblyai.api.core.ClientOptions;
 import com.assemblyai.api.core.ObjectMappers;
 import com.assemblyai.api.core.RequestOptions;
-import com.assemblyai.api.resources.lemur.requests.LemurQuestionAnswerParameters;
-import com.assemblyai.api.resources.lemur.requests.LemurSummaryParameters;
-import com.assemblyai.api.resources.lemur.requests.LemurTaskParameters;
+import com.assemblyai.api.resources.lemur.requests.LemurQuestionAnswerParams;
+import com.assemblyai.api.resources.lemur.requests.LemurSummaryParams;
+import com.assemblyai.api.resources.lemur.requests.LemurTaskParams;
 import com.assemblyai.api.types.LemurActionItemsResponse;
-import com.assemblyai.api.types.LemurBaseParameters;
+import com.assemblyai.api.types.LemurBaseParams;
 import com.assemblyai.api.types.LemurQuestionAnswerResponse;
 import com.assemblyai.api.types.LemurSummaryResponse;
 import com.assemblyai.api.types.LemurTaskResponse;
@@ -32,19 +32,12 @@ public LemurClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
-     */
-    public LemurSummaryResponse summary() {
-        return summary(LemurSummaryParameters.builder().build());
-    }
-
-    /**
-     * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
+     * Use the LeMUR task endpoint to input your own LLM prompt.
      */
-    public LemurSummaryResponse summary(LemurSummaryParameters request, RequestOptions requestOptions) {
+    public LemurTaskResponse task(LemurTaskParams request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
                 .newBuilder()
-                .addPathSegments("lemur/v3/generate/summary")
+                .addPathSegments("lemur/v3/generate/task")
                 .build();
         RequestBody body;
         try {
@@ -63,7 +56,7 @@ public LemurSummaryResponse summary(LemurSummaryParameters request, RequestOptio
             Response response =
                     clientOptions.httpClient().newCall(okhttpRequest).execute();
             if (response.isSuccessful()) {
-                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurSummaryResponse.class);
+                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurTaskResponse.class);
             }
             throw new ApiError(
                     response.code(),
@@ -73,21 +66,27 @@ public LemurSummaryResponse summary(LemurSummaryParameters request, RequestOptio
         }
     }
 
+    /**
+     * Use the LeMUR task endpoint to input your own LLM prompt.
+     */
+    public LemurTaskResponse task(LemurTaskParams request) {
+        return task(request, null);
+    }
+
     /**
      * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
      */
-    public LemurSummaryResponse summary(LemurSummaryParameters request) {
-        return summary(request, null);
+    public LemurSummaryResponse summary() {
+        return summary(LemurSummaryParams.builder().build());
     }
 
     /**
-     * Question & Answer allows you to ask free-form questions about a single transcript or a group of transcripts. The questions can be any whose answers you find useful, such as judging whether a caller is likely to become a customer or whether all items on a meeting's agenda were covered.
+     * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
      */
-    public LemurQuestionAnswerResponse questionAnswer(
-            LemurQuestionAnswerParameters request, RequestOptions requestOptions) {
+    public LemurSummaryResponse summary(LemurSummaryParams request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
                 .newBuilder()
-                .addPathSegments("lemur/v3/generate/question-answer")
+                .addPathSegments("lemur/v3/generate/summary")
                 .build();
         RequestBody body;
         try {
@@ -106,7 +105,7 @@ public LemurQuestionAnswerResponse questionAnswer(
             Response response =
                     clientOptions.httpClient().newCall(okhttpRequest).execute();
             if (response.isSuccessful()) {
-                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurQuestionAnswerResponse.class);
+                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurSummaryResponse.class);
             }
             throw new ApiError(
                     response.code(),
@@ -117,26 +116,20 @@ public LemurQuestionAnswerResponse questionAnswer(
     }
 
     /**
-     * Question & Answer allows you to ask free-form questions about a single transcript or a group of transcripts. The questions can be any whose answers you find useful, such as judging whether a caller is likely to become a customer or whether all items on a meeting's agenda were covered.
-     */
-    public LemurQuestionAnswerResponse questionAnswer(LemurQuestionAnswerParameters request) {
-        return questionAnswer(request, null);
-    }
-
-    /**
-     * Use LeMUR to generate a list of Action Items from a transcript
+     * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
      */
-    public LemurActionItemsResponse actionItems() {
-        return actionItems(LemurBaseParameters.builder().build());
+    public LemurSummaryResponse summary(LemurSummaryParams request) {
+        return summary(request, null);
     }
 
     /**
-     * Use LeMUR to generate a list of Action Items from a transcript
+     * Question & Answer allows you to ask free-form questions about a single transcript or a group of transcripts. The questions can be any whose answers you find useful, such as judging whether a caller is likely to become a customer or whether all items on a meeting's agenda were covered.
      */
-    public LemurActionItemsResponse actionItems(LemurBaseParameters request, RequestOptions requestOptions) {
+    public LemurQuestionAnswerResponse questionAnswer(
+            LemurQuestionAnswerParams request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
                 .newBuilder()
-                .addPathSegments("lemur/v3/generate/action-items")
+                .addPathSegments("lemur/v3/generate/question-answer")
                 .build();
         RequestBody body;
         try {
@@ -155,7 +148,7 @@ public LemurActionItemsResponse actionItems(LemurBaseParameters request, Request
             Response response =
                     clientOptions.httpClient().newCall(okhttpRequest).execute();
             if (response.isSuccessful()) {
-                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurActionItemsResponse.class);
+                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurQuestionAnswerResponse.class);
             }
             throw new ApiError(
                     response.code(),
@@ -166,19 +159,26 @@ public LemurActionItemsResponse actionItems(LemurBaseParameters request, Request
     }
 
     /**
-     * Use LeMUR to generate a list of Action Items from a transcript
+     * Question & Answer allows you to ask free-form questions about a single transcript or a group of transcripts. The questions can be any whose answers you find useful, such as judging whether a caller is likely to become a customer or whether all items on a meeting's agenda were covered.
      */
-    public LemurActionItemsResponse actionItems(LemurBaseParameters request) {
-        return actionItems(request, null);
+    public LemurQuestionAnswerResponse questionAnswer(LemurQuestionAnswerParams request) {
+        return questionAnswer(request, null);
+    }
+
+    /**
+     * Use LeMUR to generate a list of action items from a transcript
+     */
+    public LemurActionItemsResponse actionItems() {
+        return actionItems(LemurBaseParams.builder().build());
     }
 
     /**
-     * Use your own prompt to run a Custom Task to handle your specialized task.
+     * Use LeMUR to generate a list of action items from a transcript
      */
-    public LemurTaskResponse task(LemurTaskParameters request, RequestOptions requestOptions) {
+    public LemurActionItemsResponse actionItems(LemurBaseParams request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
                 .newBuilder()
-                .addPathSegments("lemur/v3/generate/task")
+                .addPathSegments("lemur/v3/generate/action-items")
                 .build();
         RequestBody body;
         try {
@@ -197,7 +197,7 @@ public LemurTaskResponse task(LemurTaskParameters request, RequestOptions reques
             Response response =
                     clientOptions.httpClient().newCall(okhttpRequest).execute();
             if (response.isSuccessful()) {
-                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurTaskResponse.class);
+                return ObjectMappers.JSON_MAPPER.readValue(response.body().string(), LemurActionItemsResponse.class);
             }
             throw new ApiError(
                     response.code(),
@@ -208,10 +208,10 @@ public LemurTaskResponse task(LemurTaskParameters request, RequestOptions reques
     }
 
     /**
-     * Use your own prompt to run a Custom Task to handle your specialized task.
+     * Use LeMUR to generate a list of action items from a transcript
      */
-    public LemurTaskResponse task(LemurTaskParameters request) {
-        return task(request, null);
+    public LemurActionItemsResponse actionItems(LemurBaseParams request) {
+        return actionItems(request, null);
     }
 
     /**