Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Release: update version (#2077)

Musthaq Ahamad263936cab48e
diff --git a/.changeset/vast-rings-tan.md b/.changeset/vast-rings-tan.md
deleted file mode 100644
index b4fe54bd8..000000000
--- a/.changeset/vast-rings-tan.md
+++ /dev/null
@@ -1,68 +0,0 @@
----
-'@composio/core': minor
-'@composio/anthropic': minor
-'@composio/cloudflare': minor
-'@composio/google': minor
-'@composio/langchain': minor
-'@composio/llamaindex': minor
-'@composio/mastra': minor
-'@composio/openai': minor
-'@composio/openai-agents': minor
-'@composio/vercel': patch
-'@composio/json-schema-to-zod': patch
----
-
-### Added
-- **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
-- **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
-- **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
-- **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
-- **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
-
-### Changed
-- **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
-- **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
-- **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
-- **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
-- **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
-
-### Fixed
-- **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
-- **Code formatting**: Applied ruff formatting to all modified Python files
-- **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
-
-### Migration Guide
-When manually executing tools, you must now specify toolkit versions:
-
-**Option 1: Pass explicit version parameter**
-```python
-tools.execute("GITHUB_CREATE_ISSUE",
- arguments={...},
- version="20251201_01"
-)
-```
-
-**Option 2: Configure at SDK initialization**
-```python
-tools = Tools(client, provider,
- toolkit_versions={"github": "20251201_01"}
-)
-```
-
-**Option 3: Use environment variables**
-```bash
-export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
-```
-
-**Option 4: Skip validation (not recommended)**
-```python
-tools.execute("GITHUB_CREATE_ISSUE",
- arguments={...},
- dangerously_skip_version_check=True
-)
-```
-
-### Developer Notes
-- Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
-- The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
-- Error messages include all available resolution options for better developer experience
\ No newline at end of file
diff --git a/fern/pages/src/changelog/10-22-25.md b/fern/pages/src/changelog/10-22-25.md
new file mode 100644
index 000000000..70a5de808
--- /dev/null
+++ b/fern/pages/src/changelog/10-22-25.md
@@ -0,0 +1,48 @@
+## Adds Version Checks for Tool Execution and Improved Execution Speed in TS SDK
+
+### Summary
+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.
+
+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.
+
+### Key Changes
+
+#### Python SDK (`python/`)
+- ✅ Added `ToolVersionRequiredError` exception with detailed error messages and fix suggestions
+- ✅ Added `dangerously_skip_version_check` parameter to `execute()` method
+- ✅ Modified `_execute_tool()` to validate version is not `latest` unless skip flag is set
+- ✅ Automatically passes `dangerously_skip_version_check=True` for agentic provider flows
+- ✅ Added comprehensive test coverage (19 test methods) in `test_tool_execution.py`
+
+#### TypeScript SDK (`ts/packages/core/`)
+- ✅ Added `ComposioToolVersionRequiredError` error class with possible fixes
+- ✅ Added `dangerouslySkipVersionCheck` parameter to execute flow
+- ✅ Modified tool execution to validate version before API calls
+- ✅ Updated execution type definitions in `tool.types.ts` and `modifiers.types.ts`
+- ✅ Updated test files with date-based version format (`20251201_xx`)
+- ✅ Improved tool execution by eliminating redundant API calls
+
+### Behavior
+**Before:** Tools could be executed with `latest` version, risking unexpected behavior on toolkit updates
+
+**After:** Manual execution requires specific version or explicit skip flag:
+```python
+# ❌ Raises ToolVersionRequiredError
+tools.execute("GITHUB_CREATE_ISSUE", {...})
+
+# ✅ Works - explicit version
+tools.execute("GITHUB_CREATE_ISSUE", {...}, version="20251201_01")
+
+# ✅ Works - configured toolkit versions
+tools = Tools(client, provider, toolkit_versions={"github": "20251201_01"})
+
+# ✅ Works - with skip flag (use cautiously)
+tools.execute("GITHUB_CREATE_ISSUE", {...}, dangerously_skip_version_check=True)
+```
+
+### Breaking Changes
+⚠️ Manual tool execution without version specification now throws an error. Users must either:
+1. Pass explicit version parameter
+2. Configure toolkit versions in SDK initialization
+3. Set environment variable `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_SLUG>`
+4. Use `dangerously_skip_version_check=True` flag
\ No newline at end of file
diff --git a/ts/packages/core/CHANGELOG.md b/ts/packages/core/CHANGELOG.md
index f68ba4054..163af3e58 100644
--- a/ts/packages/core/CHANGELOG.md
+++ b/ts/packages/core/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/core
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/core/package.json b/ts/packages/core/package.json
index c5c723055..a466305ed 100644
--- a/ts/packages/core/package.json
+++ b/ts/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/core",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "",
"main": "src/index.ts",
"type": "module",
diff --git a/ts/packages/json-schema-to-zod/CHANGELOG.md b/ts/packages/json-schema-to-zod/CHANGELOG.md
index a20c5afcf..3436ce2c1 100644
--- a/ts/packages/json-schema-to-zod/CHANGELOG.md
+++ b/ts/packages/json-schema-to-zod/CHANGELOG.md
@@ -1,5 +1,11 @@
# @composio/json-schema-to-zod
+## 0.1.17
+
+### Patch Changes
+
+- 157bf7b: Fix array parsing
+
## 0.1.16
### Patch Changes
diff --git a/ts/packages/json-schema-to-zod/package.json b/ts/packages/json-schema-to-zod/package.json
index 665e3ee90..4dbc5a806 100644
--- a/ts/packages/json-schema-to-zod/package.json
+++ b/ts/packages/json-schema-to-zod/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/json-schema-to-zod",
- "version": "0.1.16",
+ "version": "0.1.17",
"description": "",
"main": "src/index.ts",
"type": "module",
diff --git a/ts/packages/providers/anthropic/CHANGELOG.md b/ts/packages/providers/anthropic/CHANGELOG.md
index 9467842b2..6055bd0ef 100644
--- a/ts/packages/providers/anthropic/CHANGELOG.md
+++ b/ts/packages/providers/anthropic/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/anthropic
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/anthropic/package.json b/ts/packages/providers/anthropic/package.json
index 13c149167..e34e90d5a 100644
--- a/ts/packages/providers/anthropic/package.json
+++ b/ts/packages/providers/anthropic/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/anthropic",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "Non-Agentic Provider for Anthropic in Composio SDK",
"main": "src/index.ts",
"type": "module",
@@ -35,7 +35,7 @@
"packageManager": "[email protected]",
"peerDependencies": {
"@anthropic-ai/sdk": "^0.52.0",
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"@mastra/mcp": "^0.12.0"
},
"devDependencies": {
diff --git a/ts/packages/providers/cloudflare/CHANGELOG.md b/ts/packages/providers/cloudflare/CHANGELOG.md
index 9268bf23e..6d09cdde3 100644
--- a/ts/packages/providers/cloudflare/CHANGELOG.md
+++ b/ts/packages/providers/cloudflare/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/cloudflare
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/cloudflare/package.json b/ts/packages/providers/cloudflare/package.json
index cf68df625..44004c452 100644
--- a/ts/packages/providers/cloudflare/package.json
+++ b/ts/packages/providers/cloudflare/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/cloudflare",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "",
"main": "src/index.ts",
"type": "module",
@@ -31,7 +31,7 @@
"packageManager": "[email protected]",
"peerDependencies": {
"@cloudflare/workers-types": "catalog:",
- "@composio/core": "0.1.55"
+ "@composio/core": "0.2.0"
},
"devDependencies": {
"@composio/core": "workspace:*",
diff --git a/ts/packages/providers/google/CHANGELOG.md b/ts/packages/providers/google/CHANGELOG.md
index b2f8f5420..d201ccd94 100644
--- a/ts/packages/providers/google/CHANGELOG.md
+++ b/ts/packages/providers/google/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/google
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/google/package.json b/ts/packages/providers/google/package.json
index 77ffe42d1..e6647f6ad 100644
--- a/ts/packages/providers/google/package.json
+++ b/ts/packages/providers/google/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/google",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "Google GenAI Provider for Composio SDK",
"main": "src/index.ts",
"type": "module",
@@ -36,7 +36,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"@google/genai": "^1.1.0"
},
"devDependencies": {
diff --git a/ts/packages/providers/langchain/CHANGELOG.md b/ts/packages/providers/langchain/CHANGELOG.md
index afff1830d..3ddc4a08d 100644
--- a/ts/packages/providers/langchain/CHANGELOG.md
+++ b/ts/packages/providers/langchain/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/langchain
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/langchain/package.json b/ts/packages/providers/langchain/package.json
index 895ced0ed..239d5e747 100644
--- a/ts/packages/providers/langchain/package.json
+++ b/ts/packages/providers/langchain/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/langchain",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "",
"main": "dist/index.js",
"type": "module",
@@ -30,7 +30,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"@langchain/core": "^0.3.63"
},
"devDependencies": {
diff --git a/ts/packages/providers/llamaindex/CHANGELOG.md b/ts/packages/providers/llamaindex/CHANGELOG.md
index d2eb94f9b..0dd5d0dd2 100644
--- a/ts/packages/providers/llamaindex/CHANGELOG.md
+++ b/ts/packages/providers/llamaindex/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/llamaindex
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/llamaindex/package.json b/ts/packages/providers/llamaindex/package.json
index 92915a8bf..8d61d752f 100644
--- a/ts/packages/providers/llamaindex/package.json
+++ b/ts/packages/providers/llamaindex/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/llamaindex",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "Agentic Provider for llamaindex in Composio SDK",
"main": "src/index.ts",
"type": "module",
@@ -33,7 +33,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"llamaindex": "^0.12.0"
},
"devDependencies": {
diff --git a/ts/packages/providers/mastra/CHANGELOG.md b/ts/packages/providers/mastra/CHANGELOG.md
index 1afe71259..4b5f31ee6 100644
--- a/ts/packages/providers/mastra/CHANGELOG.md
+++ b/ts/packages/providers/mastra/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/mastra
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.56
### Patch Changes
diff --git a/ts/packages/providers/mastra/package.json b/ts/packages/providers/mastra/package.json
index aa9cc93a9..24340b439 100644
--- a/ts/packages/providers/mastra/package.json
+++ b/ts/packages/providers/mastra/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/mastra",
- "version": "0.1.56",
+ "version": "0.2.0",
"description": "Agentic Provider for mastra in Composio SDK",
"main": "src/index.ts",
"type": "module",
@@ -34,7 +34,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"@mastra/core": "^0.16.2",
"@mastra/mcp": "^0.12.0"
},
diff --git a/ts/packages/providers/openai-agents/CHANGELOG.md b/ts/packages/providers/openai-agents/CHANGELOG.md
index 4e2246947..db35d1645 100644
--- a/ts/packages/providers/openai-agents/CHANGELOG.md
+++ b/ts/packages/providers/openai-agents/CHANGELOG.md
@@ -1,4 +1,77 @@
-# @composio/vercel
+# @composio/openai-agents
+
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
## 0.1.56
diff --git a/ts/packages/providers/openai-agents/package.json b/ts/packages/providers/openai-agents/package.json
index 2866f050c..af36b0c65 100644
--- a/ts/packages/providers/openai-agents/package.json
+++ b/ts/packages/providers/openai-agents/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/openai-agents",
- "version": "0.1.56",
+ "version": "0.2.0",
"description": "",
"main": "src/index.ts",
"type": "module",
@@ -30,7 +30,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"@openai/agents": "^0.1.3",
"zod": "catalog:"
},
diff --git a/ts/packages/providers/openai/CHANGELOG.md b/ts/packages/providers/openai/CHANGELOG.md
index 15088da52..ff7b509ec 100644
--- a/ts/packages/providers/openai/CHANGELOG.md
+++ b/ts/packages/providers/openai/CHANGELOG.md
@@ -1,5 +1,78 @@
# @composio/openai
+## 0.2.0
+
+### Minor Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+### Patch Changes
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.1.55
### Patch Changes
diff --git a/ts/packages/providers/openai/package.json b/ts/packages/providers/openai/package.json
index 176a2f695..68f88d3ee 100644
--- a/ts/packages/providers/openai/package.json
+++ b/ts/packages/providers/openai/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/openai",
- "version": "0.1.55",
+ "version": "0.2.0",
"description": "",
"main": "src/index.ts",
"type": "module",
@@ -30,7 +30,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"openai": "^5.16.0"
},
"devDependencies": {
diff --git a/ts/packages/providers/vercel/CHANGELOG.md b/ts/packages/providers/vercel/CHANGELOG.md
index 7c877ac6d..b055c5f99 100644
--- a/ts/packages/providers/vercel/CHANGELOG.md
+++ b/ts/packages/providers/vercel/CHANGELOG.md
@@ -1,5 +1,76 @@
# @composio/vercel
+## 0.2.12
+
+### Patch Changes
+
+- 157bf7b: ### Added
+
+ - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes
+ - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution)
+ - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes
+ - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions
+ - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables
+
+ ### Changed
+
+ - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls
+ - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations
+ - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration
+ - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage
+ - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning
+
+ ### Fixed
+
+ - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK
+ - **Code formatting**: Applied ruff formatting to all modified Python files
+ - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties
+
+ ### Migration Guide
+
+ When manually executing tools, you must now specify toolkit versions:
+
+ **Option 1: Pass explicit version parameter**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ version="20251201_01"
+ )
+ ```
+
+ **Option 2: Configure at SDK initialization**
+
+ ```python
+ tools = Tools(client, provider,
+ toolkit_versions={"github": "20251201_01"}
+ )
+ ```
+
+ **Option 3: Use environment variables**
+
+ ```bash
+ export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01
+ ```
+
+ **Option 4: Skip validation (not recommended)**
+
+ ```python
+ tools.execute("GITHUB_CREATE_ISSUE",
+ arguments={...},
+ dangerously_skip_version_check=True
+ )
+ ```
+
+ ### Developer Notes
+
+ - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag
+ - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended
+ - Error messages include all available resolution options for better developer experience
+
+- Updated dependencies [157bf7b]
+ - @composio/[email protected]
+
## 0.2.11
### Patch Changes
diff --git a/ts/packages/providers/vercel/package.json b/ts/packages/providers/vercel/package.json
index fe5db1e9f..8fe867043 100644
--- a/ts/packages/providers/vercel/package.json
+++ b/ts/packages/providers/vercel/package.json
@@ -1,6 +1,6 @@
{
"name": "@composio/vercel",
- "version": "0.2.11",
+ "version": "0.2.12",
"description": "",
"main": "src/index.ts",
"type": "module",
@@ -30,7 +30,7 @@
"license": "ISC",
"packageManager": "[email protected]",
"peerDependencies": {
- "@composio/core": "0.1.55",
+ "@composio/core": "0.2.0",
"ai": "^5.0.44"
},
"devDependencies": {