@devries-cameron20 / composio Mirror · read-only / commits / 7a85839c6
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 15:45 UTC

refactor: reorganize reference docs into API and SDK sections

- Move TypeScript SDK docs to /reference/sdk-reference/typescript/ - Add API Reference section for OpenAPI-generated REST API docs - Configure OpenAPI source with baseDir for proper routing - Update generator script output path 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 6, 2026 at 15:08 UTC 7a85839c6f122d41d4180b9ebc7af7adc5bdf0aa
14 files changed +26 -13
fumadocs/content/reference/api-reference/meta.json new
+4
@@ -0,0 +1,4 @@
1 +{
2 + "title": "API Reference",
3 + "pages": ["..."]
4 +}
fumadocs/content/reference/index.mdx
+2 -2
@@ -1,6 +1,6 @@
1 ---
2 -title: API Reference
3 -description: Complete API and SDK reference documentation for Composio
2 +title: Overview
3 +description: Authentication and getting started with Composio APIs
4 ---
5
6 ## Authentication
fumadocs/content/reference/meta.json
+2 -1
@@ -2,6 +2,7 @@
2 "title": "Reference",
3 "pages": [
4 "index",
5 - "typescript"
5 + "api-reference",
6 + "sdk-reference"
7 ]
8 }
fumadocs/content/reference/sdk-reference/meta.json new
+4
@@ -0,0 +1,4 @@
1 +{
2 + "title": "SDK Reference",
3 + "pages": ["typescript"]
4 +}
fumadocs/content/reference/sdk-reference/typescript/auth-configs.mdx renamed
fumadocs/content/reference/sdk-reference/typescript/composio.mdx renamed
fumadocs/content/reference/sdk-reference/typescript/connected-accounts.mdx renamed
fumadocs/content/reference/sdk-reference/typescript/index.mdx renamed
+6 -6
@@ -36,12 +36,12 @@ bun add @composio/core
36
37 | Class | Description |
38 |-------|-------------|
39 -| [`Composio`](/reference/typescript/composio) | This is the core class for Composio. |
40 -| [`AuthConfigs`](/reference/typescript/auth-configs) | AuthConfigs class |
41 -| [`ConnectedAccounts`](/reference/typescript/connected-accounts) | ConnectedAccounts class |
42 -| [`Toolkits`](/reference/typescript/toolkits) | Toolkits class |
43 -| [`Tools`](/reference/typescript/tools) | This class is used to manage tools in the Composio SDK. |
44 -| [`Triggers`](/reference/typescript/triggers) | Trigger (Instance) class |
39 +| [`Composio`](/reference/sdk-reference/typescript/composio) | This is the core class for Composio. |
40 +| [`AuthConfigs`](/reference/sdk-reference/typescript/auth-configs) | AuthConfigs class |
41 +| [`ConnectedAccounts`](/reference/sdk-reference/typescript/connected-accounts) | ConnectedAccounts class |
42 +| [`Toolkits`](/reference/sdk-reference/typescript/toolkits) | Toolkits class |
43 +| [`Tools`](/reference/sdk-reference/typescript/tools) | This class is used to manage tools in the Composio SDK. |
44 +| [`Triggers`](/reference/sdk-reference/typescript/triggers) | Trigger (Instance) class |
45
46 ## Quick Start
47
fumadocs/content/reference/sdk-reference/typescript/meta.json renamed
+1 -1
@@ -1,5 +1,5 @@
1 {
2 - "title": "TypeScript",
2 + "title": "TypeScript SDK",
3 "pages": [
4 "composio",
5 "auth-configs",
fumadocs/content/reference/sdk-reference/typescript/toolkits.mdx renamed
fumadocs/content/reference/sdk-reference/typescript/tools.mdx renamed
fumadocs/content/reference/sdk-reference/typescript/triggers.mdx renamed
fumadocs/lib/source.ts
+1
@@ -20,6 +20,7 @@ export const toolRouterSource = loader({
20 // Combined reference source with MDX pages and OpenAPI-generated pages
21 const openapiPages = await openapiSource(openapi, {
22 groupBy: 'tag',
23 + baseDir: 'api-reference',
24 });
25
26 export const referenceSource = loader({
ts/packages/core/scripts/generate-docs.ts
+6 -3
@@ -16,7 +16,10 @@ import { fileURLToPath } from 'url';
16 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
17 const PACKAGE_DIR = join(SCRIPT_DIR, '..');
18 const MODELS_DIR = join(PACKAGE_DIR, 'src/models');
19 -const OUTPUT_DIR = join(PACKAGE_DIR, '../../../fumadocs/content/reference/typescript');
19 +const OUTPUT_DIR = join(
20 + PACKAGE_DIR,
21 + '../../../fumadocs/content/reference/sdk-reference/typescript'
22 +);
23 const TEMP_JSON = join(PACKAGE_DIR, '.typedoc-output.json');
24
25 // Internal classes that should NOT be documented (accessed via other APIs)
@@ -787,7 +790,7 @@ async function main() {
790 const classesTable = documented
791 .map(
792 ({ name, description }) =>
790 - `| [\`${name}\`](/reference/typescript/${toKebabCase(name)}) | ${escapeForMdx(description)} |`
793 + `| [\`${name}\`](/reference/sdk-reference/typescript/${toKebabCase(name)}) | ${escapeForMdx(description)} |`
794 )
795 .join('\n');
796
@@ -857,7 +860,7 @@ const result = await composio.tools.execute('GITHUB_GET_REPOS', {
860
861 // Generate meta.json for sidebar
862 const meta = {
860 - title: 'TypeScript',
863 + title: 'TypeScript SDK',
864 pages: documented.map(({ name }) => toKebabCase(name)),
865 };
866 await writeFile(join(OUTPUT_DIR, 'meta.json'), JSON.stringify(meta, null, 2));