@knowledge-stack/ksapi 1.142.1 → 1.142.2

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.142.1
+# @knowledge-stack/ksapi@1.142.2
 
 A TypeScript SDK client for the localhost API.
 
@@ -125,6 +125,7 @@ All URIs are relative to *http://localhost:8000*
 *DocumentCheckoutApi* | [**acquireDocumentCheckout**](docs/DocumentCheckoutApi.md#acquiredocumentcheckout) | **POST** /v1/documents/{document_id}/checkout | Acquire Document Checkout Handler
 *DocumentCheckoutApi* | [**getDocumentCheckout**](docs/DocumentCheckoutApi.md#getdocumentcheckout) | **GET** /v1/documents/{document_id}/checkout | Get Document Checkout Handler
 *DocumentCheckoutApi* | [**releaseDocumentCheckout**](docs/DocumentCheckoutApi.md#releasedocumentcheckout) | **DELETE** /v1/documents/{document_id}/checkout | Release Document Checkout Handler
+*DocumentVersionsApi* | [**attachCitedAsset**](docs/DocumentVersionsApi.md#attachcitedasset) | **POST** /v1/document_versions/{version_id}/cited-asset | Attach Cited Asset Handler
 *DocumentVersionsApi* | [**clearDocumentVersionContents**](docs/DocumentVersionsApi.md#cleardocumentversioncontents) | **DELETE** /v1/document_versions/{version_id}/contents | Clear Document Version Contents Handler
 *DocumentVersionsApi* | [**createDocumentVersion**](docs/DocumentVersionsApi.md#createdocumentversion) | **POST** /v1/documents/{document_id}/versions | Create Document Version Handler
 *DocumentVersionsApi* | [**deleteDocumentVersion**](docs/DocumentVersionsApi.md#deletedocumentversion) | **DELETE** /v1/document_versions/{version_id} | Delete Document Version Handler
@@ -669,7 +670,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.142.1`
+- Package version: `1.142.2`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/DocumentVersionsApi.d.ts

@@ -11,6 +11,10 @@
  */
 import * as runtime from '../runtime';
 import type { ClearVersionContentsResponse, DocumentDownloadResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionContentTypeFilter, DocumentVersionMetadataUpdate, DocumentVersionOrder, DocumentVersionResponse, DownloadArtifact, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse, SortDirection, VersionDiffResponse } from '../models/index';
+export interface AttachCitedAssetRequest {
+    versionId: string;
+    file: Blob;
+}
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
 }
@@ -66,6 +70,29 @@ export interface UpdateDocumentVersionMetadataRequest {
  * @interface DocumentVersionsApiInterface
  */
 export interface DocumentVersionsApiInterface {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * @summary Attach Cited Asset Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      * @param {string} versionId DocumentVersion ID
@@ -316,6 +343,20 @@ export interface DocumentVersionsApiInterface {
  *
  */
 export declare class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVersionsApiInterface {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     */
+    attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      */

package/dist/apis/DocumentVersionsApi.js

@@ -62,6 +62,75 @@ const index_1 = require("../models/index");
  *
  */
 class DocumentVersionsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     */
+    attachCitedAssetRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['versionId'] == null) {
+                throw new runtime.RequiredError('versionId', 'Required parameter "versionId" was null or undefined when calling attachCitedAsset().');
+            }
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling attachCitedAsset().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            let urlPath = `/v1/document_versions/{version_id}/cited-asset`;
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            };
+        });
+    }
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAssetRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.attachCitedAssetRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.attachCitedAssetRaw(requestParameters, initOverrides);
+        });
+    }
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      */

package/dist/esm/apis/DocumentVersionsApi.d.ts

@@ -11,6 +11,10 @@
  */
 import * as runtime from '../runtime';
 import type { ClearVersionContentsResponse, DocumentDownloadResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionContentTypeFilter, DocumentVersionMetadataUpdate, DocumentVersionOrder, DocumentVersionResponse, DownloadArtifact, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse, SortDirection, VersionDiffResponse } from '../models/index';
+export interface AttachCitedAssetRequest {
+    versionId: string;
+    file: Blob;
+}
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
 }
@@ -66,6 +70,29 @@ export interface UpdateDocumentVersionMetadataRequest {
  * @interface DocumentVersionsApiInterface
  */
 export interface DocumentVersionsApiInterface {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * @summary Attach Cited Asset Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      * @param {string} versionId DocumentVersion ID
@@ -316,6 +343,20 @@ export interface DocumentVersionsApiInterface {
  *
  */
 export declare class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVersionsApiInterface {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     */
+    attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      */

package/dist/esm/apis/DocumentVersionsApi.js

@@ -26,6 +26,75 @@ import { ClearVersionContentsResponseFromJSON, DocumentDownloadResponseFromJSON,
  *
  */
 export class DocumentVersionsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     */
+    attachCitedAssetRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['versionId'] == null) {
+                throw new runtime.RequiredError('versionId', 'Required parameter "versionId" was null or undefined when calling attachCitedAsset().');
+            }
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling attachCitedAsset().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            let urlPath = `/v1/document_versions/{version_id}/cited-asset`;
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            };
+        });
+    }
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAssetRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.attachCitedAssetRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.attachCitedAssetRaw(requestParameters, initOverrides);
+        });
+    }
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      */

package/dist/esm/models/DocumentVersionMetadata.d.ts

@@ -45,6 +45,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     preconversionSourceS3?: string | null;
+    /**
+     * S3 URL to the agent's cited copy of the source (KS Citation comments intact); null unless the agent uploaded a file carrying citations. Read only for the agent edit round-trip so a follow-up chat re-extracts citation anchors instead of losing them; source_s3 stays the clean artifact served to chunking, the FE viewer, and downloads.
+     * @type {string}
+     * @memberof DocumentVersionMetadata
+     */
+    citedSourceS3?: string | null;
     /**
      * S3 URL to the fast plaintext export of the document
      * @type {string}

package/dist/esm/models/DocumentVersionMetadata.js

@@ -32,6 +32,7 @@ export function DocumentVersionMetadataFromJSONTyped(json, ignoreDiscriminator)
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'hash': json['hash'] == null ? undefined : json['hash'],
         'pipelineState': json['pipeline_state'] == null ? undefined : PipelineStateFromJSON(json['pipeline_state']),
@@ -61,6 +62,7 @@ export function DocumentVersionMetadataToJSONTyped(value, ignoreDiscriminator =
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'hash': value['hash'],
         'pipeline_state': PipelineStateToJSON(value['pipelineState']),

package/dist/esm/models/DocumentVersionMetadataUpdate.d.ts

@@ -39,6 +39,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     preconversionSourceS3?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    citedSourceS3?: string | null;
     /**
      *
      * @type {string}

package/dist/esm/models/DocumentVersionMetadataUpdate.js

@@ -32,6 +32,7 @@ export function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscrimin
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'standardPipelineJsonS3': json['standard_pipeline_json_s3'] == null ? undefined : json['standard_pipeline_json_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'highAccuracyContentListS3': json['high_accuracy_content_list_s3'] == null ? undefined : json['high_accuracy_content_list_s3'],
@@ -64,6 +65,7 @@ export function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscrimina
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'standard_pipeline_json_s3': value['standardPipelineJsonS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'high_accuracy_content_list_s3': value['highAccuracyContentListS3'],

package/dist/esm/models/DocumentVersionResponse.d.ts

@@ -92,6 +92,12 @@ export interface DocumentVersionResponse {
      * @memberof DocumentVersionResponse
      */
     assetS3Url?: string | null;
+    /**
+     * Presigned URL (6-hour validity) to the agent's cited copy of the source, with KS Citation comments intact; null unless one was stored. For the agent edit round-trip only — human downloads and the FE viewer use asset_s3_url (clean) and render citations from citation_anchors.
+     * @type {string}
+     * @memberof DocumentVersionResponse
+     */
+    citedAssetS3Url?: string | null;
     /**
      * Presigned URL to download the fast plaintext export (6-hour validity)
      * @type {string}

package/dist/esm/models/DocumentVersionResponse.js

@@ -62,6 +62,7 @@ export function DocumentVersionResponseFromJSONTyped(json, ignoreDiscriminator)
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
         'assetS3Url': json['asset_s3_url'] == null ? undefined : json['asset_s3_url'],
+        'citedAssetS3Url': json['cited_asset_s3_url'] == null ? undefined : json['cited_asset_s3_url'],
         'fastPlaintextUrl': json['fast_plaintext_url'] == null ? undefined : json['fast_plaintext_url'],
         'pageScreenshotUrls': json['page_screenshot_urls'] == null ? undefined : json['page_screenshot_urls'],
         'systemMetadata': json['system_metadata'] == null ? undefined : DocumentVersionMetadataFromJSON(json['system_metadata']),
@@ -87,6 +88,7 @@ export function DocumentVersionResponseToJSONTyped(value, ignoreDiscriminator =
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
         'asset_s3_url': value['assetS3Url'],
+        'cited_asset_s3_url': value['citedAssetS3Url'],
         'fast_plaintext_url': value['fastPlaintextUrl'],
         'page_screenshot_urls': value['pageScreenshotUrls'],
         'system_metadata': DocumentVersionMetadataToJSON(value['systemMetadata']),

package/dist/models/DocumentVersionMetadata.d.ts

@@ -45,6 +45,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     preconversionSourceS3?: string | null;
+    /**
+     * S3 URL to the agent's cited copy of the source (KS Citation comments intact); null unless the agent uploaded a file carrying citations. Read only for the agent edit round-trip so a follow-up chat re-extracts citation anchors instead of losing them; source_s3 stays the clean artifact served to chunking, the FE viewer, and downloads.
+     * @type {string}
+     * @memberof DocumentVersionMetadata
+     */
+    citedSourceS3?: string | null;
     /**
      * S3 URL to the fast plaintext export of the document
      * @type {string}

package/dist/models/DocumentVersionMetadata.js

@@ -40,6 +40,7 @@ function DocumentVersionMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'hash': json['hash'] == null ? undefined : json['hash'],
         'pipelineState': json['pipeline_state'] == null ? undefined : (0, PipelineState_1.PipelineStateFromJSON)(json['pipeline_state']),
@@ -69,6 +70,7 @@ function DocumentVersionMetadataToJSONTyped(value, ignoreDiscriminator = false)
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'hash': value['hash'],
         'pipeline_state': (0, PipelineState_1.PipelineStateToJSON)(value['pipelineState']),

package/dist/models/DocumentVersionMetadataUpdate.d.ts

@@ -39,6 +39,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     preconversionSourceS3?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    citedSourceS3?: string | null;
     /**
      *
      * @type {string}

package/dist/models/DocumentVersionMetadataUpdate.js

@@ -40,6 +40,7 @@ function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscriminator) {
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'standardPipelineJsonS3': json['standard_pipeline_json_s3'] == null ? undefined : json['standard_pipeline_json_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'highAccuracyContentListS3': json['high_accuracy_content_list_s3'] == null ? undefined : json['high_accuracy_content_list_s3'],
@@ -72,6 +73,7 @@ function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscriminator = f
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'standard_pipeline_json_s3': value['standardPipelineJsonS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'high_accuracy_content_list_s3': value['highAccuracyContentListS3'],

package/dist/models/DocumentVersionResponse.d.ts

@@ -92,6 +92,12 @@ export interface DocumentVersionResponse {
      * @memberof DocumentVersionResponse
      */
     assetS3Url?: string | null;
+    /**
+     * Presigned URL (6-hour validity) to the agent's cited copy of the source, with KS Citation comments intact; null unless one was stored. For the agent edit round-trip only — human downloads and the FE viewer use asset_s3_url (clean) and render citations from citation_anchors.
+     * @type {string}
+     * @memberof DocumentVersionResponse
+     */
+    citedAssetS3Url?: string | null;
     /**
      * Presigned URL to download the fast plaintext export (6-hour validity)
      * @type {string}

package/dist/models/DocumentVersionResponse.js

@@ -70,6 +70,7 @@ function DocumentVersionResponseFromJSONTyped(json, ignoreDiscriminator) {
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
         'assetS3Url': json['asset_s3_url'] == null ? undefined : json['asset_s3_url'],
+        'citedAssetS3Url': json['cited_asset_s3_url'] == null ? undefined : json['cited_asset_s3_url'],
         'fastPlaintextUrl': json['fast_plaintext_url'] == null ? undefined : json['fast_plaintext_url'],
         'pageScreenshotUrls': json['page_screenshot_urls'] == null ? undefined : json['page_screenshot_urls'],
         'systemMetadata': json['system_metadata'] == null ? undefined : (0, DocumentVersionMetadata_1.DocumentVersionMetadataFromJSON)(json['system_metadata']),
@@ -95,6 +96,7 @@ function DocumentVersionResponseToJSONTyped(value, ignoreDiscriminator = false)
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
         'asset_s3_url': value['assetS3Url'],
+        'cited_asset_s3_url': value['citedAssetS3Url'],
         'fast_plaintext_url': value['fastPlaintextUrl'],
         'page_screenshot_urls': value['pageScreenshotUrls'],
         'system_metadata': (0, DocumentVersionMetadata_1.DocumentVersionMetadataToJSON)(value['systemMetadata']),

package/docs/DocumentVersionMetadata.md

@@ -10,6 +10,7 @@ Name | Type
 `sourceS3` | string
 `cleanedSourceS3` | string
 `preconversionSourceS3` | string
+`citedSourceS3` | string
 `fastPlaintextS3` | string
 `hash` | string
 `pipelineState` | [PipelineState](PipelineState.md)
@@ -37,6 +38,7 @@ const example = {
   "sourceS3": null,
   "cleanedSourceS3": null,
   "preconversionSourceS3": null,
+  "citedSourceS3": null,
   "fastPlaintextS3": null,
   "hash": null,
   "pipelineState": null,

package/docs/DocumentVersionMetadataUpdate.md

@@ -10,6 +10,7 @@ Name | Type
 `sourceS3` | string
 `cleanedSourceS3` | string
 `preconversionSourceS3` | string
+`citedSourceS3` | string
 `standardPipelineJsonS3` | string
 `fastPlaintextS3` | string
 `highAccuracyContentListS3` | string
@@ -40,6 +41,7 @@ const example = {
   "sourceS3": null,
   "cleanedSourceS3": null,
   "preconversionSourceS3": null,
+  "citedSourceS3": null,
   "standardPipelineJsonS3": null,
   "fastPlaintextS3": null,
   "highAccuracyContentListS3": null,

package/docs/DocumentVersionResponse.md

@@ -19,6 +19,7 @@ Name | Type
 `createdAt` | Date
 `updatedAt` | Date
 `assetS3Url` | string
+`citedAssetS3Url` | string
 `fastPlaintextUrl` | string
 `pageScreenshotUrls` | Array<string>
 `systemMetadata` | [DocumentVersionMetadata](DocumentVersionMetadata.md)
@@ -42,6 +43,7 @@ const example = {
   "createdAt": null,
   "updatedAt": null,
   "assetS3Url": null,
+  "citedAssetS3Url": null,
   "fastPlaintextUrl": null,
   "pageScreenshotUrls": null,
   "systemMetadata": null,

package/docs/DocumentVersionsApi.md

@@ -4,6 +4,7 @@ All URIs are relative to *http://localhost:8000*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**attachCitedAsset**](DocumentVersionsApi.md#attachcitedasset) | **POST** /v1/document_versions/{version_id}/cited-asset | Attach Cited Asset Handler |
 | [**clearDocumentVersionContents**](DocumentVersionsApi.md#cleardocumentversioncontents) | **DELETE** /v1/document_versions/{version_id}/contents | Clear Document Version Contents Handler |
 | [**createDocumentVersion**](DocumentVersionsApi.md#createdocumentversion) | **POST** /v1/documents/{document_id}/versions | Create Document Version Handler |
 | [**deleteDocumentVersion**](DocumentVersionsApi.md#deletedocumentversion) | **DELETE** /v1/document_versions/{version_id} | Delete Document Version Handler |
@@ -17,6 +18,84 @@ All URIs are relative to *http://localhost:8000*
 
 
 
+## attachCitedAsset
+
+> attachCitedAsset(versionId, file)
+
+Attach Cited Asset Handler
+
+Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DocumentVersionsApi,
+} from '@knowledge-stack/ksapi';
+import type { AttachCitedAssetRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new DocumentVersionsApi(config);
+
+  const body = {
+    // string | DocumentVersion ID
+    versionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // Blob
+    file: BINARY_DATA_HERE,
+  } satisfies AttachCitedAssetRequest;
+
+  try {
+    const data = await api.attachCitedAsset(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **versionId** | `string` | DocumentVersion ID | [Defaults to `undefined`] |
+| **file** | `Blob` |  | [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `multipart/form-data`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **204** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## clearDocumentVersionContents
 
 > ClearVersionContentsResponse clearDocumentVersionContents(versionId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.142.1",
+  "version": "1.142.2",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/DocumentVersionsApi.ts

@@ -64,6 +64,11 @@ import {
     VersionDiffResponseToJSON,
 } from '../models/index';
 
+export interface AttachCitedAssetRequest {
+    versionId: string;
+    file: Blob;
+}
+
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
 }
@@ -129,6 +134,32 @@ export interface UpdateDocumentVersionMetadataRequest {
  * @interface DocumentVersionsApiInterface
  */
 export interface DocumentVersionsApiInterface {
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file 
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * @summary Attach Cited Asset Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {Blob} file 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      * @param {string} versionId DocumentVersion ID
@@ -411,6 +442,88 @@ export interface DocumentVersionsApiInterface {
  */
 export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVersionsApiInterface {
 
+    /**
+     * Creates request options for attachCitedAsset without sending the request
+     */
+    async attachCitedAssetRequestOpts(requestParameters: AttachCitedAssetRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['versionId'] == null) {
+            throw new runtime.RequiredError(
+                'versionId',
+                'Required parameter "versionId" was null or undefined when calling attachCitedAsset().'
+            );
+        }
+
+        if (requestParameters['file'] == null) {
+            throw new runtime.RequiredError(
+                'file',
+                'Required parameter "file" was null or undefined when calling attachCitedAsset().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['file'] != null) {
+            formParams.append('file', requestParameters['file'] as any);
+        }
+
+
+        let urlPath = `/v1/document_versions/{version_id}/cited-asset`;
+        urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    async attachCitedAssetRaw(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.attachCitedAssetRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Store the agent\'s cited copy of a version\'s source as its cited_source_s3 sibling.  The clean ``source_s3`` is untouched — chunking, the FE viewer, and downloads keep using it and render citations from ``citation_anchors``. The cited copy (KS Citation comments intact) is read only by the agent edit round-trip (``ks_download_to_sandbox``) so a follow-up chat re-extracts anchors instead of losing them. Requires write access to the version.
+     * Attach Cited Asset Handler
+     */
+    async attachCitedAsset(requestParameters: AttachCitedAssetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.attachCitedAssetRaw(requestParameters, initOverrides);
+    }
+
     /**
      * Creates request options for clearDocumentVersionContents without sending the request
      */

package/src/models/DocumentVersionMetadata.ts

@@ -68,6 +68,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     preconversionSourceS3?: string | null;
+    /**
+     * S3 URL to the agent's cited copy of the source (KS Citation comments intact); null unless the agent uploaded a file carrying citations. Read only for the agent edit round-trip so a follow-up chat re-extracts citation anchors instead of losing them; source_s3 stays the clean artifact served to chunking, the FE viewer, and downloads.
+     * @type {string}
+     * @memberof DocumentVersionMetadata
+     */
+    citedSourceS3?: string | null;
     /**
      * S3 URL to the fast plaintext export of the document
      * @type {string}
@@ -203,6 +209,7 @@ export function DocumentVersionMetadataFromJSONTyped(json: any, ignoreDiscrimina
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'hash': json['hash'] == null ? undefined : json['hash'],
         'pipelineState': json['pipeline_state'] == null ? undefined : PipelineStateFromJSON(json['pipeline_state']),
@@ -236,6 +243,7 @@ export function DocumentVersionMetadataToJSONTyped(value?: DocumentVersionMetada
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'hash': value['hash'],
         'pipeline_state': PipelineStateToJSON(value['pipelineState']),

package/src/models/DocumentVersionMetadataUpdate.ts

@@ -62,6 +62,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     preconversionSourceS3?: string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    citedSourceS3?: string | null;
     /**
      * 
      * @type {string}
@@ -215,6 +221,7 @@ export function DocumentVersionMetadataUpdateFromJSONTyped(json: any, ignoreDisc
         'sourceS3': json['source_s3'] == null ? undefined : json['source_s3'],
         'cleanedSourceS3': json['cleaned_source_s3'] == null ? undefined : json['cleaned_source_s3'],
         'preconversionSourceS3': json['preconversion_source_s3'] == null ? undefined : json['preconversion_source_s3'],
+        'citedSourceS3': json['cited_source_s3'] == null ? undefined : json['cited_source_s3'],
         'standardPipelineJsonS3': json['standard_pipeline_json_s3'] == null ? undefined : json['standard_pipeline_json_s3'],
         'fastPlaintextS3': json['fast_plaintext_s3'] == null ? undefined : json['fast_plaintext_s3'],
         'highAccuracyContentListS3': json['high_accuracy_content_list_s3'] == null ? undefined : json['high_accuracy_content_list_s3'],
@@ -251,6 +258,7 @@ export function DocumentVersionMetadataUpdateToJSONTyped(value?: DocumentVersion
         'source_s3': value['sourceS3'],
         'cleaned_source_s3': value['cleanedSourceS3'],
         'preconversion_source_s3': value['preconversionSourceS3'],
+        'cited_source_s3': value['citedSourceS3'],
         'standard_pipeline_json_s3': value['standardPipelineJsonS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
         'high_accuracy_content_list_s3': value['highAccuracyContentListS3'],

package/src/models/DocumentVersionResponse.ts

@@ -109,6 +109,12 @@ export interface DocumentVersionResponse {
      * @memberof DocumentVersionResponse
      */
     assetS3Url?: string | null;
+    /**
+     * Presigned URL (6-hour validity) to the agent's cited copy of the source, with KS Citation comments intact; null unless one was stored. For the agent edit round-trip only — human downloads and the FE viewer use asset_s3_url (clean) and render citations from citation_anchors.
+     * @type {string}
+     * @memberof DocumentVersionResponse
+     */
+    citedAssetS3Url?: string | null;
     /**
      * Presigned URL to download the fast plaintext export (6-hour validity)
      * @type {string}
@@ -186,6 +192,7 @@ export function DocumentVersionResponseFromJSONTyped(json: any, ignoreDiscrimina
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
         'assetS3Url': json['asset_s3_url'] == null ? undefined : json['asset_s3_url'],
+        'citedAssetS3Url': json['cited_asset_s3_url'] == null ? undefined : json['cited_asset_s3_url'],
         'fastPlaintextUrl': json['fast_plaintext_url'] == null ? undefined : json['fast_plaintext_url'],
         'pageScreenshotUrls': json['page_screenshot_urls'] == null ? undefined : json['page_screenshot_urls'],
         'systemMetadata': json['system_metadata'] == null ? undefined : DocumentVersionMetadataFromJSON(json['system_metadata']),
@@ -215,6 +222,7 @@ export function DocumentVersionResponseToJSONTyped(value?: DocumentVersionRespon
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
         'asset_s3_url': value['assetS3Url'],
+        'cited_asset_s3_url': value['citedAssetS3Url'],
         'fast_plaintext_url': value['fastPlaintextUrl'],
         'page_screenshot_urls': value['pageScreenshotUrls'],
         'system_metadata': DocumentVersionMetadataToJSON(value['systemMetadata']),