@knowledge-stack/ksapi 1.139.1 → 1.140.1

package/src/apis/AdminWorkflowsApi.ts

@@ -0,0 +1,539 @@
+/* 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,
+  HourHistogramResponse,
+  RunTimeseriesResponse,
+  TimeBucket,
+  WorkflowLeaderboardResponse,
+  WorkflowOutputStatsResponse,
+  WorkflowRunSummaryResponse,
+} from '../models/index';
+import {
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    HourHistogramResponseFromJSON,
+    HourHistogramResponseToJSON,
+    RunTimeseriesResponseFromJSON,
+    RunTimeseriesResponseToJSON,
+    TimeBucketFromJSON,
+    TimeBucketToJSON,
+    WorkflowLeaderboardResponseFromJSON,
+    WorkflowLeaderboardResponseToJSON,
+    WorkflowOutputStatsResponseFromJSON,
+    WorkflowOutputStatsResponseToJSON,
+    WorkflowRunSummaryResponseFromJSON,
+    WorkflowRunSummaryResponseToJSON,
+} from '../models/index';
+
+export interface GetAdminWorkflowByHourRequest {
+    since?: Date | null;
+    until?: Date | null;
+    timezone?: string | null;
+    definitionId?: string | null;
+}
+
+export interface GetAdminWorkflowLeaderboardRequest {
+    since?: Date | null;
+    until?: Date | null;
+    limit?: number;
+}
+
+export interface GetAdminWorkflowOutputStatsRequest {
+    since?: Date | null;
+    until?: Date | null;
+}
+
+export interface GetAdminWorkflowSummaryRequest {
+    since?: Date | null;
+    until?: Date | null;
+    definitionId?: string | null;
+}
+
+export interface GetAdminWorkflowTimeseriesRequest {
+    since?: Date | null;
+    until?: Date | null;
+    bucket?: TimeBucket;
+    timezone?: string | null;
+    definitionId?: string | null;
+}
+
+/**
+ * AdminWorkflowsApi - interface
+ * 
+ * @export
+ * @interface AdminWorkflowsApiInterface
+ */
+export interface AdminWorkflowsApiInterface {
+    /**
+     * Creates request options for getAdminWorkflowByHour without sending the request
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {string} [timezone] IANA tz override; defaults to tenant setting.
+     * @param {string} [definitionId] Scope to one workflow.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowByHourRequestOpts(requestParameters: GetAdminWorkflowByHourRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Runs per hour-of-day (0-23) in the resolved timezone.
+     * @summary Get Admin Workflow By Hour Handler
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {string} [timezone] IANA tz override; defaults to tenant setting.
+     * @param {string} [definitionId] Scope to one workflow.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowByHourRaw(requestParameters: GetAdminWorkflowByHourRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HourHistogramResponse>>;
+
+    /**
+     * Runs per hour-of-day (0-23) in the resolved timezone.
+     * Get Admin Workflow By Hour Handler
+     */
+    getAdminWorkflowByHour(requestParameters: GetAdminWorkflowByHourRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HourHistogramResponse>;
+
+    /**
+     * Creates request options for getAdminWorkflowLeaderboard without sending the request
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {number} [limit] Top-N per leaderboard.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowLeaderboardRequestOpts(requestParameters: GetAdminWorkflowLeaderboardRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Top workflows and top run owners by run count.
+     * @summary Get Admin Workflow Leaderboard Handler
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {number} [limit] Top-N per leaderboard.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowLeaderboardRaw(requestParameters: GetAdminWorkflowLeaderboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowLeaderboardResponse>>;
+
+    /**
+     * Top workflows and top run owners by run count.
+     * Get Admin Workflow Leaderboard Handler
+     */
+    getAdminWorkflowLeaderboard(requestParameters: GetAdminWorkflowLeaderboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowLeaderboardResponse>;
+
+    /**
+     * Creates request options for getAdminWorkflowOutputStats without sending the request
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowOutputStatsRequestOpts(requestParameters: GetAdminWorkflowOutputStatsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Average output DOCUMENTs generated per workflow definition (completed runs).
+     * @summary Get Admin Workflow Output Stats Handler
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowOutputStatsRaw(requestParameters: GetAdminWorkflowOutputStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowOutputStatsResponse>>;
+
+    /**
+     * Average output DOCUMENTs generated per workflow definition (completed runs).
+     * Get Admin Workflow Output Stats Handler
+     */
+    getAdminWorkflowOutputStats(requestParameters: GetAdminWorkflowOutputStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowOutputStatsResponse>;
+
+    /**
+     * Creates request options for getAdminWorkflowSummary without sending the request
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
+     * @param {string} [definitionId] Scope all numbers to one workflow.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowSummaryRequestOpts(requestParameters: GetAdminWorkflowSummaryRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Tenant-wide run health: counts, failure rate, durations, approval backlog.
+     * @summary Get Admin Workflow Summary Handler
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
+     * @param {string} [definitionId] Scope all numbers to one workflow.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowSummaryRaw(requestParameters: GetAdminWorkflowSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunSummaryResponse>>;
+
+    /**
+     * Tenant-wide run health: counts, failure rate, durations, approval backlog.
+     * Get Admin Workflow Summary Handler
+     */
+    getAdminWorkflowSummary(requestParameters: GetAdminWorkflowSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunSummaryResponse>;
+
+    /**
+     * Creates request options for getAdminWorkflowTimeseries without sending the request
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {TimeBucket} [bucket] Bucket size.
+     * @param {string} [timezone] IANA tz override; defaults to tenant setting.
+     * @param {string} [definitionId] Scope to one workflow.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowTimeseriesRequestOpts(requestParameters: GetAdminWorkflowTimeseriesRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Run counts bucketed over time, in the resolved timezone.
+     * @summary Get Admin Workflow Timeseries Handler
+     * @param {Date} [since] Window start.
+     * @param {Date} [until] Window end.
+     * @param {TimeBucket} [bucket] Bucket size.
+     * @param {string} [timezone] IANA tz override; defaults to tenant setting.
+     * @param {string} [definitionId] Scope to one workflow.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdminWorkflowsApiInterface
+     */
+    getAdminWorkflowTimeseriesRaw(requestParameters: GetAdminWorkflowTimeseriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunTimeseriesResponse>>;
+
+    /**
+     * Run counts bucketed over time, in the resolved timezone.
+     * Get Admin Workflow Timeseries Handler
+     */
+    getAdminWorkflowTimeseries(requestParameters: GetAdminWorkflowTimeseriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunTimeseriesResponse>;
+
+}
+
+/**
+ * 
+ */
+export class AdminWorkflowsApi extends runtime.BaseAPI implements AdminWorkflowsApiInterface {
+
+    /**
+     * Creates request options for getAdminWorkflowByHour without sending the request
+     */
+    async getAdminWorkflowByHourRequestOpts(requestParameters: GetAdminWorkflowByHourRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        if (requestParameters['timezone'] != null) {
+            queryParameters['timezone'] = requestParameters['timezone'];
+        }
+
+        if (requestParameters['definitionId'] != null) {
+            queryParameters['definition_id'] = requestParameters['definitionId'];
+        }
+
+        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}`;
+            }
+        }
+
+        let urlPath = `/v1/admin/workflows/by-hour`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Runs per hour-of-day (0-23) in the resolved timezone.
+     * Get Admin Workflow By Hour Handler
+     */
+    async getAdminWorkflowByHourRaw(requestParameters: GetAdminWorkflowByHourRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HourHistogramResponse>> {
+        const requestOptions = await this.getAdminWorkflowByHourRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => HourHistogramResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Runs per hour-of-day (0-23) in the resolved timezone.
+     * Get Admin Workflow By Hour Handler
+     */
+    async getAdminWorkflowByHour(requestParameters: GetAdminWorkflowByHourRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HourHistogramResponse> {
+        const response = await this.getAdminWorkflowByHourRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getAdminWorkflowLeaderboard without sending the request
+     */
+    async getAdminWorkflowLeaderboardRequestOpts(requestParameters: GetAdminWorkflowLeaderboardRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        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}`;
+            }
+        }
+
+        let urlPath = `/v1/admin/workflows/leaderboard`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Top workflows and top run owners by run count.
+     * Get Admin Workflow Leaderboard Handler
+     */
+    async getAdminWorkflowLeaderboardRaw(requestParameters: GetAdminWorkflowLeaderboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowLeaderboardResponse>> {
+        const requestOptions = await this.getAdminWorkflowLeaderboardRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowLeaderboardResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Top workflows and top run owners by run count.
+     * Get Admin Workflow Leaderboard Handler
+     */
+    async getAdminWorkflowLeaderboard(requestParameters: GetAdminWorkflowLeaderboardRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowLeaderboardResponse> {
+        const response = await this.getAdminWorkflowLeaderboardRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getAdminWorkflowOutputStats without sending the request
+     */
+    async getAdminWorkflowOutputStatsRequestOpts(requestParameters: GetAdminWorkflowOutputStatsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        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}`;
+            }
+        }
+
+        let urlPath = `/v1/admin/workflows/output-stats`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Average output DOCUMENTs generated per workflow definition (completed runs).
+     * Get Admin Workflow Output Stats Handler
+     */
+    async getAdminWorkflowOutputStatsRaw(requestParameters: GetAdminWorkflowOutputStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowOutputStatsResponse>> {
+        const requestOptions = await this.getAdminWorkflowOutputStatsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowOutputStatsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Average output DOCUMENTs generated per workflow definition (completed runs).
+     * Get Admin Workflow Output Stats Handler
+     */
+    async getAdminWorkflowOutputStats(requestParameters: GetAdminWorkflowOutputStatsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowOutputStatsResponse> {
+        const response = await this.getAdminWorkflowOutputStatsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getAdminWorkflowSummary without sending the request
+     */
+    async getAdminWorkflowSummaryRequestOpts(requestParameters: GetAdminWorkflowSummaryRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        if (requestParameters['definitionId'] != null) {
+            queryParameters['definition_id'] = requestParameters['definitionId'];
+        }
+
+        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}`;
+            }
+        }
+
+        let urlPath = `/v1/admin/workflows/summary`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Tenant-wide run health: counts, failure rate, durations, approval backlog.
+     * Get Admin Workflow Summary Handler
+     */
+    async getAdminWorkflowSummaryRaw(requestParameters: GetAdminWorkflowSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunSummaryResponse>> {
+        const requestOptions = await this.getAdminWorkflowSummaryRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunSummaryResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Tenant-wide run health: counts, failure rate, durations, approval backlog.
+     * Get Admin Workflow Summary Handler
+     */
+    async getAdminWorkflowSummary(requestParameters: GetAdminWorkflowSummaryRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunSummaryResponse> {
+        const response = await this.getAdminWorkflowSummaryRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getAdminWorkflowTimeseries without sending the request
+     */
+    async getAdminWorkflowTimeseriesRequestOpts(requestParameters: GetAdminWorkflowTimeseriesRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        if (requestParameters['bucket'] != null) {
+            queryParameters['bucket'] = requestParameters['bucket'];
+        }
+
+        if (requestParameters['timezone'] != null) {
+            queryParameters['timezone'] = requestParameters['timezone'];
+        }
+
+        if (requestParameters['definitionId'] != null) {
+            queryParameters['definition_id'] = requestParameters['definitionId'];
+        }
+
+        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}`;
+            }
+        }
+
+        let urlPath = `/v1/admin/workflows/timeseries`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Run counts bucketed over time, in the resolved timezone.
+     * Get Admin Workflow Timeseries Handler
+     */
+    async getAdminWorkflowTimeseriesRaw(requestParameters: GetAdminWorkflowTimeseriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunTimeseriesResponse>> {
+        const requestOptions = await this.getAdminWorkflowTimeseriesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RunTimeseriesResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Run counts bucketed over time, in the resolved timezone.
+     * Get Admin Workflow Timeseries Handler
+     */
+    async getAdminWorkflowTimeseries(requestParameters: GetAdminWorkflowTimeseriesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunTimeseriesResponse> {
+        const response = await this.getAdminWorkflowTimeseriesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/index.ts

@@ -1,5 +1,7 @@
 /* tslint:disable */
 /* eslint-disable */
+export * from './AdminKbApi';
+export * from './AdminWorkflowsApi';
 export * from './AgentApi';
 export * from './ApiConnectionsApi';
 export * from './ApiKeysApi';

package/src/models/CitedChunk.ts

@@ -27,10 +27,12 @@ import {
  * ``chunk_id`` is the load-bearing field — every reader can use it via
  * ``/v1/chunks/bulk``. The document fields are populated by
  * ``ks_upload_from_sandbox`` when it resolves each chunk through the KS API at
- * save time; they stay ``None`` only when the chunk could not be resolved
- * (e.g. the agent cited an id that no longer exists, or the resolve call
- * failed). The doc-info snapshot is captured at save time; later renames
- * or replacements of the source document do not update it.
+ * save time; they stay ``None`` only when a *transient* resolve failure
+ * (network, 5xx) left the chunk unenriched. A chunk that no longer exists
+ * (a definitive 404) is dropped at save time rather than persisted with a
+ * bare id, so a dead citation never reaches the FE. The doc-info snapshot is
+ * captured at save time; later renames or replacements of the source document
+ * do not update it.
  * @export
  * @interface CitedChunk
  */

package/src/models/DefinitionOutputStat.ts

@@ -0,0 +1,110 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call. 
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * Average output-document count for one workflow definition.
+ * @export
+ * @interface DefinitionOutputStat
+ */
+export interface DefinitionOutputStat {
+    /**
+     * 
+     * @type {string}
+     * @memberof DefinitionOutputStat
+     */
+    definitionId: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof DefinitionOutputStat
+     */
+    name: string;
+    /**
+     * COMPLETED runs in the window.
+     * @type {number}
+     * @memberof DefinitionOutputStat
+     */
+    completedRuns: number;
+    /**
+     * Mean output DOCUMENTs generated per completed run.
+     * @type {number}
+     * @memberof DefinitionOutputStat
+     */
+    avgDocuments: number;
+}
+export const DefinitionOutputStatPropertyValidationAttributesMap: {
+    [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 DefinitionOutputStat interface.
+ */
+export function instanceOfDefinitionOutputStat(value: object): value is DefinitionOutputStat {
+    if (!('definitionId' in value) || value['definitionId'] === undefined) return false;
+    if (!('name' in value) || value['name'] === undefined) return false;
+    if (!('completedRuns' in value) || value['completedRuns'] === undefined) return false;
+    if (!('avgDocuments' in value) || value['avgDocuments'] === undefined) return false;
+    return true;
+}
+
+export function DefinitionOutputStatFromJSON(json: any): DefinitionOutputStat {
+    return DefinitionOutputStatFromJSONTyped(json, false);
+}
+
+export function DefinitionOutputStatFromJSONTyped(json: any, ignoreDiscriminator: boolean): DefinitionOutputStat {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'definitionId': json['definition_id'],
+        'name': json['name'],
+        'completedRuns': json['completed_runs'],
+        'avgDocuments': json['avg_documents'],
+    };
+}
+
+export function DefinitionOutputStatToJSON(json: any): DefinitionOutputStat {
+    return DefinitionOutputStatToJSONTyped(json, false);
+}
+
+export function DefinitionOutputStatToJSONTyped(value?: DefinitionOutputStat | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'definition_id': value['definitionId'],
+        'name': value['name'],
+        'completed_runs': value['completedRuns'],
+        'avg_documents': value['avgDocuments'],
+    };
+}
+