@smithery/api 0.24.0 → 0.26.0

package/src/resources/beta/connect/connections.ts

@@ -24,30 +24,8 @@ export class Connections extends APIResource {
   }
 
   /**
-   * Get details for a specific connection. Requires service token with
-   * connections:read scope.
-   *
-   * @example
-   * ```ts
-   * const connection =
-   *   await client.beta.connect.connections.retrieve(
-   *     'connectionId',
-   *     { namespace: 'namespace' },
-   *   );
-   * ```
-   */
-  retrieve(
-    connectionID: string,
-    params: ConnectionRetrieveParams,
-    options?: RequestOptions,
-  ): APIPromise<Connection> {
-    const { namespace } = params;
-    return this._client.get(path`/connect/${namespace}/${connectionID}`, options);
-  }
-
-  /**
-   * List all connections in a namespace. Requires service token with
-   * connections:read scope.
+   * List all connections in a namespace. Supports filtering by metadata using
+   * `metadata.{key}={value}` query params (e.g., `metadata.userId=alice`).
    *
    * @example
    * ```ts
@@ -55,8 +33,12 @@ export class Connections extends APIResource {
    *   await client.beta.connect.connections.list('namespace');
    * ```
    */
-  list(namespace: string, options?: RequestOptions): APIPromise<ConnectionsListResponse> {
-    return this._client.get(path`/connect/${namespace}`, options);
+  list(
+    namespace: string,
+    query: ConnectionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConnectionsListResponse> {
+    return this._client.get(path`/connect/${namespace}`, { query, ...options });
   }
 
   /**
@@ -81,6 +63,24 @@ export class Connections extends APIResource {
     return this._client.delete(path`/connect/${namespace}/${connectionID}`, options);
   }
 
+  /**
+   * Get details for a specific connection. Requires service token with
+   * connections:read scope.
+   *
+   * @example
+   * ```ts
+   * const connection =
+   *   await client.beta.connect.connections.get(
+   *     'connectionId',
+   *     { namespace: 'namespace' },
+   *   );
+   * ```
+   */
+  get(connectionID: string, params: ConnectionGetParams, options?: RequestOptions): APIPromise<Connection> {
+    const { namespace } = params;
+    return this._client.get(path`/connect/${namespace}/${connectionID}`, options);
+  }
+
   /**
    * Create a new MCP connection with the given ID. Returns 409 if connection already
    * exists - delete it first to recreate. Requires API key and namespace ownership.
@@ -137,9 +137,9 @@ export interface Connection {
    * Connection status after initialization (only returned on create)
    */
   status?:
-    | Connection.ConnectConnectionStatusConnected
-    | Connection.ConnectConnectionStatusAuthRequired
-    | Connection.ConnectConnectionStatusError;
+    | Connection.ConnectionStatusConnected
+    | Connection.ConnectionStatusAuthRequired
+    | Connection.ConnectionStatusError;
 }
 
 export namespace Connection {
@@ -172,11 +172,11 @@ export namespace Connection {
     }
   }
 
-  export interface ConnectConnectionStatusConnected {
+  export interface ConnectionStatusConnected {
     state: 'connected';
   }
 
-  export interface ConnectConnectionStatusAuthRequired {
+  export interface ConnectionStatusAuthRequired {
     state: 'auth_required';
 
     /**
@@ -185,7 +185,7 @@ export namespace Connection {
     authorizationUrl?: string;
   }
 
-  export interface ConnectConnectionStatusError {
+  export interface ConnectionStatusError {
     /**
      * Error message
      */
@@ -254,14 +254,31 @@ export interface ConnectionCreateParams {
   name?: string;
 }
 
-export interface ConnectionRetrieveParams {
-  namespace: string;
+export interface ConnectionListParams {
+  /**
+   * Pagination cursor from previous response's nextCursor
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of items to return (default 100, max 100)
+   */
+  limit?: number;
+
+  /**
+   * Filter by exact connection name
+   */
+  name?: string;
 }
 
 export interface ConnectionDeleteParams {
   namespace: string;
 }
 
+export interface ConnectionGetParams {
+  namespace: string;
+}
+
 export interface ConnectionSetParams {
   /**
    * Path param
@@ -297,8 +314,9 @@ export declare namespace Connections {
     type CreateConnectionRequest as CreateConnectionRequest,
     type ConnectionDeleteResponse as ConnectionDeleteResponse,
     type ConnectionCreateParams as ConnectionCreateParams,
-    type ConnectionRetrieveParams as ConnectionRetrieveParams,
+    type ConnectionListParams as ConnectionListParams,
     type ConnectionDeleteParams as ConnectionDeleteParams,
+    type ConnectionGetParams as ConnectionGetParams,
     type ConnectionSetParams as ConnectionSetParams,
   };
 }

package/src/resources/beta/connect/index.ts

@@ -8,8 +8,10 @@ export {
   type CreateConnectionRequest,
   type ConnectionDeleteResponse,
   type ConnectionCreateParams,
-  type ConnectionRetrieveParams,
+  type ConnectionListParams,
   type ConnectionDeleteParams,
+  type ConnectionGetParams,
   type ConnectionSetParams,
 } from './connections';
 export { Rpc, type JsonRpcRequest, type JsonRpcResponse, type RpcCallParams } from './rpc';
+export { Tools, type ToolSearchResponse, type ToolSearchParams } from './tools';

package/src/resources/beta/connect/tools.ts

@@ -0,0 +1,73 @@
+// 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 { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Tools extends APIResource {
+  /**
+   * Search indexed tools across all connections in a namespace. Filter by
+   * connectionId or server URL. Metadata constraints from service tokens are applied
+   * automatically.
+   *
+   * @example
+   * ```ts
+   * const response = await client.beta.connect.tools.search(
+   *   'namespace',
+   *   { q: 'x' },
+   * );
+   * ```
+   */
+  search(
+    namespace: string,
+    query: ToolSearchParams,
+    options?: RequestOptions,
+  ): APIPromise<ToolSearchResponse> {
+    return this._client.get(path`/connect/tools/${namespace}`, { query, ...options });
+  }
+}
+
+export interface ToolSearchResponse {
+  nextCursor: string | null;
+
+  tools: Array<ToolSearchResponse.Tool>;
+}
+
+export namespace ToolSearchResponse {
+  export interface Tool {
+    connectionId: string;
+
+    serverUrl: string;
+
+    tool: Tool.Tool;
+
+    score?: number;
+  }
+
+  export namespace Tool {
+    export interface Tool {
+      name: string;
+
+      description?: string;
+
+      inputSchema?: { [key: string]: unknown };
+    }
+  }
+}
+
+export interface ToolSearchParams {
+  q: string;
+
+  connectionId?: string;
+
+  cursor?: string;
+
+  limit?: number;
+
+  server?: string;
+}
+
+export declare namespace Tools {
+  export { type ToolSearchResponse as ToolSearchResponse, type ToolSearchParams as ToolSearchParams };
+}

package/src/resources/index.ts

@@ -6,16 +6,16 @@ export {
   Namespaces,
   type NamespaceCreateResponse,
   type NamespaceListResponse,
-  type NamespaceCreateParams,
+  type NamespaceSetResponse,
 } from './namespaces';
 export {
   Servers,
   type BuildConfig,
   type DeploymentTarget,
   type ProjectConfig,
-  type ServerRetrieveResponse,
   type ServerListResponse,
   type ServerDeleteResponse,
+  type ServerGetResponse,
   type ServerListParams,
   type ServerListResponsesSmitheryPage,
 } from './servers/servers';
@@ -25,5 +25,15 @@ export {
   type SkillListParams,
   type SkillListResponsesSkillsPage,
 } from './skills';
-export { Tokens, type CreateTokenRequest, type CreateTokenResponse, type TokenCreateParams } from './tokens';
+export {
+  Tokens,
+  type Action,
+  type Allow,
+  type ConnectionScope,
+  type CreateTokenRequest,
+  type CreateTokenResponse,
+  type ResourceScope,
+  type RpcScope,
+  type TokenCreateParams,
+} from './tokens';
 export { Uplink, type UplinkCreateTokenResponse } from './uplink';

package/src/resources/namespaces.ts

@@ -3,33 +3,31 @@
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Namespaces extends APIResource {
   /**
-   * Create a new namespace owned by the authenticated user
-   *
-   * @example
-   * ```ts
-   * const namespace = await client.namespaces.create({
-   *   name: 'myorg',
-   * });
-   * ```
+   * Create a new namespace with a server-generated human-readable name, owned by the
+   * authenticated user
    */
-  create(body: NamespaceCreateParams, options?: RequestOptions): APIPromise<NamespaceCreateResponse> {
-    return this._client.put('/namespaces', { body, ...options });
+  create(options?: RequestOptions): APIPromise<NamespaceCreateResponse> {
+    return this._client.post('/namespaces', options);
   }
 
   /**
    * Get a list of all namespaces owned by the authenticated user
-   *
-   * @example
-   * ```ts
-   * const namespaces = await client.namespaces.list();
-   * ```
    */
   list(options?: RequestOptions): APIPromise<NamespaceListResponse> {
     return this._client.get('/namespaces', options);
   }
+
+  /**
+   * Create a new namespace with a user-specified name, owned by the authenticated
+   * user
+   */
+  set(name: string, options?: RequestOptions): APIPromise<NamespaceSetResponse> {
+    return this._client.put(path`/namespaces/${name}`, options);
+  }
 }
 
 export interface NamespaceCreateResponse {
@@ -50,7 +48,9 @@ export namespace NamespaceListResponse {
   }
 }
 
-export interface NamespaceCreateParams {
+export interface NamespaceSetResponse {
+  createdAt: string;
+
   name: string;
 }
 
@@ -58,6 +58,6 @@ export declare namespace Namespaces {
   export {
     type NamespaceCreateResponse as NamespaceCreateResponse,
     type NamespaceListResponse as NamespaceListResponse,
-    type NamespaceCreateParams as NamespaceCreateParams,
+    type NamespaceSetResponse as NamespaceSetResponse,
   };
 }

package/src/resources/servers/deployments.ts

@@ -8,18 +8,6 @@ import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
 export class Deployments extends APIResource {
-  /**
-   * Get deployment status
-   */
-  retrieve(
-    id: string,
-    params: DeploymentRetrieveParams,
-    options?: RequestOptions,
-  ): APIPromise<DeploymentRetrieveResponse> {
-    const { qualifiedName } = params;
-    return this._client.get(path`/servers/${qualifiedName}/deployments/${id}`, options);
-  }
-
   /**
    * List deployments for a server
    */
@@ -41,6 +29,14 @@ export class Deployments extends APIResource {
     );
   }
 
+  /**
+   * Get deployment status
+   */
+  get(id: string, params: DeploymentGetParams, options?: RequestOptions): APIPromise<DeploymentGetResponse> {
+    const { qualifiedName } = params;
+    return this._client.get(path`/servers/${qualifiedName}/deployments/${id}`, options);
+  }
+
   /**
    * Use id='latest' to resume the most recent deployment
    */
@@ -72,6 +68,8 @@ export interface ExternalDeployPayload {
   upstreamUrl: string;
 
   configSchema?: { [key: string]: unknown };
+
+  scanCredentials?: { [key: string]: string };
 }
 
 export interface HostedDeployPayload {
@@ -302,7 +300,33 @@ export namespace StdioDeployPayload {
   }
 }
 
-export interface DeploymentRetrieveResponse {
+export type DeploymentListResponse = Array<DeploymentListResponse.DeploymentListResponseItem>;
+
+export namespace DeploymentListResponse {
+  export interface DeploymentListResponseItem {
+    id: string;
+
+    createdAt: string;
+
+    status: string;
+
+    updatedAt: string;
+
+    mcpUrl?: string;
+  }
+}
+
+export interface DeploymentDeployResponse {
+  deploymentId: string;
+
+  mcpUrl: string;
+
+  status: string;
+
+  warnings?: Array<string>;
+}
+
+export interface DeploymentGetResponse {
   id: string;
 
   createdAt: string;
@@ -311,12 +335,12 @@ export interface DeploymentRetrieveResponse {
 
   updatedAt: string;
 
-  logs?: Array<DeploymentRetrieveResponse.Log>;
+  logs?: Array<DeploymentGetResponse.Log>;
 
   mcpUrl?: string;
 }
 
-export namespace DeploymentRetrieveResponse {
+export namespace DeploymentGetResponse {
   export interface Log {
     level: string;
 
@@ -336,42 +360,12 @@ export namespace DeploymentRetrieveResponse {
   }
 }
 
-export type DeploymentListResponse = Array<DeploymentListResponse.DeploymentListResponseItem>;
-
-export namespace DeploymentListResponse {
-  export interface DeploymentListResponseItem {
-    id: string;
-
-    createdAt: string;
-
-    status: string;
-
-    updatedAt: string;
-
-    mcpUrl?: string;
-  }
-}
-
-export interface DeploymentDeployResponse {
-  deploymentId: string;
-
-  mcpUrl: string;
-
-  status: string;
-
-  warnings?: Array<string>;
-}
-
 export interface DeploymentResumeResponse {
   deploymentId: string;
 
   status: string;
 }
 
-export interface DeploymentRetrieveParams {
-  qualifiedName: string;
-}
-
 export interface DeploymentDeployParams {
   /**
    * JSON-encoded deployment payload. See DeployPayload schema for structure.
@@ -394,6 +388,10 @@ export interface DeploymentDeployParams {
   sourcemap?: Uploadable;
 }
 
+export interface DeploymentGetParams {
+  qualifiedName: string;
+}
+
 export interface DeploymentResumeParams {
   qualifiedName: string;
 }
@@ -405,12 +403,12 @@ export declare namespace Deployments {
     type HostedDeployPayload as HostedDeployPayload,
     type ServerCard as ServerCard,
     type StdioDeployPayload as StdioDeployPayload,
-    type DeploymentRetrieveResponse as DeploymentRetrieveResponse,
     type DeploymentListResponse as DeploymentListResponse,
     type DeploymentDeployResponse as DeploymentDeployResponse,
+    type DeploymentGetResponse as DeploymentGetResponse,
     type DeploymentResumeResponse as DeploymentResumeResponse,
-    type DeploymentRetrieveParams as DeploymentRetrieveParams,
     type DeploymentDeployParams as DeploymentDeployParams,
+    type DeploymentGetParams as DeploymentGetParams,
     type DeploymentResumeParams as DeploymentResumeParams,
   };
 }

package/src/resources/servers/index.ts

@@ -7,12 +7,12 @@ export {
   type HostedDeployPayload,
   type ServerCard,
   type StdioDeployPayload,
-  type DeploymentRetrieveResponse,
   type DeploymentListResponse,
   type DeploymentDeployResponse,
+  type DeploymentGetResponse,
   type DeploymentResumeResponse,
-  type DeploymentRetrieveParams,
   type DeploymentDeployParams,
+  type DeploymentGetParams,
   type DeploymentResumeParams,
 } from './deployments';
 export { Logs, type LogListResponse, type LogListParams } from './logs';
@@ -29,9 +29,9 @@ export {
   type BuildConfig,
   type DeploymentTarget,
   type ProjectConfig,
-  type ServerRetrieveResponse,
   type ServerListResponse,
   type ServerDeleteResponse,
+  type ServerGetResponse,
   type ServerListParams,
   type ServerListResponsesSmitheryPage,
 } from './servers';

package/src/resources/servers/servers.ts

@@ -6,11 +6,11 @@ import {
   DeployPayload,
   DeploymentDeployParams,
   DeploymentDeployResponse,
+  DeploymentGetParams,
+  DeploymentGetResponse,
   DeploymentListResponse,
   DeploymentResumeParams,
   DeploymentResumeResponse,
-  DeploymentRetrieveParams,
-  DeploymentRetrieveResponse,
   Deployments,
   ExternalDeployPayload,
   HostedDeployPayload,
@@ -39,13 +39,6 @@ export class Servers extends APIResource {
   logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
   secrets: SecretsAPI.Secrets = new SecretsAPI.Secrets(this._client);
 
-  /**
-   * Get a single server by its qualified name.
-   */
-  retrieve(qualifiedName: string, options?: RequestOptions): APIPromise<ServerRetrieveResponse> {
-    return this._client.get(path`/servers/${qualifiedName}`, options);
-  }
-
   /**
    * Get a paginated list of all servers. Use the `q` parameter to search.
    */
@@ -73,6 +66,13 @@ export class Servers extends APIResource {
       __binaryResponse: true,
     });
   }
+
+  /**
+   * Get a single server by its qualified name.
+   */
+  get(qualifiedName: string, options?: RequestOptions): APIPromise<ServerGetResponse> {
+    return this._client.get(path`/servers/${qualifiedName}`, options);
+  }
 }
 
 export type ServerListResponsesSmitheryPage = SmitheryPage<ServerListResponse>;
@@ -134,8 +134,40 @@ export namespace ProjectConfig {
   }
 }
 
-export interface ServerRetrieveResponse {
-  connections: Array<ServerRetrieveResponse.StdioConnection | ServerRetrieveResponse.HTTPConnection>;
+export interface ServerListResponse {
+  id: string;
+
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  homepage: string;
+
+  iconUrl: string | null;
+
+  isDeployed: boolean;
+
+  owner: string | null;
+
+  qualifiedName: string;
+
+  remote: boolean | null;
+
+  useCount: number;
+
+  verified: boolean;
+}
+
+export interface ServerDeleteResponse {
+  qualifiedName: string;
+
+  success: boolean;
+}
+
+export interface ServerGetResponse {
+  connections: Array<ServerGetResponse.StdioConnection | ServerGetResponse.HTTPConnection>;
 
   deploymentUrl: string | null;
 
@@ -149,12 +181,12 @@ export interface ServerRetrieveResponse {
 
   remote: boolean;
 
-  security: ServerRetrieveResponse.Security | null;
+  security: ServerGetResponse.Security | null;
 
-  tools: Array<ServerRetrieveResponse.Tool> | null;
+  tools: Array<ServerGetResponse.Tool> | null;
 }
 
-export namespace ServerRetrieveResponse {
+export namespace ServerGetResponse {
   export interface StdioConnection {
     configSchema: { [key: string]: unknown };
 
@@ -196,38 +228,6 @@ export namespace ServerRetrieveResponse {
   }
 }
 
-export interface ServerListResponse {
-  id: string;
-
-  createdAt: string;
-
-  description: string;
-
-  displayName: string;
-
-  homepage: string;
-
-  iconUrl: string | null;
-
-  isDeployed: boolean;
-
-  owner: string | null;
-
-  qualifiedName: string;
-
-  remote: boolean | null;
-
-  useCount: number;
-
-  verified: boolean;
-}
-
-export interface ServerDeleteResponse {
-  qualifiedName: string;
-
-  success: boolean;
-}
-
 export interface ServerListParams extends SmitheryPageParams {
   ids?: Array<string>;
 
@@ -259,9 +259,9 @@ export declare namespace Servers {
     type BuildConfig as BuildConfig,
     type DeploymentTarget as DeploymentTarget,
     type ProjectConfig as ProjectConfig,
-    type ServerRetrieveResponse as ServerRetrieveResponse,
     type ServerListResponse as ServerListResponse,
     type ServerDeleteResponse as ServerDeleteResponse,
+    type ServerGetResponse as ServerGetResponse,
     type ServerListResponsesSmitheryPage as ServerListResponsesSmitheryPage,
     type ServerListParams as ServerListParams,
   };
@@ -273,12 +273,12 @@ export declare namespace Servers {
     type HostedDeployPayload as HostedDeployPayload,
     type ServerCard as ServerCard,
     type StdioDeployPayload as StdioDeployPayload,
-    type DeploymentRetrieveResponse as DeploymentRetrieveResponse,
     type DeploymentListResponse as DeploymentListResponse,
     type DeploymentDeployResponse as DeploymentDeployResponse,
+    type DeploymentGetResponse as DeploymentGetResponse,
     type DeploymentResumeResponse as DeploymentResumeResponse,
-    type DeploymentRetrieveParams as DeploymentRetrieveParams,
     type DeploymentDeployParams as DeploymentDeployParams,
+    type DeploymentGetParams as DeploymentGetParams,
     type DeploymentResumeParams as DeploymentResumeParams,
   };