Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Release: update version (#2160)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Musthaq Ahamad committed
Nov 10, 2025 at 18:08 UTC
0e5abf057eca3bf4cfe1651fb4e927edcd97597e
22 files changed
+213
-24
.changeset/brown-months-visit.md
deleted
-5
@@ -1,5 +0,0 @@
1
----
2
-'@composio/core': patch
3
----
4
-
5
-Update composio client version and add support for toolkit version in fetching trigger types
fern/pages/src/changelog/11-10-25.md
new
+125
@@ -0,0 +1,125 @@
1
+# Toolkit Version Support for Triggers
2
+
3
+### Summary
4
+Added toolkit version support to trigger operations (`create` and `getType`) in both Python and TypeScript SDKs. This allows users to explicitly specify which toolkit version to use when creating trigger instances and retrieving trigger type information, ensuring consistent behavior across different toolkit versions.
5
+
6
+Trigger operations now respect the global `toolkitVersions` configuration set during Composio initialization, providing better control over which trigger versions are used in your applications.
7
+
8
+### Key Changes
9
+
10
+#### TypeScript SDK (`ts/packages/core/`)
11
+- Added `toolkit_versions` parameter to `triggers.create()` method
12
+ - Passes the global toolkit versions configuration when creating trigger instances
13
+ - Defaults to `'latest'` when no version is specified
14
+- Modified `triggers.getType()` to respect global toolkit versions
15
+ - Now accepts toolkit version configuration to fetch trigger types for specific versions
16
+ - Improved error messages to include version-related fixes
17
+- Updated trigger type documentation with comprehensive examples
18
+- Added behavior documentation explaining version usage patterns
19
+
20
+#### Python SDK (`python/composio/core/models/`)
21
+- Added `toolkit_versions` parameter to `triggers.create()` method
22
+ - Uses global toolkit version configuration when creating trigger instances
23
+ - Converts `None` to `omit` for API compatibility
24
+- Modified `triggers.get_type()` to respect toolkit versions
25
+ - Implemented custom method replacing direct client binding
26
+ - Passes toolkit version configuration to API calls
27
+- Added comprehensive docstrings explaining version behavior
28
+
29
+### Behavior
30
+
31
+**Creating Triggers with Toolkit Versions:**
32
+
33
+```typescript
34
+// TypeScript - Configure versions at initialization
35
+const composio = new Composio({
36
+ apiKey: 'your-api-key',
37
+ toolkitVersions: {
38
+ gmail: '12082025_00',
39
+ github: '10082025_01'
40
+ }
41
+});
42
+
43
+// Create trigger - uses version '12082025_00' for Gmail
44
+const trigger = await composio.triggers.create('user@example.com', 'GMAIL_NEW_MESSAGE', {
45
+ connectedAccountId: 'ca_abc123',
46
+ triggerConfig: {
47
+ labelIds: 'INBOX',
48
+ userId: 'me',
49
+ interval: 60,
50
+ },
51
+});
52
+```
53
+
54
+```python
55
+# Python - Configure versions at initialization
56
+composio = Composio(
57
+ api_key="your-api-key",
58
+ toolkit_versions={"gmail": "12082025_00", "github": "10082025_01"}
59
+)
60
+
61
+# Create trigger - uses version '12082025_00' for Gmail
62
+trigger = composio.triggers.create(
63
+ slug="GMAIL_NEW_MESSAGE",
64
+ user_id="user@example.com",
65
+ trigger_config={"labelIds": "INBOX", "userId": "me", "interval": 60}
66
+)
67
+```
68
+
69
+**Retrieving Trigger Types with Specific Versions:**
70
+
71
+```typescript
72
+// TypeScript
73
+const composio = new Composio({
74
+ apiKey: 'your-api-key',
75
+ toolkitVersions: { github: '10082025_01' }
76
+});
77
+
78
+// Get trigger type for specific version
79
+const triggerType = await composio.triggers.getType('GITHUB_COMMIT_EVENT');
80
+// Returns trigger type for version '10082025_01'
81
+```
82
+
83
+```python
84
+# Python
85
+composio = Composio(
86
+ api_key="your-api-key",
87
+ toolkit_versions={"github": "10082025_01"}
88
+)
89
+
90
+# Get trigger type for specific version
91
+trigger_type = composio.triggers.get_type("GITHUB_COMMIT_EVENT")
92
+# Returns trigger type for version '10082025_01'
93
+```
94
+
95
+### Benefits
96
+
97
+- **Version Control**: Explicitly specify which toolkit version to use for triggers
98
+- **Consistency**: Ensure trigger behavior remains consistent across toolkit updates
99
+- **Testing**: Test trigger integrations with specific versions before updating
100
+- **Debugging**: Easier to debug issues by pinning to specific toolkit versions
101
+- **Production Safety**: Avoid unexpected changes from automatic version updates
102
+
103
+### Migration Guide
104
+
105
+This is a **non-breaking change**. Existing code will continue to work with default behavior:
106
+
107
+**Before (still works):**
108
+```typescript
109
+// Uses 'latest' version by default
110
+const trigger = await composio.triggers.create('user', 'GITHUB_COMMIT_EVENT', {...});
111
+```
112
+
113
+**After (recommended for production):**
114
+```typescript
115
+// Explicitly configure versions for better control
116
+const composio = new Composio({
117
+ apiKey: 'your-api-key',
118
+ toolkitVersions: { github: '10082025_01' }
119
+});
120
+
121
+const trigger = await composio.triggers.create('user', 'GITHUB_COMMIT_EVENT', {...});
122
+```
123
+
124
+For more details on toolkit versioning, see the [Toolkit Versioning documentation](/docs/toolkit-versioning).
125
+
ts/packages/core/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1
# @composio/core
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- 97c4138: Update composio client version and add support for toolkit version in fetching trigger types
8
+
9
## 0.2.3
10
11
### Patch Changes
ts/packages/core/package.json
+1
-1
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/core",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "",
5
"main": "src/index.ts",
6
"type": "module",
ts/packages/providers/anthropic/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/anthropic
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/anthropic/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/anthropic",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "Non-Agentic Provider for Anthropic in Composio SDK",
5
"main": "src/index.ts",
6
"type": "module",
@@ -35,7 +35,7 @@
35
"packageManager": "pnpm@10.17.0",
36
"peerDependencies": {
37
"@anthropic-ai/sdk": "^0.52.0",
38
- "@composio/core": "0.2.3",
38
+ "@composio/core": "0.2.4",
39
"@mastra/mcp": "^0.12.0"
40
},
41
"devDependencies": {
ts/packages/providers/cloudflare/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/cloudflare
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/cloudflare/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/cloudflare",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "",
5
"main": "src/index.ts",
6
"type": "module",
@@ -31,7 +31,7 @@
31
"packageManager": "pnpm@10.17.0",
32
"peerDependencies": {
33
"@cloudflare/workers-types": "catalog:",
34
- "@composio/core": "0.2.3"
34
+ "@composio/core": "0.2.4"
35
},
36
"devDependencies": {
37
"@composio/core": "workspace:*",
ts/packages/providers/google/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/google
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/google/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/google",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "Google GenAI Provider for Composio SDK",
5
"main": "src/index.ts",
6
"type": "module",
@@ -36,7 +36,7 @@
36
"license": "ISC",
37
"packageManager": "pnpm@10.17.0",
38
"peerDependencies": {
39
- "@composio/core": "0.2.3",
39
+ "@composio/core": "0.2.4",
40
"@google/genai": "^1.1.0"
41
},
42
"devDependencies": {
ts/packages/providers/langchain/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/langchain
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/langchain/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/langchain",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "",
5
"main": "dist/index.js",
6
"type": "module",
@@ -30,7 +30,7 @@
30
"license": "ISC",
31
"packageManager": "pnpm@10.17.0",
32
"peerDependencies": {
33
- "@composio/core": "0.2.3",
33
+ "@composio/core": "0.2.4",
34
"@langchain/core": "^0.3.63"
35
},
36
"devDependencies": {
ts/packages/providers/llamaindex/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/llamaindex
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/llamaindex/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/llamaindex",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "Agentic Provider for llamaindex in Composio SDK",
5
"main": "src/index.ts",
6
"type": "module",
@@ -33,7 +33,7 @@
33
"license": "ISC",
34
"packageManager": "pnpm@10.17.0",
35
"peerDependencies": {
36
- "@composio/core": "0.2.3",
36
+ "@composio/core": "0.2.4",
37
"llamaindex": "^0.12.0"
38
},
39
"devDependencies": {
ts/packages/providers/mastra/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/mastra
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/mastra/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/mastra",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "Agentic Provider for mastra in Composio SDK",
5
"main": "src/index.ts",
6
"type": "module",
@@ -34,7 +34,7 @@
34
"license": "ISC",
35
"packageManager": "pnpm@10.17.0",
36
"peerDependencies": {
37
- "@composio/core": "0.2.3",
37
+ "@composio/core": "0.2.4",
38
"@mastra/core": "^0.21.1",
39
"@mastra/mcp": "^0.12.0"
40
},
ts/packages/providers/openai-agents/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/openai-agents
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/openai-agents/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/openai-agents",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "",
5
"main": "src/index.ts",
6
"type": "module",
@@ -30,7 +30,7 @@
30
"license": "ISC",
31
"packageManager": "pnpm@10.17.0",
32
"peerDependencies": {
33
- "@composio/core": "0.2.3",
33
+ "@composio/core": "0.2.4",
34
"@openai/agents": "^0.1.3",
35
"zod": "catalog:"
36
},
ts/packages/providers/openai/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/openai
2
3
+## 0.2.4
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.3
11
12
### Patch Changes
ts/packages/providers/openai/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/openai",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
"description": "",
5
"main": "src/index.ts",
6
"type": "module",
@@ -30,7 +30,7 @@
30
"license": "ISC",
31
"packageManager": "pnpm@10.17.0",
32
"peerDependencies": {
33
- "@composio/core": "0.2.3",
33
+ "@composio/core": "0.2.4",
34
"openai": "^5.16.0"
35
},
36
"devDependencies": {
ts/packages/providers/vercel/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1
# @composio/vercel
2
3
+## 0.2.16
4
+
5
+### Patch Changes
6
+
7
+- Updated dependencies [97c4138]
8
+ - @composio/core@0.2.4
9
+
10
## 0.2.15
11
12
### Patch Changes
ts/packages/providers/vercel/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/vercel",
3
- "version": "0.2.15",
3
+ "version": "0.2.16",
4
"description": "",
5
"main": "src/index.ts",
6
"type": "module",
@@ -30,7 +30,7 @@
30
"license": "ISC",
31
"packageManager": "pnpm@10.17.0",
32
"peerDependencies": {
33
- "@composio/core": "0.2.3",
33
+ "@composio/core": "0.2.4",
34
"ai": "^5.0.44"
35
},
36
"devDependencies": {