@devries-cameron20 / composio Mirror · read-only / commits / 1fe2fe30c
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 14:45 UTC

docs: update guides for SDK changes (#4105)

## Summary Automated docs update triggered by SDK source changes on `next`. - Claude reviewed the SDK diff and updated guides, FAQs, or examples that reference changed APIs or features. - The docs `@composio/*` dependencies were realigned to their latest published releases so Twoslash snippets and example apps validate against versions users can actually install. ## Review checklist - [ ] Changes accurately reflect the new SDK behavior - [ ] No unrelated docs were modified - [ ] Code examples are correct and complete - [ ] If a documented feature is not published yet, the Twoslash build will fail — wait for the release instead of working around it Generated by Claude Code via GitHub Actions. --------- Co-authored-by: jkomyno <12381818+jkomyno@users.noreply.github.com> Co-authored-by: jkomyno <alberto@composio.dev>

sdkrelease[bot] committed Aug 26, 2026 at 00:23 UTC 1fe2fe30cc62944b3d05a02cbfcd6101a7840cbf
3 files changed +17 -8
docs/bun.lock
+4 -4
@@ -48,9 +48,9 @@
48 "@anthropic-ai/claude-agent-sdk": "^0.3.220",
49 "@anthropic-ai/sdk": "^0.115.0",
50 "@composio/anthropic": "^0.11.0",
51 - "@composio/claude-agent-sdk": "^0.10.1",
51 + "@composio/claude-agent-sdk": "^0.11.0",
52 "@composio/core": "^0.17.0",
53 - "@composio/google": "^0.10.1",
53 + "@composio/google": "^0.10.2",
54 "@composio/langchain": "^0.10.1",
55 "@composio/llamaindex": "^0.10.1",
56 "@composio/mastra": "^0.10.3",
@@ -201,13 +201,13 @@
201
202 "@composio/anthropic": ["@composio/anthropic@0.11.0", "", { "peerDependencies": { "@anthropic-ai/sdk": "^0.110.0", "@composio/core": ">=0.10.0 <1.0.0", "@mastra/mcp": "^1.13.1" } }, "sha512-TwlspsECetpbY81YGPj0w4/aZAvTlKMljiZyzD4o/8vbBH+DNH6t89D9+c8qzIwwuH2BwVqLq9povRq1+lWrXw=="],
203
204 - "@composio/claude-agent-sdk": ["@composio/claude-agent-sdk@0.10.1", "", { "dependencies": { "zod": "^4.4.3" }, "peerDependencies": { "@anthropic-ai/claude-agent-sdk": "^0.3.199", "@composio/core": ">=0.10.0 <1.0.0" } }, "sha512-sHZLh+H4K2JbZh/rd35JyJqGGicCrIM2drJoQfbifZJGbflR83ELQry+A2DOWEJnXVuYxg2w1oblL7d7QwUn6A=="],
204 + "@composio/claude-agent-sdk": ["@composio/claude-agent-sdk@0.11.0", "", { "dependencies": { "zod": "^4.4.3" }, "peerDependencies": { "@anthropic-ai/claude-agent-sdk": "^0.3.199", "@composio/core": ">=0.10.0 <1.0.0" } }, "sha512-kU2bp7hmbmblFhp2TJM3w3WPTPKIrlAKLScIjNFh25vO3mZoMQrqm8M9f4pPsVXPA1NxrSJVrl6LqGzequoRtg=="],
205
206 "@composio/client": ["@composio/client@0.1.0-alpha.76", "", {}, "sha512-MXC5JGRVdiQ4EgLricy9o/mqBa1+1T7wHFZ6Q4ZJkrjzZqOMvxTgy21Zlb5J/1oGkB2bg9UDzpH8PkXCp/D4zA=="],
207
208 "@composio/core": ["@composio/core@0.17.0", "", { "dependencies": { "@composio/client": "0.1.0-alpha.76", "@composio/json-schema-to-zod": "0.3.0", "@types/json-schema": "^7.0.15", "is-fs-case-sensitive": "^2.0.0", "openai": "^7.2.0", "picocolors": "^1.1.1", "pusher-js": "^8.6.0", "semver": "^7.8.5", "zod-to-json-schema": "^3.25.2" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-HJzpKWgise3piltWorEHt07nrjUR3gPZnBmrFgnJXx5+6AiKn79YGBYLytdtuMscElLt/7pHOIxfcaYpiGkJ7A=="],
209
210 - "@composio/google": ["@composio/google@0.10.1", "", { "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-jfkYG+aNboBmYbVr2H4IcZ1JwrZ5OpY+ZM4UsNPOx+16hzMcGzaQqAWZhPw1vrPNRQBR68pevthhktP3vKGqZA=="],
210 + "@composio/google": ["@composio/google@0.10.2", "", { "peerDependencies": { "@composio/core": ">=0.16.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-CKib+bVSfZoP5coVWUJJwipHuVRtGR5YKel1ZRJ8Y+z60xaXRDtdpTKO2TJPYg3CAdEMx14iQXVrSZaK1Z0yqA=="],
211
212 "@composio/json-schema-to-zod": ["@composio/json-schema-to-zod@0.3.0", "", { "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-Lgz5QlclPsd9mo8FGn/12h3cwTpN6A9aYvucO1umjnuvyetb6nC//nHEu9TDU+BN5Sa0n+qmUUv4Tzd4wI4xeA=="],
213
docs/content/docs/tools-direct/executing-tools.mdx
+11 -2
@@ -493,7 +493,15 @@ console.log(result);
493
494 ## Security for local file paths
495
496 -Automatic upload reads local paths (or uses them in `files.upload`) and sends file content to Composio storage. To reduce the chance of **accidentally uploading secrets** (SSH keys, cloud credentials, `.env` files, or assistant project folders), the SDK checks resolved paths against a **default denylist** of path segments and file-name patterns. **HTTP/HTTPS URLs and `File` objects are not matched like local path strings**; only local string paths go through this check.
496 +Automatic upload reads local paths (or uses them in `files.upload`) and sends file content to Composio storage. To reduce the chance of **accidentally uploading secrets** (SSH keys, cloud credentials, `.env` files, or assistant project folders), the SDK checks local paths against a **default denylist** of path segments and file-name patterns. **HTTP/HTTPS URLs and `File` objects are not matched like local path strings**; only local string paths go through this check.
497 +
498 +<Callout type="warn">
499 +Matching both path forms requires `@composio/core` 0.17.1 or later (TypeScript) or a `composio` release newer than 0.20.0 (Python). Earlier versions check only the symlink-resolved path. In those versions, a layout such as `~/.claude -> /state/claude` is not protected.
500 +</Callout>
501 +
502 +When `sensitiveFileUploadProtection` (TypeScript) or `sensitive_file_upload_protection` (Python) is enabled, each path is matched **twice**: once as written and once after resolving symlinks. A symlink can hide a denied name in either direction. For example, `~/link -> ~/nested/.aws/creds` hides `.aws` from the path you wrote, while `~/.claude -> /state/claude` hides `.claude` from the resolved target. Dotfile managers such as chezmoi, stow, and yadm can produce the second layout.
503 +
504 +Matching both forms blocks these common single-symlink cases. Only the path as written and its fully resolved target are compared, so treat the denylist as a guardrail against accidental uploads, not a security boundary against a determined attacker.
505
506 <Callout type="warn">
507 Disabling protection or wiring a hook that always approves paths can allow **exfiltration of sensitive files** if an LLM or malicious input points at credential locations. Prefer keeping protection on, adding [`fileUploadPathDenySegments`](/reference/sdk-reference/typescript/composio#file-upload-security) (TypeScript) / `file_upload_path_deny_segments` (Python) for your own secret directories, and using a [`beforeFileUpload`](/reference/sdk-reference/typescript/composio#file-upload-security) / `before_file_upload` hook for auditing or strict allowlists. On Python, you can use the `@before_file_upload` decorator with `modifiers=[...]` the same way as `@before_execute` — see [Before file upload (Python)](/docs/tools-direct/modify-tool-behavior/before-execution-modifiers#before-file-upload-python) on the before-execution modifiers page.
@@ -511,7 +519,8 @@ const composio = new Composio({
519 apiKey: process.env.COMPOSIO_API_KEY!,
520 // default true — block paths under built-in segments (e.g. .ssh, .aws) and risky basenames
521 sensitiveFileUploadProtection: true,
514 - // optional: extra path *components* anywhere in the resolved path, merged with the built-in list
522 + // optional: extra path *components* anywhere in the path (as written or symlink-resolved),
523 + // merged with the built-in list
524 fileUploadPathDenySegments: ['internal-only-secrets'],
525 });
526 ```
docs/package.json
+2 -2
@@ -80,9 +80,9 @@
80 "@anthropic-ai/claude-agent-sdk": "^0.3.220",
81 "@anthropic-ai/sdk": "^0.115.0",
82 "@composio/anthropic": "^0.11.0",
83 - "@composio/claude-agent-sdk": "^0.10.1",
83 + "@composio/claude-agent-sdk": "^0.11.0",
84 "@composio/core": "^0.17.0",
85 - "@composio/google": "^0.10.1",
85 + "@composio/google": "^0.10.2",
86 "@composio/langchain": "^0.10.1",
87 "@composio/llamaindex": "^0.10.1",
88 "@composio/mastra": "^0.10.3",