@devries-cameron20 / composio-1 / commits / 4248a1b93
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.

revert: remove Twoslash annotations from docs content

Revert all content changes from the previous Twoslash implementation to start fresh with a cleaner approach. The Twoslash infrastructure remains in place (source.config.ts with explicitTrigger: true), but content files are restored to their original state without annotations. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 12, 2026 at 15:06 UTC 4248a1b93f55469915b64066b778122d118d61c2
8 files changed +45 -166
fumadocs/content/docs/authenticating-tools.mdx
+10 -21
@@ -129,10 +129,10 @@ print(f"Visit: {redirect_url} to authenticate your account")
129 ```
130 </Tab>
131 <Tab value="TypeScript">
132 -```typescript twoslash
132 +```typescript
133 import { Composio } from '@composio/core';
134
135 -const composio = new Composio({ apiKey: "your_api_key" });
135 +const composio = new Composio({apiKey: "your_api_key"});
136
137 // Use the "AUTH CONFIG ID" from your dashboard
138 const authConfigId = 'your_auth_config_id';
@@ -202,10 +202,10 @@ print(f"Connection established: {connected_account.id}")
202 ```
203 </Tab>
204 <Tab value="TypeScript">
205 -```typescript twoslash
205 +```typescript
206 import { Composio } from '@composio/core';
207
208 -const composio = new Composio({ apiKey: "YOUR_COMPOSIO_API_KEY" });
208 +const composio = new Composio({apiKey: "YOUR_COMPOSIO_API_KEY"});
209
210 // Use the "AUTH CONFIG ID" from your dashboard
211 const authConfigId = 'your_auth_config_id';
@@ -249,12 +249,8 @@ connection_request = composio.connected_accounts.initiate(
249 ```
250 </Tab>
251 <Tab value="TypeScript">
252 -```typescript twoslash
253 -import { Composio, AuthScheme } from '@composio/core';
254 -const composio = new Composio({ apiKey: "your_api_key" });
255 -const userId = 'user_123';
256 -const authConfigId = 'your_auth_config_id';
257 -// ---cut---
252 +```typescript
253 +import { AuthScheme } from '@composio/core';
254 // For Zendesk - include subdomain
255 const connRequest = await composio.connectedAccounts.initiate(userId, authConfigId, {
256 config: AuthScheme.OAuth2({
@@ -300,7 +296,7 @@ print(f"Connection established: {connection_request.id}")
296 ```
297 </Tab>
298 <Tab value="TypeScript">
303 -```typescript twoslash
299 +```typescript
300 import { Composio, AuthScheme } from '@composio/core';
301
302 const composio = new Composio({ apiKey: 'your_api_key' });
@@ -350,7 +346,7 @@ print(f"Required fields: {auth_config.expected_input_fields}")
346 ```
347 </Tab>
348 <Tab value="TypeScript">
353 -```typescript twoslash
349 +```typescript
350 import { Composio } from '@composio/core';
351
352 const composio = new Composio({ apiKey: 'your_api_key' });
@@ -420,11 +416,7 @@ print(connected_account.id)
416 ```
417 </Tab>
418 <Tab value="TypeScript">
423 -```typescript twoslash
424 -import { Composio } from '@composio/core';
425 -const composio = new Composio({ apiKey: 'your_api_key' });
426 -const connectionRequest = await composio.connectedAccounts.initiate('user_123', 'auth_config_id', {});
427 -// ---cut---
419 +```typescript
420 // Wait for the connection to be established
421 const connectedAccount = await connectionRequest.waitForConnection();
422 console.log(connectedAccount.id);
@@ -466,10 +458,7 @@ for connection in filtered_connections.items:
458 ```
459 </Tab>
460 <Tab value="TypeScript">
469 -```typescript twoslash
470 -import { Composio } from '@composio/core';
471 -const composio = new Composio({ apiKey: 'your_api_key' });
472 -// ---cut---
461 +```typescript
462 // Get a specific connected account by its nanoid
463 const connectedAccount = await composio.connectedAccounts.get('your_connected_account_id');
464 console.log(`Status: ${connectedAccount.status}`);
fumadocs/content/docs/connected-accounts.mdx
+8 -42
@@ -28,11 +28,7 @@ active_accounts = composio.connected_accounts.list(
28 ```
29 </Tab>
30 <Tab value="TypeScript">
31 -```typescript twoslash
32 -import { Composio } from '@composio/core';
33 -const composio = new Composio({ apiKey: 'your_api_key' });
34 -const userId = 'user_123';
35 -// ---cut---
31 +```typescript
32 // List all accounts for a user
33 const accounts = await composio.connectedAccounts.list({
34 userIds: [userId]
@@ -61,11 +57,7 @@ print(f"Toolkit: {account.toolkit.slug}")
57 ```
58 </Tab>
59 <Tab value="TypeScript">
64 -```typescript twoslash
65 -import { Composio } from '@composio/core';
66 -const composio = new Composio({ apiKey: 'your_api_key' });
67 -const connectedAccountId = 'ca_123';
68 -// ---cut---
60 +```typescript
61 const account = await composio.connectedAccounts.get(connectedAccountId);
62
63 console.log('Status:', account.status);
@@ -92,11 +84,7 @@ if account.state:
84 ```
85 </Tab>
86 <Tab value="TypeScript">
95 -```typescript twoslash
96 -import { Composio } from '@composio/core';
97 -const composio = new Composio({ apiKey: 'your_api_key' });
98 -const account = await composio.connectedAccounts.get('ca_123');
99 -// ---cut---
87 +```typescript
88 // Get the connected account's authentication state
89 if (account.state) {
90 // The state contains the auth scheme and credentials
@@ -134,11 +122,7 @@ except Exception as e:
122 ```
123 </Tab>
124 <Tab value="TypeScript">
137 -```typescript twoslash
138 -import { Composio } from '@composio/core';
139 -const composio = new Composio({ apiKey: 'your_api_key' });
140 -const connectedAccountId = 'ca_123';
141 -// ---cut---
125 +```typescript
126 try {
127 const refreshed = await composio.connectedAccounts.refresh(connectedAccountId);
128 console.log('Redirect URL:', refreshed.redirect_url);
@@ -171,11 +155,7 @@ print(f"Account enabled status: {enabled.success}")
155 ```
156 </Tab>
157 <Tab value="TypeScript">
174 -```typescript twoslash
175 -import { Composio } from '@composio/core';
176 -const composio = new Composio({ apiKey: 'your_api_key' });
177 -const connectedAccountId = 'ca_123';
178 -// ---cut---
158 +```typescript
159 // Disable an account
160 const disabled = await composio.connectedAccounts.disable(connectedAccountId);
161 console.log('Account disabled status:', disabled.success);
@@ -204,11 +184,7 @@ print("Account deleted successfully")
184 ```
185 </Tab>
186 <Tab value="TypeScript">
207 -```typescript twoslash
208 -import { Composio } from '@composio/core';
209 -const composio = new Composio({ apiKey: 'your_api_key' });
210 -const connectedAccountId = 'ca_123';
211 -// ---cut---
187 +```typescript
188 // Delete a connected account
189 await composio.connectedAccounts.delete(connectedAccountId);
190 console.log('Account deleted successfully');
@@ -258,12 +234,7 @@ except Exception as e:
234 ```
235 </Tab>
236 <Tab value="TypeScript">
261 -```typescript twoslash
262 -import { Composio } from '@composio/core';
263 -const composio = new Composio({ apiKey: 'your_api_key' });
264 -const userId = 'user_123';
265 -const authConfigId = 'ac_123';
266 -// ---cut---
237 +```typescript
238 // First account
239 try {
240 const firstAccount = await composio.connectedAccounts.initiate(
@@ -315,12 +286,7 @@ print(f"Tool executed: {result}")
286 ```
287 </Tab>
288 <Tab value="TypeScript">
318 -```typescript twoslash
319 -import { Composio } from '@composio/core';
320 -const composio = new Composio({ apiKey: 'your_api_key' });
321 -const userId = 'user_123';
322 -const connectedAccountId = 'ca_123';
323 -// ---cut---
289 +```typescript
290 // Execute tool with a specific connected account
291 const result = await composio.tools.execute('GMAIL_GET_PROFILE', {
292 userId: userId,
fumadocs/content/docs/custom-auth-configs.mdx
+2 -7
@@ -101,11 +101,7 @@ print(connected_account)
101 ```
102 </Tab>
103 <Tab value="TypeScript">
104 -```typescript twoslash
105 -import { Composio } from '@composio/core';
106 -const composio = new Composio({ apiKey: 'your_api_key' });
107 -const userId = 'user_123';
108 -// ---cut---
104 +```typescript
105 const connReq = await composio.connectedAccounts.initiate(userId, "ac_1234");
106
107 console.log(connReq.redirectUrl);
@@ -179,8 +175,7 @@ def authorize_app(toolkit: str):
175 ```
176 </Tab>
177 <Tab value="TypeScript">
182 -```typescript twoslash
183 -// @noErrors
178 +```typescript
179 import type { NextApiRequest, NextApiResponse } from 'next';
180
181 export default function handler(req: NextApiRequest, res: NextApiResponse) {
fumadocs/content/docs/custom-auth-params.mdx
+4 -12
@@ -19,7 +19,7 @@ composio = Composio()
19 ```
20 </Tab>
21 <Tab value="TypeScript">
22 -```typescript twoslash
22 +```typescript
23 import { Composio } from "@composio/core";
24
25 const composio = new Composio({
@@ -64,12 +64,8 @@ def add_custom_auth(
64 ```
65 </Tab>
66 <Tab value="TypeScript">
67 -```typescript twoslash
68 -const authModifier = ({ toolSlug, toolkitSlug, params }: {
69 - toolSlug: string;
70 - toolkitSlug: string;
71 - params: any;
72 -}) => {
67 +```typescript
68 +const authModifier = (toolSlug: string, toolkitSlug: string, params: any) => {
69 // Add authentication parameters for specific toolkits
70 if (toolkitSlug === "NOTION") {
71 if (!params.customAuthParams) {
@@ -116,11 +112,7 @@ print(result)
112 ```
113 </Tab>
114 <Tab value="TypeScript">
119 -```typescript twoslash
120 -import { Composio } from '@composio/core';
121 -const composio = new Composio({ apiKey: 'your_api_key' });
122 -const authModifier = ({ params }: { toolSlug: string; toolkitSlug: string; params: any }) => params;
123 -// ---cut---
115 +```typescript
116 const result = await composio.tools.execute(
117 "NOTION_GET_DATABASE_ITEMS",
118 {
fumadocs/content/docs/custom-tools.mdx
+5 -28
@@ -44,12 +44,7 @@ def add_two_numbers(request: AddTwoNumbersInput) -> int:
44 ```
45 </Tab>
46 <Tab value="TypeScript">
47 -```typescript twoslash
48 -// @noErrors
49 -import { Composio } from '@composio/core';
50 -import { z } from 'zod';
51 -const composio = new Composio({ apiKey: 'your_api_key' });
52 -// ---cut---
47 +```typescript
48 const tool = await composio.tools.createCustomTool({
49 slug: 'CALCULATE_SQUARE',
50 name: 'Calculate Square',
@@ -113,12 +108,7 @@ def get_issue_info(
108 ```
109 </Tab>
110 <Tab value="TypeScript">
116 -```typescript twoslash
117 -// @noErrors
118 -import { Composio } from '@composio/core';
119 -import { z } from 'zod';
120 -const composio = new Composio({ apiKey: 'your_api_key' });
121 -// ---cut---
111 +```typescript
112 const tool = await composio.tools.createCustomTool({
113 slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',
114 name: 'Github star composio repositories',
@@ -185,12 +175,7 @@ def get_issue_info_direct(
175 ```
176 </Tab>
177 <Tab value="TypeScript">
188 -```typescript twoslash
189 -// @noErrors
190 -import { Composio } from '@composio/core';
191 -import { z } from 'zod';
192 -const composio = new Composio({ apiKey: 'your_api_key' });
193 -// ---cut---
178 +```typescript
179 const tool = await composio.tools.createCustomTool({
180 slug: 'GITHUB_DIRECT_API',
181 name: 'Direct GitHub API Call',
@@ -257,12 +242,7 @@ def get_issue_info(
242 ```
243 </Tab>
244 <Tab value="TypeScript">
260 -```typescript twoslash
261 -// @noErrors
262 -import { Composio } from '@composio/core';
263 -import { z } from 'zod';
264 -const composio = new Composio({ apiKey: 'your_api_key' });
265 -// ---cut---
245 +```typescript
246 const tool = await composio.tools.createCustomTool({
247 slug: 'GITHUB_SEARCH_REPOSITORIES',
248 name: 'Search GitHub Repositories',
@@ -324,10 +304,7 @@ response = composio.tools.execute(
304 ```
305 </Tab>
306 <Tab value="TypeScript">
327 -```typescript twoslash
328 -import { Composio } from '@composio/core';
329 -const composio = new Composio({ apiKey: 'your_api_key' });
330 -// ---cut---
307 +```typescript
308 const result = await composio.tools.execute('TOOL_SLUG', {
309 arguments: {
310 // Tool input parameters
fumadocs/content/docs/executing-tools.mdx
+8 -23
@@ -55,8 +55,7 @@ print(result)
55 ```
56 </Tab>
57 <Tab value="TypeScript">
58 -```typescript twoslash
59 -// @noErrors
58 +```typescript
59 import { Composio } from '@composio/core';
60 import { AnthropicProvider } from '@composio/anthropic';
61 import { Anthropic } from '@anthropic-ai/sdk';
@@ -141,8 +140,7 @@ asyncio.run(main())
140 ```
141 </Tab>
142 <Tab value="TypeScript">
144 -```typescript twoslash
145 -// @noErrors
143 +```typescript
144 import { Composio } from '@composio/core';
145 import { generateText } from 'ai';
146 import { anthropic } from '@ai-sdk/anthropic';
@@ -214,7 +212,7 @@ print(result)
212 ```
213 </Tab>
214 <Tab value="TypeScript">
217 -```typescript twoslash
215 +```typescript
216 import { Composio } from "@composio/core";
217
218 const userId = "user-k7334";
@@ -270,10 +268,7 @@ print(response)
268 ```
269 </Tab>
270 <Tab value="TypeScript">
273 -```typescript twoslash
274 -import { Composio } from '@composio/core';
275 -const composio = new Composio({ apiKey: 'your_api_key' });
276 -// ---cut---
271 +```typescript
272 // Send a proxy request to the endpoint
273 const { data } = await composio.tools.proxyExecute({
274 endpoint:'/repos/composiohq/composio/issues/1',
@@ -319,11 +314,7 @@ print(result) # Print Google Drive file details
314 ```
315 </Tab>
316 <Tab value="TypeScript">
322 -```typescript twoslash
323 -import { Composio } from '@composio/core';
324 -import path from 'path';
325 -const composio = new Composio({ apiKey: 'your_api_key' });
326 -// ---cut---
317 +```typescript
318 // Upload a local file to Google Drive
319 const result = await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
320 userId: 'user-4235***',
@@ -360,10 +351,7 @@ print(result)
351 ```
352 </Tab>
353 <Tab value="TypeScript">
363 -```typescript twoslash
364 -import { Composio } from '@composio/core';
365 -const composio = new Composio({ apiKey: 'your_api_key' });
366 -// ---cut---
354 +```typescript
355 // Download a file from Google Drive
356 const result = await composio.tools.execute('GOOGLEDRIVE_DOWNLOAD_FILE', {
357 userId: 'user-1235***',
@@ -382,10 +370,7 @@ console.log(result);
370
371 You can disable automatic file handling when initializing the TypeScript SDK. When disabled, handle file uploads and downloads manually using `files.upload` and `files.download`:
372
385 -```typescript twoslash
386 -import { Composio } from '@composio/core';
387 -import path from 'path';
388 -// ---cut---
373 +```typescript
374 const composio = new Composio({
375 apiKey: process.env.COMPOSIO_API_KEY,
376 autoUploadDownloadFiles: false
@@ -393,7 +378,7 @@ const composio = new Composio({
378
379 // Now you need to handle files manually using composio.files API
380 const fileData = await composio.files.upload({
396 - file: path.join(__dirname, 'document.pdf'),
381 + filePath: path.join(__dirname, 'document.pdf'),
382 toolSlug: 'GOOGLEDRIVE_UPLOAD_FILE',
383 toolkitSlug: 'googledrive'
384 });
fumadocs/content/docs/fetching-tools.mdx
+6 -29
@@ -18,11 +18,7 @@ tools = composio.tools.get(
18 ```
19 </Tab>
20 <Tab value="TypeScript">
21 -```typescript twoslash
22 -import { Composio } from '@composio/core';
23 -const composio = new Composio({ apiKey: 'your_api_key' });
24 -const userId = 'user_123';
25 -// ---cut---
21 +```typescript
22 const tools = await composio.tools.get(userId, {
23 toolkits: ["GITHUB"]
24 });
@@ -43,10 +39,7 @@ tool = composio.tools.get_raw_composio_tool_by_slug("GMAIL_SEND_EMAIL")
39 ```
40 </Tab>
41 <Tab value="TypeScript">
46 -```typescript twoslash
47 -import { Composio } from '@composio/core';
48 -const composio = new Composio({ apiKey: 'your_api_key' });
49 -// ---cut---
42 +```typescript
43 const tool = await composio.tools.getRawComposioToolBySlug("GMAIL_SEND_EMAIL");
44 ```
45 </Tab>
@@ -82,11 +75,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
75 ```
76 </Tab>
77 <Tab value="TypeScript">
85 -```typescript twoslash
86 -import { Composio } from '@composio/core';
87 -const composio = new Composio({ apiKey: 'your_api_key' });
88 -const userId = 'user_123';
89 -// ---cut---
78 +```typescript
79 // Fetch with limit for a specific user
80 const limitedTools = await composio.tools.get(userId, {
81 toolkits: ["GITHUB"],
@@ -122,11 +111,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
111 ```
112 </Tab>
113 <Tab value="TypeScript">
125 -```typescript twoslash
126 -import { Composio } from '@composio/core';
127 -const composio = new Composio({ apiKey: 'your_api_key' });
128 -const userId = 'user_123';
129 -// ---cut---
114 +```typescript
115 // Fetch specific tools by name
116 const specificTools = await composio.tools.get(userId, {
117 tools: ["GITHUB_LIST_STARGAZERS", "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"]
@@ -156,11 +141,7 @@ tools = composio.tools.get(
141 ```
142 </Tab>
143 <Tab value="TypeScript">
159 -```typescript twoslash
160 -import { Composio } from '@composio/core';
161 -const composio = new Composio({ apiKey: 'your_api_key' });
162 -const userId = 'user_123';
163 -// ---cut---
144 +```typescript
145 // Filter by OAuth scopes (single toolkit only)
146 const scopedTools = await composio.tools.get(userId, {
147 toolkits: ["GITHUB"],
@@ -203,11 +184,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
184 ```
185 </Tab>
186 <Tab value="TypeScript">
206 -```typescript twoslash
207 -import { Composio } from '@composio/core';
208 -const composio = new Composio({ apiKey: 'your_api_key' });
209 -const userId = 'user_123';
210 -// ---cut---
187 +```typescript
188 // Search tools semantically
189 const searchResults = await composio.tools.get(userId, {
190 search: "create google calendar event"
fumadocs/content/docs/quickstart.mdx
+2 -4
@@ -108,8 +108,7 @@ Composio supports multiple LLM providers. Here's how to use Composio with some o
108 npm i @composio/core @composio/anthropic @anthropic-ai/sdk
109 ```
110
111 - ```typescript twoslash
112 - // @noErrors
111 + ```typescript
112 import { Composio } from "@composio/core";
113 import { AnthropicProvider } from "@composio/anthropic";
114 import Anthropic from "@anthropic-ai/sdk";
@@ -175,8 +174,7 @@ Composio supports multiple LLM providers. Here's how to use Composio with some o
174 npm i @composio/core @composio/vercel ai @ai-sdk/openai
175 ```
176
178 - ```typescript twoslash
179 - // @noErrors
177 + ```typescript
178 import { Composio } from "@composio/core";
179 import { VercelProvider } from "@composio/vercel";
180 import { generateText } from "ai";