@knowledge-stack/ksapi 1.139.0 → 1.140.0

package/src/models/LabeledSeries.ts

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

package/src/models/LeaderboardEntry.ts

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

package/src/models/RunTimeseriesResponse.ts

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

package/src/models/SkillResponse.ts

@@ -20,6 +20,13 @@ import {
     ItemPermissionsToJSON,
     ItemPermissionsToJSONTyped,
 } from './ItemPermissions';
+import type { SkillScriptFile } from './SkillScriptFile';
+import {
+    SkillScriptFileFromJSON,
+    SkillScriptFileFromJSONTyped,
+    SkillScriptFileToJSON,
+    SkillScriptFileToJSONTyped,
+} from './SkillScriptFile';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import {
     PathPartApprovalStateFromJSON,
@@ -101,6 +108,12 @@ export interface SkillResponse {
      * @memberof SkillResponse
      */
     scriptNames?: Array<string>;
+    /**
+     * Bundled scripts with their contents; populated only on the detail read (GET /skills/{id}), null on list. Lets the editor read the current script set so a PATCH can safely resubmit the whole set.
+     * @type {Array<SkillScriptFile>}
+     * @memberof SkillResponse
+     */
+    scripts?: Array<SkillScriptFile> | null;
     /**
      * Whether the working copy differs from the active published version. Always present (incl. list responses) so the UI can flag a skill with an unpublished draft.
      * @type {boolean}
@@ -203,6 +216,7 @@ export function SkillResponseFromJSONTyped(json: any, ignoreDiscriminator: boole
         'description': json['description'],
         'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
         'scriptNames': json['script_names'] == null ? undefined : json['script_names'],
+        'scripts': json['scripts'] == null ? undefined : ((json['scripts'] as Array<any>).map(SkillScriptFileFromJSON)),
         'hasUnpublishedChanges': json['has_unpublished_changes'] == null ? undefined : json['has_unpublished_changes'],
         'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
         'owner': json['owner'] == null ? undefined : UserInfoFromJSON(json['owner']),
@@ -233,6 +247,7 @@ export function SkillResponseToJSONTyped(value?: SkillResponse | null, ignoreDis
         'description': value['description'],
         'skill_md': value['skillMd'],
         'script_names': value['scriptNames'],
+        'scripts': value['scripts'] == null ? undefined : ((value['scripts'] as Array<any>).map(SkillScriptFileToJSON)),
         'has_unpublished_changes': value['hasUnpublishedChanges'],
         'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
         'owner': UserInfoToJSON(value['owner']),

package/src/models/TimeBucket.ts

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

package/src/models/TimeseriesPoint.ts

@@ -0,0 +1,92 @@
+/* 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';
+/**
+ * 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 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 function instanceOfTimeseriesPoint(value: object): value is TimeseriesPoint {
+    if (!('bucketStart' in value) || value['bucketStart'] === undefined) return false;
+    if (!('count' in value) || value['count'] === undefined) return false;
+    return true;
+}
+
+export function TimeseriesPointFromJSON(json: any): TimeseriesPoint {
+    return TimeseriesPointFromJSONTyped(json, false);
+}
+
+export function TimeseriesPointFromJSONTyped(json: any, ignoreDiscriminator: boolean): TimeseriesPoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'bucketStart': (new Date(json['bucket_start'])),
+        'count': json['count'],
+    };
+}
+
+export function TimeseriesPointToJSON(json: any): TimeseriesPoint {
+    return TimeseriesPointToJSONTyped(json, false);
+}
+
+export function TimeseriesPointToJSONTyped(value?: TimeseriesPoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'bucket_start': value['bucketStart'].toISOString(),
+        'count': value['count'],
+    };
+}
+

package/src/models/WorkflowLeaderboardResponse.ts

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