chore: internal change to autogenerate list methods in Python, Java, and Go SDKs

PiperOrigin-RevId: 835403349

Author: speedstorm1

src/main/java/com/google/genai/AsyncBatches.java

@@ -144,6 +144,39 @@ public CompletableFuture<DeleteResourceJob> delete(String name, DeleteBatchJobCo
             });
   }
 
+  /**
+   * Asynchronously makes an API request to list the available batch jobs.
+   *
+   * @param config A {@link ListBatchJobsConfig} for configuring the list request.
+   * @return A CompletableFuture that resolves to a {@link AsyncPager}. The AsyncPager has a
+   *     `forEach` method that can be used to asynchronously process items in the page and
+   *     automatically query the next page once the current page is exhausted.
+   */
+  @SuppressWarnings("PatternMatchingInstanceof")
+  public CompletableFuture<AsyncPager<BatchJob>> list(ListBatchJobsConfig config) {
+    if (config == null) {
+      config = ListBatchJobsConfig.builder().build();
+    }
+    ListBatchJobsConfig finalConfig = config;
+    Function<JsonSerializable, CompletableFuture<JsonNode>> request =
+        requestConfig -> {
+          if (!(requestConfig instanceof ListBatchJobsConfig)) {
+            throw new GenAiIOException(
+                "Internal error: Pager expected ListBatchJobsConfig but received "
+                    + requestConfig.getClass().getName());
+          }
+          return this.privateList((ListBatchJobsConfig) requestConfig)
+              .thenApply(JsonSerializable::toJsonNode);
+        };
+    return CompletableFuture.supplyAsync(
+        () ->
+            new AsyncPager<BatchJob>(
+                Pager.PagedItem.BATCH_JOBS,
+                request,
+                (ObjectNode) JsonSerializable.toJsonNode(finalConfig),
+                request.apply(finalConfig)));
+  }
+
   /**
    * Asynchronously creates a batch job.
    *
@@ -196,33 +229,4 @@ public CompletableFuture<BatchJob> createEmbeddings(
     }
     return this.privateCreateEmbeddings(model, src, config);
   }
-
-  /**
-   * Asynchronously makes an API request to list the available batch jobs.
-   *
-   * @param config A {@link ListBatchJobsConfig} for configuring the list request.
-   * @return A CompletableFuture that resolves to a {@link AsyncPager}. The AsyncPager has a
-   *     `forEach` method that can be used to asynchronously process items in the page and
-   *     automatically query the next page once the current page is exhausted.
-   */
-  @SuppressWarnings("PatternMatchingInstanceof")
-  public CompletableFuture<AsyncPager<BatchJob>> list(ListBatchJobsConfig config) {
-    Function<JsonSerializable, CompletableFuture<JsonNode>> request =
-        requestConfig -> {
-          if (!(requestConfig instanceof ListBatchJobsConfig)) {
-            throw new GenAiIOException(
-                "Internal error: Pager expected ListBatchJobsConfig but received "
-                    + requestConfig.getClass().getName());
-          }
-          return this.privateList((ListBatchJobsConfig) requestConfig)
-              .thenApply(JsonSerializable::toJsonNode);
-        };
-    return CompletableFuture.supplyAsync(
-        () ->
-            new AsyncPager<>(
-                Pager.PagedItem.BATCH_JOBS,
-                request,
-                (ObjectNode) JsonSerializable.toJsonNode(config),
-                request.apply(config)));
-  }
 }

src/main/java/com/google/genai/AsyncCaches.java

@@ -142,6 +142,10 @@ CompletableFuture<ListCachedContentsResponse> privateList(ListCachedContentsConf
    */
   @SuppressWarnings("PatternMatchingInstanceof")
   public CompletableFuture<AsyncPager<CachedContent>> list(ListCachedContentsConfig config) {
+    if (config == null) {
+      config = ListCachedContentsConfig.builder().build();
+    }
+    ListCachedContentsConfig finalConfig = config;
     Function<JsonSerializable, CompletableFuture<JsonNode>> request =
         requestConfig -> {
           if (!(requestConfig instanceof ListCachedContentsConfig)) {
@@ -154,10 +158,10 @@ public CompletableFuture<AsyncPager<CachedContent>> list(ListCachedContentsConfi
         };
     return CompletableFuture.supplyAsync(
         () ->
-            new AsyncPager<>(
+            new AsyncPager<CachedContent>(
                 Pager.PagedItem.CACHED_CONTENTS,
                 request,
-                (ObjectNode) JsonSerializable.toJsonNode(config),
-                request.apply(config)));
+                (ObjectNode) JsonSerializable.toJsonNode(finalConfig),
+                request.apply(finalConfig)));
   }
 }

src/main/java/com/google/genai/AsyncDocuments.java

@@ -78,6 +78,7 @@ CompletableFuture<ListDocumentsResponse> privateList(String parent, ListDocument
   /**
    * Asynchronously makes an API request to list the available documents.
    *
+   * @param parent The name of the RagStore containing the Documents.
    * @param config A {@link ListDocumentsConfig} for configuring the list request.
    * @return A CompletableFuture that resolves to a {@link AsyncPager}. The AsyncPager has a
    *     `forEach` method that can be used to asynchronously process items in the page and
@@ -96,14 +97,12 @@ public CompletableFuture<AsyncPager<Document>> list(String parent, ListDocuments
                 "Internal error: Pager expected ListDocumentsConfig but received "
                     + requestConfig.getClass().getName());
           }
-          return CompletableFuture.supplyAsync(
-              () ->
-                  JsonSerializable.toJsonNode(
-                      documents.privateList(parent, (ListDocumentsConfig) requestConfig)));
+          return this.privateList(parent, (ListDocumentsConfig) requestConfig)
+              .thenApply(JsonSerializable::toJsonNode);
         };
     return CompletableFuture.supplyAsync(
         () ->
-            new AsyncPager<>(
+            new AsyncPager<Document>(
                 Pager.PagedItem.DOCUMENTS,
                 request,
                 (ObjectNode) JsonSerializable.toJsonNode(finalConfig),

src/main/java/com/google/genai/AsyncFileSearchStores.java

@@ -154,14 +154,12 @@ public CompletableFuture<AsyncPager<FileSearchStore>> list(ListFileSearchStoresC
                 "Internal error: Pager expected ListFileSearchStoresConfig but received "
                     + requestConfig.getClass().getName());
           }
-          return CompletableFuture.supplyAsync(
-              () ->
-                  JsonSerializable.toJsonNode(
-                      fileSearchStores.privateList((ListFileSearchStoresConfig) requestConfig)));
+          return this.privateList((ListFileSearchStoresConfig) requestConfig)
+              .thenApply(JsonSerializable::toJsonNode);
         };
     return CompletableFuture.supplyAsync(
         () ->
-            new AsyncPager<>(
+            new AsyncPager<FileSearchStore>(
                 Pager.PagedItem.FILE_SEARCH_STORES,
                 request,
                 (ObjectNode) JsonSerializable.toJsonNode(finalConfig),

src/main/java/com/google/genai/AsyncFiles.java

@@ -49,12 +49,6 @@ public AsyncFiles(ApiClient apiClient) {
     this.files = new Files(apiClient);
   }
 
-  /**
-   * Asynchronously lists all files from the service.
-   *
-   * @param config - Optional, configuration for the list method.
-   * @return The ListFilesResponse, the response for the list method.
-   */
   CompletableFuture<ListFilesResponse> privateList(ListFilesConfig config) {
     BuiltRequest builtRequest = files.buildRequestForPrivateList(config);
     return this.apiClient
@@ -117,6 +111,39 @@ public CompletableFuture<DeleteFileResponse> delete(String name, DeleteFileConfi
             });
   }
 
+  /**
+   * Asynchronously makes an API request to list the available files.
+   *
+   * @param config A {@link ListFilesConfig} for configuring the list request.
+   * @return A CompletableFuture that resolves to a {@link AsyncPager}. The AsyncPager has a
+   *     `forEach` method that can be used to asynchronously process items in the page and
+   *     automatically query the next page once the current page is exhausted.
+   */
+  @SuppressWarnings("PatternMatchingInstanceof")
+  public CompletableFuture<AsyncPager<File>> list(ListFilesConfig config) {
+    if (config == null) {
+      config = ListFilesConfig.builder().build();
+    }
+    ListFilesConfig finalConfig = config;
+    Function<JsonSerializable, CompletableFuture<JsonNode>> request =
+        requestConfig -> {
+          if (!(requestConfig instanceof ListFilesConfig)) {
+            throw new GenAiIOException(
+                "Internal error: Pager expected ListFilesConfig but received "
+                    + requestConfig.getClass().getName());
+          }
+          return this.privateList((ListFilesConfig) requestConfig)
+              .thenApply(JsonSerializable::toJsonNode);
+        };
+    return CompletableFuture.supplyAsync(
+        () ->
+            new AsyncPager<File>(
+                Pager.PagedItem.FILES,
+                request,
+                (ObjectNode) JsonSerializable.toJsonNode(finalConfig),
+                request.apply(finalConfig)));
+  }
+
   /**
    * Asynchronously uploads a file to the GenAI API.
    *
@@ -213,33 +240,4 @@ public CompletableFuture<Void> download(
       File file, String downloadPath, DownloadFileConfig config) {
     return CompletableFuture.runAsync(() -> files.download(file, downloadPath, config));
   }
-
-  /**
-   * Asynchronously makes an API request to list the available files.
-   *
-   * @param config A {@link ListFilesConfig} for configuring the list request.
-   * @return A CompletableFuture that resolves to a {@link AsyncPager}. The AsyncPager has a
-   *     `forEach` method that can be used to asynchronously process items in the page and
-   *     automatically query the next page once the current page is exhausted.
-   */
-  @SuppressWarnings("PatternMatchingInstanceof")
-  public CompletableFuture<AsyncPager<File>> list(ListFilesConfig config) {
-    Function<JsonSerializable, CompletableFuture<JsonNode>> request =
-        requestConfig -> {
-          if (!(requestConfig instanceof ListFilesConfig)) {
-            throw new GenAiIOException(
-                "Internal error: Pager expected ListFilesConfig but received "
-                    + requestConfig.getClass().getName());
-          }
-          return this.privateList((ListFilesConfig) requestConfig)
-              .thenApply(JsonSerializable::toJsonNode);
-        };
-    return CompletableFuture.supplyAsync(
-        () ->
-            new AsyncPager<>(
-                Pager.PagedItem.FILES,
-                request,
-                (ObjectNode) JsonSerializable.toJsonNode(config),
-                request.apply(config)));
-  }
 }

src/main/java/com/google/genai/AsyncTunings.java

@@ -121,17 +121,6 @@ CompletableFuture<TuningOperation> privateTuneMldev(
             });
   }
 
-  /**
-   * Asynchronously makes an API request to get a tuning job.
-   *
-   * @param name The resource name of the tuning job.
-   * @param config A {@link GetTuningJobConfig} for configuring the get request.
-   * @return A CompletableFuture that resolves to a {@link TuningJob} object.
-   */
-  public CompletableFuture<TuningJob> get(String name, GetTuningJobConfig config) {
-    return CompletableFuture.supplyAsync(() -> tunings.privateGet(name, config));
-  }
-
   /**
    * Asynchronously makes an API request to list the available tuning jobs.
    *
@@ -142,6 +131,10 @@ public CompletableFuture<TuningJob> get(String name, GetTuningJobConfig config)
    */
   @SuppressWarnings("PatternMatchingInstanceof")
   public CompletableFuture<AsyncPager<TuningJob>> list(ListTuningJobsConfig config) {
+    if (config == null) {
+      config = ListTuningJobsConfig.builder().build();
+    }
+    ListTuningJobsConfig finalConfig = config;
     Function<JsonSerializable, CompletableFuture<JsonNode>> request =
         requestConfig -> {
           if (!(requestConfig instanceof ListTuningJobsConfig)) {
@@ -154,11 +147,22 @@ public CompletableFuture<AsyncPager<TuningJob>> list(ListTuningJobsConfig config
         };
     return CompletableFuture.supplyAsync(
         () ->
-            new AsyncPager<>(
+            new AsyncPager<TuningJob>(
                 Pager.PagedItem.TUNING_JOBS,
                 request,
-                (ObjectNode) JsonSerializable.toJsonNode(config),
-                request.apply(config)));
+                (ObjectNode) JsonSerializable.toJsonNode(finalConfig),
+                request.apply(finalConfig)));
+  }
+
+  /**
+   * Asynchronously makes an API request to get a tuning job.
+   *
+   * @param name The resource name of the tuning job.
+   * @param config A {@link GetTuningJobConfig} for configuring the get request.
+   * @return A CompletableFuture that resolves to a {@link TuningJob} object.
+   */
+  public CompletableFuture<TuningJob> get(String name, GetTuningJobConfig config) {
+    return CompletableFuture.supplyAsync(() -> tunings.privateGet(name, config));
   }
 
   /**

src/main/java/com/google/genai/Batches.java

@@ -2329,6 +2329,34 @@ public DeleteResourceJob delete(String name, DeleteBatchJobConfig config) {
     }
   }
 
+  /**
+   * Makes an API request to list the available batch jobs.
+   *
+   * @param config A {@link ListBatchJobsConfig} for configuring the list request.
+   * @return A {@link Pager} object that contains the list of batch jobs. The pager is an iterable
+   *     and automatically queries the next page once the current page is exhausted.
+   */
+  @SuppressWarnings("PatternMatchingInstanceof")
+  public Pager<BatchJob> list(ListBatchJobsConfig config) {
+    if (config == null) {
+      config = ListBatchJobsConfig.builder().build();
+    }
+    Function<JsonSerializable, Object> request =
+        requestConfig -> {
+          if (!(requestConfig instanceof ListBatchJobsConfig)) {
+            throw new GenAiIOException(
+                "Internal error: Pager expected ListBatchJobsConfig but received "
+                    + requestConfig.getClass().getName());
+          }
+          return this.privateList((ListBatchJobsConfig) requestConfig);
+        };
+    return new Pager<>(
+        Pager.PagedItem.BATCH_JOBS,
+        request,
+        (ObjectNode) JsonSerializable.toJsonNode(config),
+        JsonSerializable.toJsonNode(privateList(config)));
+  }
+
   /**
    * Makes an API request to create the batch job.
    *
@@ -2380,29 +2408,4 @@ public BatchJob createEmbeddings(
     }
     return this.privateCreateEmbeddings(model, src, config);
   }
-
-  /**
-   * Makes an API request to list the available batch jobs.
-   *
-   * @param config A {@link ListBatchJobsConfig} for configuring the list request.
-   * @return A {@link Pager} object that contains the list of batch jobs. The pager is an iterable
-   *     and automatically queries the next page once the current page is exhausted.
-   */
-  @SuppressWarnings("PatternMatchingInstanceof")
-  public Pager<BatchJob> list(ListBatchJobsConfig config) {
-    Function<JsonSerializable, Object> request =
-        requestConfig -> {
-          if (!(requestConfig instanceof ListBatchJobsConfig)) {
-            throw new GenAiIOException(
-                "Internal error: Pager expected ListBatchJobsConfig but received "
-                    + requestConfig.getClass().getName());
-          }
-          return this.privateList((ListBatchJobsConfig) requestConfig);
-        };
-    return new Pager<>(
-        Pager.PagedItem.BATCH_JOBS,
-        request,
-        (ObjectNode) JsonSerializable.toJsonNode(config),
-        JsonSerializable.toJsonNode(privateList(config)));
-  }
 }

src/main/java/com/google/genai/Caches.java

@@ -1455,6 +1455,9 @@ ListCachedContentsResponse privateList(ListCachedContentsConfig config) {
    */
   @SuppressWarnings("PatternMatchingInstanceof")
   public Pager<CachedContent> list(ListCachedContentsConfig config) {
+    if (config == null) {
+      config = ListCachedContentsConfig.builder().build();
+    }
     Function<JsonSerializable, Object> request =
         requestConfig -> {
           if (!(requestConfig instanceof ListCachedContentsConfig)) {

src/main/java/com/google/genai/Documents.java

@@ -368,6 +368,7 @@ ListDocumentsResponse privateList(String parent, ListDocumentsConfig config) {
   /**
    * Makes an API request to list the available documents.
    *
+   * @param parent The name of the RagStore containing the Documents.
    * @param config A {@link ListDocumentsConfig} for configuring the list request.
    * @return A {@link Pager} object that contains the list of documents. The pager is an iterable
    *     and automatically queries the next page once the current page is exhausted.