@devries-cameron20 / composio-1 / commits / fa505bdbb
Fork 0

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

Revert "versioning docs"

This reverts commit e5e9a7446ea96cfe9901d72ea659f87006565826.

Sushmithamallesh committed Oct 28, 2025 at 13:10 UTC fa505bdbb00133c0f18a05a6283a73f28878dbdd
20 files changed +3 -1225
fern/pages/src/migration-guide.mdx
+1 -88
@@ -205,93 +205,6 @@ To examine the raw schema definition of a tool for understanding input/output pa
205 />
206 </CodeGroup>
207
208 -### Toolkit versioning
209 -
210 -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.
211 -
212 -#### Version requirement for manual execution
213 -
214 -Manual tool execution now requires explicit version specification:
215 -
216 -<CodeGroup>
217 -```python Python
218 -# Will fail without version (breaking change)
219 -result = composio.tools.execute(
220 - "GITHUB_CREATE_ISSUE",
221 - {"user_id": "user-123", "arguments": {...}}
222 -)
223 -
224 -# Option 1: Configure version at SDK level
225 -composio = Composio(
226 - api_key="YOUR_API_KEY",
227 - toolkit_versions={"github": "20250116_00"}
228 -)
229 -
230 -# Option 2: Pass version with execution
231 -result = composio.tools.execute(
232 - "GITHUB_CREATE_ISSUE",
233 - {
234 - "user_id": "user-123",
235 - "arguments": {...},
236 - "toolkit_version": "20250116_00"
237 - }
238 -)
239 -
240 -# Option 3: Skip version check (not recommended)
241 -result = composio.tools.execute(
242 - "GITHUB_CREATE_ISSUE",
243 - {
244 - "user_id": "user-123",
245 - "arguments": {...},
246 - "dangerously_skip_version_check": True
247 - }
248 -)
249 -```
250 -
251 -```typescript TypeScript
252 -// Will fail without version (breaking change)
253 -const result = await composio.tools.execute({
254 - toolSlug: "GITHUB_CREATE_ISSUE",
255 - userId: "user-123",
256 - arguments: {...}
257 -});
258 -
259 -// Option 1: Configure version at SDK level
260 -const composio = new Composio({
261 - apiKey: "YOUR_API_KEY",
262 - toolkitVersions: { github: "20250116_00" }
263 -});
264 -
265 -// Option 2: Pass version with execution
266 -const result = await composio.tools.execute({
267 - toolSlug: "GITHUB_CREATE_ISSUE",
268 - userId: "user-123",
269 - arguments: {...},
270 - toolkitVersion: "20250116_00"
271 -});
272 -
273 -// Option 3: Skip version check (not recommended)
274 -const result = await composio.tools.execute({
275 - toolSlug: "GITHUB_CREATE_ISSUE",
276 - userId: "user-123",
277 - arguments: {...},
278 - dangerouslySkipVersionCheck: true
279 -});
280 -```
281 -</CodeGroup>
282 -
283 -#### Migration steps
284 -
285 -1. **Audit your code**: Find all `tools.execute()` calls
286 -2. **Choose a strategy**:
287 - - Set toolkit versions globally in SDK initialization (recommended)
288 - - Add version parameter to each execute call
289 - - Use environment variables for deployment configuration
290 -3. **Test thoroughly**: Verify tools work with pinned versions
291 -4. **Deploy gradually**: Roll out changes incrementally
292 -
293 -For complete documentation, see [Toolkit versioning](/tool-calling/toolkit-versioning).
294 -
208 ### Executing tools
209
210 Tool 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
586 />
587 </CodeGroup>
588
676 -## Coming Soon
589 +## 🚧 Coming Soon
590
591 ### Local tools
592
fern/pages/src/tool-calling/executing-tools.mdx
+2 -72
@@ -58,84 +58,14 @@ Composio provides support for frameworks like this by making sure the tools are
58
59 In case you just want to call a tool without using any framework or LLM provider, you can use the `execute` method directly.
60
61 -<Warning>
62 -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.
63 -</Warning>
64 -
61 <Tip icon="lightbulb">
62 **Finding tool arguments**: In the [Auth Configs
63 tab](https://platform.composio.dev?next_page=/auth-configs) → Select your toolkit → Tools &
64 Triggers → Select the tool to see its required and optional parameters, types, and descriptions.
65 </Tip>
70 -
66 <CodeGroup>
72 -```python Python
73 -# Method 1: Configure version at SDK level
74 -composio = Composio(
75 - api_key="YOUR_API_KEY",
76 - toolkit_versions={"github": "20250116_00"}
77 -)
78 -
79 -result = composio.tools.execute(
80 - "GITHUB_CREATE_ISSUE",
81 - {
82 - "user_id": "user-123",
83 - "arguments": {
84 - "repo": "composio",
85 - "owner": "composiohq",
86 - "title": "Bug Report",
87 - "body": "Issue description"
88 - }
89 - }
90 -)
91 -
92 -# Method 2: Pass version with execution
93 -result = composio.tools.execute(
94 - "GITHUB_CREATE_ISSUE",
95 - {
96 - "user_id": "user-123",
97 - "arguments": {
98 - "repo": "composio",
99 - "owner": "composiohq",
100 - "title": "Bug Report",
101 - "body": "Issue description"
102 - },
103 - "toolkit_version": "20250116_00"
104 - }
105 -)
106 -```
107 -
108 -```typescript TypeScript
109 -// Method 1: Configure version at SDK level
110 -const composio = new Composio({
111 - apiKey: "YOUR_API_KEY",
112 - toolkitVersions: { github: "20250116_00" }
113 -});
114 -
115 -const result = await composio.tools.execute({
116 - toolSlug: "GITHUB_CREATE_ISSUE",
117 - userId: "user-123",
118 - arguments: {
119 - repo: "composio",
120 - owner: "composiohq",
121 - title: "Bug Report",
122 - body: "Issue description"
123 - }
124 -});
125 -
126 -// Method 2: Pass version with execution
127 -const result = await composio.tools.execute({
128 - toolSlug: "GITHUB_CREATE_ISSUE",
129 - userId: "user-123",
130 - arguments: {
131 - repo: "composio",
132 - owner: "composiohq",
133 - title: "Bug Report",
134 - body: "Issue description"
135 - },
136 - toolkitVersion: "20250116_00"
137 -});
138 -```
67 + <SnippetCode src="fern/snippets/tool-calling/python/direct-tool-call.py" title="Python" />
68 + <SnippetCode src="fern/snippets/tool-calling/typescript/direct-tool-call.ts" title="TypeScript" />
69 </CodeGroup>
70
71 ### Proxy Execute -- Manually calling toolkit APIs
fern/pages/src/tool-calling/fetching-tools.mdx
-52
@@ -94,58 +94,6 @@ const tools = await composio.tools.get(userId, {
94 ```
95 </CodeGroup>
96
97 -## Fetching versioned tools
98 -
99 -Control which version of tools you fetch by specifying toolkit versions. This ensures consistent tool behavior across different environments.
100 -
101 -<CodeGroup>
102 -```python Python maxLines=60 wordWrap
103 -# Fetch tools with specific versions
104 -composio = Composio(
105 - api_key="YOUR_API_KEY",
106 - toolkit_versions={
107 - "github": "20250116_00",
108 - "slack": "20250115_01"
109 - }
110 -)
111 -
112 -tools = composio.tools.get(
113 - user_id,
114 - toolkits=["GITHUB", "SLACK"]
115 -)
116 -
117 -# Inspect tool version
118 -for tool in tools:
119 - print(f"Tool: {tool.slug}")
120 - print(f"Version: {tool.toolkit_version}")
121 -```
122 -
123 -```typescript TypeScript maxLines=60 wordWrap
124 -// Fetch tools with specific versions
125 -const composio = new Composio({
126 - apiKey: "YOUR_API_KEY",
127 - toolkitVersions: {
128 - github: "20250116_00",
129 - slack: "20250115_01"
130 - }
131 -});
132 -
133 -const tools = await composio.tools.get(userId, {
134 - toolkits: ["GITHUB", "SLACK"]
135 -});
136 -
137 -// Inspect tool version
138 -tools.forEach(tool => {
139 - console.log(`Tool: ${tool.slug}`);
140 - console.log(`Version: ${tool.toolkitVersion}`);
141 -});
142 -```
143 -</CodeGroup>
144 -
145 -<Note>
146 -Tools fetched with specific versions will maintain consistent schemas and behavior. Learn more about [toolkit versioning](/tool-calling/toolkit-versioning).
147 -</Note>
148 -
97 ## Filtering by tool
98 You 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.
99
fern/pages/src/tool-calling/toolkit-versioning.mdx deleted
-304
@@ -1,304 +0,0 @@
1 ----
2 -title: Toolkit versioning
3 -image: "https://og.composio.dev/api/og?title=Toolkit%20versioning"
4 -keywords: "toolkit versioning, tool version, version pinning, stable tools"
5 -subtitle: "Pin specific tool versions for consistent, predictable behavior in production"
6 -hide-nav-links: false
7 ----
8 -
9 -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.
10 -
11 -## Quick start
12 -
13 -Configure toolkit versions using one of three methods, listed in order of precedence:
14 -
15 -### Method 1: SDK initialization (Recommended)
16 -
17 -Set versions when initializing the SDK. This applies to all tool operations.
18 -
19 -<CodeGroup>
20 -<SnippetCode
21 - src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
22 - title="Python"
23 - startLine={1}
24 - endLine={16}
25 -/>
26 -<SnippetCode
27 - src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
28 - title="TypeScript"
29 - startLine={1}
30 - endLine={15}
31 -/>
32 -</CodeGroup>
33 -
34 -### Method 2: Environment variables
35 -
36 -Set toolkit versions through environment variables. Useful for deployment configurations.
37 -
38 -```bash
39 -# Set versions for specific toolkits
40 -export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
41 -export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
42 -
43 -# Or set one version for all toolkits
44 -export COMPOSIO_TOOLKIT_VERSION="20250116_00"
45 -```
46 -
47 -<CodeGroup>
48 -<SnippetCode
49 - src="fern/snippets/tool-calling/versioning/python/environment-variables.py"
50 - title="Python"
51 - startLine={11}
52 - endLine={18}
53 -/>
54 -<SnippetCode
55 - src="fern/snippets/tool-calling/versioning/typescript/environment-variables.ts"
56 - title="TypeScript"
57 - startLine={11}
58 - endLine={18}
59 -/>
60 -</CodeGroup>
61 -
62 -### Method 3: Per-execution override
63 -
64 -Override versions for specific tool executions. Takes precedence over SDK and environment settings.
65 -
66 -<CodeGroup>
67 -<SnippetCode
68 - src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
69 - title="Python"
70 - startLine={11}
71 - endLine={21}
72 -/>
73 -<SnippetCode
74 - src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
75 - title="TypeScript"
76 - startLine={11}
77 - endLine={19}
78 -/>
79 -</CodeGroup>
80 -
81 -## Version formats
82 -
83 -### Version identifiers
84 -
85 -Toolkit versions follow the format `YYYYMMDD_NN`:
86 -- `YYYYMMDD`: Release date
87 -- `NN`: Sequential release number for that day
88 -
89 -```python
90 -# Production: Use specific version
91 -toolkit_versions = {
92 - "github": "20250116_00" # Released January 16, 2025, first version
93 -}
94 -
95 -# Development: Use latest
96 -toolkit_versions = {
97 - "github": "latest" # Always use newest version
98 -}
99 -```
100 -
101 -### Version resolution
102 -
103 -Versions are resolved in this order:
104 -1. **Per-execution version** (if specified)
105 -2. **SDK initialization version** (if configured)
106 -3. **Environment variable** for specific toolkit
107 -4. **Global environment variable** (applies to all)
108 -5. **Default**: `latest`
109 -
110 -<Warning>
111 -Never use `latest` in production. It can introduce breaking changes without warning.
112 -</Warning>
113 -
114 -## Configuration patterns
115 -
116 -### Multi-environment setup
117 -
118 -Manage different versions across development, staging, and production environments:
119 -
120 -<CodeGroup>
121 -<SnippetCode
122 - src="fern/snippets/tool-calling/versioning/python/multi-environment.py"
123 - title="Python"
124 -/>
125 -<SnippetCode
126 - src="fern/snippets/tool-calling/versioning/typescript/multi-environment.ts"
127 - title="TypeScript"
128 -/>
129 -</CodeGroup>
130 -
131 -### CI/CD pipeline
132 -
133 -```yaml
134 -# .github/workflows/deploy.yml
135 -env:
136 - COMPOSIO_TOOLKIT_VERSION_GITHUB: "20250110_00"
137 - COMPOSIO_TOOLKIT_VERSION_SLACK: "20250110_00"
138 - COMPOSIO_TOOLKIT_VERSION_GMAIL: "20250109_00"
139 -```
140 -
141 -## Managing versions
142 -
143 -### List available versions
144 -
145 -<CodeGroup>
146 -<SnippetCode
147 - src="fern/snippets/tool-calling/versioning/python/list-versions.py"
148 - title="Python"
149 - startLine={5}
150 - endLine={14}
151 -/>
152 -<SnippetCode
153 - src="fern/snippets/tool-calling/versioning/typescript/list-versions.ts"
154 - title="TypeScript"
155 - startLine={5}
156 - endLine={14}
157 -/>
158 -</CodeGroup>
159 -
160 -### Test new versions
161 -
162 -Test updates in isolated environments before production deployment:
163 -
164 -<CodeGroup>
165 -<SnippetCode
166 - src="fern/snippets/tool-calling/versioning/python/test-new-version.py"
167 - title="Python"
168 - startLine={4}
169 - endLine={29}
170 -/>
171 -<SnippetCode
172 - src="fern/snippets/tool-calling/versioning/typescript/test-new-version.ts"
173 - title="TypeScript"
174 - startLine={3}
175 - endLine={40}
176 -/>
177 -</CodeGroup>
178 -
179 -### Roll back versions
180 -
181 -If issues arise, immediately revert to a previous stable version:
182 -
183 -<CodeGroup>
184 -<SnippetCode
185 - src="fern/snippets/tool-calling/versioning/python/rollback.py"
186 - title="Python"
187 - startLine={4}
188 - endLine={22}
189 -/>
190 -<SnippetCode
191 - src="fern/snippets/tool-calling/versioning/typescript/rollback.ts"
192 - title="TypeScript"
193 - startLine={3}
194 - endLine={22}
195 -/>
196 -</CodeGroup>
197 -
198 -## Breaking changes
199 -
200 -### Manual execution requires version
201 -
202 -As of October 22, 2025, manual tool execution requires explicit version specification:
203 -
204 -<CodeGroup>
205 -<SnippetCode
206 - src="fern/snippets/tool-calling/versioning/python/breaking-changes.py"
207 - title="Python"
208 - startLine={21}
209 - endLine={61}
210 -/>
211 -<SnippetCode
212 - src="fern/snippets/tool-calling/versioning/typescript/breaking-changes.ts"
213 - title="TypeScript"
214 - startLine={20}
215 - endLine={54}
216 -/>
217 -</CodeGroup>
218 -
219 -<Warning>
220 -The `dangerouslySkipVersionCheck` flag bypasses version validation. Use only during migration or debugging.
221 -</Warning>
222 -
223 -### Migration checklist
224 -
225 -1. **Audit current usage**: Identify all `tools.execute()` calls
226 -2. **Choose strategy**:
227 - - Set toolkit versions in SDK initialization (recommended)
228 - - Add version parameter to each execute call
229 - - Use environment variables for deployment config
230 -3. **Test in staging**: Verify tools work with pinned versions
231 -4. **Deploy gradually**: Roll out to production incrementally
232 -5. **Monitor errors**: Watch for version-related failures
233 -
234 -## Best practices
235 -
236 -### Version pinning strategy
237 -
238 -```python
239 -# Development: Latest for rapid iteration
240 -dev_versions = {"github": "latest", "slack": "latest"}
241 -
242 -# Staging: Test specific new versions
243 -staging_versions = {"github": "20250116_00", "slack": "20250115_00"}
244 -
245 -# Production: Pin stable versions
246 -prod_versions = {"github": "20250110_00", "slack": "20250110_00"}
247 -```
248 -
249 -### Update workflow
250 -
251 -1. **Development**: Test with `latest`
252 -2. **Staging**: Pin specific version for testing
253 -3. **Validation**: Run automated tests
254 -4. **Production**: Deploy tested version
255 -5. **Monitor**: Track errors and performance
256 -
257 -
258 -## Reference
259 -
260 -### SDK parameters
261 -
262 -<CodeGroup>
263 -```python Python
264 -Composio(
265 - api_key="YOUR_API_KEY",
266 - toolkit_versions={
267 - "toolkit_name": "version" # Dict[str, str]
268 - }
269 -)
270 -```
271 -
272 -```typescript TypeScript
273 -new Composio({
274 - apiKey: "YOUR_API_KEY",
275 - toolkitVersions: {
276 - toolkitName: "version" // Record<string, string>
277 - }
278 -})
279 -```
280 -</CodeGroup>
281 -
282 -### Environment variables
283 -
284 -```bash
285 -# Specific toolkit version
286 -COMPOSIO_TOOLKIT_VERSION_[TOOLKIT_NAME]="version"
287 -
288 -# Global version (all toolkits)
289 -COMPOSIO_TOOLKIT_VERSION="version"
290 -
291 -# Examples
292 -COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
293 -COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
294 -COMPOSIO_TOOLKIT_VERSION="20250110_00"
295 -```
296 -
297 -### Error codes
298 -
299 -| Error | Description | Solution |
300 -|-------|-------------|----------|
301 -| `TOOLKIT_VERSION_REQUIRED` | Manual execution without version | Specify toolkit_version parameter |
302 -| `INVALID_TOOLKIT_VERSION` | Version format incorrect | Use YYYYMMDD_NN format |
303 -| `VERSION_NOT_FOUND` | Specified version doesn't exist | Check available versions |
304 -| `TOOLKIT_NOT_VERSIONED` | Toolkit doesn't support versioning | Contact support |
fern/snippets/tool-calling/versioning/python/breaking-changes.py deleted
-66
@@ -1,66 +0,0 @@
1 -from composio import Composio
2 -
3 -composio = Composio(api_key="YOUR_API_KEY")
4 -
5 -# ❌ This will fail without version specification (after October 22, 2025)
6 -try:
7 - result = composio.tools.execute(
8 - "GITHUB_CREATE_ISSUE",
9 - {
10 - "user_id": "user-123",
11 - "arguments": {
12 - "repo": "my-repo",
13 - "title": "Bug report",
14 - "body": "Issue description"
15 - }
16 - }
17 - )
18 -except Exception as e:
19 - print(f"Error: {e}")
20 - print("Manual execution requires toolkit version")
21 -
22 -# ✅ Solution 1: Specify version in execution
23 -result = composio.tools.execute(
24 - "GITHUB_CREATE_ISSUE",
25 - {
26 - "user_id": "user-123",
27 - "arguments": {
28 - "repo": "my-repo",
29 - "title": "Bug report",
30 - "body": "Issue description"
31 - },
32 - "toolkit_version": "20250116_00"
33 - }
34 -)
35 -
36 -# ✅ Solution 2: Configure version at SDK level
37 -composio_with_version = Composio(
38 - api_key="YOUR_API_KEY",
39 - toolkit_versions={"github": "20250116_00"}
40 -)
41 -
42 -result = composio_with_version.tools.execute(
43 - "GITHUB_CREATE_ISSUE",
44 - {
45 - "user_id": "user-123",
46 - "arguments": {
47 - "repo": "my-repo",
48 - "title": "Bug report",
49 - "body": "Issue description"
50 - }
51 - }
52 -)
53 -
54 -# ⚠️ Emergency escape hatch (not recommended for production)
55 -result = composio.tools.execute(
56 - "GITHUB_CREATE_ISSUE",
57 - {
58 - "user_id": "user-123",
59 - "arguments": {
60 - "repo": "my-repo",
61 - "title": "Bug report",
62 - "body": "Issue description"
63 - },
64 - "dangerously_skip_version_check": True
65 - }
66 -)
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/environment-variables.py deleted
-22
@@ -1,22 +0,0 @@
1 -import os
2 -from composio import Composio
3 -
4 -# Set environment variables before running your application
5 -# export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
6 -# export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
7 -
8 -# Or set a global version for all toolkits
9 -# export COMPOSIO_TOOLKIT_VERSION="20250116_00"
10 -
11 -# SDK automatically reads environment variables
12 -composio = Composio(api_key="YOUR_API_KEY")
13 -
14 -# Tools will use versions from environment variables
15 -tools = composio.tools.get(
16 - user_id="user-123",
17 - toolkits=["github", "slack"]
18 -)
19 -
20 -# Check which versions are being used
21 -for tool in tools:
22 - print(f"Tool: {tool.slug}, Version: {tool.toolkit_version}")
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/list-versions.py deleted
-30
@@ -1,30 +0,0 @@
1 -from composio import Composio
2 -from datetime import datetime
3 -
4 -composio = Composio(api_key="YOUR_API_KEY")
5 -
6 -# Get all available versions for a toolkit
7 -versions = composio.tools.get_toolkit_versions("github")
8 -
9 -# Display version information
10 -for version in versions:
11 - print(f"Version: {version['version']}")
12 - print(f"Released: {version['created_at']}")
13 - print(f"Status: {version['status']}")
14 - print("-" * 40)
15 -
16 -# Find the latest stable version
17 -stable_versions = [v for v in versions if v['status'] == 'stable']
18 -if stable_versions:
19 - latest_stable = stable_versions[0]
20 - print(f"Latest stable version: {latest_stable['version']}")
21 -
22 -# Find versions released in the last 7 days
23 -recent_versions = []
24 -for version in versions:
25 - release_date = datetime.fromisoformat(version['created_at'])
26 - days_ago = (datetime.now() - release_date).days
27 - if days_ago <= 7:
28 - recent_versions.append(version)
29 -
30 -print(f"Versions released in last 7 days: {len(recent_versions)}")
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/multi-environment.py deleted
-33
@@ -1,33 +0,0 @@
1 -import os
2 -from composio import Composio
3 -
4 -# Get current environment from environment variable
5 -env = os.getenv("ENVIRONMENT", "development")
6 -
7 -# Define version configurations for each environment
8 -version_configs = {
9 - "development": {
10 - "github": "latest",
11 - "slack": "latest",
12 - "gmail": "latest"
13 - },
14 - "staging": {
15 - "github": "20250116_00", # Test new GitHub version
16 - "slack": "20250110_00", # Keep stable Slack version
17 - "gmail": "20250110_00"
18 - },
19 - "production": {
20 - "github": "20250110_00", # Stable, tested version
21 - "slack": "20250110_00", # Stable, tested version
22 - "gmail": "20250109_00" # Stable, tested version
23 - }
24 -}
25 -
26 -# Initialize Composio with environment-specific versions
27 -composio = Composio(
28 - api_key=os.getenv("COMPOSIO_API_KEY"),
29 - toolkit_versions=version_configs[env]
30 -)
31 -
32 -print(f"Environment: {env}")
33 -print(f"Toolkit versions: {version_configs[env]}")
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/per-execution-override.py deleted
-33
@@ -1,33 +0,0 @@
1 -from composio import Composio
2 -
3 -composio = Composio(
4 - api_key="YOUR_API_KEY",
5 - toolkit_versions={
6 - "github": "20250110_00" # Default version
7 - }
8 -)
9 -
10 -# Override version for a single execution
11 -result = composio.tools.execute(
12 - "GITHUB_CREATE_ISSUE",
13 - {
14 - "user_id": "user-123",
15 - "arguments": {
16 - "repo": "my-repo",
17 - "title": "Bug report",
18 - "body": "Description here"
19 - },
20 - "toolkit_version": "20250115_00" # Override to different version
21 - }
22 -)
23 -
24 -# This execution uses the SDK default version
25 -result2 = composio.tools.execute(
26 - "GITHUB_LIST_ISSUES",
27 - {
28 - "user_id": "user-123",
29 - "arguments": {
30 - "repo": "my-repo"
31 - }
32 - }
33 -)
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/rollback.py deleted
-61
@@ -1,61 +0,0 @@
1 -from composio import Composio
2 -import os
3 -
4 -# Rollback Strategy 1: Update SDK initialization
5 -def rollback_via_sdk():
6 - """Rollback to previous version by updating SDK configuration"""
7 -
8 - # Previous configuration (problematic)
9 - # composio = Composio(
10 - # api_key="YOUR_API_KEY",
11 - # toolkit_versions={
12 - # "github": "20250116_00" # New version causing issues
13 - # }
14 - # )
15 -
16 - # Rollback to stable version
17 - composio = Composio(
18 - api_key="YOUR_API_KEY",
19 - toolkit_versions={
20 - "github": "20250110_00" # Previous stable version
21 - }
22 - )
23 -
24 - print("Rolled back GitHub toolkit to version 20250110_00")
25 - return composio
26 -
27 -# Rollback Strategy 2: Update environment variables
28 -def rollback_via_env():
29 - """Rollback by updating environment variables"""
30 -
31 - # Set the stable version
32 - os.environ["COMPOSIO_TOOLKIT_VERSION_GITHUB"] = "20250110_00"
33 -
34 - # Initialize SDK (will use environment variable)
35 - composio = Composio(api_key="YOUR_API_KEY")
36 -
37 - print("Rolled back via environment variable")
38 - return composio
39 -
40 -# Rollback Strategy 3: Emergency skip version check
41 -def emergency_rollback():
42 - """Emergency rollback when version system itself has issues"""
43 -
44 - composio = Composio(api_key="YOUR_API_KEY")
45 -
46 - # Skip version check temporarily (use with caution)
47 - result = composio.tools.execute(
48 - "GITHUB_CREATE_ISSUE",
49 - {
50 - "user_id": "user-123",
51 - "arguments": {
52 - "repo": "my-repo",
53 - "title": "Critical fix",
54 - "body": "Emergency deployment"
55 - },
56 - "dangerously_skip_version_check": True
57 - }
58 - )
59 -
60 - print("⚠️ Executed with version check skipped - fix version config ASAP")
61 - return result
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/sdk-initialization.py deleted
-31
@@ -1,31 +0,0 @@
1 -from composio import Composio
2 -
3 -# Initialize SDK with specific toolkit versions
4 -composio = Composio(
5 - api_key="YOUR_API_KEY",
6 - toolkit_versions={
7 - "github": "20250116_00",
8 - "slack": "20250115_01",
9 - "gmail": "latest" # Use latest version for development
10 - }
11 -)
12 -
13 -# Fetch tools - they will use the specified versions
14 -tools = composio.tools.get(
15 - user_id="user-123",
16 - toolkits=["github", "slack"]
17 -)
18 -
19 -# Execute a tool - inherits version from SDK initialization
20 -result = composio.tools.execute(
21 - "GITHUB_CREATE_ISSUE",
22 - {
23 - "user_id": "user-123",
24 - "arguments": {
25 - "repo": "my-repo",
26 - "owner": "my-org",
27 - "title": "Bug report",
28 - "body": "Issue description"
29 - }
30 - }
31 -)
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/test-new-version.py deleted
-84
@@ -1,84 +0,0 @@
1 -from composio import Composio
2 -import pytest
3 -
4 -def test_new_github_version():
5 - """Test a new GitHub toolkit version before production deployment"""
6 -
7 - # Initialize with new version to test
8 - test_composio = Composio(
9 - api_key="YOUR_TEST_KEY",
10 - toolkit_versions={"github": "20250116_00"}
11 - )
12 -
13 - # Test basic tool execution
14 - result = test_composio.tools.execute(
15 - "GITHUB_CREATE_ISSUE",
16 - {
17 - "user_id": "test-user",
18 - "arguments": {
19 - "repo": "test-repo",
20 - "owner": "test-org",
21 - "title": "Test issue",
22 - "body": "Testing new version"
23 - }
24 - }
25 - )
26 -
27 - assert result["successful"] == True
28 - assert "issue_number" in result["data"]
29 -
30 - # Test tool fetching
31 - tools = test_composio.tools.get(
32 - user_id="test-user",
33 - toolkits=["github"]
34 - )
35 -
36 - assert len(tools) > 0
37 - assert all(tool.toolkit == "github" for tool in tools)
38 -
39 - print("✓ New version tests passed")
40 - return True
41 -
42 -def test_version_compatibility():
43 - """Ensure new version maintains backward compatibility"""
44 -
45 - old_version = "20250110_00"
46 - new_version = "20250116_00"
47 -
48 - # Initialize with old version
49 - old_composio = Composio(
50 - api_key="YOUR_TEST_KEY",
51 - toolkit_versions={"github": old_version}
52 - )
53 -
54 - # Initialize with new version
55 - new_composio = Composio(
56 - api_key="YOUR_TEST_KEY",
57 - toolkit_versions={"github": new_version}
58 - )
59 -
60 - # Get tools from both versions
61 - old_tools = old_composio.tools.get(
62 - user_id="test-user",
63 - toolkits=["github"]
64 - )
65 -
66 - new_tools = new_composio.tools.get(
67 - user_id="test-user",
68 - toolkits=["github"]
69 - )
70 -
71 - # Check that essential tools still exist
72 - old_tool_slugs = {tool.slug for tool in old_tools}
73 - new_tool_slugs = {tool.slug for tool in new_tools}
74 -
75 - essential_tools = [
76 - "GITHUB_CREATE_ISSUE",
77 - "GITHUB_CREATE_PULL_REQUEST",
78 - "GITHUB_LIST_ISSUES"
79 - ]
80 -
81 - for tool in essential_tools:
82 - assert tool in new_tool_slugs, f"Essential tool {tool} missing in new version"
83 -
84 - print("✓ Backward compatibility verified")
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/breaking-changes.ts deleted
-59
@@ -1,59 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4 -
5 -// ❌ This will fail without version specification (after October 22, 2025)
6 -try {
7 - const result = await composio.tools.execute({
8 - toolSlug: "GITHUB_CREATE_ISSUE",
9 - userId: "user-123",
10 - arguments: {
11 - repo: "my-repo",
12 - title: "Bug report",
13 - body: "Issue description"
14 - }
15 - });
16 -} catch (error) {
17 - console.error("Error:", error);
18 - console.log("Manual execution requires toolkit version");
19 -}
20 -
21 -// ✅ Solution 1: Specify version in execution
22 -const result1 = await composio.tools.execute({
23 - toolSlug: "GITHUB_CREATE_ISSUE",
24 - userId: "user-123",
25 - arguments: {
26 - repo: "my-repo",
27 - title: "Bug report",
28 - body: "Issue description"
29 - },
30 - toolkitVersion: "20250116_00"
31 -});
32 -
33 -// ✅ Solution 2: Configure version at SDK level
34 -const composioWithVersion = new Composio({
35 - apiKey: "YOUR_API_KEY",
36 - toolkitVersions: { github: "20250116_00" }
37 -});
38 -
39 -const result2 = await composioWithVersion.tools.execute({
40 - toolSlug: "GITHUB_CREATE_ISSUE",
41 - userId: "user-123",
42 - arguments: {
43 - repo: "my-repo",
44 - title: "Bug report",
45 - body: "Issue description"
46 - }
47 -});
48 -
49 -// ⚠️ Emergency escape hatch (not recommended for production)
50 -const result3 = await composio.tools.execute({
51 - toolSlug: "GITHUB_CREATE_ISSUE",
52 - userId: "user-123",
53 - arguments: {
54 - repo: "my-repo",
55 - title: "Bug report",
56 - body: "Issue description"
57 - },
58 - dangerouslySkipVersionCheck: true
59 -});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/environment-variables.ts deleted
-23
@@ -1,23 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -// Set environment variables before running your application
4 -// export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
5 -// export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
6 -
7 -// Or set a global version for all toolkits
8 -// export COMPOSIO_TOOLKIT_VERSION="20250116_00"
9 -
10 -// SDK automatically reads environment variables
11 -const composio = new Composio({
12 - apiKey: "YOUR_API_KEY"
13 -});
14 -
15 -// Tools will use versions from environment variables
16 -const tools = await composio.tools.get("user-123", {
17 - toolkits: ["github", "slack"]
18 -});
19 -
20 -// Check which versions are being used
21 -tools.forEach(tool => {
22 - console.log(`Tool: ${tool.slug}, Version: ${tool.toolkitVersion}`);
23 -});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/list-versions.ts deleted
-30
@@ -1,30 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4 -
5 -// Get all available versions for a toolkit
6 -const versions = await composio.tools.getToolkitVersions("github");
7 -
8 -// Display version information
9 -versions.forEach(version => {
10 - console.log(`Version: ${version.version}`);
11 - console.log(`Released: ${version.createdAt}`);
12 - console.log(`Status: ${version.status}`);
13 - console.log("-".repeat(40));
14 -});
15 -
16 -// Find the latest stable version
17 -const stableVersions = versions.filter(v => v.status === 'stable');
18 -if (stableVersions.length > 0) {
19 - const latestStable = stableVersions[0];
20 - console.log(`Latest stable version: ${latestStable.version}`);
21 -}
22 -
23 -// Find versions released in the last 7 days
24 -const recentVersions = versions.filter(version => {
25 - const releaseDate = new Date(version.createdAt);
26 - const daysAgo = Math.floor((Date.now() - releaseDate.getTime()) / (1000 * 60 * 60 * 24));
27 - return daysAgo <= 7;
28 -});
29 -
30 -console.log(`Versions released in last 7 days: ${recentVersions.length}`);
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/multi-environment.ts deleted
-32
@@ -1,32 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -// Get current environment from environment variable
4 -const env = process.env.ENVIRONMENT || "development";
5 -
6 -// Define version configurations for each environment
7 -const versionConfigs = {
8 - development: {
9 - github: "latest",
10 - slack: "latest",
11 - gmail: "latest"
12 - },
13 - staging: {
14 - github: "20250116_00", // Test new GitHub version
15 - slack: "20250110_00", // Keep stable Slack version
16 - gmail: "20250110_00"
17 - },
18 - production: {
19 - github: "20250110_00", // Stable, tested version
20 - slack: "20250110_00", // Stable, tested version
21 - gmail: "20250109_00" // Stable, tested version
22 - }
23 -};
24 -
25 -// Initialize Composio with environment-specific versions
26 -const composio = new Composio({
27 - apiKey: process.env.COMPOSIO_API_KEY!,
28 - toolkitVersions: versionConfigs[env as keyof typeof versionConfigs]
29 -});
30 -
31 -console.log(`Environment: ${env}`);
32 -console.log(`Toolkit versions:`, versionConfigs[env as keyof typeof versionConfigs]);
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts deleted
-29
@@ -1,29 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -const composio = new Composio({
4 - apiKey: "YOUR_API_KEY",
5 - toolkitVersions: {
6 - github: "20250110_00" // Default version
7 - }
8 -});
9 -
10 -// Override version for a single execution
11 -const result = await composio.tools.execute({
12 - toolSlug: "GITHUB_CREATE_ISSUE",
13 - userId: "user-123",
14 - arguments: {
15 - repo: "my-repo",
16 - title: "Bug report",
17 - body: "Description here"
18 - },
19 - toolkitVersion: "20250115_00" // Override to different version
20 -});
21 -
22 -// This execution uses the SDK default version
23 -const result2 = await composio.tools.execute({
24 - toolSlug: "GITHUB_LIST_ISSUES",
25 - userId: "user-123",
26 - arguments: {
27 - repo: "my-repo"
28 - }
29 -});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/rollback.ts deleted
-59
@@ -1,59 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -// Rollback Strategy 1: Update SDK initialization
4 -async function rollbackViaSdk(): Promise<Composio> {
5 - // Previous configuration (problematic)
6 - // const composio = new Composio({
7 - // apiKey: "YOUR_API_KEY",
8 - // toolkitVersions: {
9 - // github: "20250116_00" // New version causing issues
10 - // }
11 - // });
12 -
13 - // Rollback to stable version
14 - const composio = new Composio({
15 - apiKey: "YOUR_API_KEY",
16 - toolkitVersions: {
17 - github: "20250110_00" // Previous stable version
18 - }
19 - });
20 -
21 - console.log("Rolled back GitHub toolkit to version 20250110_00");
22 - return composio;
23 -}
24 -
25 -// Rollback Strategy 2: Update environment variables
26 -async function rollbackViaEnv(): Promise<Composio> {
27 - // Set the stable version
28 - process.env.COMPOSIO_TOOLKIT_VERSION_GITHUB = "20250110_00";
29 -
30 - // Initialize SDK (will use environment variable)
31 - const composio = new Composio({
32 - apiKey: "YOUR_API_KEY"
33 - });
34 -
35 - console.log("Rolled back via environment variable");
36 - return composio;
37 -}
38 -
39 -// Rollback Strategy 3: Emergency skip version check
40 -async function emergencyRollback(): Promise<any> {
41 - const composio = new Composio({
42 - apiKey: "YOUR_API_KEY"
43 - });
44 -
45 - // Skip version check temporarily (use with caution)
46 - const result = await composio.tools.execute({
47 - toolSlug: "GITHUB_CREATE_ISSUE",
48 - userId: "user-123",
49 - arguments: {
50 - repo: "my-repo",
51 - title: "Critical fix",
52 - body: "Emergency deployment"
53 - },
54 - dangerouslySkipVersionCheck: true
55 - });
56 -
57 - console.log("⚠️ Executed with version check skipped - fix version config ASAP");
58 - return result;
59 -}
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts deleted
-28
@@ -1,28 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -// Initialize SDK with specific toolkit versions
4 -const composio = new Composio({
5 - apiKey: "YOUR_API_KEY",
6 - toolkitVersions: {
7 - github: "20250116_00",
8 - slack: "20250115_01",
9 - gmail: "latest" // Use latest version for development
10 - }
11 -});
12 -
13 -// Fetch tools - they will use the specified versions
14 -const tools = await composio.tools.get("user-123", {
15 - toolkits: ["github", "slack"]
16 -});
17 -
18 -// Execute a tool - inherits version from SDK initialization
19 -const result = await composio.tools.execute({
20 - toolSlug: "GITHUB_CREATE_ISSUE",
21 - userId: "user-123",
22 - arguments: {
23 - repo: "my-repo",
24 - owner: "my-org",
25 - title: "Bug report",
26 - body: "Issue description"
27 - }
28 -});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/test-new-version.ts deleted
-89
@@ -1,89 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -async function testNewGithubVersion(): Promise<boolean> {
4 - // Initialize with new version to test
5 - const testComposio = new Composio({
6 - apiKey: "YOUR_TEST_KEY",
7 - toolkitVersions: { github: "20250116_00" }
8 - });
9 -
10 - // Test basic tool execution
11 - const result = await testComposio.tools.execute({
12 - toolSlug: "GITHUB_CREATE_ISSUE",
13 - userId: "test-user",
14 - arguments: {
15 - repo: "test-repo",
16 - owner: "test-org",
17 - title: "Test issue",
18 - body: "Testing new version"
19 - }
20 - });
21 -
22 - if (!result.successful) {
23 - throw new Error("Tool execution failed");
24 - }
25 -
26 - if (!result.data.issue_number) {
27 - throw new Error("Missing expected data in response");
28 - }
29 -
30 - // Test tool fetching
31 - const tools = await testComposio.tools.get("test-user", {
32 - toolkits: ["github"]
33 - });
34 -
35 - if (tools.length === 0) {
36 - throw new Error("No tools returned");
37 - }
38 -
39 - if (!tools.every(tool => tool.toolkit === "github")) {
40 - throw new Error("Unexpected toolkit in results");
41 - }
42 -
43 - console.log("✓ New version tests passed");
44 - return true;
45 -}
46 -
47 -async function testVersionCompatibility(): Promise<void> {
48 - const oldVersion = "20250110_00";
49 - const newVersion = "20250116_00";
50 -
51 - // Initialize with old version
52 - const oldComposio = new Composio({
53 - apiKey: "YOUR_TEST_KEY",
54 - toolkitVersions: { github: oldVersion }
55 - });
56 -
57 - // Initialize with new version
58 - const newComposio = new Composio({
59 - apiKey: "YOUR_TEST_KEY",
60 - toolkitVersions: { github: newVersion }
61 - });
62 -
63 - // Get tools from both versions
64 - const oldTools = await oldComposio.tools.get("test-user", {
65 - toolkits: ["github"]
66 - });
67 -
68 - const newTools = await newComposio.tools.get("test-user", {
69 - toolkits: ["github"]
70 - });
71 -
72 - // Check that essential tools still exist
73 - const oldToolSlugs = new Set(oldTools.map(tool => tool.slug));
74 - const newToolSlugs = new Set(newTools.map(tool => tool.slug));
75 -
76 - const essentialTools = [
77 - "GITHUB_CREATE_ISSUE",
78 - "GITHUB_CREATE_PULL_REQUEST",
79 - "GITHUB_LIST_ISSUES"
80 - ];
81 -
82 - for (const tool of essentialTools) {
83 - if (!newToolSlugs.has(tool)) {
84 - throw new Error(`Essential tool ${tool} missing in new version`);
85 - }
86 - }
87 -
88 - console.log("✓ Backward compatibility verified");
89 -}
\ No newline at end of file