Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 12:00 UTC
SDK release Py.v0.10.11/Ts.v0.6.0 (#2521)
Co-authored-by: Alberto Schiabel <jkomyno@users.noreply.github.com>
Musthaq Ahamad committed
Jan 29, 2026 at 15:52 UTC
74051f1fe2f1def37b3f76b193c5533022c2ea6e
48 files changed
+947
-91
docs/content/changelog/01-29-26-sdk-major-update.mdx
new
+763
@@ -0,0 +1,763 @@
1
+---
2
+title: 'SDK 0.6.0 Major Update: Cloudflare Workers Support and Breaking Changes'
3
+description: 'Major release with Cloudflare Workers support, webhook verification updates, and Mastra v1 compatibility. Includes breaking changes for webhook APIs.'
4
+date: '2026-01-29'
5
+---
6
+
7
+## Version Information
8
+
9
+### TypeScript/JavaScript
10
+
11
+- Package: `@composio/core` and all provider packages
12
+- Version: `0.6.0`+
13
+
14
+### Python
15
+
16
+- Package: `composio` and all provider packages
17
+- Version: `0.10.11`+
18
+
19
+---
20
+
21
+This major release focuses on Cloudflare Workers compatibility, platform-specific optimizations, and critical bug fixes. It includes **breaking changes** in both TypeScript and Python SDKs.
22
+
23
+<Callout type="warn">
24
+**Breaking Changes**: This release includes breaking changes that require code modifications:
25
+
26
+**TypeScript:**
27
+
28
+1. Webhook verification: Now async + signature changed (must add `await` + new required params: `id`, `timestamp`)
29
+2. Mastra provider updated to v1 API
30
+
31
+**Python:**
32
+
33
+1. Webhook verification: Signature changed (new required parameters: `id`, `timestamp` - still synchronous)
34
+
35
+See the [Migration Guide](#migration-guide) for detailed upgrade instructions.
36
+
37
+</Callout>
38
+
39
+## Breaking Changes
40
+
41
+### 1. Webhook Verification Breaking Changes
42
+
43
+**TypeScript PR**: [#2436](https://github.com/ComposioHQ/composio/pull/2436) | **Python PR**: [#2361](https://github.com/ComposioHQ/composio/pull/2361)
44
+
45
+The webhook verification API has breaking changes in both SDKs to support multiple webhook versions (v1, v2, v3) and edge runtime compatibility.
46
+
47
+#### TypeScript: Now Async + Signature Changed
48
+
49
+The `verifyWebhook()` method has **two breaking changes**: it's now async AND requires additional parameters.
50
+
51
+**Before:**
52
+
53
+```typescript
54
+// @noErrors
55
+import { Composio } from '@composio/core';
56
+
57
+const composio = new Composio();
58
+
59
+// Old signature - synchronous, fewer parameters
60
+const payload = composio.triggers.verifyWebhook({
61
+ payload: req.body.toString(),
62
+ signature: req.headers['x-composio-signature'] as string,
63
+ secret: process.env.COMPOSIO_WEBHOOK_SECRET!,
64
+});
65
+// Returns: TriggerEvent
66
+```
67
+
68
+**After:**
69
+
70
+```typescript
71
+// @noErrors
72
+import { Composio } from '@composio/core';
73
+
74
+const composio = new Composio();
75
+
76
+// New signature - async, requires id and timestamp
77
+const result = await composio.triggers.verifyWebhook({
78
+ id: req.headers['webhook-id'] as string, // NEW: required
79
+ payload: req.body.toString(),
80
+ secret: process.env.COMPOSIO_WEBHOOK_SECRET!,
81
+ signature: req.headers['webhook-signature'] as string, // header name changed
82
+ timestamp: req.headers['webhook-timestamp'] as string, // NEW: required
83
+ tolerance: 300, // optional, default 300 seconds
84
+});
85
+// Returns: VerifyWebhookResult with version info
86
+```
87
+
88
+**Key Changes:**
89
+
90
+- ⚠️ **Now async** - Must use `await`
91
+- ⚠️ New required parameter: `id` (from `webhook-id` header)
92
+- ⚠️ New required parameter: `timestamp` (from `webhook-timestamp` header)
93
+- ⚠️ Header name changed: `x-composio-signature` → `webhook-signature`
94
+- ⚠️ Return type changed: `TriggerEvent` → `VerifyWebhookResult`
95
+
96
+**Why?**
97
+
98
+- Cloudflare Workers compatibility - uses Web Crypto API instead of `node:crypto`
99
+- Supports v1, v2, and v3 webhook formats with improved signature verification
100
+
101
+---
102
+
103
+#### Python: Signature Changed (v1/v2/v3 Support)
104
+
105
+The method signature changed to support new webhook versions and requires additional headers.
106
+
107
+**Before:**
108
+
109
+```python
110
+from composio import Composio
111
+
112
+composio = Composio()
113
+
114
+# Old signature - fewer parameters
115
+event = composio.triggers.verify_webhook(
116
+ payload=request.get_data(as_text=True),
117
+ signature=request.headers.get('x-composio-signature'),
118
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
119
+)
120
+# Returns: TriggerEvent
121
+```
122
+
123
+**After:**
124
+
125
+```python
126
+from composio import Composio
127
+
128
+composio = Composio()
129
+
130
+# New signature - requires id and timestamp headers
131
+result = composio.triggers.verify_webhook(
132
+ id=request.headers.get('webhook-id'), # NEW: required
133
+ payload=request.get_data(as_text=True),
134
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
135
+ signature=request.headers.get('webhook-signature'), # header name changed
136
+ timestamp=request.headers.get('webhook-timestamp'), # NEW: required
137
+ tolerance=300, # optional
138
+)
139
+# Returns: VerifyWebhookResult with version info
140
+```
141
+
142
+**Key Changes:**
143
+
144
+- ✅ **Still synchronous** (no `await` needed)
145
+- ⚠️ New required parameter: `id` (webhook-id header)
146
+- ⚠️ New required parameter: `timestamp` (webhook-timestamp header)
147
+- ⚠️ Header name changed: `x-composio-signature` → `webhook-signature`
148
+- ⚠️ Return type changed: `TriggerEvent` → `VerifyWebhookResult`
149
+- ⚠️ All parameters now keyword-only (must use `param=value`)
150
+
151
+**Why?** Supports v1, v2, and v3 webhook formats with improved signature verification.
152
+
153
+---
154
+
155
+### 2. Mastra v1 Provider Update
156
+
157
+**PR**: [#2433](https://github.com/ComposioHQ/composio/pull/2433)
158
+
159
+The `@composio/mastra` provider has been updated to support Mastra v1, which has breaking API changes from v0.x.
160
+
161
+#### Before (Mastra v0.x)
162
+
163
+```typescript
164
+// @noErrors
165
+import { MastraProvider } from '@composio/mastra';
166
+import { Mastra } from '@mastra/core';
167
+
168
+const mastra = new Mastra({
169
+ /* v0 config */
170
+});
171
+const provider = new MastraProvider();
172
+
173
+// v0 API usage
174
+const tools = await provider.wrapTools(composioTools);
175
+```
176
+
177
+#### After (Mastra v1)
178
+
179
+```typescript
180
+// @noErrors
181
+import { MastraProvider } from '@composio/mastra';
182
+import { Mastra } from '@mastra/core';
183
+
184
+const mastra = new Mastra({
185
+ /* v1 config */
186
+});
187
+const provider = new MastraProvider({ mastra });
188
+
189
+// v1 API - different tool format
190
+const tools = await provider.wrapTools(composioTools);
191
+```
192
+
193
+#### Changes Required
194
+
195
+1. **Update Mastra dependency**: `npm install @mastra/core@latest`
196
+2. **Update provider initialization**: Pass Mastra instance to provider
197
+3. **Update tool handling**: Mastra v1 uses different tool schema format
198
+4. **Check Zod version**: Mastra v1 supports both Zod v3 and v4
199
+5. **Check Node.js version**: Mastra v1 requires [Node.js v22.13.0](https://mastra.ai/guides/migrations/upgrade-to-v1/overview#update-nodejs-version) or higher
200
+
201
+<Callout type="info">
202
+ We've added comprehensive E2E tests for both Zod v3 and v4 compatibility with Mastra v1 and Tool
203
+ Router integration.
204
+</Callout>
205
+
206
+---
207
+
208
+## Major Features
209
+
210
+### 3. Platform-Specific File Tool Modifier
211
+
212
+**PR**: [#2437](https://github.com/ComposioHQ/composio/pull/2437)
213
+
214
+Separate implementations for Node.js and Cloudflare Workers to optimize file handling for each runtime.
215
+
216
+**Key Improvements:**
217
+
218
+- **Node.js**: Uses native file system APIs for better performance
219
+- **Cloudflare Workers**: Uses platform-specific APIs, avoids Node.js-only code
220
+- **Automatic selection**: SDK automatically picks the right implementation
221
+- **No code changes needed**: Works transparently
222
+
223
+<Callout type="info">
224
+**Related Change**: This platform-agnostic approach is why `composio.triggers.verifyWebhook()` became async in [Breaking Change #1](#1-webhook-verification-breaking-changes). Node.js `node:crypto` is mostly synchronous, but the standard `globalThis.crypto` (Web Crypto API) available in Cloudflare Workers is async. To support both platforms with a single API, the method had to become async.
225
+</Callout>
226
+
227
+---
228
+
229
+### 4. Platform-Specific Config Defaults
230
+
231
+**PR**: [#2437](https://github.com/ComposioHQ/composio/pull/2437)
232
+
233
+Different default configurations for different runtimes to optimize behavior.
234
+
235
+Changed the `autoUploadDownloadFiles` default configuration for the Cloudflare Workers runtime, to avoid triggering runtime errors on unsupported features.
236
+
237
+**Cloudflare Workers defaults:**
238
+
239
+```typescript
240
+{
241
+ autoUploadDownloadFiles: false; // We don't currently support file uploads/downloads in Cloudflare Workers
242
+}
243
+```
244
+
245
+**Benefits:**
246
+
247
+- **Zero config** for common use cases
248
+- **Optimized** for each platform's strengths
249
+- **Override** defaults when needed
250
+
251
+---
252
+
253
+### 5. Node Buffer → Uint8Array Refactoring
254
+
255
+**PR**: [#2438](https://github.com/ComposioHQ/composio/pull/2438)
256
+
257
+All `node:buffer` usage replaced with standard `Uint8Array` for universal compatibility.
258
+
259
+**Impact:**
260
+
261
+- Works in **Node.js and Cloudflare Workers**
262
+- **ESLint rules** enforce this pattern going forward
263
+- **Better type safety** with standard types
264
+- **Fully backward compatible** - no code changes needed
265
+
266
+<Callout type="info">
267
+**Why This Matters**: Removing Node.js-specific APIs like `node:buffer` and `node:crypto` enables Cloudflare Workers support. Cloudflare Workers don't have access to Node.js built-in modules, so we use Web Standard APIs (`Uint8Array`, `globalThis.crypto`) that work in both Node.js and Cloudflare Workers.
268
+</Callout>
269
+
270
+---
271
+
272
+## Bug Fixes
273
+
274
+### 6. Tool Fetching with Specific Version
275
+
276
+**PR**: [#2518](https://github.com/ComposioHQ/composio/pull/2518)
277
+
278
+Fixed issues when executing tools with version constraints.
279
+
280
+#### Before (Bug)
281
+
282
+```typescript
283
+// @noErrors
284
+// This would fail or fetch wrong version
285
+await composio.tools.execute('GITHUB_CREATE_ISSUE', {
286
+ userId: 'user_123',
287
+ version: '1.2.0', // Version constraint ignored
288
+ arguments: {
289
+ /* ... */
290
+ },
291
+});
292
+```
293
+
294
+#### After (Fixed)
295
+
296
+```typescript
297
+// @noErrors
298
+// Now correctly respects version constraint
299
+await composio.tools.execute('GITHUB_CREATE_ISSUE', {
300
+ userId: 'user_123',
301
+ version: '1.2.0', // Version constraint honored
302
+ arguments: {
303
+ /* ... */
304
+ },
305
+});
306
+```
307
+
308
+**Test Coverage**: Added 174 new test cases to prevent regression.
309
+
310
+---
311
+
312
+### 7. Python JSON Schema Default Values
313
+
314
+**PR**: [#2506](https://github.com/ComposioHQ/composio/pull/2506)
315
+
316
+Fixed type coercion for stringified default values in JSON schemas.
317
+
318
+#### Before (Bug)
319
+
320
+```python
321
+# Schema with stringified default
322
+{
323
+ "type": "integer",
324
+ "default": "42" # String instead of int
325
+}
326
+
327
+# Would cause runtime errors
328
+```
329
+
330
+#### After (Fixed)
331
+
332
+```python
333
+# SDK automatically coerces to correct type
334
+{
335
+ "type": "integer",
336
+ "default": 42 # Properly coerced to int
337
+}
338
+
339
+# Works correctly
340
+```
341
+
342
+**Impact**: Fixes runtime errors with tools that have stringified defaults in their schemas.
343
+
344
+---
345
+
346
+### 8. Salesforce Type Error Fix
347
+
348
+**PR**: [#2426](https://github.com/ComposioHQ/composio/pull/2426)
349
+
350
+Fixed `SALESFORCE_CREATE_LEAD` type error with `custom_fields` parameter.
351
+
352
+#### Before (Bug)
353
+
354
+```python
355
+# Would fail with type error
356
+composio.tools.execute('SALESFORCE_CREATE_LEAD', {
357
+ 'user_id': 'user_123',
358
+ 'arguments': {
359
+ 'custom_fields': {
360
+ 'CustomField__c': 'value'
361
+ }
362
+ }
363
+})
364
+```
365
+
366
+#### After (Fixed)
367
+
368
+```python
369
+# Now works correctly
370
+composio.tools.execute('SALESFORCE_CREATE_LEAD', {
371
+ 'user_id': 'user_123',
372
+ 'arguments': {
373
+ 'custom_fields': {
374
+ 'CustomField__c': 'value'
375
+ }
376
+ }
377
+})
378
+```
379
+
380
+**Technical Details**: Implemented proper support for `anyOf` and `allOf` JSON Schema constructs in Python SDK.
381
+
382
+---
383
+
384
+## Migration Guide
385
+
386
+### Step 1: Update Dependencies
387
+
388
+<Tabs groupId="package-manager" items={['npm', 'pnpm', 'yarn', 'pip', 'uv']} persist>
389
+ <Tab value="npm">
390
+ ```bash npm update @composio/core@latest # Update provider packages if using them npm update
391
+ @composio/openai@latest npm update @composio/anthropic@latest npm update @composio/vercel@latest
392
+ # etc. ```
393
+ </Tab>
394
+ <Tab value="pnpm">
395
+ ```bash pnpm update @composio/core@latest # Update provider packages if using them pnpm update
396
+ @composio/openai@latest pnpm update @composio/anthropic@latest pnpm update
397
+ @composio/vercel@latest # etc. ```
398
+ </Tab>
399
+ <Tab value="yarn">
400
+ ```bash yarn upgrade @composio/core@latest # Update provider packages if using them yarn upgrade
401
+ @composio/openai@latest yarn upgrade @composio/anthropic@latest yarn upgrade
402
+ @composio/vercel@latest # etc. ```
403
+ </Tab>
404
+ <Tab value="pip">```bash pip install --upgrade composio ```</Tab>
405
+ <Tab value="uv">```bash uv pip install --upgrade composio ```</Tab>
406
+</Tabs>
407
+
408
+---
409
+
410
+### Step 2: Update Webhook Verification (Required)
411
+
412
+<Tabs groupId="language" items={['TypeScript', 'Python']} persist>
413
+<Tab value="TypeScript">
414
+
415
+**Update signature with new parameters and add `await`:**
416
+
417
+```typescript
418
+// @noErrors
419
+// Before - old signature
420
+const payload = composio.triggers.verifyWebhook({
421
+ payload: req.body.toString(),
422
+ signature: req.headers['x-composio-signature'] as string,
423
+ secret: process.env.COMPOSIO_WEBHOOK_SECRET!,
424
+});
425
+
426
+// After - new signature with await and additional parameters
427
+const result = await composio.triggers.verifyWebhook({
428
+ id: req.headers['webhook-id'] as string, // NEW
429
+ payload: req.body.toString(),
430
+ secret: process.env.COMPOSIO_WEBHOOK_SECRET!,
431
+ signature: req.headers['webhook-signature'] as string, // header name changed
432
+ timestamp: req.headers['webhook-timestamp'] as string, // NEW
433
+});
434
+
435
+// Access the normalized payload and version info
436
+const event = result.payload;
437
+const version = result.version; // 'V1', 'V2', or 'V3'
438
+```
439
+
440
+**Express.js Example:**
441
+
442
+```typescript
443
+// @noErrors
444
+import express from 'express';
445
+import { Composio } from '@composio/core';
446
+
447
+const app = express();
448
+const composio = new Composio();
449
+
450
+// Make route handler async
451
+app.post('/webhook', express.raw({ type: 'application/json' }), async (req, res) => {
452
+ try {
453
+ // New signature with all required headers
454
+ const result = await composio.triggers.verifyWebhook({
455
+ id: req.headers['webhook-id'] as string,
456
+ payload: req.body.toString(),
457
+ secret: process.env.COMPOSIO_WEBHOOK_SECRET!,
458
+ signature: req.headers['webhook-signature'] as string,
459
+ timestamp: req.headers['webhook-timestamp'] as string,
460
+ });
461
+
462
+ // Access verified webhook data
463
+ console.log('Webhook version:', result.version);
464
+ console.log('Received trigger:', result.payload.triggerSlug);
465
+
466
+ res.status(200).send('OK');
467
+ } catch (error) {
468
+ console.error('Webhook verification failed:', error);
469
+ res.status(401).send('Unauthorized');
470
+ }
471
+});
472
+```
473
+
474
+**Cloudflare Workers Example:**
475
+
476
+```typescript
477
+// @noErrors
478
+import { Composio } from '@composio/core';
479
+
480
+export default {
481
+ async fetch(request: Request, env: Env): Promise<Response> {
482
+ const composio = new Composio({ apiKey: env.COMPOSIO_API_KEY });
483
+
484
+ try {
485
+ const body = await request.text();
486
+
487
+ // Now works in Cloudflare Workers!
488
+ const result = await composio.triggers.verifyWebhook({
489
+ id: request.headers.get('webhook-id') || '',
490
+ payload: body,
491
+ secret: env.COMPOSIO_WEBHOOK_SECRET,
492
+ signature: request.headers.get('webhook-signature') || '',
493
+ timestamp: request.headers.get('webhook-timestamp') || '',
494
+ });
495
+
496
+ // Process verified webhook
497
+ console.log('Trigger:', result.payload.triggerSlug);
498
+
499
+ return new Response('OK', { status: 200 });
500
+ } catch (error) {
501
+ return new Response('Unauthorized', { status: 401 });
502
+ }
503
+ },
504
+};
505
+```
506
+
507
+</Tab>
508
+<Tab value="Python">
509
+
510
+**Update signature to include new required parameters:**
511
+
512
+```python
513
+# Before - old signature
514
+event = composio.triggers.verify_webhook(
515
+ payload=request.get_data(as_text=True),
516
+ signature=request.headers.get('x-composio-signature'),
517
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
518
+)
519
+
520
+# After - new signature with additional parameters
521
+result = composio.triggers.verify_webhook(
522
+ id=request.headers.get('webhook-id'), # NEW
523
+ payload=request.get_data(as_text=True),
524
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
525
+ signature=request.headers.get('webhook-signature'), # header name changed
526
+ timestamp=request.headers.get('webhook-timestamp'), # NEW
527
+)
528
+
529
+# Access the normalized payload
530
+event = result['payload']
531
+# Check webhook version
532
+version = result['version'] # 'V1', 'V2', or 'V3'
533
+```
534
+
535
+**FastAPI Example:**
536
+
537
+```python
538
+from fastapi import FastAPI, Request, HTTPException
539
+from composio import Composio
540
+import os
541
+
542
+app = FastAPI()
543
+composio = Composio()
544
+
545
+@app.post("/webhook")
546
+def webhook(request: Request): # Still synchronous!
547
+ # New signature with all required headers
548
+ try:
549
+ result = composio.triggers.verify_webhook(
550
+ id=request.headers.get('webhook-id', ''),
551
+ payload=request.body().decode('utf-8'),
552
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
553
+ signature=request.headers.get('webhook-signature', ''),
554
+ timestamp=request.headers.get('webhook-timestamp', ''),
555
+ )
556
+
557
+ # Access normalized payload and version info
558
+ print(f"Webhook version: {result['version']}")
559
+ print(f"Trigger: {result['payload']['trigger_slug']}")
560
+
561
+ return {"success": True}
562
+ except Exception as e:
563
+ raise HTTPException(status_code=401, detail=str(e))
564
+```
565
+
566
+**Flask Example:**
567
+
568
+```python
569
+from flask import Flask, request
570
+from composio import Composio
571
+import os
572
+
573
+app = Flask(__name__)
574
+composio = Composio()
575
+
576
+@app.route('/webhook', methods=['POST'])
577
+def webhook(): # Still synchronous!
578
+ try:
579
+ result = composio.triggers.verify_webhook(
580
+ id=request.headers.get('webhook-id', ''),
581
+ payload=request.get_data(as_text=True),
582
+ secret=os.environ['COMPOSIO_WEBHOOK_SECRET'],
583
+ signature=request.headers.get('webhook-signature', ''),
584
+ timestamp=request.headers.get('webhook-timestamp', ''),
585
+ )
586
+
587
+ # Process verified webhook
588
+ event = result['payload']
589
+ return 'OK', 200
590
+ except Exception as e:
591
+ return 'Unauthorized', 401
592
+```
593
+
594
+</Tab>
595
+</Tabs>
596
+
597
+---
598
+
599
+### Step 3: Update Mastra Integration (If Using)
600
+
601
+**Only required if you use `@composio/mastra` provider**
602
+
603
+<Tabs groupId="package-manager" items={['npm', 'pnpm', 'yarn']} persist>
604
+ <Tab value="npm">
605
+ ```bash # Update to Mastra v1 npm install @mastra/core@latest @composio/mastra@latest ```
606
+ </Tab>
607
+ <Tab value="pnpm">```bash pnpm update @mastra/core@latest @composio/mastra@latest ```</Tab>
608
+ <Tab value="yarn">```bash yarn upgrade @mastra/core@latest @composio/mastra@latest ```</Tab>
609
+</Tabs>
610
+
611
+**Update your code:**
612
+
613
+```typescript
614
+// @noErrors
615
+// Before
616
+import { MastraProvider } from '@composio/mastra';
617
+
618
+const provider = new MastraProvider();
619
+
620
+// After
621
+import { MastraProvider } from '@composio/mastra';
622
+import { Mastra } from '@mastra/core';
623
+
624
+const mastra = new Mastra({
625
+ // Your Mastra v1 config
626
+});
627
+
628
+const provider = new MastraProvider({ mastra });
629
+```
630
+
631
+<Callout type="info">
632
+ **Zod Compatibility**: Mastra v1 works with both Zod v3 and v4. We test both versions in CI to
633
+ ensure compatibility.
634
+</Callout>
635
+
636
+---
637
+
638
+### Step 4: Test Your Integration
639
+
640
+1. **Run your test suite** to catch any issues
641
+2. **Test webhook verification** if you use triggers
642
+3. **Test file uploads/downloads** - behavior improved but API unchanged
643
+4. **Test in your target runtime** (Node.js, Cloudflare Workers, etc.)
644
+
645
+---
646
+
647
+## Backward Compatibility
648
+
649
+### Fully Compatible (No Changes Needed)
650
+
651
+The following features work without any code changes:
652
+
653
+- ✅ All tool execution APIs
654
+- ✅ Connected accounts management
655
+- ✅ Authentication flows
656
+- ✅ Custom tools
657
+- ✅ Tool Router sessions
658
+- ✅ File upload/download (API unchanged, implementation improved)
659
+- ✅ All provider packages (except Mastra)
660
+- ✅ Python SDK usage (except webhook verification)
661
+
662
+### Requires Changes
663
+
664
+The following features require code updates:
665
+
666
+- ⚠️ **Webhook verification (TypeScript)** - Must add `await` AND add `id` + `timestamp` parameters, update header names
667
+- ⚠️ **Webhook verification (Python)** - Must add `id` + `timestamp` parameters, update header names (still synchronous)
668
+- ⚠️ **Mastra integration (TypeScript only)** - Must update to v1 API
669
+
670
+---
671
+
672
+## Impact Summary
673
+
674
+| Change | TypeScript Breaking | Python Breaking | Migration Required | Effort |
675
+| --------------------------------- | -------------------------- | ----------------------- | ---------------------- | ----------------------------- |
676
+| Webhook verification - TypeScript | ✅ Yes (async + signature) | N/A | ✅ Required | Medium - Add `await` + params |
677
+| Webhook verification - Python | N/A | ✅ Yes (signature only) | ✅ Required | Low - Add parameters |
678
+| Mastra v1 support | ✅ Yes | N/A | ✅ Required (if using) | Medium - Update API |
679
+| Platform-specific file modifier | ❌ No | ❌ No | ❌ Optional | None - Automatic |
680
+| Config defaults | ❌ No | ❌ No | ❌ Optional | None - Automatic |
681
+| Buffer → Uint8Array | ❌ No | N/A | ❌ Optional | None - Automatic |
682
+| Tool version fix | ❌ No | ❌ No | ❌ Optional | None - Automatic |
683
+| JSON schema coercion | ❌ No | ❌ No | ❌ Optional | None - Automatic |
684
+| Salesforce type fix | ❌ No | ❌ No | ❌ Optional | None - Automatic |
685
+
686
+---
687
+
688
+## Cloudflare Workers Support
689
+
690
+This release adds support for Cloudflare Workers:
691
+
692
+```typescript
693
+// @noErrors
694
+import { Composio } from '@composio/core';
695
+
696
+export default {
697
+ async fetch(request: Request, env: Env): Promise<Response> {
698
+ const composio = new Composio({
699
+ apiKey: env.COMPOSIO_API_KEY,
700
+ });
701
+
702
+ // SDK now works in Cloudflare Workers!
703
+ const tools = await composio.tools.get('user_123', {
704
+ toolkits: ['github'],
705
+ });
706
+
707
+ const result = await composio.tools.execute('GITHUB_CREATE_ISSUE', {
708
+ userId: 'user_123',
709
+ arguments: {
710
+ /* ... */
711
+ },
712
+ });
713
+
714
+ return new Response(JSON.stringify(result));
715
+ },
716
+};
717
+```
718
+
719
+**Key Features Working in Cloudflare Workers:**
720
+- ✅ Tool execution
721
+- ✅ Connected accounts
722
+- ✅ Webhook verification
723
+- ✅ File upload/download
724
+- ✅ Custom tools
725
+
726
+---
727
+
728
+## Testing
729
+
730
+This release includes extensive E2E testing:
731
+
732
+- ✅ **Node.js**: Both CJS and ESM compatibility tests
733
+- ✅ **Cloudflare Workers**: Multiple test suites including Tool Router
734
+- ✅ **Mastra v1**: Tests for both Zod v3 and v4
735
+- ✅ **File handling**: Comprehensive tests for all platforms
736
+- ✅ **Webhook verification**: Tests for all supported runtimes
737
+
738
+**Total new tests**: 200+ test cases added across TypeScript and Python SDKs.
739
+
740
+---
741
+
742
+## Getting Help
743
+
744
+If you encounter issues during migration:
745
+
746
+1. **Check the docs**: [docs.composio.dev](https://docs.composio.dev)
747
+2. **Join our Discord**: [discord.composio.dev](https://discord.composio.dev)
748
+3. **Open an issue**: [github.com/ComposioHQ/composio/issues](https://github.com/ComposioHQ/composio/issues)
749
+4. **Email support**: [support@composio.dev](mailto:support@composio.dev)
750
+
751
+---
752
+
753
+## What's Next
754
+
755
+Future releases will focus on:
756
+
757
+- 🚀 Performance optimizations
758
+- 🔧 More platform-specific improvements
759
+- 📚 Enhanced TypeScript types
760
+- 🛠️ New tool integrations
761
+- 🔐 Advanced authentication flows
762
+
763
+Stay tuned for updates!
python/providers/anthropic/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-anthropic"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your Anthropic LLMs."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/anthropic/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_anthropic",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Anthropic LLMs.",
python/providers/autogen/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-autogen"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your autogen agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/autogen/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_autogen",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Autogen agent.",
python/providers/claude_agent_sdk/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-claude-agent-sdk"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with Claude Code Agents SDK."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/claude_agent_sdk/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9
setup(
10
name="composio_claude_agent_sdk",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools for Claude Agent SDK",
python/providers/crewai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-crewai"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your CrewAI agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/crewai/setup.py
+1
-1
@@ -6,7 +6,7 @@ from setuptools import setup
6
7
setup(
8
name="composio_crewai",
9
- version="0.10.10",
9
+ version="0.10.11",
10
author="Composio",
11
author_email="tech@composio.dev",
12
description="Use Composio to get an array of tools with your CrewAI agent.",
python/providers/gemini/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-gemini"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your Gemini agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/gemini/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_gemini",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Gemini agent.",
python/providers/google/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/google/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/google_adk/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google-adk"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/google_adk/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google_adk",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/langchain/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langchain"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your Langchain agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/langchain/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langchain",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Langchain agent.",
python/providers/langgraph/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langgraph"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/langgraph/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langgraph",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LangGraph Agent Workflows",
python/providers/llamaindex/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-llamaindex"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/llamaindex/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_llamaindex",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
python/providers/openai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get an array of tools with your OpenAI Function Call."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/openai/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_openai",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your OpenAI Function Call.",
python/providers/openai_agents/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai-agents"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/openai_agents/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9
setup(
10
name="composio_openai_agents",
11
- version="0.10.10",
11
+ version="0.10.11",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio"
3
-version = "0.10.10"
3
+version = "0.10.11"
4
description = "SDK for integrating Composio with your applications."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
ts/packages/core/CHANGELOG.md
+24
-9
@@ -1,5 +1,29 @@
1
# @composio/core
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- **BREAKING**: Webhook verification now async with new signature
8
+ - `composio.triggers.verifyWebhook()` now requires `await`
9
+ - New required parameters: `id` (webhook-id header) and `timestamp` (webhook-timestamp header)
10
+ - Uses Web Crypto API for Cloudflare Workers compatibility
11
+ - Supports v1, v2, and v3 webhook formats
12
+- **BREAKING**: Mastra provider updated to v1 API
13
+ - Requires Mastra v1 and Node.js v22.13.0+
14
+ - New initialization pattern with Mastra instance
15
+ - E2E tests for Zod v3 and v4 compatibility
16
+
17
+- Platform-specific optimizations
18
+ - Separate file tool modifiers for Node.js and Cloudflare Workers
19
+ - Platform-specific config defaults (autoUploadDownloadFiles)
20
+ - Removed node:buffer usage, replaced with Uint8Array
21
+ - Removed node:crypto from triggers for edge runtime support
22
+
23
+- Bug fixes
24
+ - Fixed tool fetching with specific version constraints
25
+ - Improved type safety across the SDK
26
+
27
## 0.5.5
28
29
### Patch Changes
@@ -149,14 +173,12 @@
173
This PR adds support for toolkit versions in the TypeScript SDK and introduces new fields for tracking tool deprecation status and no-auth capabilities.
174
175
### Core Features
152
-
176
- **Toolkit Versions Support**:
177
- Added `toolkit_versions` parameter to the `Triggers` class, defaulting to `"latest"`
178
- Made `Triggers` class generic to accept provider configuration
179
- Pass `toolkit_versions` when listing trigger types
180
181
### New Fields
159
-
182
- **Tool Types**:
183
- Added `isDeprecated` field to track deprecated tools
184
- Added `isNoAuth` field to identify tools that support no-auth mode
@@ -166,20 +188,17 @@
188
- Added `availableVersions` array to track all available versions
189
190
### Code Changes
169
-
191
- Updated `Composio` class to pass config to `Triggers` constructor
192
- Updated `Tools.get()` to include new `isDeprecated` and `isNoAuth` fields
193
- Updated transformers for toolkits and triggers to handle new fields
194
- Added TypeScript types for all new fields
195
196
### Tests
176
-
197
- Updated trigger tests to account for `toolkit_versions` and `cursor` parameters
198
- Fixed generic type usage in `Triggers` test declarations
199
- All 376 tests passing ✅
200
201
### Dependencies
182
-
202
- Updated `@composio/client` to version `0.1.0-alpha.38`
203
- Updated `pnpm-lock.yaml` with dependency resolution changes
204
@@ -204,7 +223,6 @@
223
### Minor Changes
224
225
- 157bf7b: ### Added
207
-
226
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
227
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
228
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -212,7 +230,6 @@
230
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
231
232
### Changed
215
-
233
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
234
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
235
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -220,7 +237,6 @@
237
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
238
239
### Fixed
223
-
240
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
241
- **Code formatting**: Applied ruff formatting to all modified Python files
242
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -262,7 +278,6 @@
278
```
279
280
### Developer Notes
265
-
281
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
282
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
283
- Error messages include all available resolution options for better developer experience
ts/packages/core/package.json
+1
-1
@@ -1,7 +1,7 @@
1
{
2
"name": "@composio/core",
3
"type": "module",
4
- "version": "0.5.5",
4
+ "version": "0.6.0",
5
"description": "",
6
"main": "src/index.ts",
7
"publishConfig": {
ts/packages/providers/anthropic/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/anthropic
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/anthropic/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/anthropic",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "Non-Agentic Provider for Anthropic in Composio SDK",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -43,7 +43,7 @@
43
"packageManager": "pnpm@10.28.0",
44
"peerDependencies": {
45
"@anthropic-ai/sdk": "^0.52.0",
46
- "@composio/core": "0.5.5",
46
+ "@composio/core": "0.6.0",
47
"@mastra/mcp": "^0.12.0"
48
},
49
"devDependencies": {
ts/packages/providers/claude-agent-sdk/CHANGELOG.md
+11
@@ -1,5 +1,16 @@
1
# @composio/claude-code-agents
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
ts/packages/providers/claude-agent-sdk/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/claude-agent-sdk",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "Composio provider for Claude Agent SDK",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -48,7 +48,7 @@
48
"zod": "^3.25.76"
49
},
50
"peerDependencies": {
51
- "@composio/core": "0.5.5",
51
+ "@composio/core": "0.6.0",
52
"@anthropic-ai/claude-agent-sdk": ">=0.1.0"
53
},
54
"devDependencies": {
ts/packages/providers/cloudflare/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/cloudflare
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/cloudflare/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/cloudflare",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -39,7 +39,7 @@
39
"packageManager": "pnpm@10.28.0",
40
"peerDependencies": {
41
"@cloudflare/workers-types": "catalog:",
42
- "@composio/core": "0.5.5"
42
+ "@composio/core": "0.6.0"
43
},
44
"devDependencies": {
45
"@composio/core": "workspace:*",
ts/packages/providers/google/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/google
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/google/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/google",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "Google GenAI Provider for Composio SDK",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -44,7 +44,7 @@
44
"license": "ISC",
45
"packageManager": "pnpm@10.28.0",
46
"peerDependencies": {
47
- "@composio/core": "0.5.5",
47
+ "@composio/core": "0.6.0",
48
"@google/genai": "^1.1.0"
49
},
50
"devDependencies": {
ts/packages/providers/langchain/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/langchain
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/langchain/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/langchain",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "",
5
"main": "dist/index.js",
6
"publishConfig": {
@@ -38,7 +38,7 @@
38
"license": "ISC",
39
"packageManager": "pnpm@10.28.0",
40
"peerDependencies": {
41
- "@composio/core": "0.5.5",
41
+ "@composio/core": "0.6.0",
42
"@langchain/core": "^1.1.4"
43
},
44
"devDependencies": {
ts/packages/providers/llamaindex/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/llamaindex
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/llamaindex/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/llamaindex",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "Agentic Provider for llamaindex in Composio SDK",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -41,7 +41,7 @@
41
"license": "ISC",
42
"packageManager": "pnpm@10.28.0",
43
"peerDependencies": {
44
- "@composio/core": "0.5.5",
44
+ "@composio/core": "0.6.0",
45
"llamaindex": "^0.12.0"
46
},
47
"devDependencies": {
ts/packages/providers/mastra/CHANGELOG.md
+15
-4
@@ -1,5 +1,20 @@
1
# @composio/mastra
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- **BREAKING**: Updated to Mastra v1 API
8
+ - New initialization requires passing Mastra instance to provider
9
+ - Supports both Zod v3 and v4
10
+ - Requires Node.js v22.13.0 or higher
11
+ - Added E2E tests for Tool Router integration
12
+
13
+### Patch Changes
14
+
15
+- Updated dependencies
16
+ - @composio/core@0.6.0
17
+
18
## 0.5.5
19
20
### Patch Changes
@@ -183,7 +198,6 @@
198
### Minor Changes
199
200
- 157bf7b: ### Added
186
-
201
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
202
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
203
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +205,6 @@
205
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
206
207
### Changed
194
-
208
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
209
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
210
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +212,6 @@
212
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
213
214
### Fixed
202
-
215
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
216
- **Code formatting**: Applied ruff formatting to all modified Python files
217
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +253,6 @@
253
```
254
255
### Developer Notes
244
-
256
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
257
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
258
- Error messages include all available resolution options for better developer experience
ts/packages/providers/mastra/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/mastra",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "Agentic Provider for mastra in Composio SDK",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -43,7 +43,7 @@
43
"license": "ISC",
44
"packageManager": "pnpm@10.28.0",
45
"peerDependencies": {
46
- "@composio/core": "0.5.5",
46
+ "@composio/core": "0.6.0",
47
"@mastra/core": "^1.0.4",
48
"zod": "^3.25 || ^4"
49
},
ts/packages/providers/openai-agents/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/openai-agents
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/openai-agents/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/openai-agents",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -38,7 +38,7 @@
38
"license": "ISC",
39
"packageManager": "pnpm@10.28.0",
40
"peerDependencies": {
41
- "@composio/core": "0.5.5",
41
+ "@composio/core": "0.6.0",
42
"@openai/agents": "^0.1.3",
43
"zod": "catalog:"
44
},
ts/packages/providers/openai/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/openai
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -183,7 +194,6 @@
194
### Minor Changes
195
196
- 157bf7b: ### Added
186
-
197
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
198
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
199
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -191,7 +201,6 @@
201
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
202
203
### Changed
194
-
204
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
205
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
206
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -199,7 +208,6 @@
208
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
209
210
### Fixed
202
-
211
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
212
- **Code formatting**: Applied ruff formatting to all modified Python files
213
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -241,7 +249,6 @@
249
```
250
251
### Developer Notes
244
-
252
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
253
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
254
- Error messages include all available resolution options for better developer experience
ts/packages/providers/openai/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/openai",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -38,7 +38,7 @@
38
"license": "ISC",
39
"packageManager": "pnpm@10.28.0",
40
"peerDependencies": {
41
- "@composio/core": "0.5.5",
41
+ "@composio/core": "0.6.0",
42
"openai": "catalog:"
43
},
44
"devDependencies": {
ts/packages/providers/vercel/CHANGELOG.md
+11
-4
@@ -1,5 +1,16 @@
1
# @composio/vercel
2
3
+## 0.6.0
4
+
5
+### Minor Changes
6
+
7
+- Breaking: Fixes for cloudflare support, webhook verification and other fixes
8
+
9
+### Patch Changes
10
+
11
+- Updated dependencies
12
+ - @composio/core@0.6.0
13
+
14
## 0.5.5
15
16
### Patch Changes
@@ -184,7 +195,6 @@
195
### Patch Changes
196
197
- 157bf7b: ### Added
187
-
198
- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
199
- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
200
- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
@@ -192,7 +202,6 @@
202
- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
203
204
### Changed
195
-
205
- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
206
- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
207
- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
@@ -200,7 +209,6 @@
209
- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
210
211
### Fixed
203
-
212
- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
213
- **Code formatting**: Applied ruff formatting to all modified Python files
214
- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
@@ -242,7 +250,6 @@
250
```
251
252
### Developer Notes
245
-
253
- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
254
- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
255
- Error messages include all available resolution options for better developer experience
ts/packages/providers/vercel/package.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"name": "@composio/vercel",
3
- "version": "0.5.5",
3
+ "version": "0.6.0",
4
"description": "",
5
"main": "src/index.ts",
6
"publishConfig": {
@@ -38,7 +38,7 @@
38
"license": "ISC",
39
"packageManager": "pnpm@10.28.0",
40
"peerDependencies": {
41
- "@composio/core": "0.5.5",
41
+ "@composio/core": "0.6.0",
42
"ai": "^5.0.0 || ^6.0.0"
43
},
44
"devDependencies": {