Skip to content

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 (#4105)

sdkrelease[bot]1fe2fe30cc62
diff --git a/docs/bun.lock b/docs/bun.lock
index 70b0a008b..f5561a785 100644
--- a/docs/bun.lock
+++ b/docs/bun.lock
@@ -48,9 +48,9 @@
"@anthropic-ai/claude-agent-sdk": "^0.3.220",
"@anthropic-ai/sdk": "^0.115.0",
"@composio/anthropic": "^0.11.0",
- "@composio/claude-agent-sdk": "^0.10.1",
+ "@composio/claude-agent-sdk": "^0.11.0",
"@composio/core": "^0.17.0",
- "@composio/google": "^0.10.1",
+ "@composio/google": "^0.10.2",
"@composio/langchain": "^0.10.1",
"@composio/llamaindex": "^0.10.1",
"@composio/mastra": "^0.10.3",
@@ -201,13 +201,13 @@
"@composio/anthropic": ["@composio/[email protected]", "", { "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=="],
- "@composio/claude-agent-sdk": ["@composio/[email protected]", "", { "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=="],
+ "@composio/claude-agent-sdk": ["@composio/[email protected]", "", { "dependencies": { "zod": "^4.4.3" }, "peerDependencies": { "@anthropic-ai/claude-agent-sdk": "^0.3.199", "@composio/core": ">=0.10.0 <1.0.0" } }, "sha512-kU2bp7hmbmblFhp2TJM3w3WPTPKIrlAKLScIjNFh25vO3mZoMQrqm8M9f4pPsVXPA1NxrSJVrl6LqGzequoRtg=="],
"@composio/client": ["@composio/[email protected]", "", {}, "sha512-MXC5JGRVdiQ4EgLricy9o/mqBa1+1T7wHFZ6Q4ZJkrjzZqOMvxTgy21Zlb5J/1oGkB2bg9UDzpH8PkXCp/D4zA=="],
"@composio/core": ["@composio/[email protected]", "", { "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=="],
- "@composio/google": ["@composio/[email protected]", "", { "peerDependencies": { "@composio/core": ">=0.10.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-jfkYG+aNboBmYbVr2H4IcZ1JwrZ5OpY+ZM4UsNPOx+16hzMcGzaQqAWZhPw1vrPNRQBR68pevthhktP3vKGqZA=="],
+ "@composio/google": ["@composio/[email protected]", "", { "peerDependencies": { "@composio/core": ">=0.16.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-CKib+bVSfZoP5coVWUJJwipHuVRtGR5YKel1ZRJ8Y+z60xaXRDtdpTKO2TJPYg3CAdEMx14iQXVrSZaK1Z0yqA=="],
"@composio/json-schema-to-zod": ["@composio/[email protected]", "", { "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-Lgz5QlclPsd9mo8FGn/12h3cwTpN6A9aYvucO1umjnuvyetb6nC//nHEu9TDU+BN5Sa0n+qmUUv4Tzd4wI4xeA=="],
diff --git a/docs/content/docs/tools-direct/executing-tools.mdx b/docs/content/docs/tools-direct/executing-tools.mdx
index 35fd26f74..3802a7bd8 100644
--- a/docs/content/docs/tools-direct/executing-tools.mdx
+++ b/docs/content/docs/tools-direct/executing-tools.mdx
@@ -493,7 +493,15 @@ console.log(result);
## Security for local file paths
-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.
+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.
+
+<Callout type="warn">
+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.
+</Callout>
+
+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.
+
+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.
<Callout type="warn">
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({
apiKey: process.env.COMPOSIO_API_KEY!,
// default true — block paths under built-in segments (e.g. .ssh, .aws) and risky basenames
sensitiveFileUploadProtection: true,
- // optional: extra path *components* anywhere in the resolved path, merged with the built-in list
+ // optional: extra path *components* anywhere in the path (as written or symlink-resolved),
+ // merged with the built-in list
fileUploadPathDenySegments: ['internal-only-secrets'],
});
```
diff --git a/docs/package.json b/docs/package.json
index f251821f4..22dd48538 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -80,9 +80,9 @@
"@anthropic-ai/claude-agent-sdk": "^0.3.220",
"@anthropic-ai/sdk": "^0.115.0",
"@composio/anthropic": "^0.11.0",
- "@composio/claude-agent-sdk": "^0.10.1",
+ "@composio/claude-agent-sdk": "^0.11.0",
"@composio/core": "^0.17.0",
- "@composio/google": "^0.10.1",
+ "@composio/google": "^0.10.2",
"@composio/langchain": "^0.10.1",
"@composio/llamaindex": "^0.10.1",
"@composio/mastra": "^0.10.3",