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
Revert "versioning docs"
Sushmithamalleshfa505bdbb001
diff --git a/fern/pages/src/migration-guide.mdx b/fern/pages/src/migration-guide.mdxindex ae240e6b1..57a0c5019 100644--- a/fern/pages/src/migration-guide.mdx+++ b/fern/pages/src/migration-guide.mdx@@ -205,93 +205,6 @@ To examine the raw schema definition of a tool for understanding input/output pa/></CodeGroup>-### Toolkit versioning--As of October 22, 2025, Composio enforces toolkit versioning to ensure consistent tool behavior across environments. This is a breaking change for manual tool execution.--#### Version requirement for manual execution--Manual tool execution now requires explicit version specification:--<CodeGroup>-```python Python-# Will fail without version (breaking change)-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {"user_id": "user-123", "arguments": {...}}-)--# Option 1: Configure version at SDK level-composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={"github": "20250116_00"}-)--# Option 2: Pass version with execution-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {...},- "toolkit_version": "20250116_00"- }-)--# Option 3: Skip version check (not recommended)-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {...},- "dangerously_skip_version_check": True- }-)-```--```typescript TypeScript-// Will fail without version (breaking change)-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...}-});--// Option 1: Configure version at SDK level-const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: { github: "20250116_00" }-});--// Option 2: Pass version with execution-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...},- toolkitVersion: "20250116_00"-});--// Option 3: Skip version check (not recommended)-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...},- dangerouslySkipVersionCheck: true-});-```-</CodeGroup>--#### Migration steps--1. **Audit your code**: Find all `tools.execute()` calls-2. **Choose a strategy**:- - Set toolkit versions globally in SDK initialization (recommended)- - Add version parameter to each execute call- - Use environment variables for deployment configuration-3. **Test thoroughly**: Verify tools work with pinned versions-4. **Deploy gradually**: Roll out changes incrementally--For complete documentation, see [Toolkit versioning](/tool-calling/toolkit-versioning).-### Executing toolsTool execution remains largely unchanged, with `user_id` now explicitly required.@@ -673,7 +586,7 @@ For development, you can also [listen to triggers through the SDK](/docs/using-t/></CodeGroup>-## Coming Soon+## π§ Coming Soon### Local toolsdiff --git a/fern/pages/src/tool-calling/executing-tools.mdx b/fern/pages/src/tool-calling/executing-tools.mdxindex a7cb22fc5..9c9dcc129 100644--- a/fern/pages/src/tool-calling/executing-tools.mdx+++ b/fern/pages/src/tool-calling/executing-tools.mdx@@ -58,84 +58,14 @@ Composio provides support for frameworks like this by making sure the tools areIn case you just want to call a tool without using any framework or LLM provider, you can use the `execute` method directly.-<Warning>-As of October 22, 2025, manual tool execution requires explicit version specification. Either configure toolkit versions in your SDK initialization or pass the version with each execution. See [toolkit versioning](/tool-calling/toolkit-versioning) for details.-</Warning>-<Tip icon="lightbulb">**Finding tool arguments**: In the [Auth Configstab](https://platform.composio.dev?next_page=/auth-configs) β Select your toolkit β Tools &Triggers β Select the tool to see its required and optional parameters, types, and descriptions.</Tip>-<CodeGroup>-```python Python-# Method 1: Configure version at SDK level-composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={"github": "20250116_00"}-)--result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "composio",- "owner": "composiohq",- "title": "Bug Report",- "body": "Issue description"- }- }-)--# Method 2: Pass version with execution-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "composio",- "owner": "composiohq",- "title": "Bug Report",- "body": "Issue description"- },- "toolkit_version": "20250116_00"- }-)-```--```typescript TypeScript-// Method 1: Configure version at SDK level-const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: { github: "20250116_00" }-});--const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "composio",- owner: "composiohq",- title: "Bug Report",- body: "Issue description"- }-});--// Method 2: Pass version with execution-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "composio",- owner: "composiohq",- title: "Bug Report",- body: "Issue description"- },- toolkitVersion: "20250116_00"-});-```+ <SnippetCode src="fern/snippets/tool-calling/python/direct-tool-call.py" title="Python" />+ <SnippetCode src="fern/snippets/tool-calling/typescript/direct-tool-call.ts" title="TypeScript" /></CodeGroup>### Proxy Execute -- Manually calling toolkit APIsdiff --git a/fern/pages/src/tool-calling/fetching-tools.mdx b/fern/pages/src/tool-calling/fetching-tools.mdxindex 2528c1047..ce0ea5db8 100644--- a/fern/pages/src/tool-calling/fetching-tools.mdx+++ b/fern/pages/src/tool-calling/fetching-tools.mdx@@ -94,58 +94,6 @@ const tools = await composio.tools.get(userId, {```</CodeGroup>-## Fetching versioned tools--Control which version of tools you fetch by specifying toolkit versions. This ensures consistent tool behavior across different environments.--<CodeGroup>-```python Python maxLines=60 wordWrap-# Fetch tools with specific versions-composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "github": "20250116_00",- "slack": "20250115_01"- }-)--tools = composio.tools.get(- user_id,- toolkits=["GITHUB", "SLACK"]-)--# Inspect tool version-for tool in tools:- print(f"Tool: {tool.slug}")- print(f"Version: {tool.toolkit_version}")-```--```typescript TypeScript maxLines=60 wordWrap-// Fetch tools with specific versions-const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- github: "20250116_00",- slack: "20250115_01"- }-});--const tools = await composio.tools.get(userId, {- toolkits: ["GITHUB", "SLACK"]-});--// Inspect tool version-tools.forEach(tool => {- console.log(`Tool: ${tool.slug}`);- console.log(`Version: ${tool.toolkitVersion}`);-});-```-</CodeGroup>--<Note>-Tools fetched with specific versions will maintain consistent schemas and behavior. Learn more about [toolkit versioning](/tool-calling/toolkit-versioning).-</Note>-## Filtering by toolYou may specify the list of tools to fetch by directly providing the tool names. Browse the list of tools [here](/tools) to view and inspect the tools for each toolkit.diff --git a/fern/pages/src/tool-calling/toolkit-versioning.mdx b/fern/pages/src/tool-calling/toolkit-versioning.mdxdeleted file mode 100644index d7ee8ed5d..000000000--- a/fern/pages/src/tool-calling/toolkit-versioning.mdx+++ /dev/null@@ -1,304 +0,0 @@-----title: Toolkit versioning-image: "https://og.composio.dev/api/og?title=Toolkit%20versioning"-keywords: "toolkit versioning, tool version, version pinning, stable tools"-subtitle: "Pin specific tool versions for consistent, predictable behavior in production"-hide-nav-links: false------Toolkit versioning ensures your tools behave consistently across deployments. You can pin specific versions in production, test new releases in development, and roll back easily when needed.--## Quick start--Configure toolkit versions using one of three methods, listed in order of precedence:--### Method 1: SDK initialization (Recommended)--Set versions when initializing the SDK. This applies to all tool operations.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"- title="Python"- startLine={1}- endLine={16}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"- title="TypeScript"- startLine={1}- endLine={15}-/>-</CodeGroup>--### Method 2: Environment variables--Set toolkit versions through environment variables. Useful for deployment configurations.--```bash-# Set versions for specific toolkits-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"-export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"--# Or set one version for all toolkits-export COMPOSIO_TOOLKIT_VERSION="20250116_00"-```--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/environment-variables.py"- title="Python"- startLine={11}- endLine={18}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/environment-variables.ts"- title="TypeScript"- startLine={11}- endLine={18}-/>-</CodeGroup>--### Method 3: Per-execution override--Override versions for specific tool executions. Takes precedence over SDK and environment settings.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"- title="Python"- startLine={11}- endLine={21}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"- title="TypeScript"- startLine={11}- endLine={19}-/>-</CodeGroup>--## Version formats--### Version identifiers--Toolkit versions follow the format `YYYYMMDD_NN`:-- `YYYYMMDD`: Release date-- `NN`: Sequential release number for that day--```python-# Production: Use specific version-toolkit_versions = {- "github": "20250116_00" # Released January 16, 2025, first version-}--# Development: Use latest-toolkit_versions = {- "github": "latest" # Always use newest version-}-```--### Version resolution--Versions are resolved in this order:-1. **Per-execution version** (if specified)-2. **SDK initialization version** (if configured)-3. **Environment variable** for specific toolkit-4. **Global environment variable** (applies to all)-5. **Default**: `latest`--<Warning>-Never use `latest` in production. It can introduce breaking changes without warning.-</Warning>--## Configuration patterns--### Multi-environment setup--Manage different versions across development, staging, and production environments:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/multi-environment.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/multi-environment.ts"- title="TypeScript"-/>-</CodeGroup>--### CI/CD pipeline--```yaml-# .github/workflows/deploy.yml-env:- COMPOSIO_TOOLKIT_VERSION_GITHUB: "20250110_00"- COMPOSIO_TOOLKIT_VERSION_SLACK: "20250110_00"- COMPOSIO_TOOLKIT_VERSION_GMAIL: "20250109_00"-```--## Managing versions--### List available versions--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/list-versions.py"- title="Python"- startLine={5}- endLine={14}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/list-versions.ts"- title="TypeScript"- startLine={5}- endLine={14}-/>-</CodeGroup>--### Test new versions--Test updates in isolated environments before production deployment:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/test-new-version.py"- title="Python"- startLine={4}- endLine={29}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/test-new-version.ts"- title="TypeScript"- startLine={3}- endLine={40}-/>-</CodeGroup>--### Roll back versions--If issues arise, immediately revert to a previous stable version:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/rollback.py"- title="Python"- startLine={4}- endLine={22}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/rollback.ts"- title="TypeScript"- startLine={3}- endLine={22}-/>-</CodeGroup>--## Breaking changes--### Manual execution requires version--As of October 22, 2025, manual tool execution requires explicit version specification:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/breaking-changes.py"- title="Python"- startLine={21}- endLine={61}-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/breaking-changes.ts"- title="TypeScript"- startLine={20}- endLine={54}-/>-</CodeGroup>--<Warning>-The `dangerouslySkipVersionCheck` flag bypasses version validation. Use only during migration or debugging.-</Warning>--### Migration checklist--1. **Audit current usage**: Identify all `tools.execute()` calls-2. **Choose strategy**:- - Set toolkit versions in SDK initialization (recommended)- - Add version parameter to each execute call- - Use environment variables for deployment config-3. **Test in staging**: Verify tools work with pinned versions-4. **Deploy gradually**: Roll out to production incrementally-5. **Monitor errors**: Watch for version-related failures--## Best practices--### Version pinning strategy--```python-# Development: Latest for rapid iteration-dev_versions = {"github": "latest", "slack": "latest"}--# Staging: Test specific new versions-staging_versions = {"github": "20250116_00", "slack": "20250115_00"}--# Production: Pin stable versions-prod_versions = {"github": "20250110_00", "slack": "20250110_00"}-```--### Update workflow--1. **Development**: Test with `latest`-2. **Staging**: Pin specific version for testing-3. **Validation**: Run automated tests-4. **Production**: Deploy tested version-5. **Monitor**: Track errors and performance---## Reference--### SDK parameters--<CodeGroup>-```python Python-Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "toolkit_name": "version" # Dict[str, str]- }-)-```--```typescript TypeScript-new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- toolkitName: "version" // Record<string, string>- }-})-```-</CodeGroup>--### Environment variables--```bash-# Specific toolkit version-COMPOSIO_TOOLKIT_VERSION_[TOOLKIT_NAME]="version"--# Global version (all toolkits)-COMPOSIO_TOOLKIT_VERSION="version"--# Examples-COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"-COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"-COMPOSIO_TOOLKIT_VERSION="20250110_00"-```--### Error codes--| Error | Description | Solution |-|-------|-------------|----------|-| `TOOLKIT_VERSION_REQUIRED` | Manual execution without version | Specify toolkit_version parameter |-| `INVALID_TOOLKIT_VERSION` | Version format incorrect | Use YYYYMMDD_NN format |-| `VERSION_NOT_FOUND` | Specified version doesn't exist | Check available versions |-| `TOOLKIT_NOT_VERSIONED` | Toolkit doesn't support versioning | Contact support |diff --git a/fern/snippets/tool-calling/versioning/python/breaking-changes.py b/fern/snippets/tool-calling/versioning/python/breaking-changes.pydeleted file mode 100644index e3663ff06..000000000--- a/fern/snippets/tool-calling/versioning/python/breaking-changes.py+++ /dev/null@@ -1,66 +0,0 @@-from composio import Composio--composio = Composio(api_key="YOUR_API_KEY")--# β This will fail without version specification (after October 22, 2025)-try:- result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Bug report",- "body": "Issue description"- }- }- )-except Exception as e:- print(f"Error: {e}")- print("Manual execution requires toolkit version")--# β Solution 1: Specify version in execution-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Bug report",- "body": "Issue description"- },- "toolkit_version": "20250116_00"- }-)--# β Solution 2: Configure version at SDK level-composio_with_version = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={"github": "20250116_00"}-)--result = composio_with_version.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Bug report",- "body": "Issue description"- }- }-)--# β οΈ Emergency escape hatch (not recommended for production)-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Bug report",- "body": "Issue description"- },- "dangerously_skip_version_check": True- }-)\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/environment-variables.py b/fern/snippets/tool-calling/versioning/python/environment-variables.pydeleted file mode 100644index c1e8fef4b..000000000--- a/fern/snippets/tool-calling/versioning/python/environment-variables.py+++ /dev/null@@ -1,22 +0,0 @@-import os-from composio import Composio--# Set environment variables before running your application-# export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"-# export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"--# Or set a global version for all toolkits-# export COMPOSIO_TOOLKIT_VERSION="20250116_00"--# SDK automatically reads environment variables-composio = Composio(api_key="YOUR_API_KEY")--# Tools will use versions from environment variables-tools = composio.tools.get(- user_id="user-123",- toolkits=["github", "slack"]-)--# Check which versions are being used-for tool in tools:- print(f"Tool: {tool.slug}, Version: {tool.toolkit_version}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/list-versions.py b/fern/snippets/tool-calling/versioning/python/list-versions.pydeleted file mode 100644index f12107f18..000000000--- a/fern/snippets/tool-calling/versioning/python/list-versions.py+++ /dev/null@@ -1,30 +0,0 @@-from composio import Composio-from datetime import datetime--composio = Composio(api_key="YOUR_API_KEY")--# Get all available versions for a toolkit-versions = composio.tools.get_toolkit_versions("github")--# Display version information-for version in versions:- print(f"Version: {version['version']}")- print(f"Released: {version['created_at']}")- print(f"Status: {version['status']}")- print("-" * 40)--# Find the latest stable version-stable_versions = [v for v in versions if v['status'] == 'stable']-if stable_versions:- latest_stable = stable_versions[0]- print(f"Latest stable version: {latest_stable['version']}")--# Find versions released in the last 7 days-recent_versions = []-for version in versions:- release_date = datetime.fromisoformat(version['created_at'])- days_ago = (datetime.now() - release_date).days- if days_ago <= 7:- recent_versions.append(version)--print(f"Versions released in last 7 days: {len(recent_versions)}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/multi-environment.py b/fern/snippets/tool-calling/versioning/python/multi-environment.pydeleted file mode 100644index 4ce03126d..000000000--- a/fern/snippets/tool-calling/versioning/python/multi-environment.py+++ /dev/null@@ -1,33 +0,0 @@-import os-from composio import Composio--# Get current environment from environment variable-env = os.getenv("ENVIRONMENT", "development")--# Define version configurations for each environment-version_configs = {- "development": {- "github": "latest",- "slack": "latest",- "gmail": "latest"- },- "staging": {- "github": "20250116_00", # Test new GitHub version- "slack": "20250110_00", # Keep stable Slack version- "gmail": "20250110_00"- },- "production": {- "github": "20250110_00", # Stable, tested version- "slack": "20250110_00", # Stable, tested version- "gmail": "20250109_00" # Stable, tested version- }-}--# Initialize Composio with environment-specific versions-composio = Composio(- api_key=os.getenv("COMPOSIO_API_KEY"),- toolkit_versions=version_configs[env]-)--print(f"Environment: {env}")-print(f"Toolkit versions: {version_configs[env]}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/per-execution-override.py b/fern/snippets/tool-calling/versioning/python/per-execution-override.pydeleted file mode 100644index 740f94af6..000000000--- a/fern/snippets/tool-calling/versioning/python/per-execution-override.py+++ /dev/null@@ -1,33 +0,0 @@-from composio import Composio--composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "github": "20250110_00" # Default version- }-)--# Override version for a single execution-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Bug report",- "body": "Description here"- },- "toolkit_version": "20250115_00" # Override to different version- }-)--# This execution uses the SDK default version-result2 = composio.tools.execute(- "GITHUB_LIST_ISSUES",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo"- }- }-)\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/rollback.py b/fern/snippets/tool-calling/versioning/python/rollback.pydeleted file mode 100644index 6863f309d..000000000--- a/fern/snippets/tool-calling/versioning/python/rollback.py+++ /dev/null@@ -1,61 +0,0 @@-from composio import Composio-import os--# Rollback Strategy 1: Update SDK initialization-def rollback_via_sdk():- """Rollback to previous version by updating SDK configuration"""-- # Previous configuration (problematic)- # composio = Composio(- # api_key="YOUR_API_KEY",- # toolkit_versions={- # "github": "20250116_00" # New version causing issues- # }- # )-- # Rollback to stable version- composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "github": "20250110_00" # Previous stable version- }- )-- print("Rolled back GitHub toolkit to version 20250110_00")- return composio--# Rollback Strategy 2: Update environment variables-def rollback_via_env():- """Rollback by updating environment variables"""-- # Set the stable version- os.environ["COMPOSIO_TOOLKIT_VERSION_GITHUB"] = "20250110_00"-- # Initialize SDK (will use environment variable)- composio = Composio(api_key="YOUR_API_KEY")-- print("Rolled back via environment variable")- return composio--# Rollback Strategy 3: Emergency skip version check-def emergency_rollback():- """Emergency rollback when version system itself has issues"""-- composio = Composio(api_key="YOUR_API_KEY")-- # Skip version check temporarily (use with caution)- result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Critical fix",- "body": "Emergency deployment"- },- "dangerously_skip_version_check": True- }- )-- print("β οΈ Executed with version check skipped - fix version config ASAP")- return result\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py b/fern/snippets/tool-calling/versioning/python/sdk-initialization.pydeleted file mode 100644index 18da3471d..000000000--- a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py+++ /dev/null@@ -1,31 +0,0 @@-from composio import Composio--# Initialize SDK with specific toolkit versions-composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "github": "20250116_00",- "slack": "20250115_01",- "gmail": "latest" # Use latest version for development- }-)--# Fetch tools - they will use the specified versions-tools = composio.tools.get(- user_id="user-123",- toolkits=["github", "slack"]-)--# Execute a tool - inherits version from SDK initialization-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "owner": "my-org",- "title": "Bug report",- "body": "Issue description"- }- }-)\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/test-new-version.py b/fern/snippets/tool-calling/versioning/python/test-new-version.pydeleted file mode 100644index 64413294d..000000000--- a/fern/snippets/tool-calling/versioning/python/test-new-version.py+++ /dev/null@@ -1,84 +0,0 @@-from composio import Composio-import pytest--def test_new_github_version():- """Test a new GitHub toolkit version before production deployment"""-- # Initialize with new version to test- test_composio = Composio(- api_key="YOUR_TEST_KEY",- toolkit_versions={"github": "20250116_00"}- )-- # Test basic tool execution- result = test_composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "test-user",- "arguments": {- "repo": "test-repo",- "owner": "test-org",- "title": "Test issue",- "body": "Testing new version"- }- }- )-- assert result["successful"] == True- assert "issue_number" in result["data"]-- # Test tool fetching- tools = test_composio.tools.get(- user_id="test-user",- toolkits=["github"]- )-- assert len(tools) > 0- assert all(tool.toolkit == "github" for tool in tools)-- print("β New version tests passed")- return True--def test_version_compatibility():- """Ensure new version maintains backward compatibility"""-- old_version = "20250110_00"- new_version = "20250116_00"-- # Initialize with old version- old_composio = Composio(- api_key="YOUR_TEST_KEY",- toolkit_versions={"github": old_version}- )-- # Initialize with new version- new_composio = Composio(- api_key="YOUR_TEST_KEY",- toolkit_versions={"github": new_version}- )-- # Get tools from both versions- old_tools = old_composio.tools.get(- user_id="test-user",- toolkits=["github"]- )-- new_tools = new_composio.tools.get(- user_id="test-user",- toolkits=["github"]- )-- # Check that essential tools still exist- old_tool_slugs = {tool.slug for tool in old_tools}- new_tool_slugs = {tool.slug for tool in new_tools}-- essential_tools = [- "GITHUB_CREATE_ISSUE",- "GITHUB_CREATE_PULL_REQUEST",- "GITHUB_LIST_ISSUES"- ]-- for tool in essential_tools:- assert tool in new_tool_slugs, f"Essential tool {tool} missing in new version"-- print("β Backward compatibility verified")\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/breaking-changes.ts b/fern/snippets/tool-calling/versioning/typescript/breaking-changes.tsdeleted file mode 100644index 39139d895..000000000--- a/fern/snippets/tool-calling/versioning/typescript/breaking-changes.ts+++ /dev/null@@ -1,59 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "YOUR_API_KEY" });--// β This will fail without version specification (after October 22, 2025)-try {- const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Bug report",- body: "Issue description"- }- });-} catch (error) {- console.error("Error:", error);- console.log("Manual execution requires toolkit version");-}--// β Solution 1: Specify version in execution-const result1 = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Bug report",- body: "Issue description"- },- toolkitVersion: "20250116_00"-});--// β Solution 2: Configure version at SDK level-const composioWithVersion = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: { github: "20250116_00" }-});--const result2 = await composioWithVersion.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Bug report",- body: "Issue description"- }-});--// β οΈ Emergency escape hatch (not recommended for production)-const result3 = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Bug report",- body: "Issue description"- },- dangerouslySkipVersionCheck: true-});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/environment-variables.ts b/fern/snippets/tool-calling/versioning/typescript/environment-variables.tsdeleted file mode 100644index 4bd682004..000000000--- a/fern/snippets/tool-calling/versioning/typescript/environment-variables.ts+++ /dev/null@@ -1,23 +0,0 @@-import { Composio } from "@composio/core";--// Set environment variables before running your application-// export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"-// export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"--// Or set a global version for all toolkits-// export COMPOSIO_TOOLKIT_VERSION="20250116_00"--// SDK automatically reads environment variables-const composio = new Composio({- apiKey: "YOUR_API_KEY"-});--// Tools will use versions from environment variables-const tools = await composio.tools.get("user-123", {- toolkits: ["github", "slack"]-});--// Check which versions are being used-tools.forEach(tool => {- console.log(`Tool: ${tool.slug}, Version: ${tool.toolkitVersion}`);-});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/list-versions.ts b/fern/snippets/tool-calling/versioning/typescript/list-versions.tsdeleted file mode 100644index 560a0e08e..000000000--- a/fern/snippets/tool-calling/versioning/typescript/list-versions.ts+++ /dev/null@@ -1,30 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "YOUR_API_KEY" });--// Get all available versions for a toolkit-const versions = await composio.tools.getToolkitVersions("github");--// Display version information-versions.forEach(version => {- console.log(`Version: ${version.version}`);- console.log(`Released: ${version.createdAt}`);- console.log(`Status: ${version.status}`);- console.log("-".repeat(40));-});--// Find the latest stable version-const stableVersions = versions.filter(v => v.status === 'stable');-if (stableVersions.length > 0) {- const latestStable = stableVersions[0];- console.log(`Latest stable version: ${latestStable.version}`);-}--// Find versions released in the last 7 days-const recentVersions = versions.filter(version => {- const releaseDate = new Date(version.createdAt);- const daysAgo = Math.floor((Date.now() - releaseDate.getTime()) / (1000 * 60 * 60 * 24));- return daysAgo <= 7;-});--console.log(`Versions released in last 7 days: ${recentVersions.length}`);\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/multi-environment.ts b/fern/snippets/tool-calling/versioning/typescript/multi-environment.tsdeleted file mode 100644index b63ae5249..000000000--- a/fern/snippets/tool-calling/versioning/typescript/multi-environment.ts+++ /dev/null@@ -1,32 +0,0 @@-import { Composio } from "@composio/core";--// Get current environment from environment variable-const env = process.env.ENVIRONMENT || "development";--// Define version configurations for each environment-const versionConfigs = {- development: {- github: "latest",- slack: "latest",- gmail: "latest"- },- staging: {- github: "20250116_00", // Test new GitHub version- slack: "20250110_00", // Keep stable Slack version- gmail: "20250110_00"- },- production: {- github: "20250110_00", // Stable, tested version- slack: "20250110_00", // Stable, tested version- gmail: "20250109_00" // Stable, tested version- }-};--// Initialize Composio with environment-specific versions-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY!,- toolkitVersions: versionConfigs[env as keyof typeof versionConfigs]-});--console.log(`Environment: ${env}`);-console.log(`Toolkit versions:`, versionConfigs[env as keyof typeof versionConfigs]);\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts b/fern/snippets/tool-calling/versioning/typescript/per-execution-override.tsdeleted file mode 100644index 5efcb828e..000000000--- a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts+++ /dev/null@@ -1,29 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- github: "20250110_00" // Default version- }-});--// Override version for a single execution-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Bug report",- body: "Description here"- },- toolkitVersion: "20250115_00" // Override to different version-});--// This execution uses the SDK default version-const result2 = await composio.tools.execute({- toolSlug: "GITHUB_LIST_ISSUES",- userId: "user-123",- arguments: {- repo: "my-repo"- }-});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/rollback.ts b/fern/snippets/tool-calling/versioning/typescript/rollback.tsdeleted file mode 100644index d2eb90c05..000000000--- a/fern/snippets/tool-calling/versioning/typescript/rollback.ts+++ /dev/null@@ -1,59 +0,0 @@-import { Composio } from "@composio/core";--// Rollback Strategy 1: Update SDK initialization-async function rollbackViaSdk(): Promise<Composio> {- // Previous configuration (problematic)- // const composio = new Composio({- // apiKey: "YOUR_API_KEY",- // toolkitVersions: {- // github: "20250116_00" // New version causing issues- // }- // });-- // Rollback to stable version- const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- github: "20250110_00" // Previous stable version- }- });-- console.log("Rolled back GitHub toolkit to version 20250110_00");- return composio;-}--// Rollback Strategy 2: Update environment variables-async function rollbackViaEnv(): Promise<Composio> {- // Set the stable version- process.env.COMPOSIO_TOOLKIT_VERSION_GITHUB = "20250110_00";-- // Initialize SDK (will use environment variable)- const composio = new Composio({- apiKey: "YOUR_API_KEY"- });-- console.log("Rolled back via environment variable");- return composio;-}--// Rollback Strategy 3: Emergency skip version check-async function emergencyRollback(): Promise<any> {- const composio = new Composio({- apiKey: "YOUR_API_KEY"- });-- // Skip version check temporarily (use with caution)- const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Critical fix",- body: "Emergency deployment"- },- dangerouslySkipVersionCheck: true- });-- console.log("β οΈ Executed with version check skipped - fix version config ASAP");- return result;-}\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts b/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.tsdeleted file mode 100644index e9466848b..000000000--- a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts+++ /dev/null@@ -1,28 +0,0 @@-import { Composio } from "@composio/core";--// Initialize SDK with specific toolkit versions-const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- github: "20250116_00",- slack: "20250115_01",- gmail: "latest" // Use latest version for development- }-});--// Fetch tools - they will use the specified versions-const tools = await composio.tools.get("user-123", {- toolkits: ["github", "slack"]-});--// Execute a tool - inherits version from SDK initialization-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- owner: "my-org",- title: "Bug report",- body: "Issue description"- }-});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/test-new-version.ts b/fern/snippets/tool-calling/versioning/typescript/test-new-version.tsdeleted file mode 100644index 1862b7f45..000000000--- a/fern/snippets/tool-calling/versioning/typescript/test-new-version.ts+++ /dev/null@@ -1,89 +0,0 @@-import { Composio } from "@composio/core";--async function testNewGithubVersion(): Promise<boolean> {- // Initialize with new version to test- const testComposio = new Composio({- apiKey: "YOUR_TEST_KEY",- toolkitVersions: { github: "20250116_00" }- });-- // Test basic tool execution- const result = await testComposio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "test-user",- arguments: {- repo: "test-repo",- owner: "test-org",- title: "Test issue",- body: "Testing new version"- }- });-- if (!result.successful) {- throw new Error("Tool execution failed");- }-- if (!result.data.issue_number) {- throw new Error("Missing expected data in response");- }-- // Test tool fetching- const tools = await testComposio.tools.get("test-user", {- toolkits: ["github"]- });-- if (tools.length === 0) {- throw new Error("No tools returned");- }-- if (!tools.every(tool => tool.toolkit === "github")) {- throw new Error("Unexpected toolkit in results");- }-- console.log("β New version tests passed");- return true;-}--async function testVersionCompatibility(): Promise<void> {- const oldVersion = "20250110_00";- const newVersion = "20250116_00";-- // Initialize with old version- const oldComposio = new Composio({- apiKey: "YOUR_TEST_KEY",- toolkitVersions: { github: oldVersion }- });-- // Initialize with new version- const newComposio = new Composio({- apiKey: "YOUR_TEST_KEY",- toolkitVersions: { github: newVersion }- });-- // Get tools from both versions- const oldTools = await oldComposio.tools.get("test-user", {- toolkits: ["github"]- });-- const newTools = await newComposio.tools.get("test-user", {- toolkits: ["github"]- });-- // Check that essential tools still exist- const oldToolSlugs = new Set(oldTools.map(tool => tool.slug));- const newToolSlugs = new Set(newTools.map(tool => tool.slug));-- const essentialTools = [- "GITHUB_CREATE_ISSUE",- "GITHUB_CREATE_PULL_REQUEST",- "GITHUB_LIST_ISSUES"- ];-- for (const tool of essentialTools) {- if (!newToolSlugs.has(tool)) {- throw new Error(`Essential tool ${tool} missing in new version`);- }- }-- console.log("β Backward compatibility verified");-}\ No newline at end of file