@composio/client 0.1.0-alpha.36 → 0.1.0-alpha.38

package/src/resources/mcp/index.ts

@@ -10,10 +10,8 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
-  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
   type McpRetrieveAppParams,
-  type McpValidateParams,
 } from './mcp';

package/src/resources/mcp/mcp.ts

@@ -6,7 +6,6 @@ import { Custom, CustomCreateParams, CustomCreateResponse } from './custom';
 import * as GenerateAPI from './generate';
 import { Generate, GenerateURLParams, GenerateURLResponse } from './generate';
 import { APIPromise } from '../../core/api-promise';
-import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -121,32 +120,6 @@ export class Mcp extends APIResource {
   ): APIPromise<McpRetrieveAppResponse> {
     return this._client.get(path`/api/v3/mcp/app/${appKey}`, { query, ...options });
   }
-
-  /**
-   * Admin-only endpoint that validates a Model Control Protocol (MCP) server and
-   * retrieves its complete configuration details, including authentication
-   * information. This endpoint is typically used by the MCP service itself to
-   * authenticate and authorize connection requests from clients.
-   *
-   * @example
-   * ```ts
-   * const response = await client.mcp.validate(
-   *   '550e8400-e29b-41d4-a716-446655440000',
-   *   { 'x-composio-admin-token': 'admin_tk_12345abcdef' },
-   * );
-   * ```
-   */
-  validate(
-    uuid: string,
-    params: McpValidateParams,
-    options?: RequestOptions,
-  ): APIPromise<McpValidateResponse> {
-    const { 'x-composio-admin-token': xComposioAdminToken } = params;
-    return this._client.get(path`/api/v3/mcp/validate/${uuid}`, {
-      ...options,
-      headers: buildHeaders([{ 'x-composio-admin-token': xComposioAdminToken }, options?.headers]),
-    });
-  }
 }
 
 /**
@@ -663,93 +636,6 @@ export namespace McpRetrieveAppResponse {
   }
 }
 
-/**
- * Complete validation and connection details for an MCP server
- */
-export interface McpValidateResponse {
-  /**
-   * Unique identifier of the validated MCP server
-   */
-  id: string;
-
-  /**
-   * Client information for the MCP server
-   */
-  client: McpValidateResponse.Client;
-
-  /**
-   * Human-readable name of the MCP server
-   */
-  name: string;
-
-  /**
-   * URL endpoint for connecting to this MCP server
-   */
-  url: string;
-
-  /**
-   * User authentication data for the MCP server
-   */
-  userData: McpValidateResponse.UserData;
-
-  /**
-   * List of action identifiers enabled for this server
-   */
-  allowed_tools?: Array<string> | null;
-
-  /**
-   * Flag indicating if this server uses custom authentication headers
-   */
-  customAuthHeaders?: boolean;
-
-  /**
-   * Flag indicating if this server is managed by Composio and not by the user
-   */
-  managed_auth_via_composio?: boolean;
-
-  /**
-   * List of application identifiers this server is configured for
-   */
-  toolkits?: Array<string>;
-}
-
-export namespace McpValidateResponse {
-  /**
-   * Client information for the MCP server
-   */
-  export interface Client {
-    /**
-     * Project identifier that owns this MCP server
-     */
-    id: string;
-
-    /**
-     * Organization identifier that owns the project
-     */
-    orgId: string;
-  }
-
-  /**
-   * User authentication data for the MCP server
-   */
-  export interface UserData {
-    /**
-     * User identifier for API access
-     */
-    id: string;
-
-    /**
-     * API key for authenticating requests to the Composio API
-     */
-    apiKey: string;
-
-    /**
-     * Email address associated with the API key user
-     */
-    email: string;
-  }
-}
-
 export interface McpCreateParams {
   /**
    * ID references to existing authentication configurations
@@ -883,13 +769,6 @@ export interface McpRetrieveAppParams {
   toolkits?: string;
 }
 
-export interface McpValidateParams {
-  /**
-   * Administrative access token required for validating MCP servers
-   */
-  'x-composio-admin-token': string;
-}
-
 Mcp.Custom = Custom;
 Mcp.Generate = Generate;
 
@@ -901,12 +780,10 @@ export declare namespace Mcp {
     type McpListResponse as McpListResponse,
     type McpDeleteResponse as McpDeleteResponse,
     type McpRetrieveAppResponse as McpRetrieveAppResponse,
-    type McpValidateResponse as McpValidateResponse,
     type McpCreateParams as McpCreateParams,
     type McpUpdateParams as McpUpdateParams,
     type McpListParams as McpListParams,
     type McpRetrieveAppParams as McpRetrieveAppParams,
-    type McpValidateParams as McpValidateParams,
   };
 
   export {

package/src/resources/tool-router.ts

@@ -0,0 +1,107 @@
+// 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 ToolRouter extends APIResource {
+  /**
+   * Creates a new session for the tool router lab feature. This endpoint initializes
+   * a new session with specified toolkits and their authentication configurations.
+   * The session provides an isolated environment for testing and managing tool
+   * routing logic with scoped MCP server access.
+   *
+   * @example
+   * ```ts
+   * const response = await client.toolRouter.createSession({
+   *   user_id: 'user_123456789',
+   *   config: {
+   *     toolkits: [
+   *       {
+   *         toolkit: 'gmail',
+   *         auth_config_id: 'auth_config_123',
+   *       },
+   *       {
+   *         toolkit: 'slack',
+   *         auth_config_id: 'auth_config_456',
+   *       },
+   *       { toolkit: 'github' },
+   *     ],
+   *   },
+   * });
+   * ```
+   */
+  createSession(
+    body: ToolRouterCreateSessionParams,
+    options?: RequestOptions,
+  ): APIPromise<ToolRouterCreateSessionResponse> {
+    return this._client.post('/api/v3/labs/tool_router/session', { body, ...options });
+  }
+}
+
+export interface ToolRouterCreateSessionResponse {
+  /**
+   * MCP server endpoint URL for this specific chat session
+   */
+  chat_session_mcp_url: string;
+
+  /**
+   * Generated session identifier
+   */
+  session_id: string;
+
+  /**
+   * MCP server endpoint URL for this specific tool router instance
+   */
+  tool_router_instance_mcp_url: string;
+}
+
+export interface ToolRouterCreateSessionParams {
+  /**
+   * Unique user identifier for the session owner
+   */
+  user_id: string;
+
+  /**
+   * Session configuration including enabled toolkits and their auth configs
+   */
+  config?: ToolRouterCreateSessionParams.Config;
+}
+
+export namespace ToolRouterCreateSessionParams {
+  /**
+   * Session configuration including enabled toolkits and their auth configs
+   */
+  export interface Config {
+    /**
+     * Whether to manually manage connections
+     */
+    manually_manage_connections?: boolean | null;
+
+    /**
+     * Array of toolkit configurations with optional auth configs
+     */
+    toolkits?: Array<Config.Toolkit>;
+  }
+
+  export namespace Config {
+    export interface Toolkit {
+      /**
+       * Toolkit identifier (e.g., gmail, slack, github)
+       */
+      toolkit: string;
+
+      /**
+       * Specific auth configuration ID for this toolkit
+       */
+      auth_config_id?: string;
+    }
+  }
+}
+
+export declare namespace ToolRouter {
+  export {
+    type ToolRouterCreateSessionResponse as ToolRouterCreateSessionResponse,
+    type ToolRouterCreateSessionParams as ToolRouterCreateSessionParams,
+  };
+}

package/src/resources/toolkits.ts

@@ -11,8 +11,12 @@ export class Toolkits extends APIResource {
    * slug identifier. This endpoint provides detailed metadata, authentication
    * configuration options, and feature counts for the requested toolkit.
    */
-  retrieve(slug: string, options?: RequestOptions): APIPromise<ToolkitRetrieveResponse> {
-    return this._client.get(path`/api/v3/toolkits/${slug}`, options);
+  retrieve(
+    slug: string,
+    query: ToolkitRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ToolkitRetrieveResponse> {
+    return this._client.get(path`/api/v3/toolkits/${slug}`, { query, ...options });
   }
 
   /**
@@ -112,6 +116,11 @@ export namespace ToolkitRetrieveResponse {
    * statistics
    */
   export interface Meta {
+    /**
+     * Available versions of the toolkit
+     */
+    available_versions: Array<string>;
+
     /**
      * List of categories associated with this toolkit
      */
@@ -147,6 +156,11 @@ export namespace ToolkitRetrieveResponse {
      */
     updated_at: string;
 
+    /**
+     * Version of the toolkit
+     */
+    version: string;
+
     /**
      * Link to the toolkit's main application or service website
      */
@@ -416,6 +430,11 @@ export namespace ToolkitListResponse {
        */
       updated_at: string;
 
+      /**
+       * Version of the toolkit
+       */
+      version: string;
+
       /**
        * Link to the toolkit's main application or service website
        */
@@ -467,6 +486,13 @@ export namespace ToolkitRetrieveCategoriesResponse {
   }
 }
 
+export interface ToolkitRetrieveParams {
+  /**
+   * Version of the toolkit
+   */
+  version?: string;
+}
+
 export interface ToolkitListParams {
   /**
    * Filter toolkits by category
@@ -487,7 +513,7 @@ export interface ToolkitListParams {
   is_local?: boolean | null;
 
   /**
-   * Number of items per page
+   * Number of items per page, max allowed is 1000
    */
   limit?: number | null;
 
@@ -514,6 +540,7 @@ export declare namespace Toolkits {
     type ToolkitRetrieveResponse as ToolkitRetrieveResponse,
     type ToolkitListResponse as ToolkitListResponse,
     type ToolkitRetrieveCategoriesResponse as ToolkitRetrieveCategoriesResponse,
+    type ToolkitRetrieveParams as ToolkitRetrieveParams,
     type ToolkitListParams as ToolkitListParams,
     type ToolkitRetrieveCategoriesParams as ToolkitRetrieveCategoriesParams,
   };

package/src/resources/tools.ts

@@ -131,6 +131,11 @@ export interface ToolRetrieveResponse {
    */
   input_parameters: { [key: string]: unknown };
 
+  /**
+   * Indicates if this tool is deprecated and may be removed in the future
+   */
+  is_deprecated: boolean;
+
   /**
    * Human-readable display name of the tool
    */
@@ -252,6 +257,11 @@ export namespace ToolListResponse {
      */
     input_parameters: { [key: string]: unknown };
 
+    /**
+     * Indicates if this tool is deprecated and may be removed in the future
+     */
+    is_deprecated: boolean;
+
     /**
      * Human-readable display name of the tool
      */
@@ -407,7 +417,8 @@ export type ToolRetrieveEnumResponse = Array<string>;
 
 export interface ToolRetrieveParams {
   /**
-   * Can be omitted, null, a string, or an object mapping toolkit names to versions
+   * Toolkit version specification. Use "latest" for latest versions or bracket
+   * notation for specific versions per toolkit.
    */
   toolkit_versions?: string | { [key: string]: string };
 
@@ -419,9 +430,9 @@ export interface ToolRetrieveParams {
 
 export interface ToolListParams {
   /**
-   * Filter tools by auth config id
+   * Comma-separated list of auth config IDs to filter tools by
    */
-  auth_config_ids?: Array<string> | null;
+  auth_config_ids?: string | Array<string>;
 
   /**
    * Cursor for pagination. The cursor is a base64 encoded string of the page and
@@ -442,7 +453,7 @@ export interface ToolListParams {
   include_deprecated?: boolean;
 
   /**
-   * Number of items per page
+   * Number of items per page, max allowed is 1000
    */
   limit?: number | null;
 
@@ -473,7 +484,8 @@ export interface ToolListParams {
   toolkit_slug?: string;
 
   /**
-   * Can be omitted, null, a string, or an object mapping toolkit names to versions
+   * Toolkit version specification. Use "latest" for latest versions or bracket
+   * notation for specific versions per toolkit.
    */
   toolkit_versions?: string | { [key: string]: string };
 }
@@ -510,7 +522,8 @@ export interface ToolExecuteParams {
     | ToolExecuteParams.UnionMember3
     | ToolExecuteParams.UnionMember4
     | ToolExecuteParams.UnionMember5
-    | ToolExecuteParams.UnionMember6;
+    | ToolExecuteParams.UnionMember6
+    | ToolExecuteParams.UnionMember7;
 
   /**
    * Natural language description of the task to perform (mutually exclusive with
@@ -1045,6 +1058,70 @@ export namespace ToolExecuteParams {
       [k: string]: unknown;
     }
   }
+
+  export interface UnionMember7 {
+    authScheme: 'SERVICE_ACCOUNT';
+
+    toolkitSlug: string;
+
+    val: UnionMember7.Val;
+  }
+
+  export namespace UnionMember7 {
+    export interface Val {
+      application_id: string;
+
+      installation_id: string;
+
+      private_key: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
 }
 
 export interface ToolGetInputParams {
@@ -1102,7 +1179,8 @@ export interface ToolProxyParams {
     | ToolProxyParams.UnionMember3
     | ToolProxyParams.UnionMember4
     | ToolProxyParams.UnionMember5
-    | ToolProxyParams.UnionMember6;
+    | ToolProxyParams.UnionMember6
+    | ToolProxyParams.UnionMember7;
 
   /**
    * Additional HTTP headers or query parameters to include in the request
@@ -1587,6 +1665,70 @@ export namespace ToolProxyParams {
     }
   }
 
+  export interface UnionMember7 {
+    authScheme: 'SERVICE_ACCOUNT';
+
+    toolkitSlug: string;
+
+    val: UnionMember7.Val;
+  }
+
+  export namespace UnionMember7 {
+    export interface Val {
+      application_id: string;
+
+      installation_id: string;
+
+      private_key: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
   export interface Parameter {
     /**
      * Parameter name

package/src/resources/trigger-instances/index.ts

@@ -1,12 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Handle,
-  type HandleRetrieveResponse,
-  type HandleExecuteResponse,
-  type HandleRetrieveParams,
-  type HandleExecuteParams,
-} from './handle';
 export {
   Manage,
   type ManageUpdateResponse,

package/src/resources/trigger-instances/trigger-instances.ts

@@ -1,14 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as HandleAPI from './handle';
-import {
-  Handle,
-  HandleExecuteParams,
-  HandleExecuteResponse,
-  HandleRetrieveParams,
-  HandleRetrieveResponse,
-} from './handle';
 import * as ManageAPI from './manage';
 import { Manage, ManageDeleteResponse, ManageUpdateParams, ManageUpdateResponse } from './manage';
 import { APIPromise } from '../../core/api-promise';
@@ -16,7 +8,6 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class TriggerInstances extends APIResource {
-  handle: HandleAPI.Handle = new HandleAPI.Handle(this._client);
   manage: ManageAPI.Manage = new ManageAPI.Manage(this._client);
 
   listActive(
@@ -180,7 +171,7 @@ export interface TriggerInstanceListActiveParams {
   deprecatedConnectedAccountUuids?: Array<string> | null;
 
   /**
-   * Number of items per page
+   * Number of items per page, max allowed is 1000
    */
   limit?: number | null;
 
@@ -228,7 +219,6 @@ export interface TriggerInstanceUpsertParams {
   triggerConfig?: { [key: string]: unknown };
 }
 
-TriggerInstances.Handle = Handle;
 TriggerInstances.Manage = Manage;
 
 export declare namespace TriggerInstances {
@@ -239,14 +229,6 @@ export declare namespace TriggerInstances {
     type TriggerInstanceUpsertParams as TriggerInstanceUpsertParams,
   };
 
-  export {
-    Handle as Handle,
-    type HandleRetrieveResponse as HandleRetrieveResponse,
-    type HandleExecuteResponse as HandleExecuteResponse,
-    type HandleRetrieveParams as HandleRetrieveParams,
-    type HandleExecuteParams as HandleExecuteParams,
-  };
-
   export {
     Manage as Manage,
     type ManageUpdateResponse as ManageUpdateResponse,

package/src/resources/triggers-types.ts

@@ -78,6 +78,11 @@ export interface TriggersTypeRetrieveResponse {
    * The trigger mechanism - either webhook (event-based) or poll (scheduled check)
    */
   type: 'webhook' | 'poll';
+
+  /**
+   * Version of the trigger type
+   */
+  version: string;
 }
 
 export namespace TriggersTypeRetrieveResponse {
@@ -155,6 +160,11 @@ export namespace TriggersTypeListResponse {
      * The trigger mechanism - either webhook (event-based) or poll (scheduled check)
      */
     type: 'webhook' | 'poll';
+
+    /**
+     * Version of the trigger type
+     */
+    version: string;
   }
 
   export namespace Item {
@@ -202,7 +212,7 @@ export interface TriggersTypeListParams {
   cursor?: string;
 
   /**
-   * Number of items per page
+   * Number of items per page, max allowed is 1000
    */
   limit?: number | null;
 
@@ -212,7 +222,8 @@ export interface TriggersTypeListParams {
   toolkit_slugs?: Array<string> | null;
 
   /**
-   * Can be omitted, null, a string, or an object mapping toolkit names to versions
+   * Toolkit version specification. Use "latest" for latest versions or bracket
+   * notation for specific versions per toolkit.
    */
   toolkit_versions?: string | { [key: string]: string };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.36'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.38'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.36";
+export declare const VERSION = "0.1.0-alpha.38";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.36";
+export declare const VERSION = "0.1.0-alpha.38";
 //# sourceMappingURL=version.d.ts.map