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: mark migration guides legacy + timestamp; surface example code & legacy status in llms output (#3775)
Follow-up doc fixes from a re-audit of the June "Pi Slack-bot friction" report against the current docs. Low-risk changes across the migration guides, the example `.md` output, and legacy handling. ## 1. Migration guides: selective legacy + a "Written {date}" stamp Migration guides are point-in-time documents, but not all are legacy. Two mechanisms, decoupled: - **`legacy: true`** (existing Legacy badge) — only on guides that migrate off something dead: **new-sdk** (deprecated v1 SDK) and **tool-router-beta** (removed experimental tool router). - **`written: "{Month YYYY}"`** (new frontmatter field, dates from git creation) — renders a standalone **"Written {date}"** stamp on *every* guide, independent of legacy. So current guides (direct-to-sessions, mcp-servers-to-sessions, toolkit-versioning, the hub) show their date without being mislabeled legacy. Files: `source.config.ts` (new `written` field), `components/legacy-badge.tsx` (plain badge again), docs page (badge + date row), 6 migration guides. ## 2. Real example code now in the `.md`/llms output `<FileBuildup>` / `<RepoBrowser>` render an example's actual source (`bot.ts`, `install.ts`, …) interactively, but they're React components that don't serialize to markdown — so `examples/general-agent-with-pi.md` (what an agent fetches) had all the prose and **no code**. `mdxToCleanMarkdown` now resolves them from the `FILE_BUILDS` registry. That example's `.md` grows **6.5 KB → 34 KB** with the real `createSessionTools`/`proxyExecute`/`waitForConnections`/`verifyWebhook` code. Also fixes standup-slackbot and local-workbench. ## 3. Legacy pages: flag in `.md`, skip the current-pattern guardrail `getLLMText` now prepends "Legacy · written {date}" (or "Written {date}" for current-dated pages) to the `.md`, and **skips the "enforce ONLY the current patterns" guardrail block on legacy pages** — appending it to a legacy guide contradicted the guide's own older content (e.g. new-sdk showing `tools.execute()` as the v3 target). ## 4. Note that `subscribe()` uses Pusher under the hood Short aside on the triggers subscribe doc, for readers on runtimes that restrict WebSocket clients. --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>