@atlanai/sdk 0.1.0

package/dist/raw/skill/apis/SkillApi.d.ts

@@ -0,0 +1,340 @@
+/**
+ * Skill extension
+ * Distributes agent skills as material bundles.  On upload, the pre-hook unzips and validates the `.zip`, then stores each file as a first-class `file` artifact and pins an exact manifest. Create, update, delete, and search run through the registry\'s artifact API; this service\'s native endpoints reconstruct a skill\'s bundle (latest or a pinned version) as a zip from that manifest.  **Auth:** the bundle endpoints require a bearer token.
+ *
+ * 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 GatewayTraceStatsEnvelope } from '../models/GatewayTraceStatsEnvelope';
+import { type GatewayTraceStatsRequest } from '../models/GatewayTraceStatsRequest';
+import { type SkillBulkSkillResponse } from '../models/SkillBulkSkillResponse';
+import { type SkillPageSkillArtifactView } from '../models/SkillPageSkillArtifactView';
+import { type SkillSkillAggregateRequest } from '../models/SkillSkillAggregateRequest';
+import { type SkillSkillAggregateResponse } from '../models/SkillSkillAggregateResponse';
+import { type SkillSkillArtifactView } from '../models/SkillSkillArtifactView';
+import { type SkillSkillPatch } from '../models/SkillSkillPatch';
+import { type SkillSkillSearchRequest } from '../models/SkillSkillSearchRequest';
+import { type SpanListEnvelope } from '../models/SpanListEnvelope';
+import { type TraceDetailView } from '../models/TraceDetailView';
+import { type TraceListEnvelope } from '../models/TraceListEnvelope';
+export interface SkillAggregateRequest {
+    skillSkillAggregateRequest: SkillSkillAggregateRequest;
+}
+export interface SkillArchiveRequest {
+    skillId: string;
+}
+export interface SkillBulkCreateRequest {
+    items: string;
+}
+export interface SkillCreateRequest {
+    body: Blob;
+    metadata: string;
+}
+export interface SkillGetBundleRequest {
+    skillId: string;
+}
+export interface SkillGetEnrichedRequest {
+    skillId: string;
+}
+export interface SkillGetSkillTraceRequest {
+    skillId: string;
+    traceId: string;
+    versionOrdinal?: number;
+}
+export interface SkillGetVersionBundleRequest {
+    skillId: string;
+    versionOrdinal: number;
+}
+export interface SkillGetVersionEnrichedRequest {
+    skillId: string;
+    versionOrdinal: number;
+}
+export interface SkillListRequest {
+    limit?: number;
+    offset?: number;
+    license?: string;
+    skillVersion?: string;
+    sort?: string;
+}
+export interface SkillListInsightsRequest {
+    skillId: string;
+    insightType?: string | null;
+}
+export interface SkillListSkillTraceSpansRequest {
+    skillId: string;
+    traceId: string;
+    versionOrdinal?: number;
+    limit?: number;
+    cursor?: string;
+    fields?: string;
+}
+export interface SkillListSkillTracesRequest {
+    skillId: string;
+    versionOrdinal?: number;
+    startTimeUnixSeconds?: number;
+    endTimeUnixSeconds?: number;
+    limit?: number;
+    cursor?: string;
+    sort?: string;
+    userId?: string;
+}
+export interface SkillPatchRequest {
+    skillId: string;
+    skillSkillPatch: SkillSkillPatch;
+}
+export interface SkillQuerySkillTraceStatsRequest {
+    skillId: string;
+    gatewayTraceStatsRequest: GatewayTraceStatsRequest;
+    versionOrdinal?: number;
+}
+export interface SkillSearchRequest {
+    skillSkillSearchRequest: SkillSkillSearchRequest;
+}
+/**
+ *
+ */
+export declare class SkillApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for skillAggregate without sending the request
+     */
+    skillAggregateRequestOpts(requestParameters: SkillAggregateRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Group-and-measure over skills: `group_by` dimensions (L1 columns or the kind\'s indexed columns, with `bucket=hour|day|week|month` on a timestamp) and `metrics` (`count`, `count_distinct`, `min`, `max`, `sum`, `avg`). Returns `{groups, page}` where `page.total` is the distinct-group count. Counts span only the workspaces the caller may read.
+     * Aggregate skills
+     */
+    skillAggregateRaw(requestParameters: SkillAggregateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillSkillAggregateResponse>>;
+    /**
+     * Group-and-measure over skills: `group_by` dimensions (L1 columns or the kind\'s indexed columns, with `bucket=hour|day|week|month` on a timestamp) and `metrics` (`count`, `count_distinct`, `min`, `max`, `sum`, `avg`). Returns `{groups, page}` where `page.total` is the distinct-group count. Counts span only the workspaces the caller may read.
+     * Aggregate skills
+     */
+    skillAggregate(requestParameters: SkillAggregateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillSkillAggregateResponse>;
+    /**
+     * Creates request options for skillArchive without sending the request
+     */
+    skillArchiveRequestOpts(requestParameters: SkillArchiveRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Archive the skill line: it remains directly readable for audit but is excluded from default discovery, and its pinned files are released by the delete hook. Recoverable — physical erasure is not exposed on this surface. The seeded system skill cannot be archived.
+     * Archive a skill
+     */
+    skillArchiveRaw(requestParameters: SkillArchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillSkillArtifactView>>;
+    /**
+     * Archive the skill line: it remains directly readable for audit but is excluded from default discovery, and its pinned files are released by the delete hook. Recoverable — physical erasure is not exposed on this surface. The seeded system skill cannot be archived.
+     * Archive a skill
+     */
+    skillArchive(requestParameters: SkillArchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillSkillArtifactView>;
+    /**
+     * Creates request options for skillBulkCreate without sending the request
+     */
+    skillBulkCreateRequestOpts(requestParameters: SkillBulkCreateRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Upload up to 100 skill bundles in one `multipart/form-data` request. Send an `items` part holding a JSON array of `{metadata, body_part}` objects — `metadata` is the same envelope `POST /skills` takes (`name`, optional `description`, the required `workspace_id`), and `body_part` names another part of the same request carrying that skill\'s `.zip`. Each bundle runs the identical create flow to the single-upload route, and every skill\'s files are stored as content-addressed `file` artifacts in the same batch.  Re-uploading versions rather than duplicates, exactly as `POST /skills` does: an item whose `name` already names a skill in that workspace appends a version to it. Two items in one batch naming the same skill is a per-item `409` — a batch cannot append twice to one line. A byte-identical item is also a `409`, carrying `existing_artifact_id` so the caller can identify the skill it already has.  The response is `207 Multi-Status`: one slot per submitted item, in submitted order, each carrying either the created skill or an RFC 7807 problem. An item-attributable failure — a bundle that fails validation, a missing `body_part`, an unparseable envelope — is reported in that item\'s slot and does not affect the others. Only envelope-level failures (a malformed request, an `items` part that is missing, empty, or over the cap) fail the whole request.  The practical ceiling is usually the 16 MiB request body rather than the 100-item cap, since one bundle may itself be up to 10 MiB: batch small text bundles freely, and send large ones through `POST /skills` instead. A bundle containing one file whose *decompressed* size exceeds 16 MiB is a per-item `422` on that skill alone — a single file is stored in one call and cannot be split.
+     * Create many skills from bundles
+     */
+    skillBulkCreateRaw(requestParameters: SkillBulkCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillBulkSkillResponse>>;
+    /**
+     * Upload up to 100 skill bundles in one `multipart/form-data` request. Send an `items` part holding a JSON array of `{metadata, body_part}` objects — `metadata` is the same envelope `POST /skills` takes (`name`, optional `description`, the required `workspace_id`), and `body_part` names another part of the same request carrying that skill\'s `.zip`. Each bundle runs the identical create flow to the single-upload route, and every skill\'s files are stored as content-addressed `file` artifacts in the same batch.  Re-uploading versions rather than duplicates, exactly as `POST /skills` does: an item whose `name` already names a skill in that workspace appends a version to it. Two items in one batch naming the same skill is a per-item `409` — a batch cannot append twice to one line. A byte-identical item is also a `409`, carrying `existing_artifact_id` so the caller can identify the skill it already has.  The response is `207 Multi-Status`: one slot per submitted item, in submitted order, each carrying either the created skill or an RFC 7807 problem. An item-attributable failure — a bundle that fails validation, a missing `body_part`, an unparseable envelope — is reported in that item\'s slot and does not affect the others. Only envelope-level failures (a malformed request, an `items` part that is missing, empty, or over the cap) fail the whole request.  The practical ceiling is usually the 16 MiB request body rather than the 100-item cap, since one bundle may itself be up to 10 MiB: batch small text bundles freely, and send large ones through `POST /skills` instead. A bundle containing one file whose *decompressed* size exceeds 16 MiB is a per-item `422` on that skill alone — a single file is stored in one call and cannot be split.
+     * Create many skills from bundles
+     */
+    skillBulkCreate(requestParameters: SkillBulkCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillBulkSkillResponse>;
+    /**
+     * Creates request options for skillCreate without sending the request
+     */
+    skillCreateRequestOpts(requestParameters: SkillCreateRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Upload a skill bundle as `multipart/form-data`: a `metadata` JSON part carrying `name`, optional `description`, and the required `workspace_id` handle, plus a `body` part holding the `.zip`. The create hook unzips the bundle, validates it (rejecting zip-slip and requiring `SKILL.md`), derives `summary`/`license`/the structural counts, stores each file as its own content-addressed `file` artifact, and pins the manifest — so the skill\'s own properties are derived, never supplied.  **Re-uploading a skill versions it.** `name` is the skill\'s identity within its workspace: a create naming a skill that already lives there appends a new version to that line rather than minting a second one, so the handle is stable across uploads and the history sits on one artifact. A byte-identical re-upload is an idempotent no-op that returns the existing head with no new version. Archiving a skill frees its name for a fresh line.
+     * Create a skill from a bundle
+     */
+    skillCreateRaw(requestParameters: SkillCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillSkillArtifactView>>;
+    /**
+     * Upload a skill bundle as `multipart/form-data`: a `metadata` JSON part carrying `name`, optional `description`, and the required `workspace_id` handle, plus a `body` part holding the `.zip`. The create hook unzips the bundle, validates it (rejecting zip-slip and requiring `SKILL.md`), derives `summary`/`license`/the structural counts, stores each file as its own content-addressed `file` artifact, and pins the manifest — so the skill\'s own properties are derived, never supplied.  **Re-uploading a skill versions it.** `name` is the skill\'s identity within its workspace: a create naming a skill that already lives there appends a new version to that line rather than minting a second one, so the handle is stable across uploads and the history sits on one artifact. A byte-identical re-upload is an idempotent no-op that returns the existing head with no new version. Archiving a skill frees its name for a fresh line.
+     * Create a skill from a bundle
+     */
+    skillCreate(requestParameters: SkillCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillSkillArtifactView>;
+    /**
+     * Creates request options for skillGetBundle without sending the request
+     */
+    skillGetBundleRequestOpts(requestParameters: SkillGetBundleRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Return a skill\'s latest materialized bundle as a zip archive, reconstructed from the pinned file manifest (each file fetched from the file extension). Skills are uploaded and managed through the registry\'s artifact API, not here.
+     * Download a skill bundle
+     */
+    skillGetBundleRaw(requestParameters: SkillGetBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Return a skill\'s latest materialized bundle as a zip archive, reconstructed from the pinned file manifest (each file fetched from the file extension). Skills are uploaded and managed through the registry\'s artifact API, not here.
+     * Download a skill bundle
+     */
+    skillGetBundle(requestParameters: SkillGetBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+    /**
+     * Creates request options for skillGetEnriched without sending the request
+     */
+    skillGetEnrichedRequestOpts(requestParameters: SkillGetEnrichedRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Return the skill\'s latest view with each pinned file\'s L1 metadata embedded under `files` (content excluded). Each embedded file\'s `content_uri` is the file extension\'s HTTP content route, directly fetchable. The thin pin manifest is replaced by this richer list.
+     * Read a skill with its files\' L1 embedded
+     */
+    skillGetEnrichedRaw(requestParameters: SkillGetEnrichedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Return the skill\'s latest view with each pinned file\'s L1 metadata embedded under `files` (content excluded). Each embedded file\'s `content_uri` is the file extension\'s HTTP content route, directly fetchable. The thin pin manifest is replaced by this richer list.
+     * Read a skill with its files\' L1 embedded
+     */
+    skillGetEnriched(requestParameters: SkillGetEnrichedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for skillGetSkillTrace without sending the request
+     */
+    skillGetSkillTraceRequestOpts(requestParameters: SkillGetSkillTraceRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Use this operation to read one skill trace.
+     * Read one skill trace
+     */
+    skillGetSkillTraceRaw(requestParameters: SkillGetSkillTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceDetailView>>;
+    /**
+     * Use this operation to read one skill trace.
+     * Read one skill trace
+     */
+    skillGetSkillTrace(requestParameters: SkillGetSkillTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceDetailView>;
+    /**
+     * Creates request options for skillGetVersionBundle without sending the request
+     */
+    skillGetVersionBundleRequestOpts(requestParameters: SkillGetVersionBundleRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Return a specific skill version\'s bundle as a zip, reconstructed from that version\'s pinned file manifest — old versions resolve their old pinned file bytes.
+     * Download a pinned skill version\'s bundle
+     */
+    skillGetVersionBundleRaw(requestParameters: SkillGetVersionBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+    /**
+     * Return a specific skill version\'s bundle as a zip, reconstructed from that version\'s pinned file manifest — old versions resolve their old pinned file bytes.
+     * Download a pinned skill version\'s bundle
+     */
+    skillGetVersionBundle(requestParameters: SkillGetVersionBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+    /**
+     * Creates request options for skillGetVersionEnriched without sending the request
+     */
+    skillGetVersionEnrichedRequestOpts(requestParameters: SkillGetVersionEnrichedRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Like the latest read, but for a pinned skill version — the embedded file L1s are the exact versions that skill version pins, not file-latest.
+     * Read a pinned skill version with its files\' L1 embedded
+     */
+    skillGetVersionEnrichedRaw(requestParameters: SkillGetVersionEnrichedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Like the latest read, but for a pinned skill version — the embedded file L1s are the exact versions that skill version pins, not file-latest.
+     * Read a pinned skill version with its files\' L1 embedded
+     */
+    skillGetVersionEnriched(requestParameters: SkillGetVersionEnrichedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for skillInsightSchemas without sending the request
+     */
+    skillInsightSchemasRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Return the JSON Schema for each insight type\'s `payload` (capabilities, connectivity, duplication, conflict, security), keyed by `insight_type` — a client resolves + renders any insight by its type discriminator.
+     * Insight payload schemas
+     */
+    skillInsightSchemasRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Return the JSON Schema for each insight type\'s `payload` (capabilities, connectivity, duplication, conflict, security), keyed by `insight_type` — a client resolves + renders any insight by its type discriminator.
+     * Insight payload schemas
+     */
+    skillInsightSchemas(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for skillList without sending the request
+     */
+    skillListRequestOpts(requestParameters: SkillListRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Page the account\'s skills, newest first, each carrying its typed metadata. System skills (the seeded bootstrap skill) are excluded. `license` and `skill_version` filter on the kind\'s indexed columns.
+     * List skills
+     */
+    skillListRaw(requestParameters: SkillListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillPageSkillArtifactView>>;
+    /**
+     * Page the account\'s skills, newest first, each carrying its typed metadata. System skills (the seeded bootstrap skill) are excluded. `license` and `skill_version` filter on the kind\'s indexed columns.
+     * List skills
+     */
+    skillList(requestParameters?: SkillListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillPageSkillArtifactView>;
+    /**
+     * Creates request options for skillListInsights without sending the request
+     */
+    skillListInsightsRequestOpts(requestParameters: SkillListInsightsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Return the `insight` artifacts about this skill — capabilities, connectivity, duplication, conflict, and security. Insights are system, non-searchable records derived by the analysis actions and the scan gate; this route is their read path (they never surface in `/search`). Optionally filter by `?insight_type=`. Returns the `{items, page}` envelope with at most one — the most recent — insight per type, so `page.total` may exceed the number of items returned.
+     * List a skill\'s derived insights
+     */
+    skillListInsightsRaw(requestParameters: SkillListInsightsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Return the `insight` artifacts about this skill — capabilities, connectivity, duplication, conflict, and security. Insights are system, non-searchable records derived by the analysis actions and the scan gate; this route is their read path (they never surface in `/search`). Optionally filter by `?insight_type=`. Returns the `{items, page}` envelope with at most one — the most recent — insight per type, so `page.total` may exceed the number of items returned.
+     * List a skill\'s derived insights
+     */
+    skillListInsights(requestParameters: SkillListInsightsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for skillListSkillTraceSpans without sending the request
+     */
+    skillListSkillTraceSpansRequestOpts(requestParameters: SkillListSkillTraceSpansRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Use this operation to list spans in a skill trace.
+     * List spans in a skill trace
+     */
+    skillListSkillTraceSpansRaw(requestParameters: SkillListSkillTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SpanListEnvelope>>;
+    /**
+     * Use this operation to list spans in a skill trace.
+     * List spans in a skill trace
+     */
+    skillListSkillTraceSpans(requestParameters: SkillListSkillTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SpanListEnvelope>;
+    /**
+     * Creates request options for skillListSkillTraces without sending the request
+     */
+    skillListSkillTracesRequestOpts(requestParameters: SkillListSkillTracesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Use this operation to list traces for a skill.
+     * List traces for a skill
+     */
+    skillListSkillTracesRaw(requestParameters: SkillListSkillTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceListEnvelope>>;
+    /**
+     * Use this operation to list traces for a skill.
+     * List traces for a skill
+     */
+    skillListSkillTraces(requestParameters: SkillListSkillTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceListEnvelope>;
+    /**
+     * Creates request options for skillPatch without sending the request
+     */
+    skillPatchRequestOpts(requestParameters: SkillPatchRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Partially update a skill by RFC 7396 JSON Merge Patch: only the keys supplied change, and an explicit `null` on `description` clears it. Only the generic envelope is editable — every skill property is derived from the uploaded bundle, and the `files` manifest is hook-owned (an edit to it is rejected). Upload a new version to change content. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Update a skill\'s envelope
+     */
+    skillPatchRaw(requestParameters: SkillPatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillSkillArtifactView>>;
+    /**
+     * Partially update a skill by RFC 7396 JSON Merge Patch: only the keys supplied change, and an explicit `null` on `description` clears it. Only the generic envelope is editable — every skill property is derived from the uploaded bundle, and the `files` manifest is hook-owned (an edit to it is rejected). Upload a new version to change content. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Update a skill\'s envelope
+     */
+    skillPatch(requestParameters: SkillPatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillSkillArtifactView>;
+    /**
+     * Creates request options for skillQuerySkillTraceStats without sending the request
+     */
+    skillQuerySkillTraceStatsRequestOpts(requestParameters: SkillQuerySkillTraceStatsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Use this operation to query skill trace statistics.
+     * Query skill trace statistics
+     */
+    skillQuerySkillTraceStatsRaw(requestParameters: SkillQuerySkillTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GatewayTraceStatsEnvelope>>;
+    /**
+     * Use this operation to query skill trace statistics.
+     * Query skill trace statistics
+     */
+    skillQuerySkillTraceStats(requestParameters: SkillQuerySkillTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GatewayTraceStatsEnvelope>;
+    /**
+     * Creates request options for skillSearch without sending the request
+     */
+    skillSearchRequestOpts(requestParameters: SkillSearchRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Discovery over skills. `strategy` selects ranking: `fts` (default) is full-text over name + description; `vector` and `hybrid` embed `query` server-side, so no embedding model is needed by the caller. Results are L1-only and therefore carry no `metadata`. Page with `offset`, or replay `page.next_cursor` as `cursor` (the two are mutually exclusive).
+     * Search skills
+     */
+    skillSearchRaw(requestParameters: SkillSearchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillPageSkillArtifactView>>;
+    /**
+     * Discovery over skills. `strategy` selects ranking: `fts` (default) is full-text over name + description; `vector` and `hybrid` embed `query` server-side, so no embedding model is needed by the caller. Results are L1-only and therefore carry no `metadata`. Page with `offset`, or replay `page.next_cursor` as `cursor` (the two are mutually exclusive).
+     * Search skills
+     */
+    skillSearch(requestParameters: SkillSearchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillPageSkillArtifactView>;
+}