@knowledge-stack/ksapi 2.14.4 → 2.15.0

package/.openapi-generator/FILES

@@ -158,6 +158,7 @@ docs/EnrichedThreadMessageContent.md
 docs/ErrorResponse.md
 docs/EventResponse.md
 docs/ExcludedCommonFile.md
+docs/ExportSkillsRequest.md
 docs/ExtractRequest.md
 docs/ExtractResponse.md
 docs/FeaturesApi.md
@@ -622,6 +623,7 @@ src/models/EnrichedThreadMessageContent.ts
 src/models/ErrorResponse.ts
 src/models/EventResponse.ts
 src/models/ExcludedCommonFile.ts
+src/models/ExportSkillsRequest.ts
 src/models/ExtractRequest.ts
 src/models/ExtractResponse.ts
 src/models/FeaturesResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@2.14.4
+# @knowledge-stack/ksapi@2.15.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -203,6 +203,7 @@ All URIs are relative to *http://localhost:8000*
 *SkillsApi* | [**deleteSkill**](docs/SkillsApi.md#deleteskill) | **DELETE** /v1/skills/{skill_id} | Delete Skill Handler
 *SkillsApi* | [**discardSkillDraft**](docs/SkillsApi.md#discardskilldraft) | **POST** /v1/skills/{skill_id}/discard-draft | Discard Skill Draft Handler
 *SkillsApi* | [**exportSkill**](docs/SkillsApi.md#exportskill) | **GET** /v1/skills/{skill_id}/export | Export Skill Handler
+*SkillsApi* | [**exportSkills**](docs/SkillsApi.md#exportskillsoperation) | **POST** /v1/skills/export | Export Skills Handler
 *SkillsApi* | [**getSkill**](docs/SkillsApi.md#getskill) | **GET** /v1/skills/{skill_id} | Get Skill Handler
 *SkillsApi* | [**importSkill**](docs/SkillsApi.md#importskill) | **POST** /v1/skills/import | Import Skill Handler
 *SkillsApi* | [**listSkillVersions**](docs/SkillsApi.md#listskillversions) | **GET** /v1/skills/{skill_id}/versions | List Skill Versions Handler
@@ -443,6 +444,7 @@ All URIs are relative to *http://localhost:8000*
 - [ErrorResponse](docs/ErrorResponse.md)
 - [EventResponse](docs/EventResponse.md)
 - [ExcludedCommonFile](docs/ExcludedCommonFile.md)
+- [ExportSkillsRequest](docs/ExportSkillsRequest.md)
 - [ExtractRequest](docs/ExtractRequest.md)
 - [ExtractResponse](docs/ExtractResponse.md)
 - [FeaturesResponse](docs/FeaturesResponse.md)
@@ -725,7 +727,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `2.14.4`
+- Package version: `2.15.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/SkillsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ActivateSkillVersionRequest, CreateSkillRequest, PaginatedResponseSkillResponse, SearchSkillsRequest, SearchSkillsResponse, SkillOrder, SkillResponse, SkillVersionResponse, SortDirection, UpdateSkillRequest } from '../models/index';
+import type { ActivateSkillVersionRequest, CreateSkillRequest, ExportSkillsRequest, PaginatedResponseSkillResponse, SearchSkillsRequest, SearchSkillsResponse, SkillOrder, SkillResponse, SkillVersionResponse, SortDirection, UpdateSkillRequest } from '../models/index';
 export interface ActivateSkillVersionOperationRequest {
     skillId: string;
     versionId: string;
@@ -34,6 +34,9 @@ export interface DiscardSkillDraftRequest {
 export interface ExportSkillRequest {
     skillId: string;
 }
+export interface ExportSkillsOperationRequest {
+    exportSkillsRequest: ExportSkillsRequest;
+}
 export interface GetSkillRequest {
     skillId: string;
     includeFileContents?: boolean;
@@ -219,6 +222,27 @@ export interface SkillsApiInterface {
      * Export Skill Handler
      */
     exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
+    /**
+     * Creates request options for exportSkills without sending the request
+     * @param {ExportSkillsRequest} exportSkillsRequest
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * @summary Export Skills Handler
+     * @param {ExportSkillsRequest} exportSkillsRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
     /**
      * Creates request options for getSkill without sending the request
      * @param {string} skillId
@@ -481,6 +505,20 @@ export declare class SkillsApi extends runtime.BaseAPI implements SkillsApiInter
      * Export Skill Handler
      */
     exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
+    /**
+     * Creates request options for exportSkills without sending the request
+     */
+    exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
     /**
      * Creates request options for getSkill without sending the request
      */

package/dist/apis/SkillsApi.js

@@ -411,6 +411,55 @@ class SkillsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for exportSkills without sending the request
+     */
+    exportSkillsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['exportSkillsRequest'] == null) {
+                throw new runtime.RequiredError('exportSkillsRequest', 'Required parameter "exportSkillsRequest" was null or undefined when calling exportSkills().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/skills/export`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.ExportSkillsRequestToJSON)(requestParameters['exportSkillsRequest']),
+            };
+        });
+    }
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkillsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.exportSkillsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.BlobApiResponse(response);
+        });
+    }
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.exportSkillsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getSkill without sending the request
      */

package/dist/esm/apis/SkillsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ActivateSkillVersionRequest, CreateSkillRequest, PaginatedResponseSkillResponse, SearchSkillsRequest, SearchSkillsResponse, SkillOrder, SkillResponse, SkillVersionResponse, SortDirection, UpdateSkillRequest } from '../models/index';
+import type { ActivateSkillVersionRequest, CreateSkillRequest, ExportSkillsRequest, PaginatedResponseSkillResponse, SearchSkillsRequest, SearchSkillsResponse, SkillOrder, SkillResponse, SkillVersionResponse, SortDirection, UpdateSkillRequest } from '../models/index';
 export interface ActivateSkillVersionOperationRequest {
     skillId: string;
     versionId: string;
@@ -34,6 +34,9 @@ export interface DiscardSkillDraftRequest {
 export interface ExportSkillRequest {
     skillId: string;
 }
+export interface ExportSkillsOperationRequest {
+    exportSkillsRequest: ExportSkillsRequest;
+}
 export interface GetSkillRequest {
     skillId: string;
     includeFileContents?: boolean;
@@ -219,6 +222,27 @@ export interface SkillsApiInterface {
      * Export Skill Handler
      */
     exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
+    /**
+     * Creates request options for exportSkills without sending the request
+     * @param {ExportSkillsRequest} exportSkillsRequest
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * @summary Export Skills Handler
+     * @param {ExportSkillsRequest} exportSkillsRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
     /**
      * Creates request options for getSkill without sending the request
      * @param {string} skillId
@@ -481,6 +505,20 @@ export declare class SkillsApi extends runtime.BaseAPI implements SkillsApiInter
      * Export Skill Handler
      */
     exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
+    /**
+     * Creates request options for exportSkills without sending the request
+     */
+    exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
     /**
      * Creates request options for getSkill without sending the request
      */

package/dist/esm/apis/SkillsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { ActivateSkillVersionRequestToJSON, CreateSkillRequestToJSON, PaginatedResponseSkillResponseFromJSON, SearchSkillsRequestToJSON, SearchSkillsResponseFromJSON, SkillResponseFromJSON, SkillVersionResponseFromJSON, UpdateSkillRequestToJSON, } from '../models/index';
+import { ActivateSkillVersionRequestToJSON, CreateSkillRequestToJSON, ExportSkillsRequestToJSON, PaginatedResponseSkillResponseFromJSON, SearchSkillsRequestToJSON, SearchSkillsResponseFromJSON, SkillResponseFromJSON, SkillVersionResponseFromJSON, UpdateSkillRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -375,6 +375,55 @@ export class SkillsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for exportSkills without sending the request
+     */
+    exportSkillsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['exportSkillsRequest'] == null) {
+                throw new runtime.RequiredError('exportSkillsRequest', 'Required parameter "exportSkillsRequest" was null or undefined when calling exportSkills().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/skills/export`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: ExportSkillsRequestToJSON(requestParameters['exportSkillsRequest']),
+            };
+        });
+    }
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkillsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.exportSkillsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.BlobApiResponse(response);
+        });
+    }
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.exportSkillsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getSkill without sending the request
      */

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

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+/**
+ * Skills to pack into one ZIP, each under a top-level folder named after it.
+ * @export
+ * @interface ExportSkillsRequest
+ */
+export interface ExportSkillsRequest {
+    /**
+     * Skills whose frozen active versions are packed together; duplicates are ignored. Every skill must exist and be readable.
+     * @type {Array<string>}
+     * @memberof ExportSkillsRequest
+     */
+    skillIds: Array<string>;
+}
+export declare const ExportSkillsRequestPropertyValidationAttributesMap: {
+    [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 ExportSkillsRequest interface.
+ */
+export declare function instanceOfExportSkillsRequest(value: object): value is ExportSkillsRequest;
+export declare function ExportSkillsRequestFromJSON(json: any): ExportSkillsRequest;
+export declare function ExportSkillsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExportSkillsRequest;
+export declare function ExportSkillsRequestToJSON(json: any): ExportSkillsRequest;
+export declare function ExportSkillsRequestToJSONTyped(value?: ExportSkillsRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/ExportSkillsRequest.js

@@ -0,0 +1,50 @@
+/* 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 ExportSkillsRequestPropertyValidationAttributesMap = {
+    skillIds: {
+        maxItems: 50,
+        minItems: 1,
+        uniqueItems: false,
+    },
+};
+/**
+ * Check if a given object implements the ExportSkillsRequest interface.
+ */
+export function instanceOfExportSkillsRequest(value) {
+    if (!('skillIds' in value) || value['skillIds'] === undefined)
+        return false;
+    return true;
+}
+export function ExportSkillsRequestFromJSON(json) {
+    return ExportSkillsRequestFromJSONTyped(json, false);
+}
+export function ExportSkillsRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'skillIds': json['skill_ids'],
+    };
+}
+export function ExportSkillsRequestToJSON(json) {
+    return ExportSkillsRequestToJSONTyped(json, false);
+}
+export function ExportSkillsRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'skill_ids': value['skillIds'],
+    };
+}

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

@@ -136,6 +136,7 @@ export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
 export * from './ExcludedCommonFile';
+export * from './ExportSkillsRequest';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';

package/dist/esm/models/index.js

@@ -138,6 +138,7 @@ export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
 export * from './ExcludedCommonFile';
+export * from './ExportSkillsRequest';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';

package/dist/models/ExportSkillsRequest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+/**
+ * Skills to pack into one ZIP, each under a top-level folder named after it.
+ * @export
+ * @interface ExportSkillsRequest
+ */
+export interface ExportSkillsRequest {
+    /**
+     * Skills whose frozen active versions are packed together; duplicates are ignored. Every skill must exist and be readable.
+     * @type {Array<string>}
+     * @memberof ExportSkillsRequest
+     */
+    skillIds: Array<string>;
+}
+export declare const ExportSkillsRequestPropertyValidationAttributesMap: {
+    [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 ExportSkillsRequest interface.
+ */
+export declare function instanceOfExportSkillsRequest(value: object): value is ExportSkillsRequest;
+export declare function ExportSkillsRequestFromJSON(json: any): ExportSkillsRequest;
+export declare function ExportSkillsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExportSkillsRequest;
+export declare function ExportSkillsRequestToJSON(json: any): ExportSkillsRequest;
+export declare function ExportSkillsRequestToJSONTyped(value?: ExportSkillsRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/ExportSkillsRequest.js

@@ -0,0 +1,58 @@
+"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.ExportSkillsRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfExportSkillsRequest = instanceOfExportSkillsRequest;
+exports.ExportSkillsRequestFromJSON = ExportSkillsRequestFromJSON;
+exports.ExportSkillsRequestFromJSONTyped = ExportSkillsRequestFromJSONTyped;
+exports.ExportSkillsRequestToJSON = ExportSkillsRequestToJSON;
+exports.ExportSkillsRequestToJSONTyped = ExportSkillsRequestToJSONTyped;
+exports.ExportSkillsRequestPropertyValidationAttributesMap = {
+    skillIds: {
+        maxItems: 50,
+        minItems: 1,
+        uniqueItems: false,
+    },
+};
+/**
+ * Check if a given object implements the ExportSkillsRequest interface.
+ */
+function instanceOfExportSkillsRequest(value) {
+    if (!('skillIds' in value) || value['skillIds'] === undefined)
+        return false;
+    return true;
+}
+function ExportSkillsRequestFromJSON(json) {
+    return ExportSkillsRequestFromJSONTyped(json, false);
+}
+function ExportSkillsRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'skillIds': json['skill_ids'],
+    };
+}
+function ExportSkillsRequestToJSON(json) {
+    return ExportSkillsRequestToJSONTyped(json, false);
+}
+function ExportSkillsRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'skill_ids': value['skillIds'],
+    };
+}

package/dist/models/index.d.ts

@@ -136,6 +136,7 @@ export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
 export * from './ExcludedCommonFile';
+export * from './ExportSkillsRequest';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';

package/dist/models/index.js

@@ -154,6 +154,7 @@ __exportStar(require("./EnrichedThreadMessageContent"), exports);
 __exportStar(require("./ErrorResponse"), exports);
 __exportStar(require("./EventResponse"), exports);
 __exportStar(require("./ExcludedCommonFile"), exports);
+__exportStar(require("./ExportSkillsRequest"), exports);
 __exportStar(require("./ExtractRequest"), exports);
 __exportStar(require("./ExtractResponse"), exports);
 __exportStar(require("./FeaturesResponse"), exports);

package/docs/ExportSkillsRequest.md

@@ -0,0 +1,35 @@
+
+# ExportSkillsRequest
+
+Skills to pack into one ZIP, each under a top-level folder named after it.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`skillIds` | Array<string>
+
+## Example
+
+```typescript
+import type { ExportSkillsRequest } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "skillIds": null,
+} satisfies ExportSkillsRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ExportSkillsRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/SkillsApi.md

@@ -11,6 +11,7 @@ All URIs are relative to *http://localhost:8000*
 | [**deleteSkill**](SkillsApi.md#deleteskill) | **DELETE** /v1/skills/{skill_id} | Delete Skill Handler |
 | [**discardSkillDraft**](SkillsApi.md#discardskilldraft) | **POST** /v1/skills/{skill_id}/discard-draft | Discard Skill Draft Handler |
 | [**exportSkill**](SkillsApi.md#exportskill) | **GET** /v1/skills/{skill_id}/export | Export Skill Handler |
+| [**exportSkills**](SkillsApi.md#exportskillsoperation) | **POST** /v1/skills/export | Export Skills Handler |
 | [**getSkill**](SkillsApi.md#getskill) | **GET** /v1/skills/{skill_id} | Get Skill Handler |
 | [**importSkill**](SkillsApi.md#importskill) | **POST** /v1/skills/import | Import Skill Handler |
 | [**listSkillVersions**](SkillsApi.md#listskillversions) | **GET** /v1/skills/{skill_id}/versions | List Skill Versions Handler |
@@ -552,6 +553,81 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## exportSkills
+
+> Blob exportSkills(exportSkillsRequest)
+
+Export Skills Handler
+
+Download several skills\' active versions as one ZIP; needs can_read on each.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SkillsApi,
+} from '@knowledge-stack/ksapi';
+import type { ExportSkillsOperationRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new SkillsApi(config);
+
+  const body = {
+    // ExportSkillsRequest
+    exportSkillsRequest: ...,
+  } satisfies ExportSkillsOperationRequest;
+
+  try {
+    const data = await api.exportSkills(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **exportSkillsRequest** | [ExportSkillsRequest](ExportSkillsRequest.md) |  | |
+
+### Return type
+
+**Blob**
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/zip`, `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | One ZIP with a top-level folder per skill. |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getSkill
 
 > SkillResponse getSkill(skillId, includeFileContents)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "2.14.4",
+  "version": "2.15.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/SkillsApi.ts

@@ -18,6 +18,7 @@ import type {
   ActivateSkillVersionRequest,
   CreateSkillRequest,
   ErrorResponse,
+  ExportSkillsRequest,
   HTTPValidationError,
   PaginatedResponseSkillResponse,
   SearchSkillsRequest,
@@ -35,6 +36,8 @@ import {
     CreateSkillRequestToJSON,
     ErrorResponseFromJSON,
     ErrorResponseToJSON,
+    ExportSkillsRequestFromJSON,
+    ExportSkillsRequestToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
     PaginatedResponseSkillResponseFromJSON,
@@ -85,6 +88,10 @@ export interface ExportSkillRequest {
     skillId: string;
 }
 
+export interface ExportSkillsOperationRequest {
+    exportSkillsRequest: ExportSkillsRequest;
+}
+
 export interface GetSkillRequest {
     skillId: string;
     includeFileContents?: boolean;
@@ -298,6 +305,30 @@ export interface SkillsApiInterface {
      */
     exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
 
+    /**
+     * Creates request options for exportSkills without sending the request
+     * @param {ExportSkillsRequest} exportSkillsRequest 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * @summary Export Skills Handler
+     * @param {ExportSkillsRequest} exportSkillsRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+
     /**
      * Creates request options for getSkill without sending the request
      * @param {string} skillId 
@@ -892,6 +923,63 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for exportSkills without sending the request
+     */
+    async exportSkillsRequestOpts(requestParameters: ExportSkillsOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['exportSkillsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'exportSkillsRequest',
+                'Required parameter "exportSkillsRequest" was null or undefined when calling exportSkills().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/skills/export`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: ExportSkillsRequestToJSON(requestParameters['exportSkillsRequest']),
+        };
+    }
+
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    async exportSkillsRaw(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>> {
+        const requestOptions = await this.exportSkillsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.BlobApiResponse(response);
+    }
+
+    /**
+     * Download several skills\' active versions as one ZIP; needs can_read on each.
+     * Export Skills Handler
+     */
+    async exportSkills(requestParameters: ExportSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob> {
+        const response = await this.exportSkillsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getSkill without sending the request
      */

package/src/models/ExportSkillsRequest.ts

@@ -0,0 +1,88 @@
+/* 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';
+/**
+ * Skills to pack into one ZIP, each under a top-level folder named after it.
+ * @export
+ * @interface ExportSkillsRequest
+ */
+export interface ExportSkillsRequest {
+    /**
+     * Skills whose frozen active versions are packed together; duplicates are ignored. Every skill must exist and be readable.
+     * @type {Array<string>}
+     * @memberof ExportSkillsRequest
+     */
+    skillIds: Array<string>;
+}
+export const ExportSkillsRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    skillIds: {
+        maxItems: 50,
+        minItems: 1,
+        uniqueItems: false,
+    },
+}
+
+
+/**
+ * Check if a given object implements the ExportSkillsRequest interface.
+ */
+export function instanceOfExportSkillsRequest(value: object): value is ExportSkillsRequest {
+    if (!('skillIds' in value) || value['skillIds'] === undefined) return false;
+    return true;
+}
+
+export function ExportSkillsRequestFromJSON(json: any): ExportSkillsRequest {
+    return ExportSkillsRequestFromJSONTyped(json, false);
+}
+
+export function ExportSkillsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExportSkillsRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'skillIds': json['skill_ids'],
+    };
+}
+
+export function ExportSkillsRequestToJSON(json: any): ExportSkillsRequest {
+    return ExportSkillsRequestToJSONTyped(json, false);
+}
+
+export function ExportSkillsRequestToJSONTyped(value?: ExportSkillsRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'skill_ids': value['skillIds'],
+    };
+}
+

package/src/models/index.ts

@@ -138,6 +138,7 @@ export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
 export * from './ExcludedCommonFile';
+export * from './ExportSkillsRequest';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';