@knowledge-stack/ksapi 1.135.1 → 1.136.0

package/dist/apis/SkillsApi.js

@@ -0,0 +1,786 @@
+"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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillsApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class SkillsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for activateSkillVersion without sending the request
+     */
+    activateSkillVersionRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling activateSkillVersion().');
+            }
+            if (requestParameters['versionId'] == null) {
+                throw new runtime.RequiredError('versionId', 'Required parameter "versionId" was null or undefined when calling activateSkillVersion().');
+            }
+            if (requestParameters['activateSkillVersionRequest'] == null) {
+                throw new runtime.RequiredError('activateSkillVersionRequest', 'Required parameter "activateSkillVersionRequest" was null or undefined when calling activateSkillVersion().');
+            }
+            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/{skill_id}/versions/{version_id}/activate`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.ActivateSkillVersionRequestToJSON)(requestParameters['activateSkillVersionRequest']),
+            };
+        });
+    }
+    /**
+     * Activate a published version, restoring the working copy to it.  Requires a held checkout (it overwrites the working copy).
+     * Activate Skill Version Handler
+     */
+    activateSkillVersionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.activateSkillVersionRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Activate a published version, restoring the working copy to it.  Requires a held checkout (it overwrites the working copy).
+     * Activate Skill Version Handler
+     */
+    activateSkillVersion(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.activateSkillVersionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for checkinSkill without sending the request
+     */
+    checkinSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling checkinSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/checkin`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * Checkin Skill Handler
+     */
+    checkinSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.checkinSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * Checkin Skill Handler
+     */
+    checkinSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.checkinSkillRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Creates request options for checkoutSkill without sending the request
+     */
+    checkoutSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling checkoutSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/checkout`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Check out the whole skill for editing (409 if another user holds it).  Locks the skill via its ``SKILL.md`` document; hold it to edit any file (``SKILL.md`` or scripts) and release it with ``checkin``.
+     * Checkout Skill Handler
+     */
+    checkoutSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.checkoutSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Check out the whole skill for editing (409 if another user holds it).  Locks the skill via its ``SKILL.md`` document; hold it to edit any file (``SKILL.md`` or scripts) and release it with ``checkin``.
+     * Checkout Skill Handler
+     */
+    checkoutSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.checkoutSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for createSkill without sending the request
+     */
+    createSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['createSkillRequest'] == null) {
+                throw new runtime.RequiredError('createSkillRequest', 'Required parameter "createSkillRequest" was null or undefined when calling createSkill().');
+            }
+            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`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.CreateSkillRequestToJSON)(requestParameters['createSkillRequest']),
+            };
+        });
+    }
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    createSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    createSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for deleteSkill without sending the request
+     */
+    deleteSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling deleteSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * Delete Skill Handler
+     */
+    deleteSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * Delete Skill Handler
+     */
+    deleteSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.deleteSkillRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Creates request options for discardSkillDraft without sending the request
+     */
+    discardSkillDraftRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling discardSkillDraft().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/discard-draft`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Discard unpublished edits: restore the working copy to the active version.  Requires a held checkout (it overwrites the working copy).
+     * Discard Skill Draft Handler
+     */
+    discardSkillDraftRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.discardSkillDraftRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Discard unpublished edits: restore the working copy to the active version.  Requires a held checkout (it overwrites the working copy).
+     * Discard Skill Draft Handler
+     */
+    discardSkillDraft(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.discardSkillDraftRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for exportSkill without sending the request
+     */
+    exportSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling exportSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/export`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * Export Skill Handler
+     */
+    exportSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.exportSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            if (this.isJsonMime(response.headers.get('content-type'))) {
+                return new runtime.JSONApiResponse(response);
+            }
+            else {
+                return new runtime.TextApiResponse(response);
+            }
+        });
+    }
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * Export Skill Handler
+     */
+    exportSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.exportSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for getSkill without sending the request
+     */
+    getSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling getSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * Get Skill Handler
+     */
+    getSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * Get Skill Handler
+     */
+    getSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for importSkill without sending the request
+     */
+    importSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling importSkill().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            let urlPath = `/v1/skills/import`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            };
+        });
+    }
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Import Skill Handler
+     */
+    importSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.importSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Import Skill Handler
+     */
+    importSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.importSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for listSkillVersions without sending the request
+     */
+    listSkillVersionsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling listSkillVersions().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/versions`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * List a skill\'s published versions, newest first.
+     * List Skill Versions Handler
+     */
+    listSkillVersionsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listSkillVersionsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.SkillVersionResponseFromJSON));
+        });
+    }
+    /**
+     * List a skill\'s published versions, newest first.
+     * List Skill Versions Handler
+     */
+    listSkillVersions(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listSkillVersionsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for listSkills without sending the request
+     */
+    listSkillsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            if (requestParameters['sortBy'] != null) {
+                queryParameters['sort_by'] = requestParameters['sortBy'];
+            }
+            if (requestParameters['search'] != null) {
+                queryParameters['search'] = requestParameters['search'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            if (requestParameters['sortDir'] != null) {
+                queryParameters['sort_dir'] = requestParameters['sortDir'];
+            }
+            const headerParameters = {};
+            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`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    listSkillsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listSkillsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseSkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    listSkills() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.listSkillsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for publishSkillVersion without sending the request
+     */
+    publishSkillVersionRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling publishSkillVersion().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/{skill_id}/versions`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Snapshot the working copy into a new immutable version and activate it.  Requires a held checkout on the skill (publishing mutates it), so a second author cannot push a version over the checkout holder\'s in-progress draft.
+     * Publish Skill Version Handler
+     */
+    publishSkillVersionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.publishSkillVersionRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Snapshot the working copy into a new immutable version and activate it.  Requires a held checkout on the skill (publishing mutates it), so a second author cannot push a version over the checkout holder\'s in-progress draft.
+     * Publish Skill Version Handler
+     */
+    publishSkillVersion(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.publishSkillVersionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for searchSkills without sending the request
+     */
+    searchSkillsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['searchSkillsRequest'] == null) {
+                throw new runtime.RequiredError('searchSkillsRequest', 'Required parameter "searchSkillsRequest" was null or undefined when calling searchSkills().');
+            }
+            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/search`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.SearchSkillsRequestToJSON)(requestParameters['searchSkillsRequest']),
+            };
+        });
+    }
+    /**
+     * Find skills by the meaning of their routing card (agent discovery).  Dense semantic search over each skill\'s ``name + description`` card, scoped to the tenant. Fail-closed: hits are re-loaded tenant-scoped from Postgres (the authority — a mis-scoped Qdrant hit can\'t leak another tenant\'s skill) and any the caller cannot read are dropped.
+     * Search Skills Handler
+     */
+    searchSkillsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.searchSkillsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SearchSkillsResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Find skills by the meaning of their routing card (agent discovery).  Dense semantic search over each skill\'s ``name + description`` card, scoped to the tenant. Fail-closed: hits are re-loaded tenant-scoped from Postgres (the authority — a mis-scoped Qdrant hit can\'t leak another tenant\'s skill) and any the caller cannot read are dropped.
+     * Search Skills Handler
+     */
+    searchSkills(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.searchSkillsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for updateSkill without sending the request
+     */
+    updateSkillRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['skillId'] == null) {
+                throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling updateSkill().');
+            }
+            if (requestParameters['updateSkillRequest'] == null) {
+                throw new runtime.RequiredError('updateSkillRequest', 'Required parameter "updateSkillRequest" was null or undefined when calling updateSkill().');
+            }
+            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/{skill_id}`;
+            urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+            return {
+                path: urlPath,
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.UpdateSkillRequestToJSON)(requestParameters['updateSkillRequest']),
+            };
+        });
+    }
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    updateSkillRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.updateSkillRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SkillResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    updateSkill(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updateSkillRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}
+exports.SkillsApi = SkillsApi;