@knowledge-stack/ksapi 1.135.0 → 1.136.0

package/src/apis/SkillsApi.ts

@@ -0,0 +1,1321 @@
+/* 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 * as runtime from '../runtime';
+import type {
+  ActivateSkillVersionRequest,
+  CreateSkillRequest,
+  ErrorResponse,
+  HTTPValidationError,
+  PaginatedResponseSkillResponse,
+  SearchSkillsRequest,
+  SearchSkillsResponse,
+  SkillOrder,
+  SkillResponse,
+  SkillVersionResponse,
+  SortDirection,
+  UpdateSkillRequest,
+} from '../models/index';
+import {
+    ActivateSkillVersionRequestFromJSON,
+    ActivateSkillVersionRequestToJSON,
+    CreateSkillRequestFromJSON,
+    CreateSkillRequestToJSON,
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    PaginatedResponseSkillResponseFromJSON,
+    PaginatedResponseSkillResponseToJSON,
+    SearchSkillsRequestFromJSON,
+    SearchSkillsRequestToJSON,
+    SearchSkillsResponseFromJSON,
+    SearchSkillsResponseToJSON,
+    SkillOrderFromJSON,
+    SkillOrderToJSON,
+    SkillResponseFromJSON,
+    SkillResponseToJSON,
+    SkillVersionResponseFromJSON,
+    SkillVersionResponseToJSON,
+    SortDirectionFromJSON,
+    SortDirectionToJSON,
+    UpdateSkillRequestFromJSON,
+    UpdateSkillRequestToJSON,
+} from '../models/index';
+
+export interface ActivateSkillVersionOperationRequest {
+    skillId: string;
+    versionId: string;
+    activateSkillVersionRequest: ActivateSkillVersionRequest;
+}
+
+export interface CheckinSkillRequest {
+    skillId: string;
+}
+
+export interface CheckoutSkillRequest {
+    skillId: string;
+}
+
+export interface CreateSkillOperationRequest {
+    createSkillRequest: CreateSkillRequest;
+}
+
+export interface DeleteSkillRequest {
+    skillId: string;
+}
+
+export interface DiscardSkillDraftRequest {
+    skillId: string;
+}
+
+export interface ExportSkillRequest {
+    skillId: string;
+}
+
+export interface GetSkillRequest {
+    skillId: string;
+}
+
+export interface ImportSkillRequest {
+    file: Blob;
+}
+
+export interface ListSkillVersionsRequest {
+    skillId: string;
+}
+
+export interface ListSkillsRequest {
+    sortBy?: SkillOrder;
+    search?: string | null;
+    limit?: number;
+    offset?: number;
+    sortDir?: SortDirection;
+}
+
+export interface PublishSkillVersionRequest {
+    skillId: string;
+}
+
+export interface SearchSkillsOperationRequest {
+    searchSkillsRequest: SearchSkillsRequest;
+}
+
+export interface UpdateSkillOperationRequest {
+    skillId: string;
+    updateSkillRequest: UpdateSkillRequest;
+}
+
+/**
+ * SkillsApi - interface
+ * 
+ * @export
+ * @interface SkillsApiInterface
+ */
+export interface SkillsApiInterface {
+    /**
+     * Creates request options for activateSkillVersion without sending the request
+     * @param {string} skillId 
+     * @param {string} versionId 
+     * @param {ActivateSkillVersionRequest} activateSkillVersionRequest 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    activateSkillVersionRequestOpts(requestParameters: ActivateSkillVersionOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Activate a published version, restoring the working copy to it.  Requires a held checkout (it overwrites the working copy).
+     * @summary Activate Skill Version Handler
+     * @param {string} skillId 
+     * @param {string} versionId 
+     * @param {ActivateSkillVersionRequest} activateSkillVersionRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    activateSkillVersionRaw(requestParameters: ActivateSkillVersionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * 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: ActivateSkillVersionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for checkinSkill without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    checkinSkillRequestOpts(requestParameters: CheckinSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * @summary Checkin Skill Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    checkinSkillRaw(requestParameters: CheckinSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * Checkin Skill Handler
+     */
+    checkinSkill(requestParameters: CheckinSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Creates request options for checkoutSkill without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    checkoutSkillRequestOpts(requestParameters: CheckoutSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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``.
+     * @summary Checkout Skill Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    checkoutSkillRaw(requestParameters: CheckoutSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * 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: CheckoutSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for createSkill without sending the request
+     * @param {CreateSkillRequest} createSkillRequest 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    createSkillRequestOpts(requestParameters: CreateSkillOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * @summary Create Skill Handler
+     * @param {CreateSkillRequest} createSkillRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    createSkillRaw(requestParameters: CreateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    createSkill(requestParameters: CreateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for deleteSkill without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    deleteSkillRequestOpts(requestParameters: DeleteSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * @summary Delete Skill Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    deleteSkillRaw(requestParameters: DeleteSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * Delete Skill Handler
+     */
+    deleteSkill(requestParameters: DeleteSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Creates request options for discardSkillDraft without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    discardSkillDraftRequestOpts(requestParameters: DiscardSkillDraftRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Discard unpublished edits: restore the working copy to the active version.  Requires a held checkout (it overwrites the working copy).
+     * @summary Discard Skill Draft Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    discardSkillDraftRaw(requestParameters: DiscardSkillDraftRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * 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: DiscardSkillDraftRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for exportSkill without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillRequestOpts(requestParameters: ExportSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * @summary Export Skill Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    exportSkillRaw(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<any>>;
+
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * Export Skill Handler
+     */
+    exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any>;
+
+    /**
+     * Creates request options for getSkill without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    getSkillRequestOpts(requestParameters: GetSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * @summary Get Skill Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    getSkillRaw(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * Get Skill Handler
+     */
+    getSkill(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for importSkill without sending the request
+     * @param {Blob} file 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    importSkillRequestOpts(requestParameters: ImportSkillRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * @summary Import Skill Handler
+     * @param {Blob} file 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    importSkillRaw(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Import Skill Handler
+     */
+    importSkill(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for listSkillVersions without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    listSkillVersionsRequestOpts(requestParameters: ListSkillVersionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List a skill\'s published versions, newest first.
+     * @summary List Skill Versions Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    listSkillVersionsRaw(requestParameters: ListSkillVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<SkillVersionResponse>>>;
+
+    /**
+     * List a skill\'s published versions, newest first.
+     * List Skill Versions Handler
+     */
+    listSkillVersions(requestParameters: ListSkillVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<SkillVersionResponse>>;
+
+    /**
+     * Creates request options for listSkills without sending the request
+     * @param {SkillOrder} [sortBy] Field to sort skills by (default: CREATED_AT)
+     * @param {string} [search] Case-insensitive skill-name substring filter (search bar)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {SortDirection} [sortDir] Sort direction (ASC or DESC); overrides the field\&#39;s natural default. Every sort field supports both directions.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    listSkillsRequestOpts(requestParameters: ListSkillsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * @summary List Skills Handler
+     * @param {SkillOrder} [sortBy] Field to sort skills by (default: CREATED_AT)
+     * @param {string} [search] Case-insensitive skill-name substring filter (search bar)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {SortDirection} [sortDir] Sort direction (ASC or DESC); overrides the field\&#39;s natural default. Every sort field supports both directions.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    listSkillsRaw(requestParameters: ListSkillsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseSkillResponse>>;
+
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    listSkills(requestParameters: ListSkillsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseSkillResponse>;
+
+    /**
+     * Creates request options for publishSkillVersion without sending the request
+     * @param {string} skillId 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    publishSkillVersionRequestOpts(requestParameters: PublishSkillVersionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary Publish Skill Version Handler
+     * @param {string} skillId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    publishSkillVersionRaw(requestParameters: PublishSkillVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * 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: PublishSkillVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+    /**
+     * Creates request options for searchSkills without sending the request
+     * @param {SearchSkillsRequest} searchSkillsRequest 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    searchSkillsRequestOpts(requestParameters: SearchSkillsOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary Search Skills Handler
+     * @param {SearchSkillsRequest} searchSkillsRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    searchSkillsRaw(requestParameters: SearchSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchSkillsResponse>>;
+
+    /**
+     * 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: SearchSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchSkillsResponse>;
+
+    /**
+     * Creates request options for updateSkill without sending the request
+     * @param {string} skillId 
+     * @param {UpdateSkillRequest} updateSkillRequest 
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    updateSkillRequestOpts(requestParameters: UpdateSkillOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * @summary Update Skill Handler
+     * @param {string} skillId 
+     * @param {UpdateSkillRequest} updateSkillRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SkillsApiInterface
+     */
+    updateSkillRaw(requestParameters: UpdateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
+
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    updateSkill(requestParameters: UpdateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
+
+}
+
+/**
+ * 
+ */
+export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
+
+    /**
+     * Creates request options for activateSkillVersion without sending the request
+     */
+    async activateSkillVersionRequestOpts(requestParameters: ActivateSkillVersionOperationRequest): Promise<runtime.RequestOpts> {
+        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: 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/{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: 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
+     */
+    async activateSkillVersionRaw(requestParameters: ActivateSkillVersionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.activateSkillVersionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => 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
+     */
+    async activateSkillVersion(requestParameters: ActivateSkillVersionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.activateSkillVersionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for checkinSkill without sending the request
+     */
+    async checkinSkillRequestOpts(requestParameters: CheckinSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling checkinSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async checkinSkillRaw(requestParameters: CheckinSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.checkinSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * Checkin Skill Handler
+     */
+    async checkinSkill(requestParameters: CheckinSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.checkinSkillRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for checkoutSkill without sending the request
+     */
+    async checkoutSkillRequestOpts(requestParameters: CheckoutSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling checkoutSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async checkoutSkillRaw(requestParameters: CheckoutSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.checkoutSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => 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
+     */
+    async checkoutSkill(requestParameters: CheckoutSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.checkoutSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for createSkill without sending the request
+     */
+    async createSkillRequestOpts(requestParameters: CreateSkillOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['createSkillRequest'] == null) {
+            throw new runtime.RequiredError(
+                'createSkillRequest',
+                'Required parameter "createSkillRequest" was null or undefined when calling createSkill().'
+            );
+        }
+
+        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`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CreateSkillRequestToJSON(requestParameters['createSkillRequest']),
+        };
+    }
+
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    async createSkillRaw(requestParameters: CreateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.createSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SkillResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    async createSkill(requestParameters: CreateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.createSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for deleteSkill without sending the request
+     */
+    async deleteSkillRequestOpts(requestParameters: DeleteSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling deleteSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async deleteSkillRaw(requestParameters: DeleteSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.deleteSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * Delete Skill Handler
+     */
+    async deleteSkill(requestParameters: DeleteSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.deleteSkillRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for discardSkillDraft without sending the request
+     */
+    async discardSkillDraftRequestOpts(requestParameters: DiscardSkillDraftRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling discardSkillDraft().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async discardSkillDraftRaw(requestParameters: DiscardSkillDraftRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.discardSkillDraftRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => 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
+     */
+    async discardSkillDraft(requestParameters: DiscardSkillDraftRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.discardSkillDraftRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for exportSkill without sending the request
+     */
+    async exportSkillRequestOpts(requestParameters: ExportSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling exportSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async exportSkillRaw(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<any>> {
+        const requestOptions = await this.exportSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        if (this.isJsonMime(response.headers.get('content-type'))) {
+            return new runtime.JSONApiResponse<any>(response);
+        } else {
+            return new runtime.TextApiResponse(response) as any;
+        }
+    }
+
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * Export Skill Handler
+     */
+    async exportSkill(requestParameters: ExportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<any> {
+        const response = await this.exportSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getSkill without sending the request
+     */
+    async getSkillRequestOpts(requestParameters: GetSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling getSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async getSkillRaw(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.getSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SkillResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * Get Skill Handler
+     */
+    async getSkill(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.getSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for importSkill without sending the request
+     */
+    async importSkillRequestOpts(requestParameters: ImportSkillRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['file'] == null) {
+            throw new runtime.RequiredError(
+                'file',
+                'Required parameter "file" was null or undefined when calling importSkill().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        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'] as any);
+        }
+
+
+        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
+     */
+    async importSkillRaw(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.importSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SkillResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Import Skill Handler
+     */
+    async importSkill(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.importSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listSkillVersions without sending the request
+     */
+    async listSkillVersionsRequestOpts(requestParameters: ListSkillVersionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling listSkillVersions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async listSkillVersionsRaw(requestParameters: ListSkillVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<SkillVersionResponse>>> {
+        const requestOptions = await this.listSkillVersionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(SkillVersionResponseFromJSON));
+    }
+
+    /**
+     * List a skill\'s published versions, newest first.
+     * List Skill Versions Handler
+     */
+    async listSkillVersions(requestParameters: ListSkillVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<SkillVersionResponse>> {
+        const response = await this.listSkillVersionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listSkills without sending the request
+     */
+    async listSkillsRequestOpts(requestParameters: ListSkillsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        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: runtime.HTTPHeaders = {};
+
+        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`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    async listSkillsRaw(requestParameters: ListSkillsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseSkillResponse>> {
+        const requestOptions = await this.listSkillsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseSkillResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    async listSkills(requestParameters: ListSkillsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseSkillResponse> {
+        const response = await this.listSkillsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for publishSkillVersion without sending the request
+     */
+    async publishSkillVersionRequestOpts(requestParameters: PublishSkillVersionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError(
+                'skillId',
+                'Required parameter "skillId" was null or undefined when calling publishSkillVersion().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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/{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
+     */
+    async publishSkillVersionRaw(requestParameters: PublishSkillVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.publishSkillVersionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => 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
+     */
+    async publishSkillVersion(requestParameters: PublishSkillVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.publishSkillVersionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for searchSkills without sending the request
+     */
+    async searchSkillsRequestOpts(requestParameters: SearchSkillsOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['searchSkillsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'searchSkillsRequest',
+                'Required parameter "searchSkillsRequest" was null or undefined when calling searchSkills().'
+            );
+        }
+
+        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/search`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: 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
+     */
+    async searchSkillsRaw(requestParameters: SearchSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchSkillsResponse>> {
+        const requestOptions = await this.searchSkillsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => 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
+     */
+    async searchSkills(requestParameters: SearchSkillsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchSkillsResponse> {
+        const response = await this.searchSkillsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for updateSkill without sending the request
+     */
+    async updateSkillRequestOpts(requestParameters: UpdateSkillOperationRequest): Promise<runtime.RequestOpts> {
+        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: 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/{skill_id}`;
+        urlPath = urlPath.replace(`{${"skill_id"}}`, encodeURIComponent(String(requestParameters['skillId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UpdateSkillRequestToJSON(requestParameters['updateSkillRequest']),
+        };
+    }
+
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    async updateSkillRaw(requestParameters: UpdateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
+        const requestOptions = await this.updateSkillRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SkillResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    async updateSkill(requestParameters: UpdateSkillOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
+        const response = await this.updateSkillRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}