🌿 Fern Regeneration -- November 10, 2023 (#22)

* SDK regeneration

* fix compile

* poll transcription by default

---------

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

@@ -77,8 +77,8 @@ Transcriber transcriber = Transcriber.builder()
   .apiKey("YOUR_API_KEY")
   .build();
 
-TranscriptResponse transcript = transcriber.transcribe(
-    "https://example.org/audio.mp3", true);
+TranscriptResponse transcript =
+        transcriber.transcribe("https://example.org/audio.mp3");
 ```
 
 ## Using the Realtime Transcriber

build.gradle

@@ -21,6 +21,10 @@ dependencies {
     testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.8.2'
 }
 
+
+sourceCompatibility = 1.8
+targetCompatibility = 1.8
+
 spotless {
     java {
         palantirJavaFormat()
@@ -34,14 +38,16 @@ java {
 
 test {
     useJUnitPlatform()
+    testLogging {
+        showStandardStreams = true
+    }
 }
-
 publishing {
     publications {
         maven(MavenPublication) {
             groupId = 'com.assemblyai'
             artifactId = 'assemblyai-java'
-            version = '0.0.5-beta2'
+            version = '0.0.5-beta3'
             from components.java
         }
     }

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

gradlew

@@ -145,15 +145,15 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
     case $MAX_FD in #(
       max*)
         # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045
+        # shellcheck disable=SC2039,SC3045
         MAX_FD=$( ulimit -H -n ) ||
             warn "Could not query maximum file descriptor limit"
     esac
     case $MAX_FD in  #(
       '' | soft) :;; #(
       *)
         # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045
+        # shellcheck disable=SC2039,SC3045
         ulimit -n "$MAX_FD" ||
             warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
@@ -202,11 +202,11 @@ fi
 # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
-# Collect all arguments for the java command;
-#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
-#     shell script including quotes and variable substitutions, so put them in
-#     double quotes to make sure that they get re-expanded; and
-#   * put everything else in single quotes, so that it's not re-expanded.
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
 
 set -- \
         "-Dorg.gradle.appname=$APP_BASE_NAME" \

sample-app/build.gradle

@@ -13,3 +13,7 @@ dependencies {
     implementation rootProject
 }
 
+
+sourceCompatibility = 1.8
+targetCompatibility = 1.8
+

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

@@ -5,9 +5,13 @@
 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.types.ParagraphsResponse;
+import com.assemblyai.api.types.SentencesResponse;
 import com.assemblyai.api.types.SubtitleFormat;
 import com.assemblyai.api.types.Transcript;
+import com.assemblyai.api.types.TranscriptList;
 import com.assemblyai.api.types.UploadedFile;
+import com.assemblyai.api.types.WordSearchResponse;
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.IOException;
@@ -28,19 +32,19 @@ public static void main(String... args) throws IOException {
                 transcriber.transcribe("https://storage.googleapis.com/aai-docs-samples/nbc.mp3", true);
         System.out.println(transcript);
 
-        var sentences = aai.transcript().getSentences(transcript.getId());
+        SentencesResponse sentences = aai.transcript().getSentences(transcript.getId());
         System.out.println("Get transcript sentences. " + sentences);
 
-        var paragraphs = aai.transcript().getParagraphs(transcript.getId());
+        ParagraphsResponse paragraphs = aai.transcript().getParagraphs(transcript.getId());
         System.out.println("Get transcript paragraphs. " + paragraphs);
 
-        var srt = aai.transcript().getSubtitles(transcript.getId(), SubtitleFormat.SRT);
+        String srt = aai.transcript().getSubtitles(transcript.getId(), SubtitleFormat.SRT);
         System.out.println("Get transcript srt. " + srt);
 
-        var vtt = aai.transcript().getSubtitles(transcript.getId(), SubtitleFormat.VTT);
+        String vtt = aai.transcript().getSubtitles(transcript.getId(), SubtitleFormat.VTT);
         System.out.println("Get transcript vtt. " + vtt);
 
-        var search = aai.transcript().wordSearch(transcript.getId(), TranscriptWordSearchRequest.builder()
+        WordSearchResponse search = aai.transcript().wordSearch(transcript.getId(), TranscriptWordSearchRequest.builder()
                 .words("NBC")
                 .build());
         System.out.println("Search transcript. " + search);
@@ -60,7 +64,7 @@ public static void main(String... args) throws IOException {
         transcript = aai.transcript().get(transcript.getId());
         System.out.println("Got transcript. " + transcript);
 
-        var transcripts = aai.transcript().list();
+        TranscriptList transcripts = aai.transcript().list();
         System.out.println("List transcript. " + transcripts);
 
         RealtimeTranscriber realtimeTranscriber = RealtimeTranscriber.builder()

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

@@ -18,6 +18,14 @@ private Transcriber(AssemblyAI client) {
         this.client = client;
     }
 
+    /**
+     * Transcribes an audio file whose location can be specified via a URL.
+     * Polls until transcription is done.
+     */
+    public Transcript transcribe(String url) {
+        return transcribe(url, CreateTranscriptOptionalParameters.builder().build(), true);
+    }
+
     /**
      * Transcribes an audio file whose location can be specified via a URL.
      */
@@ -56,6 +64,14 @@ public Transcript transcribe(String url, CreateTranscriptOptionalParameters tran
         return transcriptResponse;
     }
 
+    /**
+     * Transcribes an audio file whose location can be specified via a filepath.
+     * Polls until transcription is done.
+     */
+    public Transcript transcribe(File data) throws IOException {
+        return transcribe(data, CreateTranscriptOptionalParameters.builder().build(), true);
+    }
+
     /**
      * Transcribes an audio file whose location can be specified via a filepath.
      */

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-beta2",
+                "0.0.5-beta3",
                 "X-Fern-Language",
                 "JAVA"));
         this.headerSuppliers = headerSuppliers;

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

@@ -25,30 +25,30 @@ public Response intercept(Chain chain) throws IOException {
         Response response = chain.proceed(chain.request());
 
         if (shouldRetry(response.code())) {
-            return retryChain(chain);
+            return retryChain(response, chain);
         }
 
         return response;
     }
 
-    private Response retryChain(Chain chain) throws IOException {
+    private Response retryChain(Response response, Chain chain) throws IOException {
         Optional<Duration> nextBackoff = this.backoff.nextBackoff();
-
         while (nextBackoff.isPresent()) {
             try {
                 Thread.sleep(nextBackoff.get().toMillis());
             } catch (InterruptedException e) {
                 throw new IOException("Interrupted while trying request", e);
             }
-            Response response = chain.proceed(chain.request());
+            response.close();
+            response = chain.proceed(chain.request());
             if (shouldRetry(response.code())) {
                 nextBackoff = this.backoff.nextBackoff();
             } else {
                 return response;
             }
         }
 
-        throw new IOException("Max retries reached");
+        return response;
     }
 
     private static boolean shouldRetry(int statusCode) {

src/main/java/com/assemblyai/api/resources/files/FilesClient.java

@@ -22,13 +22,6 @@ public FilesClient(ClientOptions clientOptions) {
         this.clientOptions = clientOptions;
     }
 
-    /**
-     * Upload your audio or video file directly to the AssemblyAI API if it isn't accessible via a URL already.
-     */
-    public UploadedFile upload(byte[] request) {
-        return upload(request, null);
-    }
-
     /**
      * Upload your audio or video file directly to the AssemblyAI API if it isn't accessible via a URL already.
      */
@@ -57,4 +50,11 @@ public UploadedFile upload(byte[] request, RequestOptions requestOptions) {
             throw new RuntimeException(e);
         }
     }
+
+    /**
+     * Upload your audio or video file directly to the AssemblyAI API if it isn't accessible via a URL already.
+     */
+    public UploadedFile upload(byte[] request) {
+        return upload(request, null);
+    }
 }

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

@@ -31,13 +31,6 @@ public LemurClient(ClientOptions clientOptions) {
         this.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(LemurSummaryParameters request) {
-        return summary(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.
      */
@@ -74,10 +67,10 @@ public LemurSummaryResponse summary(LemurSummaryParameters request, RequestOptio
     }
 
     /**
-     * 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) {
-        return questionAnswer(request, null);
+    public LemurSummaryResponse summary(LemurSummaryParameters request) {
+        return summary(request, null);
     }
 
     /**
@@ -117,10 +110,10 @@ public LemurQuestionAnswerResponse questionAnswer(
     }
 
     /**
-     * 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(LemurQuestionAnswerParameters request) {
+        return questionAnswer(request, null);
     }
 
     /**
@@ -159,10 +152,10 @@ public LemurActionItemsResponse actionItems(LemurBaseParameters request, Request
     }
 
     /**
-     * Use LeMUR to ask anything with Custom 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(LemurBaseParameters request) {
+        return actionItems(request, null);
     }
 
     /**
@@ -201,11 +194,10 @@ public LemurTaskResponse task(LemurTaskParameters request, RequestOptions reques
     }
 
     /**
-     * Delete the data for a previously submitted LeMUR request.
-     * The LLM response data, as well as any context provided in the original request will be removed.
+     * Use LeMUR to ask anything with Custom Task
      */
-    public PurgeLemurRequestDataResponse purgeRequestData(String requestId) {
-        return purgeRequestData(requestId, null);
+    public LemurTaskResponse task(LemurTaskParameters request) {
+        return task(request, null);
     }
 
     /**
@@ -238,4 +230,12 @@ public PurgeLemurRequestDataResponse purgeRequestData(String requestId, RequestO
             throw new RuntimeException(e);
         }
     }
+
+    /**
+     * Delete the data for a previously submitted LeMUR request.
+     * The LLM response data, as well as any context provided in the original request will be removed.
+     */
+    public PurgeLemurRequestDataResponse purgeRequestData(String requestId) {
+        return purgeRequestData(requestId, null);
+    }
 }

src/main/java/com/assemblyai/api/resources/lemur/requests/LemurQuestionAnswerParameters.java

@@ -8,14 +8,18 @@
 import com.assemblyai.api.types.LemurBaseParametersContext;
 import com.assemblyai.api.types.LemurModel;
 import com.assemblyai.api.types.LemurQuestion;
+import com.fasterxml.jackson.annotation.JsonAnyGetter;
+import com.fasterxml.jackson.annotation.JsonAnySetter;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.fasterxml.jackson.annotation.JsonSetter;
 import com.fasterxml.jackson.annotation.Nulls;
 import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 import java.util.Optional;
 
@@ -34,19 +38,23 @@ public final class LemurQuestionAnswerParameters implements ILemurBaseParameters
 
     private final List<LemurQuestion> questions;
 
+    private final Map<String, Object> additionalProperties;
+
     private LemurQuestionAnswerParameters(
             List<String> transcriptIds,
             Optional<LemurBaseParametersContext> context,
             Optional<LemurModel> finalModel,
             Optional<Integer> maxOutputSize,
             Optional<Double> temperature,
-            List<LemurQuestion> questions) {
+            List<LemurQuestion> questions,
+            Map<String, Object> additionalProperties) {
         this.transcriptIds = transcriptIds;
         this.context = context;
         this.finalModel = finalModel;
         this.maxOutputSize = maxOutputSize;
         this.temperature = temperature;
         this.questions = questions;
+        this.additionalProperties = additionalProperties;
     }
 
     /**
@@ -107,6 +115,11 @@ public boolean equals(Object other) {
         return other instanceof LemurQuestionAnswerParameters && equalTo((LemurQuestionAnswerParameters) other);
     }
 
+    @JsonAnyGetter
+    public Map<String, Object> getAdditionalProperties() {
+        return this.additionalProperties;
+    }
+
     private boolean equalTo(LemurQuestionAnswerParameters other) {
         return transcriptIds.equals(other.transcriptIds)
                 && context.equals(other.context)
@@ -150,6 +163,9 @@ public static final class Builder {
 
         private List<LemurQuestion> questions = new ArrayList<>();
 
+        @JsonAnySetter
+        private Map<String, Object> additionalProperties = new HashMap<>();
+
         private Builder() {}
 
         public Builder from(LemurQuestionAnswerParameters other) {
@@ -242,7 +258,7 @@ public Builder addAllQuestions(List<LemurQuestion> questions) {
 
         public LemurQuestionAnswerParameters build() {
             return new LemurQuestionAnswerParameters(
-                    transcriptIds, context, finalModel, maxOutputSize, temperature, questions);
+                    transcriptIds, context, finalModel, maxOutputSize, temperature, questions, additionalProperties);
         }
     }
 }