Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: update guides for SDK changes
jkomyno committed
Sep 30, 2026 at 09:17 UTC
029e7db2c0705e023b3c0a528e041eed031663b5
4 files changed
+24
-12
docs/bun.lock
+8
-8
@@ -48,14 +48,14 @@
48
"@ai-sdk/react": "^4.0.96",
49
"@anthropic-ai/claude-agent-sdk": "^0.3.263",
50
"@anthropic-ai/sdk": "^0.115.0",
51
- "@composio/anthropic": "^0.11.2",
51
+ "@composio/anthropic": "^0.11.3",
52
"@composio/claude-agent-sdk": "^0.12.1",
53
- "@composio/core": "^0.21.0",
54
- "@composio/google": "^0.11.1",
53
+ "@composio/core": "^0.22.0",
54
+ "@composio/google": "^0.12.0",
55
"@composio/langchain": "^0.11.1",
56
"@composio/llamaindex": "^0.11.1",
57
"@composio/mastra": "^0.10.5",
58
- "@composio/openai": "^0.12.3",
58
+ "@composio/openai": "^0.13.0",
59
"@composio/openai-agents": "^0.11.1",
60
"@composio/typesafe": "^0.1.1",
61
"@composio/vercel": "^0.12.1",
@@ -204,15 +204,15 @@
204
205
"@chevrotain/types": ["@chevrotain/types@11.1.2", "", {}, "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw=="],
206
207
- "@composio/anthropic": ["@composio/anthropic@0.11.2", "", { "peerDependencies": { "@anthropic-ai/sdk": "^0.110.0 || ^0.120.0 || ^0.124.0 || ^0.125.0", "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@mastra/mcp": "^1.13.1" } }, "sha512-IKQy0JpkFWRZ61Yn97JiFgWu1v51rLqISCZGrtdJYlhw8GG8LifQb0nK3mFjZ9X4pQdEtcBtgzlNOJm3pL3Uiw=="],
207
+ "@composio/anthropic": ["@composio/anthropic@0.11.3", "", { "peerDependencies": { "@anthropic-ai/sdk": "^0.110.0 || ^0.120.0 || ^0.124.0 || ^0.125.0 || ^0.127.0", "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@mastra/mcp": "^1.13.1" } }, "sha512-LcGxFzB0p4SEdnn0cueEXY3tQ6r8xIl2EeI/T7vxJf6rqjn3Ib9WNo7Srx2OpSgDFSqji4qakSU4eS355d65XQ=="],
208
209
"@composio/claude-agent-sdk": ["@composio/claude-agent-sdk@0.12.1", "", { "dependencies": { "zod": "^4.5.4" }, "peerDependencies": { "@anthropic-ai/claude-agent-sdk": "^0.3.199", "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0" } }, "sha512-lHKvycugdyXnliURfNovzT0xQVvMpo5ulHsHEYOSRU++KiI9vGQ6bFFcVi+GAkxJy9FEz8TGmt/JkZ/3gs2MXQ=="],
210
211
"@composio/client": ["@composio/client@2.0.0-rc.8", "", {}, "sha512-0C0Flmblx0Y3i6iGUY/MvST4aNXn3xEmPEA4wqZd3acm9x6u61/0i1LXCgBzFTTZEveK8YBFRu8Lpo/SMZwAFQ=="],
212
213
- "@composio/core": ["@composio/core@0.21.0", "", { "dependencies": { "@composio/client": "2.0.0-rc.8", "@composio/json-schema-to-zod": "0.3.3", "@types/json-schema": "^7.0.15", "is-fs-case-sensitive": "^2.0.0", "openai": "^7.15.0", "picocolors": "^1.1.1", "pusher-js": "^8.6.0", "semver": "^7.8.5", "undici": "^7.29.1", "zod-to-json-schema": "^3.25.2" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-fAgbqBdmYUbhIS/HWUtaUCG+QlPktyHXYbZwJ3xH7et5Pyw4YLQbw4UW+L7v4cQus8ijGgvjtmK7ZJL6tmWMmw=="],
213
+ "@composio/core": ["@composio/core@0.22.0", "", { "dependencies": { "@composio/client": "2.0.0-rc.8", "@composio/json-schema-to-zod": "0.3.3", "@types/json-schema": "^7.0.15", "is-fs-case-sensitive": "^2.0.0", "openai": "^7.21.0", "picocolors": "^1.1.1", "pusher-js": "^8.6.0", "semver": "^7.8.5", "undici": "^7.29.1", "zod-to-json-schema": "^3.25.2" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-Inc7/yqhRQTfvU3km/VwSpewwJ9O/5mnC2FjSPDp56MfEdUfx61rwoi6+pancTUhHsHic5qe0lB4C2rHd7iioA=="],
214
215
- "@composio/google": ["@composio/google@0.11.1", "", { "peerDependencies": { "@composio/core": ">=0.16.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-xNQ5wesTRUXWKxTYfjGRX/Wtdiqno9up4AV+nY0qzt0NHSp7ExRG/0fkgWYUkXp3XeWi8mOZd9spo4RfI4YUJQ=="],
215
+ "@composio/google": ["@composio/google@0.12.0", "", { "peerDependencies": { "@composio/core": ">=0.16.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-VYVd7F3Nu0b/bxZgQLMb2mR8A2bPNTSKBx3SqJtMOZsJ7Gayu7JE+ZmZtJq8fFXGUmGRoqpwoopwudNpq7GS+w=="],
216
217
"@composio/json-schema-to-zod": ["@composio/json-schema-to-zod@0.3.3", "", { "dependencies": { "@cfworker/json-schema": "^4.1.1", "dequal": "^2.0.3" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-QmgYo4IeK5/34Iqo1jSx6fSnLEyL++07FlW5Y6SfGFOhyb5htnY+vZPjs/tL8puJYhiEU7FV7kXdu5EAQoGrSA=="],
218
@@ -222,7 +222,7 @@
222
223
"@composio/mastra": ["@composio/mastra@0.10.5", "", { "dependencies": { "@mastra/schema-compat": "^1.3.10" }, "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@mastra/core": "^1.46.0", "zod": "^3.25 || ^4" } }, "sha512-ev8r52HXpO9eOO8m0zeIY6I7DboiYUaBxpbsCzuC9lBaFU9b1r0en2NOAPtBvsHMpVtFl2LaTlhu6gm1lCBe+g=="],
224
225
- "@composio/openai": ["@composio/openai@0.12.3", "", { "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "openai": "^6.49.0 || ^7.0.0" } }, "sha512-F8wVZtsS+hrkmVzw3OX8vhMIGy1zMyPk/EXl2O/JbmID1sqka7fuWNjaGOXVjc+HXJd+9sTkk2+kAECio/qXRw=="],
225
+ "@composio/openai": ["@composio/openai@0.13.0", "", { "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "openai": "^6.49.0 || ^7.0.0" } }, "sha512-uhKBeQ/r+ZIMUB+WPoXdqZdxFI4VeygS7wwSc6waOJceNb/aa0aFzgkHIe9HiiaPi3ie54G52wrCyfBoQgepQA=="],
226
227
"@composio/openai-agents": ["@composio/openai-agents@0.11.1", "", { "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@openai/agents": "^0.1.3 || ^0.17.0 || ^0.18.0", "zod": "^4.5.4" } }, "sha512-R1dO5WLTrbD5T7cG7lCSJpfqFH35yq+cwwjzZF9+VrAkijlVv84qmbsVBl00Mlz5AVRkTc5MBu0MypFlAa4ryw=="],
228
docs/content/docs/sandbox/remote.mdx
+4
@@ -121,6 +121,10 @@ The mount exposes four methods:
121
122
A `RemoteFile` carries the file's bytes and a presigned `downloadUrl`. Read it with `text()` or `buffer()`, or write it to disk with `save(path)`. Its `expiresAt` is when that download link expires, not a TTL on the file: the mount itself has no expiry you set.
123
124
+`save(path)` writes exactly where you point it and overwrites whatever is there. Call `save()` with no path and the file goes to `~/.composio/files/` under its name on the mount — and an existing file there survives: the new copy gets a number before its extension, so a second `report.pdf` saves as `report-1.pdf`. The returned path tells you which name was used.
125
+
126
+Mount paths come from the sandbox, so the SDK makes that default name safe to write before using it. Characters Windows reserves (`:`, `?`, `*`, and control characters) become `_`, over-long names are truncated with their extension kept, and trailing dots and spaces are dropped. Any name these rules changed also carries a short digest of the original, so `What is this?.png` and `What is this*.png` don't land on the same file.
127
+
128
A `RemoteFile` download through `buffer()`, `blob()`, `text()`, or `save()` stops at 100 MiB, even
129
when the server omits or misreports `Content-Length`. Connection failures and streamed-body failures
130
raise `RemoteFileDownloadError`.
docs/content/docs/tools-direct/executing-tools.mdx
+8
@@ -534,6 +534,14 @@ console.log(result);
534
</Tab>
535
</Tabs>
536
537
+Python names each downloaded file after the name in the tool response, made safe to write first:
538
+characters Windows reserves become `_`, an over-long name is truncated with its extension kept, and
539
+trailing dots and spaces are dropped. A name any of those rules changed also carries a short digest
540
+of the original, so two names that clean up the same way stay distinct. An existing file in the
541
+download directory is never replaced — the new download gets a number before its extension, so a
542
+second `report.pdf` lands as `report-1.pdf`. TypeScript names automatic downloads after the tool
543
+slug and a timestamp instead, so its names are already unique.
544
+
545
Automatic S3 downloads stop at 100 MiB, even when the server omits or reports an incorrect
546
`Content-Length`. Python removes partial files for transport and filesystem failures and raises
547
`ErrorDownloadingFile`; oversized responses raise `ResponseTooLargeError`. In TypeScript, failed
docs/package.json
+4
-4
@@ -80,14 +80,14 @@
80
"@ai-sdk/react": "^4.0.96",
81
"@anthropic-ai/claude-agent-sdk": "^0.3.263",
82
"@anthropic-ai/sdk": "^0.115.0",
83
- "@composio/anthropic": "^0.11.2",
83
+ "@composio/anthropic": "^0.11.3",
84
"@composio/claude-agent-sdk": "^0.12.1",
85
- "@composio/core": "^0.21.0",
86
- "@composio/google": "^0.11.1",
85
+ "@composio/core": "^0.22.0",
86
+ "@composio/google": "^0.12.0",
87
"@composio/langchain": "^0.11.1",
88
"@composio/llamaindex": "^0.11.1",
89
"@composio/mastra": "^0.10.5",
90
- "@composio/openai": "^0.12.3",
90
+ "@composio/openai": "^0.13.0",
91
"@composio/openai-agents": "^0.11.1",
92
"@composio/typesafe": "^0.1.1",
93
"@composio/vercel": "^0.12.1",