@devries-cameron20 / composio Mirror · read-only / commits / c373d0bea
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

Brendan O'Leary committed Oct 31, 2026 at 12:38 UTC c373d0bea5f997a9fdf59683c9ae03fc87b10213
10 files changed +213 -108
docs/agent-guidance/context/fumadocs.md
+1 -1
@@ -42,7 +42,7 @@ Available globally without imports:
42 - `Callout`
43 - `Step`, `Steps`
44 - `Card`, `Cards`
45 -- `ProviderCard`, `ProviderGrid`
45 +- `ProviderList` (`group="ai-sdks"`, `"agent-frameworks"`, or `"custom"`), backed by `lib/providers.ts`
46 - `FrameworkSelector`, `QuickstartFlow`, `FrameworkOption`
47 - `IntegrationTabs`, `IntegrationContent`
48 - `ToolTypeFlow`, `ToolTypeOption`
docs/agent-guidance/context/markdown-components.md
+3 -2
@@ -9,10 +9,11 @@ Audit for DEVREL-35, 2026-09-10. Scope: components registered in `mdx-components
9 | Versioned API details | `ApiBaseUrl`, `ApiEndpointsTable` | Existing converters preserve version-specific URLs and endpoint tables. Existing tests cover raw and processed attributes. |
10 | Decisions and warnings | `Callout`, `Tabs`, `Tab`, `TabsContent`, `FrameworkOption`, `IntegrationTabs`, `IntegrationContent`, `ToolTypeOption`, `ConnectClientOption`, `Accordion` | Existing converters retain text, labels, and warning content. |
11 | Step instructions and definitions | `Steps`, `Step`, `StepTitle`, `Glossary`, `GlossaryTerm` | Existing converters retain headings and content. |
12 -| Linked content | `Card`, `ProviderCard`, `TemplateCard`, `HomeSurfaces`, `AIToolsBanner` | Existing converters retain destinations or route readers to canonical setup instructions. |
12 +| Linked content | `Card`, `TemplateCard`, `HomeSurfaces`, `AIToolsBanner` | Existing converters retain destinations or route readers to canonical setup instructions. |
13 +| Provider inventory | `ProviderList` | `lib/providers.ts` supplies semantic server-rendered lists and Markdown links, including language support and experimental labels. The concise discovery index selects OpenAI and Anthropic from the same inventory; the complete index lists the underlying guides. |
14 | Media | `Figure`, `YouTube`, `Video` | Preserve captions and source links. Video links now survive conversion. Transcription of media is outside this audit. |
15 | Example source | `FileBuildup`, `RepoBrowser` | Existing converters expose staged source or an explicit repository-availability notice. |
15 -| Structural wrappers and icons | `Cards`, `ProviderGrid`, `TemplateGrid`, `QuickstartFlow`, `FrameworkSelector`, `ToolTypeFlow`, `ConnectFlow`, `Accordions`, `CapabilityList`, `MediaSplit`, `AppLogo`, registered Lucide icons | Wrappers have no task instructions; their child content survives. Icons are decorative. |
16 +| Structural wrappers and icons | `Cards`, `TemplateGrid`, `QuickstartFlow`, `FrameworkSelector`, `ToolTypeFlow`, `ConnectFlow`, `Accordions`, `CapabilityList`, `MediaSplit`, `AppLogo`, registered Lucide icons | Wrappers have no task instructions; their child content survives. Icons are decorative. |
17 | Visual explanations | `SessionFlow`, `TriggersFlow`, `SlackBotFlow`, `LocalWorkbenchFlow`, `LocalSandboxBoundary`, `ImessageFlow`, `WorkbenchFlow`, `AuthConfigFlow`, `WhiteLabelFlow`, `ImportConnectionFlow`, `ManageConnectionsVisual`, `ConnectionRefreshVisual`, `InChatAuthTerminal`, `ClaudeMockUI`, `ZdrLogVisual` | Diagrams illustrate the surrounding guide. The authored instructions remain the executable path. Full visual-to-text parity is a follow-up, not claimed by this fix. |
18 | Mermaid | `Mermaid` | `getLLMText` preserves processed diagram code. Raw component diagrams in search require separate parity coverage. |
19 | Homepage and catalogs | `DocsHero`, `HomeFeatures`, `HomeResources`, `ToolkitsLanding`, `ManagedAuthList` | Dynamic content is not fully serialized by the generic converter. Product selection survives through `HomeSurfaces`; toolkit routes have dedicated Markdown renderers, and managed-auth prose includes the API lookup. Full catalog and homepage parity remains a follow-up. |
docs/app/llms.txt/route.ts
+12 -2
@@ -1,9 +1,15 @@
1 import { TOOLKIT_COUNT_LABEL } from '@/lib/toolkit-count';
2 +import { PROVIDERS } from '@/lib/providers';
3
4 export const revalidate = false;
5
6 /** Curated routing map; the exhaustive catalog lives at /llms-index.txt. */
7 export function GET() {
8 + // Keep the concise map focused; all adapters remain on the providers page.
9 + const providerGuides = PROVIDERS['ai-sdks']
10 + .filter(provider => provider.name === 'OpenAI' || provider.name === 'Anthropic')
11 + .map(provider => `- [${provider.name}](https://docs.composio.dev${provider.href}.md)`)
12 + .join('\n');
13 return new Response(`# Composio Documentation
14
15 > Build and operate agents with authentication, tool discovery, execution, and ${TOOLKIT_COUNT_LABEL} toolkits.
@@ -16,7 +22,7 @@ Inspect the project's framework, agent architecture, authentication, and user or
22
23 Load and follow the official [Composio Agent Skill](https://github.com/ComposioHQ/composio/blob/next/skills/composio/SKILL.md) for setup guidance and implementation patterns. If it is missing, install it for the project with \`npx skills add ComposioHQ/composio --skill composio\`, requesting approval if your host requires it. If skills are unsupported or installation fails, use the documentation linked below and report that fallback.
24
19 -If it is unclear whether the goal is to integrate Composio into the application or connect apps to the coding agent itself, clarify that first. Fetch the relevant Markdown pages below for the chosen path. Use the complete index when you need a guide or reference not listed here.
25 +If unclear, distinguish application integration from connecting apps to the coding agent. Fetch Markdown below; use the complete index for other guides.
26
27 ## Choose your path
28
@@ -36,12 +42,16 @@ If it is unclear whether the goal is to integrate Composio into the application
42 - [Token custody](https://docs.composio.dev/docs/security/token-custody.md): Credential storage, redaction, VPC, self-hosting, and customer-managed keys.
43 - [Proxy Execute](https://docs.composio.dev/docs/extending-sessions/proxy-execute.md): Call provider endpoints that tools don't cover without retrieving the token.
44 - [Configure sessions](https://docs.composio.dev/docs/configuring-sessions.md): Select toolkits, auth configs, and connected accounts for a user.
39 -- [SDKs and frameworks](https://docs.composio.dev/docs/providers.md): Choose the provider for your agent framework.
45 +- [SDKs and frameworks](https://docs.composio.dev/docs/providers.md): Choose a framework provider.
46 - [Sessions via MCP](https://docs.composio.dev/docs/sessions-via-mcp.md): Give an application-created session to an MCP-compatible framework.
47 - [Single-toolkit MCP](https://docs.composio.dev/docs/single-toolkit-mcp.md): Build an MCP server scoped to one toolkit.
48 - [Troubleshooting](https://docs.composio.dev/kb.md): Diagnose authentication, connection, and execution failures.
49 - [Production rate limits](https://docs.composio.dev/reference/rate-limits.md): Plan for request limits before deployment.
50
51 +## Provider guides
52 +
53 +${providerGuides}
54 +
55 ## Session SDK reference
56
57 - [TypeScript session creation and reuse](https://docs.composio.dev/reference/sdk-reference/typescript/sessions.md): Look up the exact \`sessions.create()\` and \`sessions.use()\` signatures.
docs/components/provider-list.tsx renamed
+11 -19
@@ -1,19 +1,8 @@
1 -'use client';
2 -
1 import Link from 'next/link';
2 import Image from 'next/image';
5 -import type { ReactNode } from 'react';
6 -
7 -interface ProviderCardProps {
8 - name: string;
9 - href: string;
10 - logo?: string;
11 - logoDark?: string;
12 - icon?: ReactNode;
13 - languages?: ('Python' | 'TypeScript')[];
14 -}
3 +import { PROVIDERS, type Provider, type ProviderGroup } from '@/lib/providers';
4
16 -export function ProviderCard({ name, href, logo, logoDark, icon, languages }: ProviderCardProps) {
5 +function ProviderCard({ name, href, logo, logoDark, languages, experimental }: Provider) {
6 return (
7 <Link
8 href={href}
@@ -45,8 +34,6 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Pr
34 height={48}
35 className="h-10 w-auto"
36 />
48 - ) : icon ? (
49 - <span className="text-fd-muted-foreground">{icon}</span>
37 ) : (
38 <span className="text-2xl font-bold text-fd-muted-foreground/40">
39 {name.charAt(0)}
@@ -56,6 +43,7 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Pr
43
44 <div className="flex flex-col justify-center gap-2">
45 <span className="text-sm font-semibold text-fd-foreground">{name}</span>
46 + {experimental && <span className="text-xs text-fd-muted-foreground">Experimental</span>}
47 {languages && languages.length > 0 && (
48 <div className="flex gap-2">
49 {languages.map((lang) => (
@@ -73,10 +61,14 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Pr
61 );
62 }
63
76 -export function ProviderGrid({ children }: { children: React.ReactNode }) {
64 +export function ProviderList({ group }: { group: ProviderGroup }) {
65 return (
78 - <div className="not-prose grid grid-cols-1 gap-3 sm:grid-cols-2">
79 - {children}
80 - </div>
66 + <ul className="not-prose m-0 grid list-none grid-cols-1 gap-3 p-0 sm:grid-cols-2">
67 + {PROVIDERS[group].map(provider => (
68 + <li key={provider.name}>
69 + <ProviderCard {...provider} />
70 + </li>
71 + ))}
72 + </ul>
73 );
74 }
docs/content/docs/providers/index.mdx
+3 -78
@@ -29,40 +29,7 @@ With `apiKey: null` and only an organization API key, API calls, trigger authori
29
30 Use these when you call a model SDK directly.
31
32 -<ProviderGrid>
33 - <ProviderCard
34 - name="Anthropic"
35 - href="/docs/providers/anthropic"
36 - logo="/images/providers/anthropic-logo.svg"
37 - logoDark="/images/providers/anthropic-logo-dark.svg"
38 - languages={['Python', 'TypeScript']}
39 - />
40 - <ProviderCard
41 - name="OpenAI"
42 - href="/docs/providers/openai"
43 - logo="/images/providers/openai-logo.svg"
44 - logoDark="/images/providers/openai-logo-dark.svg"
45 - languages={['Python', 'TypeScript']}
46 - />
47 - <ProviderCard
48 - name="Vercel AI SDK"
49 - href="/docs/providers/vercel"
50 - logo="/images/providers/vercel-logo.svg"
51 - logoDark="/images/providers/vercel-logo-dark.svg"
52 - languages={['TypeScript']}
53 - />
54 - <ProviderCard
55 - name="Google"
56 - href="/docs/providers/google"
57 - logo="/images/providers/google-logo.svg"
58 - languages={['Python', 'TypeScript']}
59 - />
60 - <ProviderCard
61 - name="TypeSafe"
62 - href="/docs/providers/typesafe"
63 - languages={['Python', 'TypeScript']}
64 - />
65 -</ProviderGrid>
32 +<ProviderList group="ai-sdks" />
33
34 ## TypeSafe
35
@@ -142,50 +109,8 @@ The confidence score is the least certain judgement the call depends on, not the
109
110 Use these when an agent framework orchestrates the tool calls for you.
111
145 -<ProviderGrid>
146 - <ProviderCard
147 - name="LangChain"
148 - href="/docs/providers/langchain"
149 - logo="/images/providers/langchain-logo.svg"
150 - logoDark="/images/providers/langchain-logo-dark.svg"
151 - languages={['Python', 'TypeScript']}
152 - />
153 - <ProviderCard
154 - name="CrewAI"
155 - href="/docs/providers/crewai"
156 - logo="/images/providers/crewai-logo.svg"
157 - languages={['Python']}
158 - />
159 - <ProviderCard
160 - name="LlamaIndex"
161 - href="/docs/providers/llamaindex"
162 - logo="/images/providers/llamaIndex-logo.svg"
163 - languages={['Python', 'TypeScript']}
164 - />
165 - <ProviderCard
166 - name="Mastra"
167 - href="/docs/providers/mastra"
168 - logo="/images/providers/mastra-logo.svg"
169 - logoDark="/images/providers/mastra-logo-dark.svg"
170 - languages={['TypeScript']}
171 - />
172 - <ProviderCard
173 - name="Pi"
174 - href="/docs/providers/pi"
175 - logo="/images/providers/pi-logo.svg"
176 - logoDark="/images/providers/pi-logo-dark.svg"
177 - languages={['TypeScript']}
178 - />
179 - <ProviderCard name="AutoGen" href="/docs/providers/autogen" languages={['Python']} />
180 -</ProviderGrid>
112 +<ProviderList group="agent-frameworks" />
113
114 ## Custom
115
184 -<ProviderGrid>
185 - <ProviderCard
186 - name="Build your own"
187 - href="/docs/providers/custom-providers"
188 - icon={<Blocks size={32} />}
189 - languages={['Python', 'TypeScript']}
190 - />
191 -</ProviderGrid>
116 +<ProviderList group="custom" />
docs/lib/providers.ts new
+81
@@ -0,0 +1,81 @@
1 +export interface Provider {
2 + name: string;
3 + href: string;
4 + languages: readonly ('Python' | 'TypeScript')[];
5 + logo?: string;
6 + logoDark?: string;
7 + experimental?: boolean;
8 +}
9 +
10 +/** Guide-backed inventory shared by HTML, Markdown, and discovery. */
11 +export const PROVIDERS: Record<'ai-sdks' | 'agent-frameworks' | 'custom', readonly Provider[]> = {
12 + 'ai-sdks': [
13 + {
14 + name: 'Anthropic', href: '/docs/providers/anthropic',
15 + logo: '/images/providers/anthropic-logo.svg', logoDark: '/images/providers/anthropic-logo-dark.svg',
16 + languages: ['Python', 'TypeScript'],
17 + },
18 + {
19 + name: 'OpenAI', href: '/docs/providers/openai',
20 + logo: '/images/providers/openai-logo.svg', logoDark: '/images/providers/openai-logo-dark.svg',
21 + languages: ['Python', 'TypeScript'],
22 + },
23 + {
24 + name: 'Vercel AI SDK', href: '/docs/providers/vercel',
25 + logo: '/images/providers/vercel-logo.svg', logoDark: '/images/providers/vercel-logo-dark.svg',
26 + languages: ['TypeScript'],
27 + },
28 + {
29 + name: 'Google', href: '/docs/providers/google',
30 + logo: '/images/providers/google-logo.svg', languages: ['Python', 'TypeScript'],
31 + },
32 + { name: 'TypeSafe', href: '/docs/providers/typesafe', languages: ['Python', 'TypeScript'] },
33 + {
34 + name: 'Cloudflare Workers AI',
35 + href: 'https://github.com/ComposioHQ/composio/blob/next/ts/packages/providers/cloudflare/README.md',
36 + languages: ['TypeScript'],
37 + },
38 + ],
39 + 'agent-frameworks': [
40 + { name: 'OpenAI Agents SDK', href: '/docs/providers/openai', languages: ['Python', 'TypeScript'] },
41 + { name: 'Claude Agent SDK', href: '/docs/providers/anthropic', languages: ['Python', 'TypeScript'] },
42 + { name: 'Google ADK', href: '/docs/providers/google', languages: ['Python'] },
43 + {
44 + name: 'LangChain', href: '/docs/providers/langchain',
45 + logo: '/images/providers/langchain-logo.svg', logoDark: '/images/providers/langchain-logo-dark.svg',
46 + languages: ['Python', 'TypeScript'],
47 + },
48 + { name: 'LangGraph', href: '/docs/providers/langchain', languages: ['Python'] },
49 + {
50 + name: 'CrewAI', href: '/docs/providers/crewai',
51 + logo: '/images/providers/crewai-logo.svg', languages: ['Python'],
52 + },
53 + {
54 + name: 'LlamaIndex', href: '/docs/providers/llamaindex',
55 + logo: '/images/providers/llamaIndex-logo.svg', languages: ['Python', 'TypeScript'],
56 + },
57 + {
58 + name: 'Mastra', href: '/docs/providers/mastra',
59 + logo: '/images/providers/mastra-logo.svg', logoDark: '/images/providers/mastra-logo-dark.svg',
60 + languages: ['TypeScript'],
61 + },
62 + {
63 + name: 'Pi', href: '/docs/providers/pi',
64 + logo: '/images/providers/pi-logo.svg', logoDark: '/images/providers/pi-logo-dark.svg',
65 + languages: ['TypeScript'], experimental: true,
66 + },
67 + { name: 'Eve', href: '/docs/providers/eve', languages: ['TypeScript'], experimental: true },
68 + { name: 'AutoGen', href: '/docs/providers/autogen', languages: ['Python'] },
69 + ],
70 + custom: [
71 + { name: 'Build your own', href: '/docs/providers/custom-providers', languages: ['Python', 'TypeScript'] },
72 + ],
73 +};
74 +
75 +export type ProviderGroup = keyof typeof PROVIDERS;
76 +
77 +export function providerListMarkdown(group: ProviderGroup): string {
78 + return PROVIDERS[group].map(provider =>
79 + `- [${provider.name}](${provider.href}) (${provider.languages.join(', ')}${provider.experimental ? '; experimental' : ''})`,
80 + ).join('\n');
81 +}
docs/lib/source.ts
+4 -3
@@ -32,6 +32,7 @@ import { promptFor, SETUP_PROMPT } from './agent-prompts';
32 import { AGENTS } from './agent-setup-clients';
33 import { HOME_OG_DESCRIPTION } from './toolkit-count';
34 import { componentsToMarkdown } from './example-document';
35 +import { providerListMarkdown } from './providers';
36
37 /**
38 * True if a reference URL belongs to an intentionally-hidden API tag
@@ -418,8 +419,8 @@ export function mdxToCleanMarkdown(content: string, url?: string): string {
419 result = result.replace(/<\/?Cards\b[^>]*>/g, '');
420
421 result = result.replace(
421 - /<ProviderCard[\s\S]*?name="([^"]*)"[\s\S]*?href="([^"]*)"[\s\S]*?languages=\{\[([^\]]*)\]\}[\s\S]*?\/>/g,
422 - (_, name, href, langs) => `- [${name}](${href}) (${langs.replace(/"/g, '')})`
422 + /<ProviderList\s+group="(ai-sdks|agent-frameworks|custom)"\s*\/>/g,
423 + (_, group: 'ai-sdks' | 'agent-frameworks' | 'custom') => providerListMarkdown(group),
424 );
425
426 result = result.replace(/^[ \t]+(- \[)/gm, '$1');
@@ -540,7 +541,7 @@ export function mdxToCleanMarkdown(content: string, url?: string): string {
541 result = replaceRepoBrowserMarkdown(result);
542
543 result = result.replace(
543 - /<\/?(ProviderGrid|Tabs|Frame|div|QuickstartFlow|IntegrationTabs|Accordions|ToolTypeFlow|ToolkitsLanding|TemplateGrid|Glossary|ConnectFlow|ConnectClientOption)[^>]*>/g,
544 + /<\/?(Tabs|Frame|div|QuickstartFlow|IntegrationTabs|Accordions|ToolTypeFlow|ToolkitsLanding|TemplateGrid|Glossary|ConnectFlow|ConnectClientOption)[^>]*>/g,
545 ''
546 );
547
docs/mdx-components.tsx
+2 -3
@@ -9,7 +9,7 @@ import { Card, Cards } from 'fumadocs-ui/components/card';
9 import { ImageZoom } from 'fumadocs-ui/components/image-zoom';
10 import { Heading } from '@/components/heading';
11 import { YouTube } from '@/components/youtube';
12 -import { ProviderCard, ProviderGrid } from '@/components/provider-card';
12 +import { ProviderList } from '@/components/provider-list';
13 import { FrameworkSelector, QuickstartFlow, FrameworkOption } from '@/components/quickstart';
14 import { IntegrationTabs, IntegrationContent } from '@/components/quickstart/integration-tabs';
15 import { ToolTypeFlow, ToolTypeOption } from '@/components/tool-type-selector';
@@ -113,8 +113,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
113 Steps,
114 Card,
115 Cards,
116 - ProviderCard,
117 - ProviderGrid,
116 + ProviderList,
117 FrameworkSelector,
118 QuickstartFlow,
119 FrameworkOption,
docs/tests/integration/providers.test.ts new
+53
@@ -0,0 +1,53 @@
1 +import { expect, test } from 'bun:test';
2 +import { fetchPage } from './helpers';
3 +
4 +async function providerLinks(html: string): Promise<Map<string, string>> {
5 + const links = new Map<string, string>();
6 + let href = '';
7 + await new HTMLRewriter()
8 + .on('article ul > li > a', {
9 + element(element) {
10 + const target = element.getAttribute('href') ?? '';
11 + href = target.startsWith('/docs/providers/') || target.includes('/ts/packages/providers/cloudflare/')
12 + ? target : '';
13 + },
14 + text(text) {
15 + if (href) links.set(href, (links.get(href) ?? '') + text.text);
16 + },
17 + })
18 + .transform(new Response(html))
19 + .text();
20 + return links;
21 +}
22 +
23 +test('providers are semantic linked lists in server HTML and processed Markdown', async () => {
24 + const htmlResponse = await fetchPage('/docs/providers', { timeout: 120_000 });
25 + expect(htmlResponse.status).toBe(200);
26 + expect(htmlResponse.headers.get('content-type')).toContain('text/html');
27 + const html = await htmlResponse.text();
28 + const links = await providerLinks(html);
29 +
30 + const markdownResponse = await fetchPage('/docs/providers.md', { timeout: 120_000 });
31 + expect(markdownResponse.status).toBe(200);
32 + expect(markdownResponse.headers.get('content-type')).toContain('text/markdown');
33 + const markdown = await markdownResponse.text();
34 + const providerSection = markdown.split('## AI SDKs')[1]?.split('More documentation')[0] ?? '';
35 + const markdownLinks = Array.from(providerSection.matchAll(/^- \[([^\]]+)\]\(([^)]+)\)/gm));
36 + expect([...links.keys()].sort()).toEqual([...new Set(markdownLinks.map(match => match[2]))].sort());
37 + for (const [, name, href] of markdownLinks) expect(links.get(href), href).toContain(name);
38 + for (const [name, slug] of [
39 + ['Anthropic', 'anthropic'], ['OpenAI Agents SDK', 'openai'],
40 + ['Claude Agent SDK', 'anthropic'], ['Google ADK', 'google'],
41 + ['LangGraph', 'langchain'], ['Eve', 'eve'], ['Build your own', 'custom-providers'],
42 + ]) {
43 + expect(links.get(`/docs/providers/${slug}`)).toContain(name);
44 + expect(providerSection).toContain(`[${name}](/docs/providers/${slug})`);
45 + }
46 + for (const slug of ['pi', 'eve']) {
47 + expect(links.get(`/docs/providers/${slug}`)).toContain('Experimental');
48 + expect(providerSection).toContain(`](/docs/providers/${slug}) (TypeScript; experimental)`);
49 + }
50 + expect(providerSection).not.toMatch(/ProviderList|languages=|\/>/);
51 + expect(links.get('https://github.com/ComposioHQ/composio/blob/next/ts/packages/providers/cloudflare/README.md'))
52 + .toContain('Cloudflare Workers AI');
53 +}, 180_000);
docs/tests/static/providers.test.ts new
+43
@@ -0,0 +1,43 @@
1 +import { expect, test } from 'bun:test';
2 +import { source, mdxToCleanMarkdown } from '../../lib/source';
3 +import { GET as getRoutingMap } from '../../app/llms.txt/route';
4 +
5 +function providersPage() {
6 + const page = source.getPage(['providers']);
7 + if (!page) throw new Error('Missing providers page');
8 + return page;
9 +}
10 +
11 +test('provider Markdown exposes every current guide and the adapters sharing guides', async () => {
12 + const markdown = mdxToCleanMarkdown(await providersPage().data.getText('raw'));
13 + const destinations = new Set(Array.from(
14 + markdown.matchAll(/^- \[[^\]]+\]\((\/docs\/providers\/[^)]+)\)/gm), match => match[1],
15 + ));
16 + const guides = source.getPages().filter(page =>
17 + page.slugs[0] === 'providers' && page.slugs.length === 2,
18 + );
19 + expect([...destinations].sort()).toEqual(guides.map(page => page.url).sort());
20 +
21 + // These adapters share vendor guides and cannot be discovered from titles alone.
22 + for (const [name, guide] of [
23 + ['OpenAI Agents SDK', 'openai'],
24 + ['Claude Agent SDK', 'anthropic'],
25 + ['Google ADK', 'google'],
26 + ['LangGraph', 'langchain'],
27 + ]) {
28 + expect(markdown).toContain(`[${name}](/docs/providers/${guide})`);
29 + }
30 + expect(markdown).toContain('[Anthropic](/docs/providers/anthropic) (Python, TypeScript)');
31 + for (const slug of ['pi', 'eve']) {
32 + expect(markdown).toContain(`](/docs/providers/${slug}) (TypeScript; experimental)`);
33 + }
34 + expect(markdown).not.toMatch(/ProviderList|languages=|\/>/);
35 + expect(markdown).toContain('[Cloudflare Workers AI](https://github.com/ComposioHQ/composio/blob/next/ts/packages/providers/cloudflare/README.md) (TypeScript)');
36 +});
37 +
38 +test('concise discovery routes OpenAI and Anthropic readers to owned guides', async () => {
39 + const text = await getRoutingMap().text();
40 + for (const slug of ['openai', 'anthropic']) {
41 + expect(text).toContain(`](https://docs.composio.dev/docs/providers/${slug}.md)`);
42 + }
43 +});