@devries-cameron20 / composio Mirror · read-only / commits / 263936cab
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, 19:30 UTC

Release: update version (#2077)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Musthaq Ahamad committed Oct 22, 2025 at 11:25 UTC 263936cab48eb2cd56bfd58cf6c4f4cb97ef49d3
24 files changed +803 -89
.changeset/vast-rings-tan.md deleted
-68
@@ -1,68 +0,0 @@
1 ----
2 -'@composio/core': minor
3 -'@composio/anthropic': minor
4 -'@composio/cloudflare': minor
5 -'@composio/google': minor
6 -'@composio/langchain': minor
7 -'@composio/llamaindex': minor
8 -'@composio/mastra': minor
9 -'@composio/openai': minor
10 -'@composio/openai-agents': minor
11 -'@composio/vercel': patch
12 -'@composio/json-schema-to-zod': patch
13 ----
14 -
15 -### Added
16 -- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
17 -- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
18 -- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
19 -- **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
20 -- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
21 -
22 -### Changed
23 -- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
24 -- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
25 -- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
26 -- **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
27 -- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
28 -
29 -### Fixed
30 -- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
31 -- **Code formatting**: Applied ruff formatting to all modified Python files
32 -- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
33 -
34 -### Migration Guide
35 -When manually executing tools, you must now specify toolkit versions:
36 -
37 -**Option 1: Pass explicit version parameter**
38 -```python
39 -tools.execute("GITHUB_CREATE_ISSUE",
40 - arguments={...},
41 - version="20251201_01"
42 -)
43 -```
44 -
45 -**Option 2: Configure at SDK initialization**
46 -```python
47 -tools = Tools(client, provider,
48 - toolkit_versions={"github": "20251201_01"}
49 -)
50 -```
51 -
52 -**Option 3: Use environment variables**
53 -```bash
54 -export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
55 -```
56 -
57 -**Option 4: Skip validation (not recommended)**
58 -```python
59 -tools.execute("GITHUB_CREATE_ISSUE",
60 - arguments={...},
61 - dangerously_skip_version_check=True
62 -)
63 -```
64 -
65 -### Developer Notes
66 -- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
67 -- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
68 -- Error messages include all available resolution options for better developer experience
\ No newline at end of file
fern/pages/src/changelog/10-22-25.md new
+48
@@ -0,0 +1,48 @@
1 +## Adds Version Checks for Tool Execution and Improved Execution Speed in TS SDK
2 +
3 +### Summary
4 +Added version validation for manual tool execution to prevent unexpected behavior when using `latest` toolkit versions. This ensures users explicitly specify toolkit versions when executing tools manually, while allowing flexibility through a skip flag.
5 +
6 +This release also eliminates a lot of redundant API calls made to check connected account during tool execution, effectively increasing the performance of tool execution.
7 +
8 +### Key Changes
9 +
10 +#### Python SDK (`python/`)
11 +- ✅ Added `ToolVersionRequiredError` exception with detailed error messages and fix suggestions
12 +- ✅ Added `dangerously_skip_version_check` parameter to `execute()` method
13 +- ✅ Modified `_execute_tool()` to validate version is not `latest` unless skip flag is set
14 +- ✅ Automatically passes `dangerously_skip_version_check=True` for agentic provider flows
15 +- ✅ Added comprehensive test coverage (19 test methods) in `test_tool_execution.py`
16 +
17 +#### TypeScript SDK (`ts/packages/core/`)
18 +- ✅ Added `ComposioToolVersionRequiredError` error class with possible fixes
19 +- ✅ Added `dangerouslySkipVersionCheck` parameter to execute flow
20 +- ✅ Modified tool execution to validate version before API calls
21 +- ✅ Updated execution type definitions in `tool.types.ts` and `modifiers.types.ts`
22 +- ✅ Updated test files with date-based version format (`20251201_xx`)
23 +- ✅ Improved tool execution by eliminating redundant API calls
24 +
25 +### Behavior
26 +**Before:** Tools could be executed with `latest` version, risking unexpected behavior on toolkit updates
27 +
28 +**After:** Manual execution requires specific version or explicit skip flag:
29 +```python
30 +# ❌ Raises ToolVersionRequiredError
31 +tools.execute("GITHUB_CREATE_ISSUE", {...})
32 +
33 +# ✅ Works - explicit version
34 +tools.execute("GITHUB_CREATE_ISSUE", {...}, version="20251201_01")
35 +
36 +# ✅ Works - configured toolkit versions
37 +tools = Tools(client, provider, toolkit_versions={"github": "20251201_01"})
38 +
39 +# ✅ Works - with skip flag (use cautiously)
40 +tools.execute("GITHUB_CREATE_ISSUE", {...}, dangerously_skip_version_check=True)
41 +```
42 +
43 +### Breaking Changes
44 +⚠️ Manual tool execution without version specification now throws an error. Users must either:
45 +1. Pass explicit version parameter
46 +2. Configure toolkit versions in SDK initialization
47 +3. Set environment variable `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_SLUG>`
48 +4. Use `dangerously_skip_version_check=True` flag
\ No newline at end of file
ts/packages/core/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/core
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/json-schema-to-zod@0.1.17
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/core/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/core",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/json-schema-to-zod/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/json-schema-to-zod
2
3 +## 0.1.17
4 +
5 +### Patch Changes
6 +
7 +- 157bf7b: Fix array parsing
8 +
9 ## 0.1.16
10
11 ### Patch Changes
ts/packages/json-schema-to-zod/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/json-schema-to-zod",
3 - "version": "0.1.16",
3 + "version": "0.1.17",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/anthropic/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/anthropic
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/anthropic/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/anthropic",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "Non-Agentic Provider for Anthropic in Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
@@ -35,7 +35,7 @@
35 "packageManager": "pnpm@10.17.0",
36 "peerDependencies": {
37 "@anthropic-ai/sdk": "^0.52.0",
38 - "@composio/core": "0.1.55",
38 + "@composio/core": "0.2.0",
39 "@mastra/mcp": "^0.12.0"
40 },
41 "devDependencies": {
ts/packages/providers/cloudflare/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/cloudflare
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/cloudflare/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/cloudflare",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
@@ -31,7 +31,7 @@
31 "packageManager": "pnpm@10.17.0",
32 "peerDependencies": {
33 "@cloudflare/workers-types": "catalog:",
34 - "@composio/core": "0.1.55"
34 + "@composio/core": "0.2.0"
35 },
36 "devDependencies": {
37 "@composio/core": "workspace:*",
ts/packages/providers/google/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/google
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/google/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/google",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "Google GenAI Provider for Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
@@ -36,7 +36,7 @@
36 "license": "ISC",
37 "packageManager": "pnpm@10.17.0",
38 "peerDependencies": {
39 - "@composio/core": "0.1.55",
39 + "@composio/core": "0.2.0",
40 "@google/genai": "^1.1.0"
41 },
42 "devDependencies": {
ts/packages/providers/langchain/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/langchain
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/langchain/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/langchain",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "",
5 "main": "dist/index.js",
6 "type": "module",
@@ -30,7 +30,7 @@
30 "license": "ISC",
31 "packageManager": "pnpm@10.17.0",
32 "peerDependencies": {
33 - "@composio/core": "0.1.55",
33 + "@composio/core": "0.2.0",
34 "@langchain/core": "^0.3.63"
35 },
36 "devDependencies": {
ts/packages/providers/llamaindex/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/llamaindex
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/llamaindex/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/llamaindex",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "Agentic Provider for llamaindex in Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
@@ -33,7 +33,7 @@
33 "license": "ISC",
34 "packageManager": "pnpm@10.17.0",
35 "peerDependencies": {
36 - "@composio/core": "0.1.55",
36 + "@composio/core": "0.2.0",
37 "llamaindex": "^0.12.0"
38 },
39 "devDependencies": {
ts/packages/providers/mastra/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/mastra
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.56
77
78 ### Patch Changes
ts/packages/providers/mastra/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/mastra",
3 - "version": "0.1.56",
3 + "version": "0.2.0",
4 "description": "Agentic Provider for mastra in Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
@@ -34,7 +34,7 @@
34 "license": "ISC",
35 "packageManager": "pnpm@10.17.0",
36 "peerDependencies": {
37 - "@composio/core": "0.1.55",
37 + "@composio/core": "0.2.0",
38 "@mastra/core": "^0.16.2",
39 "@mastra/mcp": "^0.12.0"
40 },
ts/packages/providers/openai-agents/CHANGELOG.md
+74 -1
@@ -1,4 +1,77 @@
1 -# @composio/vercel
1 +# @composio/openai-agents
2 +
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75
76 ## 0.1.56
77
ts/packages/providers/openai-agents/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/openai-agents",
3 - "version": "0.1.56",
3 + "version": "0.2.0",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
@@ -30,7 +30,7 @@
30 "license": "ISC",
31 "packageManager": "pnpm@10.17.0",
32 "peerDependencies": {
33 - "@composio/core": "0.1.55",
33 + "@composio/core": "0.2.0",
34 "@openai/agents": "^0.1.3",
35 "zod": "catalog:"
36 },
ts/packages/providers/openai/CHANGELOG.md
+73
@@ -1,5 +1,78 @@
1 # @composio/openai
2
3 +## 0.2.0
4 +
5 +### Minor Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +### Patch Changes
72 +
73 +- Updated dependencies [157bf7b]
74 + - @composio/core@0.2.0
75 +
76 ## 0.1.55
77
78 ### Patch Changes
ts/packages/providers/openai/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/openai",
3 - "version": "0.1.55",
3 + "version": "0.2.0",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
@@ -30,7 +30,7 @@
30 "license": "ISC",
31 "packageManager": "pnpm@10.17.0",
32 "peerDependencies": {
33 - "@composio/core": "0.1.55",
33 + "@composio/core": "0.2.0",
34 "openai": "^5.16.0"
35 },
36 "devDependencies": {
ts/packages/providers/vercel/CHANGELOG.md
+71
@@ -1,5 +1,76 @@
1 # @composio/vercel
2
3 +## 0.2.12
4 +
5 +### Patch Changes
6 +
7 +- 157bf7b: ### Added
8 +
9 + - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
10 + - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
11 + - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
12 + - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
13 + - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
14 +
15 + ### Changed
16 +
17 + - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
18 + - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
19 + - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
20 + - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
21 + - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
22 +
23 + ### Fixed
24 +
25 + - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
26 + - **Code formatting**: Applied ruff formatting to all modified Python files
27 + - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
28 +
29 + ### Migration Guide
30 +
31 + When manually executing tools, you must now specify toolkit versions:
32 +
33 + **Option 1: Pass explicit version parameter**
34 +
35 + ```python
36 + tools.execute("GITHUB_CREATE_ISSUE",
37 + arguments={...},
38 + version="20251201_01"
39 + )
40 + ```
41 +
42 + **Option 2: Configure at SDK initialization**
43 +
44 + ```python
45 + tools = Tools(client, provider,
46 + toolkit_versions={"github": "20251201_01"}
47 + )
48 + ```
49 +
50 + **Option 3: Use environment variables**
51 +
52 + ```bash
53 + export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
54 + ```
55 +
56 + **Option 4: Skip validation (not recommended)**
57 +
58 + ```python
59 + tools.execute("GITHUB_CREATE_ISSUE",
60 + arguments={...},
61 + dangerously_skip_version_check=True
62 + )
63 + ```
64 +
65 + ### Developer Notes
66 +
67 + - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
68 + - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
69 + - Error messages include all available resolution options for better developer experience
70 +
71 +- Updated dependencies [157bf7b]
72 + - @composio/core@0.2.0
73 +
74 ## 0.2.11
75
76 ### Patch Changes
ts/packages/providers/vercel/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/vercel",
3 - "version": "0.2.11",
3 + "version": "0.2.12",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
@@ -30,7 +30,7 @@
30 "license": "ISC",
31 "packageManager": "pnpm@10.17.0",
32 "peerDependencies": {
33 - "@composio/core": "0.1.55",
33 + "@composio/core": "0.2.0",
34 "ai": "^5.0.44"
35 },
36 "devDependencies": {