@smithery/api 0.14.0 → 0.16.0

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

@@ -0,0 +1,193 @@
+// 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 Connections extends APIResource {
+  /**
+   * Create a new MCP connection with the given ID. Requires API key and namespace
+   * ownership.
+   *
+   * @example
+   * ```ts
+   * const connection =
+   *   await client.beta.connect.connections.create(
+   *     'connectionId',
+   *     {
+   *       namespaceId: 'namespaceId',
+   *       mcpUrl: 'https://mcp.example.com/sse',
+   *       name: 'My MCP Server',
+   *     },
+   *   );
+   * ```
+   */
+  create(
+    connectionID: string,
+    params: ConnectionCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<Connection> {
+    const { namespaceId, ...body } = params;
+    return this._client.put(path`/connect/namespaces/${namespaceId}/connections/${connectionID}`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Get details for a specific connection. Requires service token with
+   * connections:read scope.
+   *
+   * @example
+   * ```ts
+   * const connection =
+   *   await client.beta.connect.connections.retrieve(
+   *     'connectionId',
+   *     { namespaceId: 'namespaceId' },
+   *   );
+   * ```
+   */
+  retrieve(
+    connectionID: string,
+    params: ConnectionRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<Connection> {
+    const { namespaceId } = params;
+    return this._client.get(path`/connect/namespaces/${namespaceId}/connections/${connectionID}`, options);
+  }
+
+  /**
+   * List all connections in a namespace. Requires service token with
+   * connections:read scope.
+   *
+   * @example
+   * ```ts
+   * const connectionsListResponse =
+   *   await client.beta.connect.connections.list('namespaceId');
+   * ```
+   */
+  list(namespaceID: string, options?: RequestOptions): APIPromise<ConnectionsListResponse> {
+    return this._client.get(path`/connect/namespaces/${namespaceID}/connections`, options);
+  }
+
+  /**
+   * Delete a connection and terminate its MCP session. Requires API key and
+   * namespace ownership.
+   *
+   * @example
+   * ```ts
+   * const connection =
+   *   await client.beta.connect.connections.delete(
+   *     'connectionId',
+   *     { namespaceId: 'namespaceId' },
+   *   );
+   * ```
+   */
+  delete(
+    connectionID: string,
+    params: ConnectionDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ConnectionDeleteResponse> {
+    const { namespaceId } = params;
+    return this._client.delete(path`/connect/namespaces/${namespaceId}/connections/${connectionID}`, options);
+  }
+}
+
+export interface Connection {
+  /**
+   * Developer-defined connection ID
+   */
+  connectionId: string;
+
+  /**
+   * MCP server URL
+   */
+  mcpUrl: string;
+
+  metadata: { [key: string]: unknown } | null;
+
+  /**
+   * Human-readable name
+   */
+  name: string;
+
+  /**
+   * ISO 8601 timestamp
+   */
+  createdAt?: string;
+
+  iconUrl?: string | null;
+}
+
+export interface ConnectionsListResponse {
+  connections: Array<Connection>;
+
+  /**
+   * Cursor for next page, null if no more results
+   */
+  nextCursor: string | null;
+}
+
+export interface CreateConnectionRequest {
+  /**
+   * URL of the MCP server
+   */
+  mcpUrl: string;
+
+  /**
+   * Human-readable name
+   */
+  name: string;
+
+  /**
+   * Custom metadata for filtering connections
+   */
+  metadata?: { [key: string]: unknown };
+}
+
+export interface ConnectionDeleteResponse {
+  success: true;
+}
+
+export interface ConnectionCreateParams {
+  /**
+   * Path param
+   */
+  namespaceId: string;
+
+  /**
+   * Body param: URL of the MCP server
+   */
+  mcpUrl: string;
+
+  /**
+   * Body param: Human-readable name
+   */
+  name: string;
+
+  /**
+   * Body param: Custom metadata for filtering connections
+   */
+  metadata?: { [key: string]: unknown };
+}
+
+export interface ConnectionRetrieveParams {
+  namespaceId: string;
+}
+
+export interface ConnectionDeleteParams {
+  namespaceId: string;
+}
+
+export declare namespace Connections {
+  export {
+    type Connection as Connection,
+    type ConnectionsListResponse as ConnectionsListResponse,
+    type CreateConnectionRequest as CreateConnectionRequest,
+    type ConnectionDeleteResponse as ConnectionDeleteResponse,
+    type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionRetrieveParams as ConnectionRetrieveParams,
+    type ConnectionDeleteParams as ConnectionDeleteParams,
+  };
+}

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

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Connect } from './connect';
+export {
+  Connections,
+  type Connection,
+  type ConnectionsListResponse,
+  type CreateConnectionRequest,
+  type ConnectionDeleteResponse,
+  type ConnectionCreateParams,
+  type ConnectionRetrieveParams,
+  type ConnectionDeleteParams,
+} from './connections';
+export {
+  Namespaces,
+  type CreateNamespaceRequest,
+  type Namespace,
+  type NamespaceDeleteResponse,
+  type NamespaceCreateParams,
+} from './namespaces';
+export { Rpc, type JsonRpcRequest, type JsonRpcResponse, type RpcCallParams } from './rpc';

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

@@ -0,0 +1,103 @@
+// 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 Namespaces extends APIResource {
+  /**
+   * Create a new Connect namespace. Requires a valid Smithery API key.
+   *
+   * @example
+   * ```ts
+   * const namespace =
+   *   await client.beta.connect.namespaces.create({
+   *     name: 'my-namespace',
+   *   });
+   * ```
+   */
+  create(body: NamespaceCreateParams, options?: RequestOptions): APIPromise<Namespace> {
+    return this._client.post('/connect/namespaces', { body, ...options });
+  }
+
+  /**
+   * Get details for a namespace. Requires API key and namespace ownership.
+   *
+   * @example
+   * ```ts
+   * const namespace =
+   *   await client.beta.connect.namespaces.retrieve(
+   *     'namespaceId',
+   *   );
+   * ```
+   */
+  retrieve(namespaceID: string, options?: RequestOptions): APIPromise<Namespace> {
+    return this._client.get(path`/connect/namespaces/${namespaceID}`, options);
+  }
+
+  /**
+   * Delete a namespace and all its connections. Requires API key and namespace
+   * ownership.
+   *
+   * @example
+   * ```ts
+   * const namespace =
+   *   await client.beta.connect.namespaces.delete(
+   *     'namespaceId',
+   *   );
+   * ```
+   */
+  delete(namespaceID: string, options?: RequestOptions): APIPromise<NamespaceDeleteResponse> {
+    return this._client.delete(path`/connect/namespaces/${namespaceID}`, options);
+  }
+}
+
+export interface CreateNamespaceRequest {
+  /**
+   * Namespace name (lowercase alphanumeric with hyphens)
+   */
+  name: string;
+}
+
+export interface Namespace {
+  /**
+   * Unique namespace ID
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Namespace name
+   */
+  name: string;
+
+  /**
+   * ISO 8601 timestamp
+   */
+  updatedAt?: string;
+}
+
+export interface NamespaceDeleteResponse {
+  success: true;
+}
+
+export interface NamespaceCreateParams {
+  /**
+   * Namespace name (lowercase alphanumeric with hyphens)
+   */
+  name: string;
+}
+
+export declare namespace Namespaces {
+  export {
+    type CreateNamespaceRequest as CreateNamespaceRequest,
+    type Namespace as Namespace,
+    type NamespaceDeleteResponse as NamespaceDeleteResponse,
+    type NamespaceCreateParams as NamespaceCreateParams,
+  };
+}

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

@@ -0,0 +1,91 @@
+// 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 Rpc extends APIResource {
+  /**
+   * Execute a JSON-RPC call on an MCP connection. Requires service token with rpc
+   * scope.
+   *
+   * @example
+   * ```ts
+   * const jsonRpcResponse = await client.beta.connect.rpc.call(
+   *   'connectionId',
+   *   {
+   *     namespaceId: 'namespaceId',
+   *     jsonrpc: '2.0',
+   *     method: 'tools/list',
+   *   },
+   * );
+   * ```
+   */
+  call(connectionID: string, params: RpcCallParams, options?: RequestOptions): APIPromise<JsonRpcResponse> {
+    const { namespaceId, ...body } = params;
+    return this._client.post(path`/connect/namespaces/${namespaceId}/connections/${connectionID}/rpc`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+
+  /**
+   * MCP method to call
+   */
+  method: string;
+
+  id?: string | number;
+
+  /**
+   * Method parameters
+   */
+  params?: unknown;
+}
+
+export interface JsonRpcResponse {
+  id: string | number | null;
+
+  jsonrpc: '2.0';
+
+  result?: unknown;
+}
+
+export interface RpcCallParams {
+  /**
+   * Path param
+   */
+  namespaceId: string;
+
+  /**
+   * Body param
+   */
+  jsonrpc: '2.0';
+
+  /**
+   * Body param: MCP method to call
+   */
+  method: string;
+
+  /**
+   * Body param
+   */
+  id?: string | number;
+
+  /**
+   * Body param: Method parameters
+   */
+  params?: unknown;
+}
+
+export declare namespace Rpc {
+  export {
+    type JsonRpcRequest as JsonRpcRequest,
+    type JsonRpcResponse as JsonRpcResponse,
+    type RpcCallParams as RpcCallParams,
+  };
+}

package/src/resources/beta/connect.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './connect/index';

package/src/resources/beta/index.ts

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Beta } from './beta';
+export { Connect } from './connect/index';
 export { Tools, type ToolListResponse, type ToolListParams, type ToolListResponsesToolsPage } from './tools';

package/src/resources/beta/tools.ts

@@ -8,6 +8,16 @@ export class Tools extends APIResource {
   /**
    * Get a paginated list of all MCP tools across servers. Use the `q` parameter for
    * semantic search.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const toolListResponse of client.beta.tools.list(
+   *   { q: 'x' },
+   * )) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query: ToolListParams,

package/src/resources/index.ts

@@ -25,4 +25,5 @@ export {
   type SkillListParams,
   type SkillListResponsesSkillsPage,
 } from './skills';
+export { Tokens, type CreateTokenRequest, type CreateTokenResponse, type TokenCreateParams } from './tokens';
 export { Uplink, type UplinkCreateTokenResponse } from './uplink';

package/src/resources/servers/secrets.ts

@@ -7,15 +7,14 @@ import { path } from '../../internal/utils/path';
 
 export class Secrets extends APIResource {
   /**
-   * Fetch secret names for the server's deployed Worker (requires ownership). Values
-   * are not returned.
+   * Fetch secret names for the server. Values are not returned.
    */
   list(qualifiedName: string, options?: RequestOptions): APIPromise<SecretListResponse> {
     return this._client.get(path`/servers/${qualifiedName}/secrets`, options);
   }
 
   /**
-   * Delete a secret by name from the server's deployed Worker (requires ownership).
+   * Delete a secret by name from the server.
    */
   delete(
     secretName: string,
@@ -27,7 +26,7 @@ export class Secrets extends APIResource {
   }
 
   /**
-   * Set a secret value for the server's deployed Worker (requires ownership).
+   * Set a secret value for the server.
    */
   set(qualifiedName: string, body: SecretSetParams, options?: RequestOptions): APIPromise<SecretSetResponse> {
     return this._client.put(path`/servers/${qualifiedName}/secrets`, { body, ...options });

package/src/resources/tokens.ts

@@ -0,0 +1,138 @@
+// 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';
+
+export class Tokens extends APIResource {
+  /**
+   * Create a service token for machine-to-machine authentication. Requires API key
+   * authentication.
+   *
+   * @example
+   * ```ts
+   * const createTokenResponse = await client.tokens.create({
+   *   permissions: {
+   *     connections: { can: ['read', 'write'] },
+   *     'connections.rpc': { can: ['write'] },
+   *   },
+   *   ttlSeconds: 3600,
+   * });
+   * ```
+   */
+  create(body: TokenCreateParams, options?: RequestOptions): APIPromise<CreateTokenResponse> {
+    return this._client.post('/tokens', { body, ...options });
+  }
+}
+
+export interface CreateTokenRequest {
+  /**
+   * Permissions to grant. Format: { [subject]: { can: [actions] } }
+   */
+  permissions: { [key: string]: CreateTokenRequest.Permissions };
+
+  /**
+   * Token TTL in seconds. Required. Max 86400 (24 hours).
+   */
+  ttlSeconds: number;
+
+  /**
+   * Optional constraints to limit token access.
+   */
+  constraints?: CreateTokenRequest.Constraints;
+
+  /**
+   * Profile to scope the token to. If not provided, uses the default profile.
+   */
+  profileSlug?: string;
+}
+
+export namespace CreateTokenRequest {
+  export interface Permissions {
+    /**
+     * Actions granted on this subject.
+     */
+    can: Array<'read' | 'write'>;
+  }
+
+  /**
+   * Optional constraints to limit token access.
+   */
+  export interface Constraints {
+    /**
+     * Limit access to specific namespace IDs.
+     */
+    namespaceIds?: Array<string>;
+
+    /**
+     * Limit access to specific server qualified names.
+     */
+    serverQualifiedNames?: Array<string>;
+  }
+}
+
+export interface CreateTokenResponse {
+  /**
+   * The signed service token (PASETO v4).
+   */
+  token: string;
+
+  /**
+   * ISO 8601 timestamp when the token expires.
+   */
+  expiresAt: string;
+}
+
+export interface TokenCreateParams {
+  /**
+   * Permissions to grant. Format: { [subject]: { can: [actions] } }
+   */
+  permissions: { [key: string]: TokenCreateParams.Permissions };
+
+  /**
+   * Token TTL in seconds. Required. Max 86400 (24 hours).
+   */
+  ttlSeconds: number;
+
+  /**
+   * Optional constraints to limit token access.
+   */
+  constraints?: TokenCreateParams.Constraints;
+
+  /**
+   * Profile to scope the token to. If not provided, uses the default profile.
+   */
+  profileSlug?: string;
+}
+
+export namespace TokenCreateParams {
+  export interface Permissions {
+    /**
+     * Actions granted on this subject.
+     */
+    can: Array<'read' | 'write'>;
+  }
+
+  /**
+   * Optional constraints to limit token access.
+   */
+  export interface Constraints {
+    /**
+     * Limit access to specific namespace IDs.
+     */
+    namespaceIds?: Array<string>;
+
+    /**
+     * Limit access to specific server qualified names.
+     */
+    serverQualifiedNames?: Array<string>;
+  }
+}
+
+export declare namespace Tokens {
+  export {
+    type CreateTokenRequest as CreateTokenRequest,
+    type CreateTokenResponse as CreateTokenResponse,
+    type TokenCreateParams as TokenCreateParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.14.0'; // x-release-please-version
+export const VERSION = '0.16.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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