@smithery/api 0.34.0 → 0.35.0

package/src/resources/skills/reviews.ts

@@ -0,0 +1,191 @@
+// 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 { PagePromise, ReviewsPage, type ReviewsPageParams } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+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.
+   */
+  create(
+    slug: string,
+    params: ReviewCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<CreateReviewResponse> {
+    const { namespace, ...body } = params;
+    return this._client.post(path`/skills/${namespace}/${slug}/reviews`, { body, ...options });
+  }
+
+  /**
+   * Get paginated list of reviews for a skill with summary statistics
+   */
+  list(
+    slug: string,
+    params: ReviewListParams,
+    options?: RequestOptions,
+  ): PagePromise<ReviewItemsReviewsPage, ReviewItem> {
+    const { namespace, ...query } = params;
+    return this._client.getAPIList(path`/skills/${namespace}/${slug}/reviews`, ReviewsPage<ReviewItem>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete your own review for a skill
+   */
+  delete(slug: string, params: ReviewDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { namespace } = params;
+    return this._client.delete(path`/skills/${namespace}/${slug}/reviews`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type ReviewItemsReviewsPage = ReviewsPage<ReviewItem>;
+
+export interface CreateReviewRequest {
+  /**
+   * Rating from 1 to 5 stars
+   */
+  rating: number;
+
+  /**
+   * Optional agent model name (e.g., 'claude-3.5-sonnet')
+   */
+  agentModel?: string;
+
+  /**
+   * Optional review comment
+   */
+  comment?: string;
+}
+
+export interface CreateReviewResponse {
+  /**
+   * Review ID
+   */
+  id: string;
+
+  comment: string | null;
+
+  /**
+   * ISO 8601 timestamp
+   */
+  createdAt: string;
+
+  rating: number;
+}
+
+export interface ReviewItem {
+  id: string;
+
+  agentClient: string | null;
+
+  agentModel: string | null;
+
+  comment: string | null;
+
+  /**
+   * ISO 8601 timestamp
+   */
+  createdAt: string;
+
+  rating: number;
+}
+
+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 {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Body param: Rating from 1 to 5 stars
+   */
+  rating: number;
+
+  /**
+   * 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 {
+  /**
+   * Path param
+   */
+  namespace: string;
+}
+
+export interface ReviewDeleteParams {
+  namespace: string;
+}
+
+export declare namespace Reviews {
+  export {
+    type CreateReviewRequest as CreateReviewRequest,
+    type CreateReviewResponse as CreateReviewResponse,
+    type ReviewItem as ReviewItem,
+    type ReviewsListResponse as ReviewsListResponse,
+    type ReviewItemsReviewsPage as ReviewItemsReviewsPage,
+    type ReviewCreateParams as ReviewCreateParams,
+    type ReviewListParams as ReviewListParams,
+    type ReviewDeleteParams as ReviewDeleteParams,
+  };
+}

package/src/resources/skills/skills.ts

@@ -0,0 +1,219 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ReviewsAPI from './reviews';
+import {
+  CreateReviewRequest,
+  CreateReviewResponse,
+  ReviewCreateParams,
+  ReviewDeleteParams,
+  ReviewItem,
+  ReviewItemsReviewsPage,
+  ReviewListParams,
+  Reviews,
+  ReviewsListResponse,
+} from './reviews';
+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 {
+  reviews: ReviewsAPI.Reviews = new ReviewsAPI.Reviews(this._client);
+
+  /**
+   * Search and browse reusable prompt-based skills. Supports full-text and semantic
+   * search via the `q` parameter, and filtering by category, namespace, or slug.
+   */
+  list(
+    query: SkillListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<SkillListResponsesSkillsPage, SkillListResponse> {
+    return this._client.getAPIList('/skills', SkillsPage<SkillListResponse>, { query, ...options });
+  }
+
+  /**
+   * Get a single skill by its namespace and slug.
+   */
+  get(slug: string, params: SkillGetParams, options?: RequestOptions): APIPromise<SkillGetResponse> {
+    const { namespace } = params;
+    return this._client.get(path`/skills/${namespace}/${slug}`, options);
+  }
+}
+
+export type SkillListResponsesSkillsPage = SkillsPage<SkillListResponse>;
+
+export interface SkillListResponse {
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was created.
+   */
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  /**
+   * Whether this skill is publicly listed in the registry.
+   */
+  listed: boolean;
+
+  /**
+   * Namespace that owns this skill.
+   */
+  namespace: string;
+
+  /**
+   * The prompt template for this skill, or null if not publicly visible.
+   */
+  prompt: string | null;
+
+  /**
+   * Computed quality score from 0 to 1.
+   */
+  qualityScore: number;
+
+  /**
+   * URL-friendly short name within the namespace.
+   */
+  slug: string;
+
+  /**
+   * List of categories this skill belongs to.
+   */
+  categories?: Array<string>;
+
+  /**
+   * GitHub fork count of the source repository, if applicable.
+   */
+  externalForks?: number;
+
+  /**
+   * GitHub star count of the source repository, if applicable.
+   */
+  externalStars?: number;
+
+  /**
+   * URL to the skill's source repository.
+   */
+  gitUrl?: string;
+
+  /**
+   * Qualified names of MCP servers this skill depends on.
+   */
+  servers?: Array<string>;
+
+  /**
+   * Total number of times this skill has been activated.
+   */
+  totalActivations?: number;
+
+  /**
+   * Number of distinct users who have activated this skill.
+   */
+  uniqueUsers?: number;
+}
+
+export interface SkillGetResponse {
+  id: string;
+
+  categories: Array<string>;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  externalForks: number;
+
+  externalStars: number;
+
+  gitUrl: string;
+
+  listed: boolean;
+
+  namespace: string;
+
+  prompt: string;
+
+  qualityScore: number;
+
+  servers: Array<string>;
+
+  slug: string;
+
+  totalActivations: number;
+
+  uniqueUsers: number;
+}
+
+export interface SkillListParams extends SkillsPageParams {
+  /**
+   * Filter by skill category (e.g. 'code', 'data', 'web').
+   */
+  category?: string;
+
+  /**
+   * Comma-separated list of fields to include in response
+   */
+  fields?: string;
+
+  /**
+   * Filter by the namespace that owns the skill.
+   */
+  namespace?: string;
+
+  /**
+   * Filter by the skill owner's user ID.
+   */
+  ownerId?: string;
+
+  /**
+   * Search query for full-text and semantic search across skill names and
+   * descriptions.
+   */
+  q?: string;
+
+  /**
+   * Filter by exact skill slug within a namespace. Deprecated: use GET
+   * /skills/:namespace/:slug instead.
+   */
+  slug?: string;
+
+  /**
+   * Maximum number of candidate results to consider from the search index before
+   * pagination.
+   */
+  topK?: number;
+}
+
+export interface SkillGetParams {
+  namespace: string;
+}
+
+Skills.Reviews = Reviews;
+
+export declare namespace Skills {
+  export {
+    type SkillListResponse as SkillListResponse,
+    type SkillGetResponse as SkillGetResponse,
+    type SkillListResponsesSkillsPage as SkillListResponsesSkillsPage,
+    type SkillListParams as SkillListParams,
+    type SkillGetParams as SkillGetParams,
+  };
+
+  export {
+    Reviews as Reviews,
+    type CreateReviewRequest as CreateReviewRequest,
+    type CreateReviewResponse as CreateReviewResponse,
+    type ReviewItem as ReviewItem,
+    type ReviewsListResponse as ReviewsListResponse,
+    type ReviewItemsReviewsPage as ReviewItemsReviewsPage,
+    type ReviewCreateParams as ReviewCreateParams,
+    type ReviewListParams as ReviewListParams,
+    type ReviewDeleteParams as ReviewDeleteParams,
+  };
+}

package/src/resources/skills.ts

@@ -1,74 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import { PagePromise, SkillsPage, type SkillsPageParams } from '../core/pagination';
-import { RequestOptions } from '../internal/request-options';
-
-export class Skills extends APIResource {
-  /**
-   * Get a paginated list of skills. When q parameter is provided, uses hybrid BM25 +
-   * vector search.
-   */
-  list(
-    query: SkillListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<SkillListResponsesSkillsPage, SkillListResponse> {
-    return this._client.getAPIList('/skills', SkillsPage<SkillListResponse>, { query, ...options });
-  }
-}
-
-export type SkillListResponsesSkillsPage = SkillsPage<SkillListResponse>;
-
-export interface SkillListResponse {
-  id: string;
-
-  createdAt: string;
-
-  description: string;
-
-  displayName: string;
-
-  listed: boolean;
-
-  namespace: string;
-
-  prompt: string | null;
-
-  qualityScore: number;
-
-  slug: string;
-
-  categories?: Array<string>;
-
-  externalForks?: number;
-
-  externalStars?: number;
-
-  gitUrl?: string;
-
-  servers?: Array<string>;
-
-  totalActivations?: number;
-
-  uniqueUsers?: number;
-}
-
-export interface SkillListParams extends SkillsPageParams {
-  category?: string;
-
-  namespace?: string;
-
-  q?: string;
-
-  slug?: string;
-
-  topK?: number;
-}
-
-export declare namespace Skills {
-  export {
-    type SkillListResponse as SkillListResponse,
-    type SkillListResponsesSkillsPage as SkillListResponsesSkillsPage,
-    type SkillListParams as SkillListParams,
-  };
-}
+export * from './skills/index';

package/src/resources/tokens.ts

@@ -19,7 +19,11 @@ export class Tokens extends APIResource {
 
 export interface Constraint {
   /**
-   * Metadata filter facts. Each object is an OR condition; keys within are AND-ed.
+   * Metadata key-value pairs for fine-grained access control. When an array is
+   * provided, each object is evaluated as an OR condition (any must match). Within a
+   * single object, all key-value pairs must match (AND). For example, [{"userId":
+   * "alice"}, {"team": "backend"}] allows access if userId is alice OR team is
+   * backend.
    */
   metadata?: { [key: string]: string } | Array<{ [key: string]: string }>;
 

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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