@devries-cameron20 / composio-1 / commits / fcbc5f179
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: add approvals and tool tags pages (PLEN-4329) (#4876)

## Summary Adds docs pages for approvals (experimental) and tool tags. Linear [PLEN-4329](https://linear.app/composio/issue/PLEN-4329/documentation). The approvals page explains how a session can ask the user before a tool runs, using the SDK options from #4862. Draft until #4862 ships: the TypeScript blocks use `// @noErrors` because the published `@composio/core` doesn't have `inputResponses` yet, and the version numbers in the experimental callout (newer than Python 0.27.0 and TypeScript 0.24.0) are placeholders. Stacked on #4882, which moves Session configs to their own page. ## Changes - New page `/docs/approvals`, marked experimental, under Sessions after Configuring Sessions. Sections: - **Configuring approvals:** the dashboard's three steps (enable toolkits; allow, ask first or block each tag; override a toolkit by tag or by tool), using the same config shapes the dashboard writes. - **Asking the user:** the `ToolInputRequiredError` / `ComposioToolInputRequiredError` and its `input_requests`. - **Sending the answer:** `input_responses` with `request_state`, and what Always approve does. - **Agent loop:** an Anthropic loop that asks the user in the terminal, plus how to answer later in a web app. - **Using MCP:** `no_elicitation_support_fallback`. - **Limitations:** providers, custom tools' `ctx.execute()` and proxy execute. - New page `/docs/tool-tags`, under Toolkits & Tools. It covers the four tags, how a tool's single tag is chosen (most severe wins), where tags come from for Composio and MCP toolkits, and how sessions use them. Configuring Sessions now links there instead of repeating the definitions. - Configuring Sessions' "Filtering tools by tags" now uses the same allow / block / ask first model for tools, with per-toolkit overrides, and links to Tool tags instead of repeating the definitions. - Stops documenting `idempotentHint` and `openWorldHint`. Only some tools set them, so they shouldn't decide what an agent can do. They're removed from `python/docs/tool-router.md`, `ts/docs/api/tool-router.md`, the SDK docstring examples and the meta-tool tag badges. The SDK types still accept them. - Bumps the docs `@composio/core` to 0.24.0, whose tag types include `createHint` and `updateHint`. - Links from Configuring Sessions, Production readiness and Sessions vs Direct Execution. The "Human approval" row there no longer tells people to build approval themselves. - Adds both pages to the Platform sidebar in `lib/home-navigation.ts`, and moves the sidebar test's Authentication anchor past the new Tool tags entry. ## Type of change - [ ] Bug fix - [ ] New feature - [ ] Refactor/Chore - [x] Documentation - [ ] Breaking change ## How Has This Been Tested? - `bun run lint:links`: 0 errors. - `bun run test`: 715 pass. - Both pages render on `bun run dev`. - `bun run build` passes locally with `@composio/core` 0.24.0. ## Checklist - [x] I have read the Code of Conduct and this PR adheres to it - [x] I have read and understand every line of this diff, including any LLM-generated code - [x] Any third-party docs links or promotional content follow the [third-party links policy](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md#third-party-links-in-docs) - [x] I ran linters/tests locally and they passed - [x] I updated documentation as needed - [x] I added tests or explain why not applicable (docs only) - [ ] I added a changeset if this change affects published packages (not applicable) 🤖 Generated with [Claude Code](https://claude.com/claude-code)

mukund-composio committed Oct 16, 2026 at 15:02 UTC fcbc5f179e3bf75b82e06c4f11fd19b2f1a13ea8

No changes.