@devries-cameron20 / composio Mirror · read-only / commits / 74051f1fe
Fork 0

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": {