@knowledge-stack/ksapi 1.135.1 → 1.136.0

package/dist/esm/models/PaginatedResponseSkillResponse.js

@@ -0,0 +1,70 @@
+/* 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 { SkillResponseFromJSON, SkillResponseToJSON, } from './SkillResponse';
+export const PaginatedResponseSkillResponsePropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
+/**
+ * Check if a given object implements the PaginatedResponseSkillResponse interface.
+ */
+export function instanceOfPaginatedResponseSkillResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+export function PaginatedResponseSkillResponseFromJSON(json) {
+    return PaginatedResponseSkillResponseFromJSONTyped(json, false);
+}
+export function PaginatedResponseSkillResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(SkillResponseFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+    };
+}
+export function PaginatedResponseSkillResponseToJSON(json) {
+    return PaginatedResponseSkillResponseToJSONTyped(json, false);
+}
+export function PaginatedResponseSkillResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(SkillResponseToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+    };
+}

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

@@ -27,6 +27,7 @@ export declare const PartType: {
     readonly DataSourceSchema: "DATA_SOURCE_SCHEMA";
     readonly DataSourceTable: "DATA_SOURCE_TABLE";
     readonly ApiConnection: "API_CONNECTION";
+    readonly Skill: "SKILL";
 };
 export type PartType = typeof PartType[keyof typeof PartType];
 export declare function instanceOfPartType(value: any): boolean;

package/dist/esm/models/PartType.js

@@ -28,7 +28,8 @@ export const PartType = {
     DataSource: 'DATA_SOURCE',
     DataSourceSchema: 'DATA_SOURCE_SCHEMA',
     DataSourceTable: 'DATA_SOURCE_TABLE',
-    ApiConnection: 'API_CONNECTION'
+    ApiConnection: 'API_CONNECTION',
+    Skill: 'SKILL'
 };
 export function instanceOfPartType(value) {
     for (const key in PartType) {

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

@@ -27,6 +27,7 @@ export declare const ReferenceType: {
     readonly DataSourceSchema: "DATA_SOURCE_SCHEMA";
     readonly DataSourceTable: "DATA_SOURCE_TABLE";
     readonly ApiConnection: "API_CONNECTION";
+    readonly Skill: "SKILL";
     readonly Image: "image";
     readonly Memory: "memory";
     readonly Tag: "tag";

package/dist/esm/models/ReferenceType.js

@@ -29,6 +29,7 @@ export const ReferenceType = {
     DataSourceSchema: 'DATA_SOURCE_SCHEMA',
     DataSourceTable: 'DATA_SOURCE_TABLE',
     ApiConnection: 'API_CONNECTION',
+    Skill: 'SKILL',
     Image: 'image',
     Memory: 'memory',
     Tag: 'tag',

package/dist/esm/models/SearchSkillsRequest.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.
+ */
+/**
+ * Semantic skill discovery for the agent.
+ * @export
+ * @interface SearchSkillsRequest
+ */
+export interface SearchSkillsRequest {
+    /**
+     * What the agent needs a skill for.
+     * @type {string}
+     * @memberof SearchSkillsRequest
+     */
+    query: string;
+    /**
+     *
+     * @type {number}
+     * @memberof SearchSkillsRequest
+     */
+    topK?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof SearchSkillsRequest
+     */
+    scoreThreshold?: number;
+}
+export declare const SearchSkillsRequestPropertyValidationAttributesMap: {
+    [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 SearchSkillsRequest interface.
+ */
+export declare function instanceOfSearchSkillsRequest(value: object): value is SearchSkillsRequest;
+export declare function SearchSkillsRequestFromJSON(json: any): SearchSkillsRequest;
+export declare function SearchSkillsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchSkillsRequest;
+export declare function SearchSkillsRequestToJSON(json: any): SearchSkillsRequest;
+export declare function SearchSkillsRequestToJSONTyped(value?: SearchSkillsRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/SearchSkillsRequest.js

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

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

@@ -0,0 +1,48 @@
+/**
+ * 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 { SkillSearchResult } from './SkillSearchResult';
+/**
+ *
+ * @export
+ * @interface SearchSkillsResponse
+ */
+export interface SearchSkillsResponse {
+    /**
+     *
+     * @type {Array<SkillSearchResult>}
+     * @memberof SearchSkillsResponse
+     */
+    results?: Array<SkillSearchResult>;
+}
+export declare const SearchSkillsResponsePropertyValidationAttributesMap: {
+    [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 SearchSkillsResponse interface.
+ */
+export declare function instanceOfSearchSkillsResponse(value: object): value is SearchSkillsResponse;
+export declare function SearchSkillsResponseFromJSON(json: any): SearchSkillsResponse;
+export declare function SearchSkillsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchSkillsResponse;
+export declare function SearchSkillsResponseToJSON(json: any): SearchSkillsResponse;
+export declare function SearchSkillsResponseToJSONTyped(value?: SearchSkillsResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/SearchSkillsResponse.js

@@ -0,0 +1,43 @@
+/* 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 { SkillSearchResultFromJSON, SkillSearchResultToJSON, } from './SkillSearchResult';
+export const SearchSkillsResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the SearchSkillsResponse interface.
+ */
+export function instanceOfSearchSkillsResponse(value) {
+    return true;
+}
+export function SearchSkillsResponseFromJSON(json) {
+    return SearchSkillsResponseFromJSONTyped(json, false);
+}
+export function SearchSkillsResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'results': json['results'] == null ? undefined : (json['results'].map(SkillSearchResultFromJSON)),
+    };
+}
+export function SearchSkillsResponseToJSON(json) {
+    return SearchSkillsResponseToJSONTyped(json, false);
+}
+export function SearchSkillsResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'results': value['results'] == null ? undefined : (value['results'].map(SkillSearchResultToJSON)),
+    };
+}

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

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+/**
+ * Sort fields for the skill list (sidebar/browse).
+ * @export
+ */
+export declare const SkillOrder: {
+    readonly Name: "NAME";
+    readonly CreatedAt: "CREATED_AT";
+    readonly UpdatedAt: "UPDATED_AT";
+};
+export type SkillOrder = typeof SkillOrder[keyof typeof SkillOrder];
+export declare function instanceOfSkillOrder(value: any): boolean;
+export declare function SkillOrderFromJSON(json: any): SkillOrder;
+export declare function SkillOrderFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillOrder;
+export declare function SkillOrderToJSON(value?: SkillOrder | null): any;
+export declare function SkillOrderToJSONTyped(value: any, ignoreDiscriminator: boolean): SkillOrder;

package/dist/esm/models/SkillOrder.js

@@ -0,0 +1,44 @@
+/* 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.
+ */
+/**
+ * Sort fields for the skill list (sidebar/browse).
+ * @export
+ */
+export const SkillOrder = {
+    Name: 'NAME',
+    CreatedAt: 'CREATED_AT',
+    UpdatedAt: 'UPDATED_AT'
+};
+export function instanceOfSkillOrder(value) {
+    for (const key in SkillOrder) {
+        if (Object.prototype.hasOwnProperty.call(SkillOrder, key)) {
+            if (SkillOrder[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function SkillOrderFromJSON(json) {
+    return SkillOrderFromJSONTyped(json, false);
+}
+export function SkillOrderFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function SkillOrderToJSON(value) {
+    return value;
+}
+export function SkillOrderToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -0,0 +1,147 @@
+/**
+ * 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 { ItemPermissions } from './ItemPermissions';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+import type { UserInfo } from './UserInfo';
+/**
+ * Skill response; ``part_type`` is the folder-listing discriminator.
+ * @export
+ * @interface SkillResponse
+ */
+export interface SkillResponse {
+    /**
+     * Path part type
+     * @type {SkillResponsePartTypeEnum}
+     * @memberof SkillResponse
+     */
+    partType?: SkillResponsePartTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    id: string;
+    /**
+     * SKILL path_part of this skill
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    pathPartId: string;
+    /**
+     * FOLDER path_part of the containing folder
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    parentPathPartId: string | null;
+    /**
+     * Full materialized path from root
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    materializedPath: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    tenantId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    name: string;
+    /**
+     * One-line 'use when…' routing signal, from the SKILL.md frontmatter.
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    description: string;
+    /**
+     * Full SKILL.md content; populated on detail reads, null on list.
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    skillMd?: string | null;
+    /**
+     * Bundled script file names; populated on detail reads.
+     * @type {Array<string>}
+     * @memberof SkillResponse
+     */
+    scriptNames?: Array<string>;
+    /**
+     * 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}
+     * @memberof SkillResponse
+     */
+    hasUnpublishedChanges?: boolean;
+    /**
+     *
+     * @type {PathPartApprovalState}
+     * @memberof SkillResponse
+     */
+    approvalState: PathPartApprovalState;
+    /**
+     * Creator, or null.
+     * @type {UserInfo}
+     * @memberof SkillResponse
+     */
+    owner?: UserInfo | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof SkillResponse
+     */
+    createdAt: Date;
+    /**
+     *
+     * @type {Date}
+     * @memberof SkillResponse
+     */
+    updatedAt: Date;
+    /**
+     * Caller's effective rights; null on mutation responses.
+     * @type {ItemPermissions}
+     * @memberof SkillResponse
+     */
+    permissions?: ItemPermissions | null;
+}
+/**
+ * @export
+ */
+export declare const SkillResponsePartTypeEnum: {
+    readonly Skill: "SKILL";
+};
+export type SkillResponsePartTypeEnum = typeof SkillResponsePartTypeEnum[keyof typeof SkillResponsePartTypeEnum];
+export declare const SkillResponsePropertyValidationAttributesMap: {
+    [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 SkillResponse interface.
+ */
+export declare function instanceOfSkillResponse(value: object): value is SkillResponse;
+export declare function SkillResponseFromJSON(json: any): SkillResponse;
+export declare function SkillResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillResponse;
+export declare function SkillResponseToJSON(json: any): SkillResponse;
+export declare function SkillResponseToJSONTyped(value?: SkillResponse | null, ignoreDiscriminator?: boolean): any;