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 TypeScript workspace
This directory contains the TypeScript half of the Composio SDK monorepo: the core SDK, provider adapters, the CLI, examples, and end-to-end tests. For an overview of Composio itself, start at the root README and docs.composio.dev.
If you just want to use the SDK:
npm install @composio/core
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
const session = await composio.create('user_123');
const tools = await session.tools();
See the @composio/core README and the quickstart for the full flow, including provider setup for your agent framework.
Packages
Published packages:
| Package | Description |
|---|---|
@composio/core |
The Composio SDK. Ships its TypeScript source and SDK docs so installed copies are inspectable by coding agents. |
@composio/slim |
Same API as @composio/core without the packaged source and docs; smaller install. |
composio CLI |
Standalone CLI binary: search, execute, and script tools from your shell. |
@composio/* providers |
Adapters that format Composio tools for agent frameworks (OpenAI, Anthropic, Vercel AI SDK, LangChain, and more). See the provider table. |
@composio/experimental |
Experimental integrations, currently the Pi provider. |
@composio/json-schema-to-zod |
JSON Schema to Zod conversion. |
Internal (unpublished) packages: cli-keyring and cli-local-tools support the CLI; ts-builders generates TypeScript source.
Layout
ts/
packages/ Published and internal packages (see above)
examples/ Runnable examples per feature and framework
e2e-tests/ Runtime E2E tests (Node, Deno, Cloudflare Workers, CLI)
docs/ Workspace SDK docs: API notes and internal guides
scripts/ Build, validation, and scaffolding scripts
vendor/ Read-only reference submodules; do not edit
Development
Commands run from the repository root. Install the pinned toolchain first:
mise install
pnpm install
Build and verify:
pnpm build:packages # build all TS packages
pnpm typecheck # typecheck all TS packages
pnpm lint:packages # oxlint over ts/packages
pnpm test # package unit tests plus example validation
Runtime E2E suites (require credentials):
pnpm test:e2e:node
pnpm test:e2e:deno
pnpm test:e2e:cloudflare
pnpm test:e2e:cli
Scaffolding:
pnpm create:provider <name> [--agentic] # new provider package
pnpm create:example <name> # new example under ts/examples
Changesets are required for changes to published packages; see the contribution guidelines.