@devries-cameron20 / composio Mirror · read-only / commits / 2919fb49a
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, 08:30 UTC

docs: list approval mode's real limitations

Workbench and bash scripts are approved as a whole after a best-effort review, proxy execute is off where approval could apply, and tag-based rules depend on tag accuracy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Mukund committed Oct 15, 2026 at 18:01 UTC 2919fb49a595466e39cae282158b207ebf501b35
1 file changed +4 -3
docs/content/docs/approval-mode.mdx
+4 -3
@@ -411,9 +411,10 @@ const session = await composio.create('user_123', {
411
412 ## Limitations
413
414 -- **Providers.** `handle_tool_calls` and framework providers don't support approval yet. Run tool calls with `session.execute()`, as in the example above.
415 -- **Custom tools.** A [custom tool](/docs/extending-sessions/custom-tools-and-toolkits) can't pass an answer through `ctx.execute()`.
416 -- **Proxy execute.** `session.proxy_execute()` is disabled for a toolkit when any of its tools can need approval.
414 +- **Workbench and bash scripts.** Composio reviews `COMPOSIO_REMOTE_WORKBENCH` and `COMPOSIO_REMOTE_BASH_TOOL` scripts on a best-effort basis to find the tools they call. If any of those tools need approval, the script picks tools while it runs, or the review fails, the user approves the whole script. Calls the script makes aren't asked about again, and there's no **Always approve**.
415 +- **Proxy execute.** A proxy request can't be matched to a tool, so `session.proxy_execute()` is disabled for a toolkit when any of its tools can need approval.
416 +- **Tags.** Rules based on [tags](/docs/tool-tags) are only as accurate as the tags, which Composio assigns on a best-effort basis. List tools explicitly for anything you must gate.
417 +- **Providers.** `handle_tool_calls` and framework providers don't handle approval yet. Run tool calls with `session.execute()`, as in the example above.
418
419 ## Next
420