@epilot/file-client 1.26.0 → 1.27.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 epilot GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={438(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var i=n(t(466));r.default=i.default},466(e){e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v2/files/upload":{"post":{"operationId":"uploadFileV2","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files":{"post":{"operationId":"saveFileV2","parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/FillActivityQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"},{"$ref":"#/components/parameters/DeleteTempFileQueryParam"},{"$ref":"#/components/parameters/VersionOnlyQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","deprecated":true,"parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files":{"post":{"operationId":"saveFile","deprecated":true,"parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"},{"$ref":"#/components/parameters/VersionOnlyQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files/{id}":{"get":{"operationId":"getFile","parameters":[{"name":"id","in":"path","required":true},{"name":"source_url","in":"query"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"responses":{}},"delete":{"operationId":"deleteFile","parameters":[{"name":"id","in":"path","required":true},{"name":"purge","in":"query"},{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"}],"responses":{}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadS3":{"post":{"operationId":"downloadS3File","parameters":[{"name":"s3_key","in":"query","required":true},{"name":"s3_bucket","in":"query","required":true},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files:zipJob":{"post":{"operationId":"createZipJob","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files:zipJob/{job_id}":{"get":{"operationId":"getZipJob","parameters":[{"name":"job_id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary:generate":{"post":{"operationId":"generateFileSummary","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/preview":{"get":{"operationId":"previewFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files:previewS3":{"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}},"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files/public/{id}/preview":{"get":{"operationId":"previewPublicFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"},{"name":"org_id","in":"query"}],"responses":{}}},"/v1/files/session":{"get":{"operationId":"getSession","responses":{}},"delete":{"operationId":"deleteSession","responses":{}}},"/v1/files/{id}/public/links":{"post":{"operationId":"generatePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}},"get":{"operationId":"listPublicLinksForFile","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/public/links/{id}/{filename}":{"get":{"operationId":"accessPublicLink","parameters":[{"name":"id","in":"path","required":true},{"name":"filename","in":"path","required":true},{"name":"hash","in":"query","required":false}],"responses":{}}},"/v1/files/public/links/{id}":{"delete":{"operationId":"revokePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/download:verify":{"post":{"operationId":"verifyCustomDownloadUrl","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/{slug}/collections":{"get":{"operationId":"getUserSchemaFileCollections","parameters":[{"name":"slug","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/{slug}/collections/{collectionSlug}":{"put":{"operationId":"updateUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true},{"name":"collectionSlug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true},{"name":"collectionSlug","in":"path","required":true}],"responses":{}}},"/v1/entity/{id}/collections/{collectionSlug}/files":{"get":{"operationId":"getFilesInCollection","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"collectionSlug","in":"path","required":true}],"responses":{}}},"/v1/collections/{schemaSlug}":{"get":{"operationId":"getGlobalFileCollections","parameters":[{"name":"schemaSlug","in":"path","required":true}],"responses":{}}}},"components":{"parameters":{"EntityIdPathParam":{"name":"id","in":"path","required":true},"StrictQueryParam":{"name":"strict","in":"query","required":false},"ActivityIdQueryParam":{"name":"activity_id","in":"query","required":false},"FillActivityQueryParam":{"name":"fill_activity","in":"query","required":false},"AsyncOperationQueryParam":{"name":"async","in":"query","required":false},"DeleteTempFileQueryParam":{"name":"delete_temp_file","in":"query","required":false},"VersionOnlyQueryParam":{"name":"version_only","in":"query","required":false}},"responses":{"BadRequestError":{"content":{"application/json":{}}},"UnauthorizedError":{"content":{"application/json":{}}},"ForbiddenError":{"content":{"application/json":{}}},"NotFoundError":{"content":{"application/json":{}}},"ConflictError":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}}}},"servers":[{"url":"https://file.sls.epilot.io"}]}')}},r={},t=function t(n){var i=r[n];if(void 0!==i)return i.exports;var a=r[n]={exports:{}};return e[n].call(a.exports,a,a.exports,t),a.exports}(438),n=exports;for(var i in t)n[i]=t[i];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={438(e,r,t){var i=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var n=i(t(466));r.default=n.default},466(e){e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v2/files/upload":{"post":{"operationId":"uploadFileV2","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files":{"post":{"operationId":"saveFileV2","parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/FillActivityQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"},{"$ref":"#/components/parameters/DeleteTempFileQueryParam"},{"$ref":"#/components/parameters/VersionOnlyQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","deprecated":true,"parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files":{"post":{"operationId":"saveFile","deprecated":true,"parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"},{"$ref":"#/components/parameters/VersionOnlyQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files/{id}":{"get":{"operationId":"getFile","parameters":[{"name":"id","in":"path","required":true},{"name":"source_url","in":"query"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"responses":{}},"delete":{"operationId":"deleteFile","parameters":[{"name":"id","in":"path","required":true},{"name":"purge","in":"query"},{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"}],"responses":{}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadS3":{"post":{"operationId":"downloadS3File","parameters":[{"name":"s3_key","in":"query","required":true},{"name":"s3_bucket","in":"query","required":true},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files:zipJob":{"post":{"operationId":"createZipJob","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files:zipJob/{job_id}":{"get":{"operationId":"getZipJob","parameters":[{"name":"job_id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary":{"get":{"operationId":"getFileSummary","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary-jobs":{"post":{"operationId":"createFileSummaryJob","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary-jobs/current":{"get":{"operationId":"getCurrentFileSummaryJob","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary-jobs/{job_id}":{"get":{"operationId":"getFileSummaryJob","parameters":[{"name":"id","in":"path","required":true},{"name":"job_id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/summary:generate":{"post":{"operationId":"generateFileSummary","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/{id}/preview":{"get":{"operationId":"previewFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files:previewS3":{"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}},"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files/public/{id}/preview":{"get":{"operationId":"previewPublicFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"},{"name":"org_id","in":"query"}],"responses":{}}},"/v1/files/session":{"get":{"operationId":"getSession","responses":{}},"delete":{"operationId":"deleteSession","responses":{}}},"/v1/files/{id}/public/links":{"post":{"operationId":"generatePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}},"get":{"operationId":"listPublicLinksForFile","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/public/links/{id}/{filename}":{"get":{"operationId":"accessPublicLink","parameters":[{"name":"id","in":"path","required":true},{"name":"filename","in":"path","required":true},{"name":"hash","in":"query","required":false}],"responses":{}}},"/v1/files/public/links/{id}":{"delete":{"operationId":"revokePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/download:verify":{"post":{"operationId":"verifyCustomDownloadUrl","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/{slug}/collections":{"get":{"operationId":"getUserSchemaFileCollections","parameters":[{"name":"slug","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/{slug}/collections/{collectionSlug}":{"put":{"operationId":"updateUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true},{"name":"collectionSlug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUserSchemaFileCollection","parameters":[{"name":"slug","in":"path","required":true},{"name":"collectionSlug","in":"path","required":true}],"responses":{}}},"/v1/entity/{id}/collections/{collectionSlug}/files":{"get":{"operationId":"getFilesInCollection","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"collectionSlug","in":"path","required":true}],"responses":{}}},"/v1/collections/{schemaSlug}":{"get":{"operationId":"getGlobalFileCollections","parameters":[{"name":"schemaSlug","in":"path","required":true}],"responses":{}}}},"components":{"parameters":{"EntityIdPathParam":{"name":"id","in":"path","required":true},"StrictQueryParam":{"name":"strict","in":"query","required":false},"ActivityIdQueryParam":{"name":"activity_id","in":"query","required":false},"FillActivityQueryParam":{"name":"fill_activity","in":"query","required":false},"AsyncOperationQueryParam":{"name":"async","in":"query","required":false},"DeleteTempFileQueryParam":{"name":"delete_temp_file","in":"query","required":false},"VersionOnlyQueryParam":{"name":"version_only","in":"query","required":false}},"responses":{"BadRequestError":{"content":{"application/json":{}}},"UnauthorizedError":{"content":{"application/json":{}}},"ForbiddenError":{"content":{"application/json":{}}},"NotFoundError":{"content":{"application/json":{}}},"ConflictError":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}}}},"servers":[{"url":"https://file.sls.epilot.io"}]}')}},r={},t=function t(i){var n=r[i];if(void 0!==n)return n.exports;var a=r[i]={exports:{}};return e[i].call(a.exports,a,a.exports,t),a.exports}(438),i=exports;for(var n in t)i[n]=t[n];t.__esModule&&Object.defineProperty(i,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -216,6 +216,63 @@
         "responses": {}
       }
     },
+    "/v1/files/{id}/summary": {
+      "get": {
+        "operationId": "getFileSummary",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/files/{id}/summary-jobs": {
+      "post": {
+        "operationId": "createFileSummaryJob",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/files/{id}/summary-jobs/current": {
+      "get": {
+        "operationId": "getCurrentFileSummaryJob",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/files/{id}/summary-jobs/{job_id}": {
+      "get": {
+        "operationId": "getFileSummaryJob",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true
+          },
+          {
+            "name": "job_id",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
     "/v1/files/{id}/summary:generate": {
       "post": {
         "operationId": "generateFileSummary",

package/dist/openapi.d.ts

@@ -2356,6 +2356,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:
@@ -2455,6 +2461,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.
              */
@@ -2471,7 +2483,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 {
             /**
@@ -2671,6 +2682,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.
              */
@@ -2687,7 +2704,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:
@@ -2759,13 +2775,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;
@@ -2890,6 +2945,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.
              */
@@ -2906,7 +2967,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;
@@ -2986,6 +3046,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.
              */
@@ -3002,7 +3068,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:
@@ -3090,6 +3155,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.
              */
@@ -3106,7 +3177,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 {
@@ -3276,6 +3346,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;
@@ -3646,7 +3776,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:
@@ -3683,15 +3813,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:
@@ -3703,7 +3878,7 @@ declare namespace Paths {
             Components.Responses.InternalServerError;
         }
     }
-    namespace GeneratePublicLink {
+    namespace GetCurrentFileSummaryJob {
         namespace Parameters {
             export type Id = /**
              * example:
@@ -3715,10 +3890,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:
@@ -3819,6 +4000,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;
@@ -4725,10 +5028,50 @@ export 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,
@@ -5186,11 +5529,59 @@ export 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,
@@ -5493,6 +5884,7 @@ export type BatchSaveFileVersionPayload = Components.Schemas.BatchSaveFileVersio
 export type CommonSaveFilePayload = Components.Schemas.CommonSaveFilePayload;
 export type CreateZipJobPayload = Components.Schemas.CreateZipJobPayload;
 export type CustomDownloadUrl = Components.Schemas.CustomDownloadUrl;
+export type CustomDownloadUrlAuth = Components.Schemas.CustomDownloadUrlAuth;
 export type DownloadFilesPayload = Components.Schemas.DownloadFilesPayload;
 export type EntityId = Components.Schemas.EntityId;
 export type EntitySlug = Components.Schemas.EntitySlug;
@@ -5506,8 +5898,9 @@ export type FileEntity = Components.Schemas.FileEntity;
 export type FileEntityId = Components.Schemas.FileEntityId;
 export type FileItem = Components.Schemas.FileItem;
 export type FileRelationItem = Components.Schemas.FileRelationItem;
-export type FileSummaryGenerationStatus = Components.Schemas.FileSummaryGenerationStatus;
-export type FileSummaryStatus = Components.Schemas.FileSummaryStatus;
+export type FileSummary = Components.Schemas.FileSummary;
+export type FileSummaryJob = Components.Schemas.FileSummaryJob;
+export type FileSummaryJobStatus = Components.Schemas.FileSummaryJobStatus;
 export type FileType = Components.Schemas.FileType;
 export type FileUpload = Components.Schemas.FileUpload;
 export type PublicLink = Components.Schemas.PublicLink;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "File API",
-    "version": "1.10.0",
+    "version": "1.12.0",
     "description": "The File API enables you to upload, store, manage, and share files within the epilot platform.\n\n## Key Features\n- **Upload files** to temporary storage and save them permanently as File entities\n- **Generate previews** (thumbnails) for images and documents\n- **Create public links** to share private files externally\n- **Organize files** into collections for better management\n- **Version control** with automatic file versioning on updates\n\n## File Upload Workflow\n1. Call `uploadFileV2` to get a pre-signed S3 URL\n2. Upload your file directly to S3 using the pre-signed URL (PUT request)\n3. Call `saveFileV2` with the S3 reference to create a permanent File entity\n\n## Changelog\n<a href=\"changelog\">View API Changelog</a>\n"
   },
   "tags": [
@@ -875,11 +875,213 @@
         }
       }
     },
+    "/v1/files/{id}/summary": {
+      "get": {
+        "operationId": "getFileSummary",
+        "summary": "getFileSummary",
+        "description": "Get summary text for a file entity together with the current summary job status when available.",
+        "tags": [
+          "File"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the file entity",
+            "schema": {
+              "$ref": "#/components/schemas/FileEntityId"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Current file summary state",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileSummary"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/files/{id}/summary-jobs": {
+      "post": {
+        "operationId": "createFileSummaryJob",
+        "summary": "createFileSummaryJob",
+        "description": "Create or return the current AI summary job for a file entity.",
+        "tags": [
+          "File"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the file entity",
+            "schema": {
+              "$ref": "#/components/schemas/FileEntityId"
+            }
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Summary job accepted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileSummaryJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/files/{id}/summary-jobs/current": {
+      "get": {
+        "operationId": "getCurrentFileSummaryJob",
+        "summary": "getCurrentFileSummaryJob",
+        "description": "Get the latest AI summary job for the file entity's current source.",
+        "tags": [
+          "File"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the file entity",
+            "schema": {
+              "$ref": "#/components/schemas/FileEntityId"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Current summary job",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileSummaryJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/files/{id}/summary-jobs/{job_id}": {
+      "get": {
+        "operationId": "getFileSummaryJob",
+        "summary": "getFileSummaryJob",
+        "description": "Get an AI summary job by id.",
+        "tags": [
+          "File"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the file entity",
+            "schema": {
+              "$ref": "#/components/schemas/FileEntityId"
+            }
+          },
+          {
+            "name": "job_id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the summary job",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Summary job",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileSummaryJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/files/{id}/summary:generate": {
       "post": {
         "operationId": "generateFileSummary",
         "summary": "generateFileSummary",
-        "description": "Request AI generation of preview and short summaries for a file entity.",
+        "description": "Compatibility alias for creating or returning the current AI summary job for a file entity.",
         "tags": [
           "File"
         ],
@@ -900,7 +1102,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileSummaryGenerationStatus"
+                  "$ref": "#/components/schemas/FileSummaryJob"
                 }
               }
             }
@@ -917,9 +1119,6 @@
           "404": {
             "$ref": "#/components/responses/NotFoundError"
           },
-          "409": {
-            "$ref": "#/components/responses/ConflictError"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -2196,6 +2395,9 @@
           "custom_download_url": {
             "$ref": "#/components/schemas/CustomDownloadUrl"
           },
+          "custom_download_url_auth": {
+            "$ref": "#/components/schemas/CustomDownloadUrlAuth"
+          },
           "preview_summary_de": {
             "type": "string",
             "description": "Compact German summary for hover and list preview surfaces.",
@@ -2215,9 +2417,6 @@
             "type": "string",
             "description": "Short English paragraph summary for file preview surfaces.",
             "readOnly": true
-          },
-          "summary_status": {
-            "$ref": "#/components/schemas/FileSummaryStatus"
           }
         }
       },
@@ -2238,34 +2437,108 @@
           "unknown"
         ]
       },
-      "FileSummaryStatus": {
+      "FileSummaryJobStatus": {
         "type": "string",
-        "description": "Current AI summary generation state for the file.",
+        "description": "Current state of a file summary job.",
         "enum": [
+          "queued",
+          "waiting_for_extraction",
           "processing",
           "completed",
           "failed",
-          "unsupported"
+          "unsupported",
+          "stale"
         ],
         "readOnly": true
       },
-      "FileSummaryGenerationStatus": {
+      "FileSummaryJob": {
         "type": "object",
         "properties": {
+          "job_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "File summary job ID."
+          },
+          "file_id": {
+            "$ref": "#/components/schemas/FileEntityId"
+          },
           "status": {
-            "$ref": "#/components/schemas/FileSummaryStatus"
+            "$ref": "#/components/schemas/FileSummaryJobStatus"
+          },
+          "error": {
+            "type": "string",
+            "description": "Human-readable failure or unsupported reason when available."
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "completed_at": {
+            "type": "string",
+            "format": "date-time"
           }
         },
         "required": [
-          "status"
+          "job_id",
+          "file_id",
+          "status",
+          "created_at",
+          "updated_at"
         ]
       },
+      "FileSummary": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "$ref": "#/components/schemas/FileSummaryJobStatus"
+          },
+          "job_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Current summary job ID when available."
+          },
+          "preview_summary_de": {
+            "type": "string",
+            "nullable": true,
+            "description": "Compact German summary for hover and list preview surfaces."
+          },
+          "short_summary_de": {
+            "type": "string",
+            "nullable": true,
+            "description": "Short German paragraph summary for file preview surfaces."
+          },
+          "preview_summary_en": {
+            "type": "string",
+            "nullable": true,
+            "description": "Compact English summary for hover and list preview surfaces."
+          },
+          "short_summary_en": {
+            "type": "string",
+            "nullable": true,
+            "description": "Short English paragraph summary for file preview surfaces."
+          }
+        }
+      },
       "CustomDownloadUrl": {
         "description": "Custom external download url used for the file",
         "type": "string",
         "format": "uri",
         "example": "https://some-api-url.com/download?file_id=123"
       },
+      "CustomDownloadUrlAuth": {
+        "description": "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.",
+        "type": "string",
+        "enum": [
+          "presigned",
+          "token"
+        ],
+        "default": "presigned",
+        "example": "token"
+      },
       "FileEntity": {
         "allOf": [
           {
@@ -2437,6 +2710,9 @@
             "properties": {
               "custom_download_url": {
                 "$ref": "#/components/schemas/CustomDownloadUrl"
+              },
+              "custom_download_url_auth": {
+                "$ref": "#/components/schemas/CustomDownloadUrlAuth"
               }
             }
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/file-client",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "description": "Client library for the epilot File API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",