@smithery/api 0.34.1 → 0.36.0

package/src/resources/experimental/agents/agents.ts

@@ -8,6 +8,21 @@ export class Agents extends APIResource {
   responses: ResponsesAPI.Responses = new ResponsesAPI.Responses(this._client);
 }
 
+export interface AssistantMessage {
+  /**
+   * Message ID
+   */
+  id: string;
+
+  content: Array<OutputTextContent>;
+
+  role: 'assistant';
+
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  type: 'message';
+}
+
 export interface CreateResponseRequest {
   /**
    * Smithery namespace for tool discovery
@@ -22,10 +37,7 @@ export interface CreateResponseRequest {
   /**
    * Input text or array of messages
    */
-  input?:
-    | string
-    | Array<CreateResponseRequest.AgentUserMessage | CreateResponseRequest.AgentSystemMessage>
-    | null;
+  input?: string | Array<InputItem> | null;
 
   /**
    * Additional system instructions
@@ -73,46 +85,6 @@ export interface CreateResponseRequest {
   top_p?: number | null;
 }
 
-export namespace CreateResponseRequest {
-  export interface AgentUserMessage {
-    content: Array<AgentUserMessage.UnionMember0> | string;
-
-    role: 'user';
-
-    type: 'message';
-  }
-
-  export namespace AgentUserMessage {
-    export interface UnionMember0 {
-      /**
-       * The text content
-       */
-      text: string;
-
-      type: 'input_text';
-    }
-  }
-
-  export interface AgentSystemMessage {
-    content: Array<AgentSystemMessage.UnionMember0> | string;
-
-    role: 'system';
-
-    type: 'message';
-  }
-
-  export namespace AgentSystemMessage {
-    export interface UnionMember0 {
-      /**
-       * The text content
-       */
-      text: string;
-
-      type: 'input_text';
-    }
-  }
-}
-
 export interface ErrorResponse {
   error: ErrorResponse.Error;
 }
@@ -136,6 +108,54 @@ export namespace ErrorResponse {
   }
 }
 
+export interface FunctionCall {
+  /**
+   * Function call ID
+   */
+  id: string;
+
+  /**
+   * JSON-encoded arguments
+   */
+  arguments: string;
+
+  /**
+   * Tool call ID
+   */
+  call_id: string;
+
+  /**
+   * Function name
+   */
+  name: string;
+
+  status: 'in_progress' | 'completed' | 'incomplete';
+
+  type: 'function_call';
+}
+
+export type InputItem = UserMessage | SystemMessage;
+
+export interface InputTextContent {
+  /**
+   * The text content
+   */
+  text: string;
+
+  type: 'input_text';
+}
+
+export type OutputItem = AssistantMessage | FunctionCall;
+
+export interface OutputTextContent {
+  /**
+   * The output text
+   */
+  text: string;
+
+  type: 'output_text';
+}
+
 export interface Response {
   /**
    * Response ID
@@ -182,7 +202,7 @@ export interface Response {
   /**
    * Output items
    */
-  output: Array<Response.AgentAssistantMessage | Response.AgentFunctionCall>;
+  output: Array<OutputItem>;
 
   /**
    * Previous response ID
@@ -192,12 +212,12 @@ export interface Response {
   /**
    * Response status
    */
-  status: 'queued' | 'in_progress' | 'completed' | 'failed' | 'incomplete';
+  status: ResponseStatus;
 
   /**
    * Token usage
    */
-  usage: Response.Usage | null;
+  usage: Usage | null;
 }
 
 export namespace Response {
@@ -209,87 +229,72 @@ export namespace Response {
 
     message: string;
   }
+}
 
-  export interface AgentAssistantMessage {
-    /**
-     * Message ID
-     */
-    id: string;
-
-    content: Array<AgentAssistantMessage.Content>;
-
-    role: 'assistant';
-
-    status: 'in_progress' | 'completed' | 'incomplete';
-
-    type: 'message';
-  }
-
-  export namespace AgentAssistantMessage {
-    export interface Content {
-      /**
-       * The output text
-       */
-      text: string;
+export type ResponseStatus = 'queued' | 'in_progress' | 'completed' | 'failed' | 'incomplete';
 
-      type: 'output_text';
-    }
-  }
+/**
+ * Simple text content
+ */
+export type StringContent = string;
 
-  export interface AgentFunctionCall {
-    /**
-     * Function call ID
-     */
-    id: string;
+export interface SystemMessage {
+  /**
+   * Simple text content
+   */
+  content: Array<InputTextContent> | StringContent;
 
-    /**
-     * JSON-encoded arguments
-     */
-    arguments: string;
+  role: 'system';
 
-    /**
-     * Tool call ID
-     */
-    call_id: string;
+  type: 'message';
+}
 
-    /**
-     * Function name
-     */
-    name: string;
+export interface Usage {
+  /**
+   * Input tokens used
+   */
+  input_tokens: number;
 
-    status: 'in_progress' | 'completed' | 'incomplete';
+  /**
+   * Output tokens generated
+   */
+  output_tokens: number;
 
-    type: 'function_call';
-  }
+  /**
+   * Total tokens
+   */
+  total_tokens: number;
+}
 
+export interface UserMessage {
   /**
-   * Token usage
+   * Simple text content
    */
-  export interface Usage {
-    /**
-     * Input tokens used
-     */
-    input_tokens: number;
+  content: Array<InputTextContent> | StringContent;
 
-    /**
-     * Output tokens generated
-     */
-    output_tokens: number;
+  role: 'user';
 
-    /**
-     * Total tokens
-     */
-    total_tokens: number;
-  }
+  type: 'message';
 }
 
 Agents.Responses = Responses;
 
 export declare namespace Agents {
   export {
+    type AssistantMessage as AssistantMessage,
     type CreateResponseRequest as CreateResponseRequest,
     type ErrorResponse as ErrorResponse,
+    type FunctionCall as FunctionCall,
+    type InputItem as InputItem,
+    type InputTextContent as InputTextContent,
+    type OutputItem as OutputItem,
+    type OutputTextContent as OutputTextContent,
     type Response as Response,
+    type ResponseStatus as ResponseStatus,
+    type StringContent as StringContent,
+    type SystemMessage as SystemMessage,
+    type Usage as Usage,
+    type UserMessage as UserMessage,
   };
 
   export { Responses as Responses, type ResponseCreateParams as ResponseCreateParams };

package/src/resources/experimental/agents/index.ts

@@ -1,4 +1,20 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Agents, type CreateResponseRequest, type ErrorResponse, type Response } from './agents';
+export {
+  Agents,
+  type AssistantMessage,
+  type CreateResponseRequest,
+  type ErrorResponse,
+  type FunctionCall,
+  type InputItem,
+  type InputTextContent,
+  type OutputItem,
+  type OutputTextContent,
+  type Response,
+  type ResponseStatus,
+  type StringContent,
+  type SystemMessage,
+  type Usage,
+  type UserMessage,
+} from './agents';
 export { Responses, type ResponseCreateParams } from './responses';

package/src/resources/experimental/agents/responses.ts

@@ -52,10 +52,7 @@ export interface ResponseCreateParams {
   /**
    * Input text or array of messages
    */
-  input?:
-    | string
-    | Array<ResponseCreateParams.AgentUserMessage | ResponseCreateParams.AgentSystemMessage>
-    | null;
+  input?: string | Array<AgentsAPI.InputItem> | null;
 
   /**
    * Additional system instructions
@@ -103,46 +100,6 @@ export interface ResponseCreateParams {
   top_p?: number | null;
 }
 
-export namespace ResponseCreateParams {
-  export interface AgentUserMessage {
-    content: Array<AgentUserMessage.UnionMember0> | string;
-
-    role: 'user';
-
-    type: 'message';
-  }
-
-  export namespace AgentUserMessage {
-    export interface UnionMember0 {
-      /**
-       * The text content
-       */
-      text: string;
-
-      type: 'input_text';
-    }
-  }
-
-  export interface AgentSystemMessage {
-    content: Array<AgentSystemMessage.UnionMember0> | string;
-
-    role: 'system';
-
-    type: 'message';
-  }
-
-  export namespace AgentSystemMessage {
-    export interface UnionMember0 {
-      /**
-       * The text content
-       */
-      text: string;
-
-      type: 'input_text';
-    }
-  }
-}
-
 export declare namespace Responses {
   export { type ResponseCreateParams as ResponseCreateParams };
 }

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

@@ -84,8 +84,10 @@ export class Connections extends APIResource {
   }
 
   /**
-   * 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.
+   * Create or update an MCP connection with the given ID. If the connection exists
+   * and mcpUrl matches, updates name/metadata/headers. Returns 409 if mcpUrl
+   * differs - delete and recreate to change URL. Requires API key and namespace
+   * ownership.
    *
    * @example
    * ```ts

package/src/resources/experimental/connect/mcp.ts

@@ -7,8 +7,10 @@ import { path } from '../../../internal/utils/path';
 
 export class Mcp extends APIResource {
   /**
-   * Streamable HTTP MCP endpoint. Accepts JSON-RPC requests and notifications.
-   * Requires service token with mcp scope.
+   * Stateless MCP endpoint using Streamable HTTP transport. Accepts JSON-RPC
+   * requests and notifications. Session management is handled internally by
+   * Connect—clients should not send mcp-session-id headers. Requires service token
+   * with mcp scope.
    *
    * @example
    * ```ts

package/src/resources/experimental/experimental.ts

@@ -2,7 +2,23 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents/agents';
-import { Agents, CreateResponseRequest, ErrorResponse, Response } from './agents/agents';
+import {
+  Agents,
+  AssistantMessage,
+  CreateResponseRequest,
+  ErrorResponse,
+  FunctionCall,
+  InputItem,
+  InputTextContent,
+  OutputItem,
+  OutputTextContent,
+  Response,
+  ResponseStatus,
+  StringContent,
+  SystemMessage,
+  Usage,
+  UserMessage,
+} from './agents/agents';
 import * as ConnectAPI from './connect/connect';
 import { Connect } from './connect/connect';
 
@@ -17,9 +33,20 @@ Experimental.Connect = Connect;
 export declare namespace Experimental {
   export {
     Agents as Agents,
+    type AssistantMessage as AssistantMessage,
     type CreateResponseRequest as CreateResponseRequest,
     type ErrorResponse as ErrorResponse,
+    type FunctionCall as FunctionCall,
+    type InputItem as InputItem,
+    type InputTextContent as InputTextContent,
+    type OutputItem as OutputItem,
+    type OutputTextContent as OutputTextContent,
     type Response as Response,
+    type ResponseStatus as ResponseStatus,
+    type StringContent as StringContent,
+    type SystemMessage as SystemMessage,
+    type Usage as Usage,
+    type UserMessage as UserMessage,
   };
 
   export { Connect as Connect };

package/src/resources/experimental/index.ts

@@ -1,5 +1,21 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Agents, type CreateResponseRequest, type ErrorResponse, type Response } from './agents/index';
+export {
+  Agents,
+  type AssistantMessage,
+  type CreateResponseRequest,
+  type ErrorResponse,
+  type FunctionCall,
+  type InputItem,
+  type InputTextContent,
+  type OutputItem,
+  type OutputTextContent,
+  type Response,
+  type ResponseStatus,
+  type StringContent,
+  type SystemMessage,
+  type Usage,
+  type UserMessage,
+} from './agents/index';
 export { Connect } from './connect/index';
 export { Experimental } from './experimental';

package/src/resources/index.ts

@@ -7,18 +7,24 @@ export {
   type NamespaceCreateResponse,
   type NamespaceListResponse,
   type NamespaceSetResponse,
+  type NamespaceListParams,
+  type NamespaceListResponsesNamespacesPage,
 } from './namespaces/namespaces';
 export {
   Servers,
   type BuildConfig,
   type DeploymentTarget,
   type ProjectConfig,
+  type ServerCreateResponse,
   type ServerListResponse,
   type ServerDeleteResponse,
+  type ServerCreateByNamespaceResponse,
   type ServerGetResponse,
   type ServerGetByNamespaceResponse,
+  type ServerCreateParams,
   type ServerListParams,
   type ServerDeleteParams,
+  type ServerCreateByNamespaceParams,
   type ServerDownloadParams,
   type ServerGetParams,
   type ServerListResponsesSmitheryPage,
@@ -26,9 +32,11 @@ export {
 export {
   Skills,
   type SkillListResponse,
+  type SkillGetResponse,
   type SkillListParams,
+  type SkillGetParams,
   type SkillListResponsesSkillsPage,
-} from './skills';
+} from './skills/skills';
 export {
   Tokens,
   type Constraint,

package/src/resources/namespaces/index.ts

@@ -5,5 +5,7 @@ export {
   type NamespaceCreateResponse,
   type NamespaceListResponse,
   type NamespaceSetResponse,
+  type NamespaceListParams,
+  type NamespaceListResponsesNamespacesPage,
 } from './namespaces';
 export { Servers, type ServerCreateResponse, type ServerCreateParams } from './servers';

package/src/resources/namespaces/namespaces.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../../core/resource';
 import * as ServersAPI from './servers';
 import { ServerCreateParams, ServerCreateResponse, Servers } from './servers';
 import { APIPromise } from '../../core/api-promise';
+import { NamespacesPage, type NamespacesPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -24,15 +25,27 @@ export class Namespaces extends APIResource {
   }
 
   /**
-   * Get a list of all namespaces owned by the authenticated user
+   * When called without query params, returns the authenticated user's namespaces
+   * (backwards compatible). When query params are provided, searches public
+   * namespaces with pagination. Use ownerId to filter by owner, hasServers/hasSkills
+   * to filter by content, q for text search.
    *
    * @example
    * ```ts
-   * const namespaces = await client.namespaces.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const namespaceListResponse of client.namespaces.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(options?: RequestOptions): APIPromise<NamespaceListResponse> {
-    return this._client.get('/namespaces', options);
+  list(
+    query: NamespaceListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<NamespaceListResponsesNamespacesPage, NamespaceListResponse> {
+    return this._client.getAPIList('/namespaces', NamespacesPage<NamespaceListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -50,6 +63,8 @@ export class Namespaces extends APIResource {
   }
 }
 
+export type NamespaceListResponsesNamespacesPage = NamespacesPage<NamespaceListResponse>;
+
 export interface NamespaceCreateResponse {
   createdAt: string;
 
@@ -57,15 +72,7 @@ export interface NamespaceCreateResponse {
 }
 
 export interface NamespaceListResponse {
-  namespaces: Array<NamespaceListResponse.Namespace>;
-}
-
-export namespace NamespaceListResponse {
-  export interface Namespace {
-    createdAt: string;
-
-    name: string;
-  }
+  name: string;
 }
 
 export interface NamespaceSetResponse {
@@ -74,6 +81,33 @@ export interface NamespaceSetResponse {
   name: string;
 }
 
+export interface NamespaceListParams extends NamespacesPageParams {
+  /**
+   * Comma-separated list of fields to include in response
+   */
+  fields?: string;
+
+  /**
+   * Filter namespaces with servers
+   */
+  hasServers?: '0' | '1' | 'true' | 'false';
+
+  /**
+   * Filter namespaces with skills
+   */
+  hasSkills?: '0' | '1' | 'true' | 'false';
+
+  /**
+   * Filter by owner ID
+   */
+  ownerId?: string;
+
+  /**
+   * Text search query (prefix match on name)
+   */
+  q?: string;
+}
+
 Namespaces.Servers = Servers;
 
 export declare namespace Namespaces {
@@ -81,6 +115,8 @@ export declare namespace Namespaces {
     type NamespaceCreateResponse as NamespaceCreateResponse,
     type NamespaceListResponse as NamespaceListResponse,
     type NamespaceSetResponse as NamespaceSetResponse,
+    type NamespaceListResponsesNamespacesPage as NamespaceListResponsesNamespacesPage,
+    type NamespaceListParams as NamespaceListParams,
   };
 
   export {

package/src/resources/namespaces/servers.ts

@@ -7,15 +7,10 @@ import { path } from '../../internal/utils/path';
 
 export class Servers extends APIResource {
   /**
-   * Create a new server under the specified namespace. This endpoint is idempotent.
+   * **Deprecated:** Use PUT /servers/{namespace}/{server} instead. Create a new
+   * server under the specified namespace. This endpoint is idempotent.
    *
-   * @example
-   * ```ts
-   * const server = await client.namespaces.servers.create(
-   *   'xxx',
-   *   { namespace: 'namespace' },
-   * );
-   * ```
+   * @deprecated
    */
   create(
     server: string,