@xemahq/skill-registry-api-client 0.1.0 → 0.2.0

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

@@ -2,14 +2,14 @@
 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;
+/**
+ * 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 skillGovernanceControllerGetState = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetStateUrl)(id), {
         ...options,
@@ -17,14 +17,14 @@ const skillGovernanceControllerGetState = async (id, options) => {
     });
 };
 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;
+/**
+ * The 3–5 representative queries plus the last-run outcome.
+ * @summary Read the skill's evaluation suite.
+ */
 const skillGovernanceControllerGetEvalSuite = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetEvalSuiteUrl)(id), {
         ...options,
@@ -32,14 +32,14 @@ const skillGovernanceControllerGetEvalSuite = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerUpsertEvalSuite = async (id, upsertSkillEvalSuiteDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerUpsertEvalSuiteUrl)(id), {
         ...options,
@@ -49,14 +49,14 @@ const skillGovernanceControllerUpsertEvalSuite = async (id, upsertSkillEvalSuite
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerRunEvalSuite = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRunEvalSuiteUrl)(id), {
         ...options,
@@ -64,14 +64,14 @@ const skillGovernanceControllerRunEvalSuite = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerGetLatestRun = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerGetLatestRunUrl)(id), {
         ...options,
@@ -79,14 +79,14 @@ const skillGovernanceControllerGetLatestRun = async (id, options) => {
     });
 };
 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;
+/**
+ * Transitions the current version `draft → in_review`.
+ * @summary Submit the skill for review.
+ */
 const skillGovernanceControllerSubmitForReview = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerSubmitForReviewUrl)(id), {
         ...options,
@@ -94,14 +94,14 @@ const skillGovernanceControllerSubmitForReview = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerApprove = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerApproveUrl)(id), {
         ...options,
@@ -109,14 +109,14 @@ const skillGovernanceControllerApprove = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerReject = async (id, rejectSkillDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRejectUrl)(id), {
         ...options,
@@ -126,14 +126,14 @@ const skillGovernanceControllerReject = async (id, rejectSkillDto, options) => {
     });
 };
 exports.skillGovernanceControllerReject = skillGovernanceControllerReject;
-/**
- * Transitions `approved → deprecated`.
- * @summary Deprecate an approved skill.
- */
 const getSkillGovernanceControllerDeprecateUrl = (id) => {
     return `/skills/${id}/governance/deprecate`;
 };
 exports.getSkillGovernanceControllerDeprecateUrl = getSkillGovernanceControllerDeprecateUrl;
+/**
+ * Transitions `approved → deprecated`.
+ * @summary Deprecate an approved skill.
+ */
 const skillGovernanceControllerDeprecate = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerDeprecateUrl)(id), {
         ...options,
@@ -141,14 +141,14 @@ const skillGovernanceControllerDeprecate = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillGovernanceControllerRollback = async (id, rollbackSkillDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillGovernanceControllerRollbackUrl)(id), {
         ...options,

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

@@ -1,36 +1,36 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * 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';
+export declare const getSkillRepositoriesControllerListUrl: () => string;
 /**
  * @summary List the git skill repositories registered by the caller org.
  */
-export declare const getSkillRepositoriesControllerListUrl: () => string;
 export declare const skillRepositoriesControllerList: (options?: RequestInit) => Promise<SkillRepositoryResponseDtoDataArrayEnvelope>;
+export declare const getSkillRepositoriesControllerCreateUrl: () => string;
 /**
  * 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>;
+export declare const getSkillRepositoriesControllerGetByIdUrl: (id: string) => string;
 /**
  * @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>;
+export declare const getSkillRepositoriesControllerRemoveUrl: (id: string) => string;
 /**
  * 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>;
+export declare const getSkillRepositoriesControllerSyncUrl: (id: string) => string;
 /**
  * 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

@@ -2,13 +2,13 @@
 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;
+/**
+ * @summary List the git skill repositories registered by the caller org.
+ */
 const skillRepositoriesControllerList = async (options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerListUrl)(), {
         ...options,
@@ -16,14 +16,14 @@ const skillRepositoriesControllerList = async (options) => {
     });
 };
 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;
+/**
+ * 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 skillRepositoriesControllerCreate = async (createSkillRepositoryDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerCreateUrl)(), {
         ...options,
@@ -33,13 +33,13 @@ const skillRepositoriesControllerCreate = async (createSkillRepositoryDto, optio
     });
 };
 exports.skillRepositoriesControllerCreate = skillRepositoriesControllerCreate;
-/**
- * @summary Get a registered skill repository by id.
- */
 const getSkillRepositoriesControllerGetByIdUrl = (id) => {
     return `/skill-repositories/${id}`;
 };
 exports.getSkillRepositoriesControllerGetByIdUrl = getSkillRepositoriesControllerGetByIdUrl;
+/**
+ * @summary Get a registered skill repository by id.
+ */
 const skillRepositoriesControllerGetById = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerGetByIdUrl)(id), {
         ...options,
@@ -47,14 +47,14 @@ const skillRepositoriesControllerGetById = async (id, options) => {
     });
 };
 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;
+/**
+ * Cascade-deletes every skill ingested from this repository.
+ * @summary Remove a skill repository.
+ */
 const skillRepositoriesControllerRemove = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerRemoveUrl)(id), {
         ...options,
@@ -62,14 +62,14 @@ const skillRepositoriesControllerRemove = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillRepositoriesControllerSync = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillRepositoriesControllerSyncUrl)(id), {
         ...options,

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

@@ -1,68 +1,68 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * 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';
+export declare const getSkillsControllerListUrl: (params?: SkillsControllerListParams) => string;
 /**
  * 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>;
+export declare const getSkillsControllerCreateUrl: () => string;
 /**
  * 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>;
+export declare const getSkillsControllerTreeUrl: () => string;
 /**
  * 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>;
+export declare const getSkillsControllerRegistryJsonUrl: () => string;
 /**
  * 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>;
+export declare const getSkillsControllerLookupUrl: (params: SkillsControllerLookupParams) => string;
 /**
  * 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>;
+export declare const getSkillsControllerBundleUrl: (params: SkillsControllerBundleParams) => string;
 /**
  * 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>;
+export declare const getSkillsControllerAuthorBundleUrl: () => string;
 /**
  * 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>;
+export declare const getSkillsControllerGetByIdUrl: (id: string) => string;
 /**
  * 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>;
+export declare const getSkillsControllerUpdateUrl: (id: string) => string;
 /**
  * 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>;
+export declare const getSkillsControllerSearchUrl: () => string;
 /**
  * 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

@@ -2,10 +2,6 @@
 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]) => {
@@ -29,6 +25,10 @@ const getSkillsControllerListUrl = (params) => {
     return stringifiedParams.length > 0 ? `/skills?${stringifiedParams}` : `/skills`;
 };
 exports.getSkillsControllerListUrl = getSkillsControllerListUrl;
+/**
+ * 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 skillsControllerList = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerListUrl)(params), {
         ...options,
@@ -36,14 +36,14 @@ const skillsControllerList = async (params, options) => {
     });
 };
 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;
+/**
+ * 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 skillsControllerCreate = async (createSkillDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerCreateUrl)(), {
         ...options,
@@ -53,14 +53,14 @@ const skillsControllerCreate = async (createSkillDto, options) => {
     });
 };
 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;
+/**
+ * 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 skillsControllerTree = async (options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerTreeUrl)(), {
         ...options,
@@ -68,14 +68,14 @@ const skillsControllerTree = async (options) => {
     });
 };
 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;
+/**
+ * A flat catalog (slug, name, description, kind, category, tags) of every visible skill — the progressive-disclosure discovery surface.
+ * @summary OpenCode-compatible skill catalog.
+ */
 const skillsControllerRegistryJson = async (options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerRegistryJsonUrl)(), {
         ...options,
@@ -83,10 +83,6 @@ const skillsControllerRegistryJson = async (options) => {
     });
 };
 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]) => {
@@ -110,6 +106,10 @@ const getSkillsControllerLookupUrl = (params) => {
     return stringifiedParams.length > 0 ? `/skills/lookup?${stringifiedParams}` : `/skills/lookup`;
 };
 exports.getSkillsControllerLookupUrl = getSkillsControllerLookupUrl;
+/**
+ * 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 skillsControllerLookup = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerLookupUrl)(params), {
         ...options,
@@ -117,10 +117,6 @@ const skillsControllerLookup = async (params, options) => {
     });
 };
 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]) => {
@@ -144,6 +140,10 @@ const getSkillsControllerBundleUrl = (params) => {
     return stringifiedParams.length > 0 ? `/skills/bundle?${stringifiedParams}` : `/skills/bundle`;
 };
 exports.getSkillsControllerBundleUrl = getSkillsControllerBundleUrl;
+/**
+ * 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 skillsControllerBundle = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerBundleUrl)(params), {
         ...options,
@@ -151,14 +151,14 @@ const skillsControllerBundle = async (params, options) => {
     });
 };
 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;
+/**
+ * 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 skillsControllerAuthorBundle = async (createSkillBundleDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerAuthorBundleUrl)(), {
         ...options,
@@ -168,14 +168,14 @@ const skillsControllerAuthorBundle = async (createSkillBundleDto, options) => {
     });
 };
 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;
+/**
+ * Returns the skill including its current-version SKILL.md body.
+ * @summary Get a skill by id.
+ */
 const skillsControllerGetById = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerGetByIdUrl)(id), {
         ...options,
@@ -183,14 +183,14 @@ const skillsControllerGetById = async (id, options) => {
     });
 };
 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;
+/**
+ * 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 skillsControllerUpdate = async (id, updateSkillDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerUpdateUrl)(id), {
         ...options,
@@ -200,14 +200,14 @@ const skillsControllerUpdate = async (id, updateSkillDto, options) => {
     });
 };
 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;
+/**
+ * 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 skillsControllerSearch = async (searchSkillsQueryDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getSkillsControllerSearchUrl)(), {
         ...options,

package/dist/models/createSkillBundleDto.d.ts

@@ -1,12 +1,12 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * 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';
+import type { CreateSkillBundleResourceDto } from './createSkillBundleResourceDto.js';
+import type { SkillSpace } from './skillSpace.js';
 export interface CreateSkillBundleDto {
     /** Hierarchical slug, e.g. `software-engineering/requirements`. */
     slug: string;

package/dist/models/createSkillBundleResourceDto.d.ts

@@ -1,11 +1,11 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * 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';
+import type { SkillResourceType } from './skillResourceType.js';
 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;

package/dist/models/createSkillBundleResponseDto.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * Do not edit manually.
  * Skill Registry API
  * Skill-registry extract (generated for client codegen).

package/dist/models/createSkillBundleResponseDto.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.16.0 🍺
  * Do not edit manually.
  * Skill Registry API
  * Skill-registry extract (generated for client codegen).