@xemahq/skill-registry-api-client 0.1.0

package/dist/endpoints/skill-governance/skill-governance.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillGovernanceControllerRollback = exports.getSkillGovernanceControllerRollbackUrl = exports.skillGovernanceControllerDeprecate = exports.getSkillGovernanceControllerDeprecateUrl = exports.skillGovernanceControllerReject = exports.getSkillGovernanceControllerRejectUrl = exports.skillGovernanceControllerApprove = exports.getSkillGovernanceControllerApproveUrl = exports.skillGovernanceControllerSubmitForReview = exports.getSkillGovernanceControllerSubmitForReviewUrl = exports.skillGovernanceControllerGetLatestRun = exports.getSkillGovernanceControllerGetLatestRunUrl = exports.skillGovernanceControllerRunEvalSuite = exports.getSkillGovernanceControllerRunEvalSuiteUrl = exports.skillGovernanceControllerUpsertEvalSuite = exports.getSkillGovernanceControllerUpsertEvalSuiteUrl = exports.skillGovernanceControllerGetEvalSuite = exports.getSkillGovernanceControllerGetEvalSuiteUrl = exports.skillGovernanceControllerGetState = exports.getSkillGovernanceControllerGetStateUrl = void 0;
+const custom_fetch_1 = require("../../custom-fetch");
+/**
+ * Lifecycle state, risk tier + the deterministic indicators that fired, eval-suite status, approval provenance, and the append-only audit history of the current version.
+ * @summary The governance state of a skill.
+ */
+const getSkillGovernanceControllerGetStateUrl = (id) => {
+    return `/skills/${id}/governance`;
+};
+exports.getSkillGovernanceControllerGetStateUrl = getSkillGovernanceControllerGetStateUrl;
+const skillGovernanceControllerGetState = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetStateUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillGovernanceControllerGetState = skillGovernanceControllerGetState;
+/**
+ * The 3–5 representative queries plus the last-run outcome.
+ * @summary Read the skill's evaluation suite.
+ */
+const getSkillGovernanceControllerGetEvalSuiteUrl = (id) => {
+    return `/skills/${id}/governance/eval-suite`;
+};
+exports.getSkillGovernanceControllerGetEvalSuiteUrl = getSkillGovernanceControllerGetEvalSuiteUrl;
+const skillGovernanceControllerGetEvalSuite = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetEvalSuiteUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillGovernanceControllerGetEvalSuite = skillGovernanceControllerGetEvalSuite;
+/**
+ * Submit 3–5 representative queries (should-trigger / should-not-trigger / edge). Allowed only while the skill is in `draft`. Replacing the suite clears the last-run outcome.
+ * @summary Replace the skill's evaluation suite.
+ */
+const getSkillGovernanceControllerUpsertEvalSuiteUrl = (id) => {
+    return `/skills/${id}/governance/eval-suite`;
+};
+exports.getSkillGovernanceControllerUpsertEvalSuiteUrl = getSkillGovernanceControllerUpsertEvalSuiteUrl;
+const skillGovernanceControllerUpsertEvalSuite = async (id, upsertSkillEvalSuiteDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerUpsertEvalSuiteUrl)(id), {
+        ...options,
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(upsertSkillEvalSuiteDto)
+    });
+};
+exports.skillGovernanceControllerUpsertEvalSuite = skillGovernanceControllerUpsertEvalSuite;
+/**
+ * Executes a full eval-driven iteration: every test case is run twice — once with the skill mounted, once without it (the baseline) — in ephemeral sandbox sessions; every assertion is graded PASS/FAIL with concrete evidence; an aggregated benchmark (per-config pass rates + the with/without delta) is persisted. A run whose benchmark satisfies the governance gate (with-skill pass rate ≥ threshold AND positive delta) is what `approve` requires.
+ * @summary Run the skill's evaluation suite.
+ */
+const getSkillGovernanceControllerRunEvalSuiteUrl = (id) => {
+    return `/skills/${id}/governance/eval-suite/run`;
+};
+exports.getSkillGovernanceControllerRunEvalSuiteUrl = getSkillGovernanceControllerRunEvalSuiteUrl;
+const skillGovernanceControllerRunEvalSuite = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRunEvalSuiteUrl)(id), {
+        ...options,
+        method: 'POST'
+    });
+};
+exports.skillGovernanceControllerRunEvalSuite = skillGovernanceControllerRunEvalSuite;
+/**
+ * The most recent eval run with its per-case results, the aggregated benchmark, and the frozen governance-gate verdict.
+ * @summary Read the skill's latest evaluation run.
+ */
+const getSkillGovernanceControllerGetLatestRunUrl = (id) => {
+    return `/skills/${id}/governance/eval-suite/latest-run`;
+};
+exports.getSkillGovernanceControllerGetLatestRunUrl = getSkillGovernanceControllerGetLatestRunUrl;
+const skillGovernanceControllerGetLatestRun = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetLatestRunUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillGovernanceControllerGetLatestRun = skillGovernanceControllerGetLatestRun;
+/**
+ * Transitions the current version `draft → in_review`.
+ * @summary Submit the skill for review.
+ */
+const getSkillGovernanceControllerSubmitForReviewUrl = (id) => {
+    return `/skills/${id}/governance/submit-for-review`;
+};
+exports.getSkillGovernanceControllerSubmitForReviewUrl = getSkillGovernanceControllerSubmitForReviewUrl;
+const skillGovernanceControllerSubmitForReview = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerSubmitForReviewUrl)(id), {
+        ...options,
+        method: 'POST'
+    });
+};
+exports.skillGovernanceControllerSubmitForReview = skillGovernanceControllerSubmitForReview;
+/**
+ * Transitions `in_review → approved`. Blocked unless the caller differs from the author (separation of duties) and the evaluation suite has a passing run.
+ * @summary Approve the skill.
+ */
+const getSkillGovernanceControllerApproveUrl = (id) => {
+    return `/skills/${id}/governance/approve`;
+};
+exports.getSkillGovernanceControllerApproveUrl = getSkillGovernanceControllerApproveUrl;
+const skillGovernanceControllerApprove = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerApproveUrl)(id), {
+        ...options,
+        method: 'POST'
+    });
+};
+exports.skillGovernanceControllerApprove = skillGovernanceControllerApprove;
+/**
+ * Transitions `in_review → draft` so the author can revise. A reason is required and recorded on the audit log.
+ * @summary Reject the skill under review.
+ */
+const getSkillGovernanceControllerRejectUrl = (id) => {
+    return `/skills/${id}/governance/reject`;
+};
+exports.getSkillGovernanceControllerRejectUrl = getSkillGovernanceControllerRejectUrl;
+const skillGovernanceControllerReject = async (id, rejectSkillDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRejectUrl)(id), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(rejectSkillDto)
+    });
+};
+exports.skillGovernanceControllerReject = skillGovernanceControllerReject;
+/**
+ * Transitions `approved → deprecated`.
+ * @summary Deprecate an approved skill.
+ */
+const getSkillGovernanceControllerDeprecateUrl = (id) => {
+    return `/skills/${id}/governance/deprecate`;
+};
+exports.getSkillGovernanceControllerDeprecateUrl = getSkillGovernanceControllerDeprecateUrl;
+const skillGovernanceControllerDeprecate = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerDeprecateUrl)(id), {
+        ...options,
+        method: 'POST'
+    });
+};
+exports.skillGovernanceControllerDeprecate = skillGovernanceControllerDeprecate;
+/**
+ * Re-points the skill's current version to an already-approved version. No version's lifecycle state changes; the move is recorded on the audit log.
+ * @summary Roll the skill back to a prior approved version.
+ */
+const getSkillGovernanceControllerRollbackUrl = (id) => {
+    return `/skills/${id}/governance/rollback`;
+};
+exports.getSkillGovernanceControllerRollbackUrl = getSkillGovernanceControllerRollbackUrl;
+const skillGovernanceControllerRollback = async (id, rollbackSkillDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRollbackUrl)(id), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(rollbackSkillDto)
+    });
+};
+exports.skillGovernanceControllerRollback = skillGovernanceControllerRollback;

package/dist/endpoints/skill-repositories/skill-repositories.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Skill Registry API
+ * Skill-registry extract (generated for client codegen).
+ * OpenAPI spec version: 0.1.0
+ */
+import type { CreateSkillRepositoryDto, SkillRepositoryResponseDtoDataArrayEnvelope, SkillRepositoryResponseDtoDataEnvelope, SkillRepositorySyncResultDtoDataEnvelope } from '../../models';
+/**
+ * @summary List the git skill repositories registered by the caller org.
+ */
+export declare const getSkillRepositoriesControllerListUrl: () => string;
+export declare const skillRepositoriesControllerList: (options?: RequestInit) => Promise<SkillRepositoryResponseDtoDataArrayEnvelope>;
+/**
+ * Stores the repo; call `POST /skill-repositories/:id/sync` to ingest its SKILL.md bundles. A duplicate `(org, url)` returns 409.
+ * @summary Register a git repository as a skill source.
+ */
+export declare const getSkillRepositoriesControllerCreateUrl: () => string;
+export declare const skillRepositoriesControllerCreate: (createSkillRepositoryDto: CreateSkillRepositoryDto, options?: RequestInit) => Promise<SkillRepositoryResponseDtoDataEnvelope>;
+/**
+ * @summary Get a registered skill repository by id.
+ */
+export declare const getSkillRepositoriesControllerGetByIdUrl: (id: string) => string;
+export declare const skillRepositoriesControllerGetById: (id: string, options?: RequestInit) => Promise<SkillRepositoryResponseDtoDataEnvelope>;
+/**
+ * Cascade-deletes every skill ingested from this repository.
+ * @summary Remove a skill repository.
+ */
+export declare const getSkillRepositoriesControllerRemoveUrl: (id: string) => string;
+export declare const skillRepositoriesControllerRemove: (id: string, options?: RequestInit) => Promise<SkillRepositoryResponseDtoDataEnvelope>;
+/**
+ * Shallow-clones the repo, ingests every SKILL.md bundle as an org-scoped git-sourced skill, and prunes skills removed from the repo.
+ * @summary Sync a skill repository.
+ */
+export declare const getSkillRepositoriesControllerSyncUrl: (id: string) => string;
+export declare const skillRepositoriesControllerSync: (id: string, options?: RequestInit) => Promise<SkillRepositorySyncResultDtoDataEnvelope>;

package/dist/endpoints/skill-repositories/skill-repositories.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillRepositoriesControllerSync = exports.getSkillRepositoriesControllerSyncUrl = exports.skillRepositoriesControllerRemove = exports.getSkillRepositoriesControllerRemoveUrl = exports.skillRepositoriesControllerGetById = exports.getSkillRepositoriesControllerGetByIdUrl = exports.skillRepositoriesControllerCreate = exports.getSkillRepositoriesControllerCreateUrl = exports.skillRepositoriesControllerList = exports.getSkillRepositoriesControllerListUrl = void 0;
+const custom_fetch_1 = require("../../custom-fetch");
+/**
+ * @summary List the git skill repositories registered by the caller org.
+ */
+const getSkillRepositoriesControllerListUrl = () => {
+    return `/skill-repositories`;
+};
+exports.getSkillRepositoriesControllerListUrl = getSkillRepositoriesControllerListUrl;
+const skillRepositoriesControllerList = async (options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerListUrl)(), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillRepositoriesControllerList = skillRepositoriesControllerList;
+/**
+ * Stores the repo; call `POST /skill-repositories/:id/sync` to ingest its SKILL.md bundles. A duplicate `(org, url)` returns 409.
+ * @summary Register a git repository as a skill source.
+ */
+const getSkillRepositoriesControllerCreateUrl = () => {
+    return `/skill-repositories`;
+};
+exports.getSkillRepositoriesControllerCreateUrl = getSkillRepositoriesControllerCreateUrl;
+const skillRepositoriesControllerCreate = async (createSkillRepositoryDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerCreateUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(createSkillRepositoryDto)
+    });
+};
+exports.skillRepositoriesControllerCreate = skillRepositoriesControllerCreate;
+/**
+ * @summary Get a registered skill repository by id.
+ */
+const getSkillRepositoriesControllerGetByIdUrl = (id) => {
+    return `/skill-repositories/${id}`;
+};
+exports.getSkillRepositoriesControllerGetByIdUrl = getSkillRepositoriesControllerGetByIdUrl;
+const skillRepositoriesControllerGetById = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerGetByIdUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillRepositoriesControllerGetById = skillRepositoriesControllerGetById;
+/**
+ * Cascade-deletes every skill ingested from this repository.
+ * @summary Remove a skill repository.
+ */
+const getSkillRepositoriesControllerRemoveUrl = (id) => {
+    return `/skill-repositories/${id}`;
+};
+exports.getSkillRepositoriesControllerRemoveUrl = getSkillRepositoriesControllerRemoveUrl;
+const skillRepositoriesControllerRemove = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerRemoveUrl)(id), {
+        ...options,
+        method: 'DELETE'
+    });
+};
+exports.skillRepositoriesControllerRemove = skillRepositoriesControllerRemove;
+/**
+ * Shallow-clones the repo, ingests every SKILL.md bundle as an org-scoped git-sourced skill, and prunes skills removed from the repo.
+ * @summary Sync a skill repository.
+ */
+const getSkillRepositoriesControllerSyncUrl = (id) => {
+    return `/skill-repositories/${id}/sync`;
+};
+exports.getSkillRepositoriesControllerSyncUrl = getSkillRepositoriesControllerSyncUrl;
+const skillRepositoriesControllerSync = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerSyncUrl)(id), {
+        ...options,
+        method: 'POST'
+    });
+};
+exports.skillRepositoriesControllerSync = skillRepositoriesControllerSync;

package/dist/endpoints/skills/skills.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Skill Registry API
+ * Skill-registry extract (generated for client codegen).
+ * OpenAPI spec version: 0.1.0
+ */
+import type { CreateSkillBundleDto, CreateSkillBundleResponseDtoDataEnvelope, CreateSkillDto, SearchSkillsQueryDto, SkillBundleResponseDtoDataEnvelope, SkillCatalogEntryDtoDataArrayEnvelope, SkillResponseDtoDataArrayEnvelope, SkillResponseDtoDataEnvelope, SkillTreeNodeDtoDataArrayEnvelope, SkillsControllerBundleParams, SkillsControllerListParams, SkillsControllerLookupParams, UpdateSkillDto } from '../../models';
+/**
+ * Returns every active system skill plus the caller org/project/user skills. Optional filters (scope, kind, parentSlug, topLevelOnly) are AND-combined. `skillMarkdown` is omitted from list rows.
+ * @summary List skills visible to the caller.
+ */
+export declare const getSkillsControllerListUrl: (params?: SkillsControllerListParams) => string;
+export declare const skillsControllerList: (params?: SkillsControllerListParams, options?: RequestInit) => Promise<SkillResponseDtoDataArrayEnvelope>;
+/**
+ * Creates a skill + its first draft version. Scope must be org, project, or user. A `(scope, slug)` collision returns 409.
+ * @summary Author a new skill.
+ */
+export declare const getSkillsControllerCreateUrl: () => string;
+export declare const skillsControllerCreate: (createSkillDto: CreateSkillDto, options?: RequestInit) => Promise<SkillResponseDtoDataEnvelope>;
+/**
+ * Top-level skills with their nested sub-skills. A skill whose parent is not visible to the caller is surfaced as a root.
+ * @summary The visible skill hierarchy as a nested tree.
+ */
+export declare const getSkillsControllerTreeUrl: () => string;
+export declare const skillsControllerTree: (options?: RequestInit) => Promise<SkillTreeNodeDtoDataArrayEnvelope>;
+/**
+ * A flat catalog (slug, name, description, kind, category, tags) of every visible skill — the progressive-disclosure discovery surface.
+ * @summary OpenCode-compatible skill catalog.
+ */
+export declare const getSkillsControllerRegistryJsonUrl: () => string;
+export declare const skillsControllerRegistryJson: (options?: RequestInit) => Promise<SkillCatalogEntryDtoDataArrayEnvelope>;
+/**
+ * Slugs contain `/`, so they are passed as a query param rather than a path segment. When the slug exists at multiple scopes the most specific visible one wins: user > project > org > system.
+ * @summary Resolve a skill by its hierarchical slug.
+ */
+export declare const getSkillsControllerLookupUrl: (params: SkillsControllerLookupParams) => string;
+export declare const skillsControllerLookup: (params: SkillsControllerLookupParams, options?: RequestInit) => Promise<SkillResponseDtoDataEnvelope>;
+/**
+ * SKILL.md plus every bundled resource (reference docs, scripts, assets, templates) for the highest-precedence visible skill at `slug`. This is what the workspace composer mounts into `/workspace/.opencode/skills/`.
+ * @summary The full mountable bundle for a skill.
+ */
+export declare const getSkillsControllerBundleUrl: (params: SkillsControllerBundleParams) => string;
+export declare const skillsControllerBundle: (params: SkillsControllerBundleParams, options?: RequestInit) => Promise<SkillBundleResponseDtoDataEnvelope>;
+/**
+ * Creates or replaces a skill from a complete bundle — SKILL.md plus reference docs, scripts, assets, templates, and nested sub-skills (a resource whose `relPath` is a nested `SKILL.md`). Use this from the Agent Studio skill builder; `POST /skills` remains the single-file quick-create path. Scope must be `org`, `project`, or `user`. Only SKILL.md is strictly validated. Re-authoring the same `(scope, slug)` upserts the bundle in place as a new draft version. A slug owned by a biome/git source returns 409.
+ * @summary Author a skill as a full multi-file bundle.
+ */
+export declare const getSkillsControllerAuthorBundleUrl: () => string;
+export declare const skillsControllerAuthorBundle: (createSkillBundleDto: CreateSkillBundleDto, options?: RequestInit) => Promise<CreateSkillBundleResponseDtoDataEnvelope>;
+/**
+ * Returns the skill including its current-version SKILL.md body.
+ * @summary Get a skill by id.
+ */
+export declare const getSkillsControllerGetByIdUrl: (id: string) => string;
+export declare const skillsControllerGetById: (id: string, options?: RequestInit) => Promise<SkillResponseDtoDataEnvelope>;
+/**
+ * Updates metadata in place. When `skillMarkdown` is supplied a new draft version is created and becomes current (`version` then required). System/biome skills are read-only — 409 with a fork-first hint.
+ * @summary Update a skill.
+ */
+export declare const getSkillsControllerUpdateUrl: (id: string) => string;
+export declare const skillsControllerUpdate: (id: string, updateSkillDto: UpdateSkillDto, options?: RequestInit) => Promise<SkillResponseDtoDataEnvelope>;
+/**
+ * Keyword search over skill name and description, scoped to the caller's visible skills. Name matches rank above description-only matches.
+ * @summary Search skills by keyword.
+ */
+export declare const getSkillsControllerSearchUrl: () => string;
+export declare const skillsControllerSearch: (searchSkillsQueryDto: SearchSkillsQueryDto, options?: RequestInit) => Promise<SkillResponseDtoDataArrayEnvelope>;

package/dist/endpoints/skills/skills.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillsControllerSearch = exports.getSkillsControllerSearchUrl = exports.skillsControllerUpdate = exports.getSkillsControllerUpdateUrl = exports.skillsControllerGetById = exports.getSkillsControllerGetByIdUrl = exports.skillsControllerAuthorBundle = exports.getSkillsControllerAuthorBundleUrl = exports.skillsControllerBundle = exports.getSkillsControllerBundleUrl = exports.skillsControllerLookup = exports.getSkillsControllerLookupUrl = exports.skillsControllerRegistryJson = exports.getSkillsControllerRegistryJsonUrl = exports.skillsControllerTree = exports.getSkillsControllerTreeUrl = exports.skillsControllerCreate = exports.getSkillsControllerCreateUrl = exports.skillsControllerList = exports.getSkillsControllerListUrl = void 0;
+const custom_fetch_1 = require("../../custom-fetch");
+/**
+ * Returns every active system skill plus the caller org/project/user skills. Optional filters (scope, kind, parentSlug, topLevelOnly) are AND-combined. `skillMarkdown` is omitted from list rows.
+ * @summary List skills visible to the caller.
+ */
+const getSkillsControllerListUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/skills?${stringifiedParams}` : `/skills`;
+};
+exports.getSkillsControllerListUrl = getSkillsControllerListUrl;
+const skillsControllerList = async (params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerListUrl)(params), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerList = skillsControllerList;
+/**
+ * Creates a skill + its first draft version. Scope must be org, project, or user. A `(scope, slug)` collision returns 409.
+ * @summary Author a new skill.
+ */
+const getSkillsControllerCreateUrl = () => {
+    return `/skills`;
+};
+exports.getSkillsControllerCreateUrl = getSkillsControllerCreateUrl;
+const skillsControllerCreate = async (createSkillDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerCreateUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(createSkillDto)
+    });
+};
+exports.skillsControllerCreate = skillsControllerCreate;
+/**
+ * Top-level skills with their nested sub-skills. A skill whose parent is not visible to the caller is surfaced as a root.
+ * @summary The visible skill hierarchy as a nested tree.
+ */
+const getSkillsControllerTreeUrl = () => {
+    return `/skills/tree`;
+};
+exports.getSkillsControllerTreeUrl = getSkillsControllerTreeUrl;
+const skillsControllerTree = async (options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerTreeUrl)(), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerTree = skillsControllerTree;
+/**
+ * A flat catalog (slug, name, description, kind, category, tags) of every visible skill — the progressive-disclosure discovery surface.
+ * @summary OpenCode-compatible skill catalog.
+ */
+const getSkillsControllerRegistryJsonUrl = () => {
+    return `/skills/registry.json`;
+};
+exports.getSkillsControllerRegistryJsonUrl = getSkillsControllerRegistryJsonUrl;
+const skillsControllerRegistryJson = async (options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerRegistryJsonUrl)(), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerRegistryJson = skillsControllerRegistryJson;
+/**
+ * Slugs contain `/`, so they are passed as a query param rather than a path segment. When the slug exists at multiple scopes the most specific visible one wins: user > project > org > system.
+ * @summary Resolve a skill by its hierarchical slug.
+ */
+const getSkillsControllerLookupUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/skills/lookup?${stringifiedParams}` : `/skills/lookup`;
+};
+exports.getSkillsControllerLookupUrl = getSkillsControllerLookupUrl;
+const skillsControllerLookup = async (params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerLookupUrl)(params), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerLookup = skillsControllerLookup;
+/**
+ * SKILL.md plus every bundled resource (reference docs, scripts, assets, templates) for the highest-precedence visible skill at `slug`. This is what the workspace composer mounts into `/workspace/.opencode/skills/`.
+ * @summary The full mountable bundle for a skill.
+ */
+const getSkillsControllerBundleUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/skills/bundle?${stringifiedParams}` : `/skills/bundle`;
+};
+exports.getSkillsControllerBundleUrl = getSkillsControllerBundleUrl;
+const skillsControllerBundle = async (params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerBundleUrl)(params), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerBundle = skillsControllerBundle;
+/**
+ * Creates or replaces a skill from a complete bundle — SKILL.md plus reference docs, scripts, assets, templates, and nested sub-skills (a resource whose `relPath` is a nested `SKILL.md`). Use this from the Agent Studio skill builder; `POST /skills` remains the single-file quick-create path. Scope must be `org`, `project`, or `user`. Only SKILL.md is strictly validated. Re-authoring the same `(scope, slug)` upserts the bundle in place as a new draft version. A slug owned by a biome/git source returns 409.
+ * @summary Author a skill as a full multi-file bundle.
+ */
+const getSkillsControllerAuthorBundleUrl = () => {
+    return `/skills/bundle`;
+};
+exports.getSkillsControllerAuthorBundleUrl = getSkillsControllerAuthorBundleUrl;
+const skillsControllerAuthorBundle = async (createSkillBundleDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerAuthorBundleUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(createSkillBundleDto)
+    });
+};
+exports.skillsControllerAuthorBundle = skillsControllerAuthorBundle;
+/**
+ * Returns the skill including its current-version SKILL.md body.
+ * @summary Get a skill by id.
+ */
+const getSkillsControllerGetByIdUrl = (id) => {
+    return `/skills/${id}`;
+};
+exports.getSkillsControllerGetByIdUrl = getSkillsControllerGetByIdUrl;
+const skillsControllerGetById = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerGetByIdUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.skillsControllerGetById = skillsControllerGetById;
+/**
+ * Updates metadata in place. When `skillMarkdown` is supplied a new draft version is created and becomes current (`version` then required). System/biome skills are read-only — 409 with a fork-first hint.
+ * @summary Update a skill.
+ */
+const getSkillsControllerUpdateUrl = (id) => {
+    return `/skills/${id}`;
+};
+exports.getSkillsControllerUpdateUrl = getSkillsControllerUpdateUrl;
+const skillsControllerUpdate = async (id, updateSkillDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerUpdateUrl)(id), {
+        ...options,
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(updateSkillDto)
+    });
+};
+exports.skillsControllerUpdate = skillsControllerUpdate;
+/**
+ * Keyword search over skill name and description, scoped to the caller's visible skills. Name matches rank above description-only matches.
+ * @summary Search skills by keyword.
+ */
+const getSkillsControllerSearchUrl = () => {
+    return `/skills/search`;
+};
+exports.getSkillsControllerSearchUrl = getSkillsControllerSearchUrl;
+const skillsControllerSearch = async (searchSkillsQueryDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerSearchUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(searchSkillsQueryDto)
+    });
+};
+exports.skillsControllerSearch = skillsControllerSearch;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { configureClient, getClientConfig, ClientError, customFetch, type ClientConfig } from './custom-fetch';
+export * from './models';
+export * from './endpoints/skill-governance/skill-governance';
+export * from './endpoints/skill-repositories/skill-repositories';
+export * from './endpoints/skills/skills';

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customFetch = exports.ClientError = exports.getClientConfig = exports.configureClient = void 0;
+// Auto-generated by @xemahq/api-client-generator — do not edit manually.
+var custom_fetch_1 = require("./custom-fetch");
+Object.defineProperty(exports, "configureClient", { enumerable: true, get: function () { return custom_fetch_1.configureClient; } });
+Object.defineProperty(exports, "getClientConfig", { enumerable: true, get: function () { return custom_fetch_1.getClientConfig; } });
+Object.defineProperty(exports, "ClientError", { enumerable: true, get: function () { return custom_fetch_1.ClientError; } });
+Object.defineProperty(exports, "customFetch", { enumerable: true, get: function () { return custom_fetch_1.customFetch; } });
+__exportStar(require("./models"), exports);
+__exportStar(require("./endpoints/skill-governance/skill-governance"), exports);
+__exportStar(require("./endpoints/skill-repositories/skill-repositories"), exports);
+__exportStar(require("./endpoints/skills/skills"), exports);

package/dist/models/createSkillBundleDto.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Skill Registry API
+ * Skill-registry extract (generated for client codegen).
+ * OpenAPI spec version: 0.1.0
+ */
+import type { CreateSkillBundleResourceDto } from './createSkillBundleResourceDto';
+import type { SkillSpace } from './skillSpace';
+export interface CreateSkillBundleDto {
+    /** Hierarchical slug, e.g. `software-engineering/requirements`. */
+    slug: string;
+    /** Authoring scope — only `org`, `project`, or `user`. */
+    scope: SkillSpace;
+    /** Raw SKILL.md content (YAML frontmatter + body). Frontmatter is strictly validated — `name` and `description` are required. */
+    skillMarkdown: string;
+    /**
+       * Every non-SKILL.md bundle file. A nested `SKILL.md` resource declares a sub-skill. Pass an empty array for a SKILL.md-only bundle.
+       * @maxItems 256
+       */
+    resources: CreateSkillBundleResourceDto[];
+    /** Version label for the authored bundle version. Becomes the skill current version. */
+    version: string;
+}

package/dist/models/createSkillBundleDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/createSkillBundleResourceDto.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Skill Registry API
+ * Skill-registry extract (generated for client codegen).
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SkillResourceType } from './skillResourceType';
+export interface CreateSkillBundleResourceDto {
+    /** Forward-slash path relative to the skill directory, e.g. `reference/api.md` or `scripts/lint.sh`. No leading slash, no `..` segments. */
+    relPath: string;
+    /** Classification of the file. The server re-derives this deterministically from `relPath`; the supplied value documents author intent. */
+    type: SkillResourceType;
+    /** File bytes, base64-encoded. */
+    contentBase64: string;
+}

package/dist/models/createSkillBundleResourceDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });