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

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",