@devries-cameron20 / composio-1 / commits / 9acfa852b
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: tidy welcome page, fix playground link, hide ugly Ask AI tab (#3455)

## Summary Three small docs polishes: - **Hide the disgusting "Ask AI" side tab.** The Decimal widget renders its own `.decimal-widget-sidebar-tab` launcher (vertical pill with sideways text) on every page. We already trigger the widget from our own "Ask AI" button in the nav, so the third-party launcher is redundant *and* ugly. Hidden via CSS in `app/global.css`. - **Fix the Playground nav link.** It pointed at `platform.composio.dev/auth?next_page=/tool-router` — which (a) hits a dead host now that platform has moved to `dashboard.composio.dev`, and (b) lost the playground's connect check on the redirect. Repointed to `https://dashboard.composio.dev/~/project/playground`, which is the dashboard's smart-resolver route: it handles login (`?next=`), looks up `last_visited` / default org+project, and lands the user on `/{org}/{project}/playground` with the connect step intact. Same fix applied to the toolkits landing CTA and the welcome-page Playground card. - **Trim the welcome page.** Dropped the duplicated intro Cards row, the "Get Started" / "Explore" / "Features" / "Community" headers, and the secondary Features grid. Now it's: intro → AIToolsBanner → Quickstart → Toolkits + Playground → Providers. Much cleaner. ## Test plan - [ ] `bun run scripts/validate-links.ts` passes (already verified locally — 0 errors) - [ ] On preview deploy, the side "Ask AI" tab is gone - [ ] Clicking "Playground" in the nav (logged out) lands on login → playground; (logged in) lands on `/{org}/{project}/playground` - [ ] Welcome page renders without missing-icon errors 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Rahul Tarak committed May 19, 2026 at 04:09 UTC 9acfa852b2f77f7838201b1036aa2628934b54e3
76 files changed +1199 -1530
docs/app/(home)/docs/[[...slug]]/page.tsx
+15 -3
@@ -9,6 +9,7 @@ import { getMDXComponents } from '@/mdx-components';
9 import type { Metadata } from 'next';
10 import { createRelativeLink } from 'fumadocs-ui/mdx';
11 import { PageActions } from '@/components/page-actions';
12 +import { EditOnGitHub } from '@/components/edit-on-github';
13
14 export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
15 const params = await props.params;
@@ -18,11 +19,21 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
19 // eslint-disable-next-line @typescript-eslint/no-explicit-any
20 const data = page.data as any;
21 const MDX = data.body;
22 + const isLanding = !params.slug || params.slug.length === 0;
23
24 return (
23 - <DocsPage toc={data.toc} full={data.full} footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
24 - <DocsTitle>{data.title}</DocsTitle>
25 - <PageActions path={page.url} />
25 + <DocsPage
26 + toc={data.toc}
27 + full={isLanding ? true : data.full}
28 + footer={{ enabled: false }}
29 + tableOfContentPopover={{ enabled: false }}
30 + >
31 + {!isLanding && (
32 + <>
33 + <DocsTitle>{data.title}</DocsTitle>
34 + <PageActions path={page.url} />
35 + </>
36 + )}
37 <DocsBody>
38 <MDX
39 components={getMDXComponents({
@@ -30,6 +41,7 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
41 a: createRelativeLink(source, page),
42 })}
43 />
44 + {!isLanding && <EditOnGitHub path={`docs/content/docs/${page.path}`} />}
45 </DocsBody>
46 </DocsPage>
47 );
docs/app/(home)/docs/changelog/[...slug]/page.tsx
+4
@@ -10,6 +10,7 @@ import { notFound } from 'next/navigation';
10 import Link from 'next/link';
11 import { ChevronLeft } from 'lucide-react';
12 import { PageActions } from '@/components/page-actions';
13 +import { EditOnGitHub } from '@/components/edit-on-github';
14
15 const mdxComponents = getMDXComponents();
16
@@ -66,6 +67,9 @@ export default async function ChangelogEntryPage({ params }: PageProps) {
67 );
68 })}
69 </div>
70 + {matchingEntries[0] && (
71 + <EditOnGitHub path={`docs/content/changelog/${matchingEntries[0].info.path}`} />
72 + )}
73 </DocsBody>
74 </DocsPage>
75 );
docs/app/(home)/docs/changelog/page.tsx
+3 -1
@@ -27,6 +27,7 @@ import {
27 } from 'fumadocs-ui/layouts/docs/page';
28 import { CopyLink } from '@/components/copy-link';
29 import { PageActions } from '@/components/page-actions';
30 +import { EditOnGitHub } from '@/components/edit-on-github';
31
32 const mdxComponents = getMDXComponents();
33
@@ -54,7 +55,7 @@ export default function ChangelogPage() {
55 <div className="mb-3 md:absolute md:left-0 md:w-28 md:text-right md:pr-6">
56 <CopyLink
57 href={dateToChangelogUrl(entry.date)}
57 - className="text-sm font-medium text-orange-500 hover:text-orange-600 transition-colors"
58 + className="text-sm font-medium text-blue-500 hover:text-blue-600 transition-colors"
59 >
60 {formatDate(entry.date)}
61 </CopyLink>
@@ -77,6 +78,7 @@ export default function ChangelogPage() {
78 })}
79 </div>
80 </div>
81 + <EditOnGitHub path="docs/app/(home)/docs/changelog/page.tsx" />
82 </DocsBody>
83 </DocsPage>
84 );
docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx
+14 -9
@@ -11,6 +11,7 @@ import type { Metadata } from 'next';
11 import { createRelativeLink } from 'fumadocs-ui/mdx';
12 import type { ApiPageProps } from 'fumadocs-openapi/ui';
13 import { PageActions } from '@/components/page-actions';
14 +import { EditOnGitHub } from '@/components/edit-on-github';
15 import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';
16
17 interface OpenAPIPageData {
@@ -37,17 +38,20 @@ export default async function Page({
38 : null;
39 return (
40 <DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
40 - <h1 className="text-2xl font-semibold mb-4">
41 - {pageData.title}
42 - {detectedVersion && (
43 - <span className="ml-2 align-middle">
44 - <VersionBadge version={detectedVersion} />
45 - </span>
46 - )}
47 - </h1>
48 - <PageActions path={page.url} />
41 + <div className="mb-4 flex items-start justify-between gap-4">
42 + <h1 className="text-2xl font-semibold">
43 + {pageData.title}
44 + {detectedVersion && (
45 + <span className="ml-2 align-middle">
46 + <VersionBadge version={detectedVersion} />
47 + </span>
48 + )}
49 + </h1>
50 + <PageActions path={page.url} variant="inline" />
51 + </div>
52 <DocsBody>
53 <APIPage {...apiProps} />
54 + <EditOnGitHub path={`docs/content/reference/${page.path}`} />
55 </DocsBody>
56 </DocsPage>
57 );
@@ -68,6 +72,7 @@ export default async function Page({
72 a: createRelativeLink(referenceSource as any, page),
73 })}
74 />
75 + <EditOnGitHub path={`docs/content/reference/${page.path}`} />
76 </DocsBody>
77 </DocsPage>
78 );
docs/app/(home)/reference/v3/[[...slug]]/page.tsx
+14 -9
@@ -11,6 +11,7 @@ import type { Metadata } from 'next';
11 import { createRelativeLink } from 'fumadocs-ui/mdx';
12 import type { ApiPageProps } from 'fumadocs-openapi/ui';
13 import { PageActions } from '@/components/page-actions';
14 +import { EditOnGitHub } from '@/components/edit-on-github';
15 import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';
16
17 interface OpenAPIPageData {
@@ -45,17 +46,20 @@ export default async function Page({
46 : null;
47 return (
48 <DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
48 - <h1 className="text-2xl font-semibold mb-4">
49 - {pageData.title}
50 - {detectedVersion && (
51 - <span className="ml-2 align-middle">
52 - <VersionBadge version={detectedVersion} />
53 - </span>
54 - )}
55 - </h1>
56 - <PageActions path={page.url} />
49 + <div className="mb-4 flex items-start justify-between gap-4">
50 + <h1 className="text-2xl font-semibold">
51 + {pageData.title}
52 + {detectedVersion && (
53 + <span className="ml-2 align-middle">
54 + <VersionBadge version={detectedVersion} />
55 + </span>
56 + )}
57 + </h1>
58 + <PageActions path={page.url} variant="inline" />
59 + </div>
60 <DocsBody>
61 <APIPage {...apiProps} />
62 + <EditOnGitHub path={`docs/content/reference/${page.path}`} />
63 </DocsBody>
64 </DocsPage>
65 );
@@ -76,6 +80,7 @@ export default async function Page({
80 a: createRelativeLink(referenceSource as any, page),
81 })}
82 />
83 + <EditOnGitHub path={`docs/content/reference/${page.path}`} />
84 </DocsBody>
85 </DocsPage>
86 );
docs/app/(home)/toolkits/[[...slug]]/page.tsx
+7 -3
@@ -4,6 +4,7 @@ import { getMDXComponents } from '@/mdx-components';
4 import { ToolkitDetail } from '@/components/toolkits/toolkit-detail';
5 import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
6 import { PageActions } from '@/components/page-actions';
7 +import { EditOnGitHub } from '@/components/edit-on-github';
8 import { readFile } from 'fs/promises';
9 import { join } from 'path';
10 import { getAllToolkits, getToolkitBySlug } from '@/lib/toolkit-data';
@@ -209,11 +210,14 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
210 return (
211 <div>
212 <a href="/toolkits" className="text-sm text-fd-muted-foreground no-underline hover:text-fd-foreground hover:underline">← All Toolkits</a>
212 - <h1 className="mt-2 text-3xl font-bold text-fd-foreground">{page.data.title}</h1>
213 - <PageActions path={page.url} />
214 - <article className="prose prose-fd max-w-none">
213 + <div className="mt-2 flex items-start justify-between gap-4">
214 + <h1 className="text-3xl font-bold text-fd-foreground">{page.data.title}</h1>
215 + <PageActions path={page.url} variant="inline" />
216 + </div>
217 + <article className="prose prose-fd mt-6 max-w-none">
218 <MDXContent components={getMDXComponents()} />
219 </article>
220 + <EditOnGitHub path={`docs/content/toolkits/${page.path}`} />
221 </div>
222 );
223 }
docs/app/global.css
+131 -65
@@ -9,19 +9,20 @@
9 /* ==========================================================================
10 COMPOSIO DOCS
11
12 - Palette:
13 - - Light: Content #ffffff, Sidebar #f7f5f2
14 - - Dark: Content #1a1815, Sidebar #252220
15 - - Accent: #ea580c (Tailwind orange-600)
12 + Palette (synced with ~/composio/landing + ~/composio/composio_dashboard):
13 + - Brand: #0007cd / oklch(0.387 0.264 264.1) — deep electric blue
14 + - Light: Content #fbfbfb, Card #ffffff
15 + - Dark: Content #0f0f0f, Card #1a1a1a
16
17 Typography:
18 - - All text: Inter
19 - - Code: IBM Plex Mono
18 + - All text: ABC Diatype (sans, loaded locally in app/layout.tsx)
19 + - Code: JetBrains Mono
20 ========================================================================== */
21
22 @theme inline {
23 - --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
24 - --radius: 0.625rem;
23 + --font-sans: var(--font-sans), ui-sans-serif, system-ui, sans-serif;
24 + --font-mono: var(--font-mono), ui-monospace, SFMono-Regular, Menlo, monospace;
25 + --radius: 0;
26 --color-sidebar-ring: var(--sidebar-ring);
27 --color-sidebar-border: var(--sidebar-border);
28 --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
@@ -75,46 +76,47 @@ html {
76 }
77
78 :root {
78 - /* Brand */
79 - --composio-orange: #ea580c;
80 - --composio-sidebar: #f7f5f2;
79 + /* Brand — deep electric blue, shared with composio.dev + dashboard */
80 + --composio-brand: #0007cd;
81 + --composio-orange: var(--composio-brand); /* legacy alias — kept for back-compat */
82 + --composio-sidebar: #fbfbfb;
83
84 /* Fumadocs overrides - Light */
83 - --color-fd-background: #ffffff;
84 - --color-fd-foreground: #171414;
85 - --color-fd-muted: #f6f4f2;
86 - --color-fd-muted-foreground: #5c5858; /* Improved contrast */
87 - --color-fd-border: #e5e0df;
85 + --color-fd-background: #fbfbfb;
86 + --color-fd-foreground: #0f0f0f;
87 + --color-fd-muted: #f3f3f3;
88 + --color-fd-muted-foreground: #585858;
89 + --color-fd-border: #e5e5e5;
90 --color-fd-card: #ffffff;
89 - --color-fd-card-foreground: #171414;
91 + --color-fd-card-foreground: #0f0f0f;
92 --color-fd-popover: #ffffff;
91 - --color-fd-popover-foreground: #171414;
92 - --color-fd-primary: #171414;
93 - --color-fd-primary-foreground: #ffffff;
94 - --color-fd-secondary: #f6f4f2;
95 - --color-fd-secondary-foreground: #171414;
96 - --color-fd-accent: #f6f4f2;
97 - --color-fd-accent-foreground: #171414;
98 - --color-fd-ring: #e5e0df;
99 - --radius: 0.625rem;
100 - --background: oklch(1 0 0);
101 - --foreground: oklch(0.145 0 0);
93 + --color-fd-popover-foreground: #0f0f0f;
94 + --color-fd-primary: #0f0f0f;
95 + --color-fd-primary-foreground: #fbfbfb;
96 + --color-fd-secondary: #f3f3f3;
97 + --color-fd-secondary-foreground: #0f0f0f;
98 + --color-fd-accent: #f3f3f3;
99 + --color-fd-accent-foreground: #0f0f0f;
100 + --color-fd-ring: var(--composio-brand);
101 + --radius: 0;
102 + --background: oklch(0.985 0 0);
103 + --foreground: oklch(0.218 0 0);
104 --card: oklch(1 0 0);
103 - --card-foreground: oklch(0.145 0 0);
105 + --card-foreground: oklch(0.218 0 0);
106 --popover: oklch(1 0 0);
105 - --popover-foreground: oklch(0.145 0 0);
106 - --primary: oklch(0.205 0 0);
107 - --primary-foreground: oklch(0.985 0 0);
107 + --popover-foreground: oklch(0.218 0 0);
108 + --primary: oklch(0.387 0.264 264.1);
109 + --primary-foreground: oklch(1 0 0);
110 --secondary: oklch(0.97 0 0);
109 - --secondary-foreground: oklch(0.205 0 0);
111 + --secondary-foreground: oklch(0.218 0 0);
112 --muted: oklch(0.97 0 0);
111 - --muted-foreground: oklch(0.556 0 0);
113 + --muted-foreground: oklch(0.51 0 0);
114 --accent: oklch(0.97 0 0);
113 - --accent-foreground: oklch(0.205 0 0);
114 - --destructive: oklch(0.577 0.245 27.325);
115 - --border: oklch(0.922 0 0);
116 - --input: oklch(0.922 0 0);
117 - --ring: oklch(0.708 0 0);
115 + --accent-foreground: oklch(0.218 0 0);
116 + --destructive: oklch(0.577 0.215 27.3);
117 + --border: oklch(0.931 0 0);
118 + --input: oklch(0.931 0 0);
119 + --ring: oklch(0.387 0.264 264.1);
120 --chart-1: oklch(0.646 0.222 41.116);
121 --chart-2: oklch(0.6 0.118 184.704);
122 --chart-3: oklch(0.398 0.07 227.392);
@@ -131,43 +133,43 @@ html {
133 }
134
135 .dark {
134 - --composio-sidebar: #131211;
136 + --composio-sidebar: #0f0f0f;
137
138 /* Fumadocs overrides - Dark */
137 - --color-fd-background: #131211;
138 - --color-fd-foreground: #e8e4e0;
139 - --color-fd-muted: #1e1d1c;
140 - --color-fd-muted-foreground: #a8a29e; /* Improved contrast */
141 - --color-fd-border: #2c2a28;
142 - --color-fd-card: #131211;
143 - --color-fd-card-foreground: #e8e4e0;
144 - --color-fd-popover: #252220;
145 - --color-fd-popover-foreground: #e8e4e0;
146 - --color-fd-primary: #e8e4e0;
147 - --color-fd-primary-foreground: #1a1815;
148 - --color-fd-secondary: #2a2725;
149 - --color-fd-secondary-foreground: #e8e4e0;
150 - --color-fd-accent: #2a2725;
151 - --color-fd-accent-foreground: #e8e4e0;
152 - --color-fd-ring: #3d3935;
153 - --background: oklch(0.145 0 0);
139 + --color-fd-background: #0f0f0f;
140 + --color-fd-foreground: #fbfbfb;
141 + --color-fd-muted: #1a1a1a;
142 + --color-fd-muted-foreground: #b4b4b4;
143 + --color-fd-border: rgba(255, 255, 255, 0.10);
144 + --color-fd-card: #141414;
145 + --color-fd-card-foreground: #fbfbfb;
146 + --color-fd-popover: #1a1a1a;
147 + --color-fd-popover-foreground: #fbfbfb;
148 + --color-fd-primary: #fbfbfb;
149 + --color-fd-primary-foreground: #0f0f0f;
150 + --color-fd-secondary: #1a1a1a;
151 + --color-fd-secondary-foreground: #fbfbfb;
152 + --color-fd-accent: #1a1a1a;
153 + --color-fd-accent-foreground: #fbfbfb;
154 + --color-fd-ring: var(--composio-brand);
155 + --background: oklch(0.159 0 0);
156 --foreground: oklch(0.985 0 0);
155 - --card: oklch(0.205 0 0);
157 + --card: oklch(0.218 0 0);
158 --card-foreground: oklch(0.985 0 0);
157 - --popover: oklch(0.205 0 0);
159 + --popover: oklch(0.218 0 0);
160 --popover-foreground: oklch(0.985 0 0);
159 - --primary: oklch(0.922 0 0);
160 - --primary-foreground: oklch(0.205 0 0);
161 + --primary: oklch(0.985 0 0);
162 + --primary-foreground: oklch(0.218 0 0);
163 --secondary: oklch(0.269 0 0);
164 --secondary-foreground: oklch(0.985 0 0);
165 --muted: oklch(0.269 0 0);
164 - --muted-foreground: oklch(0.708 0 0);
166 + --muted-foreground: oklch(0.706 0 0);
167 --accent: oklch(0.269 0 0);
168 --accent-foreground: oklch(0.985 0 0);
167 - --destructive: oklch(0.704 0.191 22.216);
168 - --border: oklch(1 0 0 / 5%);
169 + --destructive: oklch(0.637 0.208 25.3);
170 + --border: oklch(1 0 0 / 10%);
171 --input: oklch(1 0 0 / 15%);
170 - --ring: oklch(0.556 0 0);
172 + --ring: oklch(0.745 0.128 275);
173 --chart-1: oklch(0.488 0.243 264.376);
174 --chart-2: oklch(0.696 0.17 162.48);
175 --chart-3: oklch(0.769 0.188 70.08);
@@ -361,6 +363,18 @@ textarea:focus-visible {
363 border-radius: 0 var(--radius) var(--radius) 0;
364 }
365
366 +/* Callouts — muted links, not brand accent */
367 +[data-fumadocs-body] [data-callout] a:not([data-card]) {
368 + color: inherit;
369 + text-decoration: underline;
370 + text-underline-offset: 2px;
371 + text-decoration-color: var(--color-fd-border);
372 +}
373 +
374 +[data-fumadocs-body] [data-callout] a:not([data-card]):hover {
375 + text-decoration-color: currentColor;
376 +}
377 +
378 /* ==========================================================================
379 Header Components
380 ========================================================================== */
@@ -565,6 +579,13 @@ body {
579 transition: max-width 0.3s ease;
580 }
581
582 +/* Hide Decimal's built-in launcher tab and floating button — we trigger
583 + the widget from our own "Ask AI" button in the nav (see ask-ai-button.tsx). */
584 +.decimal-widget-sidebar-tab,
585 +.decimal-widget-button {
586 + display: none !important;
587 +}
588 +
589 @layer base {
590 * {
591 @apply border-border outline-ring/50;
@@ -573,3 +594,48 @@ body {
594 @apply bg-background text-foreground;
595 }
596 }
597 +
598 +/* ==========================================================================
599 + 404 glitch animation (ported from landing site)
600 + ========================================================================== */
601 +@keyframes glitch-404 {
602 + 0%,
603 + 3% {
604 + text-shadow: none;
605 + transform: translate(0);
606 + }
607 + 6% {
608 + text-shadow:
609 + 3px 0 var(--composio-brand),
610 + -3px 0 #cd0700;
611 + transform: translate(-3px, 1px);
612 + }
613 + 12% {
614 + text-shadow:
615 + -3px 0 var(--composio-brand),
616 + 3px 0 #cd0700;
617 + transform: translate(3px, -1px);
618 + }
619 + 18% {
620 + text-shadow:
621 + 2px 0 var(--composio-brand),
622 + -2px 0 #cd0700;
623 + transform: translate(-1px, 2px);
624 + }
625 + 24% {
626 + text-shadow:
627 + -1px 0 var(--composio-brand),
628 + 1px 0 #cd0700;
629 + transform: translate(2px, -1px);
630 + }
631 + 30%,
632 + 100% {
633 + text-shadow: none;
634 + transform: translate(0);
635 + }
636 +}
637 +
638 +.animate-glitch-404 {
639 + animation: glitch-404 2.6s ease-out infinite;
640 +}
641 +
docs/app/layout.tsx
+12 -8
@@ -2,7 +2,8 @@ import { RootProvider } from 'fumadocs-ui/provider/next';
2 import type { Metadata } from 'next';
3 import { Analytics } from '@vercel/analytics/next';
4 import './global.css';
5 -import { Inter, IBM_Plex_Mono } from 'next/font/google';
5 +import { JetBrains_Mono } from 'next/font/google';
6 +import localFont from 'next/font/local';
7 import { PostHogProvider } from '@/components/posthog-provider';
8 import { DecimalWidget } from '@/components/decimal-widget';
9 import CustomSearchDialog from '@/components/custom-search-dialog';
@@ -46,15 +47,17 @@ export const metadata: Metadata = {
47 },
48 };
49
49 -const inter = Inter({
50 - weight: ['400', '500', '600', '700'],
51 - subsets: ['latin'],
50 +const abcDiatype = localFont({
51 + src: [
52 + { path: '../public/fonts/ABCDiatype-Regular.woff2', weight: '400', style: 'normal' },
53 + { path: '../public/fonts/ABCDiatype-RegularItalic.woff2', weight: '400', style: 'italic' },
54 + { path: '../public/fonts/ABCDiatype-Medium.woff2', weight: '500', style: 'normal' },
55 + ],
56 variable: '--font-sans',
57 display: 'swap',
58 });
59
56 -const ibmPlexMono = IBM_Plex_Mono({
57 - weight: ['400', '500', '600'],
60 +const jetbrainsMono = JetBrains_Mono({
61 subsets: ['latin'],
62 variable: '--font-mono',
63 display: 'swap',
@@ -64,7 +67,7 @@ export default function Layout({ children }: LayoutProps<'/'>) {
67 return (
68 <html
69 lang="en"
67 - className={`${inter.variable} ${ibmPlexMono.variable}`}
70 + className={`${abcDiatype.variable} ${jetbrainsMono.variable}`}
71 suppressHydrationWarning
72 >
73 <head>
@@ -111,7 +114,8 @@ export default function Layout({ children }: LayoutProps<'/'>) {
114 theme={{
115 defaultTheme: 'light',
116 attribute: 'class',
114 - enableSystem: true,
117 + enableSystem: false,
118 + forcedTheme: 'light',
119 }}
120 search={{
121 SearchDialog: CustomSearchDialog,
docs/app/not-found.tsx
+36 -39
@@ -33,65 +33,62 @@ async function log404ToDatadog(path: string, referer: string | null) {
33 export default async function NotFound() {
34 const headersList = await headers();
35 const referer = headersList.get('referer');
36 - const path = headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';
36 + const path =
37 + headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';
38
39 // Fire and forget - don't block rendering
40 log404ToDatadog(path, referer);
41
42 return (
42 - <div className="flex min-h-[85vh] flex-col items-center justify-center px-4">
43 - <div className="relative">
44 - {/* Subtle gradient glow */}
45 - <div className="absolute -inset-4 rounded-full bg-gradient-to-r from-fd-primary/20 via-fd-primary/5 to-transparent blur-2xl" />
46 - <h1 className="relative text-[120px] sm:text-[150px] font-bold leading-none tracking-tighter text-fd-foreground/10 select-none">
47 - 404
48 - </h1>
43 + <div className="relative flex min-h-[85vh] flex-col items-center justify-center overflow-hidden px-4">
44 + {/* Faint giant background 404 */}
45 + <div
46 + aria-hidden="true"
47 + className="pointer-events-none absolute inset-0 flex select-none items-center justify-center text-fd-foreground/[0.04] dark:text-white/[0.04]"
48 + style={{
49 + fontSize: 'clamp(200px, 30vw, 500px)',
50 + fontWeight: 500,
51 + lineHeight: 1,
52 + letterSpacing: '-0.04em',
53 + }}
54 + >
55 + 404
56 </div>
57
51 - <div className="mt-2 text-center max-w-md">
52 - <h2 className="text-xl font-semibold text-fd-foreground">
58 + {/* Foreground glitch 404 */}
59 + <h1
60 + aria-label="404 — Page not found"
61 + className="animate-glitch-404 relative font-sans text-[96px] font-medium leading-none tracking-tighter text-fd-foreground sm:text-[128px]"
62 + >
63 + 404
64 + </h1>
65 +
66 + <div className="relative mt-6 text-center max-w-md">
67 + <h2 className="font-mono text-sm uppercase tracking-[-0.28px] text-fd-muted-foreground">
68 Page not found
69 </h2>
55 - <p className="mt-2 text-fd-muted-foreground text-sm">
56 - This page doesn&apos;t exist or may have moved.
70 + <p className="mt-3 font-mono text-sm leading-relaxed text-fd-muted-foreground">
71 + The page you&apos;re looking for doesn&apos;t exist or has moved.
72 <br />
73 <span className="text-fd-muted-foreground/70">
59 - Press <kbd className="mx-1 rounded border border-fd-border bg-fd-muted px-1.5 py-0.5 font-mono text-[10px]">⌘K</kbd> to search.
74 + Press{' '}
75 + <kbd className="mx-1 rounded border border-fd-border bg-fd-muted px-1.5 py-0.5 font-mono text-[10px]">
76 + ⌘K
77 + </kbd>{' '}
78 + to search.
79 </span>
80 </p>
81 </div>
82
64 - {/* Quick links */}
65 - <div className="mt-8 flex flex-wrap justify-center gap-3">
83 + <div className="relative mt-8">
84 <Link
85 href="/docs"
68 - className="inline-flex items-center gap-2 rounded-lg bg-fd-primary px-4 py-2 text-sm font-medium text-fd-primary-foreground transition-colors hover:bg-fd-primary/90"
86 + className="group inline-flex items-center gap-1.5 bg-[var(--composio-brand)] px-4 py-2.5 font-mono text-sm uppercase tracking-[-0.28px] text-white no-underline transition-colors hover:bg-[#0006a8]"
87 + style={{ color: '#ffffff' }}
88 >
70 - Documentation
71 - </Link>
72 - <Link
73 - href="/"
74 - className="inline-flex items-center gap-2 rounded-lg border border-fd-border bg-fd-background px-4 py-2 text-sm font-medium transition-colors hover:bg-fd-accent"
75 - >
76 - Home
89 + <span style={{ color: '#ffffff' }}>Back to docs</span>
90 </Link>
91 </div>
79 -
80 - {/* Secondary links */}
81 - <nav className="mt-10 flex flex-wrap justify-center gap-x-6 gap-y-2 text-sm text-fd-muted-foreground">
82 - <Link href="/docs/quickstart" className="hover:text-fd-foreground transition-colors">
83 - Quickstart
84 - </Link>
85 - <Link href="/toolkits" className="hover:text-fd-foreground transition-colors">
86 - Toolkits
87 - </Link>
88 - <Link href="/cookbooks" className="hover:text-fd-foreground transition-colors">
89 - Cookbooks
90 - </Link>
91 - <Link href="/reference" className="hover:text-fd-foreground transition-colors">
92 - API Reference
93 - </Link>
94 - </nav>
92 </div>
93 );
94 }
docs/components/ai-tools-banner.tsx
+3 -3
@@ -42,15 +42,15 @@ export function AIToolsBanner() {
42 {/* Shader gradient blobs — same as PromptBanner */}
43 <div
44 className="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"
45 - style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}
45 + style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.12) 0%, rgba(0,7,205,0) 70%)' }}
46 />
47 <div
48 className="pointer-events-none absolute right-10 -bottom-20 h-56 w-56 rounded-full"
49 - style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}
49 + style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.08) 0%, rgba(0,7,205,0) 70%)' }}
50 />
51 <div
52 className="pointer-events-none absolute right-32 -top-16 h-44 w-44 rounded-full"
53 - style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}
53 + style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.06) 0%, rgba(0,7,205,0) 70%)' }}
54 />
55 <div className="relative flex flex-col gap-3 p-4 sm:px-5 sm:py-4">
56 {/* Header */}
docs/components/callout.tsx new
+85
@@ -0,0 +1,85 @@
1 +import type { ReactNode } from 'react';
2 +import { CircleCheck, CircleX, Lightbulb, TriangleAlert } from 'lucide-react';
3 +import { cn } from '@/lib/utils';
4 +
5 +type CalloutType = 'info' | 'warn' | 'warning' | 'error' | 'success' | 'tip' | 'idea';
6 +
7 +interface CalloutProps {
8 + type?: CalloutType;
9 + title?: ReactNode;
10 + children?: ReactNode;
11 + className?: string;
12 +}
13 +
14 +type ResolvedType = 'info' | 'warning' | 'error' | 'success' | 'idea';
15 +
16 +function resolveType(type: CalloutType = 'info'): ResolvedType {
17 + if (type === 'warn') return 'warning';
18 + if (type === 'tip') return 'info';
19 + return type;
20 +}
21 +
22 +const variants: Record<
23 + ResolvedType,
24 + { container: string; icon?: typeof TriangleAlert; iconClass?: string }
25 +> = {
26 + info: {
27 + container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',
28 + },
29 + warning: {
30 + container: 'border-amber-600/15 bg-amber-500/[0.04] text-fd-muted-foreground',
31 + icon: TriangleAlert,
32 + iconClass: 'text-amber-600/60',
33 + },
34 + error: {
35 + container: 'border-red-500/15 bg-red-500/[0.04] text-fd-muted-foreground',
36 + icon: CircleX,
37 + iconClass: 'text-red-500/60',
38 + },
39 + success: {
40 + container: 'border-emerald-600/15 bg-emerald-500/[0.04] text-fd-muted-foreground',
41 + icon: CircleCheck,
42 + iconClass: 'text-emerald-600/60',
43 + },
44 + idea: {
45 + container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',
46 + icon: Lightbulb,
47 + iconClass: 'text-fd-muted-foreground/70',
48 + },
49 +};
50 +
51 +export function Callout({ type = 'info', title, children, className }: CalloutProps) {
52 + const resolved = resolveType(type);
53 + const variant = variants[resolved];
54 + const Icon = variant.icon;
55 +
56 + return (
57 + <div
58 + data-callout=""
59 + className={cn(
60 + 'not-prose my-3 rounded-md border px-3 py-2 text-[0.8125rem] leading-relaxed',
61 + variant.container,
62 + className,
63 + )}
64 + >
65 + <div className={cn('flex gap-2', Icon ? 'items-start' : '')}>
66 + {Icon ? (
67 + <Icon className={cn('mt-0.5 size-3.5 shrink-0 stroke-[1.75]', variant.iconClass)} />
68 + ) : null}
69 + <div className="min-w-0 flex-1">
70 + {title ? <p className="mb-1 font-medium text-fd-foreground">{title}</p> : null}
71 + <div
72 + className={cn(
73 + 'prose-no-margin',
74 + '[&_a]:text-fd-foreground [&_a]:underline [&_a]:decoration-fd-border [&_a]:underline-offset-2',
75 + '[&_a]:hover:decoration-fd-muted-foreground',
76 + '[&_code]:text-[0.8125rem] [&_code]:text-fd-foreground/80',
77 + )}
78 + >
79 + {children}
80 + </div>
81 + </div>
82 + </div>
83 + </div>
84 + );
85 +}
docs/components/capability-card.tsx
+3 -3
@@ -13,10 +13,10 @@ export function CapabilityCard({ icon, title, description, href }: CapabilityCar
13 <Link
14 href={href}
15 data-card
16 - className="block p-6 rounded-xl border border-fd-border bg-fd-card hover:border-orange-500 hover:bg-fd-accent/50 transition-all [text-decoration:none] group focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
16 + className="block p-6 rounded-xl border border-fd-border bg-fd-card hover:border-blue-500 hover:bg-fd-accent/50 transition-all [text-decoration:none] group focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
17 >
18 - <div className="text-orange-500 mb-3">{icon}</div>
19 - <h3 className="text-lg font-semibold text-orange-500 mb-2">{title}</h3>
18 + <div className="text-blue-500 mb-3">{icon}</div>
19 + <h3 className="text-lg font-semibold text-blue-500 mb-2">{title}</h3>
20 <p className="text-fd-muted-foreground text-sm leading-relaxed">{description}</p>
21 </Link>
22 );
docs/components/connect-flow.tsx
+2 -2
@@ -58,7 +58,7 @@ function PopularTab({
58 onClick={onSelect}
59 className={`
60 flex items-center gap-2 rounded-md px-3 py-1.5 text-sm font-medium transition-all whitespace-nowrap
61 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500
61 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500
62 ${selected
63 ? 'bg-fd-background text-fd-foreground shadow-sm dark:bg-fd-accent/60 dark:shadow-none'
64 : 'text-fd-muted-foreground hover:text-fd-foreground'
@@ -154,7 +154,7 @@ export function ConnectFlow({ children }: ConnectFlowProps) {
154 onKeyDown={(e) => { if (e.key === 'Escape') setDropdownOpen(false); }}
155 className={`
156 flex items-center gap-2 rounded-lg border px-3 py-1.5 text-sm font-medium transition-all
157 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500
157 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500
158 ${selectedIsOther
159 ? 'border-[var(--composio-orange)] bg-fd-accent/30 text-fd-foreground'
160 : 'border-fd-border bg-fd-card text-fd-muted-foreground hover:text-fd-foreground hover:bg-fd-accent/50'
docs/components/copy-link.tsx
+1 -1
@@ -22,7 +22,7 @@ export function CopyLink({ href, children, className }: CopyLinkProps) {
22 return (
23 <button
24 onClick={handleCopy}
25 - className={`inline-flex items-center gap-1.5 group cursor-pointer whitespace-nowrap focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 rounded ${className}`}
25 + className={`inline-flex items-center gap-1.5 group cursor-pointer whitespace-nowrap focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 rounded ${className}`}
26 aria-label="Copy link to clipboard"
27 >
28 <span>{children}</span>
docs/components/docs-hero.tsx new
+61
@@ -0,0 +1,61 @@
1 +import Image from 'next/image';
2 +import Link from 'next/link';
3 +import { ArrowUpRight } from 'lucide-react';
4 +
5 +/**
6 + * Welcome-page hero — Composio brand language synced with composio.dev.
7 + * Full-bleed shader background (Malay's `shader-fallback.jpg` from the
8 + * landing site), centered content on top.
9 + */
10 +export function DocsHero() {
11 + return (
12 + <div className="not-prose relative isolate mb-12 overflow-hidden border border-fd-border">
13 + <Image
14 + src="/images/hero/shader.jpg"
15 + alt=""
16 + fill
17 + priority
18 + sizes="(min-width: 1280px) 1024px, 100vw"
19 + className="-z-10 object-cover"
20 + />
21 + {/* readability scrim — soft white wash on light, soft black wash on dark */}
22 + <div
23 + aria-hidden="true"
24 + className="pointer-events-none absolute inset-0 -z-10 bg-white/30 dark:bg-black/40"
25 + />
26 +
27 + <div className="relative flex flex-col items-center gap-6 px-6 py-20 text-center sm:py-24 lg:py-32">
28 + <h1 className="text-4xl font-medium leading-[0.95] tracking-[-0.02em] text-fd-foreground md:text-5xl lg:text-[64px]">
29 + Composio
30 + <br className="sm:hidden" />
31 + <span className="sm:ml-3">Documentation</span>
32 + </h1>
33 + <p className="max-w-[560px] text-base leading-[1.5] text-fd-foreground/80 md:text-lg">
34 + Composio powers 1000+ toolkits, tool search, context management,
35 + authentication, and a sandboxed workbench to help you build AI agents
36 + that turn intent into action.
37 + </p>
38 + <div className="mt-2 flex flex-wrap items-center justify-center gap-3">
39 + <Link
40 + href="/docs/quickstart"
41 + className="group inline-flex items-center gap-1.5 bg-[var(--composio-brand)] px-5 py-3 font-mono text-sm uppercase tracking-[-0.28px] no-underline transition-colors hover:bg-[#0006a8]"
42 + style={{ color: '#ffffff' }}
43 + >
44 + <span style={{ color: '#ffffff' }}>Get Started</span>
45 + <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" style={{ color: '#ffffff' }} />
46 + </Link>
47 + <Link
48 + href="https://dashboard.composio.dev/~/project/playground"
49 + target="_blank"
50 + rel="noopener noreferrer"
51 + className="group inline-flex items-center gap-1.5 border border-black/15 bg-white/70 px-5 py-3 font-mono text-sm uppercase tracking-[-0.28px] no-underline backdrop-blur-sm transition-colors hover:bg-white dark:border-white/20 dark:bg-black/40 dark:hover:bg-black/60"
52 + style={{ color: 'var(--color-fd-foreground)' }}
53 + >
54 + <span style={{ color: 'var(--color-fd-foreground)' }}>Playground</span>
55 + <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" />
56 + </Link>
57 + </div>
58 + </div>
59 + </div>
60 + );
61 +}
docs/components/edit-on-github.tsx new
+32
@@ -0,0 +1,32 @@
1 +import { Edit } from 'lucide-react';
2 +
3 +interface EditOnGitHubProps {
4 + /**
5 + * File path relative to the repository root, e.g. `docs/content/docs/index.mdx`
6 + * or `docs/components/toolkits/toolkit-detail.tsx`.
7 + */
8 + path: string;
9 + /** Defaults to the `next` branch. */
10 + sha?: string;
11 +}
12 +
13 +/**
14 + * "Edit this page on GitHub" link, rendered at the bottom of each docs page.
15 + * Links to the source file in the public Composio repo on the configured branch.
16 + */
17 +export function EditOnGitHub({ path, sha = 'next' }: EditOnGitHubProps) {
18 + const href = `https://github.com/ComposioHQ/composio/blob/${sha}/${path}`;
19 + return (
20 + <div className="not-prose mt-12 flex justify-start border-t border-fd-border/60 pt-6">
21 + <a
22 + href={href}
23 + target="_blank"
24 + rel="noopener noreferrer"
25 + className="inline-flex items-center gap-1.5 text-xs font-medium text-fd-muted-foreground hover:text-fd-foreground transition-colors"
26 + >
27 + <Edit className="size-3.5" aria-hidden="true" />
28 + <span>Edit this page on GitHub</span>
29 + </a>
30 + </div>
31 + );
32 +}
docs/components/nav-tabs.tsx
+1 -1
@@ -27,7 +27,7 @@ export function NavTabs() {
27 <Link
28 key={tab.href}
29 href={tab.href}
30 - className={`nav-tab focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 rounded ${isActive(tab.href, tab.exact) ? 'active' : ''}`}
30 + className={`nav-tab focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 rounded ${isActive(tab.href, tab.exact) ? 'active' : ''}`}
31 >
32 {tab.label}
33 </Link>
docs/components/page-actions.tsx
+196 -128
@@ -1,160 +1,228 @@
1 'use client';
2
3 -import { useState, useCallback } from 'react';
4 -import { Copy, Check, Loader2, ExternalLink, BotMessageSquare } from 'lucide-react';
5 -import { Feedback } from './feedback';
6 -import { toggleDecimalWidget } from './ask-ai-button';
3 +import { useCallback, useEffect, useRef, useState } from 'react';
4 +import { Check, ChevronDown, Copy, ExternalLink, FileText } from 'lucide-react';
5
6 interface PageActionsProps {
7 path: string;
8 + /**
9 + * 'overlap-title' (default) lifts the button into the row above via a
10 + * negative top margin so it lands to the right of `<DocsTitle>`.
11 + * 'inline' renders the button as a normal inline-block — use when the
12 + * caller already controls layout (e.g. the Toolkits landing header).
13 + */
14 + variant?: 'overlap-title' | 'inline';
15 }
16
17 +const FALLBACK_ORIGIN = 'https://docs.composio.dev';
18 +
19 /**
13 - * Actions for the current page: copy markdown, open as markdown.
14 - * Provides AI-friendly access to documentation content.
20 + * Single "Copy page" dropdown with three actions:
21 + * - Copy page (fetches the .md and writes to clipboard)
22 + * - Open in ChatGPT (deep link with a prefilled prompt)
23 + * - Open in Claude (deep link with a prefilled prompt)
24 + *
25 + * Sits to the right of the page title via `not-prose -mt-12 mb-2 flex justify-end`
26 + * so it overlaps the row above (next to <DocsTitle>) without ever crashing into
27 + * the title text on narrow viewports.
28 */
16 -export function PageActions({ path }: PageActionsProps) {
17 - const [copyState, setCopyState] = useState<'idle' | 'loading' | 'copied' | 'error'>('idle');
29 +export function PageActions({ path, variant = 'overlap-title' }: PageActionsProps) {
30 + const [open, setOpen] = useState(false);
31 + const [copied, setCopied] = useState(false);
32 + const wrapperRef = useRef<HTMLDivElement>(null);
33
19 - const handleCopy = useCallback(async () => {
20 - if (copyState === 'loading') return;
21 - setCopyState('loading');
34 + // Close on outside click and Escape.
35 + useEffect(() => {
36 + if (!open) return;
37 + function onClick(e: MouseEvent) {
38 + if (wrapperRef.current && !wrapperRef.current.contains(e.target as Node)) {
39 + setOpen(false);
40 + }
41 + }
42 + function onKey(e: KeyboardEvent) {
43 + if (e.key === 'Escape') setOpen(false);
44 + }
45 + document.addEventListener('mousedown', onClick);
46 + document.addEventListener('keydown', onKey);
47 + return () => {
48 + document.removeEventListener('mousedown', onClick);
49 + document.removeEventListener('keydown', onKey);
50 + };
51 + }, [open]);
52 +
53 + const absoluteMdUrl =
54 + typeof window !== 'undefined'
55 + ? `${window.location.origin}${path}.md`
56 + : `${FALLBACK_ORIGIN}${path}.md`;
57
58 + const chatgptUrl = `https://chatgpt.com/?hints=search&q=${encodeURIComponent(
59 + `Read ${absoluteMdUrl} so I can ask questions about it.`,
60 + )}`;
61 + const claudeUrl = `https://claude.ai/new?q=${encodeURIComponent(
62 + `Read ${absoluteMdUrl} so I can ask questions about it.`,
63 + )}`;
64 +
65 + const handleCopy = useCallback(async () => {
66 try {
67 const response = await fetch(`${path}.md`);
68 if (!response.ok) throw new Error('Failed to fetch');
26 -
69 const markdown = await response.text();
70 await navigator.clipboard.writeText(markdown);
29 -
30 - setCopyState('copied');
31 - setTimeout(() => setCopyState('idle'), 2000);
71 + setCopied(true);
72 + setTimeout(() => setCopied(false), 1500);
73 + setTimeout(() => setOpen(false), 400);
74 } catch {
33 - setCopyState('error');
34 - setTimeout(() => setCopyState('idle'), 2000);
75 + // best-effort; leave menu open so user can retry
76 }
36 - }, [path, copyState]);
37 -
38 - const getCopyIcon = () => {
39 - switch (copyState) {
40 - case 'loading':
41 - return (
42 - <Loader2
43 - className="size-3.5 animate-spin motion-reduce:animate-none"
44 - aria-hidden="true"
45 - />
46 - );
47 - case 'copied':
48 - return (
49 - <Check
50 - className="size-3.5 text-emerald-500 dark:text-emerald-400"
51 - aria-hidden="true"
52 - />
53 - );
54 - case 'error':
55 - return (
56 - <Copy
57 - className="size-3.5 text-red-500 dark:text-red-400"
77 + }, [path]);
78 +
79 + return (
80 + <div className={variant === 'overlap-title' ? 'not-prose -mt-12 mb-2 flex justify-end' : 'not-prose inline-block'}>
81 + <div ref={wrapperRef} className="relative">
82 + <button
83 + type="button"
84 + onClick={() => setOpen((v) => !v)}
85 + aria-haspopup="menu"
86 + aria-expanded={open}
87 + className="inline-flex items-center gap-1.5 px-2.5 py-1.5 text-xs font-medium
88 + text-fd-muted-foreground hover:text-fd-foreground
89 + bg-fd-secondary/50 hover:bg-fd-secondary
90 + border border-fd-border/60
91 + transition-colors duration-150 ease-out
92 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
93 + touch-manipulation"
94 + style={{ borderRadius: 0 }}
95 + >
96 + <Copy className="size-3.5" aria-hidden="true" />
97 + <span>Copy page</span>
98 + <ChevronDown
99 + className={`size-3.5 transition-transform duration-150 ${open ? 'rotate-180' : ''}`}
100 aria-hidden="true"
101 />
60 - );
61 - default:
62 - return <Copy className="size-3.5" aria-hidden="true" />;
63 - }
64 - };
65 -
66 - const getCopyLabel = () => {
67 - switch (copyState) {
68 - case 'loading':
69 - return 'Copying…';
70 - case 'copied':
71 - return 'Copied!';
72 - case 'error':
73 - return 'Failed';
74 - default:
75 - return 'Copy page';
76 - }
77 - };
102 + </button>
103
79 - return (
80 - <div
81 - className="not-prose flex flex-wrap items-center gap-1.5 sm:gap-1 mt-2 mb-6"
82 - role="group"
83 - aria-label="Page actions"
84 - >
85 - {/* Copy Button */}
86 - <button
87 - type="button"
88 - onClick={handleCopy}
89 - disabled={copyState === 'loading'}
90 - className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
91 - text-fd-muted-foreground hover:text-fd-foreground
92 - bg-fd-secondary/50 hover:bg-fd-secondary
93 - rounded-md
94 - transition-all duration-150 ease-out
95 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
96 - disabled:pointer-events-none
97 - active:scale-[0.98]
98 - touch-manipulation
99 - motion-reduce:transition-none motion-reduce:active:scale-100"
100 - aria-label="Copy page as markdown"
101 - aria-live="polite"
102 - >
103 - <span className="transition-transform duration-150 ease-out">
104 - {getCopyIcon()}
104 + {open && (
105 + <div
106 + role="menu"
107 + className="absolute right-0 z-50 mt-1 w-[280px] border border-fd-border bg-fd-popover text-fd-popover-foreground shadow-lg"
108 + style={{ borderRadius: 0 }}
109 + >
110 + <MenuItem
111 + icon={
112 + copied ? (
113 + <Check className="size-4 text-emerald-500" aria-hidden="true" />
114 + ) : (
115 + <Copy className="size-4" aria-hidden="true" />
116 + )
117 + }
118 + title={copied ? 'Copied!' : 'Copy page'}
119 + subtitle="Copy page as Markdown for LLMs"
120 + onClick={handleCopy}
121 + />
122 + <MenuItem
123 + icon={<FileText className="size-4" aria-hidden="true" />}
124 + external
125 + title="View as Markdown"
126 + subtitle="Open the raw .md source in a new tab"
127 + href={`${path}.md`}
128 + />
129 + <MenuItem
130 + icon={<ChatGPTMark className="size-4" />}
131 + external
132 + title="Open in ChatGPT"
133 + subtitle="Ask questions about this page"
134 + href={chatgptUrl}
135 + />
136 + <MenuItem
137 + icon={<ClaudeMark className="size-4" />}
138 + external
139 + title="Open in Claude"
140 + subtitle="Ask questions about this page"
141 + href={claudeUrl}
142 + />
143 + </div>
144 + )}
145 + </div>
146 + </div>
147 + );
148 +}
149 +
150 +interface MenuItemProps {
151 + icon: React.ReactNode;
152 + title: string;
153 + subtitle: string;
154 + href?: string;
155 + external?: boolean;
156 + onClick?: () => void;
157 +}
158 +
159 +function MenuItem({ icon, title, subtitle, href, external, onClick }: MenuItemProps) {
160 + const className =
161 + 'flex w-full items-start gap-3 px-3 py-2.5 text-left hover:bg-fd-accent hover:text-fd-accent-foreground focus-visible:outline-none focus-visible:bg-fd-accent';
162 +
163 + const content = (
164 + <>
165 + <span className="mt-0.5 flex size-4 shrink-0 items-center justify-center text-fd-muted-foreground">
166 + {icon}
167 + </span>
168 + <span className="min-w-0 flex-1">
169 + <span className="flex items-center gap-1 text-sm font-medium text-fd-foreground">
170 + {title}
171 + {external && (
172 + <ExternalLink className="size-3 text-fd-muted-foreground" aria-hidden="true" />
173 + )}
174 </span>
106 - <span>{getCopyLabel()}</span>
107 - </button>
175 + <span className="block text-xs text-fd-muted-foreground">{subtitle}</span>
176 + </span>
177 + </>
178 + );
179
109 - {/* View Markdown Link */}
180 + if (href) {
181 + return (
182 <a
111 - href={`${path}.md`}
183 + href={href}
184 target="_blank"
185 rel="noopener noreferrer"
114 - className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
115 - text-fd-muted-foreground hover:text-fd-foreground
116 - bg-fd-secondary/50 hover:bg-fd-secondary
117 - rounded-md
118 - transition-all duration-150 ease-out
119 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
120 - active:scale-[0.98]
121 - touch-manipulation
122 - motion-reduce:transition-none motion-reduce:active:scale-100"
123 - aria-label="View page as markdown (opens in new tab)"
186 + role="menuitem"
187 + className={className}
188 >
125 - <ExternalLink className="size-3.5" aria-hidden="true" />
126 - <span className="hidden sm:inline">View </span>
127 - <span>Markdown</span>
189 + {content}
190 </a>
191 + );
192 + }
193 + return (
194 + <button type="button" role="menuitem" onClick={onClick} className={className}>
195 + {content}
196 + </button>
197 + );
198 +}
199
130 - {/* Divider - hidden on mobile when wrapped */}
131 - <span
132 - className="hidden sm:block mx-1 h-4 w-px bg-fd-border/60"
133 - role="separator"
134 - aria-orientation="vertical"
135 - />
136 -
137 - {/* Ask AI */}
138 - <button
139 - type="button"
140 - onClick={toggleDecimalWidget}
141 - className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
142 - text-fd-muted-foreground hover:text-fd-foreground
143 - bg-fd-secondary/50 hover:bg-fd-secondary
144 - rounded-md
145 - transition-all duration-150 ease-out
146 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
147 - active:scale-[0.98]
148 - touch-manipulation
149 - motion-reduce:transition-none motion-reduce:active:scale-100"
150 - aria-label="Ask AI"
151 - >
152 - <BotMessageSquare className="size-3.5" aria-hidden="true" />
153 - <span>Ask AI</span>
154 - </button>
200 +/** Tiny inline OpenAI/ChatGPT mark (flower-gear), monochrome currentColor. */
201 +function ChatGPTMark({ className }: { className?: string }) {
202 + return (
203 + <svg
204 + className={className}
205 + viewBox="0 0 24 24"
206 + fill="currentColor"
207 + aria-hidden="true"
208 + xmlns="http://www.w3.org/2000/svg"
209 + >
210 + <path d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.077.077 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08-4.778 2.758a.795.795 0 0 0-.393.681zm1.097-2.365 2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5z" />
211 + </svg>
212 + );
213 +}
214
156 - {/* Feedback */}
157 - <Feedback page={path} />
158 - </div>
215 +/** Tiny inline Anthropic Claude mark (asterisk/burst), monochrome currentColor. */
216 +function ClaudeMark({ className }: { className?: string }) {
217 + return (
218 + <svg
219 + className={className}
220 + viewBox="0 0 24 24"
221 + fill="currentColor"
222 + aria-hidden="true"
223 + xmlns="http://www.w3.org/2000/svg"
224 + >
225 + <path d="M4.709 15.955l4.72-2.647.079-.23-.079-.128h-.23l-.787-.048-2.687-.073-2.331-.097L1.078 12.6l-.582-.74.058-.385.49-.327.701.063 1.55.105 2.327.16 3.376.198 4.802.205-.018-.07L17.16 7.31l.215.06.21.124.214.214.06.21-.124.214-2.31 2.31-.214.215-.06.21-.124.214.124.214.06.21.214.214 2.31 2.31.124.214.06.21-.21.124-.214.06-.215-.06-3.06-2.06-.31-.16-1.06-.06-.124.06-.06.21.124.214 1.95 2.954.214.214.06.21-.06.21-.214.214.214.214.06.21-.06.21.214.214.214.214-.06.21-.21.124-.214.06-3.06-2.06z" />
226 + </svg>
227 );
228 }
docs/components/provider-card.tsx
+1 -1
@@ -17,7 +17,7 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Pr
17 return (
18 <Link
19 href={href}
20 - className="flex items-center gap-5 rounded-lg border border-fd-border bg-fd-card p-5 transition-all hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
20 + className="flex items-center gap-5 rounded-lg border border-fd-border bg-fd-card p-5 transition-all hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
21 >
22 <div className="flex h-12 w-12 shrink-0 items-center justify-center">
23 {logo && logoDark ? (
docs/components/quickstart/framework-selector.tsx
+1 -1
@@ -56,7 +56,7 @@ function FrameworkCard({ framework, selected, onSelect }: FrameworkCardProps) {
56 onClick={onSelect}
57 className={`
58 flex flex-col items-start gap-4 rounded-xl border-2 p-5 text-left transition-all
59 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
59 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
60 ${selected
61 ? 'border-[var(--composio-orange)] bg-fd-card'
62 : 'border-fd-border bg-fd-card hover:bg-fd-accent/50'
docs/components/quickstart/index.tsx
-1
@@ -1,4 +1,3 @@
1 export { FrameworkSelector, frameworks } from './framework-selector';
2 export { QuickstartFlow, FrameworkOption } from './quickstart-flow';
3 -export { PromptBanner } from './prompt-banner';
3 export type { Framework } from './framework-selector';
docs/components/quickstart/prompt-banner.tsx deleted
-168
@@ -1,168 +0,0 @@
1 -'use client';
2 -
3 -import { useState, useRef, useEffect, type ReactNode } from 'react';
4 -import { Copy, Check } from 'lucide-react';
5 -
6 -function detectLang(pre: Element, code: Element | null): string {
7 - for (const el of [pre, code]) {
8 - const lang = el?.getAttribute('data-language') ?? el?.getAttribute('data-lang');
9 - if (lang) return lang;
10 - }
11 - const cls = Array.from(code?.classList ?? []).find(c => c.startsWith('language-'));
12 - if (cls) return cls.replace('language-', '');
13 - const text = code?.textContent ?? '';
14 - if (/^(pip|npm|npx|bun|yarn|pnpm) /.test(text.trim())) return 'bash';
15 - if (text.includes('from dotenv') || text.includes('import asyncio')) return 'python';
16 - if (text.includes('from "') || text.includes('from "@')) return 'typescript';
17 - if (text.includes('COMPOSIO_API_KEY=')) return 'bash';
18 - return '';
19 -}
20 -
21 -function getTabLabel(pre: Element, step: Element): string {
22 - let el: Element | null = pre.parentElement;
23 - while (el && el !== step) {
24 - if (el.getAttribute('role') === 'tabpanel') {
25 - const tablist = el.parentElement?.querySelector('[role="tablist"]');
26 - if (tablist) {
27 - const tabs = tablist.querySelectorAll('[role="tab"]');
28 - const panels = el.parentElement?.querySelectorAll(':scope > [role="tabpanel"]');
29 - if (panels) {
30 - const idx = Array.from(panels).indexOf(el);
31 - if (idx >= 0 && tabs[idx]) return tabs[idx].textContent?.trim() ?? '';
32 - }
33 - }
34 - return '';
35 - }
36 - el = el.parentElement;
37 - }
38 - return '';
39 -}
40 -
41 -function extractSteps(stepsEl: Element): string {
42 - const parts: string[] = [];
43 - const steps = stepsEl.querySelectorAll('.fd-step');
44 -
45 - steps.forEach((step) => {
46 - const title = step.querySelector('h3, h4, h2, [class*="step-title"], [class*="StepTitle"]');
47 - const titleText = title?.textContent?.trim();
48 - if (titleText) parts.push(`### ${titleText}`);
49 -
50 - const pres = step.querySelectorAll('pre');
51 - pres.forEach((pre) => {
52 - const codeEl = pre.querySelector('code');
53 - const code = codeEl?.textContent?.trim() ?? '';
54 - if (!code) return;
55 -
56 - const lang = detectLang(pre, codeEl);
57 - const tabLabel = getTabLabel(pre, step);
58 -
59 - if (tabLabel) {
60 - parts.push(`**${tabLabel}**\n\n\`\`\`${lang}\n${code}\n\`\`\``);
61 - } else {
62 - parts.push(`\`\`\`${lang}\n${code}\n\`\`\``);
63 - }
64 - });
65 - });
66 -
67 - return parts.join('\n\n');
68 -}
69 -
70 -interface PromptBannerProps {
71 - children: ReactNode;
72 -}
73 -
74 -export function PromptBanner({ children }: PromptBannerProps) {
75 - const [copied, setCopied] = useState(false);
76 - const contentRef = useRef<HTMLDivElement>(null);
77 - const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
78 -
79 - useEffect(() => () => { clearTimeout(timerRef.current); }, []);
80 -
81 - const handleCopy = async () => {
82 - const fullMeta = contentRef.current?.innerText ?? '';
83 -
84 - const splitMarker = 'Key concepts';
85 - const splitIdx = fullMeta.indexOf(splitMarker);
86 - const context = splitIdx > 0 ? fullMeta.slice(0, splitIdx).trim() : fullMeta;
87 - const rules = splitIdx > 0 ? fullMeta.slice(splitIdx).trim() : '';
88 -
89 - let sibling = contentRef.current?.closest('.not-prose')?.nextElementSibling;
90 - let stepsText = '';
91 - while (sibling) {
92 - if (sibling.classList.contains('fd-steps')) {
93 - stepsText = extractSteps(sibling);
94 - break;
95 - }
96 - sibling = sibling.nextElementSibling;
97 - }
98 -
99 - const parts = [context];
100 - if (stepsText) parts.push(`## Code\n\n${stepsText}`);
101 - if (rules) parts.push(rules);
102 - const fullPrompt = parts.join('\n\n');
103 -
104 - try {
105 - await navigator.clipboard.writeText(fullPrompt);
106 - clearTimeout(timerRef.current);
107 - setCopied(true);
108 - timerRef.current = setTimeout(() => setCopied(false), 2000);
109 - } catch {
110 - // Clipboard write failed (e.g. permission denied) — don't show success
111 - }
112 - };
113 -
114 - return (
115 - <div className="not-prose mb-6">
116 - <div className="relative flex flex-wrap items-center justify-between gap-4 overflow-hidden rounded-xl border border-fd-border bg-fd-card px-5 py-4 sm:flex-nowrap sm:gap-6">
117 - {/* Shader gradient blobs */}
118 - <div
119 - className="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"
120 - style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}
121 - />
122 - <div
123 - className="pointer-events-none absolute right-20 -bottom-24 h-48 w-48 rounded-full"
124 - style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}
125 - />
126 - <div
127 - className="pointer-events-none absolute left-72 -top-20 h-44 w-44 rounded-full"
128 - style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}
129 - />
130 -
131 - {/* Sparkle */}
132 - <svg className="relative shrink-0" aria-hidden="true" width="28" height="28" viewBox="0 0 28 28" fill="none">
133 - <path d="M14 2L16.1 11.9L26 14L16.1 16.1L14 26L11.9 16.1L2 14L11.9 11.9L14 2Z" fill="var(--composio-orange)" opacity="0.25"/>
134 - </svg>
135 -
136 - <p className="relative flex-1 text-[15px] text-fd-foreground/70">
137 - Use skills or copy prompt to get started faster!
138 - </p>
139 -
140 - <div className="relative flex shrink-0 items-center gap-3">
141 - <a
142 - href="https://skills.sh/composiohq/skills/composio"
143 - target="_blank"
144 - rel="noopener noreferrer"
145 - className="inline-flex items-center gap-2 rounded-lg border border-[var(--composio-orange)]/30 bg-transparent px-4 py-2 text-sm font-medium text-[var(--composio-orange)] transition-all hover:border-[var(--composio-orange)]/60 hover:bg-[var(--composio-orange)]/5"
146 - >
147 - Skills
148 - <span aria-hidden="true">↗</span>
149 - </a>
150 - <button
151 - type="button"
152 - onClick={handleCopy}
153 - className={`inline-flex items-center gap-2 rounded-lg border px-4 py-2 text-sm font-medium transition-all duration-200 active:scale-[0.98] ${copied ? 'border-emerald-500/50 bg-emerald-500/10 text-emerald-500' : 'border-transparent bg-[var(--composio-orange)] text-white shadow-sm hover:brightness-110'}`}
154 - >
155 - {copied ? (
156 - <Check className="h-4 w-4" strokeWidth={3} />
157 - ) : (
158 - <Copy className="h-4 w-4" />
159 - )}
160 - {copied ? 'Copied!' : 'Copy prompt'}
161 - </button>
162 - </div>
163 - </div>
164 - {/* Hidden prompt content for copy button */}
165 - <div ref={contentRef} className="sr-only">{children}</div>
166 - </div>
167 - );
168 -}
docs/components/quickstart/quickstart-flow.tsx
+1 -1
@@ -79,7 +79,7 @@ function FrameworkCard({ name, logo, logoDark, selected, onSelect }: FrameworkCa
79 onClick={onSelect}
80 className={`
81 flex items-center gap-3 rounded-lg border px-3 py-2.5 text-left transition-all
82 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
82 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
83 ${selected
84 ? 'border-[var(--composio-orange)] bg-fd-accent/30'
85 : 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'
docs/components/template-card.tsx
+1 -1
@@ -25,7 +25,7 @@ export function TemplateCard({
25 href={href}
26 target="_blank"
27 rel="noopener noreferrer"
28 - className="flex flex-col sm:flex-row items-start gap-8 rounded-xl border border-fd-border bg-fd-card p-8 transition-all hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] [text-decoration:none] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
28 + className="flex flex-col sm:flex-row items-start gap-8 rounded-xl border border-fd-border bg-fd-card p-8 transition-all hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] [text-decoration:none] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
29 >
30 <div className="flex flex-col gap-3 sm:w-1/2 shrink-0 pt-2">
31 <h3 className="text-xl font-bold text-fd-foreground">{title}</h3>
docs/components/tool-type-selector.tsx
+1 -1
@@ -76,7 +76,7 @@ function ToolTypeCard({ name, icon, selected, onSelect }: ToolTypeCardProps) {
76 onClick={onSelect}
77 className={`
78 flex items-center gap-3 rounded-lg border px-4 py-3 text-left transition-all
79 - focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
79 + focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
80 ${selected
81 ? 'border-[var(--composio-orange)] bg-fd-accent/30'
82 : 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'
docs/components/toolkits/auth-details-section.tsx
+9 -3
@@ -1,6 +1,7 @@
1 'use client';
2
3 -import { Key } from 'lucide-react';
3 +import { ArrowUpRight, Key } from 'lucide-react';
4 +import Link from 'next/link';
5 import { TypeTable } from 'fumadocs-ui/components/type-table';
6 import { Accordion, Accordions } from '@/mdx-components';
7 import type { AuthConfigDetail, AuthConfigField } from '@/types/toolkit';
@@ -81,9 +82,14 @@ export function AuthDetailsSection({ authConfigDetails, authSchemes, composioMan
82 Authentication Details
83 {hasOAuth && (
84 composioManagedAuthSchemes && composioManagedAuthSchemes.length > 0 ? (
84 - <span className="rounded bg-green-500/10 px-2 py-0.5 text-xs font-medium text-green-600 dark:text-green-400">
85 + <Link
86 + href="/toolkits/managed-auth"
87 + className="inline-flex items-center gap-1.5 border border-fd-border bg-fd-card px-2 py-0.5 font-mono text-[10px] uppercase tracking-[0.06em] text-fd-foreground transition-colors hover:border-fd-foreground/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring"
88 + >
89 + <span className="size-1.5 rounded-full bg-green-500" aria-hidden="true" />
90 Composio Managed App available
86 - </span>
91 + <ArrowUpRight className="size-3" aria-hidden="true" />
92 + </Link>
93 ) : (
94 <span className="rounded bg-amber-500/10 px-2 py-0.5 text-xs font-medium text-amber-600 dark:text-amber-400">
95 Composio Managed App not available
docs/components/toolkits/managed-auth-list.tsx
+32 -30
@@ -49,7 +49,7 @@ function CopySlugButton({ slug }: { slug: string }) {
49 <button
50 onClick={handleCopy}
51 aria-label={`Copy ${slug.toUpperCase()} to clipboard`}
52 - className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500"
52 + className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500"
53 >
54 <span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
55 {copied ? <Check className="h-3 w-3 text-green-500" aria-hidden="true" /> : <Copy className="h-3 w-3" aria-hidden="true" />}
@@ -158,38 +158,40 @@ export function ManagedAuthList() {
158 autoComplete="off"
159 value={search}
160 onChange={(e) => setSearch(e.target.value)}
161 - className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
161 + className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
162 />
163 </div>
164
165 - {/* Tabs + Copy */}
166 - <div className="flex items-center justify-between border-b border-fd-border">
167 - <div className="flex items-center gap-1">
168 - <button
169 - onClick={() => setTab('managed')}
170 - className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
171 - tab === 'managed'
172 - ? 'border-green-500 text-fd-foreground'
173 - : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
174 - }`}
175 - >
176 - <span className="inline-block h-2 w-2 rounded-full bg-green-500" />
177 - Composio Managed App Available
178 - <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
179 - </button>
180 - <button
181 - onClick={() => setTab('unmanaged')}
182 - className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
183 - tab === 'unmanaged'
184 - ? 'border-amber-500 text-fd-foreground'
185 - : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
186 - }`}
187 - >
188 - <span className="inline-block h-2 w-2 rounded-full bg-amber-500" />
189 - Requires your own credentials
190 - <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
191 - </button>
192 - </div>
165 + {/* Tabs */}
166 + <div className="flex items-center gap-1 border-b border-fd-border">
167 + <button
168 + onClick={() => setTab('managed')}
169 + className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
170 + tab === 'managed'
171 + ? 'border-green-500 text-fd-foreground'
172 + : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
173 + }`}
174 + >
175 + <span className="inline-block h-2 w-2 rounded-full bg-green-500" />
176 + Composio Managed App Available
177 + <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
178 + </button>
179 + <button
180 + onClick={() => setTab('unmanaged')}
181 + className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
182 + tab === 'unmanaged'
183 + ? 'border-fd-muted-foreground text-fd-foreground'
184 + : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
185 + }`}
186 + >
187 + <span className="inline-block h-2 w-2 rounded-full bg-fd-muted-foreground/60" />
188 + Requires your own credentials
189 + <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
190 + </button>
191 + </div>
192 +
193 + {/* Copy slugs — separate row, aligned with list content */}
194 + <div className="flex justify-end">
195 <CopyButton toolkits={activeList} />
196 </div>
197
docs/components/toolkits/toolkit-detail.tsx
+24 -37
@@ -2,11 +2,12 @@
2
3 import { useState, useMemo, useEffect, type ReactNode } from 'react';
4 import Link from 'next/link';
5 -import { ExternalLink, Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';
5 +import { Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';
6 import { TypeTable } from 'fumadocs-ui/components/type-table';
7 import type { Toolkit, Tool, Trigger, ParameterSchema } from '@/types/toolkit';
8 import { processSchema } from '@/lib/toolkit-schema';
9 import { PageActions } from '@/components/page-actions';
10 +import { EditOnGitHub } from '@/components/edit-on-github';
11 import { AuthDetailsSection } from '@/components/toolkits/auth-details-section';
12 import { FaqSection, type FaqItem } from '@/components/toolkits/faq-section';
13
@@ -317,56 +318,41 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
318 </Link>
319
320 {/* Header */}
320 - <div className="flex gap-4">
321 + <div className="flex flex-wrap items-start justify-between gap-4">
322 + <div className="flex min-w-0 flex-1 gap-4">
323 <ToolkitIcon key={toolkit.slug} toolkit={toolkit} />
324 <div className="min-w-0 flex-1">
325 {/* Title row */}
324 - <div className="flex flex-wrap items-center justify-between gap-2">
325 - <div className="flex flex-wrap items-center gap-2">
326 - <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>
327 - <button
328 - onClick={copySlug}
329 - className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
330 - >
331 - {toolkit.slug.toUpperCase()}
332 - {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
333 - </button>
334 - </div>
326 + <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
327 + <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>
328 + <button
329 + onClick={copySlug}
330 + className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
331 + >
332 + {toolkit.slug.toUpperCase()}
333 + {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
334 + </button>
335 {toolkit.version && (
336 - <div className="flex items-center gap-2 text-sm text-fd-muted-foreground">
336 + <span className="inline-flex items-center gap-1.5 text-xs text-fd-muted-foreground">
337 <span>Latest version</span>
338 <button
339 onClick={copyVersion}
340 - className="inline-flex items-center gap-1 rounded border border-orange-500/30 bg-orange-500/10 px-1.5 py-0.5 font-mono text-xs text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
340 + className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
341 >
342 {toolkit.version}
343 {versionCopied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
344 </button>
345 - </div>
345 + </span>
346 )}
347 </div>
348
349 {/* Description */}
350 <p className="mt-1.5 text-sm text-fd-muted-foreground">{toolkit.description}</p>
351 -
352 - {/* Actions */}
353 - <div className="mt-4 flex flex-wrap items-center justify-between gap-2">
354 - <div className="flex flex-wrap items-center gap-2">
355 - <Link
356 - href={`https://platform.composio.dev/marketplace/${toolkit.slug}`}
357 - target="_blank"
358 - rel="noopener noreferrer"
359 - className="inline-flex items-center gap-1.5 rounded-md border border-orange-500/30 bg-orange-500/10 px-3 py-1.5 text-sm font-medium text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
360 - >
361 - Try {(toolkit.name?.trim() || toolkit.slug)}
362 - <ExternalLink className="h-3.5 w-3.5" />
363 - </Link>
364 - </div>
365 - </div>
366 -
367 - {/* Page actions */}
368 - <PageActions path={path} />
351 </div>
352 + </div>
353 +
354 + {/* Page actions */}
355 + <PageActions path={path} variant="inline" />
356 </div>
357
358 {/* Authentication Details */}
@@ -392,7 +378,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
378 >
379 Tools ({tools.length})
380 {activeTab === 'tools' && (
395 - <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
381 + <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />
382 )}
383 </button>
384 {triggers.length > 0 && (
@@ -406,7 +392,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
392 >
393 Triggers ({triggers.length})
394 {activeTab === 'triggers' && (
409 - <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
395 + <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />
396 )}
397 </button>
398 )}
@@ -423,7 +409,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
409 autoComplete="off"
410 value={toolSearch}
411 onChange={(e) => setToolSearch(e.target.value)}
426 - className="h-9 w-full rounded-md border border-fd-border bg-fd-background pl-9 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
412 + className="h-9 w-full rounded-md border border-fd-border bg-fd-background pl-9 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
413 />
414 </div>
415
@@ -454,6 +440,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
440 </div>
441 </div>
442 )}
443 + <EditOnGitHub path="docs/components/toolkits/toolkit-detail.tsx" />
444 </div>
445 );
446 }
docs/components/toolkits/toolkits-landing.tsx
+5 -5
@@ -59,7 +59,7 @@ function CopySlugButton({ slug }: { slug: string }) {
59 <button
60 onClick={handleCopy}
61 aria-label={`Copy ${slug.toUpperCase()} to clipboard`}
62 - className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500"
62 + className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500"
63 >
64 <span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
65 {copied ? <Check className="h-3 w-3 text-green-500" aria-hidden="true" /> : <Copy className="h-3 w-3" aria-hidden="true" />}
@@ -154,11 +154,11 @@ export function ToolkitsLanding() {
154 <p className="mt-1.5 text-sm text-fd-muted-foreground sm:mt-2 sm:text-base">
155 Browse {toolkits.length} toolkits supported by Composio
156 </p>
157 - <PageActions path="/toolkits" />
157 </div>
158 <div className="flex flex-wrap items-center gap-2">
159 + <PageActions path="/toolkits" variant="inline" />
160 <a
161 - href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
161 + href="https://dashboard.composio.dev/~/project/playground"
162 target="_blank"
163 rel="noopener noreferrer"
164 className="inline-flex items-center gap-1.5 rounded-md border border-fd-border bg-fd-background px-3 py-1.5 text-sm font-medium text-fd-foreground transition-colors hover:bg-fd-accent"
@@ -170,7 +170,7 @@ export function ToolkitsLanding() {
170 href="https://request.composio.dev/boards/tool-requests"
171 target="_blank"
172 rel="noopener noreferrer"
173 - className="inline-flex items-center gap-1.5 rounded-md border border-orange-500/30 bg-orange-500/10 px-3 py-1.5 text-sm font-medium text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
173 + className="inline-flex items-center gap-1.5 rounded-md border border-blue-500/30 bg-blue-500/10 px-3 py-1.5 text-sm font-medium text-blue-600 transition-colors hover:bg-blue-500/20 dark:text-blue-400"
174 >
175 <Grip className="h-3.5 w-3.5" />
176 Request Tools
@@ -196,7 +196,7 @@ export function ToolkitsLanding() {
196 autoComplete="off"
197 value={search}
198 onChange={(e) => setSearch(e.target.value)}
199 - className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
199 + className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
200 />
201 </div>
202
docs/components/top-nav.tsx
+1 -1
@@ -51,7 +51,7 @@ export function TopNav() {
51 <Link
52 key={item.href}
53 href={item.href}
54 - className={`px-3 py-1.5 text-sm font-medium rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 ${
54 + className={`px-3 py-1.5 text-sm font-medium rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 ${
55 isActive(item.href)
56 ? 'text-[var(--composio-orange)]'
57 : 'text-fd-muted-foreground hover:text-fd-foreground'
docs/content/changelog/04-24-26-trigger-disabled-event.mdx
+1 -1
@@ -21,7 +21,7 @@ The event does not fire when you disable a trigger yourself — neither through
21
22 ## Subscribe
23
24 -Add `composio.trigger.disabled` to your subscription's `enabled_events` — via the [dashboard webhook settings](https://platform.composio.dev?next_page=/settings/webhook) or the Webhook Subscriptions API:
24 +Add `composio.trigger.disabled` to your subscription's `enabled_events` — via the [dashboard webhook settings](https://dashboard.composio.dev/~/project/settings/webhook) or the Webhook Subscriptions API:
25
26 ```bash
27 curl -X PATCH https://backend.composio.dev/api/v3/webhook_subscriptions/ws_your-subscription-id \
docs/content/docs/auth-configuration/white-labeling.mdx
+1 -1
@@ -26,7 +26,7 @@ The Connect Link is the hosted page your users see when connecting their account
26
27 To replace it with your own branding:
28
29 -1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)
29 +1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)
30 2. Upload your **Logo** and set your **App Title**
31
32 This applies to all Connect Link flows across all toolkits. Each project has one logo and app title, so if you need different branding per product, use separate projects.
docs/content/docs/common-faq.mdx
+2 -2
@@ -49,7 +49,7 @@ Create a new session when the config changes: different toolkits, different auth
49 <Accordions>
50
51 <Accordion title="Where can I see all available toolkits?">
52 -You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://platform.composio.dev?next_page=/marketplace). Both list every supported app along with available auth schemes and tools.
52 +You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://dashboard.composio.dev/~/project/toolkits). Both list every supported app along with available auth schemes and tools.
53 </Accordion>
54
55 <Accordion title="What toolkits are available by default in a session?">
@@ -267,7 +267,7 @@ See [Connected accounts](/docs/auth-configuration/connected-accounts#get-account
267 </Accordion>
268
269 <Accordion title="Where can I find execution logs?">
270 -Every tool execution is logged in the [Composio dashboard](https://platform.composio.dev?next_page=/logs/tools) under **Logs > Tools**. Each execution response includes a `log_id` you can use to look up detailed request and response data. Trigger delivery attempts are logged separately under **Logs > Triggers**.
270 +Every tool execution is logged in the [Composio dashboard](https://dashboard.composio.dev/~/project/logs) under **Logs > Tools**. Each execution response includes a `log_id` you can use to look up detailed request and response data. Trigger delivery attempts are logged separately under **Logs > Triggers**.
271
272 See [Troubleshooting tools](/docs/troubleshooting/tools) for how to use logs to debug failed executions.
273 </Accordion>
docs/content/docs/configuring-sessions.mdx
+1 -1
@@ -518,7 +518,7 @@ console.log(mcp.url);
518 </Tab>
519 </Tabs>
520
521 -For framework examples, see provider-specific documentation like [OpenAI Agents](/docs/providers/openai-agents) or [Vercel AI SDK](/docs/providers/vercel).
521 +For framework examples, see provider-specific documentation like [OpenAI](/docs/providers/openai) or [Vercel AI SDK](/docs/providers/vercel).
522
523 ### tools()
524
docs/content/docs/index.mdx
+2 -81
@@ -4,99 +4,20 @@ description: Composio powers 1000+ toolkits, tool search, context management, au
4 keywords: [getting started, introduction]
5 ---
6
7 -Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
8 -
9 -<Cards>
10 - <Card
11 - title="Tutorial: Build a chat app"
12 - href="/cookbooks/chat-app"
13 - description="Build a Next.js chat app where your agent can discover and use tools across 1000+ apps."
14 - />
15 - <Card
16 - title="How Composio works"
17 - href="/docs/how-composio-works"
18 - description="See what happens under the hood when your agent searches, authenticates, and executes a tool."
19 - />
20 -</Cards>
21 -
22 -## Get Started
23 -
24 -<AIToolsBanner />
25 -
26 -<Cards className="grid-cols-1">
27 - <Card
28 - icon={<Rocket />}
29 - title="Quickstart"
30 - href="/docs/quickstart"
31 - description="Install the SDK, connect an app, and run your first tool call in 5 minutes."
32 - />
33 -</Cards>
34 -
35 -## Explore
36 -
37 -<Cards>
38 - <Card
39 - icon={<Wrench />}
40 - title="Toolkits"
41 - href="/toolkits"
42 - description="Browse 1000+ toolkits across GitHub, Gmail, Slack, Notion, and more."
43 - />
44 - <Card
45 - icon={<Play />}
46 - title="Playground"
47 - href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
48 - description="Try Composio in your browser without writing any code."
49 - />
50 -</Cards>
7 +<DocsHero />
8
9 ## Providers
10
11 Composio works with any AI framework. Pick your preferred SDK:
12
13 <ProviderGrid>
57 - <ProviderCard name="Claude Agent SDK" href="/docs/providers/claude-agent-sdk" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
14 <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
59 - <ProviderCard name="OpenAI Agents" href="/docs/providers/openai-agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
15 <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
61 - <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
16 <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
17 + <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
18 <ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />
64 - <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} />
19 <ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} />
20 <ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} />
21 <ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} />
22 <ProviderCard name="Build your own" href="/docs/providers/custom-providers" icon={<Blocks size={32} />} languages={["Python", "TypeScript"]} />
23 </ProviderGrid>
70 -
71 -## Features
72 -
73 -<Cards>
74 - <Card
75 - icon={<Key />}
76 - title="Authentication"
77 - href="/docs/authentication"
78 - description="OAuth, API keys, and custom auth flows"
79 - />
80 - <Card
81 - icon={<Zap />}
82 - title="Triggers"
83 - href="/docs/triggers"
84 - description="Subscribe to external events and trigger workflows"
85 - />
86 - <Card
87 - icon={<Terminal />}
88 - title="CLI"
89 - href="/docs/cli"
90 - description="Manage toolkits, execute tools, and generate type-safe code from the terminal"
91 - />
92 - <Card
93 - icon={<Palette />}
94 - title="White Labeling"
95 - href="/docs/white-labeling-authentication"
96 - description="Customize auth screens with your branding"
97 - />
98 -</Cards>
99 -
100 -## Community
101 -
102 -Join our [Discord](https://discord.gg/composio) community!
docs/content/docs/meta.json
-1
@@ -5,7 +5,6 @@
5 "quickstart",
6 "providers",
7 "cli",
8 - "claude-code-plugin",
8 "---Core Concepts---",
9 "how-composio-works",
10 "users-and-sessions",
docs/content/docs/projects.mdx
+2 -2
@@ -25,7 +25,7 @@ Common reasons to use multiple projects:
25
26 ## Managing projects
27
28 -You can manage projects from the [dashboard](https://platform.composio.dev?next_page=/settings) or via the API using an **organization API key** (`x-org-api-key`).
28 +You can manage projects from the [dashboard](https://dashboard.composio.dev/~/org/) or via the API using an **organization API key** (`x-org-api-key`).
29
30 <Callout type="info">
31 Project management endpoints use the `x-org-api-key` header, not the regular `x-api-key`. You can find your org API key in the dashboard under **Settings > Organization**.
@@ -90,7 +90,7 @@ curl -X PATCH https://backend.composio.dev/api/v3.1/org/project/config \
90 Notable security setting:
91 - `require_mcp_api_key`: when `true`, MCP server requests must include a valid `x-api-key` header. This defaults to `true` for organizations created on or after March 5, 2026.
92
93 -You can also view and update these from **Settings > Project Settings** in the [dashboard](https://platform.composio.dev?next_page=/settings). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
93 +You can also view and update these from **Settings > Project Settings** in the [dashboard](https://dashboard.composio.dev/~/project/settings/general). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
94
95 ## What to read next
96
docs/content/docs/providers/anthropic.mdx
+121 -6
@@ -1,14 +1,19 @@
1 ---
2 title: Anthropic
3 description: Build an agent with Claude and enable it to use 1000+ tools with Composio.
4 -keywords: [claude, messages api]
4 +keywords: [claude, messages api, claude agent sdk, agents sdk]
5 ---
6
7 -The Anthropic Provider transforms Composio tools into a format compatible with the [Claude Messages API](https://docs.anthropic.com/en/api/messages).
7 +Composio integrates with Anthropic through the [Claude Messages API](https://docs.anthropic.com/en/api/messages) and the [Claude Agent SDK](https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk). Pick the tab that matches your integration.
8
9 -<Callout type="info">
10 -Looking for the Claude Agent SDK? See the [Claude Agent SDK](/docs/providers/claude-agent-sdk) provider page.
11 -</Callout>
9 +<IntegrationTabs tabs={[
10 + { value: "messages", label: "Messages API" },
11 + { value: "agent-sdk", label: "Claude Agent SDK" },
12 +]}>
13 +
14 +<IntegrationContent value="messages">
15 +
16 +The Anthropic Provider transforms Composio tools into a format compatible with the Claude Messages API.
17
18 <Steps>
19 <Step>
@@ -32,7 +37,7 @@ npm install @composio/core @composio/anthropic @anthropic-ai/sdk
37 **Configure API Keys**
38
39 <Callout type="info">
35 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
40 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
41 </Callout>
42
43 ```txt title=".env"
@@ -149,6 +154,116 @@ for (const block of response.content) {
154 </Step>
155 </Steps>
156
157 +</IntegrationContent>
158 +
159 +<IntegrationContent value="agent-sdk">
160 +
161 +The Claude Agent SDK provider transforms Composio tools into tools compatible with the Claude Agent SDK.
162 +
163 +<Steps>
164 +<Step>
165 +**Install**
166 +
167 +<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
168 +<Tab value="Python">
169 +```bash
170 +pip install composio composio_claude_agent_sdk claude-agent-sdk
171 +```
172 +</Tab>
173 +<Tab value="TypeScript">
174 +```bash
175 +npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk
176 +```
177 +</Tab>
178 +</Tabs>
179 +</Step>
180 +
181 +<Step>
182 +**Configure API Keys**
183 +
184 +<Callout type="info">
185 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
186 +</Callout>
187 +
188 +```txt title=".env"
189 +COMPOSIO_API_KEY=xxxxxxxxx
190 +ANTHROPIC_API_KEY=xxxxxxxxx
191 +```
192 +</Step>
193 +
194 +<Step>
195 +**Create session and run**
196 +
197 +<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
198 +<Tab value="Python">
199 +```python
200 +import asyncio
201 +from composio import Composio
202 +from composio_claude_agent_sdk import ClaudeAgentSDKProvider
203 +from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server
204 +
205 +composio = Composio(provider=ClaudeAgentSDKProvider())
206 +
207 +# Create a session for your user
208 +session = composio.create(user_id="user_123")
209 +tools = session.tools()
210 +tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
211 +
212 +async def main():
213 + options = ClaudeAgentOptions(
214 + system_prompt="You are a helpful assistant",
215 + permission_mode="bypassPermissions",
216 + mcp_servers={"composio": tool_server},
217 + )
218 +
219 + async with ClaudeSDKClient(options=options) as client:
220 + await client.query("Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")
221 + async for msg in client.receive_response():
222 + print(msg)
223 +
224 +asyncio.run(main())
225 +```
226 +</Tab>
227 +<Tab value="TypeScript">
228 +```js
229 +import { Composio } from '@composio/core';
230 +import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';
231 +import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';
232 +
233 +const composio = new Composio({
234 + provider: new ClaudeAgentSDKProvider(),
235 +});
236 +
237 +// Create a session for your user
238 +const session = await composio.create("user_123");
239 +const tools = await session.tools();
240 +const toolServer = createSdkMcpServer({
241 + name: "composio",
242 + version: "1.0.0",
243 + tools: tools,
244 +});
245 +
246 +for await (const content of query({
247 + prompt: "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
248 + options: {
249 + mcpServers: { composio: toolServer },
250 + permissionMode: "bypassPermissions",
251 + },
252 +})) {
253 + if (content.type === "assistant") {
254 + console.log("Claude:", content.message);
255 + }
256 +}
257 +```
258 +</Tab>
259 +</Tabs>
260 +</Step>
261 +</Steps>
262 +
263 +</IntegrationContent>
264 +
265 +</IntegrationTabs>
266 +
267 ## Multi-turn chat
268
269 For multi-turn apps, create the session once and reuse it across requests with `composio.use()`:
docs/content/docs/providers/autogen.mdx
+1 -1
@@ -19,7 +19,7 @@ pip install composio composio_autogen autogen-agentchat
19 **Configure API Keys**
20
21 <Callout type="info">
22 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
22 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
23 </Callout>
24
25 ```txt title=".env"
docs/content/docs/providers/claude-agent-sdk.mdx deleted
-111
@@ -1,111 +0,0 @@
1 ----
2 -title: Claude Agent SDK
3 -description: Build an agent with the Claude Agent SDK and enable it to use 1000+ tools with Composio.
4 -keywords: [claude agent sdk, claude code]
5 ----
6 -
7 -The Claude Agent SDK provider transforms Composio tools into tools compatible with the [Claude Agent SDK](https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk).
8 -
9 -<Callout type="info">
10 -Looking for the Claude Messages API? See the [Anthropic](/docs/providers/anthropic) provider page.
11 -</Callout>
12 -
13 -<Steps>
14 -<Step>
15 -**Install**
16 -
17 -<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
18 -<Tab value="Python">
19 -```bash
20 -pip install composio composio_claude_agent_sdk claude-agent-sdk
21 -```
22 -</Tab>
23 -<Tab value="TypeScript">
24 -```bash
25 -npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk
26 -```
27 -</Tab>
28 -</Tabs>
29 -</Step>
30 -
31 -<Step>
32 -**Configure API Keys**
33 -
34 -<Callout type="info">
35 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
36 -</Callout>
37 -
38 -```txt title=".env"
39 -COMPOSIO_API_KEY=xxxxxxxxx
40 -ANTHROPIC_API_KEY=xxxxxxxxx
41 -```
42 -</Step>
43 -
44 -<Step>
45 -**Create session and run**
46 -
47 -<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
48 -<Tab value="Python">
49 -```python
50 -import asyncio
51 -from composio import Composio
52 -from composio_claude_agent_sdk import ClaudeAgentSDKProvider
53 -from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server
54 -
55 -composio = Composio(provider=ClaudeAgentSDKProvider())
56 -
57 -# Create a session for your user
58 -session = composio.create(user_id="user_123")
59 -tools = session.tools()
60 -tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
61 -
62 -async def main():
63 - options = ClaudeAgentOptions(
64 - system_prompt="You are a helpful assistant",
65 - permission_mode="bypassPermissions",
66 - mcp_servers={"composio": tool_server},
67 - )
68 -
69 - async with ClaudeSDKClient(options=options) as client:
70 - await client.query("Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")
71 - async for msg in client.receive_response():
72 - print(msg)
73 -
74 -asyncio.run(main())
75 -```
76 -</Tab>
77 -<Tab value="TypeScript">
78 -```js
79 -import { Composio } from '@composio/core';
80 -import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';
81 -import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';
82 -
83 -const composio = new Composio({
84 - provider: new ClaudeAgentSDKProvider(),
85 -});
86 -
87 -// Create a session for your user
88 -const session = await composio.create("user_123");
89 -const tools = await session.tools();
90 -const toolServer = createSdkMcpServer({
91 - name: "composio",
92 - version: "1.0.0",
93 - tools: tools,
94 -});
95 -
96 -for await (const content of query({
97 - prompt: "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
98 - options: {
99 - mcpServers: { composio: toolServer },
100 - permissionMode: "bypassPermissions",
101 - },
102 -})) {
103 - if (content.type === "assistant") {
104 - console.log("Claude:", content.message);
105 - }
106 -}
107 -```
108 -</Tab>
109 -</Tabs>
110 -</Step>
111 -</Steps>
docs/content/docs/providers/crewai.mdx
+1 -1
@@ -19,7 +19,7 @@ pip install composio composio_crewai crewai
19 **Configure API Keys**
20
21 <Callout type="info">
22 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
22 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
23 </Callout>
24
25 ```txt title=".env"
docs/content/docs/providers/google-adk.mdx deleted
-82
@@ -1,82 +0,0 @@
1 ----
2 -title: Google ADK
3 -description: Build an agent with Google ADK and enable it to use 1000+ tools with Composio.
4 -keywords: [google adk, agent development kit, gemini]
5 ----
6 -
7 -The Google ADK provider transforms Composio tools into Google ADK's [FunctionTool](https://google.github.io/adk-docs/) format for use with Google ADK agents.
8 -
9 -<Callout type="info">
10 -Looking for Gemini without ADK? See the [Google Generative AI](/docs/providers/google) provider page.
11 -</Callout>
12 -
13 -<Steps>
14 -<Step>
15 -**Install**
16 -
17 -```bash
18 -pip install composio composio_google_adk google-adk
19 -```
20 -</Step>
21 -
22 -<Step>
23 -**Configure API Keys**
24 -
25 -<Callout type="info">
26 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
27 -</Callout>
28 -
29 -```txt title=".env"
30 -COMPOSIO_API_KEY=xxxxxxxxx
31 -GOOGLE_API_KEY=xxxxxxxxx
32 -```
33 -</Step>
34 -
35 -<Step>
36 -**Create session and run**
37 -
38 -```python
39 -from composio import Composio
40 -from composio_google_adk import GoogleAdkProvider
41 -from google.adk.agents import Agent
42 -from google.adk.runners import Runner
43 -from google.adk.sessions import InMemorySessionService
44 -from google.genai import types
45 -
46 -composio = Composio(provider=GoogleAdkProvider())
47 -
48 -# Create a session for your user
49 -session = composio.create(user_id="user_123")
50 -tools = session.tools()
51 -
52 -agent = Agent(
53 - name="email_agent",
54 - model="gemini-3-pro-preview",
55 - instruction="You are an AI agent that sends emails using Gmail.",
56 - tools=tools,
57 -)
58 -
59 -session_service = InMemorySessionService()
60 -adk_session = session_service.create_session_sync(
61 - app_name="email_agent",
62 - user_id="user_123",
63 - session_id="session_1",
64 -)
65 -runner = Runner(
66 - agent=agent,
67 - app_name="email_agent",
68 - session_service=session_service,
69 -)
70 -
71 -content = types.Content(
72 - role="user",
73 - parts=[types.Part(text="Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")],
74 -)
75 -
76 -events = runner.run(user_id="user_123", session_id="session_1", new_message=content)
77 -for event in events:
78 - if event.is_final_response() and event.content and event.content.parts:
79 - print(event.content.parts[0].text)
80 -```
81 -</Step>
82 -</Steps>
docs/content/docs/providers/google.mdx
+95 -5
@@ -1,10 +1,19 @@
1 ---
2 -title: Google Generative AI
3 -description: Build an agent with Gemini and enable it to use 1000+ tools with Composio.
4 -keywords: [gemini, google generative ai, google genai]
2 +title: Google
3 +description: Build an agent with Gemini or Google ADK and enable it to use 1000+ tools with Composio.
4 +keywords: [gemini, google generative ai, google genai, google adk, agent development kit]
5 ---
6
7 -The Google Generative AI provider transforms Composio tools into a format compatible with [Gemini's function calling](https://ai.google.dev/) capabilities.
7 +Composio integrates with Google through [Gemini function calling](https://ai.google.dev/) and the [Agent Development Kit (ADK)](https://google.github.io/adk-docs/). Pick the tab that matches your integration.
8 +
9 +<IntegrationTabs tabs={[
10 + { value: "gemini", label: "Gemini" },
11 + { value: "adk", label: "ADK" },
12 +]}>
13 +
14 +<IntegrationContent value="gemini">
15 +
16 +The Google Generative AI provider transforms Composio tools into a format compatible with Gemini function calling.
17
18 <Steps>
19 <Step>
@@ -28,7 +37,7 @@ npm install @composio/core @composio/google @google/genai
37 **Configure API Keys**
38
39 <Callout type="info">
31 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
40 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
41 </Callout>
42
43 ```txt title=".env"
@@ -121,3 +130,84 @@ console.log(response.text);
130 </Tabs>
131 </Step>
132 </Steps>
133 +
134 +</IntegrationContent>
135 +
136 +<IntegrationContent value="adk">
137 +
138 +The Google ADK provider transforms Composio tools into Google ADK's FunctionTool format for use with Google ADK agents. ADK integration is Python-only.
139 +
140 +<Steps>
141 +<Step>
142 +**Install**
143 +
144 +```bash
145 +pip install composio composio_google_adk google-adk
146 +```
147 +</Step>
148 +
149 +<Step>
150 +**Configure API Keys**
151 +
152 +<Callout type="info">
153 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
154 +</Callout>
155 +
156 +```txt title=".env"
157 +COMPOSIO_API_KEY=xxxxxxxxx
158 +GOOGLE_API_KEY=xxxxxxxxx
159 +```
160 +</Step>
161 +
162 +<Step>
163 +**Create session and run**
164 +
165 +```python
166 +from composio import Composio
167 +from composio_google_adk import GoogleAdkProvider
168 +from google.adk.agents import Agent
169 +from google.adk.runners import Runner
170 +from google.adk.sessions import InMemorySessionService
171 +from google.genai import types
172 +
173 +composio = Composio(provider=GoogleAdkProvider())
174 +
175 +# Create a session for your user
176 +session = composio.create(user_id="user_123")
177 +tools = session.tools()
178 +
179 +agent = Agent(
180 + name="email_agent",
181 + model="gemini-3-pro-preview",
182 + instruction="You are an AI agent that sends emails using Gmail.",
183 + tools=tools,
184 +)
185 +
186 +session_service = InMemorySessionService()
187 +adk_session = session_service.create_session_sync(
188 + app_name="email_agent",
189 + user_id="user_123",
190 + session_id="session_1",
191 +)
192 +runner = Runner(
193 + agent=agent,
194 + app_name="email_agent",
195 + session_service=session_service,
196 +)
197 +
198 +content = types.Content(
199 + role="user",
200 + parts=[types.Part(text="Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")],
201 +)
202 +
203 +events = runner.run(user_id="user_123", session_id="session_1", new_message=content)
204 +for event in events:
205 + if event.is_final_response() and event.content and event.content.parts:
206 + print(event.content.parts[0].text)
207 +```
208 +</Step>
209 +</Steps>
210 +
211 +</IntegrationContent>
212 +
213 +</IntegrationTabs>
docs/content/docs/providers/index.mdx
+9 -13
@@ -5,27 +5,23 @@ description: Composio works with any AI framework. Pick your preferred SDK to ge
5
6 Composio works with any AI framework. Each provider transforms Composio tools into the native format your framework expects — no glue code needed.
7
8 +## AI SDKs
9 +
10 +<ProviderGrid>
11 + <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
12 + <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
13 + <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
14 + <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
15 +</ProviderGrid>
16 +
17 ## Agent Frameworks
18
19 <ProviderGrid>
20 <ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />
12 - <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} />
21 <ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} />
22 <ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} />
23 <ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} />
24 <ProviderCard name="AutoGen" href="/docs/providers/autogen" languages={["Python"]} />
17 - <ProviderCard name="Google ADK" href="/docs/providers/google-adk" logo="/images/providers/google-logo.svg" languages={["Python"]} />
18 -</ProviderGrid>
19 -
20 -## AI SDKs
21 -
22 -<ProviderGrid>
23 - <ProviderCard name="Claude Agent SDK" href="/docs/providers/claude-agent-sdk" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
24 - <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
25 - <ProviderCard name="OpenAI Agents" href="/docs/providers/openai-agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
26 - <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
27 - <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
28 - <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
25 </ProviderGrid>
26
27 ## Custom
docs/content/docs/providers/langchain.mdx
+69 -4
@@ -1,10 +1,19 @@
1 ---
2 title: LangChain
3 -description: Build an agent with LangChain and enable it to use 1000+ tools with Composio.
4 -keywords: [langchain]
3 +description: Build an agent with LangChain or LangGraph and enable it to use 1000+ tools with Composio.
4 +keywords: [langchain, langgraph]
5 ---
6
7 -The LangChain provider transforms Composio tools into LangChain's [StructuredTool](https://python.langchain.com/docs/how_to/custom_tools/) format with built-in execution.
7 +Composio integrates with [LangChain](https://python.langchain.com/) and [LangGraph](https://langchain-ai.github.io/langgraph/). Pick the tab that matches your integration.
8 +
9 +<IntegrationTabs tabs={[
10 + { value: "langchain", label: "LangChain" },
11 + { value: "langgraph", label: "LangGraph" },
12 +]}>
13 +
14 +<IntegrationContent value="langchain">
15 +
16 +The LangChain provider transforms Composio tools into LangChain's StructuredTool format with built-in execution.
17
18 <Steps>
19 <Step>
@@ -28,7 +37,7 @@ npm install @composio/core @composio/langchain @langchain/openai @langchain/lang
37 **Configure API Keys**
38
39 <Callout type="info">
31 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
40 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
41 </Callout>
42
43 ```txt title=".env"
@@ -116,3 +125,59 @@ console.log(finalState.messages[finalState.messages.length - 1].content);
125 </Tabs>
126 </Step>
127 </Steps>
128 +
129 +</IntegrationContent>
130 +
131 +<IntegrationContent value="langgraph">
132 +
133 +The LangGraph provider transforms Composio tools into LangChain StructuredTool format for use with LangGraph agents. LangGraph integration is Python-only.
134 +
135 +<Steps>
136 +<Step>
137 +**Install**
138 +
139 +```bash
140 +pip install composio composio_langgraph langgraph langchain_openai
141 +```
142 +</Step>
143 +
144 +<Step>
145 +**Configure API Keys**
146 +
147 +<Callout type="info">
148 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
149 +</Callout>
150 +
151 +```txt title=".env"
152 +COMPOSIO_API_KEY=xxxxxxxxx
153 +OPENAI_API_KEY=xxxxxxxxx
154 +```
155 +</Step>
156 +
157 +<Step>
158 +**Create session and run**
159 +
160 +```python
161 +from composio import Composio
162 +from composio_langgraph import LanggraphProvider
163 +from langchain.agents import create_agent
164 +from langchain_openai import ChatOpenAI
165 +
166 +composio = Composio(provider=LanggraphProvider())
167 +llm = ChatOpenAI(model="gpt-5.2")
168 +
169 +# Create a session for your user
170 +session = composio.create(user_id="user_123")
171 +tools = session.tools()
172 +
173 +agent = create_agent(tools=tools, model=llm)
174 +result = agent.invoke({"messages": [("user", "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")]})
175 +
176 +print(result["messages"][-1].content)
177 +```
178 +</Step>
179 +</Steps>
180 +
181 +</IntegrationContent>
182 +
183 +</IntegrationTabs>
docs/content/docs/providers/langgraph.mdx deleted
-53
@@ -1,53 +0,0 @@
1 ----
2 -title: LangGraph
3 -description: Build an agent with LangGraph and enable it to use 1000+ tools with Composio.
4 -keywords: [langgraph]
5 ----
6 -
7 -The LangGraph provider transforms Composio tools into LangChain's [StructuredTool](https://python.langchain.com/docs/how_to/custom_tools/) format for use with [LangGraph](https://langchain-ai.github.io/langgraph/) agents.
8 -
9 -<Steps>
10 -<Step>
11 -**Install**
12 -
13 -```bash
14 -pip install composio composio_langgraph langgraph langchain_openai
15 -```
16 -</Step>
17 -
18 -<Step>
19 -**Configure API Keys**
20 -
21 -<Callout type="info">
22 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
23 -</Callout>
24 -
25 -```txt title=".env"
26 -COMPOSIO_API_KEY=xxxxxxxxx
27 -OPENAI_API_KEY=xxxxxxxxx
28 -```
29 -</Step>
30 -
31 -<Step>
32 -**Create session and run**
33 -
34 -```python
35 -from composio import Composio
36 -from composio_langgraph import LanggraphProvider
37 -from langchain.agents import create_agent
38 -from langchain_openai import ChatOpenAI
39 -
40 -composio = Composio(provider=LanggraphProvider())
41 -llm = ChatOpenAI(model="gpt-5.2")
42 -
43 -# Create a session for your user
44 -session = composio.create(user_id="user_123")
45 -tools = session.tools()
46 -
47 -agent = create_agent(tools=tools, model=llm)
48 -result = agent.invoke({"messages": [("user", "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'")]})
49 -
50 -print(result["messages"][-1].content)
51 -```
52 -</Step>
53 -</Steps>
docs/content/docs/providers/llamaindex.mdx
+1 -1
@@ -28,7 +28,7 @@ npm install @composio/core @composio/llamaindex @llamaindex/openai @llamaindex/w
28 **Configure API Keys**
29
30 <Callout type="info">
31 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
31 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
32 </Callout>
33
34 ```txt title=".env"
docs/content/docs/providers/mastra.mdx
+1 -1
@@ -19,7 +19,7 @@ npm install @composio/core @composio/mastra @mastra/core @ai-sdk/openai
19 **Configure API Keys**
20
21 <Callout type="info">
22 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
22 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
23 </Callout>
24
25 ```txt title=".env"
docs/content/docs/providers/meta.json
+3 -7
@@ -2,19 +2,15 @@
2 "title": "Providers",
3 "pages": [
4 "...",
5 - "claude-agent-sdk",
5 "anthropic",
7 - "openai-agents",
6 "openai",
9 - "autogen",
10 - "crewai",
7 + "vercel",
8 "google",
12 - "google-adk",
9 "langchain",
14 - "langgraph",
10 + "autogen",
11 + "crewai",
12 "llamaindex",
13 "mastra",
17 - "vercel",
14 "custom-providers"
15 ]
16 }
docs/content/docs/providers/openai-agents.mdx deleted
-103
@@ -1,103 +0,0 @@
1 ----
2 -title: OpenAI Agents SDK
3 -description: Build an agent with OpenAI Agents SDK and enable it to use 1000+ tools with Composio.
4 -keywords: [openai agents sdk, agents sdk]
5 ----
6 -
7 -The OpenAI Agents SDK provider transforms Composio tools into the [Agents SDK tool format](https://openai.github.io/openai-agents-python/) with built-in execution.
8 -
9 -<Steps>
10 -<Step>
11 -**Install**
12 -
13 -<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
14 -<Tab value="Python">
15 -```bash
16 -pip install composio composio-openai-agents openai-agents
17 -```
18 -</Tab>
19 -<Tab value="TypeScript">
20 -```bash
21 -npm install @composio/core @composio/openai-agents @openai/agents
22 -```
23 -</Tab>
24 -</Tabs>
25 -</Step>
26 -
27 -<Step>
28 -**Configure API Keys**
29 -
30 -<Callout type="info">
31 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
32 -</Callout>
33 -
34 -```txt title=".env"
35 -COMPOSIO_API_KEY=xxxxxxxxx
36 -OPENAI_API_KEY=xxxxxxxxx
37 -```
38 -</Step>
39 -
40 -<Step>
41 -**Create session and run**
42 -
43 -<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
44 -<Tab value="Python">
45 -```python
46 -import asyncio
47 -from composio import Composio
48 -from composio_openai_agents import OpenAIAgentsProvider
49 -from agents import Agent, Runner
50 -
51 -composio = Composio(provider=OpenAIAgentsProvider())
52 -
53 -# Create a session for your user
54 -session = composio.create(user_id="user_123")
55 -tools = session.tools()
56 -
57 -agent = Agent(
58 - name="Email Agent",
59 - instructions="You are a helpful assistant.",
60 - tools=tools,
61 -)
62 -
63 -async def main():
64 - result = await Runner.run(
65 - starting_agent=agent,
66 - input="Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
67 - )
68 - print(result.final_output)
69 -
70 -asyncio.run(main())
71 -```
72 -</Tab>
73 -<Tab value="TypeScript">
74 -```typescript
75 -import { Composio } from "@composio/core";
76 -import { OpenAIAgentsProvider } from "@composio/openai-agents";
77 -import { Agent, run } from "@openai/agents";
78 -
79 -const composio = new Composio({
80 - provider: new OpenAIAgentsProvider(),
81 -});
82 -
83 -// Create a session for your user
84 -const session = await composio.create("user_123");
85 -const tools = await session.tools();
86 -
87 -const agent = new Agent({
88 - name: "Email Agent",
89 - instructions: "You are a helpful assistant.",
90 - tools,
91 -});
92 -
93 -const result = await run(
94 - agent,
95 - "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'"
96 -);
97 -
98 -console.log(result.finalOutput);
99 -```
100 -</Tab>
101 -</Tabs>
102 -</Step>
103 -</Steps>
docs/content/docs/providers/openai.mdx
+113 -8
@@ -1,21 +1,21 @@
1 ---
2 title: OpenAI
3 description: Build an agent with OpenAI and enable it to use 1000+ tools with Composio.
4 -keywords: [gpt, responses api, chat completions]
4 +keywords: [gpt, responses api, chat completions, openai agents sdk, agents sdk]
5 ---
6
7 -The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI's function calling capabilities through both the Responses and Chat Completion APIs.
8 -
9 -<Callout type="info">
10 -Looking for the OpenAI Agents SDK? See the [OpenAI Agents SDK](/docs/providers/openai-agents) provider page.
11 -</Callout>
7 +Composio integrates with OpenAI through the [Responses API](https://platform.openai.com/docs/api-reference/responses), [Chat Completions API](https://platform.openai.com/docs/api-reference/chat), and [Agents SDK](https://openai.github.io/openai-agents-python/). Pick the tab that matches your integration.
8
9 <IntegrationTabs tabs={[
10 { value: "responses", label: "Responses API" },
11 { value: "chat", label: "Chat Completions" },
12 + { value: "agents", label: "Agents SDK" },
13 ]}>
14
15 <IntegrationContent value="responses">
16 +
17 +The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI function calling through the Responses API.
18 +
19 <Steps>
20 <Step>
21 **Install**
@@ -38,7 +38,7 @@ npm install @composio/core @composio/openai openai
38 **Configure API Keys**
39
40 <Callout type="info">
41 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
41 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
42 </Callout>
43
44 ```txt title=".env"
@@ -161,6 +161,9 @@ for (const item of response.output) {
161 </IntegrationContent>
162
163 <IntegrationContent value="chat">
164 +
165 +The `OpenAIProvider` (Chat Completions) is the default provider used by the Composio SDK when no other provider is specified.
166 +
167 <Steps>
168 <Step>
169 **Install**
@@ -183,7 +186,7 @@ npm install @composio/core @composio/openai openai
186 **Configure API Keys**
187
188 <Callout type="info">
186 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
189 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
190 </Callout>
191
192 ```txt title=".env"
@@ -296,6 +299,108 @@ console.log(response.choices[0].message.content);
299 </Steps>
300 </IntegrationContent>
301
302 +<IntegrationContent value="agents">
303 +
304 +The OpenAI Agents SDK provider transforms Composio tools into the Agents SDK tool format with built-in execution.
305 +
306 +<Steps>
307 +<Step>
308 +**Install**
309 +
310 +<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
311 +<Tab value="Python">
312 +```bash
313 +pip install composio composio-openai-agents openai-agents
314 +```
315 +</Tab>
316 +<Tab value="TypeScript">
317 +```bash
318 +npm install @composio/core @composio/openai-agents @openai/agents
319 +```
320 +</Tab>
321 +</Tabs>
322 +</Step>
323 +
324 +<Step>
325 +**Configure API Keys**
326 +
327 +<Callout type="info">
328 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
329 +</Callout>
330 +
331 +```txt title=".env"
332 +COMPOSIO_API_KEY=xxxxxxxxx
333 +OPENAI_API_KEY=xxxxxxxxx
334 +```
335 +</Step>
336 +
337 +<Step>
338 +**Create session and run**
339 +
340 +<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
341 +<Tab value="Python">
342 +```python
343 +import asyncio
344 +from composio import Composio
345 +from composio_openai_agents import OpenAIAgentsProvider
346 +from agents import Agent, Runner
347 +
348 +composio = Composio(provider=OpenAIAgentsProvider())
349 +
350 +# Create a session for your user
351 +session = composio.create(user_id="user_123")
352 +tools = session.tools()
353 +
354 +agent = Agent(
355 + name="Email Agent",
356 + instructions="You are a helpful assistant.",
357 + tools=tools,
358 +)
359 +
360 +async def main():
361 + result = await Runner.run(
362 + starting_agent=agent,
363 + input="Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
364 + )
365 + print(result.final_output)
366 +
367 +asyncio.run(main())
368 +```
369 +</Tab>
370 +<Tab value="TypeScript">
371 +```typescript
372 +import { Composio } from "@composio/core";
373 +import { OpenAIAgentsProvider } from "@composio/openai-agents";
374 +import { Agent, run } from "@openai/agents";
375 +
376 +const composio = new Composio({
377 + provider: new OpenAIAgentsProvider(),
378 +});
379 +
380 +// Create a session for your user
381 +const session = await composio.create("user_123");
382 +const tools = await session.tools();
383 +
384 +const agent = new Agent({
385 + name: "Email Agent",
386 + instructions: "You are a helpful assistant.",
387 + tools,
388 +});
389 +
390 +const result = await run(
391 + agent,
392 + "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'"
393 +);
394 +
395 +console.log(result.finalOutput);
396 +```
397 +</Tab>
398 +</Tabs>
399 +</Step>
400 +</Steps>
401 +
402 +</IntegrationContent>
403 +
404 </IntegrationTabs>
405
406 ## Multi-turn chat
docs/content/docs/providers/vercel.mdx
+1 -1
@@ -19,7 +19,7 @@ npm install @composio/core @composio/vercel ai @ai-sdk/anthropic
19 **Configure API Keys**
20
21 <Callout type="info">
22 -Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
22 +Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
23 </Callout>
24
25 ```txt title=".env"
docs/content/docs/quickstart.mdx
+1 -350
@@ -6,10 +6,6 @@ keywords: [tutorial, setup, first agent]
6
7 Build your first AI agent with Composio Tools. You'll create a [session](/docs/users-and-sessions) for a user, give your agent access to [tools](/docs/tools-and-toolkits), and let it take action across 1000+ apps.
8
9 -<Callout type="info">
10 -If you are an AI agent setting up Composio for yourself, you can [sign up as an agent](/docs/signing-up-as-an-agent) without a human-created account first.
11 -</Callout>
12 -
9 <QuickstartFlow>
10
11 <FrameworkOption id="openai-agents" name="OpenAI Agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg">
@@ -17,60 +13,6 @@ If you are an AI agent setting up Composio for yourself, you can [sign up as an
13 <IntegrationTabs>
14 <IntegrationContent value="native">
15
20 -<PromptBanner>
21 -**Add Composio tools to an OpenAI Agents app (Native Tools)**
22 -
23 -Give your OpenAI Agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools from that session, and pass them to your Agent.
24 -
25 -**Key concepts**
26 -
27 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
28 -- **Provider**: Translates Composio tools into the framework's tool format. For OpenAI Agents, use `OpenAIAgentsProvider`.
29 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
30 -
31 -**Rules**
32 -
33 -ALWAYS:
34 -- Initialize with `OpenAIAgentsProvider` as the provider
35 -- Create a session with a user ID before getting tools
36 -- Use `session.tools()` to get tools — this returns framework-ready tools
37 -- Store API keys in .env, load with dotenv
38 -
39 -NEVER:
40 -- Hardcode API keys in source code
41 -- Call tools directly without a session
42 -- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
43 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
44 -
45 -**Deprecated (DO NOT use)**
46 -
47 -Python:
48 -```
49 -# WRONG — old direct execution pattern
50 -tools = composio.tools.get(user_id, { toolkits: ['github'] })
51 -result = composio.tools.execute('GITHUB_STAR_REPO', {...})
52 -
53 -# WRONG — old package name
54 -from composio_core import Composio
55 -```
56 -
57 -TypeScript:
58 -```
59 -// WRONG — old direct execution pattern
60 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
61 -const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
62 -```
63 -
64 -**Verify before responding**
65 -
66 -1. Is `OpenAIAgentsProvider` passed to `Composio()`?
67 -2. Is a session created with `composio.create(user_id)`?
68 -3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?
69 -4. Are API keys in .env, not hardcoded?
70 -5. Are imports from `composio` (Python) or `@composio/core` (TS)?
71 -
72 -</PromptBanner>
73 -
16 <Steps>
17 <Step>
18 <StepTitle>Install</StepTitle>
@@ -213,65 +155,6 @@ readline.close();
155 </IntegrationContent>
156 <IntegrationContent value="mcp">
157
216 -<PromptBanner>
217 -**Add Composio tools to an OpenAI Agents app (MCP)**
218 -
219 -Give your OpenAI Agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint. Composio handles authentication, tool discovery, and execution. You create a **session** for a user and pass the MCP connection to your Agent.
220 -
221 -**Key concepts**
222 -
223 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
224 -- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers`. No `@composio/openai-agents` package needed.
225 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
226 -
227 -**Rules**
228 -
229 -ALWAYS:
230 -- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session
231 -- In Python, set `require_approval` to `"never"` in the tool_config
232 -- Create a session with a user ID before accessing `session.mcp`
233 -- Store API keys in .env, load with dotenv
234 -
235 -NEVER:
236 -- Hardcode MCP URLs or headers — they come from the session
237 -- Pass a provider to `Composio()` when using MCP mode (no provider needed)
238 -- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
239 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
240 -
241 -**Deprecated (DO NOT use)**
242 -
243 -Python:
244 -```
245 -# WRONG — old direct execution pattern
246 -tools = composio.tools.get(user_id, { toolkits: ['github'] })
247 -result = composio.tools.execute('GITHUB_STAR_REPO', {...})
248 -
249 -# WRONG — using a provider with MCP (not needed)
250 -composio = Composio(provider=OpenAIAgentsProvider())
251 -
252 -# WRONG — old package name
253 -from composio_core import Composio
254 -```
255 -
256 -TypeScript:
257 -```
258 -// WRONG — old direct execution pattern
259 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
260 -
261 -// WRONG — using a provider with MCP (not needed)
262 -const composio = new Composio({ provider: new OpenAIAgentsProvider() });
263 -```
264 -
265 -**Verify before responding**
266 -
267 -1. Is `Composio()` initialized WITHOUT a provider?
268 -2. Is a session created with `composio.create(user_id)`?
269 -3. Are `session.mcp.url` and `session.mcp.headers` used for the MCP connection?
270 -4. In Python, is `require_approval` set to `"never"`?
271 -5. Are API keys in .env, not hardcoded?
272 -
273 -</PromptBanner>
274 -
158 <Steps>
159 <Step>
160 <StepTitle>Install</StepTitle>
@@ -432,67 +315,6 @@ readline.close();
315 <IntegrationTabs>
316 <IntegrationContent value="native">
317
435 -<PromptBanner>
436 -**Add Composio tools to a Claude Agent SDK app (Native Tools)**
437 -
438 -Give your Claude agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools, wrap them in an SDK MCP server, and pass that server to ClaudeAgentOptions.
439 -
440 -**Key concepts**
441 -
442 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
443 -- **Provider**: Translates Composio tools into the framework's tool format. For Claude Agent SDK, use `ClaudeAgentSDKProvider`.
444 -- **SDK MCP server**: Tools must be wrapped in an SDK MCP server via `create_sdk_mcp_server` / `createSdkMcpServer` before passing to `ClaudeAgentOptions.mcp_servers`. Do NOT pass tools directly.
445 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
446 -
447 -**Rules**
448 -
449 -ALWAYS:
450 -- Initialize with `ClaudeAgentSDKProvider` as the provider
451 -- Create a session with a user ID before getting tools
452 -- Wrap tools in an SDK MCP server before passing to ClaudeAgentOptions
453 -- Use `async/await` — Claude Agent SDK is fully async
454 -- Store API keys in .env, load with dotenv
455 -
456 -NEVER:
457 -- Pass tools directly to ClaudeAgentOptions (must wrap in MCP server first)
458 -- Hardcode API keys in source code
459 -- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
460 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
461 -
462 -**Deprecated (DO NOT use)**
463 -
464 -Python:
465 -```
466 -# WRONG — old direct execution pattern
467 -tools = composio.tools.get(user_id, { toolkits: ['github'] })
468 -result = composio.tools.execute('GITHUB_STAR_REPO', {...})
469 -
470 -# WRONG — passing tools directly without MCP server wrapper
471 -options = ClaudeAgentOptions(tools=tools)
472 -
473 -# WRONG — old package name
474 -from composio_core import Composio
475 -```
476 -
477 -TypeScript:
478 -```
479 -// WRONG — old direct execution pattern
480 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
481 -
482 -// WRONG — passing tools directly without MCP server wrapper
483 -const options = new ClaudeAgentOptions({ tools });
484 -```
485 -
486 -**Verify before responding**
487 -
488 -1. Is `ClaudeAgentSDKProvider` passed to `Composio()`?
489 -2. Is a session created with `composio.create(user_id)`?
490 -3. Are tools wrapped in `create_sdk_mcp_server` / `createSdkMcpServer` before passing to options?
491 -4. Is the code using `async/await`?
492 -5. Are API keys in .env, not hardcoded?
493 -
494 -</PromptBanner>
495 -
318 <Steps>
319 <Step>
320 <StepTitle>Install</StepTitle>
@@ -659,67 +481,6 @@ readline.close();
481 </IntegrationContent>
482 <IntegrationContent value="mcp">
483
662 -<PromptBanner>
663 -**Add Composio tools to a Claude Agent SDK app (MCP)**
664 -
665 -Give your Claude agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint. Composio handles authentication, tool discovery, and execution. You create a **session** for a user and pass the MCP connection to ClaudeAgentOptions.
666 -
667 -**Key concepts**
668 -
669 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
670 -- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers`. No `@composio/claude-agent-sdk` package needed.
671 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
672 -
673 -**Rules**
674 -
675 -ALWAYS:
676 -- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session
677 -- Set MCP server type to `"http"` in the mcp_servers config
678 -- In Python, set `permission_mode` to `"bypassPermissions"` in the mcp_servers config
679 -- Use `async/await` — Claude Agent SDK is fully async
680 -- Store API keys in .env, load with dotenv
681 -
682 -NEVER:
683 -- Hardcode MCP URLs or headers — they come from the session
684 -- Pass a provider to `Composio()` when using MCP mode (no provider needed)
685 -- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
686 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
687 -
688 -**Deprecated (DO NOT use)**
689 -
690 -Python:
691 -```
692 -# WRONG — old direct execution pattern
693 -tools = composio.tools.get(user_id, { toolkits: ['github'] })
694 -result = composio.tools.execute('GITHUB_STAR_REPO', {...})
695 -
696 -# WRONG — using a provider with MCP (not needed)
697 -composio = Composio(provider=ClaudeAgentSDKProvider())
698 -
699 -# WRONG — old package name
700 -from composio_core import Composio
701 -```
702 -
703 -TypeScript:
704 -```
705 -// WRONG — old direct execution pattern
706 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
707 -
708 -// WRONG — using a provider with MCP (not needed)
709 -const composio = new Composio({ provider: new ClaudeAgentSDKProvider() });
710 -```
711 -
712 -**Verify before responding**
713 -
714 -1. Is `Composio()` initialized WITHOUT a provider?
715 -2. Is a session created with `composio.create(user_id)`?
716 -3. Are `session.mcp.url` and `session.mcp.headers` used in the `mcp_servers` config?
717 -4. Is the MCP server type set to `"http"`?
718 -5. Is the code using `async/await`?
719 -6. Are API keys in .env, not hardcoded?
720 -
721 -</PromptBanner>
722 -
484 <Steps>
485 <Step>
486 <StepTitle>Install</StepTitle>
@@ -903,56 +664,6 @@ readline.close();
664 <IntegrationTabs>
665 <IntegrationContent value="native">
666
906 -<PromptBanner>
907 -**Add Composio tools to a Vercel AI SDK app (Native Tools)**
908 -
909 -Give your Vercel AI agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools from that session, and pass them to `streamText` or `generateText`. TypeScript only.
910 -
911 -**Key concepts**
912 -
913 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
914 -- **Provider**: Translates Composio tools into the framework's tool format. For Vercel AI, use `VercelProvider`.
915 -- **streamText vs generateText**: Use `streamText` for streaming responses, `generateText` for single responses. Both accept Composio tools via the `tools` parameter.
916 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
917 -
918 -**Rules**
919 -
920 -ALWAYS:
921 -- Initialize with `VercelProvider` as the provider
922 -- Create a session with a user ID before getting tools
923 -- Use `session.tools()` to get tools — this returns Vercel AI-compatible tools
924 -- Use `streamText` or `generateText` from the `ai` package
925 -- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)
926 -- Store API keys in .env, load with dotenv
927 -
928 -NEVER:
929 -- Hardcode API keys in source code
930 -- Call tools directly without a session
931 -- Import from `composio-core` (the package is `@composio/core`)
932 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
933 -- Forget `maxSteps` — without it, the model won't execute tool calls
934 -
935 -**Deprecated (DO NOT use)**
936 -
937 -```
938 -// WRONG — old direct execution pattern
939 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
940 -const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
941 -
942 -// WRONG — missing maxSteps (model won't execute tool calls)
943 -const result = await generateText({ model, tools, prompt });
944 -```
945 -
946 -**Verify before responding**
947 -
948 -1. Is `VercelProvider` passed to `Composio()`?
949 -2. Is a session created with `composio.create(userId)`?
950 -3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?
951 -4. Is `maxSteps` set in `streamText` / `generateText`?
952 -5. Are API keys in .env, not hardcoded?
953 -
954 -</PromptBanner>
955 -
667 <Steps>
668 <Step>
669 <StepTitle>Install</StepTitle>
@@ -1047,60 +758,6 @@ readline.close();
758 </IntegrationContent>
759 <IntegrationContent value="mcp">
760
1050 -<PromptBanner>
1051 -**Add Composio tools to a Vercel AI SDK app (MCP)**
1052 -
1053 -Give your Vercel AI agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint using `@ai-sdk/mcp`. Composio handles authentication, tool discovery, and execution. TypeScript only.
1054 -
1055 -**Key concepts**
1056 -
1057 -- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
1058 -- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers` via `@ai-sdk/mcp`. No `@composio/vercel` package needed.
1059 -- **Client lifecycle**: Always close the MCP client with `await client.close()` when done.
1060 -- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
1061 -
1062 -**Rules**
1063 -
1064 -ALWAYS:
1065 -- Use `mcp.url` and `mcp.headers` from the session object returned by `composio.create(userId)`
1066 -- Set transport type to `"http"` in createMCPClient
1067 -- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)
1068 -- Close the MCP client when done: `await client.close()`
1069 -- Store API keys in .env, load with dotenv
1070 -
1071 -NEVER:
1072 -- Hardcode MCP URLs or headers — they come from the session
1073 -- Pass a provider to `Composio()` when using MCP mode (no provider needed)
1074 -- Import from `composio-core` (the package is `@composio/core`)
1075 -- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
1076 -- Forget `maxSteps` — without it, the model won't execute tool calls
1077 -- Forget `await client.close()` — this leaks the MCP connection
1078 -
1079 -**Deprecated (DO NOT use)**
1080 -
1081 -```
1082 -// WRONG — old direct execution pattern
1083 -const tools = composio.tools.get(userId, { toolkits: ['github'] });
1084 -const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
1085 -
1086 -// WRONG — using a provider with MCP (not needed)
1087 -const composio = new Composio({ provider: new VercelProvider() });
1088 -
1089 -// WRONG — missing maxSteps (model won't execute tool calls)
1090 -const result = await generateText({ model, tools, prompt });
1091 -```
1092 -
1093 -**Verify before responding**
1094 -
1095 -1. Is `Composio()` initialized WITHOUT a provider?
1096 -2. Are `mcp.url` and `mcp.headers` taken from the session returned by `composio.create(userId)`?
1097 -3. Is transport type `"http"` in `createMCPClient`?
1098 -4. Is `maxSteps` set in `streamText` / `generateText`?
1099 -5. Is `client.close()` called when done?
1100 -6. Are API keys in .env, not hardcoded?
1101 -
1102 -</PromptBanner>
1103 -
761 <Steps>
762 <Step>
763 <StepTitle>Install</StepTitle>
@@ -1210,13 +867,7 @@ readline.close();
867
868 </QuickstartFlow>
869
1213 -<Callout type="info">
1214 -By default, sessions have access to **all available toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. To restrict which toolkits are available, see [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
1215 -</Callout>
1216 -
1217 -<Callout>
1218 -Every `composio.create()` call returns a new session ID. For multi-turn conversations or web apps, store the session ID and call `composio.use(sessionId)` on subsequent requests instead of creating a new session each time. See [Reusing a session](/docs/users-and-sessions#reusing-a-session).
1219 -</Callout>
870 +By default, each `composio.create()` call returns a new session with access to all toolkits. Sessions are highly configurable beyond that: [Reusing a session](/docs/users-and-sessions#reusing-a-session) covers storing a session ID and calling `composio.use()` across multi-turn requests, while [Configuring Sessions](/docs/configuring-sessions) covers restricting toolkits, auth configs, and connected accounts.
871
872 ## Next steps
873
docs/content/docs/setting-up-triggers/creating-triggers.mdx
+1 -1
@@ -235,7 +235,7 @@ Trigger instances default to the `'latest'` toolkit version. If your code parses
235
236 ## Using the dashboard
237
238 -1. Navigate to [Auth Configs](https://platform.composio.dev?next_page=%2Fauth-configs) and select the auth config for the relevant toolkit
238 +1. Navigate to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select the auth config for the relevant toolkit
239 2. Navigate to **Active Triggers** and click **Create Trigger**
240 3. Select the connected account for which you want to create a trigger
241 4. Choose a trigger type and fill in the required configuration
docs/content/docs/setting-up-triggers/managing-triggers.mdx
+1 -1
@@ -87,7 +87,7 @@ await composio.triggers.enable('ti_abcd123');
87
88 You can also toggle triggers from the dashboard:
89
90 -1. Go to [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) and select your auth config
90 +1. Go to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select your auth config
91 2. Navigate to **Active Triggers**
92 3. Toggle the trigger on or off
93
docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+1 -1
@@ -14,7 +14,7 @@ Webhooks are the recommended way to receive trigger events in production. To sta
14 | `composio.connected_account.expired` | Fired when a connected account expires and needs re-authentication. See [Subscribing to connection expiry events](/docs/subscribing-to-connection-expiry-events). |
15 | `composio.trigger.disabled` | **Fired when** Composio automatically disables a trigger — expired connection, webhook refresh failure, or unhealthy polling. **Not fired when** you disable a trigger through the manage API or deactivate its connected account via `PATCH /api/v3/connected_accounts/{id}/status`. |
16
17 -Set your webhook URL in the [dashboard settings](https://platform.composio.dev?next_page=/settings/webhook) or via the [Webhook Subscriptions API](/reference/api-reference/webhook-subscriptions):
17 +Set your webhook URL in the [dashboard settings](https://dashboard.composio.dev/~/project/settings/webhook) or via the [Webhook Subscriptions API](/reference/api-reference/webhook-subscriptions):
18
19 ```bash
20 curl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \
docs/content/docs/single-toolkit-mcp.mdx
+1 -1
@@ -93,7 +93,7 @@ console.log(`Server created: ${server.id}`);
93 </Tabs>
94
95 <Callout type="info">
96 - You can also create and manage MCP configs from the [Composio dashboard](https://platform.composio.dev?next_page=/mcp-configs).
96 + You can also create and manage MCP configs from the [Composio dashboard](https://dashboard.composio.dev/~/org/connect/clients).
97 </Callout>
98 </Step>
99
docs/content/docs/tools-direct/authenticating-tools.mdx
+1 -1
@@ -25,7 +25,7 @@ An **Auth Config** is a blueprint that defines how authentication works for a to
25 <Step>
26 <StepTitle>Selecting a toolkit</StepTitle>
27
28 -Navigate to [Auth Configs](https://platform.composio.dev?next_page=%2Fauth-configs) tab in your dashboard and click "**Create Auth Config**". Find and select the toolkit you want to integrate (e.g., **Gmail**, **Slack**, **GitHub**).
28 +Navigate to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) tab in your dashboard and click "**Create Auth Config**". Find and select the toolkit you want to integrate (e.g., **Gmail**, **Slack**, **GitHub**).
29 </Step>
30
31 <Step>
docs/content/docs/tools-direct/executing-tools.mdx
+1 -1
@@ -190,7 +190,7 @@ If you just want to call a tool without using any framework or LLM provider, you
190 <Callout type="info">
191 **Finding tool parameters and types:**
192
193 -**Platform UI**: [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) → Select your toolkit → Tools & Triggers → Select the tool to see its required and optional parameters
193 +**Platform UI**: [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) → Select your toolkit → Tools & Triggers → Select the tool to see its required and optional parameters
194
195 **CLI**: For Python and TypeScript projects, run `composio generate` to generate types. [Learn more →](/docs/cli#generate-type-definitions)
196 </Callout>
docs/content/docs/troubleshooting/index.mdx
+1 -1
@@ -12,7 +12,7 @@ This section is designed to help you quickly identify and resolve common issues
12 <Accordions>
13
14 <Accordion title="How do I find the log ID for a failed tool execution?">
15 -Every tool execution response includes a `log_id` field. You can also find it in the [dashboard logs](https://platform.composio.dev?next_page=/logs/tools) under **Logs > Tools**. Use this ID when reporting issues to support.
15 +Every tool execution response includes a `log_id` field. You can also find it in the [dashboard logs](https://dashboard.composio.dev/~/project/logs) under **Logs > Tools**. Use this ID when reporting issues to support.
16
17 See [Troubleshooting tools](/docs/troubleshooting/tools#reporting-tool-issues) for more details.
18 </Accordion>
docs/content/docs/troubleshooting/triggers.mdx
+1 -1
@@ -12,7 +12,7 @@ Check the error message — the connected account might not have sufficient perm
12 - **Polling triggers** (e.g., Gmail): These check for new events on an interval you configure. For Composio managed auth, intervals below 15 minutes are not supported.
13 - **Webhook URL**: Ensure your URL is publicly accessible and returns a `2xx` status code.
14 - **Trigger status**: Verify the trigger is enabled, not disabled.
15 -- **Logs**: Check the [trigger logs](https://platform.composio.dev?next_page=/logs/triggers) in the dashboard for delivery attempts and errors.
15 +- **Logs**: Check the [trigger logs](https://dashboard.composio.dev/~/project/logs?tab=triggers) in the dashboard for delivery attempts and errors.
16
17 ## Type errors with trigger payloads
18
docs/content/docs/white-labeling-authentication.mdx
+1 -1
@@ -21,7 +21,7 @@ The Connect Link is the hosted page your users see when connecting their account
21
22 To replace it with your own branding:
23
24 -1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)
24 +1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)
25 2. Upload your **Logo** and set your **App Title**
26
27 This applies to all Connect Link flows across all toolkits, for both [in-chat](/docs/authenticating-users/in-chat-authentication) and [manual](/docs/authenticating-users/manually-authenticating) authentication. Each project has one logo and app title, so if you need different branding per product, use separate projects.
docs/content/toolkits/premium-tools.mdx
+15 -37
@@ -1,36 +1,24 @@
1 ---
2 title: Premium Tools
3 -description: Learn about premium tools, pricing, and limits in Composio
3 +description: Pricing and limits for premium tools in Composio
4 ---
5
6 -This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.
6 +Some tool calls cost more to run — search APIs, code sandboxes, ML inference. We call those premium tools and price them separately.
7
8 -## What are premium tools?
8 +## What counts as a premium tool?
9
10 -Premium tools are essential tool calls that cost us more to run, normally paying for more premium services or longer running tasks.
10 +<Cards>
11 + <Card icon={<Search />} title="Search APIs" href="/toolkits/composio_search" description="Composio Search, Perplexity, Exa, SerpAPI" />
12 + <Card icon={<Code />} title="Code execution" href="/toolkits/codeinterpreter" description="Sandboxed runtimes like E2B" />
13 + <Card icon={<Database />} title="Web scraping & data extraction" description="Crawlers and structured extraction" />
14 + <Card icon={<Zap />} title="AI/ML inference" description="Hosted model calls and embeddings" />
15 + <Card icon={<Wrench />} title="Document processing & OCR" description="PDF, image, and document parsing" />
16 + <Card icon={<Rocket />} title="Compute-intensive operations" description="Long-running or heavy transforms" />
17 +</Cards>
18
12 -Think something like `E2B` or `Perplexity`, these are not really comparable to a `GMAIL_SEND_EMAIL` call.
19 +## Pricing
20
14 -These types of tools are separated out so we can price both of them competitively.
15 -
16 -Premium tools include:
17 -
18 -- Search APIs (Google, Bing, Perplexity, etc.)
19 - - [Composio Search](/toolkits/composio_search)
20 - - [Perplexity](/toolkits/perplexityai)
21 - - [Exa](/toolkits/exa)
22 - - [SerpAPI](/toolkits/serpapi)
23 -- Code execution environments (E2B)
24 - - [Code Interpreter (E2B)](/toolkits/codeinterpreter)
25 -- Web scraping & data extraction
26 -- AI/ML model inference
27 -- Document processing & OCR
28 -- Advanced data transformations
29 -- Compute-intensive operations
30 -
31 -## How are premium tools priced?
32 -
33 -As a rough guide, they are priced at 3x the cost of a standard tool call — the specifics depends on your plan and the tool.
21 +Premium tool calls are roughly 3x the cost of a standard tool call. Full pricing is on the [pricing page](https://composio.dev/pricing).
22
23 | Plan | Included Standard Tool Calls | Included Premium Tool Calls | Usage Based Standard Tool Calls | Usage Based Premium Tool Calls |
24 |------|------------------------------|-----------------------------|---------------------------------|--------------------------------|
@@ -39,22 +27,12 @@ As a rough guide, they are priced at 3x the cost of a standard tool call — the
27 | Serious Business | 2M | 50k | $0.249/1k | $0.747/1k |
28 | Enterprise | Flexible | Flexible | Flexible | Flexible |
29
42 -This is a quick call out — full pricing details are on the [pricing page](https://composio.dev/pricing).
43 -
44 -## What limits do premium tools have?
30 +## Rate limits
31
46 -Premium tools are also subject to lower rate limits than standard tool calls.
47 -
48 -If you need more than the default limits, please [contact us](mailto:billing@composio.dev) and we can find a workable solution.
32 +Premium tools have lower rate limits than standard tool calls. If you need more, [contact us](mailto:billing@composio.dev).
33
34 | Spending Tier | Standard Tool Calls Rate Limit | Premium Tool Calls Rate Limit |
35 |---------------|--------------------------------|-------------------------------|
36 | Free | 100/min | 1,000/hour |
37 | Paid | 5,000/min | 10,000/hour |
38 | Enterprise | Custom | Custom |
55 -
56 -## Feedback on premium tools
57 -
58 -These pricing changes are not rolling out immediately, and we are very open to feedback on the pricing and the limits.
59 -
60 -There is a lot of room for improvement and iteration here, please reach out if you have suggestions [here](mailto:rahul@composio.dev).
docs/lib/create-docs-page.tsx
+3 -1
@@ -8,12 +8,13 @@ import { getMDXComponents } from '@/mdx-components';
8 import type { Metadata } from 'next';
9 import { createRelativeLink } from 'fumadocs-ui/mdx';
10 import { PageActions } from '@/components/page-actions';
11 +import { EditOnGitHub } from '@/components/edit-on-github';
12 import { getOgImageUrl } from '@/lib/source';
13
14 // eslint-disable-next-line @typescript-eslint/no-explicit-any
15 type Source = any;
16
16 -export function createDocsPage(source: Source) {
17 +export function createDocsPage(source: Source, contentDir: string = 'content/docs') {
18 return async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
19 const { slug } = await params;
20 const page = source.getPage(slug);
@@ -31,6 +32,7 @@ export function createDocsPage(source: Source) {
32 a: createRelativeLink(source, page),
33 })}
34 />
35 + <EditOnGitHub path={`docs/${contentDir}/${page.path}`} />
36 </DocsBody>
37 </DocsPage>
38 );
docs/lib/layout.shared.tsx
+2 -1
@@ -36,6 +36,7 @@ export function baseOptions(): BaseLayoutProps {
36 title: <ComposioLogo />,
37 transparentMode: 'top',
38 },
39 + themeSwitch: { enabled: false },
40 searchToggle: {
41 components: {
42 lg: <SearchAndAskAI />,
@@ -84,7 +85,7 @@ export function baseOptions(): BaseLayoutProps {
85 Playground
86 </span>
87 ),
87 - url: 'https://platform.composio.dev/auth?next_page=%2Ftool-router&utm_source=docs&utm_medium=navbar&utm_campaign=tool_router',
88 + url: 'https://dashboard.composio.dev/~/project/playground?utm_source=docs&utm_medium=navbar&utm_campaign=playground',
89 external: true,
90 secondary: true,
91 },
docs/lib/source.ts
-2
@@ -213,8 +213,6 @@ export function mdxToCleanMarkdown(content: string): string {
213 (_, name, content) => `### ${name}\n\n${content.trim()}`
214 );
215
216 - result = result.replace(/<PromptBanner[\s\S]*?<\/PromptBanner>/g, '');
217 -
216 result = result.replace(
217 /<AIToolsBanner\s*\/>/g,
218 '### For AI tools\n\n' +
docs/mdx-components.tsx
+6 -3
@@ -3,14 +3,14 @@ import type { MDXComponents } from 'mdx/types';
3 import type { ComponentProps } from 'react';
4 import { Accordion as BaseAccordion, Accordions } from 'fumadocs-ui/components/accordion';
5 import { Tabs, Tab, TabsList, TabsTrigger, TabsContent } from 'fumadocs-ui/components/tabs';
6 -import { Callout } from 'fumadocs-ui/components/callout';
6 +import { Callout } from '@/components/callout';
7 import { Step, Steps } from 'fumadocs-ui/components/steps';
8 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';
13 -import { FrameworkSelector, QuickstartFlow, FrameworkOption, PromptBanner } from '@/components/quickstart';
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';
16 import { ConnectFlow, ConnectClientOption } from '@/components/connect-flow';
@@ -23,6 +23,7 @@ import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
23 import { ManagedAuthList } from '@/components/toolkits/managed-auth-list';
24 import { Mermaid } from '@/components/mermaid';
25 import { AIToolsBanner } from '@/components/ai-tools-banner';
26 +import { DocsHero } from '@/components/docs-hero';
27 import { Glossary, GlossaryTerm } from '@/components/glossary';
28 import { ApiBaseUrl } from '@/components/api-base-url';
29 import { ApiEndpointsTable } from '@/components/api-endpoints-table';
@@ -30,6 +31,7 @@ import {
31 ShieldCheck,
32 Route as RouteIcon,
33 Key,
34 + Search,
35 Wrench,
36 Database,
37 Zap,
@@ -83,7 +85,6 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
85 FrameworkOption,
86 IntegrationTabs,
87 IntegrationContent,
86 - PromptBanner,
88 ToolTypeFlow,
89 ToolTypeOption,
90 ConnectFlow,
@@ -98,6 +99,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
99 ManagedAuthList,
100 Mermaid,
101 AIToolsBanner,
102 + DocsHero,
103 StepTitle,
104 Glossary,
105 GlossaryTerm,
@@ -107,6 +109,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
109 ShieldCheck,
110 RouteIcon,
111 Key,
112 + Search,
113 Wrench,
114 Database,
115 Zap,
docs/next.config.mjs
+36 -1
@@ -156,6 +156,16 @@ const config = {
156 destination: '/docs/providers/google',
157 permanent: true,
158 },
159 + {
160 + source: '/providers/google-adk',
161 + destination: '/docs/providers/google',
162 + permanent: true,
163 + },
164 + {
165 + source: '/docs/providers/google-adk',
166 + destination: '/docs/providers/google',
167 + permanent: true,
168 + },
169 {
170 source: '/providers/langchain',
171 destination: '/docs/providers/langchain',
@@ -178,7 +188,32 @@ const config = {
188 },
189 {
190 source: '/providers/openai-agents',
181 - destination: '/docs/providers/openai-agents',
191 + destination: '/docs/providers/openai',
192 + permanent: true,
193 + },
194 + {
195 + source: '/providers/claude-agent-sdk',
196 + destination: '/docs/providers/anthropic',
197 + permanent: true,
198 + },
199 + {
200 + source: '/docs/providers/openai-agents',
201 + destination: '/docs/providers/openai',
202 + permanent: true,
203 + },
204 + {
205 + source: '/docs/providers/claude-agent-sdk',
206 + destination: '/docs/providers/anthropic',
207 + permanent: true,
208 + },
209 + {
210 + source: '/providers/langgraph',
211 + destination: '/docs/providers/langchain',
212 + permanent: true,
213 + },
214 + {
215 + source: '/docs/providers/langgraph',
216 + destination: '/docs/providers/langchain',
217 permanent: true,
218 },
219 {
docs/public/fonts/ABCDiatype-Medium.woff2
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-Medium.woff2 differ
docs/public/fonts/ABCDiatype-Regular.woff2
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-Regular.woff2 differ
docs/public/fonts/ABCDiatype-RegularItalic.woff2
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-RegularItalic.woff2 differ
docs/public/images/hero/managed-auth.png
Binary files /dev/null and b/docs/public/images/hero/managed-auth.png differ
docs/public/images/hero/shader.jpg
Binary files /dev/null and b/docs/public/images/hero/shader.jpg differ
docs/public/images/hero/triggers.png
Binary files /dev/null and b/docs/public/images/hero/triggers.png differ
docs/tests/integration/redirects.test.ts
+7
@@ -14,6 +14,13 @@ const REDIRECTS = [
14 { from: "/api-reference", to: "/reference" },
15 { from: "/providers/openai", to: "/docs/providers/openai" },
16 { from: "/providers/anthropic", to: "/docs/providers/anthropic" },
17 + { from: "/providers/openai-agents", to: "/docs/providers/openai" },
18 + { from: "/docs/providers/openai-agents", to: "/docs/providers/openai" },
19 + { from: "/docs/providers/claude-agent-sdk", to: "/docs/providers/anthropic" },
20 + { from: "/providers/google-adk", to: "/docs/providers/google" },
21 + { from: "/docs/providers/google-adk", to: "/docs/providers/google" },
22 + { from: "/providers/langgraph", to: "/docs/providers/langchain" },
23 + { from: "/docs/providers/langgraph", to: "/docs/providers/langchain" },
24 { from: "/tools", to: "/toolkits" },
25 { from: "/docs/fetching-tools", to: "/docs/tools-direct/fetching-tools" },
26 { from: "/docs/custom-tools", to: "/docs/tools-direct/custom-tools" },
docs/tests/static/quickstart-prompts.test.ts deleted
-115
@@ -1,115 +0,0 @@
1 -/**
2 - * Quickstart PromptBanner static validation.
3 - *
4 - * Validates prompt content quality directly from the MDX source:
5 - * - All 6 integration variants have prompts
6 - * - Each prompt has the required sections (concepts, rules, deprecated, verify)
7 - * - Prompts contain code examples (deprecated patterns)
8 - * - No markdown headings leak into TOC
9 - * - PromptBanner is stripped from LLM .md output
10 - */
11 -import { describe, test, expect } from "bun:test";
12 -import { readFile } from "fs/promises";
13 -import { join } from "path";
14 -import { mdxToCleanMarkdown } from "../../lib/source";
15 -
16 -const QUICKSTART_PATH = join(
17 - import.meta.dir,
18 - "../../content/docs/quickstart.mdx"
19 -);
20 -
21 -let rawContent: string;
22 -let blocks: string[];
23 -
24 -describe("Quickstart PromptBanner", () => {
25 - test("quickstart.mdx has 6 PromptBanner blocks (one per integration variant)", async () => {
26 - rawContent = await readFile(QUICKSTART_PATH, "utf-8");
27 - blocks =
28 - rawContent.match(/<PromptBanner>([\s\S]*?)<\/PromptBanner>/g) ?? [];
29 - expect(blocks.length).toBe(6);
30 - });
31 -
32 - test("each prompt has required sections", () => {
33 - const required = [
34 - "**Key concepts**",
35 - "**Rules**",
36 - "ALWAYS:",
37 - "NEVER:",
38 - "**Deprecated",
39 - "**Verify before responding**",
40 - ];
41 - const errors: string[] = [];
42 -
43 - for (let i = 0; i < blocks.length; i++) {
44 - for (const section of required) {
45 - if (!blocks[i].includes(section)) {
46 - errors.push(`Prompt #${i + 1}: missing "${section}"`);
47 - }
48 - }
49 - }
50 -
51 - expect(errors).toEqual([]);
52 - });
53 -
54 - test("each prompt has code in deprecated section", () => {
55 - const errors: string[] = [];
56 -
57 - for (let i = 0; i < blocks.length; i++) {
58 - const afterDeprecated = blocks[i].split("**Deprecated")[1] ?? "";
59 - const hasCodeFence = afterDeprecated.includes("```");
60 - if (!hasCodeFence) {
61 - errors.push(`Prompt #${i + 1}: deprecated section has no code examples`);
62 - }
63 - }
64 -
65 - expect(errors).toEqual([]);
66 - });
67 -
68 - test("each prompt mentions session-based pattern", () => {
69 - const errors: string[] = [];
70 -
71 - for (let i = 0; i < blocks.length; i++) {
72 - if (!blocks[i].includes("session") && !blocks[i].includes("Session")) {
73 - errors.push(`Prompt #${i + 1}: doesn't mention sessions`);
74 - }
75 - }
76 -
77 - expect(errors).toEqual([]);
78 - });
79 -
80 - test("each prompt warns against deprecated composio.tools.get()", () => {
81 - const errors: string[] = [];
82 -
83 - for (let i = 0; i < blocks.length; i++) {
84 - if (!blocks[i].includes("composio.tools.get()")) {
85 - errors.push(`Prompt #${i + 1}: missing composio.tools.get() deprecation warning`);
86 - }
87 - }
88 -
89 - expect(errors).toEqual([]);
90 - });
91 -
92 - test("no markdown headings inside prompts (would pollute TOC)", () => {
93 - const errors: string[] = [];
94 -
95 - for (let i = 0; i < blocks.length; i++) {
96 - const withoutCode = blocks[i].replace(/```[\s\S]*?```/g, "");
97 - const heading = withoutCode.match(/^#{1,6}\s+/m);
98 - if (heading) {
99 - errors.push(
100 - `Prompt #${i + 1}: contains heading "${heading[0].trim()}" — use **bold** instead`
101 - );
102 - }
103 - }
104 -
105 - expect(errors).toEqual([]);
106 - });
107 -
108 - test("mdxToCleanMarkdown strips all PromptBanner blocks from .md output", () => {
109 - const cleaned = mdxToCleanMarkdown(rawContent);
110 - expect(cleaned).not.toContain("<PromptBanner>");
111 - expect(cleaned).not.toContain("</PromptBanner>");
112 - expect(cleaned).not.toContain("ALWAYS:");
113 - expect(cleaned).not.toContain("Deprecated (DO NOT use)");
114 - });
115 -});