@composio/client 0.1.0-alpha.35 → 0.1.0-alpha.37

package/src/resources/index.ts

@@ -17,9 +17,7 @@ export {
   Cli,
   type CliCreateSessionResponse,
   type CliGetSessionResponse,
-  type CliLinkSessionResponse,
   type CliGetSessionParams,
-  type CliLinkSessionParams,
 } from './cli';
 export {
   ConnectedAccounts,
@@ -41,14 +39,7 @@ export {
   type FileListParams,
   type FileCreatePresignedURLParams,
 } from './files';
-export {
-  Link,
-  type LinkCreateResponse,
-  type LinkRetrieveResponse,
-  type LinkSubmitResponse,
-  type LinkCreateParams,
-  type LinkSubmitParams,
-} from './link';
+export { Link, type LinkCreateResponse, type LinkCreateParams } from './link';
 export {
   Mcp,
   type McpCreateResponse,
@@ -57,31 +48,27 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
-  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
   type McpRetrieveAppParams,
-  type McpValidateParams,
 } from './mcp/mcp';
 export {
   Migration,
   type MigrationRetrieveNanoidResponse,
   type MigrationRetrieveNanoidParams,
 } from './migration';
-export { Org } from './org/org';
 export {
-  TeamMembers,
-  type TeamMemberUpdateResponse,
-  type TeamMemberListResponse,
-  type TeamMemberRemoveResponse,
-  type TeamMemberUpdateParams,
-} from './team-members';
+  ToolRouter,
+  type ToolRouterCreateSessionResponse,
+  type ToolRouterCreateSessionParams,
+} from './tool-router';
 export {
   Toolkits,
   type ToolkitRetrieveResponse,
   type ToolkitListResponse,
   type ToolkitRetrieveCategoriesResponse,
+  type ToolkitRetrieveParams,
   type ToolkitListParams,
   type ToolkitRetrieveCategoriesParams,
 } from './toolkits';

package/src/resources/link.ts

@@ -3,7 +3,6 @@
 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 Link extends APIResource {
   /**
@@ -13,20 +12,6 @@ export class Link extends APIResource {
   create(body: LinkCreateParams, options?: RequestOptions): APIPromise<LinkCreateResponse> {
     return this._client.post('/api/v3/connected_accounts/link', { body, ...options });
   }
-
-  /**
-   * Retrieves information about an authentication session using the link token
-   */
-  retrieve(token: string, options?: RequestOptions): APIPromise<LinkRetrieveResponse> {
-    return this._client.get(path`/api/v3/internal/connected_accounts/link/${token}`, options);
-  }
-
-  /**
-   * Submits authentication input for a link session
-   */
-  submit(token: string, body: LinkSubmitParams, options?: RequestOptions): APIPromise<LinkSubmitResponse> {
-    return this._client.post(path`/api/v3/internal/connected_accounts/link/${token}`, { body, ...options });
-  }
 }
 
 export interface LinkCreateResponse {
@@ -51,108 +36,6 @@ export interface LinkCreateResponse {
   redirect_url: string;
 }
 
-export interface LinkRetrieveResponse {
-  connected_account: LinkRetrieveResponse.ConnectedAccount;
-
-  project: LinkRetrieveResponse.Project;
-
-  toolkit: LinkRetrieveResponse.Toolkit;
-}
-
-export namespace LinkRetrieveResponse {
-  export interface ConnectedAccount {
-    /**
-     * The connected account ID
-     */
-    id: string;
-
-    mode:
-      | 'OAUTH2'
-      | 'OAUTH1'
-      | 'API_KEY'
-      | 'BASIC'
-      | 'BILLCOM_AUTH'
-      | 'BEARER_TOKEN'
-      | 'GOOGLE_SERVICE_ACCOUNT'
-      | 'NO_AUTH'
-      | 'BASIC_WITH_JWT'
-      | 'CALCOM_AUTH';
-
-    status: 'INITIATED' | 'ACTIVE' | 'FAILED';
-
-    /**
-     * The user callback URL if applicable. If active, redirect to this URL
-     */
-    callback_url?: string;
-
-    expected_input_fields?: Array<ConnectedAccount.ExpectedInputField>;
-
-    /**
-     * The OAuth provider redirect URL if applicable. If active, redirect to this URL
-     */
-    redirect_url?: string;
-  }
-
-  export namespace ConnectedAccount {
-    export interface ExpectedInputField {
-      displayName: string;
-
-      name: string;
-
-      required: boolean;
-
-      type: string;
-
-      default?: string | null;
-
-      description?: string;
-
-      legacy_template_name?: string;
-    }
-  }
-
-  export interface Project {
-    /**
-     * The project logo URL
-     */
-    logo?: string;
-
-    /**
-     * The project name
-     */
-    name?: string;
-  }
-
-  export interface Toolkit {
-    /**
-     * The toolkit logo
-     */
-    logo: string;
-
-    /**
-     * The toolkit display name
-     */
-    name: string;
-
-    /**
-     * The toolkit slug
-     */
-    slug: string;
-  }
-}
-
-export interface LinkSubmitResponse {
-  /**
-   * The status of the connection attempt
-   */
-  status: 'ACTIVE' | 'FAILED';
-
-  /**
-   * The user callback URL if applicable
-   */
-  user_callback_url?: string;
-}
-
 export interface LinkCreateParams {
   /**
    * The auth config id to create a link for
@@ -170,19 +53,6 @@ export interface LinkCreateParams {
   callback_url?: string;
 }
 
-export interface LinkSubmitParams {
-  /**
-   * The input fields for authentication
-   */
-  input: { [key: string]: unknown };
-}
-
 export declare namespace Link {
-  export {
-    type LinkCreateResponse as LinkCreateResponse,
-    type LinkRetrieveResponse as LinkRetrieveResponse,
-    type LinkSubmitResponse as LinkSubmitResponse,
-    type LinkCreateParams as LinkCreateParams,
-    type LinkSubmitParams as LinkSubmitParams,
-  };
+  export { type LinkCreateResponse as LinkCreateResponse, type LinkCreateParams as LinkCreateParams };
 }

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,96 @@
+// 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: 'auth_config_123' },
+   *       { toolkit: 'slack', auth_config: '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 session
+   */
+  chat_session_mcp_url: string;
+
+  /**
+   * Generated session identifier
+   */
+  session_id: 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?: 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 });
   }
 
   /**
@@ -147,6 +151,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 +425,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 +481,13 @@ export namespace ToolkitRetrieveCategoriesResponse {
   }
 }
 
+export interface ToolkitRetrieveParams {
+  /**
+   * Version of the toolkit
+   */
+  version?: string;
+}
+
 export interface ToolkitListParams {
   /**
    * Filter toolkits by category
@@ -514,6 +535,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,
   };