Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: tidy welcome page, fix playground link, hide ugly Ask AI tab (#3455)
Rahul Tarak9acfa852b2f7
diff --git a/docs/app/(home)/docs/[[...slug]]/page.tsx b/docs/app/(home)/docs/[[...slug]]/page.tsxindex 330e22fe9..705c2f0e7 100644--- a/docs/app/(home)/docs/[[...slug]]/page.tsx+++ b/docs/app/(home)/docs/[[...slug]]/page.tsx@@ -9,6 +9,7 @@ import { getMDXComponents } from '@/mdx-components';import type { Metadata } from 'next';import { createRelativeLink } from 'fumadocs-ui/mdx';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {const params = await props.params;@@ -18,11 +19,21 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {// eslint-disable-next-line @typescript-eslint/no-explicit-anyconst data = page.data as any;const MDX = data.body;+ const isLanding = !params.slug || params.slug.length === 0;return (- <DocsPage toc={data.toc} full={data.full} footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>- <DocsTitle>{data.title}</DocsTitle>- <PageActions path={page.url} />+ <DocsPage+ toc={data.toc}+ full={isLanding ? true : data.full}+ footer={{ enabled: false }}+ tableOfContentPopover={{ enabled: false }}+ >+ {!isLanding && (+ <>+ <DocsTitle>{data.title}</DocsTitle>+ <PageActions path={page.url} />+ </>+ )}<DocsBody><MDXcomponents={getMDXComponents({@@ -30,6 +41,7 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {a: createRelativeLink(source, page),})}/>+ {!isLanding && <EditOnGitHub path={`docs/content/docs/${page.path}`} />}</DocsBody></DocsPage>);diff --git a/docs/app/(home)/docs/changelog/[...slug]/page.tsx b/docs/app/(home)/docs/changelog/[...slug]/page.tsxindex 7bbb7b17a..9bcc53f5a 100644--- a/docs/app/(home)/docs/changelog/[...slug]/page.tsx+++ b/docs/app/(home)/docs/changelog/[...slug]/page.tsx@@ -10,6 +10,7 @@ import { notFound } from 'next/navigation';import Link from 'next/link';import { ChevronLeft } from 'lucide-react';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';const mdxComponents = getMDXComponents();@@ -66,6 +67,9 @@ export default async function ChangelogEntryPage({ params }: PageProps) {);})}</div>+ {matchingEntries[0] && (+ <EditOnGitHub path={`docs/content/changelog/${matchingEntries[0].info.path}`} />+ )}</DocsBody></DocsPage>);diff --git a/docs/app/(home)/docs/changelog/page.tsx b/docs/app/(home)/docs/changelog/page.tsxindex 9b9bcf32f..5c7f44d6b 100644--- a/docs/app/(home)/docs/changelog/page.tsx+++ b/docs/app/(home)/docs/changelog/page.tsx@@ -27,6 +27,7 @@ import {} from 'fumadocs-ui/layouts/docs/page';import { CopyLink } from '@/components/copy-link';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';const mdxComponents = getMDXComponents();@@ -54,7 +55,7 @@ export default function ChangelogPage() {<div className="mb-3 md:absolute md:left-0 md:w-28 md:text-right md:pr-6"><CopyLinkhref={dateToChangelogUrl(entry.date)}- className="text-sm font-medium text-orange-500 hover:text-orange-600 transition-colors"+ className="text-sm font-medium text-blue-500 hover:text-blue-600 transition-colors">{formatDate(entry.date)}</CopyLink>@@ -77,6 +78,7 @@ export default function ChangelogPage() {})}</div></div>+ <EditOnGitHub path="docs/app/(home)/docs/changelog/page.tsx" /></DocsBody></DocsPage>);diff --git a/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx b/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsxindex d52982d97..d6713e4e3 100644--- a/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx+++ b/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx@@ -11,6 +11,7 @@ import type { Metadata } from 'next';import { createRelativeLink } from 'fumadocs-ui/mdx';import type { ApiPageProps } from 'fumadocs-openapi/ui';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';interface OpenAPIPageData {@@ -37,17 +38,20 @@ export default async function Page({: null;return (<DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>- <h1 className="text-2xl font-semibold mb-4">- {pageData.title}- {detectedVersion && (- <span className="ml-2 align-middle">- <VersionBadge version={detectedVersion} />- </span>- )}- </h1>- <PageActions path={page.url} />+ <div className="mb-4 flex items-start justify-between gap-4">+ <h1 className="text-2xl font-semibold">+ {pageData.title}+ {detectedVersion && (+ <span className="ml-2 align-middle">+ <VersionBadge version={detectedVersion} />+ </span>+ )}+ </h1>+ <PageActions path={page.url} variant="inline" />+ </div><DocsBody><APIPage {...apiProps} />+ <EditOnGitHub path={`docs/content/reference/${page.path}`} /></DocsBody></DocsPage>);@@ -68,6 +72,7 @@ export default async function Page({a: createRelativeLink(referenceSource as any, page),})}/>+ <EditOnGitHub path={`docs/content/reference/${page.path}`} /></DocsBody></DocsPage>);diff --git a/docs/app/(home)/reference/v3/[[...slug]]/page.tsx b/docs/app/(home)/reference/v3/[[...slug]]/page.tsxindex ae9ed764b..eb1f08c02 100644--- a/docs/app/(home)/reference/v3/[[...slug]]/page.tsx+++ b/docs/app/(home)/reference/v3/[[...slug]]/page.tsx@@ -11,6 +11,7 @@ import type { Metadata } from 'next';import { createRelativeLink } from 'fumadocs-ui/mdx';import type { ApiPageProps } from 'fumadocs-openapi/ui';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';interface OpenAPIPageData {@@ -45,17 +46,20 @@ export default async function Page({: null;return (<DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>- <h1 className="text-2xl font-semibold mb-4">- {pageData.title}- {detectedVersion && (- <span className="ml-2 align-middle">- <VersionBadge version={detectedVersion} />- </span>- )}- </h1>- <PageActions path={page.url} />+ <div className="mb-4 flex items-start justify-between gap-4">+ <h1 className="text-2xl font-semibold">+ {pageData.title}+ {detectedVersion && (+ <span className="ml-2 align-middle">+ <VersionBadge version={detectedVersion} />+ </span>+ )}+ </h1>+ <PageActions path={page.url} variant="inline" />+ </div><DocsBody><APIPage {...apiProps} />+ <EditOnGitHub path={`docs/content/reference/${page.path}`} /></DocsBody></DocsPage>);@@ -76,6 +80,7 @@ export default async function Page({a: createRelativeLink(referenceSource as any, page),})}/>+ <EditOnGitHub path={`docs/content/reference/${page.path}`} /></DocsBody></DocsPage>);diff --git a/docs/app/(home)/toolkits/[[...slug]]/page.tsx b/docs/app/(home)/toolkits/[[...slug]]/page.tsxindex 7cd6eb0c0..6c8a20ee5 100644--- a/docs/app/(home)/toolkits/[[...slug]]/page.tsx+++ b/docs/app/(home)/toolkits/[[...slug]]/page.tsx@@ -4,6 +4,7 @@ import { getMDXComponents } from '@/mdx-components';import { ToolkitDetail } from '@/components/toolkits/toolkit-detail';import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';import { readFile } from 'fs/promises';import { join } from 'path';import { getAllToolkits, getToolkitBySlug } from '@/lib/toolkit-data';@@ -209,11 +210,14 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?return (<div><a href="/toolkits" className="text-sm text-fd-muted-foreground no-underline hover:text-fd-foreground hover:underline">← All Toolkits</a>- <h1 className="mt-2 text-3xl font-bold text-fd-foreground">{page.data.title}</h1>- <PageActions path={page.url} />- <article className="prose prose-fd max-w-none">+ <div className="mt-2 flex items-start justify-between gap-4">+ <h1 className="text-3xl font-bold text-fd-foreground">{page.data.title}</h1>+ <PageActions path={page.url} variant="inline" />+ </div>+ <article className="prose prose-fd mt-6 max-w-none"><MDXContent components={getMDXComponents()} /></article>+ <EditOnGitHub path={`docs/content/toolkits/${page.path}`} /></div>);}diff --git a/docs/app/global.css b/docs/app/global.cssindex 52f2fc721..37354b977 100644--- a/docs/app/global.css+++ b/docs/app/global.css@@ -9,19 +9,20 @@/* ==========================================================================COMPOSIO DOCS- Palette:- - Light: Content #ffffff, Sidebar #f7f5f2- - Dark: Content #1a1815, Sidebar #252220- - Accent: #ea580c (Tailwind orange-600)+ Palette (synced with ~/composio/landing + ~/composio/composio_dashboard):+ - Brand: #0007cd / oklch(0.387 0.264 264.1) — deep electric blue+ - Light: Content #fbfbfb, Card #ffffff+ - Dark: Content #0f0f0f, Card #1a1a1aTypography:- - All text: Inter- - Code: IBM Plex Mono+ - All text: ABC Diatype (sans, loaded locally in app/layout.tsx)+ - Code: JetBrains Mono========================================================================== */@theme inline {- --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;- --radius: 0.625rem;+ --font-sans: var(--font-sans), ui-sans-serif, system-ui, sans-serif;+ --font-mono: var(--font-mono), ui-monospace, SFMono-Regular, Menlo, monospace;+ --radius: 0;--color-sidebar-ring: var(--sidebar-ring);--color-sidebar-border: var(--sidebar-border);--color-sidebar-accent-foreground: var(--sidebar-accent-foreground);@@ -75,46 +76,47 @@ html {}:root {- /* Brand */- --composio-orange: #ea580c;- --composio-sidebar: #f7f5f2;+ /* Brand — deep electric blue, shared with composio.dev + dashboard */+ --composio-brand: #0007cd;+ --composio-orange: var(--composio-brand); /* legacy alias — kept for back-compat */+ --composio-sidebar: #fbfbfb;/* Fumadocs overrides - Light */- --color-fd-background: #ffffff;- --color-fd-foreground: #171414;- --color-fd-muted: #f6f4f2;- --color-fd-muted-foreground: #5c5858; /* Improved contrast */- --color-fd-border: #e5e0df;+ --color-fd-background: #fbfbfb;+ --color-fd-foreground: #0f0f0f;+ --color-fd-muted: #f3f3f3;+ --color-fd-muted-foreground: #585858;+ --color-fd-border: #e5e5e5;--color-fd-card: #ffffff;- --color-fd-card-foreground: #171414;+ --color-fd-card-foreground: #0f0f0f;--color-fd-popover: #ffffff;- --color-fd-popover-foreground: #171414;- --color-fd-primary: #171414;- --color-fd-primary-foreground: #ffffff;- --color-fd-secondary: #f6f4f2;- --color-fd-secondary-foreground: #171414;- --color-fd-accent: #f6f4f2;- --color-fd-accent-foreground: #171414;- --color-fd-ring: #e5e0df;- --radius: 0.625rem;- --background: oklch(1 0 0);- --foreground: oklch(0.145 0 0);+ --color-fd-popover-foreground: #0f0f0f;+ --color-fd-primary: #0f0f0f;+ --color-fd-primary-foreground: #fbfbfb;+ --color-fd-secondary: #f3f3f3;+ --color-fd-secondary-foreground: #0f0f0f;+ --color-fd-accent: #f3f3f3;+ --color-fd-accent-foreground: #0f0f0f;+ --color-fd-ring: var(--composio-brand);+ --radius: 0;+ --background: oklch(0.985 0 0);+ --foreground: oklch(0.218 0 0);--card: oklch(1 0 0);- --card-foreground: oklch(0.145 0 0);+ --card-foreground: oklch(0.218 0 0);--popover: oklch(1 0 0);- --popover-foreground: oklch(0.145 0 0);- --primary: oklch(0.205 0 0);- --primary-foreground: oklch(0.985 0 0);+ --popover-foreground: oklch(0.218 0 0);+ --primary: oklch(0.387 0.264 264.1);+ --primary-foreground: oklch(1 0 0);--secondary: oklch(0.97 0 0);- --secondary-foreground: oklch(0.205 0 0);+ --secondary-foreground: oklch(0.218 0 0);--muted: oklch(0.97 0 0);- --muted-foreground: oklch(0.556 0 0);+ --muted-foreground: oklch(0.51 0 0);--accent: oklch(0.97 0 0);- --accent-foreground: oklch(0.205 0 0);- --destructive: oklch(0.577 0.245 27.325);- --border: oklch(0.922 0 0);- --input: oklch(0.922 0 0);- --ring: oklch(0.708 0 0);+ --accent-foreground: oklch(0.218 0 0);+ --destructive: oklch(0.577 0.215 27.3);+ --border: oklch(0.931 0 0);+ --input: oklch(0.931 0 0);+ --ring: oklch(0.387 0.264 264.1);--chart-1: oklch(0.646 0.222 41.116);--chart-2: oklch(0.6 0.118 184.704);--chart-3: oklch(0.398 0.07 227.392);@@ -131,43 +133,43 @@ html {}.dark {- --composio-sidebar: #131211;+ --composio-sidebar: #0f0f0f;/* Fumadocs overrides - Dark */- --color-fd-background: #131211;- --color-fd-foreground: #e8e4e0;- --color-fd-muted: #1e1d1c;- --color-fd-muted-foreground: #a8a29e; /* Improved contrast */- --color-fd-border: #2c2a28;- --color-fd-card: #131211;- --color-fd-card-foreground: #e8e4e0;- --color-fd-popover: #252220;- --color-fd-popover-foreground: #e8e4e0;- --color-fd-primary: #e8e4e0;- --color-fd-primary-foreground: #1a1815;- --color-fd-secondary: #2a2725;- --color-fd-secondary-foreground: #e8e4e0;- --color-fd-accent: #2a2725;- --color-fd-accent-foreground: #e8e4e0;- --color-fd-ring: #3d3935;- --background: oklch(0.145 0 0);+ --color-fd-background: #0f0f0f;+ --color-fd-foreground: #fbfbfb;+ --color-fd-muted: #1a1a1a;+ --color-fd-muted-foreground: #b4b4b4;+ --color-fd-border: rgba(255, 255, 255, 0.10);+ --color-fd-card: #141414;+ --color-fd-card-foreground: #fbfbfb;+ --color-fd-popover: #1a1a1a;+ --color-fd-popover-foreground: #fbfbfb;+ --color-fd-primary: #fbfbfb;+ --color-fd-primary-foreground: #0f0f0f;+ --color-fd-secondary: #1a1a1a;+ --color-fd-secondary-foreground: #fbfbfb;+ --color-fd-accent: #1a1a1a;+ --color-fd-accent-foreground: #fbfbfb;+ --color-fd-ring: var(--composio-brand);+ --background: oklch(0.159 0 0);--foreground: oklch(0.985 0 0);- --card: oklch(0.205 0 0);+ --card: oklch(0.218 0 0);--card-foreground: oklch(0.985 0 0);- --popover: oklch(0.205 0 0);+ --popover: oklch(0.218 0 0);--popover-foreground: oklch(0.985 0 0);- --primary: oklch(0.922 0 0);- --primary-foreground: oklch(0.205 0 0);+ --primary: oklch(0.985 0 0);+ --primary-foreground: oklch(0.218 0 0);--secondary: oklch(0.269 0 0);--secondary-foreground: oklch(0.985 0 0);--muted: oklch(0.269 0 0);- --muted-foreground: oklch(0.708 0 0);+ --muted-foreground: oklch(0.706 0 0);--accent: oklch(0.269 0 0);--accent-foreground: oklch(0.985 0 0);- --destructive: oklch(0.704 0.191 22.216);- --border: oklch(1 0 0 / 5%);+ --destructive: oklch(0.637 0.208 25.3);+ --border: oklch(1 0 0 / 10%);--input: oklch(1 0 0 / 15%);- --ring: oklch(0.556 0 0);+ --ring: oklch(0.745 0.128 275);--chart-1: oklch(0.488 0.243 264.376);--chart-2: oklch(0.696 0.17 162.48);--chart-3: oklch(0.769 0.188 70.08);@@ -361,6 +363,18 @@ textarea:focus-visible {border-radius: 0 var(--radius) var(--radius) 0;}+/* Callouts — muted links, not brand accent */+[data-fumadocs-body] [data-callout] a:not([data-card]) {+ color: inherit;+ text-decoration: underline;+ text-underline-offset: 2px;+ text-decoration-color: var(--color-fd-border);+}++[data-fumadocs-body] [data-callout] a:not([data-card]):hover {+ text-decoration-color: currentColor;+}+/* ==========================================================================Header Components========================================================================== */@@ -565,6 +579,13 @@ body {transition: max-width 0.3s ease;}+/* Hide Decimal's built-in launcher tab and floating button — we trigger+ the widget from our own "Ask AI" button in the nav (see ask-ai-button.tsx). */+.decimal-widget-sidebar-tab,+.decimal-widget-button {+ display: none !important;+}+@layer base {* {@apply border-border outline-ring/50;@@ -573,3 +594,48 @@ body {@apply bg-background text-foreground;}}++/* ==========================================================================+ 404 glitch animation (ported from landing site)+ ========================================================================== */+@keyframes glitch-404 {+ 0%,+ 3% {+ text-shadow: none;+ transform: translate(0);+ }+ 6% {+ text-shadow:+ 3px 0 var(--composio-brand),+ -3px 0 #cd0700;+ transform: translate(-3px, 1px);+ }+ 12% {+ text-shadow:+ -3px 0 var(--composio-brand),+ 3px 0 #cd0700;+ transform: translate(3px, -1px);+ }+ 18% {+ text-shadow:+ 2px 0 var(--composio-brand),+ -2px 0 #cd0700;+ transform: translate(-1px, 2px);+ }+ 24% {+ text-shadow:+ -1px 0 var(--composio-brand),+ 1px 0 #cd0700;+ transform: translate(2px, -1px);+ }+ 30%,+ 100% {+ text-shadow: none;+ transform: translate(0);+ }+}++.animate-glitch-404 {+ animation: glitch-404 2.6s ease-out infinite;+}+diff --git a/docs/app/layout.tsx b/docs/app/layout.tsxindex 0d8faa3fe..aff138120 100644--- a/docs/app/layout.tsx+++ b/docs/app/layout.tsx@@ -2,7 +2,8 @@ import { RootProvider } from 'fumadocs-ui/provider/next';import type { Metadata } from 'next';import { Analytics } from '@vercel/analytics/next';import './global.css';-import { Inter, IBM_Plex_Mono } from 'next/font/google';+import { JetBrains_Mono } from 'next/font/google';+import localFont from 'next/font/local';import { PostHogProvider } from '@/components/posthog-provider';import { DecimalWidget } from '@/components/decimal-widget';import CustomSearchDialog from '@/components/custom-search-dialog';@@ -46,15 +47,17 @@ export const metadata: Metadata = {},};-const inter = Inter({- weight: ['400', '500', '600', '700'],- subsets: ['latin'],+const abcDiatype = localFont({+ src: [+ { path: '../public/fonts/ABCDiatype-Regular.woff2', weight: '400', style: 'normal' },+ { path: '../public/fonts/ABCDiatype-RegularItalic.woff2', weight: '400', style: 'italic' },+ { path: '../public/fonts/ABCDiatype-Medium.woff2', weight: '500', style: 'normal' },+ ],variable: '--font-sans',display: 'swap',});-const ibmPlexMono = IBM_Plex_Mono({- weight: ['400', '500', '600'],+const jetbrainsMono = JetBrains_Mono({subsets: ['latin'],variable: '--font-mono',display: 'swap',@@ -64,7 +67,7 @@ export default function Layout({ children }: LayoutProps<'/'>) {return (<htmllang="en"- className={`${inter.variable} ${ibmPlexMono.variable}`}+ className={`${abcDiatype.variable} ${jetbrainsMono.variable}`}suppressHydrationWarning><head>@@ -111,7 +114,8 @@ export default function Layout({ children }: LayoutProps<'/'>) {theme={{defaultTheme: 'light',attribute: 'class',- enableSystem: true,+ enableSystem: false,+ forcedTheme: 'light',}}search={{SearchDialog: CustomSearchDialog,diff --git a/docs/app/not-found.tsx b/docs/app/not-found.tsxindex 9dd2ce6e7..6e3ece48e 100644--- a/docs/app/not-found.tsx+++ b/docs/app/not-found.tsx@@ -33,65 +33,62 @@ async function log404ToDatadog(path: string, referer: string | null) {export default async function NotFound() {const headersList = await headers();const referer = headersList.get('referer');- const path = headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';+ const path =+ headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';// Fire and forget - don't block renderinglog404ToDatadog(path, referer);return (- <div className="flex min-h-[85vh] flex-col items-center justify-center px-4">- <div className="relative">- {/* Subtle gradient glow */}- <div className="absolute -inset-4 rounded-full bg-gradient-to-r from-fd-primary/20 via-fd-primary/5 to-transparent blur-2xl" />- <h1 className="relative text-[120px] sm:text-[150px] font-bold leading-none tracking-tighter text-fd-foreground/10 select-none">- 404- </h1>+ <div className="relative flex min-h-[85vh] flex-col items-center justify-center overflow-hidden px-4">+ {/* Faint giant background 404 */}+ <div+ aria-hidden="true"+ className="pointer-events-none absolute inset-0 flex select-none items-center justify-center text-fd-foreground/[0.04] dark:text-white/[0.04]"+ style={{+ fontSize: 'clamp(200px, 30vw, 500px)',+ fontWeight: 500,+ lineHeight: 1,+ letterSpacing: '-0.04em',+ }}+ >+ 404</div>- <div className="mt-2 text-center max-w-md">- <h2 className="text-xl font-semibold text-fd-foreground">+ {/* Foreground glitch 404 */}+ <h1+ aria-label="404 — Page not found"+ className="animate-glitch-404 relative font-sans text-[96px] font-medium leading-none tracking-tighter text-fd-foreground sm:text-[128px]"+ >+ 404+ </h1>++ <div className="relative mt-6 text-center max-w-md">+ <h2 className="font-mono text-sm uppercase tracking-[-0.28px] text-fd-muted-foreground">Page not found</h2>- <p className="mt-2 text-fd-muted-foreground text-sm">- This page doesn't exist or may have moved.+ <p className="mt-3 font-mono text-sm leading-relaxed text-fd-muted-foreground">+ The page you're looking for doesn't exist or has moved.<br /><span className="text-fd-muted-foreground/70">- 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.+ 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.</span></p></div>- {/* Quick links */}- <div className="mt-8 flex flex-wrap justify-center gap-3">+ <div className="relative mt-8"><Linkhref="/docs"- 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"+ 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]"+ style={{ color: '#ffffff' }}>- Documentation- </Link>- <Link- href="/"- 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"- >- Home+ <span style={{ color: '#ffffff' }}>Back to docs</span></Link></div>-- {/* Secondary links */}- <nav className="mt-10 flex flex-wrap justify-center gap-x-6 gap-y-2 text-sm text-fd-muted-foreground">- <Link href="/docs/quickstart" className="hover:text-fd-foreground transition-colors">- Quickstart- </Link>- <Link href="/toolkits" className="hover:text-fd-foreground transition-colors">- Toolkits- </Link>- <Link href="/cookbooks" className="hover:text-fd-foreground transition-colors">- Cookbooks- </Link>- <Link href="/reference" className="hover:text-fd-foreground transition-colors">- API Reference- </Link>- </nav></div>);}diff --git a/docs/components/ai-tools-banner.tsx b/docs/components/ai-tools-banner.tsxindex 7fa3e9dac..9950dc70a 100644--- a/docs/components/ai-tools-banner.tsx+++ b/docs/components/ai-tools-banner.tsx@@ -42,15 +42,15 @@ export function AIToolsBanner() {{/* Shader gradient blobs — same as PromptBanner */}<divclassName="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.12) 0%, rgba(0,7,205,0) 70%)' }}/><divclassName="pointer-events-none absolute right-10 -bottom-20 h-56 w-56 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.08) 0%, rgba(0,7,205,0) 70%)' }}/><divclassName="pointer-events-none absolute right-32 -top-16 h-44 w-44 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.06) 0%, rgba(0,7,205,0) 70%)' }}/><div className="relative flex flex-col gap-3 p-4 sm:px-5 sm:py-4">{/* Header */}diff --git a/docs/components/callout.tsx b/docs/components/callout.tsxnew file mode 100644index 000000000..f1abd9fd0--- /dev/null+++ b/docs/components/callout.tsx@@ -0,0 +1,85 @@+import type { ReactNode } from 'react';+import { CircleCheck, CircleX, Lightbulb, TriangleAlert } from 'lucide-react';+import { cn } from '@/lib/utils';++type CalloutType = 'info' | 'warn' | 'warning' | 'error' | 'success' | 'tip' | 'idea';++interface CalloutProps {+ type?: CalloutType;+ title?: ReactNode;+ children?: ReactNode;+ className?: string;+}++type ResolvedType = 'info' | 'warning' | 'error' | 'success' | 'idea';++function resolveType(type: CalloutType = 'info'): ResolvedType {+ if (type === 'warn') return 'warning';+ if (type === 'tip') return 'info';+ return type;+}++const variants: Record<+ ResolvedType,+ { container: string; icon?: typeof TriangleAlert; iconClass?: string }+> = {+ info: {+ container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',+ },+ warning: {+ container: 'border-amber-600/15 bg-amber-500/[0.04] text-fd-muted-foreground',+ icon: TriangleAlert,+ iconClass: 'text-amber-600/60',+ },+ error: {+ container: 'border-red-500/15 bg-red-500/[0.04] text-fd-muted-foreground',+ icon: CircleX,+ iconClass: 'text-red-500/60',+ },+ success: {+ container: 'border-emerald-600/15 bg-emerald-500/[0.04] text-fd-muted-foreground',+ icon: CircleCheck,+ iconClass: 'text-emerald-600/60',+ },+ idea: {+ container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',+ icon: Lightbulb,+ iconClass: 'text-fd-muted-foreground/70',+ },+};++export function Callout({ type = 'info', title, children, className }: CalloutProps) {+ const resolved = resolveType(type);+ const variant = variants[resolved];+ const Icon = variant.icon;++ return (+ <div+ data-callout=""+ className={cn(+ 'not-prose my-3 rounded-md border px-3 py-2 text-[0.8125rem] leading-relaxed',+ variant.container,+ className,+ )}+ >+ <div className={cn('flex gap-2', Icon ? 'items-start' : '')}>+ {Icon ? (+ <Icon className={cn('mt-0.5 size-3.5 shrink-0 stroke-[1.75]', variant.iconClass)} />+ ) : null}+ <div className="min-w-0 flex-1">+ {title ? <p className="mb-1 font-medium text-fd-foreground">{title}</p> : null}+ <div+ className={cn(+ 'prose-no-margin',+ '[&_a]:text-fd-foreground [&_a]:underline [&_a]:decoration-fd-border [&_a]:underline-offset-2',+ '[&_a]:hover:decoration-fd-muted-foreground',+ '[&_code]:text-[0.8125rem] [&_code]:text-fd-foreground/80',+ )}+ >+ {children}+ </div>+ </div>+ </div>+ </div>+ );+}diff --git a/docs/components/capability-card.tsx b/docs/components/capability-card.tsxindex 5cdd696de..2d050e238 100644--- a/docs/components/capability-card.tsx+++ b/docs/components/capability-card.tsx@@ -13,10 +13,10 @@ export function CapabilityCard({ icon, title, description, href }: CapabilityCar<Linkhref={href}data-card- 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"+ 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">- <div className="text-orange-500 mb-3">{icon}</div>- <h3 className="text-lg font-semibold text-orange-500 mb-2">{title}</h3>+ <div className="text-blue-500 mb-3">{icon}</div>+ <h3 className="text-lg font-semibold text-blue-500 mb-2">{title}</h3><p className="text-fd-muted-foreground text-sm leading-relaxed">{description}</p></Link>);diff --git a/docs/components/connect-flow.tsx b/docs/components/connect-flow.tsxindex a97551a38..10b1b4ed1 100644--- a/docs/components/connect-flow.tsx+++ b/docs/components/connect-flow.tsx@@ -58,7 +58,7 @@ function PopularTab({onClick={onSelect}className={`flex items-center gap-2 rounded-md px-3 py-1.5 text-sm font-medium transition-all whitespace-nowrap- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500${selected? 'bg-fd-background text-fd-foreground shadow-sm dark:bg-fd-accent/60 dark:shadow-none': 'text-fd-muted-foreground hover:text-fd-foreground'@@ -154,7 +154,7 @@ export function ConnectFlow({ children }: ConnectFlowProps) {onKeyDown={(e) => { if (e.key === 'Escape') setDropdownOpen(false); }}className={`flex items-center gap-2 rounded-lg border px-3 py-1.5 text-sm font-medium transition-all- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500${selectedIsOther? 'border-[var(--composio-orange)] bg-fd-accent/30 text-fd-foreground': 'border-fd-border bg-fd-card text-fd-muted-foreground hover:text-fd-foreground hover:bg-fd-accent/50'diff --git a/docs/components/copy-link.tsx b/docs/components/copy-link.tsxindex 07c2ea8c1..bd53a2bcb 100644--- a/docs/components/copy-link.tsx+++ b/docs/components/copy-link.tsx@@ -22,7 +22,7 @@ export function CopyLink({ href, children, className }: CopyLinkProps) {return (<buttononClick={handleCopy}- 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}`}+ 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}`}aria-label="Copy link to clipboard"><span>{children}</span>diff --git a/docs/components/docs-hero.tsx b/docs/components/docs-hero.tsxnew file mode 100644index 000000000..373fa9dc4--- /dev/null+++ b/docs/components/docs-hero.tsx@@ -0,0 +1,61 @@+import Image from 'next/image';+import Link from 'next/link';+import { ArrowUpRight } from 'lucide-react';++/**+ * Welcome-page hero — Composio brand language synced with composio.dev.+ * Full-bleed shader background (Malay's `shader-fallback.jpg` from the+ * landing site), centered content on top.+ */+export function DocsHero() {+ return (+ <div className="not-prose relative isolate mb-12 overflow-hidden border border-fd-border">+ <Image+ src="/images/hero/shader.jpg"+ alt=""+ fill+ priority+ sizes="(min-width: 1280px) 1024px, 100vw"+ className="-z-10 object-cover"+ />+ {/* readability scrim — soft white wash on light, soft black wash on dark */}+ <div+ aria-hidden="true"+ className="pointer-events-none absolute inset-0 -z-10 bg-white/30 dark:bg-black/40"+ />++ <div className="relative flex flex-col items-center gap-6 px-6 py-20 text-center sm:py-24 lg:py-32">+ <h1 className="text-4xl font-medium leading-[0.95] tracking-[-0.02em] text-fd-foreground md:text-5xl lg:text-[64px]">+ Composio+ <br className="sm:hidden" />+ <span className="sm:ml-3">Documentation</span>+ </h1>+ <p className="max-w-[560px] text-base leading-[1.5] text-fd-foreground/80 md:text-lg">+ Composio powers 1000+ toolkits, tool search, context management,+ authentication, and a sandboxed workbench to help you build AI agents+ that turn intent into action.+ </p>+ <div className="mt-2 flex flex-wrap items-center justify-center gap-3">+ <Link+ href="/docs/quickstart"+ 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]"+ style={{ color: '#ffffff' }}+ >+ <span style={{ color: '#ffffff' }}>Get Started</span>+ <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" style={{ color: '#ffffff' }} />+ </Link>+ <Link+ href="https://dashboard.composio.dev/~/project/playground"+ target="_blank"+ rel="noopener noreferrer"+ 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"+ style={{ color: 'var(--color-fd-foreground)' }}+ >+ <span style={{ color: 'var(--color-fd-foreground)' }}>Playground</span>+ <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" />+ </Link>+ </div>+ </div>+ </div>+ );+}diff --git a/docs/components/edit-on-github.tsx b/docs/components/edit-on-github.tsxnew file mode 100644index 000000000..fc93aa704--- /dev/null+++ b/docs/components/edit-on-github.tsx@@ -0,0 +1,32 @@+import { Edit } from 'lucide-react';++interface EditOnGitHubProps {+ /**+ * File path relative to the repository root, e.g. `docs/content/docs/index.mdx`+ * or `docs/components/toolkits/toolkit-detail.tsx`.+ */+ path: string;+ /** Defaults to the `next` branch. */+ sha?: string;+}++/**+ * "Edit this page on GitHub" link, rendered at the bottom of each docs page.+ * Links to the source file in the public Composio repo on the configured branch.+ */+export function EditOnGitHub({ path, sha = 'next' }: EditOnGitHubProps) {+ const href = `https://github.com/ComposioHQ/composio/blob/${sha}/${path}`;+ return (+ <div className="not-prose mt-12 flex justify-start border-t border-fd-border/60 pt-6">+ <a+ href={href}+ target="_blank"+ rel="noopener noreferrer"+ className="inline-flex items-center gap-1.5 text-xs font-medium text-fd-muted-foreground hover:text-fd-foreground transition-colors"+ >+ <Edit className="size-3.5" aria-hidden="true" />+ <span>Edit this page on GitHub</span>+ </a>+ </div>+ );+}diff --git a/docs/components/nav-tabs.tsx b/docs/components/nav-tabs.tsxindex 15758245b..af87252a7 100644--- a/docs/components/nav-tabs.tsx+++ b/docs/components/nav-tabs.tsx@@ -27,7 +27,7 @@ export function NavTabs() {<Linkkey={tab.href}href={tab.href}- 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' : ''}`}+ 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' : ''}`}>{tab.label}</Link>diff --git a/docs/components/page-actions.tsx b/docs/components/page-actions.tsxindex 03334e33c..18df6dab1 100644--- a/docs/components/page-actions.tsx+++ b/docs/components/page-actions.tsx@@ -1,160 +1,228 @@'use client';-import { useState, useCallback } from 'react';-import { Copy, Check, Loader2, ExternalLink, BotMessageSquare } from 'lucide-react';-import { Feedback } from './feedback';-import { toggleDecimalWidget } from './ask-ai-button';+import { useCallback, useEffect, useRef, useState } from 'react';+import { Check, ChevronDown, Copy, ExternalLink, FileText } from 'lucide-react';interface PageActionsProps {path: string;+ /**+ * 'overlap-title' (default) lifts the button into the row above via a+ * negative top margin so it lands to the right of `<DocsTitle>`.+ * 'inline' renders the button as a normal inline-block — use when the+ * caller already controls layout (e.g. the Toolkits landing header).+ */+ variant?: 'overlap-title' | 'inline';}+const FALLBACK_ORIGIN = 'https://docs.composio.dev';+/**- * Actions for the current page: copy markdown, open as markdown.- * Provides AI-friendly access to documentation content.+ * Single "Copy page" dropdown with three actions:+ * - Copy page (fetches the .md and writes to clipboard)+ * - Open in ChatGPT (deep link with a prefilled prompt)+ * - Open in Claude (deep link with a prefilled prompt)+ *+ * Sits to the right of the page title via `not-prose -mt-12 mb-2 flex justify-end`+ * so it overlaps the row above (next to <DocsTitle>) without ever crashing into+ * the title text on narrow viewports.*/-export function PageActions({ path }: PageActionsProps) {- const [copyState, setCopyState] = useState<'idle' | 'loading' | 'copied' | 'error'>('idle');+export function PageActions({ path, variant = 'overlap-title' }: PageActionsProps) {+ const [open, setOpen] = useState(false);+ const [copied, setCopied] = useState(false);+ const wrapperRef = useRef<HTMLDivElement>(null);- const handleCopy = useCallback(async () => {- if (copyState === 'loading') return;- setCopyState('loading');+ // Close on outside click and Escape.+ useEffect(() => {+ if (!open) return;+ function onClick(e: MouseEvent) {+ if (wrapperRef.current && !wrapperRef.current.contains(e.target as Node)) {+ setOpen(false);+ }+ }+ function onKey(e: KeyboardEvent) {+ if (e.key === 'Escape') setOpen(false);+ }+ document.addEventListener('mousedown', onClick);+ document.addEventListener('keydown', onKey);+ return () => {+ document.removeEventListener('mousedown', onClick);+ document.removeEventListener('keydown', onKey);+ };+ }, [open]);++ const absoluteMdUrl =+ typeof window !== 'undefined'+ ? `${window.location.origin}${path}.md`+ : `${FALLBACK_ORIGIN}${path}.md`;+ const chatgptUrl = `https://chatgpt.com/?hints=search&q=${encodeURIComponent(+ `Read ${absoluteMdUrl} so I can ask questions about it.`,+ )}`;+ const claudeUrl = `https://claude.ai/new?q=${encodeURIComponent(+ `Read ${absoluteMdUrl} so I can ask questions about it.`,+ )}`;++ const handleCopy = useCallback(async () => {try {const response = await fetch(`${path}.md`);if (!response.ok) throw new Error('Failed to fetch');-const markdown = await response.text();await navigator.clipboard.writeText(markdown);-- setCopyState('copied');- setTimeout(() => setCopyState('idle'), 2000);+ setCopied(true);+ setTimeout(() => setCopied(false), 1500);+ setTimeout(() => setOpen(false), 400);} catch {- setCopyState('error');- setTimeout(() => setCopyState('idle'), 2000);+ // best-effort; leave menu open so user can retry}- }, [path, copyState]);-- const getCopyIcon = () => {- switch (copyState) {- case 'loading':- return (- <Loader2- className="size-3.5 animate-spin motion-reduce:animate-none"- aria-hidden="true"- />- );- case 'copied':- return (- <Check- className="size-3.5 text-emerald-500 dark:text-emerald-400"- aria-hidden="true"- />- );- case 'error':- return (- <Copy- className="size-3.5 text-red-500 dark:text-red-400"+ }, [path]);++ return (+ <div className={variant === 'overlap-title' ? 'not-prose -mt-12 mb-2 flex justify-end' : 'not-prose inline-block'}>+ <div ref={wrapperRef} className="relative">+ <button+ type="button"+ onClick={() => setOpen((v) => !v)}+ aria-haspopup="menu"+ aria-expanded={open}+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 text-xs font-medium+ text-fd-muted-foreground hover:text-fd-foreground+ bg-fd-secondary/50 hover:bg-fd-secondary+ border border-fd-border/60+ transition-colors duration-150 ease-out+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background+ touch-manipulation"+ style={{ borderRadius: 0 }}+ >+ <Copy className="size-3.5" aria-hidden="true" />+ <span>Copy page</span>+ <ChevronDown+ className={`size-3.5 transition-transform duration-150 ${open ? 'rotate-180' : ''}`}aria-hidden="true"/>- );- default:- return <Copy className="size-3.5" aria-hidden="true" />;- }- };-- const getCopyLabel = () => {- switch (copyState) {- case 'loading':- return 'Copying…';- case 'copied':- return 'Copied!';- case 'error':- return 'Failed';- default:- return 'Copy page';- }- };+ </button>- return (- <div- className="not-prose flex flex-wrap items-center gap-1.5 sm:gap-1 mt-2 mb-6"- role="group"- aria-label="Page actions"- >- {/* Copy Button */}- <button- type="button"- onClick={handleCopy}- disabled={copyState === 'loading'}- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium- text-fd-muted-foreground hover:text-fd-foreground- bg-fd-secondary/50 hover:bg-fd-secondary- rounded-md- transition-all duration-150 ease-out- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background- disabled:pointer-events-none- active:scale-[0.98]- touch-manipulation- motion-reduce:transition-none motion-reduce:active:scale-100"- aria-label="Copy page as markdown"- aria-live="polite"- >- <span className="transition-transform duration-150 ease-out">- {getCopyIcon()}+ {open && (+ <div+ role="menu"+ className="absolute right-0 z-50 mt-1 w-[280px] border border-fd-border bg-fd-popover text-fd-popover-foreground shadow-lg"+ style={{ borderRadius: 0 }}+ >+ <MenuItem+ icon={+ copied ? (+ <Check className="size-4 text-emerald-500" aria-hidden="true" />+ ) : (+ <Copy className="size-4" aria-hidden="true" />+ )+ }+ title={copied ? 'Copied!' : 'Copy page'}+ subtitle="Copy page as Markdown for LLMs"+ onClick={handleCopy}+ />+ <MenuItem+ icon={<FileText className="size-4" aria-hidden="true" />}+ external+ title="View as Markdown"+ subtitle="Open the raw .md source in a new tab"+ href={`${path}.md`}+ />+ <MenuItem+ icon={<ChatGPTMark className="size-4" />}+ external+ title="Open in ChatGPT"+ subtitle="Ask questions about this page"+ href={chatgptUrl}+ />+ <MenuItem+ icon={<ClaudeMark className="size-4" />}+ external+ title="Open in Claude"+ subtitle="Ask questions about this page"+ href={claudeUrl}+ />+ </div>+ )}+ </div>+ </div>+ );+}++interface MenuItemProps {+ icon: React.ReactNode;+ title: string;+ subtitle: string;+ href?: string;+ external?: boolean;+ onClick?: () => void;+}++function MenuItem({ icon, title, subtitle, href, external, onClick }: MenuItemProps) {+ const className =+ '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';++ const content = (+ <>+ <span className="mt-0.5 flex size-4 shrink-0 items-center justify-center text-fd-muted-foreground">+ {icon}+ </span>+ <span className="min-w-0 flex-1">+ <span className="flex items-center gap-1 text-sm font-medium text-fd-foreground">+ {title}+ {external && (+ <ExternalLink className="size-3 text-fd-muted-foreground" aria-hidden="true" />+ )}</span>- <span>{getCopyLabel()}</span>- </button>+ <span className="block text-xs text-fd-muted-foreground">{subtitle}</span>+ </span>+ </>+ );- {/* View Markdown Link */}+ if (href) {+ return (<a- href={`${path}.md`}+ href={href}target="_blank"rel="noopener noreferrer"- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium- text-fd-muted-foreground hover:text-fd-foreground- bg-fd-secondary/50 hover:bg-fd-secondary- rounded-md- transition-all duration-150 ease-out- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background- active:scale-[0.98]- touch-manipulation- motion-reduce:transition-none motion-reduce:active:scale-100"- aria-label="View page as markdown (opens in new tab)"+ role="menuitem"+ className={className}>- <ExternalLink className="size-3.5" aria-hidden="true" />- <span className="hidden sm:inline">View </span>- <span>Markdown</span>+ {content}</a>+ );+ }+ return (+ <button type="button" role="menuitem" onClick={onClick} className={className}>+ {content}+ </button>+ );+}- {/* Divider - hidden on mobile when wrapped */}- <span- className="hidden sm:block mx-1 h-4 w-px bg-fd-border/60"- role="separator"- aria-orientation="vertical"- />-- {/* Ask AI */}- <button- type="button"- onClick={toggleDecimalWidget}- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium- text-fd-muted-foreground hover:text-fd-foreground- bg-fd-secondary/50 hover:bg-fd-secondary- rounded-md- transition-all duration-150 ease-out- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background- active:scale-[0.98]- touch-manipulation- motion-reduce:transition-none motion-reduce:active:scale-100"- aria-label="Ask AI"- >- <BotMessageSquare className="size-3.5" aria-hidden="true" />- <span>Ask AI</span>- </button>+/** Tiny inline OpenAI/ChatGPT mark (flower-gear), monochrome currentColor. */+function ChatGPTMark({ className }: { className?: string }) {+ return (+ <svg+ className={className}+ viewBox="0 0 24 24"+ fill="currentColor"+ aria-hidden="true"+ xmlns="http://www.w3.org/2000/svg"+ >+ <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" />+ </svg>+ );+}- {/* Feedback */}- <Feedback page={path} />- </div>+/** Tiny inline Anthropic Claude mark (asterisk/burst), monochrome currentColor. */+function ClaudeMark({ className }: { className?: string }) {+ return (+ <svg+ className={className}+ viewBox="0 0 24 24"+ fill="currentColor"+ aria-hidden="true"+ xmlns="http://www.w3.org/2000/svg"+ >+ <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" />+ </svg>);}diff --git a/docs/components/provider-card.tsx b/docs/components/provider-card.tsxindex 6f507b289..23f0bb8a2 100644--- a/docs/components/provider-card.tsx+++ b/docs/components/provider-card.tsx@@ -17,7 +17,7 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Prreturn (<Linkhref={href}- 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"+ 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"><div className="flex h-12 w-12 shrink-0 items-center justify-center">{logo && logoDark ? (diff --git a/docs/components/quickstart/framework-selector.tsx b/docs/components/quickstart/framework-selector.tsxindex c724043c1..01836ff55 100644--- a/docs/components/quickstart/framework-selector.tsx+++ b/docs/components/quickstart/framework-selector.tsx@@ -56,7 +56,7 @@ function FrameworkCard({ framework, selected, onSelect }: FrameworkCardProps) {onClick={onSelect}className={`flex flex-col items-start gap-4 rounded-xl border-2 p-5 text-left transition-all- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2${selected? 'border-[var(--composio-orange)] bg-fd-card': 'border-fd-border bg-fd-card hover:bg-fd-accent/50'diff --git a/docs/components/quickstart/index.tsx b/docs/components/quickstart/index.tsxindex 3e321ca50..3cbd0d73d 100644--- a/docs/components/quickstart/index.tsx+++ b/docs/components/quickstart/index.tsx@@ -1,4 +1,3 @@export { FrameworkSelector, frameworks } from './framework-selector';export { QuickstartFlow, FrameworkOption } from './quickstart-flow';-export { PromptBanner } from './prompt-banner';export type { Framework } from './framework-selector';diff --git a/docs/components/quickstart/prompt-banner.tsx b/docs/components/quickstart/prompt-banner.tsxdeleted file mode 100644index 0bfeb07aa..000000000--- a/docs/components/quickstart/prompt-banner.tsx+++ /dev/null@@ -1,168 +0,0 @@-'use client';--import { useState, useRef, useEffect, type ReactNode } from 'react';-import { Copy, Check } from 'lucide-react';--function detectLang(pre: Element, code: Element | null): string {- for (const el of [pre, code]) {- const lang = el?.getAttribute('data-language') ?? el?.getAttribute('data-lang');- if (lang) return lang;- }- const cls = Array.from(code?.classList ?? []).find(c => c.startsWith('language-'));- if (cls) return cls.replace('language-', '');- const text = code?.textContent ?? '';- if (/^(pip|npm|npx|bun|yarn|pnpm) /.test(text.trim())) return 'bash';- if (text.includes('from dotenv') || text.includes('import asyncio')) return 'python';- if (text.includes('from "') || text.includes('from "@')) return 'typescript';- if (text.includes('COMPOSIO_API_KEY=')) return 'bash';- return '';-}--function getTabLabel(pre: Element, step: Element): string {- let el: Element | null = pre.parentElement;- while (el && el !== step) {- if (el.getAttribute('role') === 'tabpanel') {- const tablist = el.parentElement?.querySelector('[role="tablist"]');- if (tablist) {- const tabs = tablist.querySelectorAll('[role="tab"]');- const panels = el.parentElement?.querySelectorAll(':scope > [role="tabpanel"]');- if (panels) {- const idx = Array.from(panels).indexOf(el);- if (idx >= 0 && tabs[idx]) return tabs[idx].textContent?.trim() ?? '';- }- }- return '';- }- el = el.parentElement;- }- return '';-}--function extractSteps(stepsEl: Element): string {- const parts: string[] = [];- const steps = stepsEl.querySelectorAll('.fd-step');-- steps.forEach((step) => {- const title = step.querySelector('h3, h4, h2, [class*="step-title"], [class*="StepTitle"]');- const titleText = title?.textContent?.trim();- if (titleText) parts.push(`### ${titleText}`);-- const pres = step.querySelectorAll('pre');- pres.forEach((pre) => {- const codeEl = pre.querySelector('code');- const code = codeEl?.textContent?.trim() ?? '';- if (!code) return;-- const lang = detectLang(pre, codeEl);- const tabLabel = getTabLabel(pre, step);-- if (tabLabel) {- parts.push(`**${tabLabel}**\n\n\`\`\`${lang}\n${code}\n\`\`\``);- } else {- parts.push(`\`\`\`${lang}\n${code}\n\`\`\``);- }- });- });-- return parts.join('\n\n');-}--interface PromptBannerProps {- children: ReactNode;-}--export function PromptBanner({ children }: PromptBannerProps) {- const [copied, setCopied] = useState(false);- const contentRef = useRef<HTMLDivElement>(null);- const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);-- useEffect(() => () => { clearTimeout(timerRef.current); }, []);-- const handleCopy = async () => {- const fullMeta = contentRef.current?.innerText ?? '';-- const splitMarker = 'Key concepts';- const splitIdx = fullMeta.indexOf(splitMarker);- const context = splitIdx > 0 ? fullMeta.slice(0, splitIdx).trim() : fullMeta;- const rules = splitIdx > 0 ? fullMeta.slice(splitIdx).trim() : '';-- let sibling = contentRef.current?.closest('.not-prose')?.nextElementSibling;- let stepsText = '';- while (sibling) {- if (sibling.classList.contains('fd-steps')) {- stepsText = extractSteps(sibling);- break;- }- sibling = sibling.nextElementSibling;- }-- const parts = [context];- if (stepsText) parts.push(`## Code\n\n${stepsText}`);- if (rules) parts.push(rules);- const fullPrompt = parts.join('\n\n');-- try {- await navigator.clipboard.writeText(fullPrompt);- clearTimeout(timerRef.current);- setCopied(true);- timerRef.current = setTimeout(() => setCopied(false), 2000);- } catch {- // Clipboard write failed (e.g. permission denied) — don't show success- }- };-- return (- <div className="not-prose mb-6">- <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">- {/* Shader gradient blobs */}- <div- className="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}- />- <div- className="pointer-events-none absolute right-20 -bottom-24 h-48 w-48 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}- />- <div- className="pointer-events-none absolute left-72 -top-20 h-44 w-44 rounded-full"- style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}- />-- {/* Sparkle */}- <svg className="relative shrink-0" aria-hidden="true" width="28" height="28" viewBox="0 0 28 28" fill="none">- <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"/>- </svg>-- <p className="relative flex-1 text-[15px] text-fd-foreground/70">- Use skills or copy prompt to get started faster!- </p>-- <div className="relative flex shrink-0 items-center gap-3">- <a- href="https://skills.sh/composiohq/skills/composio"- target="_blank"- rel="noopener noreferrer"- 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"- >- Skills- <span aria-hidden="true">↗</span>- </a>- <button- type="button"- onClick={handleCopy}- 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'}`}- >- {copied ? (- <Check className="h-4 w-4" strokeWidth={3} />- ) : (- <Copy className="h-4 w-4" />- )}- {copied ? 'Copied!' : 'Copy prompt'}- </button>- </div>- </div>- {/* Hidden prompt content for copy button */}- <div ref={contentRef} className="sr-only">{children}</div>- </div>- );-}diff --git a/docs/components/quickstart/quickstart-flow.tsx b/docs/components/quickstart/quickstart-flow.tsxindex f917bb8e6..f8673fba3 100644--- a/docs/components/quickstart/quickstart-flow.tsx+++ b/docs/components/quickstart/quickstart-flow.tsx@@ -79,7 +79,7 @@ function FrameworkCard({ name, logo, logoDark, selected, onSelect }: FrameworkCaonClick={onSelect}className={`flex items-center gap-3 rounded-lg border px-3 py-2.5 text-left transition-all- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2${selected? 'border-[var(--composio-orange)] bg-fd-accent/30': 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'diff --git a/docs/components/template-card.tsx b/docs/components/template-card.tsxindex 70e242888..edbf75dfb 100644--- a/docs/components/template-card.tsx+++ b/docs/components/template-card.tsx@@ -25,7 +25,7 @@ export function TemplateCard({href={href}target="_blank"rel="noopener noreferrer"- 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"+ 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"><div className="flex flex-col gap-3 sm:w-1/2 shrink-0 pt-2"><h3 className="text-xl font-bold text-fd-foreground">{title}</h3>diff --git a/docs/components/tool-type-selector.tsx b/docs/components/tool-type-selector.tsxindex ba15f7f43..606a467c1 100644--- a/docs/components/tool-type-selector.tsx+++ b/docs/components/tool-type-selector.tsx@@ -76,7 +76,7 @@ function ToolTypeCard({ name, icon, selected, onSelect }: ToolTypeCardProps) {onClick={onSelect}className={`flex items-center gap-3 rounded-lg border px-4 py-3 text-left transition-all- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2${selected? 'border-[var(--composio-orange)] bg-fd-accent/30': 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'diff --git a/docs/components/toolkits/auth-details-section.tsx b/docs/components/toolkits/auth-details-section.tsxindex 2e37dac33..99dca67a1 100644--- a/docs/components/toolkits/auth-details-section.tsx+++ b/docs/components/toolkits/auth-details-section.tsx@@ -1,6 +1,7 @@'use client';-import { Key } from 'lucide-react';+import { ArrowUpRight, Key } from 'lucide-react';+import Link from 'next/link';import { TypeTable } from 'fumadocs-ui/components/type-table';import { Accordion, Accordions } from '@/mdx-components';import type { AuthConfigDetail, AuthConfigField } from '@/types/toolkit';@@ -81,9 +82,14 @@ export function AuthDetailsSection({ authConfigDetails, authSchemes, composioManAuthentication Details{hasOAuth && (composioManagedAuthSchemes && composioManagedAuthSchemes.length > 0 ? (- <span className="rounded bg-green-500/10 px-2 py-0.5 text-xs font-medium text-green-600 dark:text-green-400">+ <Link+ href="/toolkits/managed-auth"+ 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"+ >+ <span className="size-1.5 rounded-full bg-green-500" aria-hidden="true" />Composio Managed App available- </span>+ <ArrowUpRight className="size-3" aria-hidden="true" />+ </Link>) : (<span className="rounded bg-amber-500/10 px-2 py-0.5 text-xs font-medium text-amber-600 dark:text-amber-400">Composio Managed App not availablediff --git a/docs/components/toolkits/managed-auth-list.tsx b/docs/components/toolkits/managed-auth-list.tsxindex 558b86578..893ac5f85 100644--- a/docs/components/toolkits/managed-auth-list.tsx+++ b/docs/components/toolkits/managed-auth-list.tsx@@ -49,7 +49,7 @@ function CopySlugButton({ slug }: { slug: string }) {<buttononClick={handleCopy}aria-label={`Copy ${slug.toUpperCase()} to clipboard`}- 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"+ 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"><span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>{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() {autoComplete="off"value={search}onChange={(e) => setSearch(e.target.value)}- 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"+ 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"/></div>- {/* Tabs + Copy */}- <div className="flex items-center justify-between border-b border-fd-border">- <div className="flex items-center gap-1">- <button- onClick={() => setTab('managed')}- className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${- tab === 'managed'- ? 'border-green-500 text-fd-foreground'- : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'- }`}- >- <span className="inline-block h-2 w-2 rounded-full bg-green-500" />- Composio Managed App Available- <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>- </button>- <button- onClick={() => setTab('unmanaged')}- className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${- tab === 'unmanaged'- ? 'border-amber-500 text-fd-foreground'- : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'- }`}- >- <span className="inline-block h-2 w-2 rounded-full bg-amber-500" />- Requires your own credentials- <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>- </button>- </div>+ {/* Tabs */}+ <div className="flex items-center gap-1 border-b border-fd-border">+ <button+ onClick={() => setTab('managed')}+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${+ tab === 'managed'+ ? 'border-green-500 text-fd-foreground'+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'+ }`}+ >+ <span className="inline-block h-2 w-2 rounded-full bg-green-500" />+ Composio Managed App Available+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>+ </button>+ <button+ onClick={() => setTab('unmanaged')}+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${+ tab === 'unmanaged'+ ? 'border-fd-muted-foreground text-fd-foreground'+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'+ }`}+ >+ <span className="inline-block h-2 w-2 rounded-full bg-fd-muted-foreground/60" />+ Requires your own credentials+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>+ </button>+ </div>++ {/* Copy slugs — separate row, aligned with list content */}+ <div className="flex justify-end"><CopyButton toolkits={activeList} /></div>diff --git a/docs/components/toolkits/toolkit-detail.tsx b/docs/components/toolkits/toolkit-detail.tsxindex e2718faab..3c3eb4432 100644--- a/docs/components/toolkits/toolkit-detail.tsx+++ b/docs/components/toolkits/toolkit-detail.tsx@@ -2,11 +2,12 @@import { useState, useMemo, useEffect, type ReactNode } from 'react';import Link from 'next/link';-import { ExternalLink, Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';+import { Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';import { TypeTable } from 'fumadocs-ui/components/type-table';import type { Toolkit, Tool, Trigger, ParameterSchema } from '@/types/toolkit';import { processSchema } from '@/lib/toolkit-schema';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';import { AuthDetailsSection } from '@/components/toolkits/auth-details-section';import { FaqSection, type FaqItem } from '@/components/toolkits/faq-section';@@ -317,56 +318,41 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe</Link>{/* Header */}- <div className="flex gap-4">+ <div className="flex flex-wrap items-start justify-between gap-4">+ <div className="flex min-w-0 flex-1 gap-4"><ToolkitIcon key={toolkit.slug} toolkit={toolkit} /><div className="min-w-0 flex-1">{/* Title row */}- <div className="flex flex-wrap items-center justify-between gap-2">- <div className="flex flex-wrap items-center gap-2">- <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>- <button- onClick={copySlug}- 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"- >- {toolkit.slug.toUpperCase()}- {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}- </button>- </div>+ <div className="flex flex-wrap items-center gap-x-2 gap-y-1">+ <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>+ <button+ onClick={copySlug}+ 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"+ >+ {toolkit.slug.toUpperCase()}+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}+ </button>{toolkit.version && (- <div className="flex items-center gap-2 text-sm text-fd-muted-foreground">+ <span className="inline-flex items-center gap-1.5 text-xs text-fd-muted-foreground"><span>Latest version</span><buttononClick={copyVersion}- 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"+ 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">{toolkit.version}{versionCopied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}</button>- </div>+ </span>)}</div>{/* Description */}<p className="mt-1.5 text-sm text-fd-muted-foreground">{toolkit.description}</p>-- {/* Actions */}- <div className="mt-4 flex flex-wrap items-center justify-between gap-2">- <div className="flex flex-wrap items-center gap-2">- <Link- href={`https://platform.composio.dev/marketplace/${toolkit.slug}`}- target="_blank"- rel="noopener noreferrer"- 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"- >- Try {(toolkit.name?.trim() || toolkit.slug)}- <ExternalLink className="h-3.5 w-3.5" />- </Link>- </div>- </div>-- {/* Page actions */}- <PageActions path={path} /></div>+ </div>++ {/* Page actions */}+ <PageActions path={path} variant="inline" /></div>{/* Authentication Details */}@@ -392,7 +378,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe>Tools ({tools.length}){activeTab === 'tools' && (- <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />)}</button>{triggers.length > 0 && (@@ -406,7 +392,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe>Triggers ({triggers.length}){activeTab === 'triggers' && (- <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />)}</button>)}@@ -423,7 +409,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDeautoComplete="off"value={toolSearch}onChange={(e) => setToolSearch(e.target.value)}- 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"+ 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"/></div>@@ -454,6 +440,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe</div></div>)}+ <EditOnGitHub path="docs/components/toolkits/toolkit-detail.tsx" /></div>);}diff --git a/docs/components/toolkits/toolkits-landing.tsx b/docs/components/toolkits/toolkits-landing.tsxindex 2f01b58d5..5ad6b9216 100644--- a/docs/components/toolkits/toolkits-landing.tsx+++ b/docs/components/toolkits/toolkits-landing.tsx@@ -59,7 +59,7 @@ function CopySlugButton({ slug }: { slug: string }) {<buttononClick={handleCopy}aria-label={`Copy ${slug.toUpperCase()} to clipboard`}- 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"+ 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"><span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>{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() {<p className="mt-1.5 text-sm text-fd-muted-foreground sm:mt-2 sm:text-base">Browse {toolkits.length} toolkits supported by Composio</p>- <PageActions path="/toolkits" /></div><div className="flex flex-wrap items-center gap-2">+ <PageActions path="/toolkits" variant="inline" /><a- href="https://platform.composio.dev/auth?next_page=%2Ftool-router"+ href="https://dashboard.composio.dev/~/project/playground"target="_blank"rel="noopener noreferrer"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() {href="https://request.composio.dev/boards/tool-requests"target="_blank"rel="noopener noreferrer"- 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"+ 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"><Grip className="h-3.5 w-3.5" />Request Tools@@ -196,7 +196,7 @@ export function ToolkitsLanding() {autoComplete="off"value={search}onChange={(e) => setSearch(e.target.value)}- 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"+ 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"/></div>diff --git a/docs/components/top-nav.tsx b/docs/components/top-nav.tsxindex f952ef2a6..cef1b2d16 100644--- a/docs/components/top-nav.tsx+++ b/docs/components/top-nav.tsx@@ -51,7 +51,7 @@ export function TopNav() {<Linkkey={item.href}href={item.href}- 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 ${+ 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 ${isActive(item.href)? 'text-[var(--composio-orange)]': 'text-fd-muted-foreground hover:text-fd-foreground'diff --git a/docs/content/changelog/04-24-26-trigger-disabled-event.mdx b/docs/content/changelog/04-24-26-trigger-disabled-event.mdxindex d4d3d43d6..696d04bad 100644--- a/docs/content/changelog/04-24-26-trigger-disabled-event.mdx+++ b/docs/content/changelog/04-24-26-trigger-disabled-event.mdx@@ -21,7 +21,7 @@ The event does not fire when you disable a trigger yourself — neither through## Subscribe-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:+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:```bashcurl -X PATCH https://backend.composio.dev/api/v3/webhook_subscriptions/ws_your-subscription-id \diff --git a/docs/content/docs/auth-configuration/white-labeling.mdx b/docs/content/docs/auth-configuration/white-labeling.mdxindex 65ed56b53..b21cc65cf 100644--- a/docs/content/docs/auth-configuration/white-labeling.mdx+++ b/docs/content/docs/auth-configuration/white-labeling.mdx@@ -26,7 +26,7 @@ The Connect Link is the hosted page your users see when connecting their accountTo replace it with your own branding:-1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)+1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)2. Upload your **Logo** and set your **App Title**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.diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdxindex 4036d88c2..2fcbba2cb 100644--- a/docs/content/docs/common-faq.mdx+++ b/docs/content/docs/common-faq.mdx@@ -49,7 +49,7 @@ Create a new session when the config changes: different toolkits, different auth<Accordions><Accordion title="Where can I see all available toolkits?">-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.+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.</Accordion><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</Accordion><Accordion title="Where can I find execution logs?">-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**.+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**.See [Troubleshooting tools](/docs/troubleshooting/tools) for how to use logs to debug failed executions.</Accordion>diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdxindex 4378ddd3c..70aa8c70b 100644--- a/docs/content/docs/configuring-sessions.mdx+++ b/docs/content/docs/configuring-sessions.mdx@@ -518,7 +518,7 @@ console.log(mcp.url);</Tab></Tabs>-For framework examples, see provider-specific documentation like [OpenAI Agents](/docs/providers/openai-agents) or [Vercel AI SDK](/docs/providers/vercel).+For framework examples, see provider-specific documentation like [OpenAI](/docs/providers/openai) or [Vercel AI SDK](/docs/providers/vercel).### tools()diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdxindex 51edeb62e..85a267489 100644--- a/docs/content/docs/index.mdx+++ b/docs/content/docs/index.mdx@@ -4,99 +4,20 @@ description: Composio powers 1000+ toolkits, tool search, context management, aukeywords: [getting started, introduction]----Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.--<Cards>- <Card- title="Tutorial: Build a chat app"- href="/cookbooks/chat-app"- description="Build a Next.js chat app where your agent can discover and use tools across 1000+ apps."- />- <Card- title="How Composio works"- href="/docs/how-composio-works"- description="See what happens under the hood when your agent searches, authenticates, and executes a tool."- />-</Cards>--## Get Started--<AIToolsBanner />--<Cards className="grid-cols-1">- <Card- icon={<Rocket />}- title="Quickstart"- href="/docs/quickstart"- description="Install the SDK, connect an app, and run your first tool call in 5 minutes."- />-</Cards>--## Explore--<Cards>- <Card- icon={<Wrench />}- title="Toolkits"- href="/toolkits"- description="Browse 1000+ toolkits across GitHub, Gmail, Slack, Notion, and more."- />- <Card- icon={<Play />}- title="Playground"- href="https://platform.composio.dev/auth?next_page=%2Ftool-router"- description="Try Composio in your browser without writing any code."- />-</Cards>+<DocsHero />## ProvidersComposio works with any AI framework. Pick your preferred SDK:<ProviderGrid>- <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"]} /><ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />- <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"]} /><ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />- <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} /><ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />+ <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} /><ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />- <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} /><ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} /><ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} /><ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} /><ProviderCard name="Build your own" href="/docs/providers/custom-providers" icon={<Blocks size={32} />} languages={["Python", "TypeScript"]} /></ProviderGrid>--## Features--<Cards>- <Card- icon={<Key />}- title="Authentication"- href="/docs/authentication"- description="OAuth, API keys, and custom auth flows"- />- <Card- icon={<Zap />}- title="Triggers"- href="/docs/triggers"- description="Subscribe to external events and trigger workflows"- />- <Card- icon={<Terminal />}- title="CLI"- href="/docs/cli"- description="Manage toolkits, execute tools, and generate type-safe code from the terminal"- />- <Card- icon={<Palette />}- title="White Labeling"- href="/docs/white-labeling-authentication"- description="Customize auth screens with your branding"- />-</Cards>--## Community--Join our [Discord](https://discord.gg/composio) community!diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.jsonindex 708613507..fb6ff75a9 100644--- a/docs/content/docs/meta.json+++ b/docs/content/docs/meta.json@@ -5,7 +5,6 @@"quickstart","providers","cli",- "claude-code-plugin","---Core Concepts---","how-composio-works","users-and-sessions",diff --git a/docs/content/docs/projects.mdx b/docs/content/docs/projects.mdxindex d9fd88c61..d09c0a2c2 100644--- a/docs/content/docs/projects.mdx+++ b/docs/content/docs/projects.mdx@@ -25,7 +25,7 @@ Common reasons to use multiple projects:## Managing projects-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`).+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`).<Callout type="info">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 \Notable security setting:- `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.-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.+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.## What to read nextdiff --git a/docs/content/docs/providers/anthropic.mdx b/docs/content/docs/providers/anthropic.mdxindex 958c95149..2f212d089 100644--- a/docs/content/docs/providers/anthropic.mdx+++ b/docs/content/docs/providers/anthropic.mdx@@ -1,14 +1,19 @@---title: Anthropicdescription: Build an agent with Claude and enable it to use 1000+ tools with Composio.-keywords: [claude, messages api]+keywords: [claude, messages api, claude agent sdk, agents sdk]----The Anthropic Provider transforms Composio tools into a format compatible with the [Claude Messages API](https://docs.anthropic.com/en/api/messages).+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.-<Callout type="info">-Looking for the Claude Agent SDK? See the [Claude Agent SDK](/docs/providers/claude-agent-sdk) provider page.-</Callout>+<IntegrationTabs tabs={[+ { value: "messages", label: "Messages API" },+ { value: "agent-sdk", label: "Claude Agent SDK" },+]}>++<IntegrationContent value="messages">++The Anthropic Provider transforms Composio tools into a format compatible with the Claude Messages API.<Steps><Step>@@ -32,7 +37,7 @@ npm install @composio/core @composio/anthropic @anthropic-ai/sdk**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"@@ -149,6 +154,116 @@ for (const block of response.content) {</Step></Steps>+</IntegrationContent>++<IntegrationContent value="agent-sdk">++The Claude Agent SDK provider transforms Composio tools into tools compatible with the Claude Agent SDK.++<Steps>+<Step>+**Install**++<Tabs groupId="language" items={["Python", "TypeScript"]} persist>+<Tab value="Python">+```bash+pip install composio composio_claude_agent_sdk claude-agent-sdk+```+</Tab>+<Tab value="TypeScript">+```bash+npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk+```+</Tab>+</Tabs>+</Step>++<Step>+**Configure API Keys**++<Callout type="info">+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).+</Callout>++```txt title=".env"+COMPOSIO_API_KEY=xxxxxxxxx+ANTHROPIC_API_KEY=xxxxxxxxx+```+</Step>++<Step>+**Create session and run**++<Tabs groupId="language" items={["Python", "TypeScript"]} persist>+<Tab value="Python">+```python+import asyncio+from composio import Composio+from composio_claude_agent_sdk import ClaudeAgentSDKProvider+from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server++composio = Composio(provider=ClaudeAgentSDKProvider())++# Create a session for your user+session = composio.create(user_id="user_123")+tools = session.tools()+tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)++async def main():+ options = ClaudeAgentOptions(+ system_prompt="You are a helpful assistant",+ permission_mode="bypassPermissions",+ mcp_servers={"composio": tool_server},+ )++ async with ClaudeSDKClient(options=options) as client:+ await client.query("Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")+ async for msg in client.receive_response():+ print(msg)++asyncio.run(main())+```+</Tab>+<Tab value="TypeScript">+```js+import { Composio } from '@composio/core';+import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';+import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';++const composio = new Composio({+ provider: new ClaudeAgentSDKProvider(),+});++// Create a session for your user+const session = await composio.create("user_123");+const tools = await session.tools();+const toolServer = createSdkMcpServer({+ name: "composio",+ version: "1.0.0",+ tools: tools,+});++for await (const content of query({+ prompt: "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",+ options: {+ mcpServers: { composio: toolServer },+ permissionMode: "bypassPermissions",+ },+})) {+ if (content.type === "assistant") {+ console.log("Claude:", content.message);+ }+}+```+</Tab>+</Tabs>+</Step>+</Steps>++</IntegrationContent>++</IntegrationTabs>+## Multi-turn chatFor multi-turn apps, create the session once and reuse it across requests with `composio.use()`:diff --git a/docs/content/docs/providers/autogen.mdx b/docs/content/docs/providers/autogen.mdxindex 8ec1e9dea..d28e09305 100644--- a/docs/content/docs/providers/autogen.mdx+++ b/docs/content/docs/providers/autogen.mdx@@ -19,7 +19,7 @@ pip install composio composio_autogen autogen-agentchat**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"diff --git a/docs/content/docs/providers/claude-agent-sdk.mdx b/docs/content/docs/providers/claude-agent-sdk.mdxdeleted file mode 100644index 14f194843..000000000--- a/docs/content/docs/providers/claude-agent-sdk.mdx+++ /dev/null@@ -1,111 +0,0 @@-----title: Claude Agent SDK-description: Build an agent with the Claude Agent SDK and enable it to use 1000+ tools with Composio.-keywords: [claude agent sdk, claude code]------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).--<Callout type="info">-Looking for the Claude Messages API? See the [Anthropic](/docs/providers/anthropic) provider page.-</Callout>--<Steps>-<Step>-**Install**--<Tabs groupId="language" items={["Python", "TypeScript"]} persist>-<Tab value="Python">-```bash-pip install composio composio_claude_agent_sdk claude-agent-sdk-```-</Tab>-<Tab value="TypeScript">-```bash-npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk-```-</Tab>-</Tabs>-</Step>--<Step>-**Configure API Keys**--<Callout type="info">-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).-</Callout>--```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-ANTHROPIC_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run**--<Tabs groupId="language" items={["Python", "TypeScript"]} persist>-<Tab value="Python">-```python-import asyncio-from composio import Composio-from composio_claude_agent_sdk import ClaudeAgentSDKProvider-from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server--composio = Composio(provider=ClaudeAgentSDKProvider())--# Create a session for your user-session = composio.create(user_id="user_123")-tools = session.tools()-tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)--async def main():- options = ClaudeAgentOptions(- system_prompt="You are a helpful assistant",- permission_mode="bypassPermissions",- mcp_servers={"composio": tool_server},- )-- async with ClaudeSDKClient(options=options) as client:- await client.query("Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")- async for msg in client.receive_response():- print(msg)--asyncio.run(main())-```-</Tab>-<Tab value="TypeScript">-```js-import { Composio } from '@composio/core';-import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';-import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';--const composio = new Composio({- provider: new ClaudeAgentSDKProvider(),-});--// Create a session for your user-const session = await composio.create("user_123");-const tools = await session.tools();-const toolServer = createSdkMcpServer({- name: "composio",- version: "1.0.0",- tools: tools,-});--for await (const content of query({- prompt: "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",- options: {- mcpServers: { composio: toolServer },- permissionMode: "bypassPermissions",- },-})) {- if (content.type === "assistant") {- console.log("Claude:", content.message);- }-}-```-</Tab>-</Tabs>-</Step>-</Steps>diff --git a/docs/content/docs/providers/crewai.mdx b/docs/content/docs/providers/crewai.mdxindex f70026274..de2042248 100644--- a/docs/content/docs/providers/crewai.mdx+++ b/docs/content/docs/providers/crewai.mdx@@ -19,7 +19,7 @@ pip install composio composio_crewai crewai**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"diff --git a/docs/content/docs/providers/google-adk.mdx b/docs/content/docs/providers/google-adk.mdxdeleted file mode 100644index 80353baae..000000000--- a/docs/content/docs/providers/google-adk.mdx+++ /dev/null@@ -1,82 +0,0 @@-----title: Google ADK-description: Build an agent with Google ADK and enable it to use 1000+ tools with Composio.-keywords: [google adk, agent development kit, gemini]------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.--<Callout type="info">-Looking for Gemini without ADK? See the [Google Generative AI](/docs/providers/google) provider page.-</Callout>--<Steps>-<Step>-**Install**--```bash-pip install composio composio_google_adk google-adk-```-</Step>--<Step>-**Configure API Keys**--<Callout type="info">-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).-</Callout>--```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-GOOGLE_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run**--```python-from composio import Composio-from composio_google_adk import GoogleAdkProvider-from google.adk.agents import Agent-from google.adk.runners import Runner-from google.adk.sessions import InMemorySessionService-from google.genai import types--composio = Composio(provider=GoogleAdkProvider())--# Create a session for your user-session = composio.create(user_id="user_123")-tools = session.tools()--agent = Agent(- name="email_agent",- model="gemini-3-pro-preview",- instruction="You are an AI agent that sends emails using Gmail.",- tools=tools,-)--session_service = InMemorySessionService()-adk_session = session_service.create_session_sync(- app_name="email_agent",- user_id="user_123",- session_id="session_1",-)-runner = Runner(- agent=agent,- app_name="email_agent",- session_service=session_service,-)--content = types.Content(- role="user",- parts=[types.Part(text="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")],-)--events = runner.run(user_id="user_123", session_id="session_1", new_message=content)-for event in events:- if event.is_final_response() and event.content and event.content.parts:- print(event.content.parts[0].text)-```-</Step>-</Steps>diff --git a/docs/content/docs/providers/google.mdx b/docs/content/docs/providers/google.mdxindex ac38db3c6..548174662 100644--- a/docs/content/docs/providers/google.mdx+++ b/docs/content/docs/providers/google.mdx@@ -1,10 +1,19 @@----title: Google Generative AI-description: Build an agent with Gemini and enable it to use 1000+ tools with Composio.-keywords: [gemini, google generative ai, google genai]+title: Google+description: Build an agent with Gemini or Google ADK and enable it to use 1000+ tools with Composio.+keywords: [gemini, google generative ai, google genai, google adk, agent development kit]----The Google Generative AI provider transforms Composio tools into a format compatible with [Gemini's function calling](https://ai.google.dev/) capabilities.+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.++<IntegrationTabs tabs={[+ { value: "gemini", label: "Gemini" },+ { value: "adk", label: "ADK" },+]}>++<IntegrationContent value="gemini">++The Google Generative AI provider transforms Composio tools into a format compatible with Gemini function calling.<Steps><Step>@@ -28,7 +37,7 @@ npm install @composio/core @composio/google @google/genai**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"@@ -121,3 +130,84 @@ console.log(response.text);</Tabs></Step></Steps>++</IntegrationContent>++<IntegrationContent value="adk">++The Google ADK provider transforms Composio tools into Google ADK's FunctionTool format for use with Google ADK agents. ADK integration is Python-only.++<Steps>+<Step>+**Install**++```bash+pip install composio composio_google_adk google-adk+```+</Step>++<Step>+**Configure API Keys**++<Callout type="info">+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).+</Callout>++```txt title=".env"+COMPOSIO_API_KEY=xxxxxxxxx+GOOGLE_API_KEY=xxxxxxxxx+```+</Step>++<Step>+**Create session and run**++```python+from composio import Composio+from composio_google_adk import GoogleAdkProvider+from google.adk.agents import Agent+from google.adk.runners import Runner+from google.adk.sessions import InMemorySessionService+from google.genai import types++composio = Composio(provider=GoogleAdkProvider())++# Create a session for your user+session = composio.create(user_id="user_123")+tools = session.tools()++agent = Agent(+ name="email_agent",+ model="gemini-3-pro-preview",+ instruction="You are an AI agent that sends emails using Gmail.",+ tools=tools,+)++session_service = InMemorySessionService()+adk_session = session_service.create_session_sync(+ app_name="email_agent",+ user_id="user_123",+ session_id="session_1",+)+runner = Runner(+ agent=agent,+ app_name="email_agent",+ session_service=session_service,+)++content = types.Content(+ role="user",+ parts=[types.Part(text="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")],+)++events = runner.run(user_id="user_123", session_id="session_1", new_message=content)+for event in events:+ if event.is_final_response() and event.content and event.content.parts:+ print(event.content.parts[0].text)+```+</Step>+</Steps>++</IntegrationContent>++</IntegrationTabs>diff --git a/docs/content/docs/providers/index.mdx b/docs/content/docs/providers/index.mdxindex a33722415..5e41173f2 100644--- a/docs/content/docs/providers/index.mdx+++ b/docs/content/docs/providers/index.mdx@@ -5,27 +5,23 @@ description: Composio works with any AI framework. Pick your preferred SDK to geComposio works with any AI framework. Each provider transforms Composio tools into the native format your framework expects — no glue code needed.+## AI SDKs++<ProviderGrid>+ <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />+ <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />+ <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />+ <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />+</ProviderGrid>+## Agent Frameworks<ProviderGrid><ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />- <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} /><ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} /><ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} /><ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} /><ProviderCard name="AutoGen" href="/docs/providers/autogen" languages={["Python"]} />- <ProviderCard name="Google ADK" href="/docs/providers/google-adk" logo="/images/providers/google-logo.svg" languages={["Python"]} />-</ProviderGrid>--## AI SDKs--<ProviderGrid>- <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"]} />- <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />- <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"]} />- <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />- <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />- <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} /></ProviderGrid>## Customdiff --git a/docs/content/docs/providers/langchain.mdx b/docs/content/docs/providers/langchain.mdxindex 57995e033..ce14f3856 100644--- a/docs/content/docs/providers/langchain.mdx+++ b/docs/content/docs/providers/langchain.mdx@@ -1,10 +1,19 @@---title: LangChain-description: Build an agent with LangChain and enable it to use 1000+ tools with Composio.-keywords: [langchain]+description: Build an agent with LangChain or LangGraph and enable it to use 1000+ tools with Composio.+keywords: [langchain, langgraph]----The LangChain provider transforms Composio tools into LangChain's [StructuredTool](https://python.langchain.com/docs/how_to/custom_tools/) format with built-in execution.+Composio integrates with [LangChain](https://python.langchain.com/) and [LangGraph](https://langchain-ai.github.io/langgraph/). Pick the tab that matches your integration.++<IntegrationTabs tabs={[+ { value: "langchain", label: "LangChain" },+ { value: "langgraph", label: "LangGraph" },+]}>++<IntegrationContent value="langchain">++The LangChain provider transforms Composio tools into LangChain's StructuredTool format with built-in execution.<Steps><Step>@@ -28,7 +37,7 @@ npm install @composio/core @composio/langchain @langchain/openai @langchain/lang**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"@@ -116,3 +125,59 @@ console.log(finalState.messages[finalState.messages.length - 1].content);</Tabs></Step></Steps>++</IntegrationContent>++<IntegrationContent value="langgraph">++The LangGraph provider transforms Composio tools into LangChain StructuredTool format for use with LangGraph agents. LangGraph integration is Python-only.++<Steps>+<Step>+**Install**++```bash+pip install composio composio_langgraph langgraph langchain_openai+```+</Step>++<Step>+**Configure API Keys**++<Callout type="info">+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).+</Callout>++```txt title=".env"+COMPOSIO_API_KEY=xxxxxxxxx+OPENAI_API_KEY=xxxxxxxxx+```+</Step>++<Step>+**Create session and run**++```python+from composio import Composio+from composio_langgraph import LanggraphProvider+from langchain.agents import create_agent+from langchain_openai import ChatOpenAI++composio = Composio(provider=LanggraphProvider())+llm = ChatOpenAI(model="gpt-5.2")++# Create a session for your user+session = composio.create(user_id="user_123")+tools = session.tools()++agent = create_agent(tools=tools, model=llm)+result = agent.invoke({"messages": [("user", "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")]})++print(result["messages"][-1].content)+```+</Step>+</Steps>++</IntegrationContent>++</IntegrationTabs>diff --git a/docs/content/docs/providers/langgraph.mdx b/docs/content/docs/providers/langgraph.mdxdeleted file mode 100644index f0ccffec1..000000000--- a/docs/content/docs/providers/langgraph.mdx+++ /dev/null@@ -1,53 +0,0 @@-----title: LangGraph-description: Build an agent with LangGraph and enable it to use 1000+ tools with Composio.-keywords: [langgraph]------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.--<Steps>-<Step>-**Install**--```bash-pip install composio composio_langgraph langgraph langchain_openai-```-</Step>--<Step>-**Configure API Keys**--<Callout type="info">-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).-</Callout>--```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-OPENAI_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run**--```python-from composio import Composio-from composio_langgraph import LanggraphProvider-from langchain.agents import create_agent-from langchain_openai import ChatOpenAI--composio = Composio(provider=LanggraphProvider())-llm = ChatOpenAI(model="gpt-5.2")--# Create a session for your user-session = composio.create(user_id="user_123")-tools = session.tools()--agent = create_agent(tools=tools, model=llm)-result = agent.invoke({"messages": [("user", "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")]})--print(result["messages"][-1].content)-```-</Step>-</Steps>diff --git a/docs/content/docs/providers/llamaindex.mdx b/docs/content/docs/providers/llamaindex.mdxindex 49589a398..4fca3e410 100644--- a/docs/content/docs/providers/llamaindex.mdx+++ b/docs/content/docs/providers/llamaindex.mdx@@ -28,7 +28,7 @@ npm install @composio/core @composio/llamaindex @llamaindex/openai @llamaindex/w**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"diff --git a/docs/content/docs/providers/mastra.mdx b/docs/content/docs/providers/mastra.mdxindex 7156b60a3..c83d425a6 100644--- a/docs/content/docs/providers/mastra.mdx+++ b/docs/content/docs/providers/mastra.mdx@@ -19,7 +19,7 @@ npm install @composio/core @composio/mastra @mastra/core @ai-sdk/openai**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"diff --git a/docs/content/docs/providers/meta.json b/docs/content/docs/providers/meta.jsonindex 0871dc2c8..d83ada503 100644--- a/docs/content/docs/providers/meta.json+++ b/docs/content/docs/providers/meta.json@@ -2,19 +2,15 @@"title": "Providers","pages": ["...",- "claude-agent-sdk","anthropic",- "openai-agents","openai",- "autogen",- "crewai",+ "vercel","google",- "google-adk","langchain",- "langgraph",+ "autogen",+ "crewai","llamaindex","mastra",- "vercel","custom-providers"]}diff --git a/docs/content/docs/providers/openai-agents.mdx b/docs/content/docs/providers/openai-agents.mdxdeleted file mode 100644index 1e92a3973..000000000--- a/docs/content/docs/providers/openai-agents.mdx+++ /dev/null@@ -1,103 +0,0 @@-----title: OpenAI Agents SDK-description: Build an agent with OpenAI Agents SDK and enable it to use 1000+ tools with Composio.-keywords: [openai agents sdk, agents sdk]------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.--<Steps>-<Step>-**Install**--<Tabs groupId="language" items={["Python", "TypeScript"]} persist>-<Tab value="Python">-```bash-pip install composio composio-openai-agents openai-agents-```-</Tab>-<Tab value="TypeScript">-```bash-npm install @composio/core @composio/openai-agents @openai/agents-```-</Tab>-</Tabs>-</Step>--<Step>-**Configure API Keys**--<Callout type="info">-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).-</Callout>--```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-OPENAI_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run**--<Tabs groupId="language" items={["Python", "TypeScript"]} persist>-<Tab value="Python">-```python-import asyncio-from composio import Composio-from composio_openai_agents import OpenAIAgentsProvider-from agents import Agent, Runner--composio = Composio(provider=OpenAIAgentsProvider())--# Create a session for your user-session = composio.create(user_id="user_123")-tools = session.tools()--agent = Agent(- name="Email Agent",- instructions="You are a helpful assistant.",- tools=tools,-)--async def main():- result = await Runner.run(- starting_agent=agent,- input="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",- )- print(result.final_output)--asyncio.run(main())-```-</Tab>-<Tab value="TypeScript">-```typescript-import { Composio } from "@composio/core";-import { OpenAIAgentsProvider } from "@composio/openai-agents";-import { Agent, run } from "@openai/agents";--const composio = new Composio({- provider: new OpenAIAgentsProvider(),-});--// Create a session for your user-const session = await composio.create("user_123");-const tools = await session.tools();--const agent = new Agent({- name: "Email Agent",- instructions: "You are a helpful assistant.",- tools,-});--const result = await run(- agent,- "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"-);--console.log(result.finalOutput);-```-</Tab>-</Tabs>-</Step>-</Steps>diff --git a/docs/content/docs/providers/openai.mdx b/docs/content/docs/providers/openai.mdxindex 626c670ad..5f5601bd6 100644--- a/docs/content/docs/providers/openai.mdx+++ b/docs/content/docs/providers/openai.mdx@@ -1,21 +1,21 @@---title: OpenAIdescription: Build an agent with OpenAI and enable it to use 1000+ tools with Composio.-keywords: [gpt, responses api, chat completions]+keywords: [gpt, responses api, chat completions, openai agents sdk, agents sdk]----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.--<Callout type="info">-Looking for the OpenAI Agents SDK? See the [OpenAI Agents SDK](/docs/providers/openai-agents) provider page.-</Callout>+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.<IntegrationTabs tabs={[{ value: "responses", label: "Responses API" },{ value: "chat", label: "Chat Completions" },+ { value: "agents", label: "Agents SDK" },]}><IntegrationContent value="responses">++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.+<Steps><Step>**Install**@@ -38,7 +38,7 @@ npm install @composio/core @composio/openai openai**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"@@ -161,6 +161,9 @@ for (const item of response.output) {</IntegrationContent><IntegrationContent value="chat">++The `OpenAIProvider` (Chat Completions) is the default provider used by the Composio SDK when no other provider is specified.+<Steps><Step>**Install**@@ -183,7 +186,7 @@ npm install @composio/core @composio/openai openai**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"@@ -296,6 +299,108 @@ console.log(response.choices[0].message.content);</Steps></IntegrationContent>+<IntegrationContent value="agents">++The OpenAI Agents SDK provider transforms Composio tools into the Agents SDK tool format with built-in execution.++<Steps>+<Step>+**Install**++<Tabs groupId="language" items={["Python", "TypeScript"]} persist>+<Tab value="Python">+```bash+pip install composio composio-openai-agents openai-agents+```+</Tab>+<Tab value="TypeScript">+```bash+npm install @composio/core @composio/openai-agents @openai/agents+```+</Tab>+</Tabs>+</Step>++<Step>+**Configure API Keys**++<Callout type="info">+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).+</Callout>++```txt title=".env"+COMPOSIO_API_KEY=xxxxxxxxx+OPENAI_API_KEY=xxxxxxxxx+```+</Step>++<Step>+**Create session and run**++<Tabs groupId="language" items={["Python", "TypeScript"]} persist>+<Tab value="Python">+```python+import asyncio+from composio import Composio+from composio_openai_agents import OpenAIAgentsProvider+from agents import Agent, Runner++composio = Composio(provider=OpenAIAgentsProvider())++# Create a session for your user+session = composio.create(user_id="user_123")+tools = session.tools()++agent = Agent(+ name="Email Agent",+ instructions="You are a helpful assistant.",+ tools=tools,+)++async def main():+ result = await Runner.run(+ starting_agent=agent,+ input="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",+ )+ print(result.final_output)++asyncio.run(main())+```+</Tab>+<Tab value="TypeScript">+```typescript+import { Composio } from "@composio/core";+import { OpenAIAgentsProvider } from "@composio/openai-agents";+import { Agent, run } from "@openai/agents";++const composio = new Composio({+ provider: new OpenAIAgentsProvider(),+});++// Create a session for your user+const session = await composio.create("user_123");+const tools = await session.tools();++const agent = new Agent({+ name: "Email Agent",+ instructions: "You are a helpful assistant.",+ tools,+});++const result = await run(+ agent,+ "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"+);++console.log(result.finalOutput);+```+</Tab>+</Tabs>+</Step>+</Steps>++</IntegrationContent>+</IntegrationTabs>## Multi-turn chatdiff --git a/docs/content/docs/providers/vercel.mdx b/docs/content/docs/providers/vercel.mdxindex dee1d6bbb..72bca1d97 100644--- a/docs/content/docs/providers/vercel.mdx+++ b/docs/content/docs/providers/vercel.mdx@@ -19,7 +19,7 @@ npm install @composio/core @composio/vercel ai @ai-sdk/anthropic**Configure API Keys**<Callout type="info">-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).+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).</Callout>```txt title=".env"diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdxindex ced057fa4..467064d13 100644--- a/docs/content/docs/quickstart.mdx+++ b/docs/content/docs/quickstart.mdx@@ -6,10 +6,6 @@ keywords: [tutorial, setup, first agent]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.-<Callout type="info">-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.-</Callout>-<QuickstartFlow><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<IntegrationTabs><IntegrationContent value="native">-<PromptBanner>-**Add Composio tools to an OpenAI Agents app (Native Tools)**--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.--**Key concepts**--- **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.-- **Provider**: Translates Composio tools into the framework's tool format. For OpenAI Agents, use `OpenAIAgentsProvider`.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Initialize with `OpenAIAgentsProvider` as the provider-- Create a session with a user ID before getting tools-- Use `session.tools()` to get tools — this returns framework-ready tools-- Store API keys in .env, load with dotenv--NEVER:-- Hardcode API keys in source code-- Call tools directly without a session-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns--**Deprecated (DO NOT use)**--Python:-```-# WRONG — old direct execution pattern-tools = composio.tools.get(user_id, { toolkits: ['github'] })-result = composio.tools.execute('GITHUB_STAR_REPO', {...})--# WRONG — old package name-from composio_core import Composio-```--TypeScript:-```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});-```--**Verify before responding**--1. Is `OpenAIAgentsProvider` passed to `Composio()`?-2. Is a session created with `composio.create(user_id)`?-3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?-4. Are API keys in .env, not hardcoded?-5. Are imports from `composio` (Python) or `@composio/core` (TS)?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -213,65 +155,6 @@ readline.close();</IntegrationContent><IntegrationContent value="mcp">-<PromptBanner>-**Add Composio tools to an OpenAI Agents app (MCP)**--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.--**Key concepts**--- **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.-- **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.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session-- In Python, set `require_approval` to `"never"` in the tool_config-- Create a session with a user ID before accessing `session.mcp`-- Store API keys in .env, load with dotenv--NEVER:-- Hardcode MCP URLs or headers — they come from the session-- Pass a provider to `Composio()` when using MCP mode (no provider needed)-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns--**Deprecated (DO NOT use)**--Python:-```-# WRONG — old direct execution pattern-tools = composio.tools.get(user_id, { toolkits: ['github'] })-result = composio.tools.execute('GITHUB_STAR_REPO', {...})--# WRONG — using a provider with MCP (not needed)-composio = Composio(provider=OpenAIAgentsProvider())--# WRONG — old package name-from composio_core import Composio-```--TypeScript:-```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });--// WRONG — using a provider with MCP (not needed)-const composio = new Composio({ provider: new OpenAIAgentsProvider() });-```--**Verify before responding**--1. Is `Composio()` initialized WITHOUT a provider?-2. Is a session created with `composio.create(user_id)`?-3. Are `session.mcp.url` and `session.mcp.headers` used for the MCP connection?-4. In Python, is `require_approval` set to `"never"`?-5. Are API keys in .env, not hardcoded?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -432,67 +315,6 @@ readline.close();<IntegrationTabs><IntegrationContent value="native">-<PromptBanner>-**Add Composio tools to a Claude Agent SDK app (Native Tools)**--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.--**Key concepts**--- **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.-- **Provider**: Translates Composio tools into the framework's tool format. For Claude Agent SDK, use `ClaudeAgentSDKProvider`.-- **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.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Initialize with `ClaudeAgentSDKProvider` as the provider-- Create a session with a user ID before getting tools-- Wrap tools in an SDK MCP server before passing to ClaudeAgentOptions-- Use `async/await` — Claude Agent SDK is fully async-- Store API keys in .env, load with dotenv--NEVER:-- Pass tools directly to ClaudeAgentOptions (must wrap in MCP server first)-- Hardcode API keys in source code-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns--**Deprecated (DO NOT use)**--Python:-```-# WRONG — old direct execution pattern-tools = composio.tools.get(user_id, { toolkits: ['github'] })-result = composio.tools.execute('GITHUB_STAR_REPO', {...})--# WRONG — passing tools directly without MCP server wrapper-options = ClaudeAgentOptions(tools=tools)--# WRONG — old package name-from composio_core import Composio-```--TypeScript:-```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });--// WRONG — passing tools directly without MCP server wrapper-const options = new ClaudeAgentOptions({ tools });-```--**Verify before responding**--1. Is `ClaudeAgentSDKProvider` passed to `Composio()`?-2. Is a session created with `composio.create(user_id)`?-3. Are tools wrapped in `create_sdk_mcp_server` / `createSdkMcpServer` before passing to options?-4. Is the code using `async/await`?-5. Are API keys in .env, not hardcoded?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -659,67 +481,6 @@ readline.close();</IntegrationContent><IntegrationContent value="mcp">-<PromptBanner>-**Add Composio tools to a Claude Agent SDK app (MCP)**--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.--**Key concepts**--- **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.-- **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.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session-- Set MCP server type to `"http"` in the mcp_servers config-- In Python, set `permission_mode` to `"bypassPermissions"` in the mcp_servers config-- Use `async/await` — Claude Agent SDK is fully async-- Store API keys in .env, load with dotenv--NEVER:-- Hardcode MCP URLs or headers — they come from the session-- Pass a provider to `Composio()` when using MCP mode (no provider needed)-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns--**Deprecated (DO NOT use)**--Python:-```-# WRONG — old direct execution pattern-tools = composio.tools.get(user_id, { toolkits: ['github'] })-result = composio.tools.execute('GITHUB_STAR_REPO', {...})--# WRONG — using a provider with MCP (not needed)-composio = Composio(provider=ClaudeAgentSDKProvider())--# WRONG — old package name-from composio_core import Composio-```--TypeScript:-```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });--// WRONG — using a provider with MCP (not needed)-const composio = new Composio({ provider: new ClaudeAgentSDKProvider() });-```--**Verify before responding**--1. Is `Composio()` initialized WITHOUT a provider?-2. Is a session created with `composio.create(user_id)`?-3. Are `session.mcp.url` and `session.mcp.headers` used in the `mcp_servers` config?-4. Is the MCP server type set to `"http"`?-5. Is the code using `async/await`?-6. Are API keys in .env, not hardcoded?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -903,56 +664,6 @@ readline.close();<IntegrationTabs><IntegrationContent value="native">-<PromptBanner>-**Add Composio tools to a Vercel AI SDK app (Native Tools)**--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.--**Key concepts**--- **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.-- **Provider**: Translates Composio tools into the framework's tool format. For Vercel AI, use `VercelProvider`.-- **streamText vs generateText**: Use `streamText` for streaming responses, `generateText` for single responses. Both accept Composio tools via the `tools` parameter.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Initialize with `VercelProvider` as the provider-- Create a session with a user ID before getting tools-- Use `session.tools()` to get tools — this returns Vercel AI-compatible tools-- Use `streamText` or `generateText` from the `ai` package-- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)-- Store API keys in .env, load with dotenv--NEVER:-- Hardcode API keys in source code-- Call tools directly without a session-- Import from `composio-core` (the package is `@composio/core`)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns-- Forget `maxSteps` — without it, the model won't execute tool calls--**Deprecated (DO NOT use)**--```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});--// WRONG — missing maxSteps (model won't execute tool calls)-const result = await generateText({ model, tools, prompt });-```--**Verify before responding**--1. Is `VercelProvider` passed to `Composio()`?-2. Is a session created with `composio.create(userId)`?-3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?-4. Is `maxSteps` set in `streamText` / `generateText`?-5. Are API keys in .env, not hardcoded?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -1047,60 +758,6 @@ readline.close();</IntegrationContent><IntegrationContent value="mcp">-<PromptBanner>-**Add Composio tools to a Vercel AI SDK app (MCP)**--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.--**Key concepts**--- **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.-- **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.-- **Client lifecycle**: Always close the MCP client with `await client.close()` when done.-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.--**Rules**--ALWAYS:-- Use `mcp.url` and `mcp.headers` from the session object returned by `composio.create(userId)`-- Set transport type to `"http"` in createMCPClient-- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)-- Close the MCP client when done: `await client.close()`-- Store API keys in .env, load with dotenv--NEVER:-- Hardcode MCP URLs or headers — they come from the session-- Pass a provider to `Composio()` when using MCP mode (no provider needed)-- Import from `composio-core` (the package is `@composio/core`)-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns-- Forget `maxSteps` — without it, the model won't execute tool calls-- Forget `await client.close()` — this leaks the MCP connection--**Deprecated (DO NOT use)**--```-// WRONG — old direct execution pattern-const tools = composio.tools.get(userId, { toolkits: ['github'] });-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});--// WRONG — using a provider with MCP (not needed)-const composio = new Composio({ provider: new VercelProvider() });--// WRONG — missing maxSteps (model won't execute tool calls)-const result = await generateText({ model, tools, prompt });-```--**Verify before responding**--1. Is `Composio()` initialized WITHOUT a provider?-2. Are `mcp.url` and `mcp.headers` taken from the session returned by `composio.create(userId)`?-3. Is transport type `"http"` in `createMCPClient`?-4. Is `maxSteps` set in `streamText` / `generateText`?-5. Is `client.close()` called when done?-6. Are API keys in .env, not hardcoded?--</PromptBanner>-<Steps><Step><StepTitle>Install</StepTitle>@@ -1210,13 +867,7 @@ readline.close();</QuickstartFlow>-<Callout type="info">-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).-</Callout>--<Callout>-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).-</Callout>+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.## Next stepsdiff --git a/docs/content/docs/setting-up-triggers/creating-triggers.mdx b/docs/content/docs/setting-up-triggers/creating-triggers.mdxindex 875e4accc..c5f2608b6 100644--- a/docs/content/docs/setting-up-triggers/creating-triggers.mdx+++ b/docs/content/docs/setting-up-triggers/creating-triggers.mdx@@ -235,7 +235,7 @@ Trigger instances default to the `'latest'` toolkit version. If your code parses## Using the dashboard-1. Navigate to [Auth Configs](https://platform.composio.dev?next_page=%2Fauth-configs) and select the auth config for the relevant toolkit+1. Navigate to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select the auth config for the relevant toolkit2. Navigate to **Active Triggers** and click **Create Trigger**3. Select the connected account for which you want to create a trigger4. Choose a trigger type and fill in the required configurationdiff --git a/docs/content/docs/setting-up-triggers/managing-triggers.mdx b/docs/content/docs/setting-up-triggers/managing-triggers.mdxindex 06057bca7..9bdfe646a 100644--- a/docs/content/docs/setting-up-triggers/managing-triggers.mdx+++ b/docs/content/docs/setting-up-triggers/managing-triggers.mdx@@ -87,7 +87,7 @@ await composio.triggers.enable('ti_abcd123');You can also toggle triggers from the dashboard:-1. Go to [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) and select your auth config+1. Go to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select your auth config2. Navigate to **Active Triggers**3. Toggle the trigger on or offdiff --git a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdxindex 6dc91e3e5..0f9f66b9d 100644--- a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx+++ b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx@@ -14,7 +14,7 @@ Webhooks are the recommended way to receive trigger events in production. To sta| `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). || `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`. |-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):+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):```bashcurl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \diff --git a/docs/content/docs/single-toolkit-mcp.mdx b/docs/content/docs/single-toolkit-mcp.mdxindex df9a78813..4e79620a4 100644--- a/docs/content/docs/single-toolkit-mcp.mdx+++ b/docs/content/docs/single-toolkit-mcp.mdx@@ -93,7 +93,7 @@ console.log(`Server created: ${server.id}`);</Tabs><Callout type="info">- You can also create and manage MCP configs from the [Composio dashboard](https://platform.composio.dev?next_page=/mcp-configs).+ You can also create and manage MCP configs from the [Composio dashboard](https://dashboard.composio.dev/~/org/connect/clients).</Callout></Step>diff --git a/docs/content/docs/tools-direct/authenticating-tools.mdx b/docs/content/docs/tools-direct/authenticating-tools.mdxindex 4886ae752..d2c92e70b 100644--- a/docs/content/docs/tools-direct/authenticating-tools.mdx+++ b/docs/content/docs/tools-direct/authenticating-tools.mdx@@ -25,7 +25,7 @@ An **Auth Config** is a blueprint that defines how authentication works for a to<Step><StepTitle>Selecting a toolkit</StepTitle>-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**).+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**).</Step><Step>diff --git a/docs/content/docs/tools-direct/executing-tools.mdx b/docs/content/docs/tools-direct/executing-tools.mdxindex 7b8388064..59714f4da 100644--- a/docs/content/docs/tools-direct/executing-tools.mdx+++ b/docs/content/docs/tools-direct/executing-tools.mdx@@ -190,7 +190,7 @@ If you just want to call a tool without using any framework or LLM provider, you<Callout type="info">**Finding tool parameters and types:**-**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+**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**CLI**: For Python and TypeScript projects, run `composio generate` to generate types. [Learn more →](/docs/cli#generate-type-definitions)</Callout>diff --git a/docs/content/docs/troubleshooting/index.mdx b/docs/content/docs/troubleshooting/index.mdxindex b6e3b1e40..a6ca698bd 100644--- a/docs/content/docs/troubleshooting/index.mdx+++ b/docs/content/docs/troubleshooting/index.mdx@@ -12,7 +12,7 @@ This section is designed to help you quickly identify and resolve common issues<Accordions><Accordion title="How do I find the log ID for a failed tool execution?">-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.+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.See [Troubleshooting tools](/docs/troubleshooting/tools#reporting-tool-issues) for more details.</Accordion>diff --git a/docs/content/docs/troubleshooting/triggers.mdx b/docs/content/docs/troubleshooting/triggers.mdxindex 28f60003d..b77e5fc44 100644--- a/docs/content/docs/troubleshooting/triggers.mdx+++ b/docs/content/docs/troubleshooting/triggers.mdx@@ -12,7 +12,7 @@ Check the error message — the connected account might not have sufficient perm- **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.- **Webhook URL**: Ensure your URL is publicly accessible and returns a `2xx` status code.- **Trigger status**: Verify the trigger is enabled, not disabled.-- **Logs**: Check the [trigger logs](https://platform.composio.dev?next_page=/logs/triggers) in the dashboard for delivery attempts and errors.+- **Logs**: Check the [trigger logs](https://dashboard.composio.dev/~/project/logs?tab=triggers) in the dashboard for delivery attempts and errors.## Type errors with trigger payloadsdiff --git a/docs/content/docs/white-labeling-authentication.mdx b/docs/content/docs/white-labeling-authentication.mdxindex 9c8355a69..cc8edc8ec 100644--- a/docs/content/docs/white-labeling-authentication.mdx+++ b/docs/content/docs/white-labeling-authentication.mdx@@ -21,7 +21,7 @@ The Connect Link is the hosted page your users see when connecting their accountTo replace it with your own branding:-1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)+1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)2. Upload your **Logo** and set your **App Title**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.diff --git a/docs/content/toolkits/premium-tools.mdx b/docs/content/toolkits/premium-tools.mdxindex 776ae2652..4979f407a 100644--- a/docs/content/toolkits/premium-tools.mdx+++ b/docs/content/toolkits/premium-tools.mdx@@ -1,36 +1,24 @@---title: Premium Tools-description: Learn about premium tools, pricing, and limits in Composio+description: Pricing and limits for premium tools in Composio----This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.+Some tool calls cost more to run — search APIs, code sandboxes, ML inference. We call those premium tools and price them separately.-## What are premium tools?+## What counts as a premium tool?-Premium tools are essential tool calls that cost us more to run, normally paying for more premium services or longer running tasks.+<Cards>+ <Card icon={<Search />} title="Search APIs" href="/toolkits/composio_search" description="Composio Search, Perplexity, Exa, SerpAPI" />+ <Card icon={<Code />} title="Code execution" href="/toolkits/codeinterpreter" description="Sandboxed runtimes like E2B" />+ <Card icon={<Database />} title="Web scraping & data extraction" description="Crawlers and structured extraction" />+ <Card icon={<Zap />} title="AI/ML inference" description="Hosted model calls and embeddings" />+ <Card icon={<Wrench />} title="Document processing & OCR" description="PDF, image, and document parsing" />+ <Card icon={<Rocket />} title="Compute-intensive operations" description="Long-running or heavy transforms" />+</Cards>-Think something like `E2B` or `Perplexity`, these are not really comparable to a `GMAIL_SEND_EMAIL` call.+## Pricing-These types of tools are separated out so we can price both of them competitively.--Premium tools include:--- Search APIs (Google, Bing, Perplexity, etc.)- - [Composio Search](/toolkits/composio_search)- - [Perplexity](/toolkits/perplexityai)- - [Exa](/toolkits/exa)- - [SerpAPI](/toolkits/serpapi)-- Code execution environments (E2B)- - [Code Interpreter (E2B)](/toolkits/codeinterpreter)-- Web scraping & data extraction-- AI/ML model inference-- Document processing & OCR-- Advanced data transformations-- Compute-intensive operations--## How are premium tools priced?--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.+Premium tool calls are roughly 3x the cost of a standard tool call. Full pricing is on the [pricing page](https://composio.dev/pricing).| Plan | Included Standard Tool Calls | Included Premium Tool Calls | Usage Based Standard Tool Calls | Usage Based Premium Tool Calls ||------|------------------------------|-----------------------------|---------------------------------|--------------------------------|@@ -39,22 +27,12 @@ As a rough guide, they are priced at 3x the cost of a standard tool call — the| Serious Business | 2M | 50k | $0.249/1k | $0.747/1k || Enterprise | Flexible | Flexible | Flexible | Flexible |-This is a quick call out — full pricing details are on the [pricing page](https://composio.dev/pricing).--## What limits do premium tools have?+## Rate limits-Premium tools are also subject to lower rate limits than standard tool calls.--If you need more than the default limits, please [contact us](mailto:[email protected]) and we can find a workable solution.+Premium tools have lower rate limits than standard tool calls. If you need more, [contact us](mailto:[email protected]).| Spending Tier | Standard Tool Calls Rate Limit | Premium Tool Calls Rate Limit ||---------------|--------------------------------|-------------------------------|| Free | 100/min | 1,000/hour || Paid | 5,000/min | 10,000/hour || Enterprise | Custom | Custom |--## Feedback on premium tools--These pricing changes are not rolling out immediately, and we are very open to feedback on the pricing and the limits.--There is a lot of room for improvement and iteration here, please reach out if you have suggestions [here](mailto:[email protected]).diff --git a/docs/lib/create-docs-page.tsx b/docs/lib/create-docs-page.tsxindex f91f33453..e7eb874c1 100644--- a/docs/lib/create-docs-page.tsx+++ b/docs/lib/create-docs-page.tsx@@ -8,12 +8,13 @@ import { getMDXComponents } from '@/mdx-components';import type { Metadata } from 'next';import { createRelativeLink } from 'fumadocs-ui/mdx';import { PageActions } from '@/components/page-actions';+import { EditOnGitHub } from '@/components/edit-on-github';import { getOgImageUrl } from '@/lib/source';// eslint-disable-next-line @typescript-eslint/no-explicit-anytype Source = any;-export function createDocsPage(source: Source) {+export function createDocsPage(source: Source, contentDir: string = 'content/docs') {return async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {const { slug } = await params;const page = source.getPage(slug);@@ -31,6 +32,7 @@ export function createDocsPage(source: Source) {a: createRelativeLink(source, page),})}/>+ <EditOnGitHub path={`docs/${contentDir}/${page.path}`} /></DocsBody></DocsPage>);diff --git a/docs/lib/layout.shared.tsx b/docs/lib/layout.shared.tsxindex 19a549050..657f647f6 100644--- a/docs/lib/layout.shared.tsx+++ b/docs/lib/layout.shared.tsx@@ -36,6 +36,7 @@ export function baseOptions(): BaseLayoutProps {title: <ComposioLogo />,transparentMode: 'top',},+ themeSwitch: { enabled: false },searchToggle: {components: {lg: <SearchAndAskAI />,@@ -84,7 +85,7 @@ export function baseOptions(): BaseLayoutProps {Playground</span>),- url: 'https://platform.composio.dev/auth?next_page=%2Ftool-router&utm_source=docs&utm_medium=navbar&utm_campaign=tool_router',+ url: 'https://dashboard.composio.dev/~/project/playground?utm_source=docs&utm_medium=navbar&utm_campaign=playground',external: true,secondary: true,},diff --git a/docs/lib/source.ts b/docs/lib/source.tsindex 26ac2d3a3..08ce32ea1 100644--- a/docs/lib/source.ts+++ b/docs/lib/source.ts@@ -213,8 +213,6 @@ export function mdxToCleanMarkdown(content: string): string {(_, name, content) => `### ${name}\n\n${content.trim()}`);- result = result.replace(/<PromptBanner[\s\S]*?<\/PromptBanner>/g, '');-result = result.replace(/<AIToolsBanner\s*\/>/g,'### For AI tools\n\n' +diff --git a/docs/mdx-components.tsx b/docs/mdx-components.tsxindex db0978fd3..7fad2012b 100644--- a/docs/mdx-components.tsx+++ b/docs/mdx-components.tsx@@ -3,14 +3,14 @@ import type { MDXComponents } from 'mdx/types';import type { ComponentProps } from 'react';import { Accordion as BaseAccordion, Accordions } from 'fumadocs-ui/components/accordion';import { Tabs, Tab, TabsList, TabsTrigger, TabsContent } from 'fumadocs-ui/components/tabs';-import { Callout } from 'fumadocs-ui/components/callout';+import { Callout } from '@/components/callout';import { Step, Steps } from 'fumadocs-ui/components/steps';import { Card, Cards } from 'fumadocs-ui/components/card';import { ImageZoom } from 'fumadocs-ui/components/image-zoom';import { Heading } from '@/components/heading';import { YouTube } from '@/components/youtube';import { ProviderCard, ProviderGrid } from '@/components/provider-card';-import { FrameworkSelector, QuickstartFlow, FrameworkOption, PromptBanner } from '@/components/quickstart';+import { FrameworkSelector, QuickstartFlow, FrameworkOption } from '@/components/quickstart';import { IntegrationTabs, IntegrationContent } from '@/components/quickstart/integration-tabs';import { ToolTypeFlow, ToolTypeOption } from '@/components/tool-type-selector';import { ConnectFlow, ConnectClientOption } from '@/components/connect-flow';@@ -23,6 +23,7 @@ import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';import { ManagedAuthList } from '@/components/toolkits/managed-auth-list';import { Mermaid } from '@/components/mermaid';import { AIToolsBanner } from '@/components/ai-tools-banner';+import { DocsHero } from '@/components/docs-hero';import { Glossary, GlossaryTerm } from '@/components/glossary';import { ApiBaseUrl } from '@/components/api-base-url';import { ApiEndpointsTable } from '@/components/api-endpoints-table';@@ -30,6 +31,7 @@ import {ShieldCheck,Route as RouteIcon,Key,+ Search,Wrench,Database,Zap,@@ -83,7 +85,6 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {FrameworkOption,IntegrationTabs,IntegrationContent,- PromptBanner,ToolTypeFlow,ToolTypeOption,ConnectFlow,@@ -98,6 +99,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {ManagedAuthList,Mermaid,AIToolsBanner,+ DocsHero,StepTitle,Glossary,GlossaryTerm,@@ -107,6 +109,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {ShieldCheck,RouteIcon,Key,+ Search,Wrench,Database,Zap,diff --git a/docs/next.config.mjs b/docs/next.config.mjsindex ad347339a..7cea35ca3 100644--- a/docs/next.config.mjs+++ b/docs/next.config.mjs@@ -156,6 +156,16 @@ const config = {destination: '/docs/providers/google',permanent: true,},+ {+ source: '/providers/google-adk',+ destination: '/docs/providers/google',+ permanent: true,+ },+ {+ source: '/docs/providers/google-adk',+ destination: '/docs/providers/google',+ permanent: true,+ },{source: '/providers/langchain',destination: '/docs/providers/langchain',@@ -178,7 +188,32 @@ const config = {},{source: '/providers/openai-agents',- destination: '/docs/providers/openai-agents',+ destination: '/docs/providers/openai',+ permanent: true,+ },+ {+ source: '/providers/claude-agent-sdk',+ destination: '/docs/providers/anthropic',+ permanent: true,+ },+ {+ source: '/docs/providers/openai-agents',+ destination: '/docs/providers/openai',+ permanent: true,+ },+ {+ source: '/docs/providers/claude-agent-sdk',+ destination: '/docs/providers/anthropic',+ permanent: true,+ },+ {+ source: '/providers/langgraph',+ destination: '/docs/providers/langchain',+ permanent: true,+ },+ {+ source: '/docs/providers/langgraph',+ destination: '/docs/providers/langchain',permanent: true,},{diff --git a/docs/public/fonts/ABCDiatype-Medium.woff2 b/docs/public/fonts/ABCDiatype-Medium.woff2new file mode 100644index 000000000..3dbb9e02fBinary files /dev/null and b/docs/public/fonts/ABCDiatype-Medium.woff2 differdiff --git a/docs/public/fonts/ABCDiatype-Regular.woff2 b/docs/public/fonts/ABCDiatype-Regular.woff2new file mode 100644index 000000000..dc963475cBinary files /dev/null and b/docs/public/fonts/ABCDiatype-Regular.woff2 differdiff --git a/docs/public/fonts/ABCDiatype-RegularItalic.woff2 b/docs/public/fonts/ABCDiatype-RegularItalic.woff2new file mode 100644index 000000000..11eb88434Binary files /dev/null and b/docs/public/fonts/ABCDiatype-RegularItalic.woff2 differdiff --git a/docs/public/images/hero/managed-auth.png b/docs/public/images/hero/managed-auth.pngnew file mode 100644index 000000000..668cc6996Binary files /dev/null and b/docs/public/images/hero/managed-auth.png differdiff --git a/docs/public/images/hero/shader.jpg b/docs/public/images/hero/shader.jpgnew file mode 100644index 000000000..9df690fceBinary files /dev/null and b/docs/public/images/hero/shader.jpg differdiff --git a/docs/public/images/hero/triggers.png b/docs/public/images/hero/triggers.pngnew file mode 100644index 000000000..38e469da2Binary files /dev/null and b/docs/public/images/hero/triggers.png differdiff --git a/docs/tests/integration/redirects.test.ts b/docs/tests/integration/redirects.test.tsindex f5498dda4..58cf19e6d 100644--- a/docs/tests/integration/redirects.test.ts+++ b/docs/tests/integration/redirects.test.ts@@ -14,6 +14,13 @@ const REDIRECTS = [{ from: "/api-reference", to: "/reference" },{ from: "/providers/openai", to: "/docs/providers/openai" },{ from: "/providers/anthropic", to: "/docs/providers/anthropic" },+ { from: "/providers/openai-agents", to: "/docs/providers/openai" },+ { from: "/docs/providers/openai-agents", to: "/docs/providers/openai" },+ { from: "/docs/providers/claude-agent-sdk", to: "/docs/providers/anthropic" },+ { from: "/providers/google-adk", to: "/docs/providers/google" },+ { from: "/docs/providers/google-adk", to: "/docs/providers/google" },+ { from: "/providers/langgraph", to: "/docs/providers/langchain" },+ { from: "/docs/providers/langgraph", to: "/docs/providers/langchain" },{ from: "/tools", to: "/toolkits" },{ from: "/docs/fetching-tools", to: "/docs/tools-direct/fetching-tools" },{ from: "/docs/custom-tools", to: "/docs/tools-direct/custom-tools" },diff --git a/docs/tests/static/quickstart-prompts.test.ts b/docs/tests/static/quickstart-prompts.test.tsdeleted file mode 100644index 8d755cab8..000000000--- a/docs/tests/static/quickstart-prompts.test.ts+++ /dev/null@@ -1,115 +0,0 @@-/**- * Quickstart PromptBanner static validation.- *- * Validates prompt content quality directly from the MDX source:- * - All 6 integration variants have prompts- * - Each prompt has the required sections (concepts, rules, deprecated, verify)- * - Prompts contain code examples (deprecated patterns)- * - No markdown headings leak into TOC- * - PromptBanner is stripped from LLM .md output- */-import { describe, test, expect } from "bun:test";-import { readFile } from "fs/promises";-import { join } from "path";-import { mdxToCleanMarkdown } from "../../lib/source";--const QUICKSTART_PATH = join(- import.meta.dir,- "../../content/docs/quickstart.mdx"-);--let rawContent: string;-let blocks: string[];--describe("Quickstart PromptBanner", () => {- test("quickstart.mdx has 6 PromptBanner blocks (one per integration variant)", async () => {- rawContent = await readFile(QUICKSTART_PATH, "utf-8");- blocks =- rawContent.match(/<PromptBanner>([\s\S]*?)<\/PromptBanner>/g) ?? [];- expect(blocks.length).toBe(6);- });-- test("each prompt has required sections", () => {- const required = [- "**Key concepts**",- "**Rules**",- "ALWAYS:",- "NEVER:",- "**Deprecated",- "**Verify before responding**",- ];- const errors: string[] = [];-- for (let i = 0; i < blocks.length; i++) {- for (const section of required) {- if (!blocks[i].includes(section)) {- errors.push(`Prompt #${i + 1}: missing "${section}"`);- }- }- }-- expect(errors).toEqual([]);- });-- test("each prompt has code in deprecated section", () => {- const errors: string[] = [];-- for (let i = 0; i < blocks.length; i++) {- const afterDeprecated = blocks[i].split("**Deprecated")[1] ?? "";- const hasCodeFence = afterDeprecated.includes("```");- if (!hasCodeFence) {- errors.push(`Prompt #${i + 1}: deprecated section has no code examples`);- }- }-- expect(errors).toEqual([]);- });-- test("each prompt mentions session-based pattern", () => {- const errors: string[] = [];-- for (let i = 0; i < blocks.length; i++) {- if (!blocks[i].includes("session") && !blocks[i].includes("Session")) {- errors.push(`Prompt #${i + 1}: doesn't mention sessions`);- }- }-- expect(errors).toEqual([]);- });-- test("each prompt warns against deprecated composio.tools.get()", () => {- const errors: string[] = [];-- for (let i = 0; i < blocks.length; i++) {- if (!blocks[i].includes("composio.tools.get()")) {- errors.push(`Prompt #${i + 1}: missing composio.tools.get() deprecation warning`);- }- }-- expect(errors).toEqual([]);- });-- test("no markdown headings inside prompts (would pollute TOC)", () => {- const errors: string[] = [];-- for (let i = 0; i < blocks.length; i++) {- const withoutCode = blocks[i].replace(/```[\s\S]*?```/g, "");- const heading = withoutCode.match(/^#{1,6}\s+/m);- if (heading) {- errors.push(- `Prompt #${i + 1}: contains heading "${heading[0].trim()}" — use **bold** instead`- );- }- }-- expect(errors).toEqual([]);- });-- test("mdxToCleanMarkdown strips all PromptBanner blocks from .md output", () => {- const cleaned = mdxToCleanMarkdown(rawContent);- expect(cleaned).not.toContain("<PromptBanner>");- expect(cleaned).not.toContain("</PromptBanner>");- expect(cleaned).not.toContain("ALWAYS:");- expect(cleaned).not.toContain("Deprecated (DO NOT use)");- });-});