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

@composio/anthropic

0.11.8

Patch Changes

  • 55d8924: Preserve the originating tool_use_id in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.
  • d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.

0.11.7

Patch Changes

  • fecf1bf: Accept @anthropic-ai/sdk ^0.135.0 as a peer dependency.

0.11.6

Patch Changes

  • ba7c9a1: Remove the unused @mastra/mcp peer dependency. The provider never imported it, but package managers that install peers automatically pulled in about 234 extra packages.

0.11.5

Patch Changes

  • fd59eba: Update SDK and provider dependencies to compatible releases. Accept Anthropic SDK 0.132 and OpenAI Agents 0.20 in provider peer ranges, and add Pi coding-agent 1.x to the experimental provider's supported peer range.

0.11.4

Patch Changes

  • 72fbd00: Fix cacheTools: true exceeding Anthropic's 4-breakpoint-per-request limit (shared with the system prompt and messages), which causes the whole request to be rejected. wrapTools now places a single breakpoint on the last tool, which caches the entire tool list since a breakpoint covers everything up to and including it, instead of one on every tool. handleToolCalls no longer marks tool_result blocks, because they accumulate in the message history and would exceed the limit after a few turns.

0.11.3

Patch Changes

  • 485c09d: Refresh runtime dependencies and support Anthropic SDK 0.127 in the Anthropic provider.

0.11.2

Patch Changes

  • 62e51e8: Refresh runtime dependencies and extend provider peer compatibility to the latest supported Anthropic and OpenAI Agents SDK releases.
  • 7055914: Move published dependency ranges to their current upstream releases: zod 4.5, openai 7.10, typebox 1.3.27, @mastra/schema-compat 1.3.8, and @cloudflare/workers-types 5.20260905. @composio/anthropic also accepts @anthropic-ai/sdk 0.124 as a peer, the line it is now tested against.
  • 20aaa95: Accept the upcoming core prerelease and the upstream versions already used to build and test providers.

0.11.1

Patch Changes

  • db7b576: Declare Node.js 22.22.3 as the minimum supported runtime for every published TypeScript package so package managers surface incompatible runtimes before users encounter ESM loading failures.

0.11.0

Minor Changes

  • 760f8d0: Allow OpenAI and Anthropic provider tool-call helpers to execute through a supplied Tool Router session. Session meta-tools now retain their session context while provider argument normalization remains intact; existing user-ID calls continue to use direct execution. Anthropic helper failures now preserve their error text in { error } results without changing successful payloads. Custom provider subclasses overriding executeToolCall or handleToolCalls may require updates because these methods now accept session targets.

0.10.1

Patch Changes

  • 7125576: Normalize duplicate JSON Schema required entries before provider tool schemas are emitted.
  • 58bc93b: Refresh dependency ranges and lockfiles across the workspace.
  • fa933a6: Fix the homepage links in these packages' package.json. They pointed at github.com/ComposioHQ/composio/tree/main/..., but the default branch is next and no main branch exists, so every link 404'd on npm and in editor tooltips. They now point at tree/next/....

0.10.0

Minor Changes

  • 025a657: Drop CommonJS entrypoints and publish the TypeScript SDK packages as ESM-only packages. This is a breaking change within the existing 0.x release line: consumers must use Node.js 22.22.3 or newer. CommonJS callers can only rely on Node's native require(esm) interop, and the SDK no longer ships custom CommonJS compatibility machinery or .cjs artifacts.

Patch Changes

  • 507318d: Harden the Anthropic tool property-key sanitizer:

    • Broader schema coverage. Illegal keys are now sanitized wherever they appear in a tool schema — under the composition keywords (allOf/anyOf/oneOf, not/if/then/else), prefixItems tuples, additionalProperties/patternProperties, and $defs/definitions — not just top-level properties and array items. Previously a single illegal key under one of these would still 400 the entire request. Renames inside composition keywords are restored correctly (they fold into the value level they share).
    • $ref keys restored. wrapTool now dereferences internal $ref/$defs (leniently — a dangling ref degrades to a permissive schema instead of throwing) before sanitizing, so keys reachable only through a reference are both made compliant and restored. Only genuinely dynamic positions (additionalProperties, patternProperties, contains) remain rewrite-only.
    • Shared core implementation. The traversal/restoration mechanism now lives in @composio/core (sanitizeSchemaPropertyKeys / restoreOriginalKeys); this provider supplies only the Anthropic key constraint as a policy, reusing core's prototype-pollution guard and depth cap.
    • Prototype-safe key restoration. Reverse-mapping lookups and the rebuilt argument object are now prototype-free, so a tool call whose arguments use a key matching an Object.prototype member (__proto__, constructor, toString, hasOwnProperty, …) no longer throws or silently corrupts the payload sent to the backend. Object.prototype is never mutated.
    • Depth cap. Schema sanitization and key restoration now bound recursion (matching core's JSON-schema walker) so a pathologically deep schema or argument object fails with a clear error instead of overflowing the stack.
    • Empty / all-illegal keys. A property key that is empty (or made entirely of stripped characters) now becomes a deterministic non-empty alias instead of an empty string, which would itself have violated Anthropic's {1,64} length bound.
    • Collision loop. Replaced a latent non-terminating fixed point in the alias collision resolver with a counter that always makes progress.
    • Observability. The provider now emits debug logs when it rewrites a tool's schema keys and when it restores them at execution time, and the wrap-then-execute (same provider instance) contract for key restoration is documented.
  • c90ae95: Sanitize tool input_schema property keys that violate Anthropic's ^[a-zA-Z0-9_.-]{1,64}$ constraint before sending tools to the Messages API, then restore the original names when the tool is executed.

A single non-conforming key previously made Anthropic reject the entire tools array with HTTP 400, taking down every other tool in the same request. This commonly happened with OneDrive's Microsoft Graph OData parameters ($top, $filter, @microsoft.graph.conflictBehavior) and with over-long flattened keys from tools such as Zoom. Offending keys are now rewritten to conforming aliases ($ → dollar_, @ → at_, any other illegal character → _, keys longer than 64 characters truncated with a deterministic suffix), recursing through nested object properties and array items schemas. The original parameter names are restored before the call reaches the Composio backend, so the model sees dollar_top while the backend still receives $top. Schemas whose keys already conform are left unchanged.

0.9.3

Patch Changes

  • ce4b213: fix(providers): normalize string tool-call arguments across all providers

Models occasionally emit tool-call arguments as a JSON string instead of an object (most visibly with COMPOSIO_MULTI_EXECUTE_TOOL on the Vercel AI SDK), which broke downstream validation with errors like tool_use.input: Input should be a valid dictionary.

@composio/core now exposes a single normalizeToolArguments helper, and every provider routes model-supplied arguments through it. Object payloads pass through unchanged, JSON strings are parsed, empty/null payloads become {}, and anything that cannot resolve to an object throws a typed ComposioInvalidToolArgumentsError instead of a raw SyntaxError or a silently forwarded malformed string. This replaces the inconsistent per-provider guards that previously existed only in vercel, cloudflare and openai-agents.

0.9.2

Patch Changes

0.9.1

Patch Changes

  • Updated dependencies [84a3a07]
  • Updated dependencies [c358ffa]

0.9.0

Minor Changes

  • Bumped to align with @composio/core@0.9.0 for the Tool Router release train. No public-API change in this provider package.

Patch Changes

  • Updated dependencies [c9b6525]
  • Updated dependencies [cc673b6]
  • Updated dependencies [9f14971]
  • Updated dependencies [81f8027]
  • Updated dependencies [711a703]
  • Updated dependencies [bccd32b]
  • Updated dependencies [bccd32b]
  • Updated dependencies [07c9bab]
  • Updated dependencies [3ece424]

0.8.1

Patch Changes

  • Updated dependencies [6b986cd]
  • Updated dependencies [1c3276b]

0.8.0

Minor Changes

  • Bumped to align with @composio/core@0.8.0 for the file-upload allowlist release train. No public-API change in this package.

Patch Changes

  • Updated dependencies [ebc9778]

0.6.11

Patch Changes

0.6.10

Patch Changes

0.6.9

Patch Changes

  • Updated dependencies [5b5723a]

0.6.8

Patch Changes

  • Updated dependencies [2b19ae9]

0.6.7

Patch Changes

  • Updated dependencies [8dc5568]

0.6.6

Patch Changes

  • Updated dependencies [e1f6516]

0.6.5

Patch Changes

  • Updated dependencies [476d451]
  • Updated dependencies

0.6.5-alpha.0

Patch Changes

0.6.4

Patch Changes

  • Updated dependencies [e3f1f6c]

0.6.3

Patch Changes

  • Updated dependencies [087385d]

0.6.2

Patch Changes

0.6.1

Patch Changes

  • Updated dependencies [e746383]

0.6.0

Minor Changes

  • Breaking: Fixes for cloudflare support, webhook verification and other fixes

Patch Changes

0.5.5

Patch Changes

  • Updated dependencies [b132aad]

0.5.4

Patch Changes

  • Updated dependencies [b3f5875]

0.5.3

Patch Changes

  • Updated dependencies [498505d]

0.5.2

Patch Changes

  • Updated dependencies [277f02b]

0.5.1

Patch Changes

  • Updated dependencies [3055048]

0.5.0

Minor Changes

  • d80f3e2: Bump core dependency to 0.5.0

0.4.0

Minor Changes

  • c7e1217: Add support for dedicated tools for tool router

Patch Changes

  • Updated dependencies [c7e1217]

0.3.4

Patch Changes

  • Updated dependencies [019f54f]

0.3.3

Patch Changes

  • Updated dependencies [a76b002]

0.3.2

Patch Changes

  • Updated dependencies [69cfede]

0.3.1

Patch Changes

  • Updated dependencies [73db5f5]

0.3.0

Patch Changes

0.2.7

Patch Changes

  • Updated dependencies [07551cd]
  • Updated dependencies [9e002c5]
  • Updated dependencies [f0e67c4]
  • Updated dependencies [31521bd]
  • Updated dependencies [9e002c5]

0.2.7-alpha.4

Patch Changes

0.2.7-alpha.3

Patch Changes

0.2.7-alpha.2

Patch Changes

0.2.7-alpha.1

Patch Changes

0.2.7-alpha.0

Patch Changes

0.2.6

Patch Changes

  • b5cc23f: Fix dangerously skip version check in non agentic providers, Throw error instead of process.exit when api key doesn't exist, bump zod-to-json-schema to 3.25.0, which supports "zod/3"
  • Updated dependencies [b5cc23f]

0.2.5

Patch Changes

  • e2762f2: Fix non-agentic providers to work without specifying versions
  • Updated dependencies [e2762f2]

0.2.4

Patch Changes

  • Updated dependencies [97c4138]

0.2.3

Patch Changes

  • Updated dependencies [f88ab99]

0.2.2

Patch Changes

  • cfc2c50: Update zod version to 4
  • Updated dependencies [cfc2c50]

0.2.1

Patch Changes

  • Updated dependencies [6135896]

0.2.0

Minor Changes

  • 157bf7b: ### Added
    • Version validation for manual tool execution: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from latest version changes
    • New dangerously_skip_version_check parameter (Python) / dangerouslySkipVersionCheck (TypeScript): Optional flag to bypass version validation (use with caution)
    • ToolVersionRequiredError exception (Python): Raised when attempting to execute tools with latest version without skip flag, includes helpful error messages with 4 possible fixes
    • ComposioToolVersionRequiredError error (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
    • Comprehensive test coverage: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables

### Changed - Tool execution behavior: Manual execution via tools.execute() now validates toolkit versions before API calls - Agentic provider flows: Automatically set dangerously_skip_version_check=True internally to maintain backward compatibility for framework integrations - Instance-level version resolution: Both execute() and _execute_tool() methods now consistently resolve versions from instance-level toolkit_versions configuration - Modifier support: Added dangerously_skip_version_check to modifier parameter types for complete flow coverage - Test version format: Updated all test files to use production date-based version format (20251201_XX) instead of semantic versioning

### Fixed - Consistent version handling: Removed toolkit_versions parameter from _execute_tool() in favor of instance-level configuration, ensuring consistent version resolution across the SDK - Code formatting: Applied ruff formatting to all modified Python files - Array parsing to ZodSchema: Fixes in json-schema-to-zod to parse array without properties and with properties

### Migration Guide

When manually executing tools, you must now specify toolkit versions:

Option 1: Pass explicit version parameter

  tools.execute("GITHUB_CREATE_ISSUE",
      arguments={...},
      version="20251201_01"
  )

Option 2: Configure at SDK initialization

  tools = Tools(client, provider,
      toolkit_versions={"github": "20251201_01"}
  )

Option 3: Use environment variables

  export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01

Option 4: Skip validation (not recommended)

  tools.execute("GITHUB_CREATE_ISSUE",
      arguments={...},
      dangerously_skip_version_check=True
  )

### Developer Notes - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag - The latest version can still be used with the skip flag, but specific versions are strongly recommended - Error messages include all available resolution options for better developer experience

Patch Changes

  • Updated dependencies [157bf7b]

0.1.55

Patch Changes

0.1.54

Patch Changes

0.1.53

Patch Changes

  • 9a1b0e9: - Adds the new experiemntal ToolRouter, Deprecates the existing MCP experience and adds the new MCP components.
    • The old MCP components can be accessed via deprecated.mcp until the next release, where it will get removed.
    • Fixes toolkits.list and toolkits.get methods to add description to connection fields
  • Updated dependencies [9a1b0e9]

0.1.52

Patch Changes

  • 7077cee: Add tool versioning support
  • Updated dependencies [7077cee]

0.1.51

Patch Changes

0.1.50

Patch Changes

0.1.49

Patch Changes

0.1.48

Patch Changes

0.1.47

Patch Changes

0.1.46

Patch Changes

  • Updated dependencies [ee12d25]
  • Updated dependencies [9458513]

0.1.45

Patch Changes

0.1.44

Patch Changes

  • b4b8b94: Fix telemetry flags and disable when passed
  • Updated dependencies [b4b8b94]

0.1.43

Patch Changes

  • eb7691e: Add strict mode to vercel provider
  • Updated dependencies [eb7691e]

0.1.42

Patch Changes

0.1.41

Patch Changes

  • 025600f: Bump composio client version to 0.1.0-alpha.31
  • Updated dependencies [025600f]

0.1.40

Patch Changes

  • 1664c34: Fix auth config creation/updation methods to accept tool access configs
  • Updated dependencies [1664c34]

0.1.39

Patch Changes

  • Fix jsonSchema to zod parsing which used to eliminate min/max and examples proeperties
  • Updated dependencies

0.1.38

Patch Changes

  • 6c980ad: Add generics for CLI trigger type generation
  • Updated dependencies [6c980ad]

0.1.37

Patch Changes

  • 09c4a26: Fix issues with tools.execute requiring userId for no auth apps
  • Updated dependencies [09c4a26]

0.1.36

Patch Changes

  • 7276d1e: Fix issues with json schema to zod parsing causing nested objects to be marked as required
  • c223e54: Fix file upload handlers
  • 7276d1e: Fix issues with objects with default values being marked as required
  • 9a10986: Fix: Relax strict type/schema validations on API responses
  • 06612f5: Downgrade chalk to v4 to allow CJS as well
  • cb1b401: Update composio api client to latest version
  • da57771: dont't validate if authConfigIds is provided
  • 91c3647: Update deps
  • b001330: Fix package bumps
  • 77e96e4: Fix JSON Schema to Zod Parsing
  • ea79c18: Bump packages
  • cb1b401: Bump packages for authconfig fixes
  • ea79c18: Update packages
  • a79dfac: Relax connected account schema parsing
  • Create stable release
  • ea79c18: Fix: Gracefully handle connected account responses for missing fields
  • 91c3647: Fix proxy execute params and bump langchain packages
  • ea79c18: Bump packages
  • Updated dependencies [7276d1e]
  • Updated dependencies [c223e54]
  • Updated dependencies [7276d1e]
  • Updated dependencies [9a10986]
  • Updated dependencies [06612f5]
  • Updated dependencies [cb1b401]
  • Updated dependencies [da57771]
  • Updated dependencies [91c3647]
  • Updated dependencies [b001330]
  • Updated dependencies [77e96e4]
  • Updated dependencies [ea79c18]
  • Updated dependencies [cb1b401]
  • Updated dependencies [ea79c18]
  • Updated dependencies [a79dfac]
  • Updated dependencies
  • Updated dependencies [ea79c18]
  • Updated dependencies [91c3647]
  • Updated dependencies [ea79c18]

0.1.36-next.13

Patch Changes

  • 77e96e4: Fix JSON Schema to Zod Parsing
  • Updated dependencies [77e96e4]

0.1.36-next.12

Patch Changes

0.1.36-next.11

Patch Changes

  • Fix proxy execute params and bump langchain packages
  • Updated dependencies

0.1.36-next.10

Patch Changes

  • Fix: Relax strict type/schema validations on API responses
  • Updated dependencies

0.1.36-next.9

Patch Changes

  • 9fa49ec: Update composio api client to latest version
  • Bump packages for authconfig fixes
  • Updated dependencies [9fa49ec]
  • Updated dependencies

0.1.36-next.8

Patch Changes

0.1.36-next.7

Patch Changes

  • da57771: dont't validate if authConfigIds is provided
  • Updated dependencies [da57771]

0.1.36-next.6

Patch Changes

  • 06612f5: Downgrade chalk to v4 to allow CJS as well
  • Relax connected account schema parsing
  • Updated dependencies [06612f5]
  • Updated dependencies

0.1.36-next.5

Patch Changes

  • dd630fe: Bump packages
  • Bump packages
  • Updated dependencies [dd630fe]
  • Updated dependencies

0.1.36-next.4

Patch Changes

0.1.36-next.3

Patch Changes

  • Fix: Gracefully handle connected account responses for missing fields
  • Updated dependencies

0.1.36-next.2

Patch Changes

  • Fix issues with objects with default values being marked as required
  • Updated dependencies

0.1.36-next.1

Patch Changes

  • Fix issues with json schema to zod parsing causing nested objects to be marked as required
  • Updated dependencies

0.1.36-next.0

Patch Changes

0.1.35

Patch Changes

  • git status
  • Updated dependencies

0.1.34

Patch Changes

  • Add exports for connection request
  • Updated dependencies

0.1.33

Patch Changes

  • Fix types and exports
  • Updated dependencies

0.1.32

Patch Changes

  • Add support for File type in uploading files
  • Updated dependencies

0.1.31

Patch Changes

  • e660385: Fix file upload / download
  • Updated dependencies [e660385]

0.1.30

Patch Changes

  • Improved support for file handling
  • Updated dependencies

0.1.29

Patch Changes

  • Add file upload / download modifiers
  • Updated dependencies

0.1.28

Patch Changes

  • Add MCP support for providers
  • Updated dependencies

0.1.27

Patch Changes

  • Remove cusrsor and important flags from tools.get
  • Updated dependencies

0.1.26

Patch Changes

  • Fix function signatures for toolkits auth fields
  • Updated dependencies

0.1.25

Patch Changes

  • Add MCP server to composio SDk
  • Updated dependencies

0.1.24

Patch Changes

  • Fix auth schemes for creating connected accounts
  • Updated dependencies

0.1.23

Patch Changes

  • Improvements in DX in triggers and bug fixes in tools
  • Updated dependencies

0.1.22

Patch Changes

  • Adds support for connected accounts allowMultiple flag, and other improvements
  • Updated dependencies

0.1.21

Patch Changes

  • Add host name support in SDK
  • Updated dependencies

0.1.20

Patch Changes

  • 1ab34ef: Fix json schema support in tools
  • Updated dependencies [1ab34ef]

0.1.19

Patch Changes

  • c8e89d5: Fix telemetry transport
  • Updated dependencies [c8e89d5]

0.1.18

Patch Changes

  • 37a1f01: Feat better connected account creation flow
  • Updated dependencies [37a1f01]

0.1.17

Patch Changes

  • df31cc2: Fix json schema parsing
  • Updated dependencies [df31cc2]

0.1.16

Patch Changes

  • f943ba4: Export all the types from the core SDK
  • Updated dependencies [f943ba4]

0.1.15

Patch Changes

  • 208e320: Update json schema transformations issues related to strict mode
  • Updated dependencies [208e320]

0.1.14

Patch Changes

  • 4ddfafc: Add json schema to zod schema
  • Updated dependencies [4ddfafc]

0.1.13

Patch Changes

  • 040b5a4: Ability to create sessions for transferring request ids
  • Updated dependencies [040b5a4]

0.1.12

Patch Changes

  • b121e73: Update packages to stable version
  • f144202: Update tsdocs across all the functions
  • 0b15376: Add custom toolkit examples
  • de3f522: Stable version with test coverage and other stuff
  • a2f9537: Update tools.get to accept discriminated unions
  • 83a0d15: Test github ci publish
  • Updated dependencies [c1443db]
  • Updated dependencies [b121e73]
  • Updated dependencies [f144202]
  • Updated dependencies [ba8d991]
  • Updated dependencies [ca59bcd]
  • Updated dependencies [e51680c]
  • Updated dependencies [0b15376]
  • Updated dependencies [de3f522]
  • Updated dependencies [a2f9537]
  • Updated dependencies [83a0d15]
  • Updated dependencies [eeec413]

0.1.12-alpha.16

Patch Changes

  • 0b15376: Add custom toolkit examples
  • Updated dependencies [0b15376]

0.1.12-alpha.15

Patch Changes

  • f144202: Update tsdocs across all the functions
  • Updated dependencies [f144202]

0.1.12-alpha.14

Patch Changes

0.1.12-alpha.13

Patch Changes

  • a2f9537: Update tools.get to accept discriminated unions
  • Updated dependencies [a2f9537]

0.1.12-alpha.12

Patch Changes

  • de3f522: Stable version with test coverage and other stuff
  • Updated dependencies [de3f522]