@knowledge-stack/ksapi 2.14.4 → 2.15.1

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

@@ -12,31 +12,31 @@
 import * as runtime from '../runtime';
 import type { HourHistogramResponse, RunTimeseriesResponse, TimeBucket, WorkflowLeaderboardResponse, WorkflowOutputStatsResponse, WorkflowRunSummaryResponse } from '../models/index';
 export interface GetAdminWorkflowByHourRequest {
-    since?: Date | null;
-    until?: Date | null;
     timezone?: string | null;
     definitionId?: string | null;
+    since?: Date | null;
+    until?: Date | null;
 }
 export interface GetAdminWorkflowLeaderboardRequest {
+    limit?: number;
     since?: Date | null;
     until?: Date | null;
-    limit?: number;
 }
 export interface GetAdminWorkflowOutputStatsRequest {
     since?: Date | null;
     until?: Date | null;
 }
 export interface GetAdminWorkflowSummaryRequest {
+    definitionId?: string | null;
     since?: Date | null;
     until?: Date | null;
-    definitionId?: string | null;
 }
 export interface GetAdminWorkflowTimeseriesRequest {
+    timezone?: string | null;
+    definitionId?: string | null;
     since?: Date | null;
     until?: Date | null;
     bucket?: TimeBucket;
-    timezone?: string | null;
-    definitionId?: string | null;
 }
 /**
  * AdminWorkflowsApi - interface
@@ -47,10 +47,10 @@ export interface GetAdminWorkflowTimeseriesRequest {
 export interface AdminWorkflowsApiInterface {
     /**
      * Creates request options for getAdminWorkflowByHour without sending the request
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
      * @param {string} [timezone] IANA tz override; defaults to tenant setting.
      * @param {string} [definitionId] Scope to one workflow.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
      */
@@ -58,10 +58,10 @@ export interface AdminWorkflowsApiInterface {
     /**
      * Runs per hour-of-day (0-23) in the resolved timezone.
      * @summary Get Admin Workflow By Hour Handler
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
      * @param {string} [timezone] IANA tz override; defaults to tenant setting.
      * @param {string} [definitionId] Scope to one workflow.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
@@ -74,9 +74,9 @@ export interface AdminWorkflowsApiInterface {
     getAdminWorkflowByHour(requestParameters: GetAdminWorkflowByHourRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HourHistogramResponse>;
     /**
      * Creates request options for getAdminWorkflowLeaderboard without sending the request
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
      * @param {number} [limit] Top-N per leaderboard.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
      */
@@ -84,9 +84,9 @@ export interface AdminWorkflowsApiInterface {
     /**
      * Top workflows and top run owners by run count.
      * @summary Get Admin Workflow Leaderboard Handler
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
      * @param {number} [limit] Top-N per leaderboard.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
@@ -99,8 +99,8 @@ export interface AdminWorkflowsApiInterface {
     getAdminWorkflowLeaderboard(requestParameters: GetAdminWorkflowLeaderboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowLeaderboardResponse>;
     /**
      * Creates request options for getAdminWorkflowOutputStats without sending the request
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
      */
@@ -108,8 +108,8 @@ export interface AdminWorkflowsApiInterface {
     /**
      * Average output DOCUMENTs generated per workflow definition (completed runs).
      * @summary Get Admin Workflow Output Stats Handler
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
@@ -122,9 +122,9 @@ export interface AdminWorkflowsApiInterface {
     getAdminWorkflowOutputStats(requestParameters: GetAdminWorkflowOutputStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowOutputStatsResponse>;
     /**
      * Creates request options for getAdminWorkflowSummary without sending the request
+     * @param {string} [definitionId] Scope all numbers to one workflow.
      * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
      * @param {Date} [until] Window end (inclusive).
-     * @param {string} [definitionId] Scope all numbers to one workflow.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
      */
@@ -132,9 +132,9 @@ export interface AdminWorkflowsApiInterface {
     /**
      * Tenant-wide run health: counts, failure rate, durations, approval backlog.
      * @summary Get Admin Workflow Summary Handler
+     * @param {string} [definitionId] Scope all numbers to one workflow.
      * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
      * @param {Date} [until] Window end (inclusive).
-     * @param {string} [definitionId] Scope all numbers to one workflow.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
@@ -147,11 +147,11 @@ export interface AdminWorkflowsApiInterface {
     getAdminWorkflowSummary(requestParameters: GetAdminWorkflowSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunSummaryResponse>;
     /**
      * Creates request options for getAdminWorkflowTimeseries without sending the request
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
-     * @param {TimeBucket} [bucket] Bucket size.
      * @param {string} [timezone] IANA tz override; defaults to tenant setting.
      * @param {string} [definitionId] Scope to one workflow.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
+     * @param {TimeBucket} [bucket] Bucket size.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface
      */
@@ -159,11 +159,11 @@ export interface AdminWorkflowsApiInterface {
     /**
      * Run counts bucketed over time, in the resolved timezone.
      * @summary Get Admin Workflow Timeseries Handler
-     * @param {Date} [since] Window start.
-     * @param {Date} [until] Window end.
-     * @param {TimeBucket} [bucket] Bucket size.
      * @param {string} [timezone] IANA tz override; defaults to tenant setting.
      * @param {string} [definitionId] Scope to one workflow.
+     * @param {Date} [since] Window start (inclusive). Defaults to 7 days ago.
+     * @param {Date} [until] Window end (inclusive).
+     * @param {TimeBucket} [bucket] Bucket size.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AdminWorkflowsApiInterface

package/dist/esm/apis/AdminWorkflowsApi.js

@@ -32,18 +32,18 @@ export class AdminWorkflowsApi extends runtime.BaseAPI {
     getAdminWorkflowByHourRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
-            if (requestParameters['since'] != null) {
-                queryParameters['since'] = requestParameters['since'].toISOString();
-            }
-            if (requestParameters['until'] != null) {
-                queryParameters['until'] = requestParameters['until'].toISOString();
-            }
             if (requestParameters['timezone'] != null) {
                 queryParameters['timezone'] = requestParameters['timezone'];
             }
             if (requestParameters['definitionId'] != null) {
                 queryParameters['definition_id'] = requestParameters['definitionId'];
             }
+            if (requestParameters['since'] != null) {
+                queryParameters['since'] = requestParameters['since'].toISOString();
+            }
+            if (requestParameters['until'] != null) {
+                queryParameters['until'] = requestParameters['until'].toISOString();
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -88,15 +88,15 @@ export class AdminWorkflowsApi extends runtime.BaseAPI {
     getAdminWorkflowLeaderboardRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
             if (requestParameters['since'] != null) {
                 queryParameters['since'] = requestParameters['since'].toISOString();
             }
             if (requestParameters['until'] != null) {
                 queryParameters['until'] = requestParameters['until'].toISOString();
             }
-            if (requestParameters['limit'] != null) {
-                queryParameters['limit'] = requestParameters['limit'];
-            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -191,15 +191,15 @@ export class AdminWorkflowsApi extends runtime.BaseAPI {
     getAdminWorkflowSummaryRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
+            if (requestParameters['definitionId'] != null) {
+                queryParameters['definition_id'] = requestParameters['definitionId'];
+            }
             if (requestParameters['since'] != null) {
                 queryParameters['since'] = requestParameters['since'].toISOString();
             }
             if (requestParameters['until'] != null) {
                 queryParameters['until'] = requestParameters['until'].toISOString();
             }
-            if (requestParameters['definitionId'] != null) {
-                queryParameters['definition_id'] = requestParameters['definitionId'];
-            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -244,6 +244,12 @@ export class AdminWorkflowsApi extends runtime.BaseAPI {
     getAdminWorkflowTimeseriesRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
+            if (requestParameters['timezone'] != null) {
+                queryParameters['timezone'] = requestParameters['timezone'];
+            }
+            if (requestParameters['definitionId'] != null) {
+                queryParameters['definition_id'] = requestParameters['definitionId'];
+            }
             if (requestParameters['since'] != null) {
                 queryParameters['since'] = requestParameters['since'].toISOString();
             }
@@ -253,12 +259,6 @@ export class AdminWorkflowsApi extends runtime.BaseAPI {
             if (requestParameters['bucket'] != null) {
                 queryParameters['bucket'] = requestParameters['bucket'];
             }
-            if (requestParameters['timezone'] != null) {
-                queryParameters['timezone'] = requestParameters['timezone'];
-            }
-            if (requestParameters['definitionId'] != null) {
-                queryParameters['definition_id'] = requestParameters['definitionId'];
-            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;

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);