@knowledge-stack/ksapi 1.135.1 → 1.136.0

package/dist/models/SkillOrder.js

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

package/dist/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;

package/dist/models/SkillResponse.js

@@ -0,0 +1,109 @@
+"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.SkillResponsePropertyValidationAttributesMap = exports.SkillResponsePartTypeEnum = void 0;
+exports.instanceOfSkillResponse = instanceOfSkillResponse;
+exports.SkillResponseFromJSON = SkillResponseFromJSON;
+exports.SkillResponseFromJSONTyped = SkillResponseFromJSONTyped;
+exports.SkillResponseToJSON = SkillResponseToJSON;
+exports.SkillResponseToJSONTyped = SkillResponseToJSONTyped;
+const ItemPermissions_1 = require("./ItemPermissions");
+const PathPartApprovalState_1 = require("./PathPartApprovalState");
+const UserInfo_1 = require("./UserInfo");
+/**
+ * @export
+ */
+exports.SkillResponsePartTypeEnum = {
+    Skill: 'SKILL'
+};
+exports.SkillResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the SkillResponse interface.
+ */
+function instanceOfSkillResponse(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined)
+        return false;
+    if (!('parentPathPartId' in value) || value['parentPathPartId'] === undefined)
+        return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined)
+        return false;
+    if (!('tenantId' in value) || value['tenantId'] === undefined)
+        return false;
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if (!('description' in value) || value['description'] === undefined)
+        return false;
+    if (!('approvalState' in value) || value['approvalState'] === undefined)
+        return false;
+    if (!('createdAt' in value) || value['createdAt'] === undefined)
+        return false;
+    if (!('updatedAt' in value) || value['updatedAt'] === undefined)
+        return false;
+    return true;
+}
+function SkillResponseFromJSON(json) {
+    return SkillResponseFromJSONTyped(json, false);
+}
+function SkillResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
+        'id': json['id'],
+        'pathPartId': json['path_part_id'],
+        'parentPathPartId': json['parent_path_part_id'],
+        'materializedPath': json['materialized_path'],
+        'tenantId': json['tenant_id'],
+        'name': json['name'],
+        'description': json['description'],
+        'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
+        'scriptNames': json['script_names'] == null ? undefined : json['script_names'],
+        'hasUnpublishedChanges': json['has_unpublished_changes'] == null ? undefined : json['has_unpublished_changes'],
+        'approvalState': (0, PathPartApprovalState_1.PathPartApprovalStateFromJSON)(json['approval_state']),
+        'owner': json['owner'] == null ? undefined : (0, UserInfo_1.UserInfoFromJSON)(json['owner']),
+        'createdAt': (new Date(json['created_at'])),
+        'updatedAt': (new Date(json['updated_at'])),
+        'permissions': json['permissions'] == null ? undefined : (0, ItemPermissions_1.ItemPermissionsFromJSON)(json['permissions']),
+    };
+}
+function SkillResponseToJSON(json) {
+    return SkillResponseToJSONTyped(json, false);
+}
+function SkillResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'part_type': value['partType'],
+        'id': value['id'],
+        'path_part_id': value['pathPartId'],
+        'parent_path_part_id': value['parentPathPartId'],
+        'materialized_path': value['materializedPath'],
+        'tenant_id': value['tenantId'],
+        'name': value['name'],
+        'description': value['description'],
+        'skill_md': value['skillMd'],
+        'script_names': value['scriptNames'],
+        'has_unpublished_changes': value['hasUnpublishedChanges'],
+        'approval_state': (0, PathPartApprovalState_1.PathPartApprovalStateToJSON)(value['approvalState']),
+        'owner': (0, UserInfo_1.UserInfoToJSON)(value['owner']),
+        'created_at': value['createdAt'].toISOString(),
+        'updated_at': value['updatedAt'].toISOString(),
+        'permissions': (0, ItemPermissions_1.ItemPermissionsToJSON)(value['permissions']),
+    };
+}

package/dist/models/SkillScriptFile.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.
+ */
+/**
+ * A single script bundled under a skill's ``scripts/`` folder.
+ * @export
+ * @interface SkillScriptFile
+ */
+export interface SkillScriptFile {
+    /**
+     * Script file name, e.g. inspect.py
+     * @type {string}
+     * @memberof SkillScriptFile
+     */
+    name: string;
+    /**
+     * Script file contents (UTF-8 text).
+     * @type {string}
+     * @memberof SkillScriptFile
+     */
+    content: string;
+}
+export declare const SkillScriptFilePropertyValidationAttributesMap: {
+    [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 SkillScriptFile interface.
+ */
+export declare function instanceOfSkillScriptFile(value: object): value is SkillScriptFile;
+export declare function SkillScriptFileFromJSON(json: any): SkillScriptFile;
+export declare function SkillScriptFileFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillScriptFile;
+export declare function SkillScriptFileToJSON(json: any): SkillScriptFile;
+export declare function SkillScriptFileToJSONTyped(value?: SkillScriptFile | null, ignoreDiscriminator?: boolean): any;

package/dist/models/SkillScriptFile.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.SkillScriptFilePropertyValidationAttributesMap = void 0;
+exports.instanceOfSkillScriptFile = instanceOfSkillScriptFile;
+exports.SkillScriptFileFromJSON = SkillScriptFileFromJSON;
+exports.SkillScriptFileFromJSONTyped = SkillScriptFileFromJSONTyped;
+exports.SkillScriptFileToJSON = SkillScriptFileToJSON;
+exports.SkillScriptFileToJSONTyped = SkillScriptFileToJSONTyped;
+exports.SkillScriptFilePropertyValidationAttributesMap = {
+    name: {
+        maxLength: 255,
+    },
+};
+/**
+ * Check if a given object implements the SkillScriptFile interface.
+ */
+function instanceOfSkillScriptFile(value) {
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if (!('content' in value) || value['content'] === undefined)
+        return false;
+    return true;
+}
+function SkillScriptFileFromJSON(json) {
+    return SkillScriptFileFromJSONTyped(json, false);
+}
+function SkillScriptFileFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'name': json['name'],
+        'content': json['content'],
+    };
+}
+function SkillScriptFileToJSON(json) {
+    return SkillScriptFileToJSONTyped(json, false);
+}
+function SkillScriptFileToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'name': value['name'],
+        'content': value['content'],
+    };
+}

package/dist/models/SkillSearchResult.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.
+ */
+/**
+ * One skill matched by semantic search.
+ * @export
+ * @interface SkillSearchResult
+ */
+export interface SkillSearchResult {
+    /**
+     *
+     * @type {string}
+     * @memberof SkillSearchResult
+     */
+    skillId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillSearchResult
+     */
+    name: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillSearchResult
+     */
+    description: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SkillSearchResult
+     */
+    materializedPath: string;
+    /**
+     *
+     * @type {number}
+     * @memberof SkillSearchResult
+     */
+    score: number;
+}
+export declare const SkillSearchResultPropertyValidationAttributesMap: {
+    [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 SkillSearchResult interface.
+ */
+export declare function instanceOfSkillSearchResult(value: object): value is SkillSearchResult;
+export declare function SkillSearchResultFromJSON(json: any): SkillSearchResult;
+export declare function SkillSearchResultFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillSearchResult;
+export declare function SkillSearchResultToJSON(json: any): SkillSearchResult;
+export declare function SkillSearchResultToJSONTyped(value?: SkillSearchResult | null, ignoreDiscriminator?: boolean): any;

package/dist/models/SkillSearchResult.js

@@ -0,0 +1,68 @@
+"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.SkillSearchResultPropertyValidationAttributesMap = void 0;
+exports.instanceOfSkillSearchResult = instanceOfSkillSearchResult;
+exports.SkillSearchResultFromJSON = SkillSearchResultFromJSON;
+exports.SkillSearchResultFromJSONTyped = SkillSearchResultFromJSONTyped;
+exports.SkillSearchResultToJSON = SkillSearchResultToJSON;
+exports.SkillSearchResultToJSONTyped = SkillSearchResultToJSONTyped;
+exports.SkillSearchResultPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the SkillSearchResult interface.
+ */
+function instanceOfSkillSearchResult(value) {
+    if (!('skillId' in value) || value['skillId'] === undefined)
+        return false;
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if (!('description' in value) || value['description'] === undefined)
+        return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined)
+        return false;
+    if (!('score' in value) || value['score'] === undefined)
+        return false;
+    return true;
+}
+function SkillSearchResultFromJSON(json) {
+    return SkillSearchResultFromJSONTyped(json, false);
+}
+function SkillSearchResultFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'skillId': json['skill_id'],
+        'name': json['name'],
+        'description': json['description'],
+        'materializedPath': json['materialized_path'],
+        'score': json['score'],
+    };
+}
+function SkillSearchResultToJSON(json) {
+    return SkillSearchResultToJSONTyped(json, false);
+}
+function SkillSearchResultToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'skill_id': value['skillId'],
+        'name': value['name'],
+        'description': value['description'],
+        'materialized_path': value['materializedPath'],
+        'score': value['score'],
+    };
+}

package/dist/models/SkillVersionResponse.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.
+ */
+/**
+ * One published version of a skill.
+ * @export
+ * @interface SkillVersionResponse
+ */
+export interface SkillVersionResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof SkillVersionResponse
+     */
+    versionId: string;
+    /**
+     * Monotonic version number (0, 1, 2, …)
+     * @type {number}
+     * @memberof SkillVersionResponse
+     */
+    version: number;
+    /**
+     * Content hash of the version bundle.
+     * @type {string}
+     * @memberof SkillVersionResponse
+     */
+    contentSha256?: string | null;
+    /**
+     *
+     * @type {boolean}
+     * @memberof SkillVersionResponse
+     */
+    isActive: boolean;
+    /**
+     *
+     * @type {Date}
+     * @memberof SkillVersionResponse
+     */
+    createdAt: Date;
+}
+export declare const SkillVersionResponsePropertyValidationAttributesMap: {
+    [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 SkillVersionResponse interface.
+ */
+export declare function instanceOfSkillVersionResponse(value: object): value is SkillVersionResponse;
+export declare function SkillVersionResponseFromJSON(json: any): SkillVersionResponse;
+export declare function SkillVersionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillVersionResponse;
+export declare function SkillVersionResponseToJSON(json: any): SkillVersionResponse;
+export declare function SkillVersionResponseToJSONTyped(value?: SkillVersionResponse | null, ignoreDiscriminator?: boolean): any;