@knowledge-stack/ksapi 3.5.2 → 3.6.1

package/.openapi-generator/FILES

@@ -121,6 +121,11 @@ docs/DataSourceTableResponse.md
 docs/DataSourcesApi.md
 docs/DefaultApi.md
 docs/DefinitionOutputStat.md
+docs/DiagnosticTraceFailureReason.md
+docs/DiagnosticTraceItem.md
+docs/DiagnosticTraceStatus.md
+docs/DiagnosticsApi.md
+docs/DiagnosticsResponse.md
 docs/DiffFormat.md
 docs/DiffRow.md
 docs/DiffRowType.md
@@ -374,6 +379,7 @@ docs/TimeseriesPoint.md
 docs/ToolDisplayType.md
 docs/ToolPart.md
 docs/ToolStatus.md
+docs/TraceKind.md
 docs/TranscriptionResponse.md
 docs/TranscriptionsApi.md
 docs/TransferOwnerRequest.md
@@ -462,6 +468,7 @@ src/apis/ChunkLineagesApi.ts
 src/apis/ChunksApi.ts
 src/apis/DataSourcesApi.ts
 src/apis/DefaultApi.ts
+src/apis/DiagnosticsApi.ts
 src/apis/DocumentCheckoutApi.ts
 src/apis/DocumentVersionsApi.ts
 src/apis/DocumentsApi.ts
@@ -595,6 +602,10 @@ src/models/DataSourceSchemaResponse.ts
 src/models/DataSourceSyncResponse.ts
 src/models/DataSourceTableResponse.ts
 src/models/DefinitionOutputStat.ts
+src/models/DiagnosticTraceFailureReason.ts
+src/models/DiagnosticTraceItem.ts
+src/models/DiagnosticTraceStatus.ts
+src/models/DiagnosticsResponse.ts
 src/models/DiffFormat.ts
 src/models/DiffRow.ts
 src/models/DiffRowType.ts
@@ -828,6 +839,7 @@ src/models/TimeseriesPoint.ts
 src/models/ToolDisplayType.ts
 src/models/ToolPart.ts
 src/models/ToolStatus.ts
+src/models/TraceKind.ts
 src/models/TranscriptionResponse.ts
 src/models/TransferOwnerRequest.ts
 src/models/TransferOwnerResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@3.5.2
+# @knowledge-stack/ksapi@3.6.1
 
 A TypeScript SDK client for the localhost API.
 
@@ -125,6 +125,8 @@ All URIs are relative to *http://localhost:8000*
 *DataSourcesApi* | [**updateDataSourceTable**](docs/DataSourcesApi.md#updatedatasourcetable) | **PATCH** /v1/data-sources/{data_source_id}/tables/{table_id} | Update Data Source Table Handler
 *DefaultApi* | [**healthCheck**](docs/DefaultApi.md#healthcheck) | **GET** /healthz | Health Check Handler
 *DefaultApi* | [**hello**](docs/DefaultApi.md#hello) | **GET** / | Root Handler
+*DiagnosticsApi* | [**computeThreadDiagnostics**](docs/DiagnosticsApi.md#computethreaddiagnostics) | **POST** /v1/diagnostics/threads/{thread_id} | Compute Thread Diagnostics Handler
+*DiagnosticsApi* | [**computeWorkflowRunDiagnostics**](docs/DiagnosticsApi.md#computeworkflowrundiagnostics) | **POST** /v1/diagnostics/workflow-runs/{run_id} | Compute Workflow Run Diagnostics Handler
 *DocumentCheckoutApi* | [**acquireDocumentCheckout**](docs/DocumentCheckoutApi.md#acquiredocumentcheckout) | **POST** /v1/documents/{document_id}/checkout | Acquire Document Checkout Handler
 *DocumentCheckoutApi* | [**getDocumentCheckout**](docs/DocumentCheckoutApi.md#getdocumentcheckout) | **GET** /v1/documents/{document_id}/checkout | Get Document Checkout Handler
 *DocumentCheckoutApi* | [**releaseDocumentCheckout**](docs/DocumentCheckoutApi.md#releasedocumentcheckout) | **DELETE** /v1/documents/{document_id}/checkout | Release Document Checkout Handler
@@ -410,6 +412,10 @@ All URIs are relative to *http://localhost:8000*
 - [DataSourceSyncResponse](docs/DataSourceSyncResponse.md)
 - [DataSourceTableResponse](docs/DataSourceTableResponse.md)
 - [DefinitionOutputStat](docs/DefinitionOutputStat.md)
+- [DiagnosticTraceFailureReason](docs/DiagnosticTraceFailureReason.md)
+- [DiagnosticTraceItem](docs/DiagnosticTraceItem.md)
+- [DiagnosticTraceStatus](docs/DiagnosticTraceStatus.md)
+- [DiagnosticsResponse](docs/DiagnosticsResponse.md)
 - [DiffFormat](docs/DiffFormat.md)
 - [DiffRow](docs/DiffRow.md)
 - [DiffRowType](docs/DiffRowType.md)
@@ -643,6 +649,7 @@ All URIs are relative to *http://localhost:8000*
 - [ToolDisplayType](docs/ToolDisplayType.md)
 - [ToolPart](docs/ToolPart.md)
 - [ToolStatus](docs/ToolStatus.md)
+- [TraceKind](docs/TraceKind.md)
 - [TranscriptionResponse](docs/TranscriptionResponse.md)
 - [TransferOwnerRequest](docs/TransferOwnerRequest.md)
 - [TransferOwnerResponse](docs/TransferOwnerResponse.md)
@@ -733,7 +740,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `3.5.2`
+- Package version: `3.6.1`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/DiagnosticsApi.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 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 { DiagnosticsResponse } from '../models/index';
+export interface ComputeThreadDiagnosticsRequest {
+    threadId: string;
+}
+export interface ComputeWorkflowRunDiagnosticsRequest {
+    runId: string;
+}
+/**
+ * DiagnosticsApi - interface
+ *
+ * @export
+ * @interface DiagnosticsApiInterface
+ */
+export interface DiagnosticsApiInterface {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     * @param {string} threadId
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters: ComputeThreadDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * @summary Compute Thread Diagnostics Handler
+     * @param {string} threadId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeThreadDiagnosticsRaw(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     * @param {string} runId
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters: ComputeWorkflowRunDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * @summary Compute Workflow Run Diagnostics Handler
+     * @param {string} runId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+}
+/**
+ *
+ */
+export declare class DiagnosticsApi extends runtime.BaseAPI implements DiagnosticsApiInterface {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters: ComputeThreadDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnosticsRaw(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters: ComputeWorkflowRunDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+}

package/dist/apis/DiagnosticsApi.js

@@ -0,0 +1,162 @@
+"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.DiagnosticsApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class DiagnosticsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['threadId'] == null) {
+                throw new runtime.RequiredError('threadId', 'Required parameter "threadId" was null or undefined when calling computeThreadDiagnostics().');
+            }
+            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}`;
+                }
+            }
+            let urlPath = `/v1/diagnostics/threads/{thread_id}`;
+            urlPath = urlPath.replace(`{${"thread_id"}}`, encodeURIComponent(String(requestParameters['threadId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnosticsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.computeThreadDiagnosticsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DiagnosticsResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.computeThreadDiagnosticsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['runId'] == null) {
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling computeWorkflowRunDiagnostics().');
+            }
+            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}`;
+                }
+            }
+            let urlPath = `/v1/diagnostics/workflow-runs/{run_id}`;
+            urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.computeWorkflowRunDiagnosticsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DiagnosticsResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.computeWorkflowRunDiagnosticsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}
+exports.DiagnosticsApi = DiagnosticsApi;

package/dist/apis/index.d.ts

@@ -13,6 +13,7 @@ export * from './ChunkLineagesApi';
 export * from './ChunksApi';
 export * from './DataSourcesApi';
 export * from './DefaultApi';
+export * from './DiagnosticsApi';
 export * from './DocumentCheckoutApi';
 export * from './DocumentVersionsApi';
 export * from './DocumentsApi';

package/dist/apis/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./ChunkLineagesApi"), exports);
 __exportStar(require("./ChunksApi"), exports);
 __exportStar(require("./DataSourcesApi"), exports);
 __exportStar(require("./DefaultApi"), exports);
+__exportStar(require("./DiagnosticsApi"), exports);
 __exportStar(require("./DocumentCheckoutApi"), exports);
 __exportStar(require("./DocumentVersionsApi"), exports);
 __exportStar(require("./DocumentsApi"), exports);

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

@@ -0,0 +1,102 @@
+/**
+ * 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 { DiagnosticsResponse } from '../models/index';
+export interface ComputeThreadDiagnosticsRequest {
+    threadId: string;
+}
+export interface ComputeWorkflowRunDiagnosticsRequest {
+    runId: string;
+}
+/**
+ * DiagnosticsApi - interface
+ *
+ * @export
+ * @interface DiagnosticsApiInterface
+ */
+export interface DiagnosticsApiInterface {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     * @param {string} threadId
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters: ComputeThreadDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * @summary Compute Thread Diagnostics Handler
+     * @param {string} threadId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeThreadDiagnosticsRaw(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     * @param {string} runId
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters: ComputeWorkflowRunDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * @summary Compute Workflow Run Diagnostics Handler
+     * @param {string} runId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+}
+/**
+ *
+ */
+export declare class DiagnosticsApi extends runtime.BaseAPI implements DiagnosticsApiInterface {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters: ComputeThreadDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnosticsRaw(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters: ComputeThreadDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters: ComputeWorkflowRunDiagnosticsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DiagnosticsResponse>>;
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters: ComputeWorkflowRunDiagnosticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DiagnosticsResponse>;
+}

package/dist/esm/apis/DiagnosticsApi.js

@@ -0,0 +1,125 @@
+/* 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 { DiagnosticsResponseFromJSON, } from '../models/index';
+/**
+ *
+ */
+export class DiagnosticsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for computeThreadDiagnostics without sending the request
+     */
+    computeThreadDiagnosticsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['threadId'] == null) {
+                throw new runtime.RequiredError('threadId', 'Required parameter "threadId" was null or undefined when calling computeThreadDiagnostics().');
+            }
+            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}`;
+                }
+            }
+            let urlPath = `/v1/diagnostics/threads/{thread_id}`;
+            urlPath = urlPath.replace(`{${"thread_id"}}`, encodeURIComponent(String(requestParameters['threadId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnosticsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.computeThreadDiagnosticsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DiagnosticsResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Stats and trace links for every turn; a run\'s thread answers as its run.
+     * Compute Thread Diagnostics Handler
+     */
+    computeThreadDiagnostics(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.computeThreadDiagnosticsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for computeWorkflowRunDiagnostics without sending the request
+     */
+    computeWorkflowRunDiagnosticsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['runId'] == null) {
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling computeWorkflowRunDiagnostics().');
+            }
+            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}`;
+                }
+            }
+            let urlPath = `/v1/diagnostics/workflow-runs/{run_id}`;
+            urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnosticsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.computeWorkflowRunDiagnosticsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DiagnosticsResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Stats and trace links for the run\'s attempts and every turn in its thread.
+     * Compute Workflow Run Diagnostics Handler
+     */
+    computeWorkflowRunDiagnostics(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.computeWorkflowRunDiagnosticsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}

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

@@ -13,6 +13,7 @@ export * from './ChunkLineagesApi';
 export * from './ChunksApi';
 export * from './DataSourcesApi';
 export * from './DefaultApi';
+export * from './DiagnosticsApi';
 export * from './DocumentCheckoutApi';
 export * from './DocumentVersionsApi';
 export * from './DocumentsApi';

package/dist/esm/apis/index.js

@@ -15,6 +15,7 @@ export * from './ChunkLineagesApi';
 export * from './ChunksApi';
 export * from './DataSourcesApi';
 export * from './DefaultApi';
+export * from './DiagnosticsApi';
 export * from './DocumentCheckoutApi';
 export * from './DocumentVersionsApi';
 export * from './DocumentsApi';