@knowledge-stack/ksapi 1.152.0 → 1.153.0

package/src/models/CompleteUploadRequest.ts

@@ -0,0 +1,83 @@
+/* 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';
+/**
+ * Finalize a resumable upload and start ingestion.
+ * @export
+ * @interface CompleteUploadRequest
+ */
+export interface CompleteUploadRequest {
+    /**
+     * Token from create-upload
+     * @type {string}
+     * @memberof CompleteUploadRequest
+     */
+    uploadToken: string;
+}
+export const CompleteUploadRequestPropertyValidationAttributesMap: {
+    [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 CompleteUploadRequest interface.
+ */
+export function instanceOfCompleteUploadRequest(value: object): value is CompleteUploadRequest {
+    if (!('uploadToken' in value) || value['uploadToken'] === undefined) return false;
+    return true;
+}
+
+export function CompleteUploadRequestFromJSON(json: any): CompleteUploadRequest {
+    return CompleteUploadRequestFromJSONTyped(json, false);
+}
+
+export function CompleteUploadRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CompleteUploadRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'uploadToken': json['upload_token'],
+    };
+}
+
+export function CompleteUploadRequestToJSON(json: any): CompleteUploadRequest {
+    return CompleteUploadRequestToJSONTyped(json, false);
+}
+
+export function CompleteUploadRequestToJSONTyped(value?: CompleteUploadRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'upload_token': value['uploadToken'],
+    };
+}
+

package/src/models/CreateUploadRequest.ts

@@ -0,0 +1,110 @@
+/* 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';
+/**
+ * Begin a resumable upload.
+ * @export
+ * @interface CreateUploadRequest
+ */
+export interface CreateUploadRequest {
+    /**
+     * Parent folder path part ID (FOLDER)
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    parentPathId: string;
+    /**
+     * Document name
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    name: string;
+    /**
+     * Original filename; its extension selects the type + size cap
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    filename: string;
+    /**
+     * Declared total size; fast-rejected against the type cap
+     * @type {number}
+     * @memberof CreateUploadRequest
+     */
+    sizeBytes: number;
+}
+export const CreateUploadRequestPropertyValidationAttributesMap: {
+    [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 CreateUploadRequest interface.
+ */
+export function instanceOfCreateUploadRequest(value: object): value is CreateUploadRequest {
+    if (!('parentPathId' in value) || value['parentPathId'] === undefined) return false;
+    if (!('name' in value) || value['name'] === undefined) return false;
+    if (!('filename' in value) || value['filename'] === undefined) return false;
+    if (!('sizeBytes' in value) || value['sizeBytes'] === undefined) return false;
+    return true;
+}
+
+export function CreateUploadRequestFromJSON(json: any): CreateUploadRequest {
+    return CreateUploadRequestFromJSONTyped(json, false);
+}
+
+export function CreateUploadRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateUploadRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'parentPathId': json['parent_path_id'],
+        'name': json['name'],
+        'filename': json['filename'],
+        'sizeBytes': json['size_bytes'],
+    };
+}
+
+export function CreateUploadRequestToJSON(json: any): CreateUploadRequest {
+    return CreateUploadRequestToJSONTyped(json, false);
+}
+
+export function CreateUploadRequestToJSONTyped(value?: CreateUploadRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'parent_path_id': value['parentPathId'],
+        'name': value['name'],
+        'filename': value['filename'],
+        'size_bytes': value['sizeBytes'],
+    };
+}
+

package/src/models/CreateUploadResponse.ts

@@ -0,0 +1,110 @@
+/* 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';
+/**
+ * Handles for a started resumable upload.
+ * @export
+ * @interface CreateUploadResponse
+ */
+export interface CreateUploadResponse {
+    /**
+     * 
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    documentId: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    documentVersionId: string;
+    /**
+     * Opaque token; return it on every part/status/complete/abort
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    uploadToken: string;
+    /**
+     * Recommended part size in bytes; every part except the last must be at least 5 MiB
+     * @type {number}
+     * @memberof CreateUploadResponse
+     */
+    partSize: number;
+}
+export const CreateUploadResponsePropertyValidationAttributesMap: {
+    [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 CreateUploadResponse interface.
+ */
+export function instanceOfCreateUploadResponse(value: object): value is CreateUploadResponse {
+    if (!('documentId' in value) || value['documentId'] === undefined) return false;
+    if (!('documentVersionId' in value) || value['documentVersionId'] === undefined) return false;
+    if (!('uploadToken' in value) || value['uploadToken'] === undefined) return false;
+    if (!('partSize' in value) || value['partSize'] === undefined) return false;
+    return true;
+}
+
+export function CreateUploadResponseFromJSON(json: any): CreateUploadResponse {
+    return CreateUploadResponseFromJSONTyped(json, false);
+}
+
+export function CreateUploadResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateUploadResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'documentId': json['document_id'],
+        'documentVersionId': json['document_version_id'],
+        'uploadToken': json['upload_token'],
+        'partSize': json['part_size'],
+    };
+}
+
+export function CreateUploadResponseToJSON(json: any): CreateUploadResponse {
+    return CreateUploadResponseToJSONTyped(json, false);
+}
+
+export function CreateUploadResponseToJSONTyped(value?: CreateUploadResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'document_id': value['documentId'],
+        'document_version_id': value['documentVersionId'],
+        'upload_token': value['uploadToken'],
+        'part_size': value['partSize'],
+    };
+}
+

package/src/models/DocumentType.ts

@@ -28,6 +28,8 @@ export const DocumentType = {
     Json: 'JSON',
     Yaml: 'YAML',
     Code: 'CODE',
+    Audio: 'AUDIO',
+    Video: 'VIDEO',
     Unknown: 'UNKNOWN'
 } as const;
 export type DocumentType = typeof DocumentType[keyof typeof DocumentType];

package/src/models/EnrichedCitation.ts

@@ -43,6 +43,18 @@ export interface EnrichedCitation {
      * @memberof EnrichedCitation
      */
     length: number;
+    /**
+     * Start time (ms) of the cited chunk in the source media, for AUDIO/VIDEO — lets the client deep-link playback to the moment. None for non-media chunks.
+     * @type {number}
+     * @memberof EnrichedCitation
+     */
+    startMs?: number | null;
+    /**
+     * End time (ms) of the cited chunk in the source media (AUDIO/VIDEO); None for non-media chunks.
+     * @type {number}
+     * @memberof EnrichedCitation
+     */
+    endMs?: number | null;
     /**
      * 
      * @type {string}
@@ -127,6 +139,8 @@ export function EnrichedCitationFromJSONTyped(json: any, ignoreDiscriminator: bo
         'quote': json['quote'],
         'startChar': json['start_char'],
         'length': json['length'],
+        'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
+        'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
         'documentId': json['document_id'] == null ? undefined : json['document_id'],
         'documentVersionId': json['document_version_id'] == null ? undefined : json['document_version_id'],
         'documentName': json['document_name'] == null ? undefined : json['document_name'],
@@ -151,6 +165,8 @@ export function EnrichedCitationToJSONTyped(value?: EnrichedCitation | null, ign
         'quote': value['quote'],
         'start_char': value['startChar'],
         'length': value['length'],
+        'start_ms': value['startMs'],
+        'end_ms': value['endMs'],
         'document_id': value['documentId'],
         'document_version_id': value['documentVersionId'],
         'document_name': value['documentName'],

package/src/models/IngestionMode.ts

@@ -20,7 +20,8 @@
 export const IngestionMode = {
     HighAccuracy: 'high_accuracy',
     Standard: 'standard',
-    SingleChunk: 'single_chunk'
+    SingleChunk: 'single_chunk',
+    Media: 'media'
 } as const;
 export type IngestionMode = typeof IngestionMode[keyof typeof IngestionMode];
 

package/src/models/SubscriptionPlanResponse.ts

@@ -55,6 +55,12 @@ export interface SubscriptionPlanResponse {
      * @memberof SubscriptionPlanResponse
      */
     searches: number;
+    /**
+     * Per-period cap on transcribed media minutes (MEDIA_MINUTE).
+     * @type {number}
+     * @memberof SubscriptionPlanResponse
+     */
+    mediaMinutes: number;
     /**
      * Upper bound on num_seats accepted by the upgrade endpoint. Admin PATCH may set tenant.seats above this value.
      * @type {number}
@@ -107,6 +113,7 @@ export function instanceOfSubscriptionPlanResponse(value: object): value is Subs
     if (!('ingestedPages' in value) || value['ingestedPages'] === undefined) return false;
     if (!('messages' in value) || value['messages'] === undefined) return false;
     if (!('searches' in value) || value['searches'] === undefined) return false;
+    if (!('mediaMinutes' in value) || value['mediaMinutes'] === undefined) return false;
     if (!('maxSeats' in value) || value['maxSeats'] === undefined) return false;
     if (!('_public' in value) || value['_public'] === undefined) return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined) return false;
@@ -129,6 +136,7 @@ export function SubscriptionPlanResponseFromJSONTyped(json: any, ignoreDiscrimin
         'ingestedPages': json['ingested_pages'],
         'messages': json['messages'],
         'searches': json['searches'],
+        'mediaMinutes': json['media_minutes'],
         'maxSeats': json['max_seats'],
         '_public': json['public'],
         'createdAt': (new Date(json['created_at'])),
@@ -152,6 +160,7 @@ export function SubscriptionPlanResponseToJSONTyped(value?: SubscriptionPlanResp
         'ingested_pages': value['ingestedPages'],
         'messages': value['messages'],
         'searches': value['searches'],
+        'media_minutes': value['mediaMinutes'],
         'max_seats': value['maxSeats'],
         'public': value['_public'],
         'created_at': value['createdAt'].toISOString(),

package/src/models/UploadPartResponse.ts

@@ -0,0 +1,101 @@
+/* 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';
+/**
+ * Acknowledgement of one stored part.
+ * @export
+ * @interface UploadPartResponse
+ */
+export interface UploadPartResponse {
+    /**
+     * 
+     * @type {number}
+     * @memberof UploadPartResponse
+     */
+    partNumber: number;
+    /**
+     * 
+     * @type {string}
+     * @memberof UploadPartResponse
+     */
+    etag: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof UploadPartResponse
+     */
+    size: number;
+}
+export const UploadPartResponsePropertyValidationAttributesMap: {
+    [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 UploadPartResponse interface.
+ */
+export function instanceOfUploadPartResponse(value: object): value is UploadPartResponse {
+    if (!('partNumber' in value) || value['partNumber'] === undefined) return false;
+    if (!('etag' in value) || value['etag'] === undefined) return false;
+    if (!('size' in value) || value['size'] === undefined) return false;
+    return true;
+}
+
+export function UploadPartResponseFromJSON(json: any): UploadPartResponse {
+    return UploadPartResponseFromJSONTyped(json, false);
+}
+
+export function UploadPartResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadPartResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'partNumber': json['part_number'],
+        'etag': json['etag'],
+        'size': json['size'],
+    };
+}
+
+export function UploadPartResponseToJSON(json: any): UploadPartResponse {
+    return UploadPartResponseToJSONTyped(json, false);
+}
+
+export function UploadPartResponseToJSONTyped(value?: UploadPartResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'part_number': value['partNumber'],
+        'etag': value['etag'],
+        'size': value['size'],
+    };
+}
+

package/src/models/UploadStatusResponse.ts

@@ -0,0 +1,100 @@
+/* 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';
+import type { UploadPartResponse } from './UploadPartResponse';
+import {
+    UploadPartResponseFromJSON,
+    UploadPartResponseFromJSONTyped,
+    UploadPartResponseToJSON,
+    UploadPartResponseToJSONTyped,
+} from './UploadPartResponse';
+
+/**
+ * Parts S3 already holds — resume by re-sending the rest.
+ * @export
+ * @interface UploadStatusResponse
+ */
+export interface UploadStatusResponse {
+    /**
+     * 
+     * @type {Array<UploadPartResponse>}
+     * @memberof UploadStatusResponse
+     */
+    parts: Array<UploadPartResponse>;
+    /**
+     * 
+     * @type {number}
+     * @memberof UploadStatusResponse
+     */
+    uploadedBytes: number;
+}
+export const UploadStatusResponsePropertyValidationAttributesMap: {
+    [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 UploadStatusResponse interface.
+ */
+export function instanceOfUploadStatusResponse(value: object): value is UploadStatusResponse {
+    if (!('parts' in value) || value['parts'] === undefined) return false;
+    if (!('uploadedBytes' in value) || value['uploadedBytes'] === undefined) return false;
+    return true;
+}
+
+export function UploadStatusResponseFromJSON(json: any): UploadStatusResponse {
+    return UploadStatusResponseFromJSONTyped(json, false);
+}
+
+export function UploadStatusResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadStatusResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'parts': ((json['parts'] as Array<any>).map(UploadPartResponseFromJSON)),
+        'uploadedBytes': json['uploaded_bytes'],
+    };
+}
+
+export function UploadStatusResponseToJSON(json: any): UploadStatusResponse {
+    return UploadStatusResponseToJSONTyped(json, false);
+}
+
+export function UploadStatusResponseToJSONTyped(value?: UploadStatusResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'parts': ((value['parts'] as Array<any>).map(UploadPartResponseToJSON)),
+        'uploaded_bytes': value['uploadedBytes'],
+    };
+}
+

package/src/models/UsageMetric.ts

@@ -20,7 +20,8 @@
 export const UsageMetric = {
     Page: 'PAGE',
     Search: 'SEARCH',
-    Message: 'MESSAGE'
+    Message: 'MESSAGE',
+    MediaMinute: 'MEDIA_MINUTE'
 } as const;
 export type UsageMetric = typeof UsageMetric[keyof typeof UsageMetric];
 

package/src/models/index.ts

@@ -49,6 +49,7 @@ export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
+export * from './CompleteUploadRequest';
 export * from './ConnectionConfig';
 export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
@@ -69,6 +70,8 @@ export * from './CreateSkillRequest';
 export * from './CreateTagRequest';
 export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
+export * from './CreateUploadRequest';
+export * from './CreateUploadResponse';
 export * from './CreateWorkflowDefinitionRequest';
 export * from './DataSourceCatalogResponse';
 export * from './DataSourceDescribeResponse';
@@ -330,6 +333,8 @@ export * from './UpdateWorkflowDefinitionRequest';
 export * from './UpdateWorkflowRunRequest';
 export * from './UploadConstraints';
 export * from './UploadFormat';
+export * from './UploadPartResponse';
+export * from './UploadStatusResponse';
 export * from './UsageMetric';
 export * from './UserInfo';
 export * from './UserMessageRequest';