@smithery/api 0.54.0 → 0.56.0

package/src/client.ts

@@ -91,6 +91,8 @@ import {
   SkillSetResponse,
   SkillSyncParams,
   SkillSyncResponse,
+  SkillUploadParams,
+  SkillUploadResponse,
   Skills,
 } from './resources/skills/skills';
 import { type Fetch } from './internal/builtin-types';
@@ -319,8 +321,9 @@ export class Smithery {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
@@ -653,9 +656,9 @@ export class Smithery {
       }
     }
 
-    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-    // just do what it says, but otherwise calculate a default
-    if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+    // If the API asks us to wait a certain amount of time, just do what it
+    // says, but otherwise calculate a default
+    if (timeoutMillis === undefined) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -888,6 +891,7 @@ export declare namespace Smithery {
     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,
@@ -896,6 +900,7 @@ export declare namespace Smithery {
     type SkillGetParams as SkillGetParams,
     type SkillSetParams as SkillSetParams,
     type SkillSyncParams as SkillSyncParams,
+    type SkillUploadParams as SkillUploadParams,
   };
 
   export {

package/src/resources/index.ts

@@ -45,6 +45,7 @@ export {
   type SkillGetResponse,
   type SkillSetResponse,
   type SkillSyncResponse,
+  type SkillUploadResponse,
   type SkillCreateParams,
   type SkillListParams,
   type SkillDeleteParams,
@@ -52,6 +53,7 @@ export {
   type SkillGetParams,
   type SkillSetParams,
   type SkillSyncParams,
+  type SkillUploadParams,
   type SkillListResponsesSkillsPage,
 } from './skills/skills';
 export {

package/src/resources/servers/servers.ts

@@ -507,6 +507,12 @@ export interface ServerListParams extends SmitheryPageParams {
    */
   repoOwner?: string;
 
+  /**
+   * Random seed for deterministic pagination. When provided, results use a stable
+   * sort order that is consistent across pages for the same seed value.
+   */
+  seed?: number;
+
   /**
    * Maximum number of candidate results to consider from the search index before
    * pagination.

package/src/resources/skills/index.ts

@@ -24,6 +24,7 @@ export {
   type SkillGetResponse,
   type SkillSetResponse,
   type SkillSyncResponse,
+  type SkillUploadResponse,
   type SkillCreateParams,
   type SkillListParams,
   type SkillDeleteParams,
@@ -31,6 +32,7 @@ export {
   type SkillGetParams,
   type SkillSetParams,
   type SkillSyncParams,
+  type SkillUploadParams,
   type SkillListResponsesSkillsPage,
 } from './skills';
 export {

package/src/resources/skills/skills.ts

@@ -31,8 +31,10 @@ import {
 } from './votes';
 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';
 
 /**
@@ -72,8 +74,7 @@ export class Skills extends APIResource {
   }
 
   /**
-   * Download a ZIP bundle containing all skill files, fetched via well-known
-   * endpoints.
+   * Download a ZIP bundle containing all skill files.
    */
   download(slug: string, params: SkillDownloadParams, options?: RequestOptions): APIPromise<Response> {
     const { namespace } = params;
@@ -93,13 +94,12 @@ export class Skills extends APIResource {
   }
 
   /**
-   * Idempotent endpoint to create or sync a skill. If the skill does not exist,
-   * creates it. If it exists, updates displayName, description, and externalStars
-   * from GitHub.
+   * 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, ...options });
+    const { namespace, body } = params;
+    return this._client.put(path`/skills/${namespace}/${slug}`, { body: body, ...options });
   }
 
   /**
@@ -112,6 +112,17 @@ export class Skills extends APIResource {
     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>;
@@ -199,7 +210,7 @@ export interface SkillListResponse {
   /**
    * URL to the skill's source repository.
    */
-  gitUrl?: string;
+  gitUrl?: string | null;
 
   /**
    * Number of reviews for this skill.
@@ -250,7 +261,7 @@ export interface SkillGetResponse {
 
   externalStars: number;
 
-  gitUrl: string;
+  gitUrl: string | null;
 
   listed: boolean;
 
@@ -294,7 +305,7 @@ export interface SkillSetResponse {
 
   externalStars: number;
 
-  gitUrl: string;
+  gitUrl: string | null;
 
   listed: boolean;
 
@@ -323,6 +334,28 @@ export interface SkillSyncResponse {
   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
@@ -404,15 +437,28 @@ export interface SkillSetParams {
   namespace: string;
 
   /**
-   * Body param: GitHub URL pointing to a repository with SKILL.md
+   * Body param
    */
-  gitUrl: string;
+  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;
+}
+
 Skills.Votes = Votes;
 Skills.Reviews = Reviews;
 
@@ -424,6 +470,7 @@ export declare namespace Skills {
     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,
@@ -432,6 +479,7 @@ export declare namespace Skills {
     type SkillGetParams as SkillGetParams,
     type SkillSetParams as SkillSetParams,
     type SkillSyncParams as SkillSyncParams,
+    type SkillUploadParams as SkillUploadParams,
   };
 
   export {

package/src/resources/tokens.ts

@@ -68,16 +68,10 @@ export interface Constraint {
 
 export interface CreateTokenRequest {
   /**
-   * Constraint objects to restrict the token. Cannot be combined with profileSlug.
-   * Each constraint may include a `ttl` field (max 24 hours). Default TTL is 1 hour.
-   * Maximum is 24 hours.
+   * 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.
    */
   policy?: Array<Constraint>;
-
-  /**
-   * Profile slug for legacy token minting. Cannot be combined with policy.
-   */
-  profileSlug?: string;
 }
 
 export interface CreateTokenResponse {
@@ -94,16 +88,10 @@ export interface CreateTokenResponse {
 
 export interface TokenCreateParams {
   /**
-   * Constraint objects to restrict the token. Cannot be combined with profileSlug.
-   * Each constraint may include a `ttl` field (max 24 hours). Default TTL is 1 hour.
-   * Maximum is 24 hours.
+   * 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.
    */
   policy?: Array<Constraint>;
-
-  /**
-   * Profile slug for legacy token minting. Cannot be combined with policy.
-   */
-  profileSlug?: string;
 }
 
 export declare namespace Tokens {

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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