@knowledge-stack/ksapi 1.156.1 → 1.158.0

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/UserMessageRequest.d.ts

@@ -21,6 +21,12 @@ export interface UserMessageRequest {
      * @memberof UserMessageRequest
      */
     inputText?: string;
+    /**
+     * Answer with the faster, lower-cost chat profile. Ignored when the tenant pins a chat profile and on workflow-run threads.
+     * @type {boolean}
+     * @memberof UserMessageRequest
+     */
+    fastMode?: boolean;
 }
 export declare const UserMessageRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/UserMessageRequest.js

@@ -35,6 +35,7 @@ function UserMessageRequestFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'inputText': json['input_text'] == null ? undefined : json['input_text'],
+        'fastMode': json['fast_mode'] == null ? undefined : json['fast_mode'],
     };
 }
 function UserMessageRequestToJSON(json) {
@@ -46,5 +47,6 @@ function UserMessageRequestToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'input_text': value['inputText'],
+        'fast_mode': value['fastMode'],
     };
 }

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

@@ -29,6 +29,7 @@ Name | Type
 `informationStatistics` | [InformationStatistics](InformationStatistics.md)
 `quotaCharged` | boolean
 `quotaPageCount` | number
+`quotaMediaMinutes` | number
 `quotaIdempotencyKey` | string
 `fileMd5` | string
 `idempotencyKey` | string
@@ -62,6 +63,7 @@ const example = {
   "informationStatistics": null,
   "quotaCharged": null,
   "quotaPageCount": null,
+  "quotaMediaMinutes": null,
   "quotaIdempotencyKey": null,
   "fileMd5": null,
   "idempotencyKey": null,

package/docs/DocumentVersionMetadataUpdate.md

@@ -32,6 +32,7 @@ Name | Type
 `informationStatistics` | [InformationStatistics](InformationStatistics.md)
 `quotaCharged` | boolean
 `quotaPageCount` | number
+`quotaMediaMinutes` | number
 `quotaIdempotencyKey` | string
 `fileMd5` | string
 
@@ -67,6 +68,7 @@ const example = {
   "informationStatistics": null,
   "quotaCharged": null,
   "quotaPageCount": null,
+  "quotaMediaMinutes": null,
   "quotaIdempotencyKey": null,
   "fileMd5": null,
 } satisfies DocumentVersionMetadataUpdate

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/docs/UserMessageRequest.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `inputText` | string
+`fastMode` | boolean
 
 ## Example
 
@@ -16,6 +17,7 @@ import type { UserMessageRequest } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "inputText": null,
+  "fastMode": null,
 } satisfies UserMessageRequest
 
 console.log(example)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.156.1",
+  "version": "1.158.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

@@ -182,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}
@@ -258,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'],
@@ -297,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'],

package/src/models/DocumentVersionMetadataUpdate.ts

@@ -194,6 +194,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     quotaPageCount?: number | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    quotaMediaMinutes?: number | null;
     /**
      * 
      * @type {string}
@@ -267,6 +273,7 @@ export function DocumentVersionMetadataUpdateFromJSONTyped(json: any, ignoreDisc
         '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'],
     };
@@ -308,6 +315,7 @@ export function DocumentVersionMetadataUpdateToJSONTyped(value?: DocumentVersion
         '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'],
     };

package/src/models/DownloadArtifact.ts

@@ -19,7 +19,8 @@
  */
 export const DownloadArtifact = {
     Source: 'source',
-    FastPlaintext: 'fast_plaintext'
+    FastPlaintext: 'fast_plaintext',
+    Transcript: 'transcript'
 } as const;
 export type DownloadArtifact = typeof DownloadArtifact[keyof typeof DownloadArtifact];
 

package/src/models/SegmentSpan.ts

@@ -0,0 +1,104 @@
+/* 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.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * 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 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 function instanceOfSegmentSpan(value: object): value is SegmentSpan {
+    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;
+}
+
+export function SegmentSpanFromJSON(json: any): SegmentSpan {
+    return SegmentSpanFromJSONTyped(json, false);
+}
+
+export function SegmentSpanFromJSONTyped(json: any, ignoreDiscriminator: boolean): SegmentSpan {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        's': json['s'],
+        'e': json['e'],
+        'c': json['c'],
+    };
+}
+
+export function SegmentSpanToJSON(json: any): SegmentSpan {
+    return SegmentSpanToJSONTyped(json, false);
+}
+
+export function SegmentSpanToJSONTyped(value?: SegmentSpan | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        's': value['s'],
+        'e': value['e'],
+        'c': value['c'],
+    };
+}
+