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

fix(docs): expose supported providers in HTML and Markdown (#5177)

Linear: [DEVREL-311](https://linear.app/composio/issue/DEVREL-311/providers-page-doesnt-list-all-adapters) ## Problem The live https://docs.composio.dev/docs/providers.md response had empty AI SDKs and Agent frameworks sections and leaked a Custom-card JSX fragment. The concise https://docs.composio.dev/llms.txt index had no individual provider-guide links. The source inventory also omitted Eve and did not name adapters sharing vendor guides. Gauge issue cmvh74fw0006m0iuxw58q8igm corroborates this in cmvtk3294007v01ggkd54meq2 (seq 24, 30, 34), cmvfzawkc00at01nu6seg4xhs (seq 40, 48, 52), and cmvh6unw2000501jqc1jjffka (seq 73, 89, 101, 106). Live issue details, insights, and cited trace windows were read. The defect remained in the worktree's origin/next baseline ccc05a690a6fa3fc252e27764290b22b4d6f3ddc; no matching full-scope open PR was identified. **Root cause.** ComposioHQ/composio owns docs/content/docs/providers/index.mdx and docs/lib/source.ts. The ProviderCard serializer required authored braced language arrays, while processed Markdown reserialized those attributes as strings. Unmatched cards were stripped; the Custom card's nested self-closing icon left trailing JSX. The page's hand-maintained cards also lacked several guide-backed adapters, and the concise discovery index only linked the broken landing page. ## Change Introduced docs/lib/providers.ts as the shared inventory for server-rendered semantic lists, Markdown serialization, and curated OpenAI/Anthropic discovery entries. Replaced prop-heavy ProviderCard/ProviderGrid MDX with ProviderList group references and removed the obsolete export path. Included current guides, explicitly named OpenAI Agents SDK, Claude Agent SDK, Google ADK, and LangGraph, added Eve, preserved Pi/Eve experimental labels, and linked the verified maintained Cloudflare Workers AI package reference rather than inventing a docs route. Kept the TypeSafe tutorial, client configuration, custom-provider destination, SDK contracts, and legacy references unchanged. Added static inventory/discovery and HTTP parity regressions and updated component guidance. Committed as c373d0bea on the requested branch. ## Verification exercised - Scoped dependency installation with NODE_OPTIONS=--max-old-space-size=4096 bun install --frozen-lockfile succeeded without lockfile changes. - Focused static suite: 7 passed, 0 failed, 183 assertions across provider inventory, concise routing, source conversion, and package-install Markdown tests. - Documentation typecheck passed. A post-dev attempt encountered malformed generated .next/dev/types/validator.ts; after stopping the server and clearing its generated .next cache, normal types:check regenerated route types and passed without changing checks or source contracts. - Documentation lint exited successfully; warnings reference untouched files, not the provider changes. - Documentation and SDK link validators each reported 0 errored files and 0 errors. - Local dev-server HTTP regression: NODE_OPTIONS=--max-old-space-size=4096 TEST_BASE_URL=http://localhost:3311 bun test tests/integration/providers.test.ts --timeout 180000 passed with 43 assertions, checking semantic HTML lists against processed Markdown, shared-guide adapter names, experimental labels, and the custom-provider link. - Consumer smoke scenario verified all 18 linked entries across /docs/providers.md, Accept: text/markdown on /docs/providers, and /llms.mdx/docs/providers; every representation returned HTTP 200 and text/markdown. - Consumer smoke scenario verified /llms.txt and /llms-index.txt as HTTP 200 text/plain, direct OpenAI/Anthropic discovery, and all 13 owned guide destinations as HTTP 200 text/markdown; retained TypeSafe installation and client-configuration guidance was present. - Opened the public maintained Cloudflare provider README and confirmed the Workers AI adapter and TypeScript package reference before adding its link. - Stopped the local dev server, removed the throwaway smoke script and Next-generated guidance append, committed only intended files, and observed an empty git status --short. Rerun by the factory on the pushed commit before opening this PR: - `NODE_OPTIONS=--max-old-space-size=4096 bun test tests/static/providers.test.ts tests/static/llms-routing.test.ts tests/static/source.test.ts tests/static/package-install-markdown.test.ts` in `docs` — exit 0 - `NODE_OPTIONS=--max-old-space-size=4096 bun run types:check` in `docs` — exit 0 - `NODE_OPTIONS=--max-old-space-size=4096 bun run lint` in `docs` — exit 0 - `NODE_OPTIONS=--max-old-space-size=4096 bun run lint:links` in `docs` — exit 0 ## Remaining validation - Pending post-deployment matched Gauge validation for cmvtk3294007v01ggkd54meq2, cmvfzawkc00at01nu6seg4xhs, and cmvh6unw2000501jqc1jjffka with unchanged criteria: confirm exact changed-section exposure, original-finding removal, and no material new finding. No run, evaluation, optimization, or deployment was started. - Local verification used server-rendered HTML inspection and a dev server, not a production build or browser visual/hydration check. - No credentialed SDK execution was attempted; unchanged examples and unrelated SDK/authentication/packaging issues are not claimed fixed. Not merged or deployed. A matched Gauge retest can only run after deployment. <sub>Opened by the devrel-tools factory (queue `2026-10-31-initial`).</sub>

Brendan O'Leary committed Nov 3, 2026 at 10:34 UTC b708d866ca4773255cff1a24086840ae7afa2af4

No changes.