Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
Release: update version (#2077)
Musthaq Ahamad263936cab48e
diff --git a/.changeset/vast-rings-tan.md b/.changeset/vast-rings-tan.mddeleted file mode 100644index 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 filediff --git a/fern/pages/src/changelog/10-22-25.md b/fern/pages/src/changelog/10-22-25.mdnew file mode 100644index 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 filediff --git a/ts/packages/core/CHANGELOG.md b/ts/packages/core/CHANGELOG.mdindex 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 Changesdiff --git a/ts/packages/core/package.json b/ts/packages/core/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/json-schema-to-zod/package.json b/ts/packages/json-schema-to-zod/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/anthropic/package.json b/ts/packages/providers/anthropic/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/cloudflare/package.json b/ts/packages/providers/cloudflare/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/google/package.json b/ts/packages/providers/google/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/langchain/package.json b/ts/packages/providers/langchain/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/llamaindex/package.json b/ts/packages/providers/llamaindex/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/mastra/package.json b/ts/packages/providers/mastra/package.jsonindex 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.mdindex 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.56diff --git a/ts/packages/providers/openai-agents/package.json b/ts/packages/providers/openai-agents/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/openai/package.json b/ts/packages/providers/openai/package.jsonindex 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.mdindex 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 Changesdiff --git a/ts/packages/providers/vercel/package.json b/ts/packages/providers/vercel/package.jsonindex 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": {