Files
Alberto Schiabel dafe1389b1 chore(release): prepare Python 0.22.0 and TypeScript releases (#4563)
This PR:

- bumps Python `composio` and all 13 provider packages to `0.22.0`
- regenerates `uv.lock` and adds the coordinated Python and TypeScript
release changelog
- records the manually published `@composio/typesafe@0.1.0` as the
repository baseline
- replaces the original TypeSafe minor changeset with a patch release
for `0.1.1`, so post-publication runtime fixes ship instead of being
skipped
- keeps the existing Changesets train for `@composio/core@0.19.0`,
`@composio/slim@0.19.0`, and provider updates
- verifies the release workflow, changesets, all 20 TypeScript package
builds, 147 TypeSafe tests, 590 docs static tests, and all 28 Python
distributions with Twine
2026-09-21 23:02:55 +04:00
..
2026-09-17 16:55:28 +02:00
2026-09-17 16:55:28 +02:00

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.