Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 03:37 UTC
| 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) |