@renai-labs/sdk 0.1.20 → 0.1.21

package/dist/generated/sdk.gen.js

@@ -1423,6 +1423,14 @@ export class Skill extends HeyApiClient {
             },
         });
     }
+    /**
+     * Resolve the one version served per skill in this project, with pin-conflict warnings
+     *
+     * The server resolves one version per skill per project — highest live version wins (decision 5). When a bound pin loses, it is reported here as a warning (never an error at bind time): a pin can lose later when someone publishes a newer version, so there is no request to reject at that moment.
+     */
+    resolution(options) {
+        return (options.client ?? this.client).get({ url: "/api/projects/{id}/skills/resolution", ...options });
+    }
     /**
      * Detach a skill from a project
      */
@@ -1858,6 +1866,8 @@ export class Session extends HeyApiClient {
 export class Version2 extends HeyApiClient {
     /**
      * List skill versions
+     *
+     * Git-backed skills are versionless (GitHub owns their history) but expose one pointer row holding the git source; its version string is a placeholder, not a commit SHA.
      */
     list(options) {
         return (options.client ?? this.client).get({
@@ -1870,11 +1880,10 @@ export class Version2 extends HeyApiClient {
      */
     create(options) {
         return (options.client ?? this.client).post({
-            ...formDataBodySerializer,
             url: "/api/skills/{id}/versions",
             ...options,
             headers: {
-                "Content-Type": null,
+                "Content-Type": "application/json",
                 ...options.headers,
             },
         });
@@ -1909,7 +1918,7 @@ export class Version2 extends HeyApiClient {
 }
 export class Skill2 extends HeyApiClient {
     /**
-     * List skills
+     * List and search skills
      */
     list(options) {
         return (options?.client ?? this.client).get({
@@ -1921,22 +1930,8 @@ export class Skill2 extends HeyApiClient {
      * Create a skill
      */
     create(options) {
-        return (options.client ?? this.client).post({
-            ...formDataBodySerializer,
-            url: "/api/skills",
-            ...options,
-            headers: {
-                "Content-Type": null,
-                ...options.headers,
-            },
-        });
-    }
-    /**
-     * Search skills across private, org, and published tiers
-     */
-    search(options) {
         return (options?.client ?? this.client).post({
-            url: "/api/skills/search",
+            url: "/api/skills",
             ...options,
             headers: {
                 "Content-Type": "application/json",
@@ -1945,20 +1940,11 @@ export class Skill2 extends HeyApiClient {
         });
     }
     /**
-     * Get a skill by slug
-     */
-    getBySlug(options) {
-        return (options.client ?? this.client).get({
-            url: "/api/skills/slug/{slug}",
-            ...options,
-        });
-    }
-    /**
-     * Get a skill
+     * Get a skill by ID or slug
      */
     get(options) {
         return (options.client ?? this.client).get({
-            url: "/api/skills/{id}",
+            url: "/api/skills/{idOrSlug}",
             ...options,
         });
     }
@@ -1986,6 +1972,8 @@ export class Skill2 extends HeyApiClient {
     }
     /**
      * Publish a skill
+     *
+     * Publishing changes copyability (the skill enters the registry), not materialisation: it does NOT fan out to sandboxes. A git-backed skill's repository must be publicly cloneable (decision 11).
      */
     publish(options) {
         return (options.client ?? this.client).post({
@@ -1995,6 +1983,8 @@ export class Skill2 extends HeyApiClient {
     }
     /**
      * Deprecate a skill
+     *
+     * Deprecation is an adoption signal only — it does NOT affect materialisation: sandboxes already tracking the skill keep receiving it. Use archive to remove a skill from sandboxes.
      */
     deprecate(options) {
         return (options.client ?? this.client).post({

package/dist/generated/types.gen.d.ts

@@ -835,6 +835,22 @@ export type Topology = {
         address: string;
     }>;
 };
+export type SkillVersionFiles = {
+    /**
+     * Discriminant: this version is file-backed and returns its files inline.
+     */
+    type: "files";
+    files: Array<{
+        /**
+         * Relative path within the skill folder.
+         */
+        path: string;
+        /**
+         * Base64-encoded file bytes. Decode to reconstruct the exact file.
+         */
+        contentBase64: string;
+    }>;
+};
 export type SkillVersion = {
     id: string;
     skillId: string;
@@ -844,16 +860,54 @@ export type SkillVersion = {
     archivedAt: string | null;
     source: {
         type: "s3";
-        url: string;
+        /**
+         * S3 object-key prefix holding the version's files, one object per file at `${key}/${path}`. The prefix is stored (not a full URL) so a storage-endpoint change never breaks a stored skill; presigned URLs are built at read time (decision 12, Materialise fix #5).
+         */
+        key: string;
     } | {
         type: "git";
+        /**
+         * HTTPS git repository URL (https:// only). Public repos are cloned directly; private repos use the org's GitHub installation.
+         */
         url: string;
+        /**
+         * Branch, tag, or commit to mirror. Omitted = the remote's default branch (HEAD). Floating refs are re-resolved at index build time.
+         */
         ref?: string;
+        /**
+         * Subdirectory containing SKILL.md, relative to the repo root. No leading slash or '..' segments.
+         */
         path?: string;
     };
     requiredCredentials: Array<RequiredCredential>;
     releaseNotes: string | null;
-    contentHash: string | null;
+};
+export type SkillArchiveResult = {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    icon: string | null;
+    docUrl: string | null;
+    repository: Repository | null;
+    orgId: string;
+    userId: string | null;
+    publisherId: string | null;
+    parentId: string | null;
+    websiteMetadata: WebsiteMetadata | null;
+    sortOrder: number | null;
+    popularityScore: number | null;
+    trendingScore: number | null;
+    rank: number | null;
+    latestVersionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+    deprecatedAt: string | null;
+    deprecationMessage: string | null;
+    tags?: Array<string>;
+    agentCount: number;
+    projectCount: number;
 };
 export type Skill = {
     id: string;
@@ -1059,6 +1113,45 @@ export type ProjectMcp = {
     createdAt: string;
     updatedAt: string;
 };
+export type ProjectSkillResolution = {
+    /**
+     * One resolved version per attached skill (highest live version wins).
+     */
+    skills: Array<{
+        skillId: string;
+        skillSlug: string;
+        /**
+         * The one version served for this skill in this project.
+         */
+        effectiveVersionId: string;
+        /**
+         * Its version string: semver for file-backed skills; for git-backed skills this is the pointer row's placeholder version — the mirror commit SHA appears in the serving menu, not here.
+         */
+        effectiveVersion: string;
+    }>;
+    /**
+     * Warnings where a bound pin lost. Warning-only: a pin can lose later when a newer version is published.
+     */
+    conflicts: Array<SkillPinConflict>;
+};
+export type SkillPinConflict = {
+    /**
+     * Slug of the skill whose pin lost.
+     */
+    skillSlug: string;
+    /**
+     * The bound (pinned) version that did not win.
+     */
+    pinnedVersion: string;
+    /**
+     * The version actually served for this skill in this project.
+     */
+    effectiveVersion: string;
+    /**
+     * `outranked`: a higher live version won. `pin-archived`: the pin was archived; latest served.
+     */
+    reason: "outranked" | "pin-archived";
+};
 export type ProjectSkill = {
     id: string;
     projectId: string;
@@ -7041,6 +7134,9 @@ export type ProjectSkillListResponse = ProjectSkillListResponses[keyof ProjectSk
 export type ProjectSkillAddData = {
     body?: {
         skillId: string;
+        /**
+         * Pin to a specific version, or null to track the latest live version (highest wins) for this skill.
+         */
         skillVersionId?: string | null;
     };
     path: {
@@ -7083,6 +7179,42 @@ export type ProjectSkillAddResponses = {
     200: ProjectSkill;
 };
 export type ProjectSkillAddResponse = ProjectSkillAddResponses[keyof ProjectSkillAddResponses];
+export type ProjectSkillResolutionData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: "/api/projects/{id}/skills/resolution";
+};
+export type ProjectSkillResolutionErrors = {
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+    /**
+     * Not found
+     */
+    404: {
+        error: string;
+    };
+};
+export type ProjectSkillResolutionError = ProjectSkillResolutionErrors[keyof ProjectSkillResolutionErrors];
+export type ProjectSkillResolutionResponses = {
+    /**
+     * Effective versions and pin-conflict warnings
+     */
+    200: ProjectSkillResolution;
+};
+export type ProjectSkillResolutionResponse = ProjectSkillResolutionResponses[keyof ProjectSkillResolutionResponses];
 export type ProjectSkillRemoveData = {
     body?: never;
     path: {
@@ -8313,7 +8445,26 @@ export type SkillListData = {
         offset?: number;
         includeDeprecated?: boolean;
         sort?: "popular" | "trending" | "recent";
+        /**
+         * Restrict to a single visibility tier within the caller's scope.
+         */
         visibility?: "private" | "org";
+        /**
+         * Case-insensitive match across name, slug, and description.
+         */
+        query?: string;
+        /**
+         * true = only published (registry) skills; false = only unpublished.
+         */
+        published?: boolean;
+        /**
+         * Restrict to skills carried by a specific publisher.
+         */
+        publisherId?: string;
+        /**
+         * Only skills carrying every one of these tags. Repeat the param for multiple tags.
+         */
+        tagged?: string | Array<string>;
     };
     url: "/api/skills";
 };
@@ -8340,26 +8491,53 @@ export type SkillListResponses = {
 };
 export type SkillListResponse = SkillListResponses[keyof SkillListResponses];
 export type SkillCreateData = {
-    body: {
+    body?: {
         slug?: string;
-        name: string;
-        description?: string;
-        icon?: string;
         /**
-         * JSON-encoded string array
+         * Overrides the name declared in SKILL.md.
          */
-        tags?: string;
+        nameOverride?: string;
         /**
-         * JSON-encoded RequiredCredential[]
+         * Overrides the description declared in SKILL.md.
          */
-        requiredCredentials?: string;
+        descriptionOverride?: string;
+        icon?: string | null;
+        docUrl?: string | null;
+        repository?: Repository | null;
+        websiteMetadata?: WebsiteMetadata | null;
+        version?: string;
         releaseNotes?: string;
+        requiredCredentials?: Array<RequiredCredential>;
+        tags?: Array<string>;
         /**
-         * JSON-encoded GitSource
+         * Skill folder as base64-encoded files. A root SKILL.md is required. Total decoded size max 10 MB.
          */
-        source?: string;
+        files?: Array<{
+            /**
+             * Relative path within the skill folder. No leading slash or '..' segments.
+             */
+            path: string;
+            /**
+             * Base64-encoded file bytes. Per-file decoded size max 10 MB.
+             */
+            contentBase64: string;
+        }>;
+        source?: {
+            type: "git";
+            /**
+             * HTTPS git repository URL (https:// only). Public repos are cloned directly; private repos use the org's GitHub installation.
+             */
+            url: string;
+            /**
+             * Branch, tag, or commit to mirror. Omitted = the remote's default branch (HEAD). Floating refs are re-resolved at index build time.
+             */
+            ref?: string;
+            /**
+             * Subdirectory containing SKILL.md, relative to the repo root. No leading slash or '..' segments.
+             */
+            path?: string;
+        };
         visibility?: "private" | "org";
-        files: Array<Blob | File>;
     };
     path?: never;
     query?: never;
@@ -8384,99 +8562,28 @@ export type SkillCreateErrors = {
     403: {
         error: string;
     };
-};
-export type SkillCreateError = SkillCreateErrors[keyof SkillCreateErrors];
-export type SkillCreateResponses = {
-    /**
-     * Created skill
-     */
-    200: Skill;
-};
-export type SkillCreateResponse = SkillCreateResponses[keyof SkillCreateResponses];
-export type SkillSearchData = {
-    body?: {
-        query?: string;
-        sources?: Array<"user" | "org" | "registry">;
-        limit?: number;
-    };
-    path?: never;
-    query?: never;
-    url: "/api/skills/search";
-};
-export type SkillSearchErrors = {
-    /**
-     * Bad request
-     */
-    400: {
-        error: string;
-    };
-    /**
-     * Unauthorized
-     */
-    401: {
-        error: string;
-    };
-    /**
-     * Forbidden
-     */
-    403: {
-        error: string;
-    };
-};
-export type SkillSearchError = SkillSearchErrors[keyof SkillSearchErrors];
-export type SkillSearchResponses = {
     /**
-     * Matching skills
-     */
-    200: Array<SearchResult>;
-};
-export type SkillSearchResponse = SkillSearchResponses[keyof SkillSearchResponses];
-export type SkillGetBySlugData = {
-    body?: never;
-    path: {
-        /**
-         * URL-friendly identifier
-         */
-        slug: string;
-    };
-    query?: never;
-    url: "/api/skills/slug/{slug}";
-};
-export type SkillGetBySlugErrors = {
-    /**
-     * Unauthorized
-     */
-    401: {
-        error: string;
-    };
-    /**
-     * Forbidden
-     */
-    403: {
-        error: string;
-    };
-    /**
-     * Not found
+     * Conflict
      */
-    404: {
+    409: {
         error: string;
     };
 };
-export type SkillGetBySlugError = SkillGetBySlugErrors[keyof SkillGetBySlugErrors];
-export type SkillGetBySlugResponses = {
+export type SkillCreateError = SkillCreateErrors[keyof SkillCreateErrors];
+export type SkillCreateResponses = {
     /**
-     * Skill details
+     * Created skill
      */
     200: Skill;
 };
-export type SkillGetBySlugResponse = SkillGetBySlugResponses[keyof SkillGetBySlugResponses];
+export type SkillCreateResponse = SkillCreateResponses[keyof SkillCreateResponses];
 export type SkillGetData = {
     body?: never;
     path: {
-        id: string;
+        idOrSlug: string | string;
     };
     query?: never;
-    url: "/api/skills/{id}";
+    url: "/api/skills/{idOrSlug}";
 };
 export type SkillGetErrors = {
     /**
@@ -8508,8 +8615,14 @@ export type SkillGetResponses = {
 export type SkillGetResponse = SkillGetResponses[keyof SkillGetResponses];
 export type SkillUpdateData = {
     body?: {
+        /**
+         * Registry display name. Editing it does not change any version's SKILL.md.
+         */
         name?: string;
-        description?: string | null;
+        /**
+         * Registry description. Editing it does not change any version's SKILL.md.
+         */
+        description?: string;
         icon?: string | null;
         docUrl?: string | null;
         repository?: Repository | null;
@@ -8587,9 +8700,9 @@ export type SkillArchiveErrors = {
 export type SkillArchiveError = SkillArchiveErrors[keyof SkillArchiveErrors];
 export type SkillArchiveResponses = {
     /**
-     * Archived skill
+     * Archived skill with the blast radius of agents and projects that referenced it
      */
-    200: Skill;
+    200: SkillArchiveResult;
 };
 export type SkillArchiveResponse = SkillArchiveResponses[keyof SkillArchiveResponses];
 export type SkillPublishData = {
@@ -8601,6 +8714,12 @@ export type SkillPublishData = {
     url: "/api/skills/{id}/publish";
 };
 export type SkillPublishErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        error: string;
+    };
     /**
      * Unauthorized
      */
@@ -8619,6 +8738,12 @@ export type SkillPublishErrors = {
     404: {
         error: string;
     };
+    /**
+     * Conflict
+     */
+    409: {
+        error: string;
+    };
 };
 export type SkillPublishError = SkillPublishErrors[keyof SkillPublishErrors];
 export type SkillPublishResponses = {
@@ -8739,6 +8864,12 @@ export type SkillCopyErrors = {
     404: {
         error: string;
     };
+    /**
+     * Conflict
+     */
+    409: {
+        error: string;
+    };
 };
 export type SkillCopyError = SkillCopyErrors[keyof SkillCopyErrors];
 export type SkillCopyResponses = {
@@ -8837,21 +8968,41 @@ export type SkillVersionListResponses = {
 };
 export type SkillVersionListResponse = SkillVersionListResponses[keyof SkillVersionListResponses];
 export type SkillVersionCreateData = {
-    body: {
+    body?: {
         /**
-         * Semver string or 'major' | 'minor' | 'patch'
+         * Either an explicit semver string (e.g. "1.2.0") or a bump keyword ("major" | "minor" | "patch") applied to the latest live version.
          */
-        version?: string;
+        version?: string | "major" | "minor" | "patch";
         releaseNotes?: string;
+        requiredCredentials?: Array<RequiredCredential>;
         /**
-         * JSON-encoded RequiredCredential[]
-         */
-        requiredCredentials?: string;
-        /**
-         * JSON-encoded GitSource
+         * Skill folder as base64-encoded files. A root SKILL.md is required. Total decoded size max 10 MB.
          */
-        source?: string;
-        files: Array<Blob | File>;
+        files?: Array<{
+            /**
+             * Relative path within the skill folder. No leading slash or '..' segments.
+             */
+            path: string;
+            /**
+             * Base64-encoded file bytes. Per-file decoded size max 10 MB.
+             */
+            contentBase64: string;
+        }>;
+        source?: {
+            type: "git";
+            /**
+             * HTTPS git repository URL (https:// only). Public repos are cloned directly; private repos use the org's GitHub installation.
+             */
+            url: string;
+            /**
+             * Branch, tag, or commit to mirror. Omitted = the remote's default branch (HEAD). Floating refs are re-resolved at index build time.
+             */
+            ref?: string;
+            /**
+             * Subdirectory containing SKILL.md, relative to the repo root. No leading slash or '..' segments.
+             */
+            path?: string;
+        };
     };
     path: {
         id: string;
@@ -8942,9 +9093,7 @@ export type SkillVersionDataData = {
         id: string;
         version: string;
     };
-    query?: {
-        format?: "json" | "presigned";
-    };
+    query?: never;
     url: "/api/skills/{id}/versions/{version}/data";
 };
 export type SkillVersionDataErrors = {
@@ -8970,19 +9119,21 @@ export type SkillVersionDataErrors = {
 export type SkillVersionDataError = SkillVersionDataErrors[keyof SkillVersionDataErrors];
 export type SkillVersionDataResponses = {
     /**
-     * Extracted files, presigned URL, or git source descriptor
+     * One shape per skill kind: file-backed versions return their files base64-encoded (binary-safe); git-backed versions return the git source pointer verbatim (Read fix #1).
      */
-    200: {
-        files: Array<{
-            path: string;
-            content: string;
-        }>;
-    } | {
-        url: string;
-    } | {
+    200: SkillVersionFiles | {
         type: "git";
+        /**
+         * HTTPS git repository URL (https:// only). Public repos are cloned directly; private repos use the org's GitHub installation.
+         */
         url: string;
+        /**
+         * Branch, tag, or commit to mirror. Omitted = the remote's default branch (HEAD). Floating refs are re-resolved at index build time.
+         */
         ref?: string;
+        /**
+         * Subdirectory containing SKILL.md, relative to the repo root. No leading slash or '..' segments.
+         */
         path?: string;
     };
 };