@composio/core / composio / Composio

Class: Composio<TProvider>

Defined in: ts/packages/core/src/composio.ts:123

This is the core class for Composio. It is used to initialize the Composio SDK and provide a global configuration.

Type Parameters

TProvider

TProvider extends BaseComposioProvider<unknown, unknown, unknown> = OpenAIProvider

Constructors

Constructor

new Composio<TProvider>(config?): Composio<TProvider>

Defined in: ts/packages/core/src/composio.ts:225

Creates a new instance of the Composio SDK.

The constructor initializes the SDK with the provided configuration options, sets up the API client, and initializes all core models (tools, toolkits, etc.).

Parameters

config?

ComposioConfig<TProvider>

Configuration options for the Composio SDK

Returns

Composio<TProvider>

Example

1 // Initialize with default configuration
2 const composio = new Composio();
3 
4 // Initialize with custom API key and base URL
5 const composio = new Composio({
6   apiKey: 'your-api-key',
7   baseURL: 'https://api.composio.dev'
8 });
9 
10 // Initialize with custom provider
11 const composio = new Composio({
12   apiKey: 'your-api-key',
13   provider: new CustomProvider()
14 });

Properties

authConfigs

authConfigs: AuthConfigs

Defined in: ts/packages/core/src/composio.ts:146

client

protected client: Composio

Defined in: ts/packages/core/src/composio.ts:130

The Composio API client.

connectedAccounts

connectedAccounts: ConnectedAccounts

Defined in: ts/packages/core/src/composio.ts:147

create()

create: (userId, routerConfig?) => Promise<ToolRouterSession<unknown, unknown, TProvider>>

Defined in: ts/packages/core/src/composio.ts:177

Creates a new tool router session for a user.

Parameters

userId

string

{string} The user id to create the session for

routerConfig?

Returns

Promise<ToolRouterSession<unknown, unknown, TProvider>>

The tool router session

Example

1 import { Composio } from '@composio/core';
2 
3 const composio = new Composio();
4 const userId = 'user_123';
5 
6 const session = await composio.create(userId, {
7  manageConnections: true,
8 });
9 
10 console.log(session.sessionId);
11 console.log(session.url);
12 console.log(session.tools());

experimental

experimental: object

Defined in: ts/packages/core/src/composio.ts:193

Experimental features

files

files: Files

Defined in: ts/packages/core/src/composio.ts:145

mcp

mcp: MCP

Defined in: ts/packages/core/src/composio.ts:148

provider

provider: TProvider

Defined in: ts/packages/core/src/composio.ts:144

toolkits

toolkits: Toolkits

Defined in: ts/packages/core/src/composio.ts:142

toolRouter

toolRouter: ToolRouter<unknown, unknown, TProvider>

Defined in: ts/packages/core/src/composio.ts:153

Experimental

Experimental feature, use with caution

tools

tools: Tools<unknown, unknown, TProvider>

Defined in: ts/packages/core/src/composio.ts:141

Core models for Composio.

triggers

triggers: Triggers<TProvider>

Defined in: ts/packages/core/src/composio.ts:143

use()

use: (id) => Promise<ToolRouterSession<unknown, unknown, TProvider>>

Defined in: ts/packages/core/src/composio.ts:188

Use an existing tool router session

Parameters

id

string

{string} The id of the session to use

Returns

Promise<ToolRouterSession<unknown, unknown, TProvider>>

The tool router session

Methods

createSession()

createSession(options?): Composio<TProvider>

Defined in: ts/packages/core/src/composio.ts:380

Creates a new instance of the Composio SDK with custom request options while preserving the existing configuration. This method is particularly useful when you need to:

Add custom headers for specific requests
Track request contexts with unique identifiers
Override default request behavior for a subset of operations

The new instance inherits all configuration from the parent instance (apiKey, baseURL, provider, etc.) but allows you to specify custom request options that will be used for all API calls made through this session.

Parameters

options?

headers?

ComposioRequestHeaders

Returns

Composio<TProvider>

A new Composio instance with the custom request options applied.

Example

1 // Create a base Composio instance
2 const composio = new Composio({
3   apiKey: 'your-api-key'
4 });
5 
6 // Create a session with request tracking headers
7 const composioWithCustomHeaders = composio.createSession({
8   headers: {
9     'x-request-id': '1234567890',
10     'x-correlation-id': 'session-abc-123',
11     'x-custom-header': 'custom-value'
12   }
13 });
14 
15 // Use the session for making API calls with the custom headers
16 await composioWithCustomHeaders.tools.list();

getClient()

getClient(): Composio

Defined in: ts/packages/core/src/composio.ts:331

Get the Composio SDK client.

Returns

Composio

The Composio API client.

getConfig()

getConfig(): ComposioConfig<TProvider>

Defined in: ts/packages/core/src/composio.ts:342

Get the configuration SDK is initialized with

Returns

ComposioConfig<TProvider>

The configuration SDK is initialized with