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, 09:45 UTC
docs: toolkit version deprecation and sunset (#4881)
## What Adds a "Deprecation and sunset" section to `docs/content/docs/tools-direct/toolkit-versioning.mdx` (50 lines of MDX): Composio-managed toolkit versions are deprecated 12 months after publish and retired 3 months after that, the newest version is never deprecated, what the `Composio-Deprecated-Toolkits` response header looks like and which routes carry it, the exact SDK warning text for Python and TypeScript with how to silence it, how to move to a newer version (cross-linked to the existing pinning sections on the page), and the `410 Gone` after the sunset date. The section's anchor is the `<DOCS_URL>` both SDK warnings point at: `https://docs.composio.dev/docs/tools-direct/toolkit-versioning#deprecation-and-sunset` ## Why Phase 1 of toolkit version deprecation (PLEN-2553; platform #13516, #13517) emits the header and the SDK PRs warn with a link to this section. `migration-guide/toolkit-versioning.mdx` covers the v0.9 / v0.2 required-version change and does not overlap, so nothing was duplicated there. ## Notes - No Phase 2 (410) page exists on the site yet, so the sunset behaviour is one sentence. - The sunset in the example header, `@1787788800`, is 2026-08-27 UTC (the handoff's prose said 2026-08-23; the page uses the value the epoch actually encodes, matching the SDK formatters). - No em dashes in the added text. ## Checks run From `docs/` with the mise toolchain (`bun 1.4.3`), after `bun install`: - `bun run lint`: 5 pre-existing warnings in unrelated `.tsx` / `.mjs` files, none in the changed page. - `bun run lint:links`: `0 errored file, 0 errors`. - `bun run test`: `715 pass, 0 fail` across 67 files. - `bun run types:check`: KB generation, agent index, `fumadocs-mdx`, `next typegen` and `tsc --noEmit` all clean. - `bun run build`: `next build` exit 0. ## Sibling PRs - TypeScript: https://github.com/ComposioHQ/composio/pull/4883 - Python: https://github.com/ComposioHQ/composio/pull/4884 Linear: PLEN-4352 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>