Delete the files a folder owns when the folder or the file is removed (#33001)

Stainless-Generated-From: eefd9be86cba8f2fa9fc19b39da635fe9c86ed0c

Author: stlc-bot

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/beta/directories/DirectoryDeleteParams.kt

@@ -11,7 +11,7 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Permanently delete a directory. */
+/** Permanently delete a directory, and the files in it that no other directory or index uses. */
 class DirectoryDeleteParams
 private constructor(
     private val directoryId: String?,

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/beta/directories/files/FileDeleteParams.kt

@@ -15,6 +15,8 @@ import kotlin.jvm.optionals.getOrNull
 /**
  * Delete a directory file by `directory_file_id`; to resolve from `unique_id`, list with a filter
  * first.
+ *
+ * The uploaded file is deleted with it unless another directory or index still uses it.
  */
 class FileDeleteParams
 private constructor(

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/beta/DirectoryServiceAsync.kt

@@ -104,7 +104,9 @@ interface DirectoryServiceAsync {
     fun list(requestOptions: RequestOptions): CompletableFuture<DirectoryListPageAsync> =
         list(DirectoryListParams.none(), requestOptions)
 
-    /** Permanently delete a directory. */
+    /**
+     * Permanently delete a directory, and the files in it that no other directory or index uses.
+     */
     fun delete(directoryId: String): CompletableFuture<Void?> =
         delete(directoryId, DirectoryDeleteParams.none())
 

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/beta/directories/FileServiceAsync.kt

@@ -100,6 +100,8 @@ interface FileServiceAsync {
     /**
      * Delete a directory file by `directory_file_id`; to resolve from `unique_id`, list with a
      * filter first.
+     *
+     * The uploaded file is deleted with it unless another directory or index still uses it.
      */
     fun delete(directoryFileId: String, params: FileDeleteParams): CompletableFuture<Void?> =
         delete(directoryFileId, params, RequestOptions.none())

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/beta/DirectoryService.kt

@@ -99,7 +99,9 @@ interface DirectoryService {
     fun list(requestOptions: RequestOptions): DirectoryListPage =
         list(DirectoryListParams.none(), requestOptions)
 
-    /** Permanently delete a directory. */
+    /**
+     * Permanently delete a directory, and the files in it that no other directory or index uses.
+     */
     fun delete(directoryId: String) = delete(directoryId, DirectoryDeleteParams.none())
 
     /** @see delete */

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/beta/directories/FileService.kt

@@ -88,6 +88,8 @@ interface FileService {
     /**
      * Delete a directory file by `directory_file_id`; to resolve from `unique_id`, list with a
      * filter first.
+     *
+     * The uploaded file is deleted with it unless another directory or index still uses it.
      */
     fun delete(directoryFileId: String, params: FileDeleteParams) =
         delete(directoryFileId, params, RequestOptions.none())