@knowledge-stack/ksapi 2.10.2 → 2.11.0

package/.openapi-generator/FILES

@@ -369,6 +369,8 @@ docs/TimeseriesPoint.md
 docs/ToolDisplayType.md
 docs/ToolPart.md
 docs/ToolStatus.md
+docs/TranscriptionResponse.md
+docs/TranscriptionsApi.md
 docs/TransferOwnerRequest.md
 docs/TransferOwnerResponse.md
 docs/TrashApi.md
@@ -472,6 +474,7 @@ src/apis/TenantGroupsApi.ts
 src/apis/TenantsApi.ts
 src/apis/ThreadMessagesApi.ts
 src/apis/ThreadsApi.ts
+src/apis/TranscriptionsApi.ts
 src/apis/TrashApi.ts
 src/apis/UserPermissionsApi.ts
 src/apis/UsersApi.ts
@@ -812,6 +815,7 @@ src/models/TimeseriesPoint.ts
 src/models/ToolDisplayType.ts
 src/models/ToolPart.ts
 src/models/ToolStatus.ts
+src/models/TranscriptionResponse.ts
 src/models/TransferOwnerRequest.ts
 src/models/TransferOwnerResponse.ts
 src/models/TrashItemDetailResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@2.10.2
+# @knowledge-stack/ksapi@2.11.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -258,6 +258,7 @@ All URIs are relative to *http://localhost:8000*
 *ThreadsApi* | [**sendUserMessage**](docs/ThreadsApi.md#sendusermessage) | **POST** /v1/threads/{thread_id}/user_message | Send User Message Handler
 *ThreadsApi* | [**streamThread**](docs/ThreadsApi.md#streamthread) | **GET** /v1/threads/{thread_id}/stream | Stream Thread Handler
 *ThreadsApi* | [**updateThread**](docs/ThreadsApi.md#updatethreadoperation) | **PATCH** /v1/threads/{thread_id} | Update Thread Handler
+*TranscriptionsApi* | [**createTranscription**](docs/TranscriptionsApi.md#createtranscription) | **POST** /v1/transcriptions | Create Transcription Handler
 *TrashApi* | [**bulkPermanentlyDeleteTrash**](docs/TrashApi.md#bulkpermanentlydeletetrash) | **POST** /v1/trash/bulk-delete | Bulk Permanently Delete Trash Handler
 *TrashApi* | [**bulkRestoreTrash**](docs/TrashApi.md#bulkrestoretrash) | **POST** /v1/trash/bulk-restore | Bulk Restore Trash Handler
 *TrashApi* | [**getTrashItem**](docs/TrashApi.md#gettrashitem) | **GET** /v1/trash/{path_part_id} | Get Trash Item Handler
@@ -636,6 +637,7 @@ All URIs are relative to *http://localhost:8000*
 - [ToolDisplayType](docs/ToolDisplayType.md)
 - [ToolPart](docs/ToolPart.md)
 - [ToolStatus](docs/ToolStatus.md)
+- [TranscriptionResponse](docs/TranscriptionResponse.md)
 - [TransferOwnerRequest](docs/TransferOwnerRequest.md)
 - [TransferOwnerResponse](docs/TransferOwnerResponse.md)
 - [TrashItemDetailResponse](docs/TrashItemDetailResponse.md)
@@ -722,7 +724,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `2.10.2`
+- Package version: `2.11.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/TranscriptionsApi.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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 * as runtime from '../runtime';
+import type { SupportedLanguage, TranscriptionResponse } from '../models/index';
+export interface CreateTranscriptionRequest {
+    file: Blob;
+    language?: SupportedLanguage;
+}
+/**
+ * TranscriptionsApi - interface
+ *
+ * @export
+ * @interface TranscriptionsApiInterface
+ */
+export interface TranscriptionsApiInterface {
+    /**
+     * Creates request options for createTranscription without sending the request
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language]
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * @summary Create Transcription Handler
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse>;
+}
+/**
+ *
+ */
+export declare class TranscriptionsApi extends runtime.BaseAPI implements TranscriptionsApiInterface {
+    /**
+     * Creates request options for createTranscription without sending the request
+     */
+    createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse>;
+}

package/dist/apis/TranscriptionsApi.js

@@ -0,0 +1,135 @@
+"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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranscriptionsApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class TranscriptionsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for createTranscription without sending the request
+     */
+    createTranscriptionRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling createTranscription().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            if (requestParameters['language'] != null) {
+                formParams.append('language', requestParameters['language']);
+            }
+            let urlPath = `/v1/transcriptions`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            };
+        });
+    }
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscriptionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createTranscriptionRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.TranscriptionResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createTranscriptionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}
+exports.TranscriptionsApi = TranscriptionsApi;

package/dist/apis/index.d.ts

@@ -33,6 +33,7 @@ export * from './TenantGroupsApi';
 export * from './TenantsApi';
 export * from './ThreadMessagesApi';
 export * from './ThreadsApi';
+export * from './TranscriptionsApi';
 export * from './TrashApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';

package/dist/apis/index.js

@@ -51,6 +51,7 @@ __exportStar(require("./TenantGroupsApi"), exports);
 __exportStar(require("./TenantsApi"), exports);
 __exportStar(require("./ThreadMessagesApi"), exports);
 __exportStar(require("./ThreadsApi"), exports);
+__exportStar(require("./TranscriptionsApi"), exports);
 __exportStar(require("./TrashApi"), exports);
 __exportStar(require("./UserPermissionsApi"), exports);
 __exportStar(require("./UsersApi"), exports);

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

@@ -0,0 +1,67 @@
+/**
+ * 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 * as runtime from '../runtime';
+import type { SupportedLanguage, TranscriptionResponse } from '../models/index';
+export interface CreateTranscriptionRequest {
+    file: Blob;
+    language?: SupportedLanguage;
+}
+/**
+ * TranscriptionsApi - interface
+ *
+ * @export
+ * @interface TranscriptionsApiInterface
+ */
+export interface TranscriptionsApiInterface {
+    /**
+     * Creates request options for createTranscription without sending the request
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language]
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * @summary Create Transcription Handler
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse>;
+}
+/**
+ *
+ */
+export declare class TranscriptionsApi extends runtime.BaseAPI implements TranscriptionsApiInterface {
+    /**
+     * Creates request options for createTranscription without sending the request
+     */
+    createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>>;
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse>;
+}

package/dist/esm/apis/TranscriptionsApi.js

@@ -0,0 +1,98 @@
+/* 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.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as runtime from '../runtime';
+import { TranscriptionResponseFromJSON, } from '../models/index';
+/**
+ *
+ */
+export class TranscriptionsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for createTranscription without sending the request
+     */
+    createTranscriptionRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling createTranscription().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            if (requestParameters['language'] != null) {
+                formParams.append('language', requestParameters['language']);
+            }
+            let urlPath = `/v1/transcriptions`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            };
+        });
+    }
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscriptionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createTranscriptionRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => TranscriptionResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createTranscriptionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}

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

@@ -33,6 +33,7 @@ export * from './TenantGroupsApi';
 export * from './TenantsApi';
 export * from './ThreadMessagesApi';
 export * from './ThreadsApi';
+export * from './TranscriptionsApi';
 export * from './TrashApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';

package/dist/esm/apis/index.js

@@ -35,6 +35,7 @@ export * from './TenantGroupsApi';
 export * from './TenantsApi';
 export * from './ThreadMessagesApi';
 export * from './ThreadsApi';
+export * from './TranscriptionsApi';
 export * from './TrashApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';

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

@@ -46,6 +46,8 @@ export declare const ErrorResponseCodeEnum: {
     readonly NotFound: 'not_found';
     readonly Conflict: 'conflict';
     readonly RunBusy: 'run_busy';
+    readonly PayloadTooLarge: 'payload_too_large';
+    readonly UnsupportedMediaType: 'unsupported_media_type';
     readonly UnprocessableEntity: 'unprocessable_entity';
     readonly TooManyRequests: 'too_many_requests';
     readonly QuotaExceeded: 'quota_exceeded';

package/dist/esm/models/ErrorResponse.js

@@ -23,6 +23,8 @@ export const ErrorResponseCodeEnum = {
     NotFound: 'not_found',
     Conflict: 'conflict',
     RunBusy: 'run_busy',
+    PayloadTooLarge: 'payload_too_large',
+    UnsupportedMediaType: 'unsupported_media_type',
     UnprocessableEntity: 'unprocessable_entity',
     TooManyRequests: 'too_many_requests',
     QuotaExceeded: 'quota_exceeded',

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

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+/**
+ * A spoken clip rendered as text, ready to send as a chat message.
+ * @export
+ * @interface TranscriptionResponse
+ */
+export interface TranscriptionResponse {
+    /**
+     * The transcript. Empty when the clip contained no speech, which is a success, not an error.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    text: string;
+    /**
+     * The language ASR detected, or the one the caller pinned. Null when the backend reports none; the text is still valid.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    language?: string | null;
+}
+export declare const TranscriptionResponsePropertyValidationAttributesMap: {
+    [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 TranscriptionResponse interface.
+ */
+export declare function instanceOfTranscriptionResponse(value: object): value is TranscriptionResponse;
+export declare function TranscriptionResponseFromJSON(json: any): TranscriptionResponse;
+export declare function TranscriptionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): TranscriptionResponse;
+export declare function TranscriptionResponseToJSON(json: any): TranscriptionResponse;
+export declare function TranscriptionResponseToJSONTyped(value?: TranscriptionResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/TranscriptionResponse.js

@@ -0,0 +1,46 @@
+/* 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.
+ */
+export const TranscriptionResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the TranscriptionResponse interface.
+ */
+export function instanceOfTranscriptionResponse(value) {
+    if (!('text' in value) || value['text'] === undefined)
+        return false;
+    return true;
+}
+export function TranscriptionResponseFromJSON(json) {
+    return TranscriptionResponseFromJSONTyped(json, false);
+}
+export function TranscriptionResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'text': json['text'],
+        'language': json['language'] == null ? undefined : json['language'],
+    };
+}
+export function TranscriptionResponseToJSON(json) {
+    return TranscriptionResponseToJSONTyped(json, false);
+}
+export function TranscriptionResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'text': value['text'],
+        'language': value['language'],
+    };
+}

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

@@ -330,6 +330,7 @@ export * from './TimeseriesPoint';
 export * from './ToolDisplayType';
 export * from './ToolPart';
 export * from './ToolStatus';
+export * from './TranscriptionResponse';
 export * from './TransferOwnerRequest';
 export * from './TransferOwnerResponse';
 export * from './TrashItemDetailResponse';

package/dist/esm/models/index.js

@@ -332,6 +332,7 @@ export * from './TimeseriesPoint';
 export * from './ToolDisplayType';
 export * from './ToolPart';
 export * from './ToolStatus';
+export * from './TranscriptionResponse';
 export * from './TransferOwnerRequest';
 export * from './TransferOwnerResponse';
 export * from './TrashItemDetailResponse';

package/dist/models/ErrorResponse.d.ts

@@ -46,6 +46,8 @@ export declare const ErrorResponseCodeEnum: {
     readonly NotFound: 'not_found';
     readonly Conflict: 'conflict';
     readonly RunBusy: 'run_busy';
+    readonly PayloadTooLarge: 'payload_too_large';
+    readonly UnsupportedMediaType: 'unsupported_media_type';
     readonly UnprocessableEntity: 'unprocessable_entity';
     readonly TooManyRequests: 'too_many_requests';
     readonly QuotaExceeded: 'quota_exceeded';

package/dist/models/ErrorResponse.js

@@ -31,6 +31,8 @@ exports.ErrorResponseCodeEnum = {
     NotFound: 'not_found',
     Conflict: 'conflict',
     RunBusy: 'run_busy',
+    PayloadTooLarge: 'payload_too_large',
+    UnsupportedMediaType: 'unsupported_media_type',
     UnprocessableEntity: 'unprocessable_entity',
     TooManyRequests: 'too_many_requests',
     QuotaExceeded: 'quota_exceeded',

package/dist/models/TranscriptionResponse.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+/**
+ * A spoken clip rendered as text, ready to send as a chat message.
+ * @export
+ * @interface TranscriptionResponse
+ */
+export interface TranscriptionResponse {
+    /**
+     * The transcript. Empty when the clip contained no speech, which is a success, not an error.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    text: string;
+    /**
+     * The language ASR detected, or the one the caller pinned. Null when the backend reports none; the text is still valid.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    language?: string | null;
+}
+export declare const TranscriptionResponsePropertyValidationAttributesMap: {
+    [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 TranscriptionResponse interface.
+ */
+export declare function instanceOfTranscriptionResponse(value: object): value is TranscriptionResponse;
+export declare function TranscriptionResponseFromJSON(json: any): TranscriptionResponse;
+export declare function TranscriptionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): TranscriptionResponse;
+export declare function TranscriptionResponseToJSON(json: any): TranscriptionResponse;
+export declare function TranscriptionResponseToJSONTyped(value?: TranscriptionResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/TranscriptionResponse.js

@@ -0,0 +1,54 @@
+"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.TranscriptionResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfTranscriptionResponse = instanceOfTranscriptionResponse;
+exports.TranscriptionResponseFromJSON = TranscriptionResponseFromJSON;
+exports.TranscriptionResponseFromJSONTyped = TranscriptionResponseFromJSONTyped;
+exports.TranscriptionResponseToJSON = TranscriptionResponseToJSON;
+exports.TranscriptionResponseToJSONTyped = TranscriptionResponseToJSONTyped;
+exports.TranscriptionResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the TranscriptionResponse interface.
+ */
+function instanceOfTranscriptionResponse(value) {
+    if (!('text' in value) || value['text'] === undefined)
+        return false;
+    return true;
+}
+function TranscriptionResponseFromJSON(json) {
+    return TranscriptionResponseFromJSONTyped(json, false);
+}
+function TranscriptionResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'text': json['text'],
+        'language': json['language'] == null ? undefined : json['language'],
+    };
+}
+function TranscriptionResponseToJSON(json) {
+    return TranscriptionResponseToJSONTyped(json, false);
+}
+function TranscriptionResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'text': value['text'],
+        'language': value['language'],
+    };
+}

package/dist/models/index.d.ts

@@ -330,6 +330,7 @@ export * from './TimeseriesPoint';
 export * from './ToolDisplayType';
 export * from './ToolPart';
 export * from './ToolStatus';
+export * from './TranscriptionResponse';
 export * from './TransferOwnerRequest';
 export * from './TransferOwnerResponse';
 export * from './TrashItemDetailResponse';

package/dist/models/index.js

@@ -348,6 +348,7 @@ __exportStar(require("./TimeseriesPoint"), exports);
 __exportStar(require("./ToolDisplayType"), exports);
 __exportStar(require("./ToolPart"), exports);
 __exportStar(require("./ToolStatus"), exports);
+__exportStar(require("./TranscriptionResponse"), exports);
 __exportStar(require("./TransferOwnerRequest"), exports);
 __exportStar(require("./TransferOwnerResponse"), exports);
 __exportStar(require("./TrashItemDetailResponse"), exports);

package/docs/TranscriptionResponse.md

@@ -0,0 +1,37 @@
+
+# TranscriptionResponse
+
+A spoken clip rendered as text, ready to send as a chat message.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`text` | string
+`language` | string
+
+## Example
+
+```typescript
+import type { TranscriptionResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "text": 请帮我总结这份文档,
+  "language": zh,
+} satisfies TranscriptionResponse
+
+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 TranscriptionResponse
+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/TranscriptionsApi.md

@@ -0,0 +1,87 @@
+# TranscriptionsApi
+
+All URIs are relative to *http://localhost:8000*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**createTranscription**](TranscriptionsApi.md#createtranscription) | **POST** /v1/transcriptions | Create Transcription Handler |
+
+
+
+## createTranscription
+
+> TranscriptionResponse createTranscription(file, language)
+
+Create Transcription Handler
+
+Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TranscriptionsApi,
+} from '@knowledge-stack/ksapi';
+import type { CreateTranscriptionRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new TranscriptionsApi(config);
+
+  const body = {
+    // Blob | The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+    file: BINARY_DATA_HERE,
+    // SupportedLanguage (optional)
+    language: ...,
+  } satisfies CreateTranscriptionRequest;
+
+  try {
+    const data = await api.createTranscription(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **file** | `Blob` | The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend. | [Defaults to `undefined`] |
+| **language** | `SupportedLanguage` |  | [Optional] [Defaults to `undefined`] [Enum: en, zh] |
+
+### Return type
+
+[**TranscriptionResponse**](TranscriptionResponse.md)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `multipart/form-data`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+

package/package.json

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

package/src/apis/TranscriptionsApi.ts

@@ -0,0 +1,158 @@
+/* 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 * as runtime from '../runtime';
+import type {
+  ErrorResponse,
+  HTTPValidationError,
+  SupportedLanguage,
+  TranscriptionResponse,
+} from '../models/index';
+import {
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    SupportedLanguageFromJSON,
+    SupportedLanguageToJSON,
+    TranscriptionResponseFromJSON,
+    TranscriptionResponseToJSON,
+} from '../models/index';
+
+export interface CreateTranscriptionRequest {
+    file: Blob;
+    language?: SupportedLanguage;
+}
+
+/**
+ * TranscriptionsApi - interface
+ * 
+ * @export
+ * @interface TranscriptionsApiInterface
+ */
+export interface TranscriptionsApiInterface {
+    /**
+     * Creates request options for createTranscription without sending the request
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language] 
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * @summary Create Transcription Handler
+     * @param {Blob} file The audio clip. Accepts what a browser records (audio/webm, audio/ogg, audio/mp4) plus audio/mpeg, audio/wav and audio/flac. Re-encoded server-side, so the container does not have to match the backend.
+     * @param {SupportedLanguage} [language] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TranscriptionsApiInterface
+     */
+    createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>>;
+
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse>;
+
+}
+
+/**
+ * 
+ */
+export class TranscriptionsApi extends runtime.BaseAPI implements TranscriptionsApiInterface {
+
+    /**
+     * Creates request options for createTranscription without sending the request
+     */
+    async createTranscriptionRequestOpts(requestParameters: CreateTranscriptionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['file'] == null) {
+            throw new runtime.RequiredError(
+                'file',
+                'Required parameter "file" was null or undefined when calling createTranscription().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['file'] != null) {
+            formParams.append('file', requestParameters['file'] as any);
+        }
+
+        if (requestParameters['language'] != null) {
+            formParams.append('language', requestParameters['language'] as any);
+        }
+
+
+        let urlPath = `/v1/transcriptions`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    async createTranscriptionRaw(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TranscriptionResponse>> {
+        const requestOptions = await this.createTranscriptionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => TranscriptionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Transcribe a short spoken clip to text.  **Answers synchronously.** Unlike document ingestion there is no `Location` header and nothing to poll — the transcript is in the response body. Expect roughly a second per 10s of audio.  Send `multipart/form-data` with a `file` part; add `language` only to pin `zh` or `en` instead of auto-detecting. The clip is re-encoded server-side to mono 16 kHz mp3, so any listed container works.  Limits: **25 MiB** and **5 min** per clip.  Errors, all carrying the standard `code`/`request_id` body: `413` clip over either limit · `415` content type not accepted · `422` empty clip, or audio that could not be decoded · `503` the speech backend is unreachable or unconfigured.  The audio is held for one ASR call and never persisted; the transcript is never logged.
+     * Create Transcription Handler
+     */
+    async createTranscription(requestParameters: CreateTranscriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TranscriptionResponse> {
+        const response = await this.createTranscriptionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/index.ts

@@ -35,6 +35,7 @@ export * from './TenantGroupsApi';
 export * from './TenantsApi';
 export * from './ThreadMessagesApi';
 export * from './ThreadsApi';
+export * from './TranscriptionsApi';
 export * from './TrashApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';

package/src/models/ErrorResponse.ts

@@ -52,6 +52,8 @@ export const ErrorResponseCodeEnum = {
     NotFound: 'not_found',
     Conflict: 'conflict',
     RunBusy: 'run_busy',
+    PayloadTooLarge: 'payload_too_large',
+    UnsupportedMediaType: 'unsupported_media_type',
     UnprocessableEntity: 'unprocessable_entity',
     TooManyRequests: 'too_many_requests',
     QuotaExceeded: 'quota_exceeded',

package/src/models/TranscriptionResponse.ts

@@ -0,0 +1,91 @@
+/* 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';
+/**
+ * A spoken clip rendered as text, ready to send as a chat message.
+ * @export
+ * @interface TranscriptionResponse
+ */
+export interface TranscriptionResponse {
+    /**
+     * The transcript. Empty when the clip contained no speech, which is a success, not an error.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    text: string;
+    /**
+     * The language ASR detected, or the one the caller pinned. Null when the backend reports none; the text is still valid.
+     * @type {string}
+     * @memberof TranscriptionResponse
+     */
+    language?: string | null;
+}
+export const TranscriptionResponsePropertyValidationAttributesMap: {
+    [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 TranscriptionResponse interface.
+ */
+export function instanceOfTranscriptionResponse(value: object): value is TranscriptionResponse {
+    if (!('text' in value) || value['text'] === undefined) return false;
+    return true;
+}
+
+export function TranscriptionResponseFromJSON(json: any): TranscriptionResponse {
+    return TranscriptionResponseFromJSONTyped(json, false);
+}
+
+export function TranscriptionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): TranscriptionResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'text': json['text'],
+        'language': json['language'] == null ? undefined : json['language'],
+    };
+}
+
+export function TranscriptionResponseToJSON(json: any): TranscriptionResponse {
+    return TranscriptionResponseToJSONTyped(json, false);
+}
+
+export function TranscriptionResponseToJSONTyped(value?: TranscriptionResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'text': value['text'],
+        'language': value['language'],
+    };
+}
+

package/src/models/index.ts

@@ -332,6 +332,7 @@ export * from './TimeseriesPoint';
 export * from './ToolDisplayType';
 export * from './ToolPart';
 export * from './ToolStatus';
+export * from './TranscriptionResponse';
 export * from './TransferOwnerRequest';
 export * from './TransferOwnerResponse';
 export * from './TrashItemDetailResponse';