Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 45 lines 2.7 KB
Rendered Raw
1 # Composio TypeScript providers
2
3 Each package in this directory adapts Composio tools to one agent framework's native tool format. You pass a provider to `new Composio({ provider })`, and `session.tools()` returns tools your framework can call directly.
4
5 ## Packages
6
7 | Package | Framework |
8 | ------------------------------------------------ | ------------------------------------------ |
9 | [`@composio/openai`](openai) | OpenAI Chat Completions and Responses APIs |
10 | [`@composio/openai-agents`](openai-agents) | OpenAI Agents SDK |
11 | [`@composio/anthropic`](anthropic) | Anthropic Messages API |
12 | [`@composio/claude-agent-sdk`](claude-agent-sdk) | Claude Agent SDK |
13 | [`@composio/vercel`](vercel) | Vercel AI SDK |
14 | [`@composio/google`](google) | Google GenAI |
15 | [`@composio/langchain`](langchain) | LangChain and LangGraph |
16 | [`@composio/llamaindex`](llamaindex) | LlamaIndex |
17 | [`@composio/mastra`](mastra) | Mastra |
18 | [`@composio/cloudflare`](cloudflare) | Cloudflare Workers AI |
19 | [`@composio/typesafe`](typesafe) | TypeSafe Jev (System One, no tool calling) |
20
21 Each package README has an install command and a runnable quickstart.
22
23 ## Provider types
24
25 Providers extend one of two base classes from `@composio/core`:
26
27 - **Non-agentic** (`BaseNonAgenticProvider`): format tool schemas for a raw model API (OpenAI, Anthropic, Cloudflare). Your code runs the tool loop, calling helpers like `executeToolCall` or `handleToolCalls` on the provider.
28 - **Agentic** (`BaseAgenticProvider`): wrap tools with an execute function baked in (LangChain, LlamaIndex, Mastra, Vercel, OpenAI Agents). The framework runs the tool loop itself.
29
30 ## Creating a new provider
31
32 Scaffold a package from the repository root:
33
34 ```bash
35 pnpm create:provider <provider-name> [--agentic]
36 ```
37
38 This creates `ts/packages/providers/<provider-name>` with `src/index.ts`, `package.json`, and build config. Implement `wrapTool` and `wrapTools` (plus `executeToolCall` for non-agentic providers), then add tests covering wrapping and execution handling.
39
40 If you are building an adapter outside this repo, see the [custom providers guide](https://docs.composio.dev/docs/providers/custom-providers).
41
42 ## Links
43
44 - [Provider docs](https://docs.composio.dev/docs/providers)
45 - [Composio documentation](https://docs.composio.dev)