feat: add s3 provider to files API

Signed-off-by: Sébastien Han <seb@redhat.com>

docs/_static/llama-stack-spec.yaml

@@ -379,11 +379,12 @@ paths:
     get:
       responses:
         '200':
-          description: OK
+          description: >-
+            PaginatedResponse with the list of buckets
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ListBucketResponse'
+                $ref: '#/components/schemas/PaginatedResponse'
         '400':
           $ref: '#/components/responses/BadRequest400'
         '429':
@@ -398,11 +399,20 @@ paths:
         - Files
       description: List all buckets.
       parameters:
-        - name: bucket
+        - name: page
           in: query
-          required: true
+          description: >-
+            The page number (1-based). If None, starts from first page.
+          required: false
           schema:
-            type: string
+            type: integer
+        - name: size
+          in: query
+          description: >-
+            Number of items per page. If None or -1, returns all items.
+          required: false
+          schema:
+            type: integer
     post:
       responses:
         '200':
@@ -1261,7 +1271,7 @@ paths:
         - PostTraining (Coming Soon)
       description: ''
       parameters: []
-  /v1/files/session:{upload_id}:
+  /v1/files/session/{upload_id}:
     get:
       responses:
         '200':
@@ -1816,11 +1826,11 @@ paths:
     get:
       responses:
         '200':
-          description: OK
+          description: PaginatedResponse with the list of files
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ListFileResponse'
+                $ref: '#/components/schemas/PaginatedResponse'
         '400':
           $ref: '#/components/responses/BadRequest400'
         '429':
@@ -1841,6 +1851,20 @@ paths:
           required: true
           schema:
             type: string
+        - name: page
+          in: query
+          description: >-
+            The page number (1-based). If None, starts from first page.
+          required: false
+          schema:
+            type: integer
+        - name: size
+          in: query
+          description: >-
+            Number of items per page. If None or -1, returns all items.
+          required: false
+          schema:
+            type: integer
   /v1/models:
     get:
       responses:
@@ -6277,29 +6301,6 @@ components:
         - job_id
         - status
       title: Job
-    BucketResponse:
-      type: object
-      properties:
-        name:
-          type: string
-      additionalProperties: false
-      required:
-        - name
-      title: BucketResponse
-    ListBucketResponse:
-      type: object
-      properties:
-        data:
-          type: array
-          items:
-            $ref: '#/components/schemas/BucketResponse'
-          description: List of FileResponse entries
-      additionalProperties: false
-      required:
-        - data
-      title: ListBucketResponse
-      description: >-
-        Response representing a list of file entries.
     ListBenchmarksResponse:
       type: object
       properties:
@@ -6322,20 +6323,6 @@ components:
       required:
         - data
       title: ListDatasetsResponse
-    ListFileResponse:
-      type: object
-      properties:
-        data:
-          type: array
-          items:
-            $ref: '#/components/schemas/FileResponse'
-          description: List of FileResponse entries
-      additionalProperties: false
-      required:
-        - data
-      title: ListFileResponse
-      description: >-
-        Response representing a list of file entries.
     ListModelsResponse:
       type: object
       properties: