@smithery/api 0.56.1 → 0.58.0

package/src/resources/servers/index.ts

@@ -2,13 +2,9 @@
 
 export {
   Domains,
-  type DomainCreateResponse,
   type DomainUpdateResponse,
   type DomainListResponse,
-  type DomainDeleteResponse,
-  type DomainCreateParams,
   type DomainUpdateParams,
-  type DomainDeleteParams,
 } from './domains';
 export { Icon, type IconDeleteResponse, type IconUploadResponse } from './icon';
 export { Logs, type LogListResponse, type LogListParams } from './logs';

package/src/resources/servers/releases.ts

@@ -178,8 +178,6 @@ export namespace HostedDeployPayload {
 export interface ServerCard {
   serverInfo: ServerCard.ServerInfo;
 
-  eventTopics?: Array<ServerCard.EventTopic>;
-
   prompts?: Array<ServerCard.Prompt>;
 
   resources?: Array<ServerCard.Resource>;
@@ -216,18 +214,6 @@ export namespace ServerCard {
     }
   }
 
-  export interface EventTopic {
-    name: string;
-
-    topic: string;
-
-    description?: string;
-
-    eventSchema?: { [key: string]: unknown };
-
-    inputSchema?: { [key: string]: unknown };
-  }
-
   export interface Prompt {
     name: string;
 

package/src/resources/servers/servers.ts

@@ -2,16 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as DomainsAPI from './domains';
-import {
-  DomainCreateParams,
-  DomainCreateResponse,
-  DomainDeleteParams,
-  DomainDeleteResponse,
-  DomainListResponse,
-  DomainUpdateParams,
-  DomainUpdateResponse,
-  Domains,
-} from './domains';
+import { DomainListResponse, DomainUpdateParams, DomainUpdateResponse, Domains } from './domains';
 import * as IconAPI from './icon';
 import { Icon, IconDeleteResponse, IconUploadResponse } from './icon';
 import * as LogsAPI from './logs';
@@ -262,7 +253,8 @@ export interface ServerListResponse {
   displayName: string;
 
   /**
-   * URL to the server's page on smithery.ai.
+   * The server owner's homepage URL, or the server's Smithery page as a fallback.
+   * Will become nullable in a future release.
    */
   homepage: string;
 
@@ -332,8 +324,6 @@ export interface ServerGetResponse {
 
   displayName: string;
 
-  eventTopics: Array<ServerGetResponse.EventTopic> | null;
-
   iconUrl: string | null;
 
   prompts: Array<ServerGetResponse.Prompt> | null;
@@ -370,18 +360,6 @@ export namespace ServerGetResponse {
     type: 'http';
   }
 
-  export interface EventTopic {
-    name: string;
-
-    topic: string;
-
-    description?: string;
-
-    eventSchema?: { [key: string]: unknown };
-
-    inputSchema?: { [key: string]: unknown };
-  }
-
   export interface Prompt {
     name: string;
 
@@ -595,12 +573,8 @@ export declare namespace Servers {
 
   export {
     Domains as Domains,
-    type DomainCreateResponse as DomainCreateResponse,
     type DomainUpdateResponse as DomainUpdateResponse,
     type DomainListResponse as DomainListResponse,
-    type DomainDeleteResponse as DomainDeleteResponse,
-    type DomainCreateParams as DomainCreateParams,
     type DomainUpdateParams as DomainUpdateParams,
-    type DomainDeleteParams as DomainDeleteParams,
   };
 }

package/src/resources/skills.ts

@@ -1,3 +1,429 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './skills/index';
+import { APIResource } from '../core/resource';
+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';
+
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
+export class Skills extends APIResource {
+  /**
+   * **Deprecated:** Use PUT /skills/{namespace}/{slug} instead. Create a new skill
+   * by linking a GitHub repository containing a SKILL.md file.
+   *
+   * @deprecated
+   */
+  create(body: SkillCreateParams, options?: RequestOptions): APIPromise<SkillCreateResponse> {
+    return this._client.post('/skills', { body, ...options });
+  }
+
+  /**
+   * 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 });
+  }
+
+  /**
+   * Delete a skill by namespace and slug. Requires ownership of the namespace.
+   */
+  delete(slug: string, params: SkillDeleteParams, options?: RequestOptions): APIPromise<SkillDeleteResponse> {
+    const { namespace } = params;
+    return this._client.delete(path`/skills/${namespace}/${slug}`, options);
+  }
+
+  /**
+   * Download a ZIP bundle containing all skill files.
+   */
+  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.
+   */
+  get(slug: string, params: SkillGetParams, options?: RequestOptions): APIPromise<SkillGetResponse> {
+    const { namespace } = params;
+    return this._client.get(path`/skills/${namespace}/${slug}`, options);
+  }
+
+  /**
+   * 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: body, ...options });
+  }
+
+  /**
+   * **Deprecated:** Use PUT /skills/{namespace}/{slug} instead. Refetch SKILL.md and
+   * repository stars from GitHub and update the skill record.
+   *
+   * @deprecated
+   */
+  sync(slug: string, params: SkillSyncParams, options?: RequestOptions): APIPromise<SkillSyncResponse> {
+    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>;
+
+export interface SkillCreateResponse {
+  id: string;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  gitUrl: string;
+
+  listed: boolean;
+
+  namespace: string;
+
+  slug: string;
+}
+
+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;
+
+  /**
+   * Whether this skill's namespace is verified.
+   */
+  verified: boolean;
+
+  /**
+   * 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 | null;
+
+  /**
+   * 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 SkillDeleteResponse {
+  qualifiedName: string;
+
+  success: boolean;
+}
+
+export interface SkillGetResponse {
+  id: string;
+
+  categories: Array<string>;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  externalForks: number;
+
+  externalStars: number;
+
+  gitUrl: string | null;
+
+  listed: boolean;
+
+  namespace: string;
+
+  /**
+   * Organization ID of the skill owner (from namespace)
+   */
+  owner: string | null;
+
+  prompt: string;
+
+  qualityScore: number;
+
+  servers: Array<string>;
+
+  slug: string;
+
+  totalActivations: number;
+
+  uniqueUsers: number;
+
+  /**
+   * Whether this skill's namespace is verified.
+   */
+  verified: boolean;
+}
+
+export interface SkillSetResponse {
+  id: string;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  externalStars: number;
+
+  gitUrl: string | null;
+
+  listed: boolean;
+
+  namespace: string;
+
+  slug: string;
+
+  updatedAt: string;
+}
+
+export interface SkillSyncResponse {
+  id: string;
+
+  description: string;
+
+  displayName: string;
+
+  externalStars: number;
+
+  gitUrl: string;
+
+  namespace: string;
+
+  slug: string;
+
+  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
+   */
+  gitUrl: string;
+
+  /**
+   * The namespace to create the skill in.
+   */
+  namespace: string;
+
+  /**
+   * URL-friendly identifier for the skill.
+   */
+  slug: string;
+}
+
+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 organization 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;
+
+  /**
+   * Filter by whether the skill's namespace is verified.
+   */
+  verified?: boolean;
+}
+
+export interface SkillDeleteParams {
+  namespace: string;
+}
+
+export interface SkillDownloadParams {
+  namespace: string;
+}
+
+export interface SkillGetParams {
+  namespace: string;
+}
+
+export interface SkillSetParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Body param
+   */
+  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;
+}
+
+export declare namespace Skills {
+  export {
+    type SkillCreateResponse as SkillCreateResponse,
+    type SkillListResponse as SkillListResponse,
+    type SkillDeleteResponse as SkillDeleteResponse,
+    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,
+    type SkillDeleteParams as SkillDeleteParams,
+    type SkillDownloadParams as SkillDownloadParams,
+    type SkillGetParams as SkillGetParams,
+    type SkillSetParams as SkillSetParams,
+    type SkillSyncParams as SkillSyncParams,
+    type SkillUploadParams as SkillUploadParams,
+  };
+}

package/src/resources/tokens.ts

@@ -8,6 +8,11 @@ export class Tokens extends APIResource {
   /**
    * Create a service token for machine-to-machine authentication. Accepts API key or
    * bearer token. Optionally apply restrictions.
+   *
+   * @example
+   * ```ts
+   * const createTokenResponse = await client.tokens.create();
+   * ```
    */
   create(
     body: TokenCreateParams | null | undefined = {},
@@ -67,6 +72,13 @@ export interface Constraint {
 }
 
 export interface CreateTokenRequest {
+  /**
+   * Optional organization ID to scope the token to. When provided, the token is
+   * minted with org context. The authenticated user must be an admin or owner of the
+   * organization.
+   */
+  organizationId?: string;
+
   /**
    * Constraint objects to restrict the token. Each constraint may include a `ttl`
    * field (max 24 hours). Default TTL is 1 hour. Maximum is 24 hours.
@@ -87,6 +99,13 @@ export interface CreateTokenResponse {
 }
 
 export interface TokenCreateParams {
+  /**
+   * Optional organization ID to scope the token to. When provided, the token is
+   * minted with org context. The authenticated user must be an admin or owner of the
+   * organization.
+   */
+  organizationId?: string;
+
   /**
    * Constraint objects to restrict the token. Each constraint may include a `ttl`
    * field (max 24 hours). Default TTL is 1 hour. Maximum is 24 hours.

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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

package/resources/skills/index.d.mts

@@ -1,4 +0,0 @@
-export { Reviews, type CreateReviewRequest, type CreateReviewResponse, type ReviewError, type ReviewItem, type ReviewVoteRequest, type ReviewVoteResponse, type ReviewsListResponse, type ReviewCreateParams, type ReviewListParams, type ReviewDeleteParams, type ReviewUnvoteParams, type ReviewVoteParams, type ReviewItemsReviewsPage, } from "./reviews.mjs";
-export { Skills, type SkillCreateResponse, type SkillListResponse, type SkillDeleteResponse, type SkillGetResponse, type SkillSetResponse, type SkillSyncResponse, type SkillUploadResponse, type SkillCreateParams, type SkillListParams, type SkillDeleteParams, type SkillDownloadParams, type SkillGetParams, type SkillSetParams, type SkillSyncParams, type SkillUploadParams, type SkillListResponsesSkillsPage, } from "./skills.mjs";
-export { Votes, type SkillVoteCounts, type SkillVoteError, type SkillVoteRequest, type SkillVoteResponse, type VoteCreateParams, type VoteDeleteParams, type VoteGetParams, } from "./votes.mjs";
-//# sourceMappingURL=index.d.mts.map

package/resources/skills/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/skills/index.ts"],"names":[],"mappings":"OAEO,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B;OACM,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,GAClC;OACM,EACL,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB"}

package/resources/skills/index.d.ts

@@ -1,4 +0,0 @@
-export { Reviews, type CreateReviewRequest, type CreateReviewResponse, type ReviewError, type ReviewItem, type ReviewVoteRequest, type ReviewVoteResponse, type ReviewsListResponse, type ReviewCreateParams, type ReviewListParams, type ReviewDeleteParams, type ReviewUnvoteParams, type ReviewVoteParams, type ReviewItemsReviewsPage, } from "./reviews.js";
-export { Skills, type SkillCreateResponse, type SkillListResponse, type SkillDeleteResponse, type SkillGetResponse, type SkillSetResponse, type SkillSyncResponse, type SkillUploadResponse, type SkillCreateParams, type SkillListParams, type SkillDeleteParams, type SkillDownloadParams, type SkillGetParams, type SkillSetParams, type SkillSyncParams, type SkillUploadParams, type SkillListResponsesSkillsPage, } from "./skills.js";
-export { Votes, type SkillVoteCounts, type SkillVoteError, type SkillVoteRequest, type SkillVoteResponse, type VoteCreateParams, type VoteDeleteParams, type VoteGetParams, } from "./votes.js";
-//# sourceMappingURL=index.d.ts.map

package/resources/skills/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/skills/index.ts"],"names":[],"mappings":"OAEO,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B;OACM,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,GAClC;OACM,EACL,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB"}

package/resources/skills/index.js

@@ -1,11 +0,0 @@
-"use strict";
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Votes = exports.Skills = exports.Reviews = void 0;
-var reviews_1 = require("./reviews.js");
-Object.defineProperty(exports, "Reviews", { enumerable: true, get: function () { return reviews_1.Reviews; } });
-var skills_1 = require("./skills.js");
-Object.defineProperty(exports, "Skills", { enumerable: true, get: function () { return skills_1.Skills; } });
-var votes_1 = require("./votes.js");
-Object.defineProperty(exports, "Votes", { enumerable: true, get: function () { return votes_1.Votes; } });
-//# sourceMappingURL=index.js.map

package/resources/skills/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/skills/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wCAemB;AAdjB,kGAAA,OAAO,OAAA;AAeT,sCAkBkB;AAjBhB,gGAAA,MAAM,OAAA;AAkBR,oCASiB;AARf,8FAAA,KAAK,OAAA"}

package/resources/skills/index.mjs

@@ -1,5 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export { Reviews, } from "./reviews.mjs";
-export { Skills, } from "./skills.mjs";
-export { Votes, } from "./votes.mjs";
-//# sourceMappingURL=index.mjs.map

package/resources/skills/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/skills/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,OAAO,GAcR;OACM,EACL,MAAM,GAiBP;OACM,EACL,KAAK,GAQN"}