@smithery/api 0.35.0 → 0.37.0

package/resources/skills/votes.mjs

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Votes extends APIResource {
+    /**
+     * Upvote or downvote a skill. Updates existing vote if one exists.
+     */
+    create(slug, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.post(path `/skills/${namespace}/${slug}/vote`, { body, ...options });
+    }
+    /**
+     * Remove vote from a skill
+     */
+    delete(slug, params, options) {
+        const { namespace } = params;
+        return this._client.delete(path `/skills/${namespace}/${slug}/vote`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get upvote/downvote counts and current user's vote (if authenticated)
+     */
+    get(slug, params, options) {
+        const { namespace } = params;
+        return this._client.get(path `/skills/${namespace}/${slug}/vote`, options);
+    }
+}
+//# sourceMappingURL=votes.mjs.map

package/resources/skills/votes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"votes.mjs","sourceRoot":"","sources":["../../src/resources/skills/votes.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAwB,EAAE,OAAwB;QACrE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAwB,EAAE,OAAwB;QACrE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,OAAO,EAAE;YAClE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,MAAqB,EAAE,OAAwB;QAC/D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/src/lib/mcp-transport.ts

@@ -60,6 +60,19 @@ export interface CreateConnectionOptions {
    * If connectionId is not provided, this is required.
    */
   mcpUrl?: string;
+
+  /**
+   * Enable MCP init/initialized handshake to receive server version info.
+   *
+   * When `false` (default), skips the handshake for faster connection.
+   * Smithery Connect is stateless, so the handshake is not required.
+   *
+   * Set to `true` if you need `client.getServerVersion()` or protocol
+   * version negotiation.
+   *
+   * @default false
+   */
+  handshake?: boolean;
 }
 
 export interface SmitheryConnection {
@@ -147,13 +160,19 @@ export async function createConnection(options: CreateConnectionOptions): Promis
   const url = new URL(`/connect/${namespace}/${connectionId}/mcp`, client.baseURL).href;
 
   // Create transport with auth headers
-  const transport = new StreamableHTTPClientTransport(new URL(url), {
+  // Skip MCP init handshake by default (stateless server).
+  // Setting sessionId tricks the SDK into thinking we're reconnecting.
+  const transportOptions = {
     requestInit: {
       headers: {
         Authorization: `Bearer ${client.apiKey}`,
       },
     },
-  });
+  };
+  const transport = new StreamableHTTPClientTransport(
+    new URL(url),
+    options.handshake ? transportOptions : { ...transportOptions, sessionId: 'smithery-stateless' },
+  );
 
   return { transport, connectionId, url };
 }

package/src/resources/experimental/connect/mcp.ts

@@ -7,8 +7,10 @@ import { path } from '../../../internal/utils/path';
 
 export class Mcp extends APIResource {
   /**
-   * Streamable HTTP MCP endpoint. Accepts JSON-RPC requests and notifications.
-   * Requires service token with mcp scope.
+   * Stateless MCP endpoint using Streamable HTTP transport. Accepts JSON-RPC
+   * requests and notifications. Session management is handled internally by
+   * Connect—clients should not send mcp-session-id headers. Requires service token
+   * with mcp scope.
    *
    * @example
    * ```ts

package/src/resources/skills/index.ts

@@ -5,10 +5,14 @@ export {
   type CreateReviewRequest,
   type CreateReviewResponse,
   type ReviewItem,
+  type ReviewVoteRequest,
+  type ReviewVoteResponse,
   type ReviewsListResponse,
   type ReviewCreateParams,
   type ReviewListParams,
   type ReviewDeleteParams,
+  type ReviewUnvoteParams,
+  type ReviewVoteParams,
   type ReviewItemsReviewsPage,
 } from './reviews';
 export {
@@ -19,3 +23,12 @@ export {
   type SkillGetParams,
   type SkillListResponsesSkillsPage,
 } from './skills';
+export {
+  Votes,
+  type SkillVoteCounts,
+  type SkillVoteRequest,
+  type SkillVoteResponse,
+  type VoteCreateParams,
+  type VoteDeleteParams,
+  type VoteGetParams,
+} from './votes';

package/src/resources/skills/reviews.ts

@@ -9,8 +9,7 @@ import { path } from '../../internal/utils/path';
 
 export class Reviews extends APIResource {
   /**
-   * Submit a review for a skill after using it. Updates existing review if one
-   * already exists.
+   * Submit a review for a skill. Updates existing review if one already exists.
    */
   create(
     slug: string,
@@ -22,7 +21,7 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Get paginated list of reviews for a skill with summary statistics
+   * Get paginated list of reviews with vote counts
    */
   list(
     slug: string,
@@ -37,7 +36,7 @@ export class Reviews extends APIResource {
   }
 
   /**
-   * Delete your own review for a skill
+   * Delete your review
    */
   delete(slug: string, params: ReviewDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { namespace } = params;
@@ -46,25 +45,42 @@ export class Reviews extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Remove vote from a review
+   */
+  unvote(reviewID: string, params: ReviewUnvoteParams, options?: RequestOptions): APIPromise<void> {
+    const { namespace, slug } = params;
+    return this._client.delete(path`/skills/${namespace}/${slug}/reviews/${reviewID}/vote`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Upvote or downvote a review. Updates existing vote if one exists.
+   */
+  vote(reviewID: string, params: ReviewVoteParams, options?: RequestOptions): APIPromise<ReviewVoteResponse> {
+    const { namespace, slug, ...body } = params;
+    return this._client.post(path`/skills/${namespace}/${slug}/reviews/${reviewID}/vote`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type ReviewItemsReviewsPage = ReviewsPage<ReviewItem>;
 
 export interface CreateReviewRequest {
   /**
-   * Rating from 1 to 5 stars
+   * Review text (required)
    */
-  rating: number;
+  review: string;
 
   /**
    * Optional agent model name (e.g., 'claude-3.5-sonnet')
    */
   agentModel?: string;
-
-  /**
-   * Optional review comment
-   */
-  comment?: string;
 }
 
 export interface CreateReviewResponse {
@@ -73,14 +89,12 @@ export interface CreateReviewResponse {
    */
   id: string;
 
-  comment: string | null;
-
   /**
    * ISO 8601 timestamp
    */
   createdAt: string;
 
-  rating: number;
+  review: string;
 }
 
 export interface ReviewItem {
@@ -90,58 +104,47 @@ export interface ReviewItem {
 
   agentModel: string | null;
 
-  comment: string | null;
-
   /**
    * ISO 8601 timestamp
    */
   createdAt: string;
 
-  rating: number;
+  downvotes: number;
+
+  review: string;
+
+  upvotes: number;
+}
+
+export interface ReviewVoteRequest {
+  /**
+   * true for thumbs up, false for thumbs down
+   */
+  isPositive: boolean;
+}
+
+export interface ReviewVoteResponse {
+  createdAt: string;
+
+  isPositive: boolean;
 }
 
 export interface ReviewsListResponse {
   pagination: ReviewsListResponse.Pagination;
 
   reviews: Array<ReviewItem>;
-
-  summary: ReviewsListResponse.Summary;
 }
 
 export namespace ReviewsListResponse {
   export interface Pagination {
-    /**
-     * Current page number (1-indexed)
-     */
     currentPage: number;
 
-    /**
-     * Number of results per page
-     */
     pageSize: number;
 
-    /**
-     * Total number of matching reviews
-     */
     totalCount: number;
 
-    /**
-     * Total number of pages available
-     */
     totalPages: number;
   }
-
-  export interface Summary {
-    /**
-     * Average rating across all reviews
-     */
-    averageRating: number;
-
-    /**
-     * Total number of reviews
-     */
-    totalReviews: number;
-  }
 }
 
 export interface ReviewCreateParams {
@@ -151,19 +154,14 @@ export interface ReviewCreateParams {
   namespace: string;
 
   /**
-   * Body param: Rating from 1 to 5 stars
+   * Body param: Review text (required)
    */
-  rating: number;
+  review: string;
 
   /**
    * Body param: Optional agent model name (e.g., 'claude-3.5-sonnet')
    */
   agentModel?: string;
-
-  /**
-   * Body param: Optional review comment
-   */
-  comment?: string;
 }
 
 export interface ReviewListParams extends ReviewsPageParams {
@@ -177,15 +175,42 @@ export interface ReviewDeleteParams {
   namespace: string;
 }
 
+export interface ReviewUnvoteParams {
+  namespace: string;
+
+  slug: string;
+}
+
+export interface ReviewVoteParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Path param
+   */
+  slug: string;
+
+  /**
+   * Body param: true for thumbs up, false for thumbs down
+   */
+  isPositive: boolean;
+}
+
 export declare namespace Reviews {
   export {
     type CreateReviewRequest as CreateReviewRequest,
     type CreateReviewResponse as CreateReviewResponse,
     type ReviewItem as ReviewItem,
+    type ReviewVoteRequest as ReviewVoteRequest,
+    type ReviewVoteResponse as ReviewVoteResponse,
     type ReviewsListResponse as ReviewsListResponse,
     type ReviewItemsReviewsPage as ReviewItemsReviewsPage,
     type ReviewCreateParams as ReviewCreateParams,
     type ReviewListParams as ReviewListParams,
     type ReviewDeleteParams as ReviewDeleteParams,
+    type ReviewUnvoteParams as ReviewUnvoteParams,
+    type ReviewVoteParams as ReviewVoteParams,
   };
 }

package/src/resources/skills/skills.ts

@@ -10,15 +10,30 @@ import {
   ReviewItem,
   ReviewItemsReviewsPage,
   ReviewListParams,
+  ReviewUnvoteParams,
+  ReviewVoteParams,
+  ReviewVoteRequest,
+  ReviewVoteResponse,
   Reviews,
   ReviewsListResponse,
 } from './reviews';
+import * as VotesAPI from './votes';
+import {
+  SkillVoteCounts,
+  SkillVoteRequest,
+  SkillVoteResponse,
+  VoteCreateParams,
+  VoteDeleteParams,
+  VoteGetParams,
+  Votes,
+} from './votes';
 import { APIPromise } from '../../core/api-promise';
 import { PagePromise, SkillsPage, type SkillsPageParams } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Skills extends APIResource {
+  votes: VotesAPI.Votes = new VotesAPI.Votes(this._client);
   reviews: ReviewsAPI.Reviews = new ReviewsAPI.Reviews(this._client);
 
   /**
@@ -194,6 +209,7 @@ export interface SkillGetParams {
   namespace: string;
 }
 
+Skills.Votes = Votes;
 Skills.Reviews = Reviews;
 
 export declare namespace Skills {
@@ -205,15 +221,29 @@ export declare namespace Skills {
     type SkillGetParams as SkillGetParams,
   };
 
+  export {
+    Votes as Votes,
+    type SkillVoteCounts as SkillVoteCounts,
+    type SkillVoteRequest as SkillVoteRequest,
+    type SkillVoteResponse as SkillVoteResponse,
+    type VoteCreateParams as VoteCreateParams,
+    type VoteDeleteParams as VoteDeleteParams,
+    type VoteGetParams as VoteGetParams,
+  };
+
   export {
     Reviews as Reviews,
     type CreateReviewRequest as CreateReviewRequest,
     type CreateReviewResponse as CreateReviewResponse,
     type ReviewItem as ReviewItem,
+    type ReviewVoteRequest as ReviewVoteRequest,
+    type ReviewVoteResponse as ReviewVoteResponse,
     type ReviewsListResponse as ReviewsListResponse,
     type ReviewItemsReviewsPage as ReviewItemsReviewsPage,
     type ReviewCreateParams as ReviewCreateParams,
     type ReviewListParams as ReviewListParams,
     type ReviewDeleteParams as ReviewDeleteParams,
+    type ReviewUnvoteParams as ReviewUnvoteParams,
+    type ReviewVoteParams as ReviewVoteParams,
   };
 }

package/src/resources/skills/votes.ts

@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Votes extends APIResource {
+  /**
+   * Upvote or downvote a skill. Updates existing vote if one exists.
+   */
+  create(slug: string, params: VoteCreateParams, options?: RequestOptions): APIPromise<SkillVoteResponse> {
+    const { namespace, ...body } = params;
+    return this._client.post(path`/skills/${namespace}/${slug}/vote`, { body, ...options });
+  }
+
+  /**
+   * Remove vote from a skill
+   */
+  delete(slug: string, params: VoteDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { namespace } = params;
+    return this._client.delete(path`/skills/${namespace}/${slug}/vote`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get upvote/downvote counts and current user's vote (if authenticated)
+   */
+  get(slug: string, params: VoteGetParams, options?: RequestOptions): APIPromise<SkillVoteCounts> {
+    const { namespace } = params;
+    return this._client.get(path`/skills/${namespace}/${slug}/vote`, options);
+  }
+}
+
+export interface SkillVoteCounts {
+  downvotes: number;
+
+  upvotes: number;
+
+  /**
+   * Current user's vote, null if not voted
+   */
+  userVote: boolean | null;
+}
+
+export interface SkillVoteRequest {
+  /**
+   * true for thumbs up, false for thumbs down
+   */
+  isPositive: boolean;
+}
+
+export interface SkillVoteResponse {
+  createdAt: string;
+
+  isPositive: boolean;
+}
+
+export interface VoteCreateParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Body param: true for thumbs up, false for thumbs down
+   */
+  isPositive: boolean;
+}
+
+export interface VoteDeleteParams {
+  namespace: string;
+}
+
+export interface VoteGetParams {
+  namespace: string;
+}
+
+export declare namespace Votes {
+  export {
+    type SkillVoteCounts as SkillVoteCounts,
+    type SkillVoteRequest as SkillVoteRequest,
+    type SkillVoteResponse as SkillVoteResponse,
+    type VoteCreateParams as VoteCreateParams,
+    type VoteDeleteParams as VoteDeleteParams,
+    type VoteGetParams as VoteGetParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.35.0'; // x-release-please-version
+export const VERSION = '0.37.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.35.0";
+export declare const VERSION = "0.37.0";
 //# 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.35.0'; // x-release-please-version
+exports.VERSION = '0.37.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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