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 2.7 KB

Composio TypeScript providers

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.

Packages

Package Framework
@composio/openai OpenAI Chat Completions and Responses APIs
@composio/openai-agents OpenAI Agents SDK
@composio/anthropic Anthropic Messages API
@composio/claude-agent-sdk Claude Agent SDK
@composio/vercel Vercel AI SDK
@composio/google Google GenAI
@composio/langchain LangChain and LangGraph
@composio/llamaindex LlamaIndex
@composio/mastra Mastra
@composio/cloudflare Cloudflare Workers AI
@composio/typesafe TypeSafe Jev (System One, no tool calling)

Each package README has an install command and a runnable quickstart.

Provider types

Providers extend one of two base classes from @composio/core:

  • 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.
  • Agentic (BaseAgenticProvider): wrap tools with an execute function baked in (LangChain, LlamaIndex, Mastra, Vercel, OpenAI Agents). The framework runs the tool loop itself.

Creating a new provider

Scaffold a package from the repository root:

pnpm create:provider <provider-name> [--agentic]

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.

If you are building an adapter outside this repo, see the custom providers guide.