@knowledge-stack/ksapi 1.156.0 → 1.157.0

package/dist/models/DocumentVersionMetadataUpdate.d.ts

@@ -57,6 +57,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     fastPlaintextS3?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    transcriptS3?: string | null;
     /**
      *
      * @type {string}
@@ -169,6 +175,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     quotaPageCount?: number | null;
+    /**
+     *
+     * @type {number}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    quotaMediaMinutes?: number | null;
     /**
      *
      * @type {string}

package/dist/models/DocumentVersionMetadataUpdate.js

@@ -43,6 +43,7 @@ function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscriminator) {
         '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'],
+        'transcriptS3': json['transcript_s3'] == null ? undefined : json['transcript_s3'],
         'highAccuracyContentListS3': json['high_accuracy_content_list_s3'] == null ? undefined : json['high_accuracy_content_list_s3'],
         'highAccuracyMiddleS3': json['high_accuracy_middle_s3'] == null ? undefined : json['high_accuracy_middle_s3'],
         'hash': json['hash'] == null ? undefined : json['hash'],
@@ -61,6 +62,7 @@ function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscriminator) {
         'informationStatistics': json['information_statistics'] == null ? undefined : (0, InformationStatistics_1.InformationStatisticsFromJSON)(json['information_statistics']),
         'quotaCharged': json['quota_charged'] == null ? undefined : json['quota_charged'],
         'quotaPageCount': json['quota_page_count'] == null ? undefined : json['quota_page_count'],
+        'quotaMediaMinutes': json['quota_media_minutes'] == null ? undefined : json['quota_media_minutes'],
         'quotaIdempotencyKey': json['quota_idempotency_key'] == null ? undefined : json['quota_idempotency_key'],
         'fileMd5': json['file_md5'] == null ? undefined : json['file_md5'],
     };
@@ -79,6 +81,7 @@ function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscriminator = f
         'cited_source_s3': value['citedSourceS3'],
         'standard_pipeline_json_s3': value['standardPipelineJsonS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
+        'transcript_s3': value['transcriptS3'],
         'high_accuracy_content_list_s3': value['highAccuracyContentListS3'],
         'high_accuracy_middle_s3': value['highAccuracyMiddleS3'],
         'hash': value['hash'],
@@ -97,6 +100,7 @@ function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscriminator = f
         'information_statistics': (0, InformationStatistics_1.InformationStatisticsToJSON)(value['informationStatistics']),
         'quota_charged': value['quotaCharged'],
         'quota_page_count': value['quotaPageCount'],
+        'quota_media_minutes': value['quotaMediaMinutes'],
         'quota_idempotency_key': value['quotaIdempotencyKey'],
         'file_md5': value['fileMd5'],
     };

package/dist/models/DocumentVersionResponse.d.ts

@@ -104,6 +104,12 @@ export interface DocumentVersionResponse {
      * @memberof DocumentVersionResponse
      */
     fastPlaintextUrl?: string | null;
+    /**
+     * Presigned URL (6-hour validity) to the ASR transcript JSON with per-segment start_ms/end_ms/text; null for non-media. Chunks pack many segments into one, so this is what a client reads to follow a recording line by line.
+     * @type {string}
+     * @memberof DocumentVersionResponse
+     */
+    transcriptUrl?: string | null;
     /**
      * Presigned URLs (6-hour validity) to per-page WEBP screenshots in page order: index 0 is page 1, index N-1 is page N. Populated only when the request includes include_page_screenshots=true; null otherwise.
      * @type {Array<string>}

package/dist/models/DocumentVersionResponse.js

@@ -72,6 +72,7 @@ function DocumentVersionResponseFromJSONTyped(json, ignoreDiscriminator) {
         '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'],
+        'transcriptUrl': json['transcript_url'] == null ? undefined : json['transcript_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']),
     };
@@ -98,6 +99,7 @@ function DocumentVersionResponseToJSONTyped(value, ignoreDiscriminator = false)
         'asset_s3_url': value['assetS3Url'],
         'cited_asset_s3_url': value['citedAssetS3Url'],
         'fast_plaintext_url': value['fastPlaintextUrl'],
+        'transcript_url': value['transcriptUrl'],
         'page_screenshot_urls': value['pageScreenshotUrls'],
         'system_metadata': (0, DocumentVersionMetadata_1.DocumentVersionMetadataToJSON)(value['systemMetadata']),
     };

package/dist/models/DownloadArtifact.d.ts

@@ -16,6 +16,7 @@
 export declare const DownloadArtifact: {
     readonly Source: 'source';
     readonly FastPlaintext: 'fast_plaintext';
+    readonly Transcript: 'transcript';
 };
 export type DownloadArtifact = typeof DownloadArtifact[keyof typeof DownloadArtifact];
 export declare function instanceOfDownloadArtifact(value: any): boolean;

package/dist/models/DownloadArtifact.js

@@ -25,7 +25,8 @@ exports.DownloadArtifactToJSONTyped = DownloadArtifactToJSONTyped;
  */
 exports.DownloadArtifact = {
     Source: 'source',
-    FastPlaintext: 'fast_plaintext'
+    FastPlaintext: 'fast_plaintext',
+    Transcript: 'transcript'
 };
 function instanceOfDownloadArtifact(value) {
     for (const key in exports.DownloadArtifact) {

package/dist/models/SegmentSpan.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * 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.
+ */
+/**
+ * One ASR segment's span inside a media chunk (media chunks only).
+ *
+ * Field names are deliberately compact — a media document stores hundreds
+ * of chunks x up to ~15 spans each in ``chunk_metadata`` JSONB.
+ * @export
+ * @interface SegmentSpan
+ */
+export interface SegmentSpan {
+    /**
+     * Segment start in the media, ms from start.
+     * @type {number}
+     * @memberof SegmentSpan
+     */
+    s: number;
+    /**
+     * Segment end in the media, ms from start.
+     * @type {number}
+     * @memberof SegmentSpan
+     */
+    e: number;
+    /**
+     * Character offset of this segment's text within the chunk's joined content — maps a position in the chunk text back to a moment in the recording.
+     * @type {number}
+     * @memberof SegmentSpan
+     */
+    c: number;
+}
+export declare const SegmentSpanPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the SegmentSpan interface.
+ */
+export declare function instanceOfSegmentSpan(value: object): value is SegmentSpan;
+export declare function SegmentSpanFromJSON(json: any): SegmentSpan;
+export declare function SegmentSpanFromJSONTyped(json: any, ignoreDiscriminator: boolean): SegmentSpan;
+export declare function SegmentSpanToJSON(json: any): SegmentSpan;
+export declare function SegmentSpanToJSONTyped(value?: SegmentSpan | null, ignoreDiscriminator?: boolean): any;

package/dist/models/SegmentSpan.js

@@ -0,0 +1,60 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentSpanPropertyValidationAttributesMap = void 0;
+exports.instanceOfSegmentSpan = instanceOfSegmentSpan;
+exports.SegmentSpanFromJSON = SegmentSpanFromJSON;
+exports.SegmentSpanFromJSONTyped = SegmentSpanFromJSONTyped;
+exports.SegmentSpanToJSON = SegmentSpanToJSON;
+exports.SegmentSpanToJSONTyped = SegmentSpanToJSONTyped;
+exports.SegmentSpanPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the SegmentSpan interface.
+ */
+function instanceOfSegmentSpan(value) {
+    if (!('s' in value) || value['s'] === undefined)
+        return false;
+    if (!('e' in value) || value['e'] === undefined)
+        return false;
+    if (!('c' in value) || value['c'] === undefined)
+        return false;
+    return true;
+}
+function SegmentSpanFromJSON(json) {
+    return SegmentSpanFromJSONTyped(json, false);
+}
+function SegmentSpanFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        's': json['s'],
+        'e': json['e'],
+        'c': json['c'],
+    };
+}
+function SegmentSpanToJSON(json) {
+    return SegmentSpanToJSONTyped(json, false);
+}
+function SegmentSpanToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        's': value['s'],
+        'e': value['e'],
+        'c': value['c'],
+    };
+}

package/dist/models/UploadConstraints.d.ts

@@ -34,6 +34,18 @@ export interface UploadConstraints {
      * @memberof UploadConstraints
      */
     maxImageBytes: number;
+    /**
+     *
+     * @type {number}
+     * @memberof UploadConstraints
+     */
+    maxMediaBytes: number;
+    /**
+     *
+     * @type {number}
+     * @memberof UploadConstraints
+     */
+    maxVideoBytes: number;
 }
 export declare const UploadConstraintsPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/UploadConstraints.js

@@ -31,6 +31,10 @@ function instanceOfUploadConstraints(value) {
         return false;
     if (!('maxImageBytes' in value) || value['maxImageBytes'] === undefined)
         return false;
+    if (!('maxMediaBytes' in value) || value['maxMediaBytes'] === undefined)
+        return false;
+    if (!('maxVideoBytes' in value) || value['maxVideoBytes'] === undefined)
+        return false;
     return true;
 }
 function UploadConstraintsFromJSON(json) {
@@ -44,6 +48,8 @@ function UploadConstraintsFromJSONTyped(json, ignoreDiscriminator) {
         'formats': (json['formats'].map(UploadFormat_1.UploadFormatFromJSON)),
         'maxBytes': json['max_bytes'],
         'maxImageBytes': json['max_image_bytes'],
+        'maxMediaBytes': json['max_media_bytes'],
+        'maxVideoBytes': json['max_video_bytes'],
     };
 }
 function UploadConstraintsToJSON(json) {
@@ -57,5 +63,7 @@ function UploadConstraintsToJSONTyped(value, ignoreDiscriminator = false) {
         'formats': (value['formats'].map(UploadFormat_1.UploadFormatToJSON)),
         'max_bytes': value['maxBytes'],
         'max_image_bytes': value['maxImageBytes'],
+        'max_media_bytes': value['maxMediaBytes'],
+        'max_video_bytes': value['maxVideoBytes'],
     };
 }

package/dist/models/index.d.ts

@@ -265,6 +265,7 @@ export * from './SectionContentItem';
 export * from './SectionContentItemOrChunkContentItem';
 export * from './SectionResponse';
 export * from './SectionSystemMetadata';
+export * from './SegmentSpan';
 export * from './SendPasswordResetRequest';
 export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';

package/dist/models/index.js

@@ -283,6 +283,7 @@ __exportStar(require("./SectionContentItem"), exports);
 __exportStar(require("./SectionContentItemOrChunkContentItem"), exports);
 __exportStar(require("./SectionResponse"), exports);
 __exportStar(require("./SectionSystemMetadata"), exports);
+__exportStar(require("./SegmentSpan"), exports);
 __exportStar(require("./SendPasswordResetRequest"), exports);
 __exportStar(require("./SetApprovalStateRequest"), exports);
 __exportStar(require("./SetWorkflowRunApprovalRequest"), exports);

package/docs/ChunkMetadata.md

@@ -15,6 +15,7 @@ Name | Type
 `secondaryTaxonomy` | [ImageTaxonomy](ImageTaxonomy.md)
 `startMs` | number
 `endMs` | number
+`segments` | [Array<SegmentSpan>](SegmentSpan.md)
 `sheetName` | string
 `blockType` | string
 `sourceUri` | string
@@ -40,6 +41,7 @@ const example = {
   "secondaryTaxonomy": null,
   "startMs": null,
   "endMs": null,
+  "segments": null,
   "sheetName": null,
   "blockType": null,
   "sourceUri": null,

package/docs/DocumentVersionMetadata.md

@@ -12,6 +12,7 @@ Name | Type
 `preconversionSourceS3` | string
 `citedSourceS3` | string
 `fastPlaintextS3` | string
+`transcriptS3` | string
 `hash` | string
 `pipelineState` | [PipelineState](PipelineState.md)
 `totalPages` | number
@@ -28,6 +29,7 @@ Name | Type
 `informationStatistics` | [InformationStatistics](InformationStatistics.md)
 `quotaCharged` | boolean
 `quotaPageCount` | number
+`quotaMediaMinutes` | number
 `quotaIdempotencyKey` | string
 `fileMd5` | string
 `idempotencyKey` | string
@@ -44,6 +46,7 @@ const example = {
   "preconversionSourceS3": null,
   "citedSourceS3": null,
   "fastPlaintextS3": null,
+  "transcriptS3": null,
   "hash": null,
   "pipelineState": null,
   "totalPages": null,
@@ -60,6 +63,7 @@ const example = {
   "informationStatistics": null,
   "quotaCharged": null,
   "quotaPageCount": null,
+  "quotaMediaMinutes": null,
   "quotaIdempotencyKey": null,
   "fileMd5": null,
   "idempotencyKey": null,

package/docs/DocumentVersionMetadataUpdate.md

@@ -13,6 +13,7 @@ Name | Type
 `citedSourceS3` | string
 `standardPipelineJsonS3` | string
 `fastPlaintextS3` | string
+`transcriptS3` | string
 `highAccuracyContentListS3` | string
 `highAccuracyMiddleS3` | string
 `hash` | string
@@ -31,6 +32,7 @@ Name | Type
 `informationStatistics` | [InformationStatistics](InformationStatistics.md)
 `quotaCharged` | boolean
 `quotaPageCount` | number
+`quotaMediaMinutes` | number
 `quotaIdempotencyKey` | string
 `fileMd5` | string
 
@@ -47,6 +49,7 @@ const example = {
   "citedSourceS3": null,
   "standardPipelineJsonS3": null,
   "fastPlaintextS3": null,
+  "transcriptS3": null,
   "highAccuracyContentListS3": null,
   "highAccuracyMiddleS3": null,
   "hash": null,
@@ -65,6 +68,7 @@ const example = {
   "informationStatistics": null,
   "quotaCharged": null,
   "quotaPageCount": null,
+  "quotaMediaMinutes": null,
   "quotaIdempotencyKey": null,
   "fileMd5": null,
 } satisfies DocumentVersionMetadataUpdate

package/docs/DocumentVersionResponse.md

@@ -21,6 +21,7 @@ Name | Type
 `assetS3Url` | string
 `citedAssetS3Url` | string
 `fastPlaintextUrl` | string
+`transcriptUrl` | string
 `pageScreenshotUrls` | Array<string>
 `systemMetadata` | [DocumentVersionMetadata](DocumentVersionMetadata.md)
 
@@ -45,6 +46,7 @@ const example = {
   "assetS3Url": null,
   "citedAssetS3Url": null,
   "fastPlaintextUrl": null,
+  "transcriptUrl": null,
   "pageScreenshotUrls": null,
   "systemMetadata": null,
 } satisfies DocumentVersionResponse

package/docs/DocumentVersionsApi.md

@@ -429,7 +429,7 @@ async function example() {
   const body = {
     // string | DocumentVersion ID
     versionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
-    // DownloadArtifact | Artifact to download: source or fast_plaintext (optional)
+    // DownloadArtifact | Artifact to download: source, fast_plaintext, or transcript (media only) (optional)
     artifact: ...,
   } satisfies DownloadDocumentVersionRequest;
 
@@ -451,7 +451,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **versionId** | `string` | DocumentVersion ID | [Defaults to `undefined`] |
-| **artifact** | `DownloadArtifact` | Artifact to download: source or fast_plaintext | [Optional] [Defaults to `undefined`] [Enum: source, fast_plaintext] |
+| **artifact** | `DownloadArtifact` | Artifact to download: source, fast_plaintext, or transcript (media only) | [Optional] [Defaults to `undefined`] [Enum: source, fast_plaintext, transcript] |
 
 ### Return type
 

package/docs/DocumentsApi.md

@@ -426,7 +426,7 @@ async function example() {
   const body = {
     // string
     documentId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
-    // DownloadArtifact | Artifact to download: source or fast_plaintext (optional)
+    // DownloadArtifact | Artifact to download: source, fast_plaintext, or transcript (media only) (optional)
     artifact: ...,
   } satisfies DownloadDocumentRequest;
 
@@ -448,7 +448,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **documentId** | `string` |  | [Defaults to `undefined`] |
-| **artifact** | `DownloadArtifact` | Artifact to download: source or fast_plaintext | [Optional] [Defaults to `undefined`] [Enum: source, fast_plaintext] |
+| **artifact** | `DownloadArtifact` | Artifact to download: source, fast_plaintext, or transcript (media only) | [Optional] [Defaults to `undefined`] [Enum: source, fast_plaintext, transcript] |
 
 ### Return type
 

package/docs/SegmentSpan.md

@@ -0,0 +1,39 @@
+
+# SegmentSpan
+
+One ASR segment\'s span inside a media chunk (media chunks only).  Field names are deliberately compact — a media document stores hundreds of chunks x up to ~15 spans each in ``chunk_metadata`` JSONB.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`s` | number
+`e` | number
+`c` | number
+
+## Example
+
+```typescript
+import type { SegmentSpan } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "s": null,
+  "e": null,
+  "c": null,
+} satisfies SegmentSpan
+
+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 SegmentSpan
+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/UploadConstraints.md

@@ -9,6 +9,8 @@ Name | Type
 `formats` | [Array<UploadFormat>](UploadFormat.md)
 `maxBytes` | number
 `maxImageBytes` | number
+`maxMediaBytes` | number
+`maxVideoBytes` | number
 
 ## Example
 
@@ -20,6 +22,8 @@ const example = {
   "formats": null,
   "maxBytes": null,
   "maxImageBytes": null,
+  "maxMediaBytes": null,
+  "maxVideoBytes": null,
 } satisfies UploadConstraints
 
 console.log(example)

package/package.json

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

package/src/apis/DocumentVersionsApi.ts

@@ -261,7 +261,7 @@ export interface DocumentVersionsApiInterface {
     /**
      * Creates request options for downloadDocumentVersion without sending the request
      * @param {string} versionId DocumentVersion ID
-     * @param {DownloadArtifact} [artifact] Artifact to download: source or fast_plaintext
+     * @param {DownloadArtifact} [artifact] Artifact to download: source, fast_plaintext, or transcript (media only)
      * @throws {RequiredError}
      * @memberof DocumentVersionsApiInterface
      */
@@ -271,7 +271,7 @@ export interface DocumentVersionsApiInterface {
      * Issue a short-lived, audited download link for a specific version.  Records a ``document.downloaded`` audit event anchored to the document so the customer audit log captures who downloaded which version and when.
      * @summary Download Document Version Handler
      * @param {string} versionId DocumentVersion ID
-     * @param {DownloadArtifact} [artifact] Artifact to download: source or fast_plaintext
+     * @param {DownloadArtifact} [artifact] Artifact to download: source, fast_plaintext, or transcript (media only)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DocumentVersionsApiInterface

package/src/apis/DocumentsApi.ts

@@ -304,7 +304,7 @@ export interface DocumentsApiInterface {
     /**
      * Creates request options for downloadDocument without sending the request
      * @param {string} documentId 
-     * @param {DownloadArtifact} [artifact] Artifact to download: source or fast_plaintext
+     * @param {DownloadArtifact} [artifact] Artifact to download: source, fast_plaintext, or transcript (media only)
      * @throws {RequiredError}
      * @memberof DocumentsApiInterface
      */
@@ -314,7 +314,7 @@ export interface DocumentsApiInterface {
      * Issue a short-lived, audited download link for a document\'s active version.  Records a ``document.downloaded`` audit event so the customer audit log captures who downloaded which document/version and when.
      * @summary Download Document Handler
      * @param {string} documentId 
-     * @param {DownloadArtifact} [artifact] Artifact to download: source or fast_plaintext
+     * @param {DownloadArtifact} [artifact] Artifact to download: source, fast_plaintext, or transcript (media only)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DocumentsApiInterface

package/src/models/ChunkMetadata.ts

@@ -13,6 +13,13 @@
  */
 
 import { mapValues } from '../runtime';
+import type { SegmentSpan } from './SegmentSpan';
+import {
+    SegmentSpanFromJSON,
+    SegmentSpanFromJSONTyped,
+    SegmentSpanToJSON,
+    SegmentSpanToJSONTyped,
+} from './SegmentSpan';
 import type { ImageTaxonomy } from './ImageTaxonomy';
 import {
     ImageTaxonomyFromJSON,
@@ -82,6 +89,12 @@ export interface ChunkMetadata {
      * @memberof ChunkMetadata
      */
     endMs?: number | null;
+    /**
+     * Per-ASR-segment spans inside this media chunk, in order, each carrying its char offset in the chunk content. Lets citation resolution narrow a chunk-level timeframe to the enclosing segment. None for non-media chunks and media ingested before this field existed.
+     * @type {Array<SegmentSpan>}
+     * @memberof ChunkMetadata
+     */
+    segments?: Array<SegmentSpan> | null;
     /**
      * Worksheet name this chunk was extracted from (XLSX only)
      * @type {string}
@@ -182,6 +195,7 @@ export function ChunkMetadataFromJSONTyped(json: any, ignoreDiscriminator: boole
         'secondaryTaxonomy': json['secondary_taxonomy'] == null ? undefined : ImageTaxonomyFromJSON(json['secondary_taxonomy']),
         'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
         'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
+        'segments': json['segments'] == null ? undefined : ((json['segments'] as Array<any>).map(SegmentSpanFromJSON)),
         'sheetName': json['sheet_name'] == null ? undefined : json['sheet_name'],
         'blockType': json['block_type'] == null ? undefined : json['block_type'],
         'sourceUri': json['source_uri'] == null ? undefined : json['source_uri'],
@@ -213,6 +227,7 @@ export function ChunkMetadataToJSONTyped(value?: ChunkMetadata | null, ignoreDis
         'secondary_taxonomy': ImageTaxonomyToJSON(value['secondaryTaxonomy']),
         'start_ms': value['startMs'],
         'end_ms': value['endMs'],
+        'segments': value['segments'] == null ? undefined : ((value['segments'] as Array<any>).map(SegmentSpanToJSON)),
         'sheet_name': value['sheetName'],
         'block_type': value['blockType'],
         'source_uri': value['sourceUri'],

package/src/models/DocumentVersionMetadata.ts

@@ -80,6 +80,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     fastPlaintextS3?: string | null;
+    /**
+     * S3 URI of the ASR transcript JSON (per-segment start_ms/end_ms/text); null for non-media. Chunks carry timings too, but at merged-chunk granularity, so this is the only per-segment source.
+     * @type {string}
+     * @memberof DocumentVersionMetadata
+     */
+    transcriptS3?: string | null;
     /**
      * Base64-encoded SHA256 hash of the uploaded source file
      * @type {string}
@@ -176,6 +182,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     quotaPageCount?: number;
+    /**
+     * MEDIA_MINUTE quantity charged at media preparation; 0 if not yet charged
+     * @type {number}
+     * @memberof DocumentVersionMetadata
+     */
+    quotaMediaMinutes?: number;
     /**
      * Stable consume key (matches workflow_id); 'UNSET' for pre-Phase-2 docs so refund logic short-circuits
      * @type {string}
@@ -235,6 +247,7 @@ export function DocumentVersionMetadataFromJSONTyped(json: any, ignoreDiscrimina
         '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'],
+        'transcriptS3': json['transcript_s3'] == null ? undefined : json['transcript_s3'],
         'hash': json['hash'] == null ? undefined : json['hash'],
         'pipelineState': json['pipeline_state'] == null ? undefined : PipelineStateFromJSON(json['pipeline_state']),
         'totalPages': json['total_pages'] == null ? undefined : json['total_pages'],
@@ -251,6 +264,7 @@ export function DocumentVersionMetadataFromJSONTyped(json: any, ignoreDiscrimina
         'informationStatistics': json['information_statistics'] == null ? undefined : InformationStatisticsFromJSON(json['information_statistics']),
         'quotaCharged': json['quota_charged'] == null ? undefined : json['quota_charged'],
         'quotaPageCount': json['quota_page_count'] == null ? undefined : json['quota_page_count'],
+        'quotaMediaMinutes': json['quota_media_minutes'] == null ? undefined : json['quota_media_minutes'],
         'quotaIdempotencyKey': json['quota_idempotency_key'] == null ? undefined : json['quota_idempotency_key'],
         'fileMd5': json['file_md5'] == null ? undefined : json['file_md5'],
         'idempotencyKey': json['idempotency_key'] == null ? undefined : json['idempotency_key'],
@@ -273,6 +287,7 @@ export function DocumentVersionMetadataToJSONTyped(value?: DocumentVersionMetada
         'preconversion_source_s3': value['preconversionSourceS3'],
         'cited_source_s3': value['citedSourceS3'],
         'fast_plaintext_s3': value['fastPlaintextS3'],
+        'transcript_s3': value['transcriptS3'],
         'hash': value['hash'],
         'pipeline_state': PipelineStateToJSON(value['pipelineState']),
         'total_pages': value['totalPages'],
@@ -289,6 +304,7 @@ export function DocumentVersionMetadataToJSONTyped(value?: DocumentVersionMetada
         'information_statistics': InformationStatisticsToJSON(value['informationStatistics']),
         'quota_charged': value['quotaCharged'],
         'quota_page_count': value['quotaPageCount'],
+        'quota_media_minutes': value['quotaMediaMinutes'],
         'quota_idempotency_key': value['quotaIdempotencyKey'],
         'file_md5': value['fileMd5'],
         'idempotency_key': value['idempotencyKey'],