@smithery/api 0.52.0 → 0.54.0

package/src/resources/servers/releases.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { PagePromise, ReleasesPage, type ReleasesPageParams } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
@@ -9,6 +10,9 @@ import { RequestOptions } from '../../internal/request-options';
 import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Releases extends APIResource {
   /**
    * List releases ordered by most recent first. Logs are omitted — fetch a specific
@@ -16,13 +20,24 @@ export class Releases extends APIResource {
    *
    * @example
    * ```ts
-   * const releases = await client.servers.releases.list(
+   * // Automatically fetches more pages as needed.
+   * for await (const releaseListResponse of client.servers.releases.list(
    *   'qualifiedName',
-   * );
+   * )) {
+   *   // ...
+   * }
    * ```
    */
-  list(qualifiedName: string, options?: RequestOptions): APIPromise<ReleaseListResponse> {
-    return this._client.get(path`/servers/${qualifiedName}/releases`, options);
+  list(
+    qualifiedName: string,
+    query: ReleaseListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ReleaseListResponsesReleasesPage, ReleaseListResponse> {
+    return this._client.getAPIList(
+      path`/servers/${qualifiedName}/releases`,
+      ReleasesPage<ReleaseListResponse>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -110,6 +125,8 @@ export class Releases extends APIResource {
   }
 }
 
+export type ReleaseListResponsesReleasesPage = ReleasesPage<ReleaseListResponse>;
+
 export type DeployPayload =
   | HostedDeployPayload
   | ExternalDeployPayload
@@ -165,8 +182,6 @@ export namespace HostedDeployPayload {
 export interface ServerCard {
   serverInfo: ServerCard.ServerInfo;
 
-  authentication?: ServerCard.Authentication;
-
   eventTopics?: Array<ServerCard.EventTopic>;
 
   prompts?: Array<ServerCard.Prompt>;
@@ -205,12 +220,6 @@ export namespace ServerCard {
     }
   }
 
-  export interface Authentication {
-    required: boolean;
-
-    schemes: Array<string>;
-  }
-
   export interface EventTopic {
     name: string;
 
@@ -386,59 +395,55 @@ export namespace StdioDeployPayload {
   }
 }
 
-export type ReleaseListResponse = Array<ReleaseListResponse.ReleaseListResponseItem>;
-
-export namespace ReleaseListResponse {
-  export interface ReleaseListResponseItem {
-    id: string;
+export interface ReleaseListResponse {
+  id: string;
 
-    /**
-     * ISO 8601 timestamp of when the release was created.
-     */
-    createdAt: string;
+  /**
+   * ISO 8601 timestamp of when the release was created.
+   */
+  createdAt: string;
 
-    /**
-     * Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED,
-     * CANCELLED, or INTERNAL_ERROR.
-     */
-    status: string;
+  /**
+   * Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED,
+   * CANCELLED, or INTERNAL_ERROR.
+   */
+  status: string;
 
-    /**
-     * Release type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or
-     * stdio (local binary).
-     */
-    type: string;
+  /**
+   * Release type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or
+   * stdio (local binary).
+   */
+  type: string;
 
-    /**
-     * ISO 8601 timestamp of the last status change.
-     */
-    updatedAt: string;
+  /**
+   * ISO 8601 timestamp of the last status change.
+   */
+  updatedAt: string;
 
-    /**
-     * Git branch this release was built from.
-     */
-    branch?: string | null;
+  /**
+   * Git branch this release was built from.
+   */
+  branch?: string | null;
 
-    /**
-     * Git commit SHA that triggered this release.
-     */
-    commit?: string | null;
+  /**
+   * Git commit SHA that triggered this release.
+   */
+  commit?: string | null;
 
-    /**
-     * Git commit message associated with this release.
-     */
-    commitMessage?: string | null;
+  /**
+   * Git commit message associated with this release.
+   */
+  commitMessage?: string | null;
 
-    /**
-     * The MCP endpoint URL for connecting to this server.
-     */
-    mcpUrl?: string;
+  /**
+   * The MCP endpoint URL for connecting to this server.
+   */
+  mcpUrl?: string;
 
-    /**
-     * Upstream MCP server URL. Present only for external releases.
-     */
-    upstreamUrl?: string | null;
-  }
+  /**
+   * Upstream MCP server URL. Present only for external releases.
+   */
+  upstreamUrl?: string | null;
 }
 
 export interface ReleaseDeployResponse {
@@ -569,6 +574,8 @@ export interface ReleaseResumeResponse {
  */
 export type ReleaseStreamResponse = string;
 
+export interface ReleaseListParams extends ReleasesPageParams {}
+
 export interface ReleaseDeployParams {
   /**
    * JSON-encoded release payload. See DeployPayload schema for structure.
@@ -627,6 +634,8 @@ export declare namespace Releases {
     type ReleaseGetResponse as ReleaseGetResponse,
     type ReleaseResumeResponse as ReleaseResumeResponse,
     type ReleaseStreamResponse as ReleaseStreamResponse,
+    type ReleaseListResponsesReleasesPage as ReleaseListResponsesReleasesPage,
+    type ReleaseListParams as ReleaseListParams,
     type ReleaseDeployParams as ReleaseDeployParams,
     type ReleaseGetParams as ReleaseGetParams,
     type ReleaseResumeParams as ReleaseResumeParams,

package/src/resources/servers/repo.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Repo extends APIResource {
   /**
    * Partially update the GitHub repository connection settings. Only provided fields

package/src/resources/servers/secrets.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Secrets extends APIResource {
   /**
    * List secret names. Values are not returned.

package/src/resources/servers/servers.ts

@@ -25,7 +25,9 @@ import {
   ReleaseDeployResponse,
   ReleaseGetParams,
   ReleaseGetResponse,
+  ReleaseListParams,
   ReleaseListResponse,
+  ReleaseListResponsesReleasesPage,
   ReleaseResumeParams,
   ReleaseResumeResponse,
   ReleaseStreamParams,
@@ -59,6 +61,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Servers extends APIResource {
   releases: ReleasesAPI.Releases = new ReleasesAPI.Releases(this._client);
   logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
@@ -549,6 +554,8 @@ export declare namespace Servers {
     type ReleaseGetResponse as ReleaseGetResponse,
     type ReleaseResumeResponse as ReleaseResumeResponse,
     type ReleaseStreamResponse as ReleaseStreamResponse,
+    type ReleaseListResponsesReleasesPage as ReleaseListResponsesReleasesPage,
+    type ReleaseListParams as ReleaseListParams,
     type ReleaseDeployParams as ReleaseDeployParams,
     type ReleaseGetParams as ReleaseGetParams,
     type ReleaseResumeParams as ReleaseResumeParams,

package/src/resources/skills/index.ts

@@ -27,6 +27,7 @@ export {
   type SkillCreateParams,
   type SkillListParams,
   type SkillDeleteParams,
+  type SkillDownloadParams,
   type SkillGetParams,
   type SkillSetParams,
   type SkillSyncParams,

package/src/resources/skills/reviews.ts

@@ -7,6 +7,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Reviews extends APIResource {
   /**
    * Submit a review for a skill. Updates existing review if one already exists.

package/src/resources/skills/skills.ts

@@ -31,9 +31,13 @@ import {
 } from './votes';
 import { APIPromise } from '../../core/api-promise';
 import { PagePromise, SkillsPage, type SkillsPageParams } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Skills extends APIResource {
   votes: VotesAPI.Votes = new VotesAPI.Votes(this._client);
   reviews: ReviewsAPI.Reviews = new ReviewsAPI.Reviews(this._client);
@@ -67,6 +71,19 @@ export class Skills extends APIResource {
     return this._client.delete(path`/skills/${namespace}/${slug}`, options);
   }
 
+  /**
+   * Download a ZIP bundle containing all skill files, fetched via well-known
+   * endpoints.
+   */
+  download(slug: string, params: SkillDownloadParams, options?: RequestOptions): APIPromise<Response> {
+    const { namespace } = params;
+    return this._client.get(path`/skills/${namespace}/${slug}/download`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/zip' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+
   /**
    * Get a single skill by its namespace and slug.
    */
@@ -372,6 +389,10 @@ export interface SkillDeleteParams {
   namespace: string;
 }
 
+export interface SkillDownloadParams {
+  namespace: string;
+}
+
 export interface SkillGetParams {
   namespace: string;
 }
@@ -407,6 +428,7 @@ export declare namespace Skills {
     type SkillCreateParams as SkillCreateParams,
     type SkillListParams as SkillListParams,
     type SkillDeleteParams as SkillDeleteParams,
+    type SkillDownloadParams as SkillDownloadParams,
     type SkillGetParams as SkillGetParams,
     type SkillSetParams as SkillSetParams,
     type SkillSyncParams as SkillSyncParams,

package/src/resources/skills/votes.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Votes extends APIResource {
   /**
    * Upvote or downvote a skill. Updates existing vote if one exists.

package/src/resources/tokens.ts

@@ -17,28 +17,33 @@ export class Tokens extends APIResource {
   }
 }
 
+/**
+ * A policy constraint that restricts a token's scope. All specified fields within
+ * a single constraint are AND'd together. When multiple constraints are passed in
+ * the policy array, each is applied as an independent attenuation block.
+ */
 export interface Constraint {
   /**
-   * 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.
+   * Key-value metadata for fine-grained filtering. A single object requires all
+   * pairs to match (AND). An array of objects requires any one to match (OR-of-AND),
+   * e.g. [{"userId":"alice"},{"team":"backend"}] grants access when either condition
+   * is met.
    */
   metadata?: { [key: string]: string } | Array<{ [key: string]: string }>;
 
   /**
-   * Restrict token to specific namespaces.
+   * Namespace(s) the token is scoped to. Accepts a single slug or an array.
    */
   namespaces?: string | Array<string>;
 
   /**
-   * Restrict token to specific operations.
+   * Operation(s) the token may perform: read, write, or execute.
    */
   operations?: 'read' | 'write' | 'execute' | Array<'read' | 'write' | 'execute'>;
 
   /**
-   * Restrict token to specific resource types.
+   * Resource type(s) the token may access: connections, servers, namespaces, or
+   * skills.
    */
   resources?:
     | 'connections'
@@ -48,7 +53,15 @@ export interface Constraint {
     | Array<'connections' | 'servers' | 'namespaces' | 'skills'>;
 
   /**
-   * TTL as seconds or duration string ("1h", "30m", "20s").
+   * MCP JSON-RPC request matching rules. Keys are dot-paths into the request body
+   * (e.g. "params.name", "method"). Values are regex patterns. All entries must
+   * match (AND).
+   */
+  rpcReqMatch?: { [key: string]: string };
+
+  /**
+   * Time-to-live for the constraint. Accepts seconds (number) or a duration string
+   * such as "1h", "30m", or "20s".
    */
   ttl?: string | number;
 }

package/src/resources/uplink.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * Manage uplink tokens for connecting locally-running MCP servers to Smithery
+ */
 export class Uplink extends APIResource {
   /**
    * Create or retrieve an authtoken for uplink connections

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.52.0'; // x-release-please-version
+export const VERSION = '0.54.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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