@atlanai/sdk 0.1.0

package/dist/raw/skill/apis/SkillApi.js

@@ -0,0 +1,895 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const GatewayTraceStatsEnvelope_1 = require("../models/GatewayTraceStatsEnvelope");
+const GatewayTraceStatsRequest_1 = require("../models/GatewayTraceStatsRequest");
+const SkillBulkSkillResponse_1 = require("../models/SkillBulkSkillResponse");
+const SkillPageSkillArtifactView_1 = require("../models/SkillPageSkillArtifactView");
+const SkillSkillAggregateRequest_1 = require("../models/SkillSkillAggregateRequest");
+const SkillSkillAggregateResponse_1 = require("../models/SkillSkillAggregateResponse");
+const SkillSkillArtifactView_1 = require("../models/SkillSkillArtifactView");
+const SkillSkillPatch_1 = require("../models/SkillSkillPatch");
+const SkillSkillSearchRequest_1 = require("../models/SkillSkillSearchRequest");
+const SpanListEnvelope_1 = require("../models/SpanListEnvelope");
+const TraceDetailView_1 = require("../models/TraceDetailView");
+const TraceListEnvelope_1 = require("../models/TraceListEnvelope");
+/**
+ *
+ */
+class SkillApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for skillAggregate without sending the request
+     */
+    async skillAggregateRequestOpts(requestParameters) {
+        if (requestParameters['skillSkillAggregateRequest'] == null) {
+            throw new runtime.RequiredError('skillSkillAggregateRequest', 'Required parameter "skillSkillAggregateRequest" was null or undefined when calling skillAggregate().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/aggregate`;
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, SkillSkillAggregateRequest_1.SkillSkillAggregateRequestToJSON)(requestParameters['skillSkillAggregateRequest']),
+        };
+    }
+    /**
+     * 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
+     */
+    async skillAggregateRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillAggregateRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillSkillAggregateResponse_1.SkillSkillAggregateResponseFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillAggregate(requestParameters, initOverrides) {
+        const response = await this.skillAggregateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillArchive without sending the request
+     */
+    async skillArchiveRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillArchive().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/archive`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillArchiveRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillArchiveRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillSkillArtifactView_1.SkillSkillArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillArchive(requestParameters, initOverrides) {
+        const response = await this.skillArchiveRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillBulkCreate without sending the request
+     */
+    async skillBulkCreateRequestOpts(requestParameters) {
+        if (requestParameters['items'] == null) {
+            throw new runtime.RequiredError('items', 'Required parameter "items" was null or undefined when calling skillBulkCreate().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+        let formParams;
+        let useForm = false;
+        if (useForm) {
+            formParams = new FormData();
+        }
+        else {
+            formParams = new URLSearchParams();
+        }
+        if (requestParameters['items'] != null) {
+            formParams.append('items', requestParameters['items']);
+        }
+        let urlPath = `/skills/bulk`;
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillBulkCreateRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillBulkCreateRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillBulkSkillResponse_1.SkillBulkSkillResponseFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillBulkCreate(requestParameters, initOverrides) {
+        const response = await this.skillBulkCreateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillCreate without sending the request
+     */
+    async skillCreateRequestOpts(requestParameters) {
+        if (requestParameters['body'] == null) {
+            throw new runtime.RequiredError('body', 'Required parameter "body" was null or undefined when calling skillCreate().');
+        }
+        if (requestParameters['metadata'] == null) {
+            throw new runtime.RequiredError('metadata', 'Required parameter "metadata" was null or undefined when calling skillCreate().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+        let formParams;
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        }
+        else {
+            formParams = new URLSearchParams();
+        }
+        if (requestParameters['body'] != null) {
+            formParams.append('body', requestParameters['body']);
+        }
+        if (requestParameters['metadata'] != null) {
+            formParams.append('metadata', requestParameters['metadata']);
+        }
+        let urlPath = `/skills`;
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillCreateRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillCreateRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillSkillArtifactView_1.SkillSkillArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillCreate(requestParameters, initOverrides) {
+        const response = await this.skillCreateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillGetBundle without sending the request
+     */
+    async skillGetBundleRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillGetBundle().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/bundle`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillGetBundleRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillGetBundleRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.BlobApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillGetBundle(requestParameters, initOverrides) {
+        const response = await this.skillGetBundleRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillGetEnriched without sending the request
+     */
+    async skillGetEnrichedRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillGetEnriched().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillGetEnrichedRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillGetEnrichedRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillGetEnriched(requestParameters, initOverrides) {
+        await this.skillGetEnrichedRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Creates request options for skillGetSkillTrace without sending the request
+     */
+    async skillGetSkillTraceRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillGetSkillTrace().');
+        }
+        if (requestParameters['traceId'] == null) {
+            throw new runtime.RequiredError('traceId', 'Required parameter "traceId" was null or undefined when calling skillGetSkillTrace().');
+        }
+        const queryParameters = {};
+        if (requestParameters['versionOrdinal'] != null) {
+            queryParameters['version_ordinal'] = requestParameters['versionOrdinal'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/traces/{trace_id}`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        urlPath = urlPath.replace('{trace_id}', encodeURIComponent(String(requestParameters['traceId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Use this operation to read one skill trace.
+     * Read one skill trace
+     */
+    async skillGetSkillTraceRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillGetSkillTraceRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceDetailView_1.TraceDetailViewFromJSON)(jsonValue));
+    }
+    /**
+     * Use this operation to read one skill trace.
+     * Read one skill trace
+     */
+    async skillGetSkillTrace(requestParameters, initOverrides) {
+        const response = await this.skillGetSkillTraceRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillGetVersionBundle without sending the request
+     */
+    async skillGetVersionBundleRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillGetVersionBundle().');
+        }
+        if (requestParameters['versionOrdinal'] == null) {
+            throw new runtime.RequiredError('versionOrdinal', 'Required parameter "versionOrdinal" was null or undefined when calling skillGetVersionBundle().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/versions/{version_ordinal}/bundle`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        urlPath = urlPath.replace('{version_ordinal}', encodeURIComponent(String(requestParameters['versionOrdinal'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillGetVersionBundleRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillGetVersionBundleRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.BlobApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillGetVersionBundle(requestParameters, initOverrides) {
+        const response = await this.skillGetVersionBundleRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillGetVersionEnriched without sending the request
+     */
+    async skillGetVersionEnrichedRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillGetVersionEnriched().');
+        }
+        if (requestParameters['versionOrdinal'] == null) {
+            throw new runtime.RequiredError('versionOrdinal', 'Required parameter "versionOrdinal" was null or undefined when calling skillGetVersionEnriched().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/versions/{version_ordinal}`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        urlPath = urlPath.replace('{version_ordinal}', encodeURIComponent(String(requestParameters['versionOrdinal'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillGetVersionEnrichedRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillGetVersionEnrichedRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillGetVersionEnriched(requestParameters, initOverrides) {
+        await this.skillGetVersionEnrichedRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Creates request options for skillInsightSchemas without sending the request
+     */
+    async skillInsightSchemasRequestOpts() {
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/insights/schemas`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillInsightSchemasRaw(initOverrides) {
+        const requestOptions = await this.skillInsightSchemasRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillInsightSchemas(initOverrides) {
+        await this.skillInsightSchemasRaw(initOverrides);
+    }
+    /**
+     * Creates request options for skillList without sending the request
+     */
+    async skillListRequestOpts(requestParameters) {
+        const queryParameters = {};
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+        if (requestParameters['license'] != null) {
+            queryParameters['license'] = requestParameters['license'];
+        }
+        if (requestParameters['skillVersion'] != null) {
+            queryParameters['skill_version'] = requestParameters['skillVersion'];
+        }
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillListRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillListRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillPageSkillArtifactView_1.SkillPageSkillArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillList(requestParameters = {}, initOverrides) {
+        const response = await this.skillListRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillListInsights without sending the request
+     */
+    async skillListInsightsRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillListInsights().');
+        }
+        const queryParameters = {};
+        if (requestParameters['insightType'] != null) {
+            queryParameters['insight_type'] = requestParameters['insightType'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/insights`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * 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
+     */
+    async skillListInsightsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillListInsightsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * 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
+     */
+    async skillListInsights(requestParameters, initOverrides) {
+        await this.skillListInsightsRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Creates request options for skillListSkillTraceSpans without sending the request
+     */
+    async skillListSkillTraceSpansRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillListSkillTraceSpans().');
+        }
+        if (requestParameters['traceId'] == null) {
+            throw new runtime.RequiredError('traceId', 'Required parameter "traceId" was null or undefined when calling skillListSkillTraceSpans().');
+        }
+        const queryParameters = {};
+        if (requestParameters['versionOrdinal'] != null) {
+            queryParameters['version_ordinal'] = requestParameters['versionOrdinal'];
+        }
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+        if (requestParameters['fields'] != null) {
+            queryParameters['fields'] = requestParameters['fields'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/traces/{trace_id}/spans`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        urlPath = urlPath.replace('{trace_id}', encodeURIComponent(String(requestParameters['traceId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Use this operation to list spans in a skill trace.
+     * List spans in a skill trace
+     */
+    async skillListSkillTraceSpansRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillListSkillTraceSpansRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SpanListEnvelope_1.SpanListEnvelopeFromJSON)(jsonValue));
+    }
+    /**
+     * Use this operation to list spans in a skill trace.
+     * List spans in a skill trace
+     */
+    async skillListSkillTraceSpans(requestParameters, initOverrides) {
+        const response = await this.skillListSkillTraceSpansRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillListSkillTraces without sending the request
+     */
+    async skillListSkillTracesRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillListSkillTraces().');
+        }
+        const queryParameters = {};
+        if (requestParameters['versionOrdinal'] != null) {
+            queryParameters['version_ordinal'] = requestParameters['versionOrdinal'];
+        }
+        if (requestParameters['startTimeUnixSeconds'] != null) {
+            queryParameters['start_time_unix_seconds'] = requestParameters['startTimeUnixSeconds'];
+        }
+        if (requestParameters['endTimeUnixSeconds'] != null) {
+            queryParameters['end_time_unix_seconds'] = requestParameters['endTimeUnixSeconds'];
+        }
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+        if (requestParameters['userId'] != null) {
+            queryParameters['user_id'] = requestParameters['userId'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/traces`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Use this operation to list traces for a skill.
+     * List traces for a skill
+     */
+    async skillListSkillTracesRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillListSkillTracesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceListEnvelope_1.TraceListEnvelopeFromJSON)(jsonValue));
+    }
+    /**
+     * Use this operation to list traces for a skill.
+     * List traces for a skill
+     */
+    async skillListSkillTraces(requestParameters, initOverrides) {
+        const response = await this.skillListSkillTracesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillPatch without sending the request
+     */
+    async skillPatchRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillPatch().');
+        }
+        if (requestParameters['skillSkillPatch'] == null) {
+            throw new runtime.RequiredError('skillSkillPatch', 'Required parameter "skillSkillPatch" was null or undefined when calling skillPatch().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, SkillSkillPatch_1.SkillSkillPatchToJSON)(requestParameters['skillSkillPatch']),
+        };
+    }
+    /**
+     * 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
+     */
+    async skillPatchRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillPatchRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillSkillArtifactView_1.SkillSkillArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillPatch(requestParameters, initOverrides) {
+        const response = await this.skillPatchRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillQuerySkillTraceStats without sending the request
+     */
+    async skillQuerySkillTraceStatsRequestOpts(requestParameters) {
+        if (requestParameters['skillId'] == null) {
+            throw new runtime.RequiredError('skillId', 'Required parameter "skillId" was null or undefined when calling skillQuerySkillTraceStats().');
+        }
+        if (requestParameters['gatewayTraceStatsRequest'] == null) {
+            throw new runtime.RequiredError('gatewayTraceStatsRequest', 'Required parameter "gatewayTraceStatsRequest" was null or undefined when calling skillQuerySkillTraceStats().');
+        }
+        const queryParameters = {};
+        if (requestParameters['versionOrdinal'] != null) {
+            queryParameters['version_ordinal'] = requestParameters['versionOrdinal'];
+        }
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/{skill_id}/traces/stats/query`;
+        urlPath = urlPath.replace('{skill_id}', encodeURIComponent(String(requestParameters['skillId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, GatewayTraceStatsRequest_1.GatewayTraceStatsRequestToJSON)(requestParameters['gatewayTraceStatsRequest']),
+        };
+    }
+    /**
+     * Use this operation to query skill trace statistics.
+     * Query skill trace statistics
+     */
+    async skillQuerySkillTraceStatsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillQuerySkillTraceStatsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, GatewayTraceStatsEnvelope_1.GatewayTraceStatsEnvelopeFromJSON)(jsonValue));
+    }
+    /**
+     * Use this operation to query skill trace statistics.
+     * Query skill trace statistics
+     */
+    async skillQuerySkillTraceStats(requestParameters, initOverrides) {
+        const response = await this.skillQuerySkillTraceStatsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for skillSearch without sending the request
+     */
+    async skillSearchRequestOpts(requestParameters) {
+        if (requestParameters['skillSkillSearchRequest'] == null) {
+            throw new runtime.RequiredError('skillSkillSearchRequest', 'Required parameter "skillSkillSearchRequest" was null or undefined when calling skillSearch().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/skills/search`;
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, SkillSkillSearchRequest_1.SkillSkillSearchRequestToJSON)(requestParameters['skillSkillSearchRequest']),
+        };
+    }
+    /**
+     * 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
+     */
+    async skillSearchRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.skillSearchRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, SkillPageSkillArtifactView_1.SkillPageSkillArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * 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
+     */
+    async skillSearch(requestParameters, initOverrides) {
+        const response = await this.skillSearchRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.SkillApi = SkillApi;