@knowledge-stack/ksapi 1.52.2 → 1.53.0

package/docs/DocumentVersionMetadata.md

@@ -1,7 +1,7 @@
 
 # DocumentVersionMetadata
 
-Schema for document_version.metadata JSONB field.  Tracks S3 URLs for generated artifacts, pipeline execution state, and document statistics. Convention-based paths (images, page screenshots) are derived from document_id/document_version_id via s3_paths helpers, using a flat S3 layout: documents/{document_id}/{document_version_id}/...
+Schema for document_version.system_metadata JSONB field.  Tracks S3 URLs for generated artifacts, pipeline execution state, and document statistics. Convention-based paths (images, page screenshots) are derived from document_id/document_version_id via s3_paths helpers, using a flat S3 layout: documents/{document_id}/{document_version_id}/...
 
 ## Properties
 
@@ -19,6 +19,7 @@ Name | Type
 `xlsxParseResultS3` | string
 `xlsxNamedRanges` | Array<{ [key: string]: any; }>
 `xlsxKpiCatalog` | Array<{ [key: string]: any; }>
+`informationStatistics` | [InformationStatistics](InformationStatistics.md)
 
 ## Example
 
@@ -39,6 +40,7 @@ const example = {
   "xlsxParseResultS3": null,
   "xlsxNamedRanges": null,
   "xlsxKpiCatalog": null,
+  "informationStatistics": null,
 } satisfies DocumentVersionMetadata
 
 console.log(example)

package/docs/DocumentVersionMetadataUpdate.md

@@ -19,6 +19,7 @@ Name | Type
 `xlsxParseResultS3` | string
 `xlsxNamedRanges` | Array<{ [key: string]: any; }>
 `xlsxKpiCatalog` | Array<{ [key: string]: any; }>
+`informationStatistics` | [InformationStatistics](InformationStatistics.md)
 
 ## Example
 
@@ -39,6 +40,7 @@ const example = {
   "xlsxParseResultS3": null,
   "xlsxNamedRanges": null,
   "xlsxKpiCatalog": null,
+  "informationStatistics": null,
 } satisfies DocumentVersionMetadataUpdate
 
 console.log(example)

package/docs/DocumentVersionResponse.md

@@ -18,7 +18,7 @@ Name | Type
 `createdAt` | Date
 `updatedAt` | Date
 `assetS3Url` | string
-`metadata` | [DocumentVersionMetadata](DocumentVersionMetadata.md)
+`systemMetadata` | [DocumentVersionMetadata](DocumentVersionMetadata.md)
 
 ## Example
 
@@ -38,7 +38,7 @@ const example = {
   "createdAt": null,
   "updatedAt": null,
   "assetS3Url": null,
-  "metadata": null,
+  "systemMetadata": null,
 } satisfies DocumentVersionResponse
 
 console.log(example)

package/docs/DocumentVersionsApi.md

@@ -7,6 +7,7 @@ All URIs are relative to *http://localhost:8000*
 | [**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 |
+| [**documentVersionAction**](DocumentVersionsApi.md#documentversionaction) | **POST** /v1/document_versions/{version_id} | Document Version Action Handler |
 | [**getDocumentVersion**](DocumentVersionsApi.md#getdocumentversion) | **GET** /v1/document_versions/{version_id} | Get Document Version Handler |
 | [**getDocumentVersionContents**](DocumentVersionsApi.md#getdocumentversioncontents) | **GET** /v1/document_versions/{version_id}/contents | Get Document Version Contents Handler |
 | [**listDocumentVersions**](DocumentVersionsApi.md#listdocumentversions) | **GET** /v1/document_versions | List Document Versions Handler |
@@ -236,6 +237,83 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## documentVersionAction
+
+> DocumentVersionActionResponse documentVersionAction(versionId, action, authorization, ksUat)
+
+Document Version Action Handler
+
+Perform an action on a document version.  Supported actions: - `reembed`: Re-embed all chunks for this version into Qdrant.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DocumentVersionsApi,
+} from '@knowledge-stack/ksapi';
+import type { DocumentVersionActionRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new DocumentVersionsApi();
+
+  const body = {
+    // string | DocumentVersion ID
+    versionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // DocumentVersionAction | Action to perform
+    action: ...,
+    // string (optional)
+    authorization: authorization_example,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies DocumentVersionActionRequest;
+
+  try {
+    const data = await api.documentVersionAction(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`] |
+| **action** | `DocumentVersionAction` | Action to perform | [Defaults to `undefined`] [Enum: reembed] |
+| **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**DocumentVersionActionResponse**](DocumentVersionActionResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getDocumentVersion
 
 > DocumentVersionResponse getDocumentVersion(versionId, authorization, ksUat)

package/docs/InformationStatistics.md

@@ -0,0 +1,41 @@
+
+# InformationStatistics
+
+Aggregate statistics for a section subtree or document version.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`numChunksByType` | { [key: string]: number; }
+`totalTokens` | number
+`numDirectChildren` | number
+`childrenDepth` | number
+
+## Example
+
+```typescript
+import type { InformationStatistics } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "numChunksByType": null,
+  "totalTokens": null,
+  "numDirectChildren": null,
+  "childrenDepth": null,
+} satisfies InformationStatistics
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as InformationStatistics
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ScoredChunkResponse.md

@@ -13,6 +13,7 @@ Name | Type
 `content` | string
 `chunkType` | [ChunkType](ChunkType.md)
 `chunkMetadata` | [ChunkMetadataOutput](ChunkMetadataOutput.md)
+`numTokens` | number
 `parentPathId` | string
 `prevSiblingPathId` | string
 `nextSiblingPathId` | string
@@ -39,6 +40,7 @@ const example = {
   "content": null,
   "chunkType": null,
   "chunkMetadata": null,
+  "numTokens": null,
   "parentPathId": null,
   "prevSiblingPathId": null,
   "nextSiblingPathId": null,

package/docs/SectionResponse.md

@@ -16,6 +16,7 @@ Name | Type
 `nextSiblingPathId` | string
 `materializedPath` | string
 `systemManaged` | boolean
+`systemMetadata` | [SectionSystemMetadata](SectionSystemMetadata.md)
 `tenantId` | string
 `createdAt` | Date
 `updatedAt` | Date
@@ -36,6 +37,7 @@ const example = {
   "nextSiblingPathId": null,
   "materializedPath": null,
   "systemManaged": null,
+  "systemMetadata": null,
   "tenantId": null,
   "createdAt": null,
   "updatedAt": null,

package/docs/SectionSystemMetadata.md

@@ -0,0 +1,35 @@
+
+# SectionSystemMetadata
+
+Schema for section.system_metadata JSONB field.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`informationStatistics` | [InformationStatistics](InformationStatistics.md)
+
+## Example
+
+```typescript
+import type { SectionSystemMetadata } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "informationStatistics": null,
+} satisfies SectionSystemMetadata
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as SectionSystemMetadata
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/package.json

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

package/src/apis/DocumentVersionsApi.ts

@@ -16,6 +16,8 @@
 import * as runtime from '../runtime';
 import type {
   ClearVersionContentsResponse,
+  DocumentVersionAction,
+  DocumentVersionActionResponse,
   DocumentVersionMetadataUpdate,
   DocumentVersionResponse,
   HTTPValidationError,
@@ -25,6 +27,10 @@ import type {
 import {
     ClearVersionContentsResponseFromJSON,
     ClearVersionContentsResponseToJSON,
+    DocumentVersionActionFromJSON,
+    DocumentVersionActionToJSON,
+    DocumentVersionActionResponseFromJSON,
+    DocumentVersionActionResponseToJSON,
     DocumentVersionMetadataUpdateFromJSON,
     DocumentVersionMetadataUpdateToJSON,
     DocumentVersionResponseFromJSON,
@@ -55,6 +61,13 @@ export interface DeleteDocumentVersionRequest {
     ksUat?: string | null;
 }
 
+export interface DocumentVersionActionRequest {
+    versionId: string;
+    action: DocumentVersionAction;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
 export interface GetDocumentVersionRequest {
     versionId: string;
     authorization?: string | null;
@@ -176,6 +189,36 @@ export interface DocumentVersionsApiInterface {
      */
     deleteDocumentVersion(requestParameters: DeleteDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
+    /**
+     * Creates request options for documentVersionAction without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {DocumentVersionAction} action Action to perform
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    documentVersionActionRequestOpts(requestParameters: DocumentVersionActionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Perform an action on a document version.  Supported actions: - `reembed`: Re-embed all chunks for this version into Qdrant.
+     * @summary Document Version Action Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {DocumentVersionAction} action Action to perform
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    documentVersionActionRaw(requestParameters: DocumentVersionActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionActionResponse>>;
+
+    /**
+     * Perform an action on a document version.  Supported actions: - `reembed`: Re-embed all chunks for this version into Qdrant.
+     * Document Version Action Handler
+     */
+    documentVersionAction(requestParameters: DocumentVersionActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionActionResponse>;
+
     /**
      * Creates request options for getDocumentVersion without sending the request
      * @param {string} versionId DocumentVersion ID
@@ -459,6 +502,68 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
         await this.deleteDocumentVersionRaw(requestParameters, initOverrides);
     }
 
+    /**
+     * Creates request options for documentVersionAction without sending the request
+     */
+    async documentVersionActionRequestOpts(requestParameters: DocumentVersionActionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['versionId'] == null) {
+            throw new runtime.RequiredError(
+                'versionId',
+                'Required parameter "versionId" was null or undefined when calling documentVersionAction().'
+            );
+        }
+
+        if (requestParameters['action'] == null) {
+            throw new runtime.RequiredError(
+                'action',
+                'Required parameter "action" was null or undefined when calling documentVersionAction().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['action'] != null) {
+            queryParameters['action'] = requestParameters['action'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/document_versions/{version_id}`;
+        urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Perform an action on a document version.  Supported actions: - `reembed`: Re-embed all chunks for this version into Qdrant.
+     * Document Version Action Handler
+     */
+    async documentVersionActionRaw(requestParameters: DocumentVersionActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionActionResponse>> {
+        const requestOptions = await this.documentVersionActionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => DocumentVersionActionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Perform an action on a document version.  Supported actions: - `reembed`: Re-embed all chunks for this version into Qdrant.
+     * Document Version Action Handler
+     */
+    async documentVersionAction(requestParameters: DocumentVersionActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionActionResponse> {
+        const response = await this.documentVersionActionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getDocumentVersion without sending the request
      */

package/src/models/ChunkBulkResponse.ts

@@ -84,6 +84,12 @@ export interface ChunkBulkResponse {
      * @memberof ChunkBulkResponse
      */
     chunkMetadata: ChunkMetadataOutput;
+    /**
+     * Number of tokens in chunk content
+     * @type {number}
+     * @memberof ChunkBulkResponse
+     */
+    numTokens?: number | null;
     /**
      * Parent PathPart ID
      * @type {string}
@@ -196,6 +202,7 @@ export function ChunkBulkResponseFromJSONTyped(json: any, ignoreDiscriminator: b
         'content': json['content'],
         'chunkType': ChunkTypeFromJSON(json['chunk_type']),
         'chunkMetadata': ChunkMetadataOutputFromJSON(json['chunk_metadata']),
+        'numTokens': json['num_tokens'] == null ? undefined : json['num_tokens'],
         'parentPathId': json['parent_path_id'],
         'prevSiblingPathId': json['prev_sibling_path_id'] == null ? undefined : json['prev_sibling_path_id'],
         'nextSiblingPathId': json['next_sibling_path_id'] == null ? undefined : json['next_sibling_path_id'],
@@ -228,6 +235,7 @@ export function ChunkBulkResponseToJSONTyped(value?: ChunkBulkResponse | null, i
         'content': value['content'],
         'chunk_type': ChunkTypeToJSON(value['chunkType']),
         'chunk_metadata': ChunkMetadataOutputToJSON(value['chunkMetadata']),
+        'num_tokens': value['numTokens'],
         'parent_path_id': value['parentPathId'],
         'prev_sibling_path_id': value['prevSiblingPathId'],
         'next_sibling_path_id': value['nextSiblingPathId'],

package/src/models/ChunkResponse.ts

@@ -84,6 +84,12 @@ export interface ChunkResponse {
      * @memberof ChunkResponse
      */
     chunkMetadata: ChunkMetadataOutput;
+    /**
+     * Number of tokens in chunk content
+     * @type {number}
+     * @memberof ChunkResponse
+     */
+    numTokens?: number | null;
     /**
      * Parent PathPart ID
      * @type {string}
@@ -189,6 +195,7 @@ export function ChunkResponseFromJSONTyped(json: any, ignoreDiscriminator: boole
         'content': json['content'],
         'chunkType': ChunkTypeFromJSON(json['chunk_type']),
         'chunkMetadata': ChunkMetadataOutputFromJSON(json['chunk_metadata']),
+        'numTokens': json['num_tokens'] == null ? undefined : json['num_tokens'],
         'parentPathId': json['parent_path_id'],
         'prevSiblingPathId': json['prev_sibling_path_id'] == null ? undefined : json['prev_sibling_path_id'],
         'nextSiblingPathId': json['next_sibling_path_id'] == null ? undefined : json['next_sibling_path_id'],
@@ -220,6 +227,7 @@ export function ChunkResponseToJSONTyped(value?: ChunkResponse | null, ignoreDis
         'content': value['content'],
         'chunk_type': ChunkTypeToJSON(value['chunkType']),
         'chunk_metadata': ChunkMetadataOutputToJSON(value['chunkMetadata']),
+        'num_tokens': value['numTokens'],
         'parent_path_id': value['parentPathId'],
         'prev_sibling_path_id': value['prevSiblingPathId'],
         'next_sibling_path_id': value['nextSiblingPathId'],

package/src/models/DocumentVersionAction.ts

@@ -0,0 +1,52 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+/**
+ * Actions that can be performed on a document version.
+ * @export
+ */
+export const DocumentVersionAction = {
+    Reembed: 'reembed'
+} as const;
+export type DocumentVersionAction = typeof DocumentVersionAction[keyof typeof DocumentVersionAction];
+
+
+export function instanceOfDocumentVersionAction(value: any): boolean {
+    for (const key in DocumentVersionAction) {
+        if (Object.prototype.hasOwnProperty.call(DocumentVersionAction, key)) {
+            if (DocumentVersionAction[key as keyof typeof DocumentVersionAction] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function DocumentVersionActionFromJSON(json: any): DocumentVersionAction {
+    return DocumentVersionActionFromJSONTyped(json, false);
+}
+
+export function DocumentVersionActionFromJSONTyped(json: any, ignoreDiscriminator: boolean): DocumentVersionAction {
+    return json as DocumentVersionAction;
+}
+
+export function DocumentVersionActionToJSON(value?: DocumentVersionAction | null): any {
+    return value as any;
+}
+
+export function DocumentVersionActionToJSONTyped(value: any, ignoreDiscriminator: boolean): DocumentVersionAction {
+    return value as DocumentVersionAction;
+}
+

package/src/models/DocumentVersionActionResponse.ts

@@ -0,0 +1,111 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { DocumentVersionAction } from './DocumentVersionAction';
+import {
+    DocumentVersionActionFromJSON,
+    DocumentVersionActionFromJSONTyped,
+    DocumentVersionActionToJSON,
+    DocumentVersionActionToJSONTyped,
+} from './DocumentVersionAction';
+
+/**
+ * Response from a document version action.
+ * @export
+ * @interface DocumentVersionActionResponse
+ */
+export interface DocumentVersionActionResponse {
+    /**
+     * DocumentVersion ID
+     * @type {string}
+     * @memberof DocumentVersionActionResponse
+     */
+    versionId: string;
+    /**
+     * 
+     * @type {DocumentVersionAction}
+     * @memberof DocumentVersionActionResponse
+     */
+    action: DocumentVersionAction;
+    /**
+     * Temporal workflow ID
+     * @type {string}
+     * @memberof DocumentVersionActionResponse
+     */
+    workflowId: string;
+}
+
+
+
+/**
+ * Check if a given object implements the DocumentVersionActionResponse interface.
+ */
+export function instanceOfDocumentVersionActionResponse(value: object): value is DocumentVersionActionResponse {
+    if (!('versionId' in value) || value['versionId'] === undefined) return false;
+    if (!('action' in value) || value['action'] === undefined) return false;
+    if (!('workflowId' in value) || value['workflowId'] === undefined) return false;
+    return true;
+}
+
+export function DocumentVersionActionResponseFromJSON(json: any): DocumentVersionActionResponse {
+    return DocumentVersionActionResponseFromJSONTyped(json, false);
+}
+
+export function DocumentVersionActionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): DocumentVersionActionResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'versionId': json['version_id'],
+        'action': DocumentVersionActionFromJSON(json['action']),
+        'workflowId': json['workflow_id'],
+    };
+}
+
+export function DocumentVersionActionResponseToJSON(json: any): DocumentVersionActionResponse {
+    return DocumentVersionActionResponseToJSONTyped(json, false);
+}
+
+export function DocumentVersionActionResponseToJSONTyped(value?: DocumentVersionActionResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'version_id': value['versionId'],
+        'action': DocumentVersionActionToJSON(value['action']),
+        'workflow_id': value['workflowId'],
+    };
+}
+
+export const DocumentVersionActionResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+}
+

package/src/models/DocumentVersionMetadata.ts

@@ -20,9 +20,16 @@ import {
     PipelineStateToJSON,
     PipelineStateToJSONTyped,
 } from './PipelineState';
+import type { InformationStatistics } from './InformationStatistics';
+import {
+    InformationStatisticsFromJSON,
+    InformationStatisticsFromJSONTyped,
+    InformationStatisticsToJSON,
+    InformationStatisticsToJSONTyped,
+} from './InformationStatistics';
 
 /**
- * Schema for document_version.metadata JSONB field.
+ * Schema for document_version.system_metadata JSONB field.
  * 
  * Tracks S3 URLs for generated artifacts, pipeline execution state,
  * and document statistics. Convention-based paths (images, page screenshots)
@@ -104,6 +111,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     xlsxKpiCatalog?: Array<{ [key: string]: any; }> | null;
+    /**
+     * 
+     * @type {InformationStatistics}
+     * @memberof DocumentVersionMetadata
+     */
+    informationStatistics?: InformationStatistics;
 }
 
 /**
@@ -135,6 +148,7 @@ export function DocumentVersionMetadataFromJSONTyped(json: any, ignoreDiscrimina
         'xlsxParseResultS3': json['xlsx_parse_result_s3'] == null ? undefined : json['xlsx_parse_result_s3'],
         'xlsxNamedRanges': json['xlsx_named_ranges'] == null ? undefined : json['xlsx_named_ranges'],
         'xlsxKpiCatalog': json['xlsx_kpi_catalog'] == null ? undefined : json['xlsx_kpi_catalog'],
+        'informationStatistics': json['information_statistics'] == null ? undefined : InformationStatisticsFromJSON(json['information_statistics']),
     };
 }
 
@@ -161,6 +175,7 @@ export function DocumentVersionMetadataToJSONTyped(value?: DocumentVersionMetada
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],
         'xlsx_kpi_catalog': value['xlsxKpiCatalog'],
+        'information_statistics': InformationStatisticsToJSON(value['informationStatistics']),
     };
 }