@devries-cameron20 / composio Mirror · read-only / commits / 96bfd2cc5
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, 12:15 UTC

docs: proxy execute follows the session's toolkit lists (#4552)

This PR: - reopens https://github.com/ComposioHQ/composio/pull/4472 (D3) directly against `next`; the original was merged into the D2 branch by mistake, and https://github.com/ComposioHQ/composio/pull/4471 has been trimmed back to D2 only - cherry-picks the original D3 commit unchanged onto `next` (ba59d21c9) - adds a "Session restrictions" section to the Proxy execute page: toolkit enable and disable lists apply to proxy calls, including from the sandbox; hint filters and per-toolkit tool rules do not; example that turns proxy execution off with `sandbox={"enable_proxy_execution": False}` / `sandbox: { enable: true, enableProxyExecution: false }` - adds one sentence in the Configuring Sessions sandbox section pointing to that section - merge after: ComposioHQ/platform#12847 (enforce toolkit lists on the session proxy execute route). Kept as a draft until that ships so it cannot be merged out of order again PRD: https://app.notion.com/p/composio/Session-Governance-via-hints-Across-toolkits-3daf261a6dfe80df8e0ce337a2b26e08 Linear workstream: https://linear.app/composio/project/sessions-execution-governance-a0942233a0d0 Verification, run in `docs/` on this branch: `bun run types:check` passes, `bun run lint:links` reports 0 errors. `pnpm exec prettier --check` flags the touched mdx files on `next` already, so no reformatting was applied. --------- Co-authored-by: Palash Kala <palash@composio.dev> Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com> Co-authored-by: Brendan O'Leary <brendan@olearycrew.com> Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

Alberto Schiabel committed Sep 21, 2026 at 19:21 UTC 96bfd2cc5e82a185e72a31d880b0b2804dce72c5
2 files changed +31
docs/content/docs/configuring-sessions.mdx
+2
@@ -626,6 +626,8 @@ When disabled:
626 - Sandbox-related system prompt lines are stripped
627 - Direct sandbox calls are rejected with a 400 error
628
629 +To keep the sandbox but block raw HTTP calls from it, set `enable_proxy_execution` (Python) or `enableProxyExecution` (TypeScript) to `false`. See [Proxy execute](/docs/extending-sessions/proxy-execute#session-restrictions) for how session restrictions apply to proxy calls.
630 +
631 <Callout>
632 `sandbox` is the preferred config key. `workbench` still works as a fully supported alias and isn't deprecated, so existing code keeps running unchanged.
633 </Callout>
docs/content/docs/extending-sessions/proxy-execute.mdx
+29
@@ -73,6 +73,35 @@ The `endpoint` is appended to the base URL, and many base URLs already include a
73 Proxy execute rejects cross-domain requests. The `endpoint` must resolve to the same domain as the toolkit's connected account (a GitHub connection can only call `api.github.com` paths). This is an intentional security boundary, not a quota, so you can't work around it by reshaping the request.
74 </Callout>
75
76 +## Session restrictions
77 +
78 +Proxy execute follows the session's toolkit lists: a call for a toolkit outside `toolkits.enable` or inside `toolkits.disable` is rejected with the same error a blocked tool call gets, including from the session's sandbox.
79 +
80 +Hint filters and per-toolkit tool rules do not apply, because a proxy request names an endpoint, not a tool. To remove the raw HTTP path from the session's sandbox, turn proxy execution off in the sandbox config:
81 +
82 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
83 +<Tab value="Python">
84 +```python
85 +session = composio.sessions.create(
86 + user_id="user_123",
87 + tags=["readOnlyHint"],
88 + sandbox={"enable_proxy_execution": False}
89 +)
90 +```
91 +</Tab>
92 +<Tab value="TypeScript">
93 +```typescript
94 +import { Composio } from '@composio/core';
95 +const composio = new Composio({ apiKey: 'your_api_key' });
96 +// ---cut---
97 +const session = await composio.create("user_123", {
98 + tags: ["readOnlyHint"],
99 + sandbox: { enable: true, enableProxyExecution: false },
100 +});
101 +```
102 +</Tab>
103 +</Tabs>
104 +
105 ## Parameters
106
107 | Parameter | Required | Type | Description |