@epilot/sdk 2.9.5 → 2.10.1

package/dist/{file.d-BjlMgTwj.d.cts → file.d-BN417xok.d.cts}

@@ -2353,6 +2353,12 @@ declare namespace Components {
          * https://some-api-url.com/download?file_id=123
          */
         export type CustomDownloadUrl = string; // uri
+        /**
+         * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+         * example:
+         * token
+         */
+        export type CustomDownloadUrlAuth = "presigned" | "token";
         export type DownloadFilesPayload = {
             id: /**
              * example:
@@ -2452,6 +2458,12 @@ declare namespace Components {
              * https://some-api-url.com/download?file_id=123
              */
             CustomDownloadUrl /* uri */;
+            custom_download_url_auth?: /**
+             * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+             * example:
+             * token
+             */
+            CustomDownloadUrlAuth;
             /**
              * Compact German summary for hover and list preview surfaces.
              */
@@ -2468,7 +2480,6 @@ declare namespace Components {
              * Short English paragraph summary for file preview surfaces.
              */
             short_summary_en?: string;
-            summary_status?: /* Current AI summary generation state for the file. */ FileSummaryStatus;
         }
         export interface FileCollectionAttributes {
             /**
@@ -2668,6 +2679,12 @@ declare namespace Components {
              * https://some-api-url.com/download?file_id=123
              */
             CustomDownloadUrl /* uri */;
+            custom_download_url_auth?: /**
+             * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+             * example:
+             * token
+             */
+            CustomDownloadUrlAuth;
             /**
              * Compact German summary for hover and list preview surfaces.
              */
@@ -2684,7 +2701,6 @@ declare namespace Components {
              * Short English paragraph summary for file preview surfaces.
              */
             short_summary_en?: string;
-            summary_status?: /* Current AI summary generation state for the file. */ FileSummaryStatus;
             /**
              * Source URL for the file. Included if the entity was created from source_url, or when ?source_url=true
              * example:
@@ -2756,13 +2772,52 @@ declare namespace Components {
             EntitySlug;
             _tags?: string[];
         }
-        export interface FileSummaryGenerationStatus {
-            status: /* Current AI summary generation state for the file. */ FileSummaryStatus;
+        export interface FileSummary {
+            status?: /* Current state of a file summary job. */ FileSummaryJobStatus;
+            /**
+             * Current summary job ID when available.
+             */
+            job_id?: string; // uuid
+            /**
+             * Compact German summary for hover and list preview surfaces.
+             */
+            preview_summary_de?: string | null;
+            /**
+             * Short German paragraph summary for file preview surfaces.
+             */
+            short_summary_de?: string | null;
+            /**
+             * Compact English summary for hover and list preview surfaces.
+             */
+            preview_summary_en?: string | null;
+            /**
+             * Short English paragraph summary for file preview surfaces.
+             */
+            short_summary_en?: string | null;
+        }
+        export interface FileSummaryJob {
+            /**
+             * File summary job ID.
+             */
+            job_id: string; // uuid
+            file_id: /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            FileEntityId;
+            status: /* Current state of a file summary job. */ FileSummaryJobStatus;
+            /**
+             * Human-readable failure or unsupported reason when available.
+             */
+            error?: string;
+            created_at: string; // date-time
+            updated_at: string; // date-time
+            completed_at?: string; // date-time
         }
         /**
-         * Current AI summary generation state for the file.
+         * Current state of a file summary job.
          */
-        export type FileSummaryStatus = "processing" | "completed" | "failed" | "unsupported";
+        export type FileSummaryJobStatus = "queued" | "waiting_for_extraction" | "processing" | "completed" | "failed" | "unsupported" | "stale";
         export type FileType = "document" | "document_template" | "text" | "image" | "video" | "audio" | "spreadsheet" | "presentation" | "font" | "archive" | "application" | "unknown";
         export interface FileUpload {
             s3ref?: S3Reference;
@@ -2887,6 +2942,12 @@ declare namespace Components {
              * https://some-api-url.com/download?file_id=123
              */
             CustomDownloadUrl /* uri */;
+            custom_download_url_auth?: /**
+             * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+             * example:
+             * token
+             */
+            CustomDownloadUrlAuth;
             /**
              * Compact German summary for hover and list preview surfaces.
              */
@@ -2903,7 +2964,6 @@ declare namespace Components {
              * Short English paragraph summary for file preview surfaces.
              */
             short_summary_en?: string;
-            summary_status?: /* Current AI summary generation state for the file. */ FileSummaryStatus;
         }
         export interface SaveFileFromSourceURLPayload {
             [name: string]: any;
@@ -2983,6 +3043,12 @@ declare namespace Components {
              * https://some-api-url.com/download?file_id=123
              */
             CustomDownloadUrl /* uri */;
+            custom_download_url_auth?: /**
+             * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+             * example:
+             * token
+             */
+            CustomDownloadUrlAuth;
             /**
              * Compact German summary for hover and list preview surfaces.
              */
@@ -2999,7 +3065,6 @@ declare namespace Components {
              * Short English paragraph summary for file preview surfaces.
              */
             short_summary_en?: string;
-            summary_status?: /* Current AI summary generation state for the file. */ FileSummaryStatus;
             source_url?: /**
              * Custom external download url used for the file
              * example:
@@ -3087,6 +3152,12 @@ declare namespace Components {
              * https://some-api-url.com/download?file_id=123
              */
             CustomDownloadUrl /* uri */;
+            custom_download_url_auth?: /**
+             * Authorization mode for the custom_download_url. `presigned` (the default) uses an HMAC-signed URL; `token` authorizes the download via the caller's bearer token, matched against the exact stored custom_download_url. In token mode the File API returns the unsigned custom_download_url (no expires_at/signature query params) so the stored url matches exactly.
+             * example:
+             * token
+             */
+            CustomDownloadUrlAuth;
             /**
              * Compact German summary for hover and list preview surfaces.
              */
@@ -3103,7 +3174,6 @@ declare namespace Components {
              * Short English paragraph summary for file preview surfaces.
              */
             short_summary_en?: string;
-            summary_status?: /* Current AI summary generation state for the file. */ FileSummaryStatus;
             s3ref?: S3Ref;
         }
         export interface UploadFilePayload {
@@ -3273,6 +3343,66 @@ declare namespace Paths {
             Components.Responses.InternalServerError;
         }
     }
+    namespace CreateFileSummaryJob {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.FileEntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $202 = Components.Schemas.FileSummaryJob;
+            export type $400 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 400,
+             *   "error": "Bad Request: filename is required"
+             * }
+             */
+            Components.Responses.BadRequestError;
+            export type $401 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 401,
+             *   "error": "Unauthorized: Invalid or expired token"
+             * }
+             */
+            Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found: File entity not found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+            export type $500 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 500,
+             *   "error": "Internal Server Error"
+             * }
+             */
+            Components.Responses.InternalServerError;
+        }
+    }
     namespace CreateUserSchemaFileCollection {
         namespace Parameters {
             export type Slug = string;
@@ -3643,7 +3773,7 @@ declare namespace Paths {
             id: Parameters.Id;
         }
         namespace Responses {
-            export type $202 = Components.Schemas.FileSummaryGenerationStatus;
+            export type $202 = Components.Schemas.FileSummaryJob;
             export type $400 = /**
              * A generic error returned by the API
              * example:
@@ -3680,15 +3810,60 @@ declare namespace Paths {
              * }
              */
             Components.Responses.NotFoundError;
-            export type $409 = /**
+            export type $500 = /**
              * A generic error returned by the API
              * example:
              * {
-             *   "status": 409,
-             *   "error": "Extracted file content is still being prepared"
+             *   "status": 500,
+             *   "error": "Internal Server Error"
              * }
              */
-            Components.Responses.ConflictError;
+            Components.Responses.InternalServerError;
+        }
+    }
+    namespace GeneratePublicLink {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.FileEntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            /**
+             * The public URL that can be shared externally
+             */
+            export type $201 = string;
+            export type $401 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 401,
+             *   "error": "Unauthorized: Invalid or expired token"
+             * }
+             */
+            Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found: File entity not found"
+             * }
+             */
+            Components.Responses.NotFoundError;
             export type $500 = /**
              * A generic error returned by the API
              * example:
@@ -3700,7 +3875,7 @@ declare namespace Paths {
             Components.Responses.InternalServerError;
         }
     }
-    namespace GeneratePublicLink {
+    namespace GetCurrentFileSummaryJob {
         namespace Parameters {
             export type Id = /**
              * example:
@@ -3712,10 +3887,16 @@ declare namespace Paths {
             id: Parameters.Id;
         }
         namespace Responses {
-            /**
-             * The public URL that can be shared externally
+            export type $200 = Components.Schemas.FileSummaryJob;
+            export type $400 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 400,
+             *   "error": "Bad Request: filename is required"
+             * }
              */
-            export type $201 = string;
+            Components.Responses.BadRequestError;
             export type $401 = /**
              * A generic error returned by the API
              * example:
@@ -3816,6 +3997,128 @@ declare namespace Paths {
             Components.Responses.InternalServerError;
         }
     }
+    namespace GetFileSummary {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.FileEntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FileSummary;
+            export type $400 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 400,
+             *   "error": "Bad Request: filename is required"
+             * }
+             */
+            Components.Responses.BadRequestError;
+            export type $401 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 401,
+             *   "error": "Unauthorized: Invalid or expired token"
+             * }
+             */
+            Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found: File entity not found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+            export type $500 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 500,
+             *   "error": "Internal Server Error"
+             * }
+             */
+            Components.Responses.InternalServerError;
+        }
+    }
+    namespace GetFileSummaryJob {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.FileEntityId;
+            export type JobId = string; // uuid
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+            job_id: Parameters.JobId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FileSummaryJob;
+            export type $400 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 400,
+             *   "error": "Bad Request: filename is required"
+             * }
+             */
+            Components.Responses.BadRequestError;
+            export type $401 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 401,
+             *   "error": "Unauthorized: Invalid or expired token"
+             * }
+             */
+            Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found: File entity not found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+            export type $500 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 500,
+             *   "error": "Internal Server Error"
+             * }
+             */
+            Components.Responses.InternalServerError;
+        }
+    }
     namespace GetFilesInCollection {
         namespace Parameters {
             export type CollectionSlug = string;
@@ -4722,10 +5025,50 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetZipJob.Responses.$200>
+  /**
+   * getFileSummary - getFileSummary
+   * 
+   * Get summary text for a file entity together with the current summary job status when available.
+   */
+  'getFileSummary'(
+    parameters?: Parameters<Paths.GetFileSummary.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFileSummary.Responses.$200>
+  /**
+   * createFileSummaryJob - createFileSummaryJob
+   * 
+   * Create or return the current AI summary job for a file entity.
+   */
+  'createFileSummaryJob'(
+    parameters?: Parameters<Paths.CreateFileSummaryJob.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateFileSummaryJob.Responses.$202>
+  /**
+   * getCurrentFileSummaryJob - getCurrentFileSummaryJob
+   * 
+   * Get the latest AI summary job for the file entity's current source.
+   */
+  'getCurrentFileSummaryJob'(
+    parameters?: Parameters<Paths.GetCurrentFileSummaryJob.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetCurrentFileSummaryJob.Responses.$200>
+  /**
+   * getFileSummaryJob - getFileSummaryJob
+   * 
+   * Get an AI summary job by id.
+   */
+  'getFileSummaryJob'(
+    parameters?: Parameters<Paths.GetFileSummaryJob.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFileSummaryJob.Responses.$200>
   /**
    * generateFileSummary - generateFileSummary
    * 
-   * Request AI generation of preview and short summaries for a file entity.
+   * Compatibility alias for creating or returning the current AI summary job for a file entity.
    */
   'generateFileSummary'(
     parameters?: Parameters<Paths.GenerateFileSummary.PathParameters> | null,
@@ -5183,11 +5526,59 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetZipJob.Responses.$200>
   }
+  ['/v1/files/{id}/summary']: {
+    /**
+     * getFileSummary - getFileSummary
+     * 
+     * Get summary text for a file entity together with the current summary job status when available.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFileSummary.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFileSummary.Responses.$200>
+  }
+  ['/v1/files/{id}/summary-jobs']: {
+    /**
+     * createFileSummaryJob - createFileSummaryJob
+     * 
+     * Create or return the current AI summary job for a file entity.
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateFileSummaryJob.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateFileSummaryJob.Responses.$202>
+  }
+  ['/v1/files/{id}/summary-jobs/current']: {
+    /**
+     * getCurrentFileSummaryJob - getCurrentFileSummaryJob
+     * 
+     * Get the latest AI summary job for the file entity's current source.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetCurrentFileSummaryJob.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetCurrentFileSummaryJob.Responses.$200>
+  }
+  ['/v1/files/{id}/summary-jobs/{job_id}']: {
+    /**
+     * getFileSummaryJob - getFileSummaryJob
+     * 
+     * Get an AI summary job by id.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFileSummaryJob.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFileSummaryJob.Responses.$200>
+  }
   ['/v1/files/{id}/summary:generate']: {
     /**
      * generateFileSummary - generateFileSummary
      * 
-     * Request AI generation of preview and short summaries for a file entity.
+     * Compatibility alias for creating or returning the current AI summary job for a file entity.
      */
     'post'(
       parameters?: Parameters<Paths.GenerateFileSummary.PathParameters> | null,
@@ -5490,6 +5881,7 @@ type BatchSaveFileVersionPayload = Components.Schemas.BatchSaveFileVersionPayloa
 type CommonSaveFilePayload = Components.Schemas.CommonSaveFilePayload;
 type CreateZipJobPayload = Components.Schemas.CreateZipJobPayload;
 type CustomDownloadUrl = Components.Schemas.CustomDownloadUrl;
+type CustomDownloadUrlAuth = Components.Schemas.CustomDownloadUrlAuth;
 type DownloadFilesPayload = Components.Schemas.DownloadFilesPayload;
 type EntityId = Components.Schemas.EntityId;
 type EntitySlug = Components.Schemas.EntitySlug;
@@ -5503,8 +5895,9 @@ type FileEntity = Components.Schemas.FileEntity;
 type FileEntityId = Components.Schemas.FileEntityId;
 type FileItem = Components.Schemas.FileItem;
 type FileRelationItem = Components.Schemas.FileRelationItem;
-type FileSummaryGenerationStatus = Components.Schemas.FileSummaryGenerationStatus;
-type FileSummaryStatus = Components.Schemas.FileSummaryStatus;
+type FileSummary = Components.Schemas.FileSummary;
+type FileSummaryJob = Components.Schemas.FileSummaryJob;
+type FileSummaryJobStatus = Components.Schemas.FileSummaryJobStatus;
 type FileType = Components.Schemas.FileType;
 type FileUpload = Components.Schemas.FileUpload;
 type PublicLink = Components.Schemas.PublicLink;
@@ -5519,4 +5912,4 @@ type UploadFilePayload = Components.Schemas.UploadFilePayload;
 type VerifyCustomDownloadUrlPayload = Components.Schemas.VerifyCustomDownloadUrlPayload;
 type ZipJob = Components.Schemas.ZipJob;
 
-export { type ActivityId as A, type BaseEntityAcl as B, type Client as C, type DownloadFilesPayload as D, type EntityId as E, type FileAttributes as F, type SaveFilePayloadV2 as G, type SaveS3FilePayload as H, type OperationMethods as O, Paths as P, type S3Ref as S, type UploadFilePayload as U, type VerifyCustomDownloadUrlPayload as V, type ZipJob as Z, Components as a, type PathsDictionary as b, type BaseEntityOwner as c, type BatchSaveFileVersionPayload as d, type CommonSaveFilePayload as e, type CreateZipJobPayload as f, type CustomDownloadUrl as g, type EntitySlug as h, type ErrorObject as i, type FileCollectionAttributes as j, type FileCollectionCreateRequest as k, type FileCollectionId as l, type FileCollectionItem as m, type FileEntity as n, type FileEntityId as o, type FileItem as p, type FileRelationItem as q, type FileSummaryGenerationStatus as r, type FileSummaryStatus as s, type FileType as t, type FileUpload as u, type PublicLink as v, type S3Reference as w, type SaveCustomFilePayload as x, type SaveFileFromSourceURLPayload as y, type SaveFilePayload as z };
+export { type ActivityId as A, type BaseEntityAcl as B, type Client as C, type DownloadFilesPayload as D, type EntityId as E, type FileAttributes as F, type SaveFileFromSourceURLPayload as G, type SaveFilePayload as H, type SaveFilePayloadV2 as I, type SaveS3FilePayload as J, type OperationMethods as O, Paths as P, type S3Ref as S, type UploadFilePayload as U, type VerifyCustomDownloadUrlPayload as V, type ZipJob as Z, Components as a, type PathsDictionary as b, type BaseEntityOwner as c, type BatchSaveFileVersionPayload as d, type CommonSaveFilePayload as e, type CreateZipJobPayload as f, type CustomDownloadUrl as g, type CustomDownloadUrlAuth as h, type EntitySlug as i, type ErrorObject as j, type FileCollectionAttributes as k, type FileCollectionCreateRequest as l, type FileCollectionId as m, type FileCollectionItem as n, type FileEntity as o, type FileEntityId as p, type FileItem as q, type FileRelationItem as r, type FileSummary as s, type FileSummaryJob as t, type FileSummaryJobStatus as u, type FileType as v, type FileUpload as w, type PublicLink as x, type S3Reference as y, type SaveCustomFilePayload as z };