@knowledge-stack/ksapi 1.139.1 → 1.140.0

package/dist/models/KbTimeseriesResponse.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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 type { KbMetric } from './KbMetric';
+import type { TimeBucket } from './TimeBucket';
+import type { LabeledSeries } from './LabeledSeries';
+/**
+ * A knowledge-base metric bucketed over time.
+ *
+ * ``series`` carries one entry per split — two (SOURCE / GENERATED) for
+ * ``document_uploads``, one for the ingestion metrics.
+ * @export
+ * @interface KbTimeseriesResponse
+ */
+export interface KbTimeseriesResponse {
+    /**
+     *
+     * @type {KbMetric}
+     * @memberof KbTimeseriesResponse
+     */
+    metric: KbMetric;
+    /**
+     *
+     * @type {string}
+     * @memberof KbTimeseriesResponse
+     */
+    timezone: string;
+    /**
+     *
+     * @type {TimeBucket}
+     * @memberof KbTimeseriesResponse
+     */
+    bucket: TimeBucket;
+    /**
+     *
+     * @type {Array<LabeledSeries>}
+     * @memberof KbTimeseriesResponse
+     */
+    series?: Array<LabeledSeries>;
+}
+export declare const KbTimeseriesResponsePropertyValidationAttributesMap: {
+    [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 KbTimeseriesResponse interface.
+ */
+export declare function instanceOfKbTimeseriesResponse(value: object): value is KbTimeseriesResponse;
+export declare function KbTimeseriesResponseFromJSON(json: any): KbTimeseriesResponse;
+export declare function KbTimeseriesResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): KbTimeseriesResponse;
+export declare function KbTimeseriesResponseToJSON(json: any): KbTimeseriesResponse;
+export declare function KbTimeseriesResponseToJSONTyped(value?: KbTimeseriesResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/KbTimeseriesResponse.js

@@ -0,0 +1,65 @@
+"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.KbTimeseriesResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfKbTimeseriesResponse = instanceOfKbTimeseriesResponse;
+exports.KbTimeseriesResponseFromJSON = KbTimeseriesResponseFromJSON;
+exports.KbTimeseriesResponseFromJSONTyped = KbTimeseriesResponseFromJSONTyped;
+exports.KbTimeseriesResponseToJSON = KbTimeseriesResponseToJSON;
+exports.KbTimeseriesResponseToJSONTyped = KbTimeseriesResponseToJSONTyped;
+const KbMetric_1 = require("./KbMetric");
+const TimeBucket_1 = require("./TimeBucket");
+const LabeledSeries_1 = require("./LabeledSeries");
+exports.KbTimeseriesResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the KbTimeseriesResponse interface.
+ */
+function instanceOfKbTimeseriesResponse(value) {
+    if (!('metric' in value) || value['metric'] === undefined)
+        return false;
+    if (!('timezone' in value) || value['timezone'] === undefined)
+        return false;
+    if (!('bucket' in value) || value['bucket'] === undefined)
+        return false;
+    return true;
+}
+function KbTimeseriesResponseFromJSON(json) {
+    return KbTimeseriesResponseFromJSONTyped(json, false);
+}
+function KbTimeseriesResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'metric': (0, KbMetric_1.KbMetricFromJSON)(json['metric']),
+        'timezone': json['timezone'],
+        'bucket': (0, TimeBucket_1.TimeBucketFromJSON)(json['bucket']),
+        'series': json['series'] == null ? undefined : (json['series'].map(LabeledSeries_1.LabeledSeriesFromJSON)),
+    };
+}
+function KbTimeseriesResponseToJSON(json) {
+    return KbTimeseriesResponseToJSONTyped(json, false);
+}
+function KbTimeseriesResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'metric': (0, KbMetric_1.KbMetricToJSON)(value['metric']),
+        'timezone': value['timezone'],
+        'bucket': (0, TimeBucket_1.TimeBucketToJSON)(value['bucket']),
+        'series': value['series'] == null ? undefined : (value['series'].map(LabeledSeries_1.LabeledSeriesToJSON)),
+    };
+}

package/dist/models/LabeledSeries.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 type { TimeseriesPoint } from './TimeseriesPoint';
+/**
+ * A named series (e.g. one per document origin or ingestion outcome).
+ * @export
+ * @interface LabeledSeries
+ */
+export interface LabeledSeries {
+    /**
+     * Series label, e.g. 'SOURCE' or 'FAILED'.
+     * @type {string}
+     * @memberof LabeledSeries
+     */
+    label: string;
+    /**
+     *
+     * @type {Array<TimeseriesPoint>}
+     * @memberof LabeledSeries
+     */
+    points?: Array<TimeseriesPoint>;
+}
+export declare const LabeledSeriesPropertyValidationAttributesMap: {
+    [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 LabeledSeries interface.
+ */
+export declare function instanceOfLabeledSeries(value: object): value is LabeledSeries;
+export declare function LabeledSeriesFromJSON(json: any): LabeledSeries;
+export declare function LabeledSeriesFromJSONTyped(json: any, ignoreDiscriminator: boolean): LabeledSeries;
+export declare function LabeledSeriesToJSON(json: any): LabeledSeries;
+export declare function LabeledSeriesToJSONTyped(value?: LabeledSeries | null, ignoreDiscriminator?: boolean): any;

package/dist/models/LabeledSeries.js

@@ -0,0 +1,55 @@
+"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.LabeledSeriesPropertyValidationAttributesMap = void 0;
+exports.instanceOfLabeledSeries = instanceOfLabeledSeries;
+exports.LabeledSeriesFromJSON = LabeledSeriesFromJSON;
+exports.LabeledSeriesFromJSONTyped = LabeledSeriesFromJSONTyped;
+exports.LabeledSeriesToJSON = LabeledSeriesToJSON;
+exports.LabeledSeriesToJSONTyped = LabeledSeriesToJSONTyped;
+const TimeseriesPoint_1 = require("./TimeseriesPoint");
+exports.LabeledSeriesPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the LabeledSeries interface.
+ */
+function instanceOfLabeledSeries(value) {
+    if (!('label' in value) || value['label'] === undefined)
+        return false;
+    return true;
+}
+function LabeledSeriesFromJSON(json) {
+    return LabeledSeriesFromJSONTyped(json, false);
+}
+function LabeledSeriesFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'label': json['label'],
+        'points': json['points'] == null ? undefined : (json['points'].map(TimeseriesPoint_1.TimeseriesPointFromJSON)),
+    };
+}
+function LabeledSeriesToJSON(json) {
+    return LabeledSeriesToJSONTyped(json, false);
+}
+function LabeledSeriesToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'label': value['label'],
+        'points': value['points'] == null ? undefined : (value['points'].map(TimeseriesPoint_1.TimeseriesPointToJSON)),
+    };
+}

package/dist/models/LeaderboardEntry.d.ts

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

package/dist/models/LeaderboardEntry.js

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

package/dist/models/RunTimeseriesResponse.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 type { TimeseriesPoint } from './TimeseriesPoint';
+import type { TimeBucket } from './TimeBucket';
+/**
+ * Workflow runs bucketed over time.
+ * @export
+ * @interface RunTimeseriesResponse
+ */
+export interface RunTimeseriesResponse {
+    /**
+     * IANA timezone the buckets are in.
+     * @type {string}
+     * @memberof RunTimeseriesResponse
+     */
+    timezone: string;
+    /**
+     *
+     * @type {TimeBucket}
+     * @memberof RunTimeseriesResponse
+     */
+    bucket: TimeBucket;
+    /**
+     *
+     * @type {Array<TimeseriesPoint>}
+     * @memberof RunTimeseriesResponse
+     */
+    points?: Array<TimeseriesPoint>;
+}
+export declare const RunTimeseriesResponsePropertyValidationAttributesMap: {
+    [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 RunTimeseriesResponse interface.
+ */
+export declare function instanceOfRunTimeseriesResponse(value: object): value is RunTimeseriesResponse;
+export declare function RunTimeseriesResponseFromJSON(json: any): RunTimeseriesResponse;
+export declare function RunTimeseriesResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): RunTimeseriesResponse;
+export declare function RunTimeseriesResponseToJSON(json: any): RunTimeseriesResponse;
+export declare function RunTimeseriesResponseToJSONTyped(value?: RunTimeseriesResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/RunTimeseriesResponse.js

@@ -0,0 +1,60 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunTimeseriesResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfRunTimeseriesResponse = instanceOfRunTimeseriesResponse;
+exports.RunTimeseriesResponseFromJSON = RunTimeseriesResponseFromJSON;
+exports.RunTimeseriesResponseFromJSONTyped = RunTimeseriesResponseFromJSONTyped;
+exports.RunTimeseriesResponseToJSON = RunTimeseriesResponseToJSON;
+exports.RunTimeseriesResponseToJSONTyped = RunTimeseriesResponseToJSONTyped;
+const TimeseriesPoint_1 = require("./TimeseriesPoint");
+const TimeBucket_1 = require("./TimeBucket");
+exports.RunTimeseriesResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the RunTimeseriesResponse interface.
+ */
+function instanceOfRunTimeseriesResponse(value) {
+    if (!('timezone' in value) || value['timezone'] === undefined)
+        return false;
+    if (!('bucket' in value) || value['bucket'] === undefined)
+        return false;
+    return true;
+}
+function RunTimeseriesResponseFromJSON(json) {
+    return RunTimeseriesResponseFromJSONTyped(json, false);
+}
+function RunTimeseriesResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'timezone': json['timezone'],
+        'bucket': (0, TimeBucket_1.TimeBucketFromJSON)(json['bucket']),
+        'points': json['points'] == null ? undefined : (json['points'].map(TimeseriesPoint_1.TimeseriesPointFromJSON)),
+    };
+}
+function RunTimeseriesResponseToJSON(json) {
+    return RunTimeseriesResponseToJSONTyped(json, false);
+}
+function RunTimeseriesResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'timezone': value['timezone'],
+        'bucket': (0, TimeBucket_1.TimeBucketToJSON)(value['bucket']),
+        'points': value['points'] == null ? undefined : (value['points'].map(TimeseriesPoint_1.TimeseriesPointToJSON)),
+    };
+}

package/dist/models/TimeBucket.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+/**
+ * Granularity for a bucketed time series.
+ * @export
+ */
+export declare const TimeBucket: {
+    readonly Hour: 'hour';
+    readonly Day: 'day';
+    readonly Week: 'week';
+    readonly Month: 'month';
+};
+export type TimeBucket = typeof TimeBucket[keyof typeof TimeBucket];
+export declare function instanceOfTimeBucket(value: any): boolean;
+export declare function TimeBucketFromJSON(json: any): TimeBucket;
+export declare function TimeBucketFromJSONTyped(json: any, ignoreDiscriminator: boolean): TimeBucket;
+export declare function TimeBucketToJSON(value?: TimeBucket | null): any;
+export declare function TimeBucketToJSONTyped(value: any, ignoreDiscriminator: boolean): TimeBucket;

package/dist/models/TimeBucket.js

@@ -0,0 +1,53 @@
+"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.TimeBucket = void 0;
+exports.instanceOfTimeBucket = instanceOfTimeBucket;
+exports.TimeBucketFromJSON = TimeBucketFromJSON;
+exports.TimeBucketFromJSONTyped = TimeBucketFromJSONTyped;
+exports.TimeBucketToJSON = TimeBucketToJSON;
+exports.TimeBucketToJSONTyped = TimeBucketToJSONTyped;
+/**
+ * Granularity for a bucketed time series.
+ * @export
+ */
+exports.TimeBucket = {
+    Hour: 'hour',
+    Day: 'day',
+    Week: 'week',
+    Month: 'month'
+};
+function instanceOfTimeBucket(value) {
+    for (const key in exports.TimeBucket) {
+        if (Object.prototype.hasOwnProperty.call(exports.TimeBucket, key)) {
+            if (exports.TimeBucket[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function TimeBucketFromJSON(json) {
+    return TimeBucketFromJSONTyped(json, false);
+}
+function TimeBucketFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+function TimeBucketToJSON(value) {
+    return value;
+}
+function TimeBucketToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

package/dist/models/TimeseriesPoint.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.
+ */
+/**
+ * One bucket of a time series.
+ * @export
+ * @interface TimeseriesPoint
+ */
+export interface TimeseriesPoint {
+    /**
+     * Start of the bucket, in the resolved timezone.
+     * @type {Date}
+     * @memberof TimeseriesPoint
+     */
+    bucketStart: Date;
+    /**
+     * Row count in this bucket.
+     * @type {number}
+     * @memberof TimeseriesPoint
+     */
+    count: number;
+}
+export declare const TimeseriesPointPropertyValidationAttributesMap: {
+    [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 TimeseriesPoint interface.
+ */
+export declare function instanceOfTimeseriesPoint(value: object): value is TimeseriesPoint;
+export declare function TimeseriesPointFromJSON(json: any): TimeseriesPoint;
+export declare function TimeseriesPointFromJSONTyped(json: any, ignoreDiscriminator: boolean): TimeseriesPoint;
+export declare function TimeseriesPointToJSON(json: any): TimeseriesPoint;
+export declare function TimeseriesPointToJSONTyped(value?: TimeseriesPoint | null, ignoreDiscriminator?: boolean): any;