@smithery/api 0.57.0 → 0.59.0

package/resources/skills.mjs

@@ -1,3 +1,78 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export * from "./skills/index.mjs";
+import { APIResource } from "../core/resource.mjs";
+import { SkillsPage } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { multipartFormRequestOptions } from "../internal/uploads.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * 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, options) {
+        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 = {}, options) {
+        return this._client.getAPIList('/skills', (SkillsPage), { query, ...options });
+    }
+    /**
+     * Delete a skill by namespace and slug. Requires ownership of the namespace.
+     */
+    delete(slug, params, options) {
+        const { namespace } = params;
+        return this._client.delete(path `/skills/${namespace}/${slug}`, options);
+    }
+    /**
+     * Download a ZIP bundle containing all skill files.
+     */
+    download(slug, params, options) {
+        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, params, options) {
+        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, params, options) {
+        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, params, options) {
+        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, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.put(path `/skills/${namespace}/${slug}/upload`, multipartFormRequestOptions({ body, ...options }, this._client));
+    }
+}
 //# sourceMappingURL=skills.mjs.map

package/resources/skills.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skills.mjs","sourceRoot":"","sources":["../src/resources/skills.ts"],"names":[],"mappings":"AAAA,sFAAsF"}
+{"version":3,"file":"skills.mjs","sourceRoot":"","sources":["../src/resources/skills.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAe,UAAU,EAAyB;OAElD,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,UAA6B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAyB,EAAE,OAAwB;QACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY,EAAE,MAA2B,EAAE,OAAwB;QAC1E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,WAAW,EAAE;YACnE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACxE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,MAAsB,EAAE,OAAwB;QAChE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAY,EAAE,MAAsB,EAAE,OAAwB;QAChE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,MAAuB,EAAE,OAAwB;QAClE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAyB,EAAE,OAAwB;QACtE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,IAAI,CAAA,WAAW,SAAS,IAAI,IAAI,SAAS,EACzC,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;CACF"}

package/src/client.ts

@@ -21,8 +21,6 @@ import {
   NamespacesPageResponse,
   type ReleasesPageParams,
   ReleasesPageResponse,
-  type ReviewsPageParams,
-  ReviewsPageResponse,
   type SkillsPageParams,
   SkillsPageResponse,
   type SmitheryPageParams,
@@ -32,6 +30,25 @@ import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
 import { Health, HealthCheckResponse } from './resources/health';
+import {
+  SkillCreateParams,
+  SkillCreateResponse,
+  SkillDeleteParams,
+  SkillDeleteResponse,
+  SkillDownloadParams,
+  SkillGetParams,
+  SkillGetResponse,
+  SkillListParams,
+  SkillListResponse,
+  SkillListResponsesSkillsPage,
+  SkillSetParams,
+  SkillSetResponse,
+  SkillSyncParams,
+  SkillSyncResponse,
+  SkillUploadParams,
+  SkillUploadResponse,
+  Skills,
+} from './resources/skills';
 import {
   Constraint,
   CreateTokenRequest,
@@ -77,25 +94,6 @@ import {
   ServerUpdateResponse,
   Servers,
 } from './resources/servers/servers';
-import {
-  SkillCreateParams,
-  SkillCreateResponse,
-  SkillDeleteParams,
-  SkillDeleteResponse,
-  SkillDownloadParams,
-  SkillGetParams,
-  SkillGetResponse,
-  SkillListParams,
-  SkillListResponse,
-  SkillListResponsesSkillsPage,
-  SkillSetParams,
-  SkillSetResponse,
-  SkillSyncParams,
-  SkillSyncResponse,
-  SkillUploadParams,
-  SkillUploadResponse,
-  Skills,
-} from './resources/skills/skills';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -860,9 +858,6 @@ export declare namespace Smithery {
     type NamespacesPageResponse as NamespacesPageResponse,
   };
 
-  export import ReviewsPage = Pagination.ReviewsPage;
-  export { type ReviewsPageParams as ReviewsPageParams, type ReviewsPageResponse as ReviewsPageResponse };
-
   export import ReleasesPage = Pagination.ReleasesPage;
   export { type ReleasesPageParams as ReleasesPageParams, type ReleasesPageResponse as ReleasesPageResponse };
 

package/src/core/pagination.ts

@@ -284,65 +284,6 @@ export class NamespacesPage<Item> extends AbstractPage<Item> implements Namespac
   }
 }
 
-export interface ReviewsPageResponse<Item> {
-  reviews: Array<Item>;
-
-  pagination: ReviewsPageResponse.Pagination;
-}
-
-export namespace ReviewsPageResponse {
-  export interface Pagination {
-    currentPage?: number;
-
-    pageSize?: number;
-
-    totalCount?: number;
-
-    totalPages?: number;
-  }
-}
-
-export interface ReviewsPageParams {
-  page?: number;
-
-  limit?: number;
-}
-
-export class ReviewsPage<Item> extends AbstractPage<Item> implements ReviewsPageResponse<Item> {
-  reviews: Array<Item>;
-
-  pagination: ReviewsPageResponse.Pagination;
-
-  constructor(
-    client: Smithery,
-    response: Response,
-    body: ReviewsPageResponse<Item>,
-    options: FinalRequestOptions,
-  ) {
-    super(client, response, body, options);
-
-    this.reviews = body.reviews || [];
-    this.pagination = body.pagination || {};
-  }
-
-  getPaginatedItems(): Item[] {
-    return this.reviews ?? [];
-  }
-
-  nextPageRequestOptions(): PageRequestOptions | null {
-    const query = this.options.query as ReviewsPageParams;
-    const currentPage = query?.page ?? 1;
-
-    return {
-      ...this.options,
-      query: {
-        ...maybeObj(this.options.query),
-        page: currentPage + 1,
-      },
-    };
-  }
-}
-
 export interface ReleasesPageResponse<Item> {
   releases: Array<Item>;
 

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/resources/connections/connections.ts

@@ -28,7 +28,7 @@ export class Connections extends APIResource {
 
   /**
    * List all connections in a namespace. Supports filtering by metadata using
-   * `metadata.{key}={value}` query params (e.g., `metadata.userId=alice`).
+   * `metadata.{key}={value}` query params.
    *
    * @example
    * ```ts
@@ -84,9 +84,9 @@ export class Connections extends APIResource {
 
   /**
    * Create or update an MCP connection with the given ID. mcpUrl is required when
-   * creating a new connection, but optional when updating (omit to keep the existing
-   * URL). Returns 409 if a different mcpUrl is provided - delete and recreate to
-   * change URL. Requires API key and namespace ownership.
+   * creating a new connection, but optional when updating. Returns 409 if a
+   * different mcpUrl is provided, except while the connection is input_required and
+   * the new URL keeps the same host and path.
    *
    * @example
    * ```ts
@@ -138,6 +138,7 @@ export interface Connection {
   status?:
     | Connection.ConnectionStatusConnected
     | Connection.ConnectionStatusAuthRequired
+    | Connection.ConnectionStatusInputRequired
     | Connection.ConnectionStatusError;
 }
 
@@ -179,9 +180,59 @@ export namespace Connection {
     state: 'auth_required';
 
     /**
-     * URL to redirect user for OAuth authorization
+     * @deprecated Deprecated compatibility alias for setupUrl
      */
     authorizationUrl?: string;
+
+    /**
+     * Hosted Smithery URL for completing setup and OAuth
+     */
+    setupUrl?: string;
+  }
+
+  export interface ConnectionStatusInputRequired {
+    http: ConnectionStatusInputRequired.HTTP;
+
+    missing: ConnectionStatusInputRequired.Missing;
+
+    state: 'input_required';
+
+    /**
+     * Hosted Smithery URL for completing setup in the browser
+     */
+    setupUrl?: string;
+  }
+
+  export namespace ConnectionStatusInputRequired {
+    export interface HTTP {
+      headers?: { [key: string]: HTTP.Headers };
+
+      query?: { [key: string]: HTTP.Query };
+    }
+
+    export namespace HTTP {
+      export interface Headers {
+        label: string;
+
+        description?: string;
+
+        required?: boolean;
+      }
+
+      export interface Query {
+        label: string;
+
+        description?: string;
+
+        required?: boolean;
+      }
+    }
+
+    export interface Missing {
+      headers: Array<string>;
+
+      query: Array<string>;
+    }
   }
 
   export interface ConnectionStatusError {

package/src/resources/index.ts

@@ -56,7 +56,7 @@ export {
   type SkillSyncParams,
   type SkillUploadParams,
   type SkillListResponsesSkillsPage,
-} from './skills/skills';
+} from './skills';
 export {
   Tokens,
   type Constraint,

package/src/resources/servers/servers.ts

@@ -253,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;