@knowledge-stack/ksapi 1.135.1 → 1.136.0

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

@@ -0,0 +1,579 @@
+/**
+ * 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, PaginatedResponseSkillResponse, SearchSkillsRequest, SearchSkillsResponse, SkillOrder, SkillResponse, SkillVersionResponse, SortDirection, UpdateSkillRequest } 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 declare class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
+    /**
+     * Creates request options for activateSkillVersion without sending the request
+     */
+    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).
+     * Activate Skill Version Handler
+     */
+    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
+     */
+    checkinSkillRequestOpts(requestParameters: CheckinSkillRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Release the skill\'s checkout so another author can edit it.
+     * Checkin Skill Handler
+     */
+    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
+     */
+    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``.
+     * Checkout Skill Handler
+     */
+    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
+     */
+    createSkillRequestOpts(requestParameters: CreateSkillOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Author a skill (JSON) under /agents/skills; requires can_write there.
+     * Create Skill Handler
+     */
+    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
+     */
+    deleteSkillRequestOpts(requestParameters: DeleteSkillRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Soft-delete a skill; requires can_delete; 409 if another holds checkout.
+     * Delete Skill Handler
+     */
+    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
+     */
+    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).
+     * Discard Skill Draft Handler
+     */
+    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
+     */
+    exportSkillRequestOpts(requestParameters: ExportSkillRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Download the active published version as a self-contained ZIP for sharing.
+     * Export Skill Handler
+     */
+    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
+     */
+    getSkillRequestOpts(requestParameters: GetSkillRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Skill detail: SKILL.md, scripts, has_unpublished_changes, permissions.
+     * Get Skill Handler
+     */
+    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
+     */
+    importSkillRequestOpts(requestParameters: ImportSkillRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Import Skill Handler
+     */
+    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
+     */
+    listSkillVersionsRequestOpts(requestParameters: ListSkillVersionsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List a skill\'s published versions, newest first.
+     * List Skill Versions Handler
+     */
+    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
+     */
+    listSkillsRequestOpts(requestParameters: ListSkillsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List readable skills: paginated, sortable both ways, name-searchable.
+     * List Skills Handler
+     */
+    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
+     */
+    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.
+     * Publish Skill Version Handler
+     */
+    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
+     */
+    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.
+     * Search Skills Handler
+     */
+    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
+     */
+    updateSkillRequestOpts(requestParameters: UpdateSkillOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Edit the working copy in place; requires can_write + a held checkout.
+     * Update Skill Handler
+     */
+    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>;
+}