@devries-cameron20 / composio-1 / commits / 4ca3a4545
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.

Versioning docs fixes

Sushmithamallesh committed Oct 30, 2025 at 15:46 UTC 4ca3a4545607e9d3e0915847ea3096e1169954f5
14 files changed +84 -140
fern/pages/src/migration-guide/index.mdx
+2 -4
@@ -6,19 +6,17 @@ keywords: "migration, upgrade, sdk, versioning"
6 hide-nav-links: false
7 ---
8
9 -Find the appropriate migration guide for your use case:
10 -
9 ## Available migration guides
10
11 <AccordionGroup>
12 <Accordion title="New SDK migration">
15 - Migrate from the old Composio SDK to the new next-generation SDK, including breaking changes, new features, and updated APIs.
13 + Migrate from the old Composio SDK to the new new SDK, including breaking changes, new features, and updated APIs.
14
15 [View SDK migration guide →](/resources/migration-guide/new-sdk)
16 </Accordion>
17
18 <Accordion title="Toolkit versioning migration">
21 - Migrate to the new toolkit versioning system introduced on October 22, 2025.
19 + Migrate to use the toolkit versioning system.
20
21 [View versioning migration guide →](/resources/migration-guide/toolkit-versioning)
22 </Accordion>
fern/pages/src/migration-guide/new-sdk.mdx
+2 -2
@@ -1,8 +1,8 @@
1 ---
2 -title: New SDK migration
2 +title: Our next generation SDKs
3 subtitle: Learn more about Composio's next generation SDKs and how to migrate
4 image: "https://og.composio.dev/api/og?title=New%20SDK%20migration"
5 -keywords: 'sdk, migration, next generation, upgrade'
5 +keywords: 'sdk, migration, upgrade'
6 hide-nav-links: false
7 ---
8
fern/pages/src/migration-guide/toolkit-versioning.mdx
+9 -28
@@ -2,7 +2,7 @@
2 title: Toolkit versioning migration
3 subtitle: Migrate to the new toolkit versioning system
4 image: "https://og.composio.dev/api/og?title=Toolkit%20versioning%20migration"
5 -keywords: "toolkit versioning, migration, breaking changes"
5 +keywords: "toolkit versioning, migration"
6 hide-nav-links: false
7 ---
8
@@ -41,11 +41,11 @@ Choose one of three migration strategies:
41
42 <CodeGroup>
43 <SnippetCode
44 - src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
44 + src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
45 title="Python"
46 />
47 <SnippetCode
48 - src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
48 + src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
49 title="TypeScript"
50 />
51 </CodeGroup>
@@ -54,14 +54,14 @@ Choose one of three migration strategies:
54
55 <CodeGroup>
56 <SnippetCode
57 - src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
58 - startLine={5}
59 - endLine={16}
57 + src="fern/snippets/tool-calling/python/versioning-per-execution.py"
58 + startLine={6}
59 + endLine={15}
60 title="Python"
61 />
62 <SnippetCode
63 - src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
64 - startLine={5}
63 + src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
64 + startLine={6}
65 endLine={14}
66 title="TypeScript"
67 />
@@ -70,28 +70,9 @@ Choose one of three migration strategies:
70 #### Option 3: Use environment variables
71
72 ```bash
73 -export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
73 +export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
74 ```
75
76 -Then execute normally:
77 -
78 -<CodeGroup>
79 -```python Python
80 -result = composio.tools.execute(
81 - "GITHUB_CREATE_ISSUE",
82 - {"user_id": "user-123", "arguments": {...}}
83 -)
84 -```
85 -
86 -```typescript TypeScript
87 -const result = await composio.tools.execute({
88 - toolSlug: "GITHUB_CREATE_ISSUE",
89 - userId: "user-123",
90 - arguments: {...}
91 -});
92 -```
93 -</CodeGroup>
94 -
76 ## Migration checklist
77
78 1. **Audit your code**: Find all `tools.execute()` calls in your codebase
fern/pages/src/tool-calling/toolkit-versioning.mdx
+13 -34
@@ -20,11 +20,11 @@ Configure toolkit versions using one of three methods:
20
21 <CodeGroup>
22 <SnippetCode
23 - src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
23 + src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
24 title="Python"
25 />
26 <SnippetCode
27 - src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
27 + src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
28 title="TypeScript"
29 />
30 </CodeGroup>
@@ -33,20 +33,20 @@ Configure toolkit versions using one of three methods:
33
34 ```bash
35 # Set versions for specific toolkits
36 -export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
37 -export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
38 -export COMPOSIO_TOOLKIT_VERSION_GMAIL="20250115_00"
36 +export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
37 +export COMPOSIO_TOOLKIT_VERSION_SLACK="20251027_00"
38 +export COMPOSIO_TOOLKIT_VERSION_GMAIL="20251027_00"
39 ```
40
41 ### Per-execution override
42
43 <CodeGroup>
44 <SnippetCode
45 - src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
45 + src="fern/snippets/tool-calling/python/versioning-per-execution.py"
46 title="Python"
47 />
48 <SnippetCode
49 - src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
49 + src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
50 title="TypeScript"
51 />
52 </CodeGroup>
@@ -59,7 +59,7 @@ Versions follow the format `YYYYMMDD_NN`:
59
60 ```python
61 # Production
62 -toolkit_versions = {"github": "20250116_00"}
62 +toolkit_versions = {"github": "20251027_00"}
63
64 # Development
65 toolkit_versions = {"github": "latest"}
@@ -77,42 +77,21 @@ Never use `latest` in production. It can introduce breaking changes.
77
78 ## Managing versions
79
80 -### List available versions
81 -
82 -Check what versions are available for a toolkit:
80 +Check available versions and inspect what your tools are using:
81
82 <CodeGroup>
83 <SnippetCode
86 - src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
87 - startLine={8}
84 + src="fern/snippets/tool-calling/python/versioning-manage.py"
85 + startLine={5}
86 endLine={11}
87 title="Python"
88 />
89 <SnippetCode
92 - src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
93 - startLine={8}
90 + src="fern/snippets/tool-calling/typescript/versioning-manage.ts"
91 + startLine={5}
92 endLine={12}
93 title="TypeScript"
94 />
95 </CodeGroup>
96
99 -### Inspect current versions
100 -
101 -Check which version your tools are actually using:
102 -
103 -<CodeGroup>
104 -<SnippetCode
105 - src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
106 - startLine={13}
107 - endLine={16}
108 - title="Python"
109 -/>
110 -<SnippetCode
111 - src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
112 - startLine={14}
113 - endLine={20}
114 - title="TypeScript"
115 -/>
116 -</CodeGroup>
117 -
97
fern/snippets/tool-calling/python/versioning-manage.py new
+11
@@ -0,0 +1,11 @@
1 +from composio import Composio
2 +
3 +composio = Composio(api_key="YOUR_API_KEY")
4 +
5 +# Get toolkit information including available versions
6 +toolkit = composio.toolkits.get(slug="github")
7 +
8 +# Extract and print version information
9 +print(f"Toolkit: {toolkit.name}")
10 +print(f"Current Version: {toolkit.meta.version}")
11 +print(f"Available Versions: {toolkit.meta.available_versions}")
\ No newline at end of file
fern/snippets/tool-calling/python/versioning-per-execution.py new
+15
@@ -0,0 +1,15 @@
1 +from composio import Composio
2 +
3 +composio = Composio(api_key="YOUR_API_KEY")
4 +
5 +# Specify version directly in execute call
6 +result = composio.tools.execute(
7 + "GITHUB_LIST_STARGAZERS",
8 + arguments={
9 + "owner": "ComposioHQ",
10 + "repo": "composio"
11 + },
12 + user_id="user-k7334",
13 + version="20251027_00" # Override version for this execution
14 +)
15 +print(result)
\ No newline at end of file
fern/snippets/tool-calling/python/versioning-sdk-init.py renamed
+3 -3
@@ -4,8 +4,8 @@ from composio import Composio
4 composio = Composio(
5 api_key="YOUR_API_KEY",
6 toolkit_versions={
7 - "github": "20250116_00",
8 - "slack": "20250115_01",
9 - "gmail": "20250115_00"
7 + "github": "20251027_00",
8 + "slack": "20251027_00",
9 + "gmail": "20251027_00"
10 }
11 )
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-manage.ts new
+12
@@ -0,0 +1,12 @@
1 +import { Composio } from "@composio/core";
2 +
3 +const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4 +
5 +// Get toolkit information including available versions
6 +const toolkit = await composio.toolkits.get("github");
7 +
8 +// Extract and print version information
9 +console.log("Toolkit:", toolkit.name);
10 +console.log("Current Version:", toolkit.meta.version);
11 +console.log("Available Versions:", toolkit.meta.availableVersions);
12 +console.log("Latest Version:", toolkit.meta.availableVersions[0]); // First one is usually the latest
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-per-execution.ts new
+14
@@ -0,0 +1,14 @@
1 +import { Composio } from "@composio/core";
2 +
3 +const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4 +
5 +// Specify version directly in execute call
6 +const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {
7 + userId: "user-k7334",
8 + arguments: {
9 + owner: "ComposioHQ",
10 + repo: "composio"
11 + },
12 + version: "20251027_00" // Override version for this execution
13 +});
14 +console.log(result);
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-sdk-init.ts renamed
+3 -3
@@ -4,8 +4,8 @@ import { Composio } from "@composio/core";
4 const composio = new Composio({
5 apiKey: "YOUR_API_KEY",
6 toolkitVersions: {
7 - github: "20250116_00",
8 - slack: "20250115_01",
9 - gmail: "20250115_00"
7 + github: "20251027_00",
8 + slack: "20251027_00",
9 + gmail: "20251027_00"
10 }
11 });
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/manage-versions.py deleted
-16
@@ -1,16 +0,0 @@
1 -from composio import Composio
2 -
3 -composio = Composio(
4 - api_key="YOUR_API_KEY",
5 - toolkit_versions={"github": "20250116_00"}
6 -)
7 -
8 -# List available versions for a toolkit
9 -versions = composio.tools.get_toolkit_versions("github")
10 -for version in versions[:3]:
11 - print(f"Version: {version['version']} - Status: {version['status']}")
12 -
13 -# Fetch tools and inspect their versions
14 -tools = composio.tools.get("user-123", toolkits=["github"])
15 -for tool in tools[:3]:
16 - print(f"{tool.slug}: v{tool.toolkit_version}")
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/per-execution-override.py deleted
-16
@@ -1,16 +0,0 @@
1 -from composio import Composio
2 -
3 -composio = Composio(api_key="YOUR_API_KEY")
4 -
5 -# Specify version directly in execute call
6 -result = composio.tools.execute(
7 - "GITHUB_CREATE_ISSUE",
8 - {
9 - "user_id": "user-123",
10 - "arguments": {
11 - "repo": "my-repo",
12 - "title": "Critical fix"
13 - },
14 - "toolkit_version": "20250116_00" # Version for this execution
15 - }
16 -)
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/manage-versions.ts deleted
-20
@@ -1,20 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -const composio = new Composio({
4 - apiKey: "YOUR_API_KEY",
5 - toolkitVersions: { github: "20250116_00" }
6 -});
7 -
8 -// List available versions for a toolkit
9 -const versions = await composio.tools.getToolkitVersions("github");
10 -versions.slice(0, 3).forEach(version => {
11 - console.log(`Version: ${version.version} - Status: ${version.status}`);
12 -});
13 -
14 -// Fetch tools and inspect their versions
15 -const tools = await composio.tools.get("user-123", {
16 - toolkits: ["github"]
17 -});
18 -tools.slice(0, 3).forEach(tool => {
19 - console.log(`${tool.slug}: v${tool.toolkitVersion}`);
20 -});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts deleted
-14
@@ -1,14 +0,0 @@
1 -import { Composio } from "@composio/core";
2 -
3 -const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4 -
5 -// Specify version directly in execute call
6 -const result = await composio.tools.execute({
7 - toolSlug: "GITHUB_CREATE_ISSUE",
8 - userId: "user-123",
9 - arguments: {
10 - repo: "my-repo",
11 - title: "Critical fix"
12 - },
13 - toolkitVersion: "20250116_00" // Version for this execution
14 -});
\ No newline at end of file