@smithery/api 0.55.0 → 0.56.1

package/src/resources/skills/reviews.ts

@@ -12,7 +12,10 @@ import { path } from '../../internal/utils/path';
  */
 export class Reviews extends APIResource {
   /**
-   * Submit a review for a skill. Updates existing review if one already exists.
+   * Deprecated (SMI-1505). Submit a review for a skill. Updates existing review if
+   * one already exists.
+   *
+   * @deprecated
    */
   create(
     slug: string,
@@ -24,7 +27,9 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Get paginated list of reviews with vote counts
+   * Deprecated (SMI-1505). Get paginated list of reviews with vote counts.
+   *
+   * @deprecated
    */
   list(
     slug: string,
@@ -39,7 +44,9 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Delete your review
+   * [Deprecated] Delete your review
+   *
+   * @deprecated
    */
   delete(slug: string, params: ReviewDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { namespace } = params;
@@ -50,7 +57,9 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Remove vote from a review
+   * [Deprecated] Remove vote from a review
+   *
+   * @deprecated
    */
   unvote(reviewID: string, params: ReviewUnvoteParams, options?: RequestOptions): APIPromise<void> {
     const { namespace, slug } = params;
@@ -61,7 +70,10 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Upvote or downvote a review. Updates existing vote if one exists.
+   * Deprecated (SMI-1505). Upvote or downvote a review. Updates existing vote if one
+   * exists.
+   *
+   * @deprecated
    */
   vote(reviewID: string, params: ReviewVoteParams, options?: RequestOptions): APIPromise<ReviewVoteResponse> {
     const { namespace, slug, ...body } = params;

package/src/resources/skills/skills.ts

@@ -31,8 +31,10 @@ import {
 } from './votes';
 import { APIPromise } from '../../core/api-promise';
 import { PagePromise, SkillsPage, type SkillsPageParams } from '../../core/pagination';
+import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
 /**
@@ -72,8 +74,7 @@ export class Skills extends APIResource {
   }
 
   /**
-   * Download a ZIP bundle containing all skill files, fetched via well-known
-   * endpoints.
+   * Download a ZIP bundle containing all skill files.
    */
   download(slug: string, params: SkillDownloadParams, options?: RequestOptions): APIPromise<Response> {
     const { namespace } = params;
@@ -93,13 +94,12 @@ export class Skills extends APIResource {
   }
 
   /**
-   * Idempotent endpoint to create or sync a skill. If the skill does not exist,
-   * creates it. If it exists, updates displayName, description, and externalStars
-   * from GitHub.
+   * Idempotent endpoint to create or update a GitHub-backed skill. Send
+   * application/json with `gitUrl`.
    */
   set(slug: string, params: SkillSetParams, options?: RequestOptions): APIPromise<SkillSetResponse> {
-    const { namespace, ...body } = params;
-    return this._client.put(path`/skills/${namespace}/${slug}`, { body, ...options });
+    const { namespace, body } = params;
+    return this._client.put(path`/skills/${namespace}/${slug}`, { body: body, ...options });
   }
 
   /**
@@ -112,6 +112,17 @@ export class Skills extends APIResource {
     const { namespace } = params;
     return this._client.post(path`/skills/${namespace}/${slug}/sync`, options);
   }
+
+  /**
+   * Upload or replace a skill bundle via multipart/form-data with an `archive` file.
+   */
+  upload(slug: string, params: SkillUploadParams, options?: RequestOptions): APIPromise<SkillUploadResponse> {
+    const { namespace, ...body } = params;
+    return this._client.put(
+      path`/skills/${namespace}/${slug}/upload`,
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
 }
 
 export type SkillListResponsesSkillsPage = SkillsPage<SkillListResponse>;
@@ -199,7 +210,7 @@ export interface SkillListResponse {
   /**
    * URL to the skill's source repository.
    */
-  gitUrl?: string;
+  gitUrl?: string | null;
 
   /**
    * Number of reviews for this skill.
@@ -250,7 +261,7 @@ export interface SkillGetResponse {
 
   externalStars: number;
 
-  gitUrl: string;
+  gitUrl: string | null;
 
   listed: boolean;
 
@@ -294,7 +305,7 @@ export interface SkillSetResponse {
 
   externalStars: number;
 
-  gitUrl: string;
+  gitUrl: string | null;
 
   listed: boolean;
 
@@ -323,6 +334,28 @@ export interface SkillSyncResponse {
   updatedAt: string;
 }
 
+export interface SkillUploadResponse {
+  id: string;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  externalStars: number;
+
+  gitUrl: string | null;
+
+  listed: boolean;
+
+  namespace: string;
+
+  slug: string;
+
+  updatedAt: string;
+}
+
 export interface SkillCreateParams {
   /**
    * GitHub URL pointing to a repository with SKILL.md
@@ -404,15 +437,28 @@ export interface SkillSetParams {
   namespace: string;
 
   /**
-   * Body param: GitHub URL pointing to a repository with SKILL.md
+   * Body param
    */
-  gitUrl: string;
+  body: unknown;
 }
 
 export interface SkillSyncParams {
   namespace: string;
 }
 
+export interface SkillUploadParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Body param: ZIP file upload containing a skill folder with SKILL.md and any
+   * scripts, references, or assets.
+   */
+  archive: Uploadable;
+}
+
 Skills.Votes = Votes;
 Skills.Reviews = Reviews;
 
@@ -424,6 +470,7 @@ export declare namespace Skills {
     type SkillGetResponse as SkillGetResponse,
     type SkillSetResponse as SkillSetResponse,
     type SkillSyncResponse as SkillSyncResponse,
+    type SkillUploadResponse as SkillUploadResponse,
     type SkillListResponsesSkillsPage as SkillListResponsesSkillsPage,
     type SkillCreateParams as SkillCreateParams,
     type SkillListParams as SkillListParams,
@@ -432,6 +479,7 @@ export declare namespace Skills {
     type SkillGetParams as SkillGetParams,
     type SkillSetParams as SkillSetParams,
     type SkillSyncParams as SkillSyncParams,
+    type SkillUploadParams as SkillUploadParams,
   };
 
   export {

package/src/resources/skills/votes.ts

@@ -11,7 +11,10 @@ import { path } from '../../internal/utils/path';
  */
 export class Votes extends APIResource {
   /**
-   * Upvote or downvote a skill. Updates existing vote if one exists.
+   * Deprecated (SMI-1505). Upvote or downvote a skill. Updates existing vote if one
+   * exists.
+   *
+   * @deprecated
    */
   create(slug: string, params: VoteCreateParams, options?: RequestOptions): APIPromise<SkillVoteResponse> {
     const { namespace, ...body } = params;
@@ -19,7 +22,9 @@ export class Votes extends APIResource {
   }
 
   /**
-   * Remove vote from a skill
+   * [Deprecated] Remove vote from a skill
+   *
+   * @deprecated
    */
   delete(slug: string, params: VoteDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { namespace } = params;
@@ -30,7 +35,10 @@ export class Votes extends APIResource {
   }
 
   /**
-   * Get upvote/downvote counts and current user's vote (if authenticated)
+   * Deprecated (SMI-1505). Get upvote/downvote counts and current user's vote (if
+   * authenticated).
+   *
+   * @deprecated
    */
   get(slug: string, params: VoteGetParams, options?: RequestOptions): APIPromise<SkillVoteCounts> {
     const { namespace } = params;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.55.0'; // x-release-please-version
+export const VERSION = '0.56.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.55.0";
+export declare const VERSION = "0.56.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.55.0";
+export declare const VERSION = "0.56.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.55.0'; // x-release-please-version
+exports.VERSION = '0.56.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.55.0'; // x-release-please-version
+export const VERSION = '0.56.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map