mirror of
https://github.com/ComposioHQ/composio.git
synced 2026-09-22 11:46:35 +08:00
sdkrelease[bot]
2573c64d97
This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to next, this PR will be updated. # Releases ## @composio/claude-agent-sdk@0.12.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/google@0.11.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/langchain@0.11.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/llamaindex@0.11.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/openai-agents@0.11.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/vercel@0.12.0 ### Minor Changes -9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. ## @composio/core@0.18.1 ### Patch Changes -8a56383: Fix: automatic S3 file downloads are now capped at 100 MiB (configurable per call) to prevent memory exhaustion from oversized or streaming responses. -7420927: Fix custom toolkit child slug mapping: reject response tools that have local handles but no exact toolkit match instead of silently dropping them or binding another toolkit's handler, derive bare-slug ambiguity from local definitions, and only reuse a same-toolkit bare alias in customToolkits(). -1d31c80: Redact credential-shaped values at the SDK log boundary. -95f9d32: Expose the runtime-conditional SSRF-safe fetch helper for protected URL upload consumers. -0d28bef: Map file-download transport failures to the SDK error contract and bound streamed response bodies. -52efb5b: Fix trigger subscriptions ignoring the `authConfigId` filter. - Updated dependencies [ab289d6] - @composio/json-schema-to-zod@0.3.2 ## @composio/experimental@0.2.4 ### Patch Changes -4e633d1: Update TypeBox to 1.3.18. ## @composio/json-schema-to-zod@0.3.2 ### Patch Changes -ab289d6: Preserve Draft 7 acceptance across primitive, composed, referenced, conditional, and typeless schemas. Enforce sibling and object/array assertions, retain positional tuple and `additionalItems` behavior, and prevent native Zod materialization from rejecting values already accepted by the source schema. ## @composio/openai@0.12.2 ### Patch Changes -620075a: Fix: stop printing MCP server URLs (credential-bearing) to stdout via console.log in the OpenAI Responses provider; log server names via logger.debug instead. ## @composio/slim@0.18.1 ### Patch Changes - Updated dependencies [ab289d6] - @composio/json-schema-to-zod@0.3.2 ## @e2e-tests/cf-workers-basic@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## @e2e-tests/cf-workers-files@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## @e2e-tests/cf-workers-tool-router-ai@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## @e2e-tests/node-claude-agent-sdk@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/claude-agent-sdk@0.12.0 ## @e2e-tests/node-custom-tools@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## @e2e-tests/node-json-schema-to-zod-v3@0.0.2 ### Patch Changes - Updated dependencies [ab289d6] - @composio/json-schema-to-zod@0.3.2 ## @e2e-tests/node-json-schema-to-zod-v4@0.0.2 ### Patch Changes - Updated dependencies [ab289d6] - @composio/json-schema-to-zod@0.3.2 ## @e2e-tests/node-mastra-tool-router-zod-v3@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/mastra@0.10.4 ## @e2e-tests/node-mastra-tool-router-zod-v4@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/mastra@0.10.4 ## @e2e-tests/node-tool-router-files@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## @e2e-tests/node-tool-router-pagination@0.0.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## anthropic-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/claude-agent-sdk@0.12.0 - @composio/anthropic@0.11.1 ## connected-accounts-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## error-handling-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## file-handling-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## google-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/google@0.11.0 ## json-schema-to-zod-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## langchain-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/langchain@0.11.0 ## llamaindex-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/llamaindex@0.11.0 ## mastra-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/mastra@0.10.4 ## mcp-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## modifiers-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## openai-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [620075a] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/openai-agents@0.11.0 - @composio/openai@0.12.2 ## session-management-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## tool-router-example@1.0.12 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/claude-agent-sdk@0.12.0 - @composio/vercel@0.12.0 - @composio/openai-agents@0.11.0 ## toolkits-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## tools-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## triggers-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## vercel-example@0.1.11 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [9447932] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 - @composio/vercel@0.12.0 ## versioning-example@0.1.2 ### Patch Changes - Updated dependencies [8a56383] - Updated dependencies [7420927] - Updated dependencies [1d31c80] - Updated dependencies [95f9d32] - Updated dependencies [0d28bef] - Updated dependencies [52efb5b] - @composio/core@0.18.1 ## @composio/json-schema-to-effect-schema@0.1.1 ### Patch Changes -ab289d6: Translate draft-4 boolean `exclusiveMinimum`/`exclusiveMaximum` flags (as emitted by OpenAPI 3.0 exporters) into their Draft 7 numeric spelling so exclusive bounds are enforced instead of silently ignored. Co-authored-by: sdkrelease[bot] <294075132+sdkrelease[bot]@users.noreply.github.com>
composio.dev • Documentation • Quickstart • Changelog
Composio
Composio gives your AI agents 1000+ pre-authenticated toolkits, per-user sessions, authentication, triggers, and a sandbox, so you can ship agents that turn intent into action.
This is the Composio SDK monorepo. It contains:
@composio/core: TypeScript SDKcomposio: Python SDKcomposioCLI: search, execute, and script tools from your shell- Provider adapters for OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain, and more
Quickstart
Create a session for a user, hand its tools to your agent, and let the agent take action across 1000+ apps. Grab a COMPOSIO_API_KEY from the dashboard first.
TypeScript
npm install @composio/core @composio/openai-agents @openai/agents
@composio/coreintentionally packages its TypeScript source and SDK docs so the installed package is inspectable to coding agents. If you want a smaller install with the same API, use@composio/slim.
import { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";
const composio = new Composio({ provider: new OpenAIAgentsProvider() });
// Each session is scoped to one of your users
const session = await composio.create("user_123");
const tools = await session.tools();
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful assistant. Use Composio tools to take action.",
tools,
});
const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);
Python
pip install composio composio-openai-agents openai-agents
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner
composio = Composio(provider=OpenAIAgentsProvider())
# Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful assistant. Use Composio tools to take action.",
tools=tools,
)
result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)
By default a session gets meta tools that discover, authenticate, and execute app tools at runtime, so you don't load hundreds of tool definitions into context. Store session.session_id and reuse it with composio.use() across turns. See what a session is and configuring sessions for restricting toolkits, auth configs, and connected accounts.
Prefer MCP? Every session also exposes a hosted MCP endpoint. Pass mcp: true to composio.create() and point Claude, Cursor, or any MCP client at session.mcp.url. See sessions via MCP.
CLI
The composio CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.
curl -fsSL https://composio.dev/install | sh
The installer puts composio on your PATH for future terminals. Open a new terminal, then run composio login. See INSTALL.md for shell setup overrides, including COMPOSIO_INSTALL_SHELL=none for install-only runs.
Use composio search to find tools, composio execute to run them, composio link to connect accounts, and composio run to script workflows in TypeScript. See the CLI docs.
Providers
A provider adapts Composio tools to your agent framework's native tool format:
| Provider | TypeScript | Python |
|---|---|---|
| OpenAI | @composio/openai |
composio-openai |
| OpenAI Agents | @composio/openai-agents |
composio-openai-agents |
| Anthropic | @composio/anthropic |
composio-anthropic |
| Claude Agent SDK | @composio/claude-agent-sdk |
composio-claude-agent-sdk |
| Vercel AI SDK | @composio/vercel |
— |
| Google GenAI | @composio/google |
composio-gemini, composio-google |
| Google ADK | — | composio-google-adk |
| LangChain | @composio/langchain |
composio-langchain |
| LangGraph | via @composio/langchain |
composio-langgraph |
| LlamaIndex | @composio/llamaindex |
composio-llamaindex |
| Mastra | @composio/mastra |
— |
| Pi | @composio/experimental* |
— |
| Cloudflare Workers AI | @composio/cloudflare |
— |
| CrewAI | — | composio-crewai |
| AutoGen | — | composio-autogen |
* The Pi provider is experimental and ships from @composio/experimental.
Don't see your framework? Build a custom provider, or skip providers entirely and connect over MCP.
All packages
Everything published from this repo:
| Package | Description |
|---|---|
@composio/core |
TypeScript SDK |
@composio/slim |
@composio/core without packaged source or docs; same API, smaller install |
composio CLI |
Standalone CLI binary: curl -fsSL https://composio.dev/install | sh |
@composio/experimental |
Experimental integrations, including the Pi provider |
@composio/json-schema-to-zod |
JSON Schema to Zod conversion |
@composio/* provider adapters |
OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare |
composio |
Python SDK |
composio-* provider adapters |
OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Gemini, Google, Google ADK, LangChain, LangGraph, LlamaIndex, CrewAI, AutoGen |
Repository layout
ts/ TypeScript SDK workspace
packages/core/ @composio/core
packages/providers/ Provider adapters
packages/cli/ Composio CLI
python/ Python SDK and provider packages
docs/ Documentation site (docs.composio.dev)
The TypeScript SDK is tested against Node 22+; the Python SDK supports Python 3.10+.
Development
mise install # pinned toolchain (Node, Python, pnpm)
pnpm install
pnpm build
pnpm test
Python commands run from python/; see python/README.md. We welcome contributions to both SDKs; read the contribution guidelines before submitting pull requests.
Support
License
MIT. See LICENSE.