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: remove deprecated fern documentation system
Sushmithamallesh17ab595bd00c
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERSindex 358743891..e09b3021d 100644--- a/.github/CODEOWNERS+++ b/.github/CODEOWNERS@@ -1,4 +1,3 @@-fern/ @haxzie @sushmithamalleshdocs/ @sushmithamalleshts/ @haxziepython/ @haxziediff --git a/.github/workflows/check_broken_links.yml b/.github/workflows/check_broken_links.ymldeleted file mode 100644index e716d7707..000000000--- a/.github/workflows/check_broken_links.yml+++ /dev/null@@ -1,82 +0,0 @@-name: Check Broken Links (DEPRECATED - Fern)--# DEPRECATED: This workflow checks broken links in the old Fern-based docs.-# The new docs in /docs use docs-check-links.yml instead.-# This workflow is disabled.--on:- pull_request:- paths:- - 'fern/**'- push:- branches:- - master- - next--jobs:- check-broken-links:- # DEPRECATED: Disabled - using new docs system in /docs- if: false- runs-on: ubuntu-latest- container:- image: ghcr.io/composiohq/dev-base:latest- permissions: read-all- env:- COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}-- steps:- - name: Checkout repository- uses: actions/checkout@v6-- - name: Setup Bun- uses: oven-sh/setup-bun@v2- with:- bun-version-file: '.bun-version'-- - name: Install dependencies- run: pnpm install- env:- BYPASS_BUN_VERSION_CHECK: '1'-- - name: Install git- run: |- apt-get update && apt-get install -y git-- - name: Install Python Dependencies- working-directory: ./fern- run: |- uv sync- uv pip install ../python-- - name: Install Fern- run: npm install -g fern-api-- - name: Build documentation with Turbo- working-directory: ./fern- run: pnpm turbo run build --filter=composio-docs-- - name: Check for broken links- working-directory: ./fern- run: |- set +e- OUTPUT=$(fern docs broken-links 2>&1)- EXIT_CODE=$?- set -e-- echo "$OUTPUT"-- if [ $EXIT_CODE -ne 0 ]; then- echo "::error::Found broken links in documentation"-- # Extract and format broken links for better visibility- echo ""- echo "## ❌ Broken Links Found"- echo ""- echo "$OUTPUT" | grep -E "(broken link to|fix here:)" | while read -r line; do- echo "- $line"- done-- exit 1- else- echo "✅ No broken links found"- fidiff --git a/.github/workflows/preview_docs.yml b/.github/workflows/preview_docs.ymldeleted file mode 100644index 3548c5e75..000000000--- a/.github/workflows/preview_docs.yml+++ /dev/null@@ -1,72 +0,0 @@-name: Preview Docs (DEPRECATED - Fern)--# DEPRECATED: This workflow previews the old Fern-based docs.-# The new docs are in /docs and previewed via Vercel.-# This workflow is disabled.--on:- pull_request:- paths:- - 'fern/**'--jobs:- run:- # DEPRECATED: Disabled - using new docs system in /docs- if: false- runs-on: ubuntu-latest- container:- image: ghcr.io/composiohq/dev-base:latest- permissions: write-all- env:- COMPOSIO_API_KEY: ${{ inputs.api_key || secrets.COMPOSIO_API_KEY }}-- steps:- - name: Checkout repository- uses: actions/checkout@v6-- - name: Setup Bun- uses: oven-sh/setup-bun@v2- with:- bun-version-file: '.bun-version'-- - name: Install dependencies- run: pnpm install-- - name: Install git- run: |- apt-get update && apt-get install -y git-- - name: Install Python Dependencies- working-directory: ./fern- run: |- uv sync- uv pip install ../python-- - name: Install Fern- run: npm install -g fern-api-- - name: Generate preview URL- id: generate-docs- working-directory: ./fern- env:- FERN_TOKEN: ${{ secrets.FERN_TOKEN }}- POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}- shell: bash- run: |- set -o pipefail- pnpm turbo run preview | tee preview.log-- URL=$(grep -oP 'Published docs to \K.*(?= \()' preview.log | tail -n 1 || true)-- if [ -z "$URL" ]; then- echo "::error::Failed to extract preview URL from preview.log"- exit 1- fi-- echo "Preview URL: $URL"- echo "Preview your docs: $URL" > preview_url.txt-- - name: Comment URL in PR- uses: thollander/actions-comment-pull-request@v3- with:- file-path: fern/preview_url.txtdiff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.ymldeleted file mode 100644index a736bc175..000000000--- a/.github/workflows/publish_docs.yml+++ /dev/null@@ -1,71 +0,0 @@-name: Publish Docs (DEPRECATED - Fern)--# DEPRECATED: This workflow publishes the old Fern-based docs.-# The new docs are in /docs and deployed via Vercel.-# This workflow is disabled - remove 'if: false' to re-enable if needed.--on:- push:- branches:- - next- workflow_dispatch:- inputs:- branch:- description: 'Branch to publish docs from'- required: false- default: 'next'- type: string- repository_dispatch:- types: [apollo-production-deploy]--jobs:- run:- runs-on: ubuntu-latest- container:- image: ghcr.io/composiohq/dev-base:latest- # DEPRECATED: Disabled - using new docs system in /docs- if: false- permissions: write-all- env:- COMPOSIO_API_KEY: ${{ inputs.api_key || secrets.COMPOSIO_API_KEY }}- steps:- - name: Checkout repository- uses: actions/checkout@v6-- - name: Setup Bun- uses: oven-sh/setup-bun@v2- with:- bun-version-file: '.bun-version'-- - name: Log trigger source- run: |- echo "Workflow triggered by: ${{ github.event_name }}"- if [ "${{ github.event_name }}" = "repository_dispatch" ]; then- echo "Triggered by Apollo production deployment"- echo "Hermes commit: ${{ github.event.client_payload.hermes_commit }}"- echo "Timestamp: ${{ github.event.client_payload.timestamp }}"- fi-- - name: Install git- run: apt-get update && apt-get install -y git-- - name: Install dependencies- run: pnpm install- env:- BYPASS_BUN_VERSION_CHECK: '1'-- - name: Install Python Dependencies- working-directory: ./fern- run: |- uv sync- uv pip install ../python-- - name: Publish Docs- working-directory: ./fern- env:- POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}- FERN_TOKEN: ${{ secrets.FERN_TOKEN }}- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}- CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}- CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}- run: pnpm turbo run publishdiff --git a/.gitignore b/.gitignoreindex a194bdf24..aa18b0b28 100644--- a/.gitignore+++ b/.gitignore@@ -39,18 +39,6 @@ report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json# lernalerna-debug.log*-# fern-fern/tools/*-fern/toolkits/*-!fern/toolkits/src/-!fern/toolkits/src/**-!fern/tools/src/-!fern/tools/src/**-fern/apis/openapi.yml-fern/apis/openapi.json-fern/apis/openapi-mcp.json-fern/pages/dist/-fern/pages/sdk/# Python cache files__pycache__/@@ -65,8 +53,6 @@ __pycache__/# VS Code.vscodetemp/-fern/llms-txt-worker/public/*-!fern/llms-txt-worker/public/.keepFolder# E2E test node_modulestest/e2e/*/node_modulesdiff --git a/CLAUDE.md b/CLAUDE.mdindex 2f29dae6c..a0f516094 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -8,7 +8,7 @@ This is the Composio SDK v3 repository containing both TypeScript and Python SDK## Memories and Notes-- For documentation tasks, refer to `fern/CLAUDE.md`+- For documentation tasks, refer to `docs/CLAUDE.md`## Effect.ts Reference Source@@ -112,7 +112,7 @@ composio/│ │ └── ts-builders/ # TypeScript code generation utilities│ └── examples/ # Usage examples for different providers├── python/ # Python SDK-├── fern/ # Documentation and API specs+├── docs/ # Documentation (Fumadocs)└── examples/ # Cross-platform examples```@@ -194,7 +194,7 @@ CI # CI environment flag- **Type Definitions**: `ts/packages/core/src/types/`- **Error Classes**: `ts/packages/core/src/errors/`- **Examples**: `ts/examples/` and `examples/`-- **Documentation**: `ts/docs/` and `fern/`+- **Documentation**: `docs/`- **Build Configs**: `turbo.jsonc`, `tsconfig.base.json`, `tsdown.config.base.ts`- **E2E Tests**: `ts/e2e-tests/`diff --git a/README.md b/README.mdindex 98b14add1..c766d7387 100644--- a/README.md+++ b/README.md@@ -143,7 +143,7 @@ To update the OpenAPI specifications used for generating SDK documentation:pnpm api:pull```-This command pulls the OpenAPI specification from `https://backend.composio.dev/api/v3/openapi.json` (defined in `fern/scripts/pull-openapi-spec.sh`) and updates the local API documentation files.+This command pulls the OpenAPI specification from `https://backend.composio.dev/api/v3/openapi.json` and updates the local API documentation files.This is pulled automatically with build step.diff --git a/context7.json b/context7.jsonindex 7b2f36209..4c653cb38 100644--- a/context7.json+++ b/context7.json@@ -1,7 +1,7 @@{"projectTitle": "Composio","description": "Composio equip's your AI agents & LLMs with 100+ high-quality integrations via function calling",- "folders": ["fern/pages/src", "fern/snippets", "ts", "python"],+ "folders": ["docs/content", "ts", "python"],"excludeFolders": [],"excludeFiles": ["CHANGELOG.md",diff --git a/fern/.python-version b/fern/.python-versiondeleted file mode 100644index e4fba2183..000000000--- a/fern/.python-version+++ /dev/null@@ -1 +0,0 @@-3.12diff --git a/fern/CLAUDE.md b/fern/CLAUDE.mddeleted file mode 100644index 509a57111..000000000--- a/fern/CLAUDE.md+++ /dev/null@@ -1,121 +0,0 @@-# CLAUDE.md--> **⚠️ DEPRECATED**: This Fern-based documentation system is deprecated. The new documentation is in `/docs` (built with Fumadocs). See `/docs/CLAUDE.md` for current documentation guidelines.-------You are reviewing technical documentation for the Composio SDK and API.--Your task is to:-- Catch and fix any and all grammar and spelling mistakes.-- Find logical gaps in explanations that might make it difficult to understand a concept for a user.-- Find and suggest fixes in ``` codeblocks when proper practices aren’t being followed.--Read through the previous docs in `fern/pages/src` to understand how they are written.--### Proper documentation practices--- BLUF: Bottom-Line Up Front. Show logical graduation for a concept from basic understanding and then add in more information as needed.-- Progressive disclosure. For example: “Executing tools:: Show how to execute tool; then show parameters, then show authentication” or “Authenticating tools:: Show basic OAuth authentication, show auth config creation flow, show how to get params and then create connection”-- Proper structure and flow: Given the entire understanding of the docs and product, proper docs should exist in proper folders and be linked properly.-- If a concept is cross-linking or referencing another concept, cross linking should be done.-- Scientifically structured—organized like a research paper or technical white paper, with a logical flow and strict attention to detail.-- Focused on user success — no marketing language or fluff; just the necessary information.--### Review Guidelines--- Titles must always start with an uppercase letter, followed by lowercase letters unless it is a name. Examples: Getting started, Text to speech, Conversational AI...-- No emojis or icons unless absolutely necessary.-- Scientific research tone—professional, factual, and straightforward.-- Avoid long text blocks. Use short paragraphs and line breaks.-- Do not use marketing/promotional language.-- Be concise, direct, and avoid wordiness.-- Tailor the tone and style depending on the location of the content.-- If the user asks you to update the changelog, you must create a new changelog file in the /fern/docs/pages/changelog folder with the following file name: `2024-10-13.md` (the date should be the current date).-- Ensure there are well-designed links (if applicable) to take the technical or non-technical reader to the relevant page.---## Components--Suggest to use the following components whenever possible to enhance readability and structure.--### Code Snippets--How to Use SnippetCode Component--Basic Usage--For local files:-```-<SnippetCode src="fern/snippets/get-started/pyth-on/quickstart.py" />-```-For GitHub files:-<SnippetCode-githubUrl="[https://github.com/ComposioHQ/compo](https://github.com/ComposioHQ/compo)-sio/blob/master/python/examples/quickstart.py"-title="[quickstart.py](http://quickstart.py)"-/>--Advanced Options--Select specific lines:-```-<SnippetCode-src="fern/snippets/tool-calling/python/example-.py"-startLine={10}-endLine={25}-/>-```-Highlight lines:-```-<SnippetCode--githubUrl="[https://github.com/ComposioHQ/composi](https://github.com/ComposioHQ/composi)-o/blob/master/python/examples/gmail.py#L20-L40"-highlightStart={25}-highlightEnd={30}-title="Gmail Integration"-/>-```-The component ensures your documentation stays-in sync with actual code examples, whether-they're local snippets or from GitHub-repositories.--### Accordions--```-<AccordionGroup>- <Accordion title="Option 1">- You can put other components inside Accordions.- ```ts- export function generateRandomNumber() {- return Math.random();- }- ```- </Accordion>- <Accordion title="Option 2">- This is a second option.- </Accordion>-- <Accordion title="Option 3">- This is a third option.- </Accordion>-</AccordionGroup>-```--### Callouts (Tips, Notes, Warnings, etc.)--```-<Tip title="Example Callout" icon="leaf">-This Callout uses a title and a custom icon.-</Tip>-<Note>This adds a note in the content</Note>-<Warning>This raises a warning to watch out for</Warning>-<Error>This indicates a potential error</Error>-<Info>This draws attention to important information</Info>-<Tip>This suggests a helpful tip</Tip>-<Check>This brings us a checked status</Check>-```\ No newline at end of filediff --git a/fern/README.md b/fern/README.mddeleted file mode 100644index 11b18ab78..000000000--- a/fern/README.md+++ /dev/null@@ -1,116 +0,0 @@-# Composio Documentation (DEPRECATED)--> **⚠️ DEPRECATED**: This Fern-based documentation system is deprecated. The new documentation is now located in the `/docs` directory and built with [Fumadocs](https://fumadocs.dev/). Please make all documentation changes there instead.->-> This directory is kept for reference only and will be removed in a future release.-------Welcome to the Composio documentation! This guide will help you contribute to our documentation with ease.--## Table of Contents--- [Prerequisites](#prerequisites)-- [One-Time Setup](#one-time-setup)-- [Development Workflow](#development-workflow)-- [Troubleshooting](#troubleshooting)-- [Contributing Guidelines](#contributing-guidelines)--## Prerequisites--Before you start, make sure you have the following installed on your system:--- **Node.js** (version 18 or higher) - [Download here](https://nodejs.org/)-- **pnpm** (package manager) - Install with `npm install -g pnpm`-- **Git** - For version control-- **A Composio API key** - Get one from [Composio Dashboard](https://platform.composio.dev?next_page=/settings)--## One-Time Setup--Follow these steps once when you first set up the project:--### 1. Clone and Navigate to the Project--```bash-git clone <repository-url>-cd composio1/fern-```--### 2. Install Dependencies--```bash-pnpm install-```--### 3. Install Python Dependencies--UV is required for generating tool and Python documentation:--```bash-curl -LsSf https://astral.sh/uv/install.sh | sh-```--**Install the Python SDK**-```bash-uv sync && uv pip install python/-```--### 4. Install and Setup Fern CLI--Fern is the documentation framework we use:--```bash-npm install -g fern-api-fern login-```--### 5. Set Up Your API Key--Export your Composio API key (you'll need this for generating tool documentation):--```bash-export COMPOSIO_API_KEY=your_api_key_here-```--**Pro tip:** Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) so you don't have to set it every time.--## Development Workflow--Once you've completed the one-time setup, use this workflow for ongoing development:--### 1. Start the Development Server--```bash-pnpm turbo run dev-```--This will:--- Comment out tool docs for faster development-- Build example code-- Start the documentation server at http://localhost:3000--### 2. Make Your Changes--- Edit the documentation files in the `fern/pages/src` directories.-- If adding new docs, make sure to add them in `docs.yml`-- Refer to [Fern docs](https://buildwithfern.com/learn/docs/getting-started/overview)--### 3. Check Your Work--Before submitting your changes, run these commands to ensure everything is working:--```bash-# Check for broken links and other issues-cd fern/ && pnpm run links--# Or use the check command (faster, but comments out tool docs)-cd fern/ && pnpm run check-```--### 4. Submit Your Changes--1. Commit your changes to a new branch-2. Push to your fork-3. Create a pull request-5. You will see preview links generated in the PR, use that to share.diff --git a/fern/apis/openapi-overrides.yml b/fern/apis/openapi-overrides.ymldeleted file mode 100644index 04ac45296..000000000--- a/fern/apis/openapi-overrides.yml+++ /dev/null@@ -1,33 +0,0 @@-paths:- /api/v3/mcp/validate/{uuid}:- get:- x-fern-ignore: true- /api/v3/labs/tool_router/session:- post:- x-fern-ignore: true- /api/v3/cli/get-session:- get:- x-fern-ignore: true- /api/v3/cli/create-session:- post:- x-fern-ignore: true- /api/v3/auth/session/logout:- post:- x-fern-ignore: true- /api/v3/tool_router/session/{session_id}/execute:- post:- parameters:- - ~ # keep session_id (first param)- - x-fern-ignore: true # hide x-session-access-key (second param)-components:- securitySchemes:- ApiKeyAuth:- type: apiKey- in: header- name: x-api-key- description: API key authentication- CookieAuth:- # type: apiKey- # in: header- # name: authToken- # description: Cookie based authenticationdiff --git a/fern/apis/v3/generators.yml b/fern/apis/v3/generators.ymldeleted file mode 100644index 415ed5e9e..000000000--- a/fern/apis/v3/generators.yml+++ /dev/null@@ -1,6 +0,0 @@-api:- specs:- - openapi: ../openapi.json- overrides: ../openapi-overrides.yml- settings:- title-as-schema-name: falsediff --git a/fern/assets/IBMPlexMono-Light.ttf b/fern/assets/IBMPlexMono-Light.ttfdeleted file mode 100644index df167f094..000000000Binary files a/fern/assets/IBMPlexMono-Light.ttf and /dev/null differdiff --git a/fern/assets/Inter-Medium.woff2 b/fern/assets/Inter-Medium.woff2deleted file mode 100644index fdfdcc699..000000000Binary files a/fern/assets/Inter-Medium.woff2 and /dev/null differdiff --git a/fern/assets/favicon.png b/fern/assets/favicon.pngdeleted file mode 100644index f8cc87148..000000000Binary files a/fern/assets/favicon.png and /dev/null differdiff --git a/fern/assets/images/after-execute.png b/fern/assets/images/after-execute.pngdeleted file mode 100644index 879931b17..000000000Binary files a/fern/assets/images/after-execute.png and /dev/null differdiff --git a/fern/assets/images/anthropic-logo.svg b/fern/assets/images/anthropic-logo.svgdeleted file mode 100644index 90ee9333c..000000000--- a/fern/assets/images/anthropic-logo.svg+++ /dev/null@@ -1,14 +0,0 @@-<svg fill="currentColor" fill-rule="evenodd" height="64" style="flex:none;line-height:1" viewBox="0 0 24 24" width="64" xmlns="http://www.w3.org/2000/svg">- <title>Anthropic</title>- <style>- .logo-path {- fill: #000;- }- @media (prefers-color-scheme: dark) {- .logo-path {- fill: #fff;- }- }- </style>- <path class="logo-path" d="M13.827 3.52h3.603L24 20h-3.603l-6.57-16.48zm-7.258 0h3.767L16.906 20h-3.674l-1.343-3.461H5.017l-1.344 3.46H0L6.57 3.522zm4.132 9.959L8.453 7.687 6.205 13.48H10.7z"></path>-</svg>\ No newline at end of filediff --git a/fern/assets/images/ask-index-docs.png b/fern/assets/images/ask-index-docs.pngdeleted file mode 100644index dd737feb3..000000000Binary files a/fern/assets/images/ask-index-docs.png and /dev/null differdiff --git a/fern/assets/images/auth-config-creation.png b/fern/assets/images/auth-config-creation.pngdeleted file mode 100644index c2f4713bc..000000000Binary files a/fern/assets/images/auth-config-creation.png and /dev/null differdiff --git a/fern/assets/images/auth-screen-example.png b/fern/assets/images/auth-screen-example.pngdeleted file mode 100644index 9f7a15766..000000000Binary files a/fern/assets/images/auth-screen-example.png and /dev/null differdiff --git a/fern/assets/images/before-execute.png b/fern/assets/images/before-execute.pngdeleted file mode 100644index 1211dab55..000000000Binary files a/fern/assets/images/before-execute.png and /dev/null differdiff --git a/fern/assets/images/composio-auth-app.png b/fern/assets/images/composio-auth-app.pngdeleted file mode 100644index 804ea5a79..000000000Binary files a/fern/assets/images/composio-auth-app.png and /dev/null differdiff --git a/fern/assets/images/cursor-settings.png b/fern/assets/images/cursor-settings.pngdeleted file mode 100644index 3cb8e4c9a..000000000Binary files a/fern/assets/images/cursor-settings.png and /dev/null differdiff --git a/fern/assets/images/custom-auth-app.png b/fern/assets/images/custom-auth-app.pngdeleted file mode 100644index 8ca7c687b..000000000Binary files a/fern/assets/images/custom-auth-app.png and /dev/null differdiff --git a/fern/assets/images/custom-auth-hubspot.png b/fern/assets/images/custom-auth-hubspot.pngdeleted file mode 100644index 8b8f6fd18..000000000Binary files a/fern/assets/images/custom-auth-hubspot.png and /dev/null differdiff --git a/fern/assets/images/custom-auth-posthog.png b/fern/assets/images/custom-auth-posthog.pngdeleted file mode 100644index 57c58cb75..000000000Binary files a/fern/assets/images/custom-auth-posthog.png and /dev/null differdiff --git a/fern/assets/images/custom-redirect-uri.png b/fern/assets/images/custom-redirect-uri.pngdeleted file mode 100644index 9bc418115..000000000Binary files a/fern/assets/images/custom-redirect-uri.png and /dev/null differdiff --git a/fern/assets/images/debugging-info/debugging-info.png b/fern/assets/images/debugging-info/debugging-info.pngdeleted file mode 100644index ee83003e0..000000000Binary files a/fern/assets/images/debugging-info/debugging-info.png and /dev/null differdiff --git a/fern/assets/images/debugging-info/project-settings.jpeg b/fern/assets/images/debugging-info/project-settings.jpegdeleted file mode 100644index 01cb30d7d..000000000Binary files a/fern/assets/images/debugging-info/project-settings.jpeg and /dev/null differdiff --git a/fern/assets/images/examples/ai-email-labels.png b/fern/assets/images/examples/ai-email-labels.pngdeleted file mode 100644index ebdcd5d99..000000000Binary files a/fern/assets/images/examples/ai-email-labels.png and /dev/null differdiff --git a/fern/assets/images/examples/auth-configs.png b/fern/assets/images/examples/auth-configs.pngdeleted file mode 100644index 695d61d4a..000000000Binary files a/fern/assets/images/examples/auth-configs.png and /dev/null differdiff --git a/fern/assets/images/examples/connection-status.png b/fern/assets/images/examples/connection-status.pngdeleted file mode 100644index 4175b1aea..000000000Binary files a/fern/assets/images/examples/connection-status.png and /dev/null differdiff --git a/fern/assets/images/examples/create-connection.png b/fern/assets/images/examples/create-connection.pngdeleted file mode 100644index 3c9c05c32..000000000Binary files a/fern/assets/images/examples/create-connection.png and /dev/null differdiff --git a/fern/assets/images/examples/custom-tool-component.png b/fern/assets/images/examples/custom-tool-component.pngdeleted file mode 100644index c5ac21b8e..000000000Binary files a/fern/assets/images/examples/custom-tool-component.png and /dev/null differdiff --git a/fern/assets/images/examples/gmail-agent-trace.png b/fern/assets/images/examples/gmail-agent-trace.pngdeleted file mode 100644index d507abd66..000000000Binary files a/fern/assets/images/examples/gmail-agent-trace.png and /dev/null differdiff --git a/fern/assets/images/examples/toolkits.png b/fern/assets/images/examples/toolkits.pngdeleted file mode 100644index d5e972602..000000000Binary files a/fern/assets/images/examples/toolkits.png and /dev/null differdiff --git a/fern/assets/images/examples/trigger-config.png b/fern/assets/images/examples/trigger-config.pngdeleted file mode 100644index 9d2877226..000000000Binary files a/fern/assets/images/examples/trigger-config.png and /dev/null differdiff --git a/fern/assets/images/examples/webhook-secret.png b/fern/assets/images/examples/webhook-secret.pngdeleted file mode 100644index 0f51d0b73..000000000Binary files a/fern/assets/images/examples/webhook-secret.png and /dev/null differdiff --git a/fern/assets/images/executingtools.png b/fern/assets/images/executingtools.pngdeleted file mode 100644index debfb441c..000000000Binary files a/fern/assets/images/executingtools.png and /dev/null differdiff --git a/fern/assets/images/github-callback.png b/fern/assets/images/github-callback.pngdeleted file mode 100644index 4d4e22f3c..000000000Binary files a/fern/assets/images/github-callback.png and /dev/null differdiff --git a/fern/assets/images/github-oauth-config.png b/fern/assets/images/github-oauth-config.pngdeleted file mode 100644index c3c4305a1..000000000Binary files a/fern/assets/images/github-oauth-config.png and /dev/null differdiff --git a/fern/assets/images/google-callback.png b/fern/assets/images/google-callback.pngdeleted file mode 100644index a762db506..000000000Binary files a/fern/assets/images/google-callback.png and /dev/null differdiff --git a/fern/assets/images/google-logo.svg b/fern/assets/images/google-logo.svgdeleted file mode 100644index aede0e4bd..000000000--- a/fern/assets/images/google-logo.svg+++ /dev/null@@ -1 +0,0 @@-<svg viewBox="0 0 256 262" xmlns="http://www.w3.org/2000/svg" preserveAspectRatio="xMidYMid"><path d="M255.878 133.451c0-10.734-.871-18.567-2.756-26.69H130.55v48.448h71.947c-1.45 12.04-9.283 30.172-26.69 42.356l-.244 1.622 38.755 30.023 2.685.268c24.659-22.774 38.875-56.282 38.875-96.027" fill="#4285F4"/><path d="M130.55 261.1c35.248 0 64.839-11.605 86.453-31.622l-41.196-31.913c-11.024 7.688-25.82 13.055-45.257 13.055-34.523 0-63.824-22.773-74.269-54.25l-1.531.13-40.298 31.187-.527 1.465C35.393 231.798 79.49 261.1 130.55 261.1" fill="#34A853"/><path d="M56.281 156.37c-2.756-8.123-4.351-16.827-4.351-25.82 0-8.994 1.595-17.697 4.206-25.82l-.073-1.73L15.26 71.312l-1.335.635C5.077 89.644 0 109.517 0 130.55s5.077 40.905 13.925 58.602l42.356-32.782" fill="#FBBC05"/><path d="M130.55 50.479c24.514 0 41.05 10.589 50.479 19.438l36.844-35.974C195.245 12.91 165.798 0 130.55 0 79.49 0 35.393 29.301 13.925 71.947l42.211 32.783c10.59-31.477 39.891-54.251 74.414-54.251" fill="#EB4335"/></svg>\ No newline at end of filediff --git a/fern/assets/images/google-oauth-config.png b/fern/assets/images/google-oauth-config.pngdeleted file mode 100644index cf61aa1c1..000000000Binary files a/fern/assets/images/google-oauth-config.png and /dev/null differdiff --git a/fern/assets/images/index-docs.png b/fern/assets/images/index-docs.pngdeleted file mode 100644index 9ea12dc6c..000000000Binary files a/fern/assets/images/index-docs.png and /dev/null differdiff --git a/fern/assets/images/integration-step-3-0.png b/fern/assets/images/integration-step-3-0.pngdeleted file mode 100644index b389a3c43..000000000Binary files a/fern/assets/images/integration-step-3-0.png and /dev/null differdiff --git a/fern/assets/images/langgraph-logo.svg b/fern/assets/images/langgraph-logo.svgdeleted file mode 100644index 92a115e10..000000000--- a/fern/assets/images/langgraph-logo.svg+++ /dev/null@@ -1,14 +0,0 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 207.43 32">- <style>- .logo-path {- fill: #000;- }- @media (prefers-color-scheme: dark) {- .logo-path {- fill: #fff;- }- }- </style>- <path class="logo-path" d="M15.81 0h30.6c8.72 0 15.81 7.12 15.81 15.87s-7.09 15.87-15.81 15.87h-30.6C7.09 31.73 0 24.61 0 15.87S7.09 0 15.81 0m14.05 24.59c.38.4.95.38 1.46.28.23-.19-.1-.43-.42-.66-.19-.14-.38-.27-.43-.39.18-.21-.34-.7-.75-1.08-.17-.16-.32-.3-.39-.39-.29-.31-.4-.71-.52-1.11-.08-.26-.15-.53-.28-.77-.79-1.84-1.7-3.66-2.97-5.21-.82-1.03-1.75-1.96-2.68-2.88-.6-.6-1.2-1.19-1.77-1.82-.59-.61-.94-1.35-1.29-2.1-.3-.63-.59-1.25-1.03-1.8-1.31-1.95-5.46-2.48-6.07.27 0 .08-.02.14-.1.19-.34.25-.64.53-.89.87-.62.86-.71 2.32.06 3.09v-.05c.03-.39.05-.76.36-1.04.59.51 1.49.69 2.18.31.83 1.19 1.09 2.63 1.36 4.07.22 1.2.44 2.41.99 3.48l.03.06c.32.54.65 1.08 1.07 1.55.15.23.46.49.77.74.41.33.81.66.85.95v.38c0 .75 0 1.53.48 2.15.27.54-.39 1.08-.91 1.02-.29.04-.6-.04-.92-.11-.43-.1-.85-.21-1.2 0-.1.1-.24.11-.38.11-.17 0-.33 0-.43.18-.02.05-.07.11-.12.17-.11.13-.23.28-.09.39.01 0 .03-.02.04-.03.21-.16.42-.32.7-.22-.04.21.1.27.24.33.02 0 .05.02.07.03 0 .05-.01.1-.02.15-.02.12-.05.23.05.34.04-.04.08-.09.12-.14.09-.12.19-.24.36-.29.37.5.75.29 1.22.03.53-.29 1.19-.65 2.1-.14-.35-.02-.66.02-.9.31-.06.06-.11.14 0 .22.54-.35.76-.22.97-.11.15.09.3.17.55.06.06-.03.12-.06.18-.1.4-.22.81-.44 1.3-.36-.36.1-.49.33-.63.58-.07.12-.14.25-.24.37-.05.05-.08.12-.02.21.75-.06 1.03-.25 1.42-.51.18-.12.39-.26.68-.41.32-.2.64-.07.95.05.34.13.66.26.96-.03.1-.09.21-.09.33-.09h.13c-.09-.5-.62-.5-1.16-.49-.62 0-1.25.01-1.23-.76.58-.39.58-1.08.59-1.72 0-.16 0-.31.01-.46.42.24.87.42 1.32.6.42.17.84.34 1.23.56.41.66 1.05 1.53 1.9 1.47.02-.07.04-.12.07-.19.05 0 .1.02.15.03.22.06.46.12.58-.15Zm16.67-7.48c.49.49 1.16.77 1.86.77s1.36-.28 1.86-.77c.49-.49.77-1.16.77-1.85a2.63 2.63 0 0 0-2.63-2.62c-.33 0-.65.06-.94.18l-1.5-2.2-1.05.72 1.51 2.21a2.61 2.61 0 0 0 .13 3.56ZM41.81 10c.37.18.77.28 1.19.27.56 0 1.11-.19 1.55-.52.45-.34.78-.81.94-1.34.16-.54.15-1.11-.04-1.64a2.58 2.58 0 0 0-1.01-1.29c-.34-.23-.73-.37-1.14-.43-.41-.05-.82 0-1.21.13-.39.14-.74.37-1.02.66a2.61 2.61 0 0 0-.68 2.26c.07.4.24.79.48 1.11.25.33.57.59.94.78Zm0 15.21c.37.18.77.28 1.19.27.56 0 1.11-.19 1.55-.52.45-.34.78-.81.94-1.34.16-.54.15-1.11-.04-1.64a2.58 2.58 0 0 0-1.01-1.29c-.34-.23-.73-.37-1.14-.43-.41-.05-.82 0-1.21.13-.39.14-.74.37-1.02.66a2.61 2.61 0 0 0-.68 2.26c.07.4.24.79.48 1.11.25.33.57.59.94.78Zm2.42-9.3v-1.3h-4.02c-.1-.39-.29-.76-.56-1.07l1.51-2.24-1.1-.73-1.51 2.24c-.28-.1-.57-.15-.86-.16-.69 0-1.36.27-1.85.76s-.77 1.15-.77 1.84.28 1.35.77 1.84 1.16.76 1.85.76c.29 0 .59-.06.86-.16l1.51 2.24 1.09-.73-1.5-2.24c.27-.31.46-.67.56-1.07h4.02Z" style="fill-rule: evenodd"/>- <path class="logo-path" d="M148.76 7.61c-1.36-1.08-3.25-1.63-5.59-1.63-1.69 0-3.23.4-4.57 1.18-1.35.79-2.42 1.93-3.19 3.41-.78 1.48-1.17 3.28-1.17 5.36 0 1.59.23 3.02.69 4.25s1.1 2.28 1.92 3.12c.81.84 1.77 1.49 2.85 1.93s2.25.66 3.48.66c1.84 0 3.44-.4 4.76-1.19s2.34-1.9 3.05-3.29c.71-1.4 1.07-3.01 1.07-4.81 0-.05 0-.22-.01-.49 0-.22-.02-.4-.03-.54h-6.65v2.34h3.42v.11c-.18 1.11-.5 2.06-.97 2.8-.47.75-1.09 1.31-1.83 1.68s-1.63.55-2.6.54c-1.31-.02-2.41-.32-3.29-.91-.87-.59-1.54-1.42-1.97-2.47s-.65-2.3-.65-3.71.22-2.67.66-3.73s1.1-1.91 1.97-2.49c.87-.59 1.98-.88 3.28-.86 1.3 0 2.39.35 3.23 1.04.82.68 1.43 1.59 1.8 2.71l3.12-.49c-.49-1.91-1.42-3.42-2.76-4.49Zm40.43 4.09c-1.01-.67-2.19-1-3.56-1s-2.53.33-3.46 1c-.19.14-.37.28-.54.44V11.1h-2.85V32h3.25v-7.16c.06.04.12.09.18.13.96.67 2.14 1 3.55 1 1.33 0 2.49-.33 3.48-1s1.76-1.58 2.3-2.73.82-2.45.82-3.9-.28-2.77-.83-3.92-1.33-2.05-2.34-2.72m-.64 9.04c-.26.72-.67 1.29-1.21 1.71s-1.24.63-2.08.63-1.57-.2-2.1-.6-.92-.95-1.16-1.67c-.25-.71-.37-1.54-.37-2.48s.12-1.78.37-2.48c.24-.71.63-1.26 1.14-1.66q.78-.6 2.01-.6c.87 0 1.58.21 2.14.64.56.42.98 1 1.25 1.72s.4 1.52.4 2.39-.13 1.69-.39 2.4m18.78-4.61c-.06-.56-.18-1.15-.38-1.78s-.5-1.21-.91-1.77c-.41-.55-.96-1.01-1.66-1.37s-1.58-.54-2.65-.54c-1.36 0-2.5.3-3.43.89-.5.32-.93.7-1.3 1.13V6.26h-2.88v19.29h3.27v-7.43c0-.88.1-1.61.29-2.18.2-.57.46-1.01.78-1.34.33-.33.69-.56 1.09-.69s.81-.2 1.22-.2c.77 0 1.38.16 1.83.5.45.33.79.75 1.02 1.27.23.51.37 1.05.44 1.6.06.55.09 1.06.09 1.51v6.97h3.27v-8.08c0-.35-.03-.8-.09-1.36Zm-45.71-4.9c-.44.03-.88.11-1.3.25-.42.13-.81.32-1.15.55q-.615.375-1.05.96c-.13.17-.24.35-.36.55l-.12.21v-2.47h-2.69v14.16h3.07v-7.2c0-.55.07-1.07.2-1.55s.35-.91.63-1.28c.28-.38.65-.69 1.1-.93.44-.27.96-.43 1.51-.47.52-.04.99 0 1.4.1v-2.84c-.4-.06-.82-.08-1.24-.05ZM74.91 6.25v19.24h13.25v-2.91H77.92V6.25zm20.32 4.56c-2.89 0-5.05 1.35-5.93 3.72-.06.15-.22.61-.22.61l2.48 1.6.34-.88c.57-1.5 1.64-2.19 3.34-2.19s2.68.83 2.66 2.45v.27s-2.25.37-3.18.56c-3.96.84-5.62 2.35-5.62 4.83 0 1.32.73 2.75 2.07 3.55.8.48 1.85.66 3 .66.76 0 1.5-.11 2.18-.32 1.56-.52 1.99-1.53 1.99-1.53v1.33h2.58v-9.49c0-3.23-2.12-5.15-5.67-5.15Zm2.67 10.13c0 1-1.09 2.4-3.62 2.4-.71 0-1.22-.19-1.56-.47-.45-.38-.6-.92-.54-1.4.03-.21.15-.66.62-1.04.48-.4 1.32-.68 2.62-.97 1.07-.23 2.48-.49 2.48-.49zm72.73-10.13c-2.89 0-5.05 1.35-5.93 3.72-.06.15-.22.61-.22.61l2.48 1.6.34-.88c.57-1.5 1.64-2.19 3.34-2.19s2.68.83 2.66 2.45v.27s-2.26.37-3.18.56c-3.96.84-5.62 2.35-5.62 4.83 0 1.32.73 2.75 2.07 3.55.8.48 1.85.66 3 .66.76 0 1.5-.11 2.18-.32 1.56-.52 1.99-1.53 1.99-1.53v1.33h2.58v-9.49c0-3.23-2.12-5.15-5.67-5.15Zm2.67 10.13c0 1-1.09 2.4-3.62 2.4-.71 0-1.22-.19-1.56-.47-.45-.38-.6-.92-.54-1.4.03-.21.15-.66.62-1.04.48-.4 1.32-.68 2.62-.97 1.07-.23 2.48-.49 2.48-.49zm-62.88-10.13c-.36 0-.71.02-1.04.07-2.31.35-2.98 1.52-2.98 1.52v-1.17h-2.89v14.23h3.01v-7.89c0-2.68 1.96-3.9 3.77-3.9 1.96 0 2.92 1.06 2.92 3.23v8.56h3.01v-8.98c0-3.5-2.22-5.67-5.8-5.67m18.36.41v1.47s-.74-1.88-4.09-1.88c-4.17 0-6.76 2.88-6.76 7.51 0 2.61.83 4.67 2.31 5.97 1.15 1.01 2.68 1.53 4.5 1.56 1.27.02 2.09-.32 2.6-.65.99-.63 1.35-1.22 1.35-1.22s-.04.47-.12 1.1c-.05.46-.16.78-.16.78-.46 1.63-1.8 2.57-3.75 2.57s-3.14-.64-3.37-1.91l-2.93.87c.51 2.44 2.79 3.89 6.12 3.89 2.26 0 4.03-.61 5.27-1.83s1.88-2.99 1.88-5.24v-13h-2.85Zm-.19 7.23c0 2.85-1.39 4.55-3.72 4.55-2.5 0-3.93-1.71-3.93-4.68s1.43-4.65 3.93-4.65c2.27 0 3.7 1.69 3.72 4.42z"/>-</svg>\ No newline at end of filediff --git a/fern/assets/images/mcp-api-key-toggle.png b/fern/assets/images/mcp-api-key-toggle.pngdeleted file mode 100644index 7855e1890..000000000Binary files a/fern/assets/images/mcp-api-key-toggle.png and /dev/null differdiff --git a/fern/assets/images/oauth-branding.png b/fern/assets/images/oauth-branding.pngdeleted file mode 100644index 8b056ed9b..000000000Binary files a/fern/assets/images/oauth-branding.png and /dev/null differdiff --git a/fern/assets/images/oauth-composio-branding.png b/fern/assets/images/oauth-composio-branding.pngdeleted file mode 100644index 40dd1c37d..000000000Binary files a/fern/assets/images/oauth-composio-branding.png and /dev/null differdiff --git a/fern/assets/images/openai-logo.svg b/fern/assets/images/openai-logo.svgdeleted file mode 100644index 682ab415d..000000000--- a/fern/assets/images/openai-logo.svg+++ /dev/null@@ -1,13 +0,0 @@-<svg xmlns="http://www.w3.org/2000/svg" preserveAspectRatio="xMidYMid" viewBox="0 0 256 260">- <style>- .logo-path {- fill: #000;- }- @media (prefers-color-scheme: dark) {- .logo-path {- fill: #fff;- }- }- </style>- <path class="logo-path" d="M239.184 106.203a64.716 64.716 0 0 0-5.576-53.103C219.452 28.459 191 15.784 163.213 21.74A65.586 65.586 0 0 0 52.096 45.22a64.716 64.716 0 0 0-43.23 31.36c-14.31 24.602-11.061 55.634 8.033 76.74a64.665 64.665 0 0 0 5.525 53.102c14.174 24.65 42.644 37.324 70.446 31.36a64.72 64.72 0 0 0 48.754 21.744c28.481.025 53.714-18.361 62.414-45.481a64.767 64.767 0 0 0 43.229-31.36c14.137-24.558 10.875-55.423-8.083-76.483Zm-97.56 136.338a48.397 48.397 0 0 1-31.105-11.255l1.535-.87 51.67-29.825a8.595 8.595 0 0 0 4.247-7.367v-72.85l21.845 12.636c.218.111.37.32.409.563v60.367c-.056 26.818-21.783 48.545-48.601 48.601Zm-104.466-44.61a48.345 48.345 0 0 1-5.781-32.589l1.534.921 51.722 29.826a8.339 8.339 0 0 0 8.441 0l63.181-36.425v25.221a.87.87 0 0 1-.358.665l-52.335 30.184c-23.257 13.398-52.97 5.431-66.404-17.803ZM23.549 85.38a48.499 48.499 0 0 1 25.58-21.333v61.39a8.288 8.288 0 0 0 4.195 7.316l62.874 36.272-21.845 12.636a.819.819 0 0 1-.767 0L41.353 151.53c-23.211-13.454-31.171-43.144-17.804-66.405v.256Zm179.466 41.695-63.08-36.63L161.73 77.86a.819.819 0 0 1 .768 0l52.233 30.184a48.6 48.6 0 0 1-7.316 87.635v-61.391a8.544 8.544 0 0 0-4.4-7.213Zm21.742-32.69-1.535-.922-51.619-30.081a8.39 8.39 0 0 0-8.492 0L99.98 99.808V74.587a.716.716 0 0 1 .307-.665l52.233-30.133a48.652 48.652 0 0 1 72.236 50.391v.205ZM88.061 139.097l-21.845-12.585a.87.87 0 0 1-.41-.614V65.685a48.652 48.652 0 0 1 79.757-37.346l-1.535.87-51.67 29.825a8.595 8.595 0 0 0-4.246 7.367l-.051 72.697Zm11.868-25.58 28.138-16.217 28.188 16.218v32.434l-28.086 16.218-28.188-16.218-.052-32.434Z"/>-</svg>\ No newline at end of filediff --git a/fern/assets/images/schema-modifier.png b/fern/assets/images/schema-modifier.pngdeleted file mode 100644index c977bd6cd..000000000Binary files a/fern/assets/images/schema-modifier.png and /dev/null differdiff --git a/fern/assets/images/setup-webhook.png b/fern/assets/images/setup-webhook.pngdeleted file mode 100644index 246c2b410..000000000Binary files a/fern/assets/images/setup-webhook.png and /dev/null differdiff --git a/fern/assets/images/tool-router/auth-config-custom-redirect.png b/fern/assets/images/tool-router/auth-config-custom-redirect.pngdeleted file mode 100644index da9a7a4df..000000000Binary files a/fern/assets/images/tool-router/auth-config-custom-redirect.png and /dev/null differdiff --git a/fern/assets/images/trigger-config.png b/fern/assets/images/trigger-config.pngdeleted file mode 100644index 2a07003d9..000000000Binary files a/fern/assets/images/trigger-config.png and /dev/null differdiff --git a/fern/assets/images/trigger-enable-disable.png b/fern/assets/images/trigger-enable-disable.pngdeleted file mode 100644index 6bb555c26..000000000Binary files a/fern/assets/images/trigger-enable-disable.png and /dev/null differdiff --git a/fern/assets/images/triggers.png b/fern/assets/images/triggers.pngdeleted file mode 100644index 4040c8b53..000000000Binary files a/fern/assets/images/triggers.png and /dev/null differdiff --git a/fern/assets/images/vercel-logo.svg b/fern/assets/images/vercel-logo.svgdeleted file mode 100644index d88fbc615..000000000--- a/fern/assets/images/vercel-logo.svg+++ /dev/null@@ -1,13 +0,0 @@-<svg viewBox="0 0 256 222" xmlns="http://www.w3.org/2000/svg" preserveAspectRatio="xMidYMid">- <style>- .logo-path {- fill: #000;- }- @media (prefers-color-scheme: dark) {- .logo-path {- fill: #fff;- }- }- </style>- <path class="logo-path" d="m128 0 128 221.705H0z"/>-</svg>\ No newline at end of filediff --git a/fern/assets/input.css b/fern/assets/input.cssdeleted file mode 100644index 507d08890..000000000--- a/fern/assets/input.css+++ /dev/null@@ -1,753 +0,0 @@-@tailwind components;-@tailwind utilities;--:root {- --space-xs: 12px;- --space-sm: 16px;- --space-md: 24px;- --space-lg: 32px;- --space-xl: 40px;- --page-padding-inline: var(--space-lg);- --section-gap: var(--space-xl);- --surface-background: #F7F4F0;- --accent-primary: #FF782F;- --sidebar-border-color: #d9d3c2;- --simple-card-bg-color: #f5f4f2;- --divider-border-color: #bdbdbd;- --radius-button: 6px;- --radius-card: 10px;- --radius-panel: 8px;- --radius-section: 16px;- --radius-pill: 999px;- --shadow-soft: 0 18px 40px rgba(15, 6, 2, 0.08);- --shadow-strong: 0 36px 80px rgba(15, 6, 2, 0.12);-}--.dark {- --surface-background: #0F0602;- --accent-primary: #FF9233;- --sidebar-border-color: #2c1b13;- --simple-card-bg-color: #1a1a1a;- --divider-border-color: #1a1a1a;-}--/* Sidebar layout alignment */-.fern-theme-default.fern-container {- background-color: var(--surface-background);-}--.fern-theme-default.fern-container .fern-header {- background-color: var(--surface-background);- border-bottom: 1px solid var(--divider-border-color);- padding: 0 var(--page-padding-inline);- min-height: 64px;- display: flex;- align-items: center;-}--.fern-theme-default.fern-container .fern-header-tabs {- background-color: var(--surface-background);- border-bottom: 1px solid var(--divider-border-color);- padding: 0 var(--page-padding-inline);-}--.fern-theme-default.fern-container .fern-sidebar-container {- border-right: 1px solid var(--sidebar-border-color);- background-color: var(--surface-background);-}--.fern-changelog>main {- width: 100%;-}--h1,-h2,-h3,-h4,-h5,-h6 {- font-weight: 400 !important;- font-family: Roobert !important;-}--h1 {- font-size: 35px !important;-}--h2 {- letter-spacing: -0.01em;- font-style: normal;- font-size: 24px !important;- line-height: 110%;-}--.fern-sidebar-heading-content {- font-weight: 500 !important;-}--.fern-header-tab-button .font-medium {- font-weight: 500 !important;-}--.fern-sidebar-heading-content {- font-weight: 500 !important;-}--.fern-header-tab-button .font-medium {- font-weight: 500 !important;-}--.fern-mdx-link {- font-weight: 400 !important;-}--.fern-announcement .fern-mdx-link, .fern-announcement svg.external-link-icon {- color: #fff !important;-}---.font-semibold {- font-weight: 500 !important;-}--.fern-api-property-key {- font-weight: 500 !important;-}--th {- font-weight: 500 !important;-}--@layer utilities {- .image-desktop {- @apply hidden md:block rounded-t-lg;- }-- .image-mobile {- @apply block md:hidden rounded-t-lg;- }-- .rounded-card {- border-radius: var(--radius-card);- }-- .rounded-panel {- border-radius: var(--radius-panel);- }-- .rounded-pill {- border-radius: var(--radius-pill);- }-- .shadow-soft {- box-shadow: var(--shadow-soft);- }-- .shadow-strong {- box-shadow: var(--shadow-strong);- }-}--/*! BEGIN STYLESHEET_HUB2 */-.flex-col-to-row {- flex-direction: column;-}--.flex-row-to-col {- flex-direction: row;-}--.w-100-to-50 {- max-width: 100%;-}--.w-100-to-75-to-50 {- max-width: 100%;-}--.h1-title {- font-family: Roobert !important;- letter-spacing: -0.01em;- font-style: normal;- font-weight: 400;- font-size: 35px !important;- line-height: 100%;-}--.h2-title {- font-family: Roobert !important;- letter-spacing: -0.01em;- font-style: normal;- font-weight: 400 !important;- font-size: 24px !important;- line-height: 110%;-}--.h3-title {- font-family: Roobert !important;- font-style: normal;- font-weight: 500;- font-size: 16.8px !important;- line-height: 124%;- margin-block-start: 1em !important;- margin-block-end: 1em !important;-}--.h4-title {- font-family: Roobert !important;- font-style: normal;- font-weight: 500;- font-size: 16px !important;- line-height: 150%;- margin-block-start: 1em !important;- margin-block-end: 1em !important;-}--.p-base {- font-family: Roobert !important;- font-style: normal;- font-weight: 400;- font-size: 14px !important;- line-height: 150%;- letter-spacing: 0.03em;-}--@media only screen and (min-width: 768px) {- .flex-col-to-row {- flex-direction: row;- }-- .flex-row-to-col {- flex-direction: column;- }-- .w-100-to-50 {- max-width: 45%;- }-- .w-100-to-75-to-50 {- max-width: 75%;- }-}--@media only screen and (min-width: 1024px) {- .w-100-to-75-to-50 {- max-width: 50%;- }-- .p-base {- font-size: 16px;- }-}--@media (max-width: 1024px) {- .fern-body {- gap: 0px !important;- }-}--/*! END STYLESHEET_HUB2 */--/*~~~~~~~~~GENERAL STYLES~~~~~~~~~~~*/-.grid-container-fluid {- margin: 0 !important;-}--#content-container {- max-width: 100% !important;-}--#content-head h1 {- display: none;-}--.page-title {- margin-bottom: var(--space-md) !important;-}--/* Mobile First Design */--.divider {- border: solid var(--divider-border-color);- border-width: 1px 0px 0px 0px;- margin-bottom: var(--section-gap);-}--.page-title-container {- display: flex;- flex-direction: column;- justify-content: start;- height: 100%;- padding-top: var(--section-gap);-}--.page-secondary-title-container {- margin-top: calc(var(--section-gap) + var(--space-xs));- margin-bottom: var(--space-lg);-}--.page-blurb {- width: 100%;-}--.all-cards-container {- padding-left: var(--space-sm);- padding-right: var(--space-sm);- padding-bottom: var(--section-gap);-}--.cards-container {- display: flex;- flex-direction: column;- gap: var(--space-md);-}--@layer components {- .small-tag-light {- display: flex;- flex-direction: row;- justify-content: center;- align-items: center;- padding: 4px 12px;- width: 90px;- height: 22px;- background: #ebebf8;- border: 1px solid rgba(43, 38, 73, 0.2);- border-radius: var(--radius-pill);- font-size: 10.5px;- color: #333293;- white-space: nowrap;- }-- .small-tag-dark {- display: flex;- flex-direction: row;- justify-content: center;- align-items: center;- padding: 4px 12px;- width: 72px;- height: 22px;- background: linear-gradient(0deg, rgba(0, 0, 0, 0.2), rgba(0, 0, 0, 0.2)),- #2b2649;- border: 1px solid rgba(46, 78, 74, 0.5);- border-radius: var(--radius-pill);- font-size: 10.5px;- color: #ebebf8;- white-space: nowrap;- }-}--.small-tag-container {- display: flex;- flex-direction: row;- gap: 12px;-}--.simple-card-container {- width: 100%;- display: flex;- flex-direction: column;- border: 1px solid var(--divider-border-color);- border-radius: var(--radius-card);-}--.simple-card-text-and-link-container {- background: var(--simple-card-bg-color);- border-top: 1px solid var(--divider-border-color);- border-radius: 0px 0px var(--radius-card) var(--radius-card);- flex-grow: 1;- display: flex;- flex-direction: column;-}--.simple-card-text-container {- display: flex;- flex-direction: column;- /* padding: 0px 24px 0px 24px; */- /* if there is a tag or time data exists on the card */- padding: 32px 24px 16px 24px;-}--.simple-card-link-container {- display: flex;- flex-direction: column;- padding: 14px 24px 17px 24px;- text-decoration: none;- margin-top: auto;-}--.toc-list {- display: flex;- flex-direction: column;- flex-wrap: wrap;-}--.toc-item {- padding: 8px 16px 8px 0px;- border-radius: var(--radius-card);- margin-right: 8px;- white-space: nowrap;-}--/* MD and above */-@media only screen and (min-width: 768px) {- .page-blurb {- width: 60%;- }-- .all-cards-container {- padding-left: 0px;- padding-right: 0px;- padding-bottom: 0px;- }-- .page-title-container {- min-height: 260px;- background-image: none !important;- height: auto;- padding-top: 0px;- justify-content: center;- }-- .page-secondary-title-container {- margin-top: 70px;- }-- .cards-container {- display: grid;- grid-template-columns: repeat(2, minmax(0, 1fr));- grid-auto-rows: auto;- gap: var(--section-gap);- }-- .p-title {- min-height: 72px;- }-- .simple-card-link-container {- padding-top: 0px;- }-- .toc-list {- flex-direction: row;- }-}--/* LG and higher */-@media only screen and (min-width: 1024px) {- .page-title-container {- padding-top: 0px;- }-- .page-blurb {- width: 50%;- }-- .cards-container {- display: grid;- grid-template-columns: repeat(3, minmax(0, 1fr));- grid-auto-rows: auto;- gap: var(--section-gap);- }-- .p-title {- min-height: 72px;- }-}--.header {- padding: 9px 0 17px 0;- display: flex;- flex-direction: column;-}--.fern-header .fern-button-text {- font-family: Roobert,Segoe UI,Roboto,Oxygen,Ubuntu,Cantarell,Open Sans,Helvetica Neue,sans-serif !important;- -webkit-font-smoothing: unset !important;-}--.fern-sidebar-content .fern-button-text {- font-family: Roobert,Segoe UI,Roboto,Oxygen,Ubuntu,Cantarell,Open Sans,Helvetica Neue,sans-serif !important;- -webkit-font-smoothing: unset !important;-}--#content {- padding: 0 var(--page-padding-inline);-}--#content-head {- display: none;-}--.guide-page-title {- font-size: 29px !important;-}--.back-button .github-button {- border-radius: 0 !important;- border-width: 0 !important;- background-color: inherit !important;-}--.cookbook-nav-container {- display: flex;- flex-direction: row;- justify-content: space-between;- align-items: center;-}--.authors-container {- display: flex;- flex-direction: row;- flex-flow: row wrap;- gap: 2px 14px;-}--.author-container:not(:is(.simple-card-container *)) {- margin-bottom: 10px;- margin-top: -10px;-}--.author-container:is(.simple-card-container *) {- margin-top: 20px;-}--.author-container {- line-height: 1.5em;- display: flex;- flex-direction: row;- vertical-align: middle;- flex-shrink: 0;-}--.author-image {- height: 1.5em;- margin: 0px 6px 6px 0px !important;- border-radius: 50%;-}--.author-name {- white-space: nowrap;- vertical-align: middle;-}--@media only screen and (min-width: 620px) {- .guide-page-title {- width: 70%;- }-- .header {- display: flex;- flex-direction: row;- align-items: center;- justify-content: space-between;- padding: 9px 0 17px 0;- }-- .git--button {- width: 145px !important;- display: flex;- flex-direction: row;- justify-content: center;- align-items: center;- padding: 8px 16px;-- width: 154px;- height: 35px;-- background: #d4d9d4;- border: 1px solid #9daaa4;- border-radius: var(--radius-button);- }-}--@media only screen and (min-width: 1024px) {- .guide-page-title {- font-size: 46px !important;- }-- .header {- padding: 9px 0 32px 0;- }-}--.side {- width: 40% !important;- float: right !important;- margin-left: .75rem !important;-}--.light-bg {- background-color: #f7f7f7 !important;- border-color: #e0e0e0 !important;- border-radius: var(--radius-panel) !important;- border-width: 1px !important;- padding: 15px !important;-}--.dark-text {- color: #1a1a1a !important;-}--.dataframe {- display: block !important;- overflow: auto !important;- border-color: #e0e0e0 !important;- border-radius: var(--radius-panel) !important;- border-width: 1px !important;-}--:is(.dark) .dataframe {- border-color: #ffffff22 !important;-}--.fern-table td {- max-width: 400px !important;- overflow: wrap !important;-}--.fern-table th {- max-width: 400px !important;- overflow: wrap !important;-}--.orange-text {- color: #e69138 !important;- white-space : pre-wrap !important;-}-.dark-orange-text{- color: #b45f06 !important;-}-.dark-red-text {- color: #a20302 !important;- white-space : pre-wrap !important;-}-.red-text {- color: #cc0100 !important;-}-.bloody-red-text {- color: #a31515 !important;-}-.dark-pink-text {- color: #b80672 !important;-}-.magenta-text {- color: #cc669f !important;- white-space : pre-wrap !important;-}-.dark-magenta-text {- color: #78345a !important;-}-.sangria-text {- color: #981ea0 !important;-}-.dark-sangria-text {- color: #6b1570 !important;-}-.brown-text {- color: #5b0f00 !important;-}-.green-text {- color: #6aa84f !important;- white-space : pre-wrap !important;-}-.grass-green-text {- color: #38761d !important;-}-.dark-green-text {- color: #284e13 !important;-}-.quartz-text {- color: #a64d79 !important;-}-.blue-text {- color: #4078f2 !important;-}-.dark-blue-text {- color: #1255cc !important;-}-.purple-text {- color: #674ea7 !important;-}-.dark-purple-text {- color: #361c75 !important;-}-.markdown-body code {- color: inherit !important;-}-.cm-s-neo .cm-keyword {- color: inherit !important;-}-.cm-s-neo .cm-variable {- color: inherit !important;-}-.cm-s-neo .cm-string {- color: inherit !important;-}-.cm-s-neo .cm-property {- color: inherit !important;-}-.theme-light {- color: #cc669f !important;-}-.override {- line-height:100% !important;-}-.yellow-highlight{- background-color: yellow !important;- display: inline-block !important;- width: 100px !important; /* Adjust the width as needed */- /*height: 20px !important;*/ /* Adjust the height as needed */-}--.extra-yellow {- color: #a31515 !important;- background-color: #ffff00 !important;-}--.extra-green {- color: #38761d !important;-}--/*- This is hacky fix for the code block comment color-*/-.code-block-line-content span[style*="color: rgb(194, 195, 197)"] {- color: rgb(155, 156, 158) !important;-}--:is(.dark) .simple-card-container {- --divider-border-color: #2c2c2c;-}--.fern-header .fern-button.minimal {- font-weight: 500 !important;-}--.fern-header .fern-button.minimal:hover,-.fern-header .fern-button.minimal:focus-visible {- background-color: rgba(30, 27, 22, 0.08);-}--.dark .fern-header .fern-button.minimal:hover,-.dark .fern-header .fern-button.minimal:focus-visible {- background-color: rgba(247, 244, 240, 0.08);-}--.fern-header-actions {- display: flex;- align-items: center;- gap: var(--space-sm);-}--.fern-header .fern-button.minimal {- color: var(--accent-primary) !important;- font-weight: 500 !important;- padding: 0 !important;- text-decoration: underline;- text-decoration-color: rgba(255, 120, 47, 0.4);-}--.dark .fern-header .fern-button.minimal[href*="platform.composio.dev"] {- color: var(--accent-primary) !important;-}\ No newline at end of filediff --git a/fern/assets/logo-dark.svg b/fern/assets/logo-dark.svgdeleted file mode 100644index 61ce70792..000000000--- a/fern/assets/logo-dark.svg+++ /dev/null@@ -1,19 +0,0 @@-<svg width="677" height="123" viewBox="0 0 677 123" fill="none" xmlns="http://www.w3.org/2000/svg">-<g clip-path="url(#clip0_2_396)">-<path d="M102.18 33.85L34.5023 20.0087C30.0648 19.0977 25.8918 22.5065 25.8918 27.0322V59.0936V60.798V92.859C25.8918 97.3847 30.0648 100.794 34.5023 99.8829L102.18 86.0415" stroke="white" stroke-width="3.43015" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>-<path d="M49.9235 8.87123C49.9237 2.51319 56.4226 -1.73892 62.2423 0.695182L62.5192 0.816015L62.5254 0.819543L98.7302 17.5403C101.908 18.9726 103.899 22.1461 103.9 25.592V39.7567C103.9 44.9242 99.4988 49.0053 94.3571 48.6075L53.3536 45.5471V74.344L94.3508 71.2834L94.8313 71.2588C99.7553 71.1388 103.898 75.1151 103.869 80.1051V94.2698C103.869 97.7424 101.825 100.869 98.7059 102.32L98.7004 102.321L62.5263 119.012L62.5272 119.013C56.6282 121.743 49.9235 117.443 49.9235 110.962V97.4634C49.6577 97.5681 49.3731 97.6377 49.0742 97.6594L29.0653 99.0999C27.3934 99.22 25.9707 97.8951 25.9704 96.2188V81.3638C25.9705 80.7879 26.1425 80.2477 26.4379 79.7929L9.97728 81.0225H9.97114C4.84357 81.386 0.435072 77.3177 0.435059 72.1708V47.7202C0.435428 42.5512 4.83999 38.4682 9.98351 38.8695H9.98261L26.079 40.0708C26.0092 39.8222 25.9705 39.5609 25.9704 39.2911V23.6428C25.9704 21.3581 28.0142 19.6154 30.2702 19.9764L49.3229 23.0246C49.5323 23.0581 49.7328 23.1153 49.9235 23.1903V8.87123ZM94.6182 74.7039H94.6118L53.3536 77.7837V95.6878L100.44 85.8461V80.0928L100.435 79.8018C100.294 76.8093 97.6708 74.4657 94.6182 74.7039ZM25.3089 43.4532C25.5967 43.9033 25.7639 44.4367 25.764 45.0063V75.413C25.764 75.7655 25.6979 76.1031 25.5815 76.4166L49.9235 74.5998V45.2904L25.3089 43.4532ZM53.3536 42.1073L94.6118 45.1872L94.6182 45.1881L94.9108 45.2031C97.9282 45.2766 100.47 42.8343 100.47 39.7567V33.8024L53.3536 23.9533V42.1073Z" fill="white"/>-</g>-<path d="M645.482 102.441C626.178 102.441 614.085 89.4608 614.085 71.044C614.085 52.5164 626.178 39.5359 645.482 39.5359C664.787 39.5359 676.88 52.5164 676.88 71.044C676.88 89.4608 664.787 102.441 645.482 102.441ZM645.482 90.903C654.691 90.903 659.572 83.2479 659.572 71.044C659.572 58.7292 654.691 51.0741 645.482 51.0741C636.274 51.0741 631.392 58.7292 631.392 71.044C631.392 83.2479 636.274 90.903 645.482 90.903Z" fill="white"/>-<path d="M607.739 32.7689H590.21V16.793H607.739V32.7689ZM607.407 101.111H590.432V40.8678H607.407V101.111Z" fill="white"/>-<path d="M555.782 102.441C540.915 102.441 529.821 96.1174 527.713 82.9151H544.799C546.019 89.017 551.122 90.903 556.448 90.903C563.881 90.903 567.875 88.4623 567.875 84.5792C567.875 80.9181 565.434 79.1429 557.224 77.2569L546.574 74.9271C535.146 72.4863 528.934 67.161 528.934 58.1745C528.934 46.7473 540.694 39.5359 555.116 39.5359C568.762 39.5359 580.19 45.194 582.852 56.8432H565.767C564.436 53.0711 560.109 51.0741 555.227 51.0741C549.791 51.0741 545.131 53.0711 545.131 56.8432C545.131 60.2824 548.571 61.6138 554.783 62.9451L565.434 65.2749C578.082 68.0485 584.073 73.4848 584.073 83.2479C584.073 95.5627 571.869 102.441 555.782 102.441Z" fill="white"/>-<path d="M493.572 102.441C474.268 102.441 462.175 89.4608 462.175 71.044C462.175 52.5164 474.268 39.5359 493.572 39.5359C512.877 39.5359 524.969 52.5164 524.969 71.044C524.969 89.4608 512.877 102.441 493.572 102.441ZM493.572 90.903C502.781 90.903 507.662 83.2479 507.662 71.044C507.662 58.7292 502.781 51.0741 493.572 51.0741C484.364 51.0741 479.482 58.7292 479.482 71.044C479.482 83.2479 484.364 90.903 493.572 90.903Z" fill="white"/>-<path d="M433.747 39.5359C448.613 39.5359 458.598 52.9601 458.598 71.044C458.598 89.1279 448.613 102.441 433.747 102.441C424.427 102.441 416.994 96.7831 413.777 89.017V122.855H396.913V40.8672H413.777V54.4024C416.44 46.5254 423.207 39.5359 433.747 39.5359ZM427.201 90.903C436.409 90.903 441.291 83.2479 441.291 71.044C441.291 58.7292 436.409 51.0741 427.201 51.0741C417.993 51.0741 413.111 58.7292 413.111 71.044C413.111 83.2479 417.993 90.903 427.201 90.903Z" fill="white"/>-<path d="M368.273 39.5359C381.808 39.5359 387.577 49.4099 387.577 62.9451V63.167V101.11H370.603V66.8281V66.6063C370.603 56.1775 367.386 51.4069 360.396 51.4069C353.407 51.4069 350.078 56.1775 350.078 66.8281V101.11H333.104V66.8281V66.6063C333.104 56.1775 329.886 51.4069 322.897 51.4069C315.908 51.4069 312.579 56.1775 312.579 66.8281V101.11H295.605V40.8672H312.468V53.182C315.353 45.7488 320.789 39.5359 330.996 39.5359C341.425 39.5359 347.194 46.5254 349.302 54.1805C351.964 46.8582 357.733 39.5359 368.273 39.5359Z" fill="white"/>-<path d="M257.697 102.441C238.393 102.441 226.3 89.4608 226.3 71.044C226.3 52.5164 238.393 39.5359 257.697 39.5359C277.002 39.5359 289.094 52.5164 289.094 71.044C289.094 89.4608 277.002 102.441 257.697 102.441ZM257.697 90.903C266.906 90.903 271.787 83.2479 271.787 71.044C271.787 58.7292 266.906 51.0741 257.697 51.0741C248.489 51.0741 243.607 58.7292 243.607 71.044C243.607 83.2479 248.489 90.903 257.697 90.903Z" fill="white"/>-<path d="M183.931 102.443C160.633 102.443 142.771 85.801 142.771 58.9525C142.771 32.215 160.522 15.4624 184.042 15.4624C204.012 15.4624 219.322 26.6678 223.76 45.5283H205.454C202.237 36.4308 195.802 29.3304 184.042 29.3304C170.063 29.3304 160.855 40.9796 160.855 58.9525C160.855 77.0364 170.396 88.5746 184.042 88.5746C195.136 88.5746 202.57 82.6946 206.009 72.1549H224.315C218.768 93.0124 203.568 102.443 183.931 102.443Z" fill="white"/>-<defs>-<clipPath id="clip0_2_396">-<rect width="103.863" height="120.12" fill="white" transform="translate(0.435059)"/>-</clipPath>-</defs>-</svg>diff --git a/fern/assets/logo.svg b/fern/assets/logo.svgdeleted file mode 100644index 379cb8669..000000000--- a/fern/assets/logo.svg+++ /dev/null@@ -1,19 +0,0 @@-<svg width="677" height="123" viewBox="0 0 677 123" fill="none" xmlns="http://www.w3.org/2000/svg">-<g clip-path="url(#clip0_2_368)">-<path d="M101.745 33.85L34.0672 20.0087C29.6297 19.0977 25.4568 22.5065 25.4568 27.0322V59.0936V60.798V92.859C25.4568 97.3847 29.6297 100.794 34.0672 99.8829L101.745 86.0415" stroke="black" stroke-width="3.43015" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>-<path d="M49.4884 8.87123C49.4886 2.51319 55.9876 -1.73892 61.8072 0.695182L62.0842 0.816015L62.0903 0.819543L98.2952 17.5403C101.472 18.9726 103.464 22.1461 103.465 25.592V39.7567C103.465 44.9242 99.0638 49.0053 93.9221 48.6075L52.9185 45.5471V74.344L93.9158 71.2834L94.3962 71.2588C99.3203 71.1388 103.463 75.1151 103.434 80.1051V94.2698C103.434 97.7424 101.39 100.869 98.2708 102.32L98.2654 102.321L62.0912 119.012L62.0921 119.013C56.1931 121.743 49.4884 117.443 49.4884 110.962V97.4634C49.2226 97.5681 48.9381 97.6377 48.6391 97.6594L28.6303 99.0999C26.9584 99.22 25.5356 97.8951 25.5353 96.2188V81.3638C25.5354 80.7879 25.7074 80.2477 26.0028 79.7929L9.54222 81.0225H9.53608C4.40851 81.386 1.332e-05 77.3177 0 72.1708V47.7202C0.000369179 42.5512 4.40493 38.4682 9.54846 38.8695H9.54755L25.6439 40.0708C25.5742 39.8222 25.5354 39.5609 25.5353 39.2911V23.6428C25.5353 21.3581 27.5792 19.6154 29.8351 19.9764L48.8878 23.0246C49.0973 23.0581 49.2977 23.1153 49.4884 23.1903V8.87123ZM94.1831 74.7039H94.1768L52.9185 77.7837V95.6878L100.005 85.8461V80.0928L99.9994 79.8018C99.8586 76.8093 97.2358 74.4657 94.1831 74.7039ZM24.8739 43.4532C25.1616 43.9033 25.3289 44.4367 25.329 45.0063V75.413C25.329 75.7655 25.2629 76.1031 25.1464 76.4166L49.4884 74.5998V45.2904L24.8739 43.4532ZM52.9185 42.1073L94.1768 45.1872L94.1831 45.1881L94.4757 45.2031C97.4932 45.2766 100.035 42.8343 100.035 39.7567V33.8024L52.9185 23.9533V42.1073Z" fill="black"/>-</g>-<path d="M645.048 102.086C625.743 102.086 613.65 89.1053 613.65 70.6886C613.65 52.1609 625.743 39.1804 645.048 39.1804C664.352 39.1804 676.445 52.1609 676.445 70.6886C676.445 89.1053 664.352 102.086 645.048 102.086ZM645.048 90.5476C654.256 90.5476 659.138 82.8924 659.138 70.6886C659.138 58.3738 654.256 50.7186 645.048 50.7186C635.839 50.7186 630.958 58.3738 630.958 70.6886C630.958 82.8924 635.839 90.5476 645.048 90.5476Z" fill="black"/>-<path d="M607.305 32.4135H589.775V16.4375H607.305V32.4135ZM606.972 100.755H589.997V40.5124H606.972V100.755Z" fill="black"/>-<path d="M555.346 102.086C540.48 102.086 529.386 95.7619 527.278 82.5596H544.363C545.583 88.6615 550.687 90.5476 556.012 90.5476C563.445 90.5476 567.439 88.1068 567.439 84.2238C567.439 80.5626 564.999 78.7875 556.789 76.9014L546.138 74.5716C534.711 72.1308 528.498 66.8055 528.498 57.819C528.498 46.3918 540.258 39.1804 554.681 39.1804C568.327 39.1804 579.754 44.8386 582.417 56.4877H565.331C564 52.7156 559.673 50.7186 554.792 50.7186C549.355 50.7186 544.696 52.7156 544.696 56.4877C544.696 59.927 548.135 61.2583 554.348 62.5896L564.999 64.9195C577.646 67.6931 583.637 73.1293 583.637 82.8924C583.637 95.2072 571.433 102.086 555.346 102.086Z" fill="black"/>-<path d="M493.137 102.086C473.833 102.086 461.74 89.1053 461.74 70.6886C461.74 52.1609 473.833 39.1804 493.137 39.1804C512.441 39.1804 524.534 52.1609 524.534 70.6886C524.534 89.1053 512.441 102.086 493.137 102.086ZM493.137 90.5476C502.346 90.5476 507.227 82.8924 507.227 70.6886C507.227 58.3738 502.346 50.7186 493.137 50.7186C483.929 50.7186 479.047 58.3738 479.047 70.6886C479.047 82.8924 483.929 90.5476 493.137 90.5476Z" fill="black"/>-<path d="M433.312 39.1804C448.178 39.1804 458.163 52.6047 458.163 70.6886C458.163 88.7725 448.178 102.086 433.312 102.086C423.992 102.086 416.559 96.4276 413.342 88.6615V122.499H396.478V40.5117H413.342V54.0469C416.004 46.1699 422.772 39.1804 433.312 39.1804ZM426.766 90.5476C435.974 90.5476 440.856 82.8924 440.856 70.6886C440.856 58.3738 435.974 50.7186 426.766 50.7186C417.558 50.7186 412.676 58.3738 412.676 70.6886C412.676 82.8924 417.558 90.5476 426.766 90.5476Z" fill="black"/>-<path d="M367.839 39.1804C381.374 39.1804 387.143 49.0544 387.143 62.5896V62.8115V100.754H370.168V66.4727V66.2508C370.168 55.822 366.951 51.0514 359.962 51.0514C352.972 51.0514 349.644 55.822 349.644 66.4727V100.754H332.669V66.4727V66.2508C332.669 55.822 329.452 51.0514 322.462 51.0514C315.473 51.0514 312.145 55.822 312.145 66.4727V100.754H295.17V40.5117H312.034V52.8265C314.918 45.3933 320.354 39.1804 330.561 39.1804C340.99 39.1804 346.759 46.1699 348.867 53.825C351.53 46.5027 357.299 39.1804 367.839 39.1804Z" fill="black"/>-<path d="M257.262 102.086C237.958 102.086 225.865 89.1053 225.865 70.6886C225.865 52.1609 237.958 39.1804 257.262 39.1804C276.566 39.1804 288.659 52.1609 288.659 70.6886C288.659 89.1053 276.566 102.086 257.262 102.086ZM257.262 90.5476C266.47 90.5476 271.352 82.8924 271.352 70.6886C271.352 58.3738 266.47 50.7186 257.262 50.7186C248.054 50.7186 243.172 58.3738 243.172 70.6886C243.172 82.8924 248.054 90.5476 257.262 90.5476Z" fill="black"/>-<path d="M183.496 102.087C160.198 102.087 142.336 85.4455 142.336 58.597C142.336 31.8595 160.087 15.1069 183.607 15.1069C203.577 15.1069 218.887 26.3123 223.325 45.1728H205.019C201.802 36.0754 195.367 28.975 183.607 28.975C169.628 28.975 160.42 40.6241 160.42 58.597C160.42 76.6809 169.961 88.2191 183.607 88.2191C194.701 88.2191 202.135 82.3391 205.574 71.7994H223.88C218.332 92.6569 203.133 102.087 183.496 102.087Z" fill="black"/>-<defs>-<clipPath id="clip0_2_368">-<rect width="103.863" height="120.12" fill="white"/>-</clipPath>-</defs>-</svg>diff --git a/fern/assets/videos/enabling-triggers.mp4 b/fern/assets/videos/enabling-triggers.mp4deleted file mode 100644index 7a9f089f5..000000000Binary files a/fern/assets/videos/enabling-triggers.mp4 and /dev/null differdiff --git a/fern/components/authors-container.tsx b/fern/components/authors-container.tsxdeleted file mode 100644index f81273f71..000000000--- a/fern/components/authors-container.tsx+++ /dev/null@@ -1,21 +0,0 @@-export interface Author {- name: string;- imageSrc: string;-}--export const AuthorsContainer = ({ authors }: { authors: Author[] }) => {- return (- <div className="authors-container">- {authors.map((author, i) => (- <div className="author-container" key={i}>- <img- className="author-image"- src={author.imageSrc}- alt={author.name}- />- <span className="author-name">{author.name}</span>- </div>- ))}- </div>- );-};diff --git a/fern/components/cards-container.tsx b/fern/components/cards-container.tsxdeleted file mode 100644index 250f85351..000000000--- a/fern/components/cards-container.tsx+++ /dev/null@@ -1,15 +0,0 @@-import { SimpleCard, SimpleCardProps } from "./simple-card";--export interface CardsContainerProps {- cards: SimpleCardProps[];-}--export function CardsContainer({ cards }: CardsContainerProps) {- return (- <div className="cards-container">- {cards.map((card, index) => (- <SimpleCard key={index} {...card} />- ))}- </div>- );-}diff --git a/fern/components/cookbook-header.tsx b/fern/components/cookbook-header.tsxdeleted file mode 100644index 5bbc2422d..000000000--- a/fern/components/cookbook-header.tsx+++ /dev/null@@ -1,75 +0,0 @@-export const CookbookHeader = ({ href }: { href: string }) => {- return (- <div className="cookbook-nav-container">- <a- href="/page/cookbooks"- className="back-button group inline-block cursor-pointer font-medium "- rel="noreferrer"- target="_self"- >- <div className="pr-1 inline-block group-hover:no-underline">- <svg- width="11.8"- height="11"- viewBox="0 0 14 13"- fill="none"- xmlns="http://www.w3.org/2000/svg"- >- <path- d="M1.1554 7.20808C1.35066 7.40335 1.66724 7.40335 1.8625 7.20808L7.18477 1.88582C7.38003 1.69055 7.38003 1.37397 7.18477 1.17871L6.83121 0.825157C6.63595 0.629895 6.31937 0.629896 6.12411 0.825157L0.801842 6.14742C0.60658 6.34269 0.60658 6.65927 0.801842 6.85453L1.1554 7.20808Z"- fill="currentColor"- />- <path- d="M1.1554 5.79226C1.35066 5.597 1.66724 5.597 1.8625 5.79226L7.18477 11.1145C7.38003 11.3098 7.38003 11.6264 7.18477 11.8216L6.83121 12.1752C6.63595 12.3705 6.31937 12.3705 6.12411 12.1752L0.801842 6.85292C0.60658 6.65766 0.60658 6.34108 0.801842 6.14582L1.1554 5.79226Z"- fill="currentColor"- />- <path- d="M2.52491 6.23674C2.52492 5.9606 2.74878 5.73675 3.02491 5.73675H6.28412C6.4513 5.73675 6.60742 5.8203 6.70015 5.95941L7.03347 6.45941C7.25499 6.79169 7.01679 7.23675 6.61745 7.23675H3.0249C2.74876 7.23675 2.5249 7.01289 2.5249 6.73674L2.52491 6.23674Z"- fill="currentColor"- />- <path- d="M13.5517 6.73676C13.5517 7.0129 13.3278 7.23675 13.0517 7.23675H8.79246C8.62528 7.23675 8.46916 7.1532 8.37643 7.0141L8.04311 6.5141C7.8216 6.18182 8.05979 5.73675 8.45914 5.73675H13.0517C13.3278 5.73675 13.5517 5.96062 13.5517 6.23676L13.5517 6.73676Z"- fill="currentColor"- />- </svg>- </div>- Back to Cookbooks- </a>-- <a- href={href}- className="github-button group inline-block cursor-pointer font-medium "- rel="noreferrer"- target="_blank"- >- Open in GitHub- <div className="pl-1 inline-block group-hover:no-underline">- <svg- width="14"- height="10"- viewBox="0 0 14 10"- fill="none"- xmlns="http://www.w3.org/2000/svg"- >- <path- d="M8.63218 0.366821C8.35604 0.366821 8.13218 0.590679 8.13218 0.866821V8.39364C8.13218 8.66978 8.35604 8.89364 8.63218 8.89364H9.13218C9.40832 8.89364 9.63218 8.66978 9.63218 8.39364V0.866821C9.63218 0.590678 9.40832 0.366821 9.13218 0.366821H8.63218Z"- fill="currentColor"- />- <path- d="M9.63332 1.36796C9.63332 1.6441 9.40946 1.86796 9.13332 1.86796H1.6065C1.33035 1.86796 1.1065 1.6441 1.1065 1.36796V0.867956C1.1065 0.591813 1.33035 0.367956 1.6065 0.367956H9.13332C9.40946 0.367956 9.63332 0.591813 9.63332 0.867956V1.36796Z"- fill="currentColor"- />- <path- d="M8.35063 2.02206C8.54588 2.21732 8.54588 2.5339 8.35062 2.72916L6.04601 5.03377C5.9278 5.15198 5.75833 5.20329 5.59439 5.1705L5.00515 5.05264C4.61356 4.97432 4.46728 4.49118 4.74966 4.2088L7.28997 1.66849C7.48523 1.47323 7.80182 1.47323 7.99708 1.6685L8.35063 2.02206Z"- fill="currentColor"- />- <path- d="M0.199967 9.46558C0.0047119 9.27032 0.0047151 8.95374 0.199974 8.75848L3.21169 5.74677C3.3299 5.62855 3.49938 5.57724 3.66331 5.61003L4.25256 5.72789C4.64414 5.80621 4.79042 6.28935 4.50804 6.57173L1.26063 9.81915C1.06536 10.0144 0.748774 10.0144 0.553513 9.81914L0.199967 9.46558Z"- fill="currentColor"- />- </svg>- </div>- </a>- </div>- );-};diff --git a/fern/components/secondary-title-container.tsx b/fern/components/secondary-title-container.tsxdeleted file mode 100644index 312c2f5dd..000000000--- a/fern/components/secondary-title-container.tsx+++ /dev/null@@ -1,24 +0,0 @@-import { PropsWithChildren } from "react";--interface SecondaryTitleContainerProps {- id?: string;- title: string;- description: string;-}--export function SecondaryTitleContainer({- id,- title,- description,- children,-}: PropsWithChildren<SecondaryTitleContainerProps>) {- return (- <div className="page-secondary-title-container">- <h2 id={id} className="h2-title page-title mb-6">- {title}- </h2>- <p className="p-base page-blurb mb-6">{description}</p>- {children}- </div>- );-}diff --git a/fern/components/simple-card.tsx b/fern/components/simple-card.tsxdeleted file mode 100644index 709530e17..000000000--- a/fern/components/simple-card.tsx+++ /dev/null@@ -1,60 +0,0 @@-import { ReactElement } from "react";-import ArrowRightIcon from "../icons/arrow-right";-import { type Author, AuthorsContainer } from "./authors-container";--export interface SimpleCardProps {- title: string;- description: string;- imageSrc: string;- tags: string[];- href: string;- authors?: Author[];-}--export function SimpleCard({- title,- description,- imageSrc,- tags,- href,- authors,-}: SimpleCardProps): ReactElement {- return (- <div className="simple-card-container">- <a- href={href}- target="_blank"- className="flex flex-1 flex-col justify-stretch"- >- <img className="image-desktop w-full" src={imageSrc} />- <img className="image-mobile w-full" src={imageSrc} />- <div className="simple-card-text-and-link-container">- <div className="simple-card-text-container">- <div className="small-tag-container">- {tags.map((tag, idx) => (- <span key={idx} className="small-tag-light dark:small-tag-dark">- {tag}- </span>- ))}- </div>- <p className="h4-title simple-card-title">{title}</p>- <p className="p-title">{description}</p>- {authors != null && authors.length > 0 && (- <AuthorsContainer authors={authors} />- )}- </div>- <div className="simple-card-link-container">- <div className="flex items-center">- <span className="group inline-block cursor-pointer font-medium text-[#39594D] dark:text-[#517B6A] hover:text-black dark:hover:text-white">- Build this- <span className="ml-2 inline-block group-hover:no-underline">- <ArrowRightIcon />- </span>- </span>- </div>- </div>- </div>- </a>- </div>- );-}diff --git a/fern/custom.js b/fern/custom.jsdeleted file mode 100644index 60ce0dd47..000000000--- a/fern/custom.js+++ /dev/null@@ -1,9 +0,0 @@-// Decimal chat widget-(function() {- var s = document.createElement('script');- s.src = 'https://app.getdecimal.ai/widget/v1/widget.js';- s.setAttribute('data-widget-id', 'wgt_Ze0kCx97w7YXIydXpEAbAVWfu7FO6HG1');- s.setAttribute('data-public-config', 'eyJhbGciOiJIUzI1NiJ9.eyJ3aWQiOiJ3Z3RfWmUwa0N4OTd3N1lYSXlkWHBFQWJBVldmdTdGTzZIRzEiLCJkb21haW5zIjpbImNvbXBvc2lvLmRldiIsImNvbXBvc2lvLWRlY2ltYWwudmVyY2VsLmFwcCIsImxvY2FsaG9zdDozMDAwIiwiZG9jcy5jb21wb3Npby5kZXYiXSwiaWF0IjoxNzY3Mzc2ODkyfQ.Aflg_XVLCmd2tY9P9h4YWle2FKA_DRZFLBhp0yClJCE');- s.async = true;- document.head.appendChild(s);-})();\ No newline at end of filediff --git a/fern/docs.yml b/fern/docs.ymldeleted file mode 100644index dbcbe146c..000000000--- a/fern/docs.yml+++ /dev/null@@ -1,492 +0,0 @@-instances:-- url: v3composio.docs.buildwithfern.com- custom-domain: docs.composio.dev-title: Composio Docs-default-language: python-logo:- light: assets/logo.svg- dark: assets/logo-dark.svg- height: 16- href: /-favicon: assets/favicon.png-typography:- bodyFont:- name: Inter- paths:- - path: assets/Inter-Medium.woff2- weight: '500'- headingsFont:- name: Inter- paths:- - path: assets/Inter-Medium.woff2- weight: '500'- codeFont:- name: IBM Plex Mono- paths:- - path: assets/IBMPlexMono-Light.ttf- weight: '400'-navbar-links:-- type: minimal- text: Status- url: https://status.composio.dev/-- type: outlined- text: Dashboard- rightIcon: fa-light fa-arrow-up-right- url: https://platform.composio.dev/auth-layout:- page-width: full- content-width: 60rem- tabs-placement: header- searchbar-placement: header- header-height: 64px- sidebar-width: 255px-settings:- hide-404-page: true- http-snippets: true-js:- - path: ./custom.js-colors:- accent-primary:- light: '#FF782F'- dark: '#FF9233'- background:- light: '#F7F4F0'- dark: '#0F0602'- sidebar-background:- light: '#F7F4F0'- dark: '#0F0602'- header-background:- light: '#F7F4F0'- dark: '#0F0602'-analytics:- posthog:- api-key: ${POSTHOG_API_KEY}-redirects:-- source: /tools/:path- destination: /toolkits/:path-- source: /changelog- destination: /docs/changelog-- source: /changelog/:date- destination: /docs/changelog/:date-- source: /sdk-reference/python- destination: /python-- source: /sdk-reference/python/:path- destination: /python/:path-- source: /sdk-reference/type-script- destination: /type-script-- source: /sdk-reference/type-script/:path- destination: /type-script/:path-- source: /docs/tool-router/quick-start- destination: /docs/tool-router/quick-start-deprecated-tabs:- docs:- display-name: Docs- slug: docs- tool-router:- display-name: Tool Router- icon: fa-light fa-sparkles- slug: tool-router- providers:- display-name: Providers- skip-slug: true- toolkits:- display-name: Toolkits- skip-slug: true- api-reference:- display-name: API Reference- skip-slug: true- examples:- display-name: Examples- skip-slug: true-navigation:-- tab: docs- layout:- - section: Get Started- icon: fa-light fa-rocket- skip-slug: true- contents:- - page: Welcome- path: pages/dist/get-started/welcome.mdx- slug: welcome- - page: Quickstart- path: pages/dist/get-started/quickstart.mdx- slug: quickstart- - page: IDE and Agent Setup- path: pages/dist/get-started/dev-setup.mdx- slug: dev-setup- - page: Providers- path: pages/dist/get-started/providers.mdx- slug: providers- - changelog: ./pages/src/changelog- title: Changelog- slug: changelog- - section: Capabilities- icon: fa-light fa-layer-group- skip-slug: true- contents:- - link: Tool Router- href: /tool-router/overview- - page: Managed Authentication- path: pages/dist/capabilities/managed-authentication.mdx- slug: managed-authentication- - page: Tools- path: pages/dist/capabilities/tools.mdx- slug: tools- - page: MCP- path: pages/dist/capabilities/mcp.mdx- slug: mcp- - page: Triggers- path: pages/dist/capabilities/triggers.mdx- slug: triggers- - section: Tools and Triggers- icon: fa-light fa-wrench- skip-slug: true- contents:- - page: Fetching tools and schemas- path: pages/dist/tools-and-triggers/fetching-tools.mdx- slug: fetching-tools- - page: Authenticating Tools- path: pages/dist/tools-and-triggers/authenticating-tools.mdx- slug: authenticating-tools- - page: Executing Tools- path: pages/dist/tools-and-triggers/executing-tools.mdx- slug: executing-tools- - page: Using Triggers- path: pages/dist/tools-and-triggers/using-triggers.mdx- slug: using-triggers- - section: Modify tool behavior- slug: tools/modify- contents:- - page: Modifying tool schemas- path: pages/dist/tools-and-triggers/schema-modifiers.mdx- slug: modifying-tool-schemas- - page: Modifying tool inputs- path: pages/dist/tools-and-triggers/before-execution-modifiers.mdx- slug: modifying-tool-inputs- - page: Modifying tool outputs- path: pages/dist/tools-and-triggers/after-execution-modifiers.mdx- slug: modifying-tool-outputs- - page: Custom tools- path: pages/dist/tools-and-triggers/custom-tools.mdx- slug: custom-tools- - page: Toolkit Versioning- path: pages/dist/tools-and-triggers/toolkit-versioning.mdx- slug: toolkit-versioning- - section: Authentication- icon: fa-light fa-key- skip-slug: true- contents:- - page: Custom Auth Configs- path: pages/dist/authentication/custom-auth-configs.mdx- slug: custom-auth-configs- - page: Programmatic Auth Configs- path: pages/dist/authentication/programmatic-auth-configs.mdx- slug: programmatic-auth-configs- - page: Custom Auth Parameters- path: pages/dist/authentication/custom-auth-params.mdx- slug: custom-auth-params- - page: Connected Accounts- path: pages/dist/authentication/connected-accounts.mdx- slug: connected-accounts- - page: User Management- path: pages/dist/authentication/user-management.mdx- slug: user-management- - section: MCP- icon: fa-light fa-database- skip-slug: true- contents:- - page: Quickstart- path: pages/dist/mcp/quickstart.mdx- slug: mcp-quickstart- - page: Server management- path: pages/dist/mcp/server-management.mdx- slug: mcp-server-management- - page: Providers- path: pages/dist/mcp/providers.mdx- slug: mcp-providers- - section: Tool Router (Beta)- icon: fa-light fa-flask- skip-slug: true- hidden: true- contents:- - page: Quick Start (Deprecated)- path: pages/dist/tool-router/quick-start-deprecated.mdx- slug: tool-router/quick-start-deprecated- hidden: true- - section: Resources- icon: fa-light fa-book- skip-slug: true- contents:- - page: CLI- path: pages/dist/resources/cli.mdx- slug: cli- - page: Debugging Info- path: pages/dist/resources/debugging-info.mdx- slug: resources/debugging-info- - section: Migration Guides- slug: migration-guide- contents:- - page: Overview- path: pages/dist/migration-guide/index.mdx- slug: overview- - page: New SDK Migration- path: pages/dist/migration-guide/new-sdk.mdx- slug: new-sdk- - page: Toolkit Versioning Migration- path: pages/dist/migration-guide/toolkit-versioning.mdx- slug: toolkit-versioning- - section: Troubleshooting- slug: troubleshooting- contents:- - page: Overview- path: pages/dist/resources/troubleshooting/overview.mdx- slug: overview- - page: API- path: pages/dist/resources/troubleshooting/api.mdx- slug: api- - page: Authentication- path: pages/dist/resources/troubleshooting/authentication.mdx- slug: authentication- - page: CLI- path: pages/dist/resources/troubleshooting/cli.mdx- slug: cli- - page: Dashboard- path: pages/dist/resources/troubleshooting/dashboard.mdx- slug: dashboard- - page: MCP- path: pages/dist/resources/troubleshooting/mcp.mdx- slug: mcp- - page: SDKs- path: pages/dist/resources/troubleshooting/sdks.mdx- slug: sdks- - page: Tools & Toolkits- path: pages/dist/resources/troubleshooting/tools.mdx- slug: tools- - page: Triggers- path: pages/dist/resources/troubleshooting/triggers.mdx- slug: triggers-- tab: tool-router- layout:- - section: Get Started- icon: fa-light fa-rocket- skip-slug: true- contents:- - page: Overview- path: pages/dist/tool-router/overview.mdx- slug: overview- - page: Quickstart- path: pages/dist/tool-router/quickstart.mdx- slug: quickstart- - section: Core Concepts- icon: fa-light fa-brain- skip-slug: true- contents:- - page: Users and Sessions- path: pages/dist/tool-router/users-and-sessions.mdx- slug: users-and-sessions- - page: Authentication- path: pages/dist/tool-router/authentication.mdx- slug: authentication- - page: Tools and Toolkits- path: pages/dist/tool-router/tools-and-toolkits.mdx- slug: tools-and-toolkits- - section: Guides- icon: fa-light fa-book- skip-slug: true- contents:- - page: Using In-chat Authentication- path: pages/dist/tool-router/using-in-chat-authentication.mdx- slug: using-in-chat-authentication- - page: Manually Authenticating Users- path: pages/dist/tool-router/manually-authenticating-users.mdx- slug: manually-authenticating-users- - page: Managing Multiple Accounts for a User- path: pages/dist/tool-router/managing-multiple-accounts.mdx- slug: managing-multiple-accounts- - page: White-labeling Authentication- path: pages/dist/tool-router/white-labeling-authentication.mdx- slug: white-labeling-authentication- - page: Using Custom Auth Configs- path: pages/dist/tool-router/using-custom-auth-configs.mdx- slug: using-custom-auth-configs- - page: Using with MCP Clients- path: pages/dist/tool-router/using-with-mcp-clients.mdx- slug: using-with-mcp-clients- - page: Using as a native tool- path: pages/dist/tool-router/using-as-a-native-tool.mdx- slug: using-as-a-native-tool- - section: Resources- icon: fa-light fa-book- skip-slug: true- contents:- - section: Migration Guides- slug: migration-guide- contents:- - page: Beta to Stable Migration- path: pages/dist/tool-router/migration/tool-router-beta-to-stable.mdx- slug: tool-router/migration-guide/beta-to-stable-- tab: providers- layout:- - section: Supported Providers- contents:- - page: OpenAI Provider- path: pages/dist/providers/openai.mdx- - page: Anthropic Provider- path: pages/dist/providers/anthropic.mdx- - page: Google Provider- path: pages/dist/providers/google.mdx- - page: LangChain Provider- path: pages/dist/providers/langchain.mdx- - page: LlamaIndex Provider- path: pages/dist/providers/llamaindex.mdx- - page: CrewAI Provider- path: pages/dist/providers/crewai.mdx- - page: Vercel AI SDK Provider- path: pages/dist/providers/vercel.mdx- - page: OpenAI Agents Provider- path: pages/dist/providers/openai-agents.mdx- - page: Mastra Provider- path: pages/dist/providers/mastra.mdx- - section: Writing your own provider- skip-slug: true- icon: fa-light fa-code- contents:- - page: TypeScript- path: pages/dist/providers/ts-custom.mdx- slug: providers/custom/typescript- - page: Python- path: pages/dist/providers/py-custom.mdx- slug: providers/custom/python-- tab: toolkits- layout:- - section: Toolkits- skip-slug: true- contents:- - page: Introduction- path: toolkits/src/introduction.mdx- slug: toolkits/introduction- - page: Premium Tools- path: toolkits/src/premium-tools.mdx- slug: toolkits/premium-tools- - section: Important- skip-slug: true- contents:- - page: Github- slug: toolkits/github- path: toolkits/github.mdx- - page: Gmail- slug: toolkits/gmail- path: toolkits/gmail.mdx- - page: Notion- slug: toolkits/notion- path: toolkits/notion.mdx- - section: Scheduling & Booking- skip-slug: true- contents:- - page: Google Calendar- slug: toolkits/googlecalendar- path: toolkits/googlecalendar.mdx- - section: No Auth- skip-slug: true- contents:- - page: Composio- slug: toolkits/composio- path: toolkits/composio.mdx-- tab: api-reference- layout:- - section: REST API- contents:- - api: v3- api-name: v3- skip-slug: true- paginated: false- flattened: true- - section: Python SDK- slug: python- icon: fa-brands fa-python- contents:- - page: Python SDK Reference- slug: python-sdk-reference- path: pages/dist/sdk/python/sdk-reference.md- - section: TypeScript SDK- slug: type-script- icon: fa-brands fa-js- contents:- - section: Core Classes- slug: core-classes- contents:- - page: Composio- slug: composio- path: pages/dist/sdk/typescript/composio/classes/Composio.mdx- - page: ComposioProvider- slug: composio-provider- path: pages/dist/sdk/typescript/provider/ComposioProvider/classes/ComposioProvider.mdx- - page: OpenAIProvider- slug: open-ai-provider- path: pages/dist/sdk/typescript/provider/OpenAIProvider/classes/OpenAIProvider.mdx- - page: BaseAgenticProvider- slug: base-agentic-provider- path: pages/dist/sdk/typescript/provider/BaseProvider/classes/BaseAgenticProvider.mdx- - page: BaseNonAgenticProvider- slug: base-non-agentic-provider- path: pages/dist/sdk/typescript/provider/BaseProvider/classes/BaseNonAgenticProvider.mdx- - section: Models- slug: models- contents:- - page: Tools- slug: tools- path: pages/dist/sdk/typescript/models/Tools/classes/Tools.mdx- - page: Toolkits- slug: toolkits- path: pages/dist/sdk/typescript/models/Toolkits/classes/Toolkits.mdx- - page: Triggers- slug: triggers- path: pages/dist/sdk/typescript/models/Triggers/classes/Triggers.mdx- - page: AuthConfigs- slug: auth-configs- path: pages/dist/sdk/typescript/AuthConfigs/classes/AuthConfigs.mdx- - page: ConnectedAccounts- slug: connected-accounts- path: pages/dist/sdk/typescript/ConnectedAccounts/classes/ConnectedAccounts.mdx- - page: CustomTools- slug: custom-tools- path: pages/dist/sdk/typescript/CustomTools/classes/CustomTools.mdx-- tab: examples- layout:- - section: Getting Started- icon: fa-light fa-rocket- skip-slug: true- contents:- - page: Basic FastAPI Server- path: pages/dist/examples/fast-api.mdx- slug: examples/fast-api- - page: Basic Hono Server- path: pages/dist/examples/hono.mdx- slug: examples/hono- - section: Productivity & Automation- icon: fa-light fa-bolt- skip-slug: true- contents:- - page: Gmail Labeller- path: pages/dist/examples/utility_agents/gmail_labeler.mdx- slug: examples/gmail-labeler- - page: Slack summariser- path: pages/dist/examples/utility_agents/slack_summariser.mdx- slug: examples/slack-summariser- - page: Supabase SQL Agent- path: pages/dist/examples/utility_agents/supabase_sql_agent.mdx- slug: examples/supabase-sql-agent- - section: Full Stack Applications- icon: fa-light fa-globe- skip-slug: true- contents:- - page: Full Stack Chat App- path: pages/dist/examples/chat_applications/vercel_chat.mdx- slug: examples/vercel-chat- - section: Behind the curtain- icon: fa-light fa-person-booth- skip-slug: true- contents:- - page: Tool Generator- path: pages/dist/examples/tool-generator/tool-generator.mdx- slug: examples/tool-generator\ No newline at end of filediff --git a/fern/fern.config.json b/fern/fern.config.jsondeleted file mode 100644index 432f97c89..000000000--- a/fern/fern.config.json+++ /dev/null@@ -1,4 +0,0 @@-{- "organization": "composio",- "version": "3.22.3"-}diff --git a/fern/generators/python_sdk/__init__.py b/fern/generators/python_sdk/__init__.pydeleted file mode 100644index a7887f4c3..000000000--- a/fern/generators/python_sdk/__init__.py+++ /dev/null@@ -1,6 +0,0 @@-"""-Python SDK documentation generator for Composio.--This module provides tools to generate SDK documentation from Python code-using autodoc markers in markdown files.-"""\ No newline at end of filediff --git a/fern/generators/python_sdk/autodoc_core/__init__.py b/fern/generators/python_sdk/autodoc_core/__init__.pydeleted file mode 100644index f5501bcb2..000000000--- a/fern/generators/python_sdk/autodoc_core/__init__.py+++ /dev/null@@ -1 +0,0 @@-# Empty init file to make this a package\ No newline at end of filediff --git a/fern/generators/python_sdk/autodoc_core/autodoc.py b/fern/generators/python_sdk/autodoc_core/autodoc.pydeleted file mode 100644index e10e88343..000000000--- a/fern/generators/python_sdk/autodoc_core/autodoc.py+++ /dev/null@@ -1,635 +0,0 @@-import importlib-import inspect-import json-import re--from .convert_md_to_mdx import convert_md_docstring_to_mdx-from .convert_rst_to_mdx import convert_rst_docstring_to_mdx, find_indent, is_empty_line-from .external import HUGGINFACE_LIBS, get_external_object_link---def find_object_in_package(object_name, package):- """- Find an object from its name inside a given package.-- Args:- - **object_name** (`str`) -- The name of the object to retrieve.- - **package** (`types.ModuleType`) -- The package to look into.- """- path_splits = object_name.split(".")- if path_splits[0] == package.__name__:- path_splits = path_splits[1:]-- module = package- for idx, split in enumerate(path_splits):- submodule = getattr(module, split, None)- if submodule is None:- try:- # Try importing at this level- full_module_path = f"{module.__name__}.{split}"- importlib.import_module(full_module_path)- submodule = getattr(module, split, None)- except ImportError:- return None # Return None if the module cannot be found or imported- module = submodule- if module is None:- return None-- return module---def remove_example_tags(text):- tags = ["<exampletitle>", "</exampletitle>", "<example>", "</example>"]- for tag in tags:- text = text.replace(tag, "")- return text---def get_shortest_path(obj, package):- """- Simplifies the path to `obj` to be the shortest possible, for instance if `obj` is in the main init of its- package.- """- if isinstance(obj, property):- # Properties have no __module__ or __name__ attributes, but their getter function does.- obj = obj.fget-- if not hasattr(obj, "__module__") or obj.__module__ is None:- return None- long_path = obj.__module__- # Sometimes methods are defined in another module from the class (flax.struct.dataclass)- if not long_path.startswith(package.__name__):- return None- long_name = obj.__qualname__ if hasattr(obj, "__qualname__") else obj.__name__- short_name = long_name.split(".")[0]- path_splits = long_path.split(".")- module = package- idx = module.__name__.count(".")- while idx + 1 < len(path_splits) and not hasattr(module, short_name):- idx += 1- module = getattr(module, path_splits[idx])- return ".".join(path_splits[: idx + 1]) + "." + long_name---def get_type_name(typ):- """- Returns the name of the type passed, properly dealing with type annotations.- """- if isinstance(typ, type):- # If it's a class, use its name.- return getattr(typ, "__qualname__", None) or getattr(typ, "__name__", None) or str(typ)- return str(typ) # otherwise, trust its string representation---def format_signature(obj):- """- Retrieves the signature of a class, function or method.- Returns `List(Dict(str, str))` (i.e. [{'do_lower_case', ' = True'}, ...])- where `key` of `Dict` is f'{param_name}' & `value` of `Dict` is f': {annotation} = {default}'- """- params = []- if is_getset_descriptor(obj):- return params- try:- signature = inspect.signature(obj)- except ValueError:- # TODO: This fails for ModelOutput. Check if this is normal.- return ""-- for idx, param in enumerate(signature.parameters.values()):- param_name = param.name- if idx == 0 and param_name in ("self", "cls"):- continue- if param.kind == inspect._ParameterKind.VAR_POSITIONAL:- param_name = f"*{param_name}"- elif param.kind == inspect._ParameterKind.VAR_KEYWORD:- param_name = f"**{param_name}"- param_type_val = ""- if param.annotation != inspect._empty:- annotation = get_type_name(param.annotation)- param_type_val += f": {annotation}"- if param.default != inspect._empty:- default = param.default- default = repr(default)- param_type_val += f" = {default}"- params.append({"name": param_name, "val": param_type_val})- return params---_re_parameters = re.compile(r"<parameters>(.*)</parameters>", re.DOTALL)-_re_returns = re.compile(r"<returns>(.*)</returns>", re.DOTALL)-_re_returntype = re.compile(r"<returntype>(.*)</returntype>", re.DOTALL)-_re_yields = re.compile(r"<yields>(.*)</yields>", re.DOTALL)-_re_yieldtype = re.compile(r"<yieldtype>(.*)</yieldtype>", re.DOTALL)-_re_example_tags = re.compile(r"(<exampletitle>|<example>)")-_re_parameter_group = re.compile(r"^> (.*)$", re.MULTILINE)-_re_raises = re.compile(r"<raises>(.*)</raises>", re.DOTALL)-_re_raisederrors = re.compile(r"<raisederrors>(.*)</raisederrors>", re.DOTALL)---def get_signature_component(name, anchor, signature, object_doc, source_link=None, is_getset_desc=False):- """- Returns the svelte `Docstring` component string.-- Args:- - **name** (`str`) -- The name of the function or class to document.- - **anchor** (`str`) -- The anchor name of the function or class that will be used for hash links.- - **signature** (`List(Dict(str,str))`) -- The signature of the object.- - **object_doc** (`str`) -- The docstring of the the object.- - **source_link** (Union[`str`, `None`], *optional*, defaults to `None`) -- The github source link of the the object.- - **is_getset_desc** (`bool`, *optional*, defaults to `False`) -- Whether the type of obj is `getset_descriptor`.- """-- def inside_example_finder_closure(match, tag):- """- This closure find whether parameters and/or returns sections has example code block inside it- """- match_str = match.group(1)- examples_inside = _re_example_tags.search(match_str)- if examples_inside:- example_tag = examples_inside.group(1)- match_str = match_str.replace(example_tag, f"</{tag}>{example_tag}", 1)- return f"<{tag}>{match_str}"- return f"<{tag}>{match_str}</{tag}>"-- def regex_closure(object_doc, regex):- """- This closure matches given regex & removes the matched group from object_doc- """- re_match = regex.search(object_doc)- object_doc = regex.sub("", object_doc)- match = None- if re_match:- _match = re_match.group(1).strip()- if len(_match):- match = _match- return object_doc, match-- object_doc = _re_returns.sub(lambda m: inside_example_finder_closure(m, "returns"), object_doc)- object_doc = _re_parameters.sub(lambda m: inside_example_finder_closure(m, "parameters"), object_doc)-- object_doc, parameters = regex_closure(object_doc, _re_parameters)- object_doc, return_description = regex_closure(object_doc, _re_returns)- object_doc, returntype = regex_closure(object_doc, _re_returntype)- object_doc, yield_description = regex_closure(object_doc, _re_yields)- object_doc, yieldtype = regex_closure(object_doc, _re_yieldtype)- object_doc, raise_description = regex_closure(object_doc, _re_raises)- object_doc, raisederrors = regex_closure(object_doc, _re_raisederrors)- object_doc = remove_example_tags(object_doc)- object_doc = hashlink_example_codeblock(object_doc, anchor)-- svelte_str = "<docstring>"- svelte_str += f"<name>{name}</name>"- svelte_str += f"<anchor>{anchor}</anchor>"- if source_link:- svelte_str += f"<source>{source_link}</source>"- svelte_str += f"<parameters>{json.dumps(signature)}</parameters>"- if is_getset_desc:- svelte_str += "<isgetsetdescriptor>"-- if parameters is not None:- parameters_str = ""- groups = _re_parameter_group.split(parameters)- group_default = groups.pop(0)- parameters_str += f"<paramsdesc>{group_default}</paramsdesc>"- n_groups = len(groups) // 2- for idx in range(n_groups):- id = idx + 1- title, group = groups[2 * idx], groups[2 * idx + 1]- parameters_str += f"<paramsdesc{id}title>{title}</paramsdesc{id}title>"- parameters_str += f"<paramsdesc{id}>{group}</paramsdesc{id}>"-- svelte_str += parameters_str- svelte_str += f"<paramgroups>{n_groups}</paramgroups>"-- if returntype is not None:- svelte_str += f"<rettype>{returntype}</rettype>"- if return_description is not None:- svelte_str += f"<retdesc>{return_description}</retdesc>"-- if yieldtype is not None:- svelte_str += f"<yieldtype>{yieldtype}</yieldtype>"- if yield_description is not None:- svelte_str += f"<yielddesc>{yield_description}</yielddesc>"-- if raise_description is not None:- svelte_str += f"<raises>{raise_description}</raises>"- if raisederrors is not None:- svelte_str += f"<raisederrors>{raisederrors}</raisederrors>"-- svelte_str += "</docstring>"-- return svelte_str + f"\n{object_doc}\n"---# Re pattern to catch :obj:`xx`, :class:`xx`, :func:`xx` or :meth:`xx`.-_re_rst_special_words = re.compile(r":(?:obj|func|class|meth):`([^`]+)`")-# Re pattern to catch things between double backquotes.-_re_double_backquotes = re.compile(r"(^|[^`])``([^`]+)``([^`]|$)")-# Re pattern to catch example introduction.-_re_rst_example = re.compile(r"^\s*Example.*::\s*$", flags=re.MULTILINE)---def is_rst_docstring(docstring):- """- Returns `True` if `docstring` is written in rst.- """- if _re_rst_special_words.search(docstring) is not None:- return True- if _re_double_backquotes.search(docstring) is not None:- return True- if _re_rst_example.search(docstring) is not None:- return True- return False---# Re pattern to catch example introduction & example code block.-_re_example_codeblock = re.compile(r"((.*:\s+)?^```((?!```)(.|\n))*```)", re.MULTILINE)---def hashlink_example_codeblock(object_doc, object_anchor):- """- Returns the svelte `ExampleCodeBlock` component string.-- Args:- - **object_doc** (`str`) -- The docstring of the the object.- - **anchor** (`str`) -- The anchor name of the function or class that will be used for hash links.- """-- example_id = 0-- def add_example_svelte_blocks(match):- """- This closure matches `_re_example_codeblock` regex & creates `ExampleCodeBlock` svelte component- """- nonlocal example_id-- example_id += 1- id_str = "" if example_id == 1 else f"-{example_id}"- example_anchor = f"{object_anchor}.example{id_str}"- return f'<ExampleCodeBlock anchor="{example_anchor}">\n\n{match.group(1)}\n\n</ExampleCodeBlock>'-- object_doc = _re_example_codeblock.sub(add_example_svelte_blocks, object_doc)- return object_doc---# Re pattern to numpystyle docstring (e.g Parameter -------).-_re_numpydocstring = re.compile(r"(Parameter|Raise|Return|Yield)s?\n\s*----+\n")---def is_numpy_docstring(docstring):- """- Returns `True` if `docstring` is written in numpystyle.- """- return _re_numpydocstring.search(docstring)---def is_dataclass_autodoc(obj):- """- Returns boolean whether object's doc was generated automatically by `dataclass`.- """- if is_getset_descriptor(obj):- return False- try:- signature = str(inspect.signature(obj))- except ValueError:- # object doesn't have signature- return False- doc = obj.__doc__- doc_generated = obj.__name__ + signature- is_generated = doc in doc_generated- return is_generated---def is_getset_descriptor(obj):- """- Returns boolean whether object is `getset_descriptor`.- """- # used by tokenizers @property bindings- obj_repr = str(type(obj))- return "getset_descriptor" in obj_repr---def get_source_link(obj, page_info, version_tag_suffix="src/"):- """- Returns the link to the source code of an object on GitHub.- """- # Repo name defaults to package_name, but if provided in page_info, it will be used instead.- repo_name = page_info.get("repo_name", page_info.get("package_name"))- version_tag = page_info.get("version_tag", "next")- repo_owner = page_info.get("repo_owner", "composiohq")- base_link = f"https://github.com/{repo_owner}/{repo_name}/blob/{version_tag}/{version_tag_suffix}"- module = obj.__module__.replace(".", "/")- line_number = inspect.getsourcelines(obj)[1]- source_file = inspect.getsourcefile(obj)- if source_file.endswith("__init__.py"):- return f"{base_link}{module}/__init__.py#L{line_number}"- return f"{base_link}{module}.py#L{line_number}"---def get_source_path(object_name, package):- """- Find a path to file in which given object was defined.-- Args:- - object_name (`str`): The name of the object to retrieve.- - package (`types.ModuleType`): The package to look into.- """- obj = obj = find_object_in_package(object_name=object_name, package=package)- obj_path = inspect.getfile(obj)- return obj_path---def document_object(object_name, package, page_info, full_name=True, anchor_name=None, version_tag_suffix="src/"):- """- Writes the document of a function, class or method.-- Args:- object_name (`str`): The name of the object to document.- package (`types.ModuleType`): The package of the object.- full_name (`bool`, *optional*, defaults to `True`): Whether to write the full name of the object or not.- anchor_name (`str`, *optional*): The name to give to the anchor for this object.- version_tag_suffix (`str`, *optional*, defaults to `"src/"`):- Suffix to add after the version tag (e.g. 1.3.0 or main) in the documentation links.- For example, the default `"src/"` suffix will result in a base link as `https://github.com/{repo_owner}/{package_name}/blob/{version_tag}/src/`.- For example, `version_tag_suffix=""` will result in a base link as `https://github.com/{repo_owner}/{package_name}/blob/{version_tag}/`.- """- if page_info is None:- page_info = {}- if "package_name" not in page_info:- page_info["package_name"] = package.__name__- obj = find_object_in_package(object_name=object_name, package=package)- if obj is None:- raise ValueError(- f"Unable to find {object_name} in {package.__name__}. Make sure the path to that object is correct."- )- if isinstance(obj, property):- # Propreties have no __module__ or __name__ attributes, but their getter function does.- obj = obj.fget-- if anchor_name is None:- anchor_name = get_shortest_path(obj, package)- if full_name and anchor_name is not None:- name = anchor_name- else:- name = obj.__name__-- prefix = "class " if isinstance(obj, type) else ""- object_doc = ""- signature_name = prefix + name- signature = format_signature(obj)- check = None- if getattr(obj, "__doc__", None) is not None and len(obj.__doc__) > 0:- object_doc = obj.__doc__- if is_dataclass_autodoc(obj):- object_doc = ""- elif is_rst_docstring(object_doc):- object_doc = convert_rst_docstring_to_mdx(obj.__doc__, page_info)- else:- check = quality_check_docstring(object_doc, object_name=object_name)- object_doc = convert_md_docstring_to_mdx(obj.__doc__, page_info)-- try:- source_link = get_source_link(obj, page_info, version_tag_suffix)- except (AttributeError, OSError, TypeError):- # tokenizers obj do NOT have `__module__` attribute & can NOT be used with inspect.getsourcelines- source_link = None- is_getset_desc = is_getset_descriptor(obj)- component = get_signature_component(- signature_name, anchor_name, signature, object_doc, source_link, is_getset_desc- )- documentation = "\n" + component + "\n"- return documentation, check---def find_documented_methods(clas):- """- Find all the public methods of a given class that have a nonempty documentation, filtering the methods documented- the exact same way in a superclass.- """- public_attrs = {a: getattr(clas, a) for a in dir(clas) if not a.startswith("_")}- public_methods = {a: m for a, m in public_attrs.items() if callable(m) and not isinstance(m, type)}- documented_methods = {- a: m for a, m in public_methods.items() if getattr(m, "__doc__", None) is not None and len(m.__doc__) > 0- }-- superclasses = clas.mro()[1:]- for superclass in superclasses:- superclass_methods = {a: getattr(superclass, a) for a in documented_methods.keys() if hasattr(superclass, a)}- documented_methods = {- a: m- for a, m in documented_methods.items()- if (- a not in superclass_methods- or getattr(superclass_methods[a], "__doc__", None) is None- or m.__doc__ != superclass_methods[a].__doc__- )- }- return list(documented_methods.keys())---docstring_css_classes = "docstring border-l-2 border-t-2 pl-4 pt-3.5 border-gray-100 rounded-tl-xl mb-6 mt-8"---def autodoc(object_name, package, methods=None, return_anchors=False, page_info=None, version_tag_suffix="python/"):- """- Generates the documentation of an object, with a potential filtering on the methods for a class.-- Args:- object_name (`str`): The name of the function or class to document.- package (`types.ModuleType`): The package of the object.- methods (`List[str]`, *optional*):- A list of methods to document if `obj` is a class. If nothing is passed, all public methods with a new- docstring compared to the superclasses are documented. If a list of methods is passed and ou want to add- all those methods, the key "all" will add them.- return_anchors (`bool`, *optional*, defaults to `False`):- Whether or not to return the list of anchors generated.- page_info (`Dict[str, str]`, *optional*): Some information about the page.- version_tag_suffix (`str`, *optional*, defaults to `"python/"`):- Suffix to add after the version tag (e.g. 1.3.0 or main) in the documentation links.- For example, the default `"src/"` suffix will result in a base link as `https://github.com/{repo_owner}/{package_name}/blob/{version_tag}/src/`.- For example, `version_tag_suffix=""` will result in a base link as `https://github.com/{repo_owner}/{package_name}/blob/{version_tag}/`.- """- if page_info is None:- page_info = {}- if "package_name" not in page_info:- page_info["package_name"] = package.__name__-- errors = []- obj = find_object_in_package(object_name=object_name, package=package)- documentation, check = document_object(- object_name=object_name, package=package, page_info=page_info, version_tag_suffix=version_tag_suffix- )- if check is not None:- errors.append(check)-- if return_anchors:- anchors = [get_shortest_path(obj, package)]- if isinstance(obj, type):- documentation, check = document_object(- object_name=object_name, package=package, page_info=page_info, version_tag_suffix=version_tag_suffix- )- if check is not None:- errors.append(check)- if methods is None:- methods = find_documented_methods(obj)- elif "all" in methods:- methods.remove("all")- methods_to_add = find_documented_methods(obj)- methods.extend([m for m in methods_to_add if m not in methods])- elif "none" in methods:- methods = []- for method in methods:- anchor_name = f"{anchors[0]}.{method}"- method_doc, check = document_object(- object_name=f"{object_name}.{method}",- package=package,- page_info=page_info,- full_name=False,- anchor_name=anchor_name,- version_tag_suffix=version_tag_suffix,- )- if check is not None:- errors.append(check)- documentation += f'\n<div class="{docstring_css_classes}">\n\n' + method_doc + "</div>"- if return_anchors:- # The anchor name of the method might be different from its- method = find_object_in_package(f"{anchors[0]}.{method}", package=package)- method_name = get_shortest_path(method, package=package)- if anchor_name == method_name or method_name is None:- anchors.append(anchor_name)- else:- anchors.append((anchor_name, method_name))- documentation = f'<div class="{docstring_css_classes}">\n\n' + documentation + "</div>\n"-- return (documentation, anchors, errors) if return_anchors else documentation---def resolve_links_in_text(text, package, mapping, page_info):- """- Resolve links of the form [`SomeClass`] to the link in the documentation to `SomeClass`.-- Args:- text (`str`): The text in which to convert the links.- package (`types.ModuleType`): The package in which to search objects for.- mapping (`Dict[str, str]`): The map from anchor names of objects to their page in the documentation.- page_info (`Dict[str, str]`): Some information about the page.- """- package_name = page_info.get("package_name", package.__name__)- version = page_info.get("version", "main")- language = page_info.get("language", "en")-- prefix = f"/docs/{package_name}/{version}/{language}/"-- def _resolve_link(search):- object_or_param_name, last_char = search.groups()- # Deal with external libs first.- lib_name = object_or_param_name.split(".")[0]- if lib_name.startswith("~"):- lib_name = lib_name[1:]- if lib_name in HUGGINFACE_LIBS and lib_name != package_name:- link = get_external_object_link(object_or_param_name, page_info)- return f"{link}{last_char}"- object_name, param_name = None, None- # If `#` is in the name, assume it's a link to the function/method parameter.- if "#" in object_or_param_name:- object_name_for_param = object_or_param_name.split("#", 1)[0]- # Strip preceding `~` if it's there.- object_name_for_param = (- object_name_for_param[1:] if object_name_for_param.startswith("~") else object_name_for_param- )- obj = find_object_in_package(object_name_for_param, package)- param_name = object_or_param_name.split("#", 1)[-1]- # If the name begins with `~`, we shortcut to the last part.- elif object_or_param_name.startswith("~"):- obj = find_object_in_package(object_or_param_name[1:], package)- object_name = object_or_param_name.split(".")[-1]- else:- obj = find_object_in_package(object_or_param_name, package)- object_name = object_or_param_name- # Object not found, return the original link text.- if obj is None:- return f"`{object_or_param_name}`{last_char}"-- link_name = object_name if param_name is None else param_name-- # If the link points to an object and the object is not a class, we add ()- if param_name is None and not isinstance(obj, (type, property)):- link_name = f"{link_name}()"-- # Link to the anchor- anchor = get_shortest_path(obj, package)- if anchor not in mapping:- return f"`{link_name}`{last_char}"- page = f"{prefix}{mapping[anchor]}"- if param_name:- anchor = f"{anchor}.{param_name}"- if "#" in page:- return f"[{link_name}]({page}){last_char}"- else:- return f"[{link_name}]({page}#{anchor}){last_char}"-- return re.sub(r"\[`([^`]+)`\]([^\(])", _resolve_link, text)---# Re pattern that catches the start of a block code with potential indent.-_re_start_code_block = re.compile(r"^\s*```.*$", flags=re.MULTILINE)-# Re pattern that catches return blocks of the form `Return:`.-_re_returns_block = re.compile(r"^\s*Returns?:\s*$")---def quality_check_docstring(docstring, object_name=None):- """- Check if a docstring is not going to generate a common error on moon-landing, by asserting it does not have:-- - an empty Return block- - two (or more) Return blocks- - a code sample not properly closed.-- This function only returns an error message and does not raise an exception, as we will raise one single exception- with all the problems at the end.-- Args:- docstring (`str`): The docstring to check.- obejct_name (`str`, *optional*): The name of the object being documented.- Will be added to the error message if passed.-- Returns:- Optional `str`: Returns `None` if the docstring is correct and an error message otherwise.- """-- lines = docstring.split("\n")- in_code = False- code_indent = 0- return_blocks = 0- error_message = ""-- for idx, line in enumerate(lines):- if not in_code and _re_start_code_block.search(line) is not None:- in_code = True- code_indent = find_indent(line)- elif in_code and line.rstrip() == " " * code_indent + "```":- in_code = False- elif _re_returns_block.search(line) is not None:- next_line_idx = idx + 1- while next_line_idx < len(lines) and is_empty_line(lines[next_line_idx]):- next_line_idx += 1- if next_line_idx >= len(lines) or find_indent(lines[next_line_idx]) <= find_indent(line):- error_message += "- The return block is empty.\n"- else:- return_blocks += 1-- if in_code:- error_message += "- A code block has been opened but is not closed.\n"- if return_blocks >= 2:- error_message += f"- There are {return_blocks} Returns block. Only one max is supported.\n"-- if len(error_message) == 0:- return-- if object_name is not None:- error_message = (- f"The docstring of {object_name} comports the following issue(s) and needs fixing:\n" + error_message- )-- return error_messagediff --git a/fern/generators/python_sdk/autodoc_core/convert_md_to_mdx.py b/fern/generators/python_sdk/autodoc_core/convert_md_to_mdx.pydeleted file mode 100644index 870def983..000000000--- a/fern/generators/python_sdk/autodoc_core/convert_md_to_mdx.py+++ /dev/null@@ -1,241 +0,0 @@-# coding=utf-8-# Copyright 2021 The HuggingFace Team. All rights reserved.-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.---import json-import re-import tempfile--from .convert_rst_to_mdx import parse_rst_docstring, remove_indent---_re_doctest_flags = re.compile(r"^(>>>.*\S)(\s+)# doctest:\s+\+[A-Z_]+\s*$", flags=re.MULTILINE)---def convert_md_to_mdx(md_text, page_info):- """- Convert a document written in md to mdx.- """- return (- """<script lang="ts">-import {onMount} from "svelte";-import Tip from "$lib/Tip.svelte";-import Youtube from "$lib/Youtube.svelte";-import Docstring from "$lib/Docstring.svelte";-import CodeBlock from "$lib/CodeBlock.svelte";-import CodeBlockFw from "$lib/CodeBlockFw.svelte";-import DocNotebookDropdown from "$lib/DocNotebookDropdown.svelte";-import CourseFloatingBanner from "$lib/CourseFloatingBanner.svelte";-import IconCopyLink from "$lib/IconCopyLink.svelte";-import FrameworkContent from "$lib/FrameworkContent.svelte";-import Markdown from "$lib/Markdown.svelte";-import Question from "$lib/Question.svelte";-import FrameworkSwitchCourse from "$lib/FrameworkSwitchCourse.svelte";-import InferenceApi from "$lib/InferenceApi.svelte";-import TokenizersLanguageContent from "$lib/TokenizersLanguageContent.svelte";-import ExampleCodeBlock from "$lib/ExampleCodeBlock.svelte";-import Added from "$lib/Added.svelte";-import Changed from "$lib/Changed.svelte";-import Deprecated from "$lib/Deprecated.svelte";-import PipelineIcon from "$lib/PipelineIcon.svelte";-import PipelineTag from "$lib/PipelineTag.svelte";-import Heading from "$lib/Heading.svelte";-import HfOptions from "$lib/HfOptions.svelte";-import HfOption from "$lib/HfOption.svelte";-import EditOnGithub from "$lib/EditOnGithub.svelte";-import InferenceSnippet from "$lib/InferenceSnippet/InferenceSnippet.svelte";-let fw: "pt" | "tf" = "pt";-onMount(() => {- const urlParams = new URLSearchParams(window.location.search);- fw = urlParams.get("fw") || "pt";-});-</script>-<svelte:head>- <meta name="hf:doc:metadata" content={metadata} >-</svelte:head>--<!--HF DOCBUILD BODY START-->--HF_DOC_BODY_START--"""- + process_md(md_text, page_info)- + edit_on_github(page_info)- + """--<!--HF DOCBUILD BODY END-->--HF_DOC_BODY_END--"""- )---def edit_on_github(page_info):- """- Svelte component string that adds "Update on Github" btn.- """- if "path" not in page_info or "repo_name" not in page_info:- return ""- path = str(page_info["path"])- package_name = page_info["repo_name"]- idx = path.find(package_name)- if idx == -1:- return ""- relative_path = path[idx + len(package_name) :]- if relative_path.startswith("/"):- relative_path = relative_path[1:]- source = f'https://github.com/{page_info["repo_owner"]}/{page_info["repo_name"]}/blob/main/{relative_path}'- return f'\n\n<EditOnGithub source="{source}" />\n\n'---def convert_img_links(text, page_info):- """- Convert image links to correct URL paths.- """- if "package_name" not in page_info:- raise ValueError("`page_info` must contain at least the package_name.")- package_name = page_info["package_name"]- version = page_info.get("version", "main")- language = page_info.get("language", "en")-- _re_img_link = re.compile(r"(src=\"|\()/imgs/")- while _re_img_link.search(text):- text = _re_img_link.sub(rf"\1/docs/{package_name}/{version}/{language}/imgs/", text)- return text---_re_md_img_tag_alt = re.compile(r"!\[([^\]]+)\]", re.I)-_re_html_img_tag_alt = re.compile(r"<img [^>]*?alt=([\"'])([^\1]*?)\1[^>]*?>", re.I)---def escape_img_alt_description(text):- """- Escapes ` with ' inside <img> alt description since it causes svelte/mdsvex compiler error.- """-- def replace_md_alt_content(match):- alt_content = match.group(1)- new_alt_content = alt_content.replace("`", "'")- return match.group(0).replace(alt_content, new_alt_content)-- def replace_html_alt_content(match):- alt_content = match.group(2) # group(2) contains the alt text for the HTML regex- new_alt_content = alt_content.replace("`", "'")- return match.group(0).replace(alt_content, new_alt_content)-- # Replace markdown style image alt text- if _re_md_img_tag_alt.search(text):- text = _re_md_img_tag_alt.sub(replace_md_alt_content, text)-- # Replace HTML style image alt text- if _re_html_img_tag_alt.search(text):- text = _re_html_img_tag_alt.sub(replace_html_alt_content, text)-- return text---def fix_img_links(text, page_info):- text = convert_img_links(text, page_info)- text = escape_img_alt_description(text)- return text---def clean_doctest_syntax(text):- """- Clean the doctest artifacts in a given content.- """- text = text.replace(">>> # ===PT-TF-SPLIT===", "===PT-TF-SPLIT===")- text = _re_doctest_flags.sub(r"\1", text)- return text---_re_include_template = r"([ \t]*)<{include_name}>(((?!<{include_name}>).)*)<\/{include_name}>"-_re_include = re.compile(_re_include_template.format(include_name="include"), re.DOTALL)-_re_literalinclude = re.compile(_re_include_template.format(include_name="literalinclude"), re.DOTALL)---def convert_file_include_helper(match, page_info, is_code=True):- """- Convert an `include` or `literalinclude` regex match into markdown blocks or markdown code blocks,- by opening a file and copying specified start-end section into markdown block.-- If `is_code` is True, the block will be rendered as a code block, otherwise it will be rendered- as a markdown block.- """- include_info = json.loads(match[2].strip())- indent = match[1]- include_name = "literalinclude" if is_code else "include"- if tempfile.gettempdir() in str(page_info["path"]):- return f"\n`Please restart doc-builder preview commands to see {include_name} rendered`\n"- file = page_info["path"].parent / include_info["path"]- with open(file, "r", encoding="utf-8-sig") as reader:- lines = reader.readlines()- include = lines # defaults to entire file- if "start-after" in include_info or "end-before" in include_info:- start_after, end_before = -1, -1- for idx, line in enumerate(lines):- line = line.strip()- line = re.sub(r"\W+$", "", line)- if line.endswith(include_info["start-after"]):- start_after = idx + 1- if line.endswith(include_info["end-before"]):- end_before = idx- if start_after == -1 or end_before == -1:- raise ValueError(f"The following '{include_name}' does NOT exist:\n{match[0]}")- include = lines[start_after:end_before]- include = [indent + line[include_info.get("dedent", 0) :] for line in include]- include = "".join(include).rstrip()- return f"""{indent}```{include_info.get('language', '')}\n{include}\n{indent}```""" if is_code else include---def convert_include(text, page_info):- """- Convert an `include` into markdown.- """- text = _re_include.sub(lambda m: convert_file_include_helper(m, page_info, is_code=False), text)- return text---def convert_literalinclude(text, page_info):- """- Convert a `literalinclude` into markdown code blocks.- """- text = _re_literalinclude.sub(lambda m: convert_file_include_helper(m, page_info, is_code=True), text)- return text---def convert_md_docstring_to_mdx(docstring, page_info):- """- Convert a docstring written in Markdown to mdx.- """- text = parse_rst_docstring(docstring)- text = remove_indent(text)- return process_md(text, page_info)---def process_md(text, page_info):- """- Processes markdown by:- 1. Convert include- 2. Convert literalinclude- 3. Clean doctest syntax- 4. Fix image links- """- text = convert_include(text, page_info)- text = convert_literalinclude(text, page_info)- text = clean_doctest_syntax(text)- text = fix_img_links(text, page_info)- return textdiff --git a/fern/generators/python_sdk/autodoc_core/convert_rst_to_mdx.py b/fern/generators/python_sdk/autodoc_core/convert_rst_to_mdx.pydeleted file mode 100644index 67379c2f1..000000000--- a/fern/generators/python_sdk/autodoc_core/convert_rst_to_mdx.py+++ /dev/null@@ -1,705 +0,0 @@-# coding=utf-8-# Copyright 2021 The HuggingFace Team. All rights reserved.-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.---import re---# Re pattern to catch things inside ` ` in :obj:`thing`.-_re_obj = re.compile(r":obj:`([^`]+)`")-# Re pattern to catch things inside ` ` in :math:`thing`.-_re_math = re.compile(r":math:`([^`]+)`")-# Re pattern to catch things between single backquotes.-_re_single_backquotes = re.compile(r"(^|[^`])`([^`]+)`([^`]|$)")-# Re pattern to catch things between double backquotes.-_re_double_backquotes = re.compile(r"(^|[^`])``([^`]+)``([^`]|$)")-# Re pattern to catch things inside ` ` in :func/class/meth:`thing`.-_re_func_class = re.compile(r":(?:func|class|meth):`([^`]+)`")---def convert_rst_formatting(text):- """- Convert rst syntax for formatting to markdown in a given text.- """- # Remove :class:, :func: and :meth: markers. To code-links and put double backquotes- # (to not be caught by the italic conversion).- text = _re_func_class.sub(r"[``\1``]", text)- # Remove :obj: markers. What's after is in a single backquotes so we put in double backquotes- # (to not be caught by the italic conversion).- text = _re_obj.sub(r"``\1``", text)- # Remove :math: markers.- text = _re_math.sub(r"\\\\(\1\\\\)", text)- # Convert content in single backquotes to italic.- text = _re_single_backquotes.sub(r"\1*\2*\3", text)- # Convert content in double backquotes to single backquotes.- text = _re_double_backquotes.sub(r"\1`\2`\3", text)- # Remove remaining ::- text = re.sub(r"::\n", "", text)-- # Remove new lines inside blocks in backsticks as they will be kept.- lines = text.split("\n")- in_code = False- text = None- for line in lines:- if in_code:- splits = line.split("`")- in_code = len(splits) > 1 and len(splits) % 2 == 1- if len(splits) == 1:- # Some forgotten lone backstick- text += "\n" + line- else:- text += " " + line.lstrip()- else:- if text is not None:- text += "\n" + line- else:- text = line- splits = line.split("`")- in_code = len(splits) % 2 == 0- return text---# Re pattern to catch description and url in links of the form `description <url>`_.-_re_links = re.compile(r"`([^`]+\S)\s+</*([^/][^>`]*)>`_+")-# Re pattern to catch description and url in links of the form :prefix_link:`description <url>`_.-_re_prefix_links = re.compile(r":prefix_link:`([^`]+\S)\s+</*([^/][^>`]*)>`")-# Re pattern to catch reference in links of the form :doc:`reference`.-_re_simple_doc = re.compile(r":doc:`([^`<]*)`")-# Re pattern to catch description and reference in links of the form :doc:`description <reference>`.-_re_doc_with_description = re.compile(r":doc:`([^`<]+\S)\s+</*([^/][^>`]*)>`")-# Re pattern to catch reference in links of the form :ref:`reference`.-_re_simple_ref = re.compile(r":ref:`([^`<]*)`")-# Re pattern to catch description and reference in links of the form :ref:`description <reference>`.-_re_ref_with_description = re.compile(r":ref:`([^`<]+\S)\s+<([^>]*)>`")---def convert_rst_links(text, page_info):- """- Convert the rst links in text to markdown.- """- if "package_name" not in page_info:- raise ValueError("`page_info` must contain at least the package_name.")- package_name = page_info["package_name"]- version = page_info.get("version", "main")- language = page_info.get("language", "en")- no_prefix = page_info.get("no_prefix", False)-- prefix = "" if no_prefix else f"/docs/{package_name}/{version}/{language}/"- # Links of the form :doc:`page`- text = _re_simple_doc.sub(rf"[\1]({prefix}\1)", text)- # Links of the form :doc:`text <page>`- text = _re_doc_with_description.sub(rf"[\1]({prefix}\2)", text)-- if "page" in page_info and not no_prefix:- page = str(page_info["page"])- if page.endswith(".html"):- page = page[:-5]- prefix = f"{prefix}{page}"- else:- prefix = ""- # Refs of the form :ref:`page`- text = _re_simple_ref.sub(rf"[\1]({prefix}#\1)", text)- # Refs of the form :ref:`text <page>`- text = _re_ref_with_description.sub(rf"[\1]({prefix}#\2)", text)-- # Links with a prefix- # TODO: when it exists, use the API to deal with prefix links properly.- prefix = f"https://github.com/huggingface/{package_name}/tree/main/"- text = _re_prefix_links.sub(rf"[\1]({prefix}\2)", text)- # Other links- text = _re_links.sub(r"[\1](\2)", text)- # Relative links or Transformers links need to remove the .html- if "(https://https://huggingface.co/" in text or re.search(r"\(\.+/", text) is not None:- text = text.replace(".html", "")- return text---# Re pattern that catches examples blocks of the form `Example::`.-_re_example = re.compile(r"^\s*(\S.*)::\s*$")-# Re pattern that catches rst blocks of the form `.. block_name::`.-_re_block = re.compile(r"^\s*\.\.\s+(\S+)::")-# Re pattern that catches what's after the :: in rst blocks of the form `.. block_name:: something`.-_re_block_info = re.compile(r"^\s*\.\.\s+\S+::\s*(\S.*)$")---def is_empty_line(line):- return len(line) == 0 or line.isspace()---def find_indent(line):- """- Returns the number of spaces that start a line indent.- """- search = re.search(r"^(\s*)(?:\S|$)", line)- if search is None:- return 0- return len(search.groups()[0])---_re_rst_option = re.compile(r"^\s*:(\S+):(.*)$")---def convert_special_chars(text):- """- Converts { and < that have special meanings in MDX.- """- text = text.replace("{", "&lcub;")- # We don't want to replace those by the HTML code, so we temporarily set them at LTHTML- text = re.sub(r"<(img|br|hr|Youtube)", r"LTHTML\1", text) # html void elements with no closing counterpart- _re_lt_html = re.compile(r"<(\S+)([^>]*>)(((?!</\1>).)*)<(/\1>)", re.DOTALL)- while _re_lt_html.search(text):- text = _re_lt_html.sub(r"LTHTML\1\2\3LTHTML\5", text)- text = re.sub(r"(^|[^<])<([^<]|$)", r"\1&lt;\2", text)- text = text.replace("LTHTML", "<")- return text---def parse_options(block_content):- """- Parses the option in some rst block content.- """- block_lines = block_content.split("\n")- block_indent = find_indent(block_lines[0])- current_option = None- result = {}- for line in block_lines:- if _re_rst_option.search(line) is not None:- current_option, value = _re_rst_option.search(line).groups()- result[current_option] = value.lstrip()- elif find_indent(line) > block_indent:- result[current_option] += " " + line.lstrip()-- return result---def apply_min_indent(text, min_indent):- """- Make sure all lines in a text are have a minimum indentation.-- Args:- text (`str`): The text to treat.- min_indent (`int`): The minimal indentation.-- Returns:- `str`: The processed text.- """- lines = text.split("\n")- idx = 0- while idx < len(lines):- if is_empty_line(lines[idx]):- idx += 1- continue- indent = find_indent(lines[idx])- if indent < min_indent:- while idx < len(lines) and (find_indent(lines[idx]) >= indent or is_empty_line(lines[idx])):- if not is_empty_line(lines[idx]):- lines[idx] = " " * (min_indent - indent) + lines[idx]- idx += 1- else:- idx += 1-- return "\n".join(lines)---def convert_rst_blocks(text, page_info):- """- Converts rst special blocks (examples, notes) into MDX.- """- if "package_name" not in page_info:- raise ValueError("`page_info` must contain at least the package_name.")- package_name = page_info["package_name"]- version = page_info.get("version", "main")- language = page_info.get("language", "en")-- lines = text.split("\n")- idx = 0- new_lines = []- while idx < len(lines):- block_type = None- block_info = None- if _re_block.search(lines[idx]) is not None:- block_type = _re_block.search(lines[idx]).groups()[0]- if _re_block_info.search(lines[idx]) is not None:- block_info = _re_block_info.search(lines[idx]).groups()[0]- elif _re_example.search(lines[idx]) is not None:- block_type = "code-block-example"- block_info = "python"- example_name = _re_example.search(lines[idx]).groups()[0]- new_lines.append(f"<exampletitle>{example_name}:</exampletitle>\n")- elif lines[idx].strip() == "..":- block_type = "comment"- elif lines[idx].strip() == "::":- block_type = "code-block"-- if block_type is not None:- block_indent = find_indent(lines[idx])- # Find the next nonempty line- idx += 1- while idx < len(lines) and is_empty_line(lines[idx]):- idx += 1- # Grab the indent of the return line, this block will stop when we unindent under it (or has already)- example_indent = find_indent(lines[idx]) if idx < len(lines) else block_indent-- if example_indent == block_indent:- block_content = ""- else:- block_lines = []- while idx < len(lines) and (is_empty_line(lines[idx]) or find_indent(lines[idx]) >= example_indent):- block_lines.append(lines[idx][example_indent:])- idx += 1- block_content = "\n".join(block_lines)-- if block_type in ["code", "code-block"]:- prefix = "```" if block_info is None else f"```{block_info}"- new_lines.append(f"{prefix}\n{block_content.strip()}\n```\n")- elif block_type == "code-block-example":- prefix = f"<example>```{block_info}"- new_lines.append(f"{prefix}\n{block_content.strip()}\n```\n</example>")- elif block_type == "note":- new_lines.append(apply_min_indent(f"<Tip>\n\n{block_content.strip()}\n\n</Tip>\n", block_indent))- elif block_type == "warning":- new_lines.append(- apply_min_indent("<Tip warning={true}>\n\n" + f"{block_content.strip()}\n\n</Tip>\n", block_indent)- )- elif block_type == "raw":- new_lines.append(block_content.strip() + "\n")- elif block_type == "math":- new_lines.append(f"$${block_content.strip()}$$\n")- elif block_type == "comment":- new_lines.append(f"<!--{block_content.strip()}\n-->\n")- elif block_type == "autofunction":- if block_info is not None:- new_lines.append(f"[[autodoc]] {block_info}\n")- elif block_type == "autoclass":- if block_info is not None:- block = f"[[autodoc]] {block_info}\n"- options = parse_options(block_content)- if "special-members" in options:- special_members = options["special-members"].split(", ")- for special_member in special_members:- block += f" - {special_member}\n"- if "members" in options:- members = options["members"]- if len(members) == 0:- block += " - all\n"- else:- for member in members.split(", "):- block += f" - {member}\n"- new_lines.append(block)- elif block_type == "image":- options = parse_options(block_content)- target = options.pop("target", None)- if block_info is not None:- options["src"] = block_info- else:- if target is None:- raise ValueError("Image source not defined.")- options["src"] = target- # Adapt path- options["src"] = options["src"].replace("/imgs/", f"/docs/{package_name}/{version}/{language}/imgs/")- html_code = " ".join([f'{key}="{value}"' for key, value in options.items()])- new_lines.append(f"<img {html_code}/>\n")-- else:- new_lines.append(f"{block_type},{block_info}\n{block_content.rstrip()}\n")-- else:- new_lines.append(lines[idx])- idx += 1-- return "\n".join(new_lines)---# Re pattern that catches rst args blocks of the form `Parameters:`.-_re_args = re.compile(r"^\s*(Args?|Arguments?|Attributes?|Params?|Parameters?):\s*$")-# Re pattern that catches return blocks of the form `Return:`.-_re_returns = re.compile(r"^\s*(Return|Yield|Raise)s?:\s*$")---def split_return_line(line):- """- Split the return line with format `type: some doc`. Type may contain colons in the form of :obj: or :class:.- """- splits_on_colon = line.split(":")- idx = 1- while idx < len(splits_on_colon) and splits_on_colon[idx] in ["obj", "class"]:- idx += 2- if idx >= len(splits_on_colon):- if len(splits_on_colon) % 2 == 1 and re.search(r"`\w+`$", line.rstrip()):- return line, ""- return None, line- return ":".join(splits_on_colon[:idx]), ":".join(splits_on_colon[idx:])---def split_raise_line(line):- """- Split the raise line with format `SomeError some doc`.- """- splits_on_colon = line.strip().split(" ")- error_type, doc = splits_on_colon[0], " ".join(splits_on_colon[1:])- if error_type and error_type[-1] == ":":- error_type = error_type[:-1]- return error_type, doc---def split_arg_line(line):- """- Split the return line with format `type: some doc`. Type may contain colons in the form of :obj: or :class:.- """- splits_on_colon = line.split(":")- idx = 1- while idx < len(splits_on_colon) and splits_on_colon[idx] in ["obj", "class"]:- idx += 2- if idx >= len(splits_on_colon):- return line, ""- return ":".join(splits_on_colon[:idx]), ":".join(splits_on_colon[idx:])---class InvalidRstDocstringError(ValueError):- pass---_re_parameters = re.compile(r"<parameters>(((?!<parameters>).)*)</parameters>", re.DOTALL)-_re_md_link = re.compile(r"\[(.+)\]\(.+\)", re.DOTALL)---def parse_rst_docstring(docstring):- """- Parses a docstring written in rst, in particular the list of arguments and the return type.- """- lines = docstring.split("\n")- idx = 0- while idx < len(lines):- # Parameters section- if _re_args.search(lines[idx]) is not None:- # Title of the section.- lines[idx] = "<parameters>\n"- # Find the next nonempty line- idx += 1- while is_empty_line(lines[idx]):- idx += 1- # Grab the indent of the list of parameters, this block will stop when we unindent under it or we see the- # Returns or Raises block.- param_indent = find_indent(lines[idx])- while (- idx < len(lines) and find_indent(lines[idx]) == param_indent and _re_returns.search(lines[idx]) is None- ):- intro, doc = split_arg_line(lines[idx])- # Line starting with a > after indent indicate a "section title" in the parameters.- if intro.lstrip().startswith(">"):- lines[idx] = intro.lstrip()- else:- lines[idx] = re.sub(r"^\s*(\S+)(\s)?", r"- **\1**\2", intro) + " --" + doc- idx += 1- while idx < len(lines) and (is_empty_line(lines[idx]) or find_indent(lines[idx]) > param_indent):- idx += 1- lines.insert(idx, "</parameters>\n")- idx += 1-- # Returns section- elif _re_returns.search(lines[idx]) is not None:- # tag is either `return` or `yield`- tag = _re_returns.match(lines[idx]).group(1).lower()- # Title of the section.- lines[idx] = f"<{tag}s>\n"- # Find the next nonempty line- idx += 1- while is_empty_line(lines[idx]):- idx += 1-- # Grab the indent of the return line, this block will stop when we unindent under it.- return_indent = find_indent(lines[idx])- raised_errors = []- # The line may contain the return type.- if tag in ["return", "yield"]:- return_type, return_description = split_return_line(lines[idx])- lines[idx] = return_description- idx += 1- while idx < len(lines) and (is_empty_line(lines[idx]) or find_indent(lines[idx]) >= return_indent):- idx += 1- else:- while idx < len(lines) and find_indent(lines[idx]) == return_indent:- return_type, return_description = split_raise_line(lines[idx])- raised_error = re.sub(r"^\s*`?([\w\.]*)`?$", r"``\1``", return_type)- lines[idx] = "- " + raised_error + " -- " + return_description- md_link = _re_md_link.match(raised_error)- if md_link:- raised_error = md_link[1]- raised_error = re.sub(r"^\s*`?([\w\.]*)`?$", r"``\1``", raised_error)- if raised_error not in raised_errors:- raised_errors.append(raised_error)- idx += 1- while idx < len(lines) and (is_empty_line(lines[idx]) or find_indent(lines[idx]) > return_indent):- idx += 1-- lines.insert(idx, f"</{tag}s>\n")- idx += 1-- # Return block finished, we insert the return type if one was specified- if tag in ["return", "yield"] and return_type is not None:- lines[idx - 1] += f"\n<{tag}type>{return_type}</{tag}type>\n"- elif len(raised_errors) > 0:- # raised errors- lines[idx - 1] += f"\n<raisederrors>{' or '.join(raised_errors)}</raisederrors>\n"-- else:- idx += 1-- result = "\n".join(lines)-- # combine multiple <parameters> blocks into one block- if result.count("<parameters>") > 1:- parameters_blocks = _re_parameters.findall(result)- parameters_blocks = [pb[0].strip() for pb in parameters_blocks]- parameters_str = "\n".join(parameters_blocks)- result = _re_parameters.sub("", result)- result += f"\n<parameters>{parameters_str}</parameters>\n"-- return result---_re_list = re.compile(r"^\s*(-|\*|\d+\.)\s")-_re_autodoc = re.compile(r"^\s*\[\[autodoc\]\]\s+(\S+)\s*$")---def remove_indent(text):- """- Remove indents in text, except the one linked to lists (or sublists).- """- lines = text.split("\n")- # List of indents to remember for nested lists- current_indents = []- # List of new indents to remember for nested lists- new_indents = []- is_inside_code = False- code_indent = 0- for idx, line in enumerate(lines):- # Line is an item in a list.- if _re_list.search(line) is not None:- indent = find_indent(line)- # Is it a new list / new level of nestedness?- if len(current_indents) == 0 or indent > current_indents[-1]:- current_indents.append(indent)- new_indent = 0 if len(new_indents) == 0 else new_indents[-1]- lines[idx] = " " * new_indent + line[indent:]- new_indent += len(_re_list.search(line).groups()[0]) + 1- new_indents.append(new_indent)- # Otherwise it's an existing level of list (current one, or previous one)- else:- # Let's find the proper level of indentation- level = len(current_indents) - 1- while level >= 0 and current_indents[level] != indent:- level -= 1- current_indents = current_indents[: level + 1]- new_indents = new_indents[:level]- new_indent = 0 if len(new_indents) == 0 else new_indents[-1]- lines[idx] = " " * new_indent + line[indent:]- new_indent += len(_re_list.search(line).groups()[0]) + 1- new_indents.append(new_indent)-- # Line is an autodoc, we keep the indent for the list just after if there is one.- elif _re_autodoc.search(line) is not None:- indent = find_indent(line)- current_indents = [indent]- new_indents = [4]- lines[idx] = line.strip()-- # Deal with empty lines separately- elif is_empty_line(line):- lines[idx] = ""-- # Code blocks- elif line.lstrip().startswith("```"):- is_inside_code = not is_inside_code- if is_inside_code:- code_indent = find_indent(line)- lines[idx] = line[code_indent:]- elif is_inside_code:- lines[idx] = line[code_indent:]-- else:- indent = find_indent(line)- if len(current_indents) > 0 and indent > current_indents[-1]:- lines[idx] = " " * new_indents[-1] + line[indent:]- elif len(current_indents) > 0:- # Let's find the proper level of indentation- level = len(current_indents) - 1- while level >= 0 and current_indents[level] > indent:- level -= 1- current_indents = current_indents[: level + 1]- if level >= 0:- if current_indents[level] < indent:- new_indents = new_indents[: level + 1]- else:- new_indents = new_indents[:level]- new_indent = 0 if len(new_indents) == 0 else new_indents[-1]- lines[idx] = " " * new_indent + line[indent:]- new_indents.append(new_indent)- else:- new_indents = []- lines[idx] = line[indent:]- else:- lines[idx] = line[indent:]-- return "\n".join(lines)---def base_rst_to_mdx(text, page_info, unindent=True):- """- Convert a text from rst to mdx, with the base operations necessary for both docstrings and rst docs.- """- text = convert_rst_links(text, page_info)- text = convert_special_chars(text)- text = convert_rst_blocks(text, page_info)- # Convert * in lists to - to avoid the formatting conversion treat them as bold.- text = re.sub(r"^(\s*)\*(\s)", r"\1-\2", text, flags=re.MULTILINE)- text = convert_rst_formatting(text)- return remove_indent(text) if unindent else text---def convert_rst_docstring_to_mdx(docstring, page_info):- """- Convert a docstring written in rst to mdx.- """- text = parse_rst_docstring(docstring)- return base_rst_to_mdx(text, page_info)---def process_titles(lines):- """Converts rst titles to markdown titles."""- title_chars = """= - ` : ' " ~ ^ _ * + # < >""".split(" ")- title_levels = {}- new_lines = []- for line in lines:- if (- len(new_lines) > 0- and len(line) >= len(new_lines[-1])- and len(set(line)) == 1- and line[0] in title_chars- and line != "::"- ):- char = line[0]- level = title_levels.get(char, len(title_levels) + 1)- if level not in title_levels:- title_levels[char] = level- new_lines[-1] = f"{'#' * level} {new_lines[-1]}"- else:- new_lines.append(line)- return new_lines---# Matches lines with a pattern of a table new line in rst.-_re_ignore_line_table = re.compile(r"^(\+[\-\s]+)+\+\s*$")-# Matches lines with a pattern of a table new line in rst, with a first column empty.-_re_ignore_line_table1 = re.compile(r"^\|\s+(\+[\-\s]+)+\+\s*$")-# Matches lines with a pattern of a first table line in rst.-_re_sep_line_table = re.compile(r"^(\+[=\s]+)+\+\s*$")-# Re pattern that catches anchors of the type .. reference:-_re_anchor_section = re.compile(r"^\.\.\s+_(\S+):")---def split_pt_tf_code_blocks(text):- """- Split PyTorch and TensorFlow specific block codes.- """- lines = text.split("\n")- new_lines = []- idx = 0- while idx < len(lines):- if lines[idx].startswith("```"):- code_lines = {"common": [lines[idx]], "pytorch": [], "tensorflow": []}- is_pytorch = False- is_tensorflow = False- idx += 1- while idx < len(lines) and lines[idx].strip() != "```":- if "## PYTORCH CODE" in lines[idx]:- is_pytorch = True- is_tensorflow = False- elif "## TENSORFLOW CODE" in lines[idx]:- is_tensorflow = True- is_pytorch = False- elif is_pytorch:- code_lines["pytorch"].append(lines[idx])- elif is_tensorflow:- code_lines["tensorflow"].append(lines[idx])- else:- code_lines["common"].append(lines[idx])- idx += 1- if len(code_lines["pytorch"]) > 0 or len(code_lines["tensorflow"]) > 0:- block_lines = ["<frameworkcontent>", "<pt>"]- block_lines.extend(code_lines["common"].copy() + code_lines["pytorch"])- block_lines.extend(["```", "</pt>", "<tf>"])- block_lines.extend(code_lines["common"].copy() + code_lines["tensorflow"])- block_lines.extend(["```", "</tf>", "</frameworkcontent>"])- new_lines.extend(block_lines)- else:- block_lines = code_lines["common"] + ["```"]- new_lines.extend(block_lines)- idx += 1- else:- new_lines.append(lines[idx])- idx += 1- return "\n".join(new_lines)---def convert_rst_to_mdx(rst_text, page_info, add_imports=True):- """- Convert a document written in rst to mdx.- """- lines = rst_text.split("\n")- lines = process_titles(lines)- if add_imports:- new_lines = [- '<script lang="ts">',- ' import Tip from "$lib/Tip.svelte";',- ' import Youtube from "$lib/Youtube.svelte";',- ' import Docstring from "$lib/Docstring.svelte";',- ' import CodeBlock from "$lib/CodeBlock.svelte";',- ' import CodeBlockFw from "$lib/CodeBlockFw.svelte";',- ' import DocNotebookDropdown from "$lib/DocNotebookDropdown.svelte";',- ' import CourseFloatingBanner from "$lib/CourseFloatingBanner.svelte";',- ' import IconCopyLink from "$lib/IconCopyLink.svelte";',- ' import FrameworkContent from "$lib/FrameworkContent.svelte";',- ' import Markdown from "$lib/Markdown.svelte";',- ' import ExampleCodeBlock from "$lib/ExampleCodeBlock.svelte";',- ' import Added from "$lib/Added.svelte";',- ' import Changed from "$lib/Changed.svelte";',- ' import Deprecated from "$lib/Deprecated.svelte";',- ' import PipelineIcon from "$lib/PipelineIcon.svelte";',- ' import PipelineTag from "$lib/PipelineTag.svelte";',- " ",- ' export let fw: "pt" | "tf"',- "</script>",- "<svelte:head>",- '<meta name="hf:doc:metadata" content={JSON.stringify(metadata)} >',- "</svelte:head>",- "",- ]- else:- new_lines = []- for line in lines:- if _re_ignore_line_table.search(line) is not None:- continue- elif _re_ignore_line_table1.search(line) is not None:- continue- elif _re_sep_line_table.search(line) is not None:- line = line.replace("=", "-").replace("+", "|")- elif _re_anchor_section.search(line) is not None:- anchor_name = _re_anchor_section.search(line).groups()[0]- line = f"<a id='{anchor_name}'></a>"- new_lines.append(line)- text = "\n".join(new_lines)-- return split_pt_tf_code_blocks(base_rst_to_mdx(text, page_info))diff --git a/fern/generators/python_sdk/autodoc_core/external.py b/fern/generators/python_sdk/autodoc_core/external.pydeleted file mode 100644index c533769f8..000000000--- a/fern/generators/python_sdk/autodoc_core/external.py+++ /dev/null@@ -1,153 +0,0 @@-# coding=utf-8-# Copyright 2022 The HuggingFace Team. All rights reserved.-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.--import os-import re-import tempfile-import zlib--import git-import requests---HF_DOC_PREFIX = "https://huggingface.co/docs/"-EXTERNAL_DOC_OBJECTS_CACHE = {}-HUGGINFACE_LIBS = [- "accelerate",- "datasets",- "evaluate",- "huggingface_hub",- "optimum",- "tokenizers",- "transformers",- "trl",-]---def post_process_objects_inv(object_data, doc_url):- """- Post-processes the data in sphinx-like format to get a dictionary object_name: link in doc.-- Args:- object_data (`str`): The data in the `objects.inv` object (except the first 4 lines).- doc_url (`str`): The documentation url of the package.- """- links = {}- for line in object_data:- if len(line) == 0:- continue- name, typ, _, link = line.split(" ")[:4]- if typ in ["py:class", "py:function", "py:method"]:- link = link.replace("$", name)- links[name] = f"{doc_url}/{link}"- return links---def get_stable_version(package_name, repo_owner="huggingface", repo_name=None):- """- Gets the version of the last release of a package.-- Args:- package_name (`str`): The name of the package.- repo_owner (`str`): The owner of the GitHub repo.- repo_name (`str`, *optional*, defaults to `package_name`):- The name of the GitHub repo. If not provided, will be the same as the package name.- """- repo_name = repo_name if repo_name is not None else package_name- github_url = f"https://github.com/{repo_owner}/{repo_name}"- try:- # Get the version tags from the GitHub repo in decreasing order (that's what '-v:refname' means)- result = git.cmd.Git().ls_remote(github_url, sort="-v:refname", tags=True)- except git.GitCommandError:- return "main"-- # One line per tag- for line in result.split("\n"):- # Lines returned are {sha}\trefs/tags/{tag}^{}, we grab the tag- candidate = line.split("/")[-1].replace("^", "").replace("{}", "")- # Some tags are not versions (looking at your VERSION and delete tags Datasets)- if re.search(r"v?\d+\.\d+\.\d+", candidate):- # Add the v is missing (looking at you Datasets :-p)- return candidate if candidate.startswith("v") else f"v{candidate}"-- return "main"---def get_objects_map(package_name, version="main", language="en", repo_owner="huggingface", repo_name=None):- """- Downloads the `objects.inv` for a package and post-processes it to get a nice dictionary.-- Args:- package_name (`str`): The name of the external package.- version (`str`, *optional*, defaults to `"main"`): The version of the package for which documentation is built.- language (`str`, *optional*, defaults to `"en"`): The language of the documentation being built.- repo_owner (`str`, *optional*, defaults to `"huggingface"`): The owner of the GitHub repo.- repo_name (`str`, *optional*, defaults to `package_name`):- The name of the GitHub repo. If not provided, it will be the same as the package name.- """- repo_name = repo_name if repo_name is not None else package_name- # We link to main in `package_name` from the main doc (or PR docs) but to the last stable release otherwise.- if version in ["main", "master"] or version.startswith("pr_"):- package_version = "main"- else:- package_version = get_stable_version(package_name, repo_owner, repo_name)-- doc_url = f"{HF_DOC_PREFIX}{package_name}/{package_version}/{language}"- url = f"{doc_url}/objects.inv"- try:- request = requests.get(url, stream=True)- request.raise_for_status()- with tempfile.TemporaryDirectory() as tmp_dir:- tmp_file = os.path.join(tmp_dir, "objects.inv")- with open(tmp_file, "ab") as writer:- for chunk in request.iter_content(chunk_size=1024):- if chunk: # filter out keep-alive new chunks- writer.write(chunk)-- with open(tmp_file, "rb") as reader:- object_lines = reader.readlines()[4:]- object_data = zlib.decompress(b"".join(object_lines)).decode().split("\n")- return post_process_objects_inv(object_data, doc_url)- except Exception:- return {}---def get_external_object_link(object_name, page_info):- if object_name.startswith("~"):- object_name = object_name[1:]- link_name = object_name.split(".")[-1]- else:- link_name = object_name-- version = page_info.get("version", "main")- language = page_info.get("language", "en")- if language != "en":- # No resolving for other languages then English as we don't translate API doc pages/docstrings for now.- return f"`{link_name}`"-- package_name = object_name.split(".")[0]- if package_name not in HUGGINFACE_LIBS:- # No resolving for non-HF libs for now.- return f"`{link_name}`"-- if package_name not in EXTERNAL_DOC_OBJECTS_CACHE:- EXTERNAL_DOC_OBJECTS_CACHE[package_name] = get_objects_map(package_name, version=version, language=language)- object_url = EXTERNAL_DOC_OBJECTS_CACHE[package_name].get(object_name, None)-- if object_url is None:- # Object not found in the lib- return f"`{link_name}`"- else:- return f"[{link_name}]({object_url})"diff --git a/fern/generators/python_sdk/generate_docs.py b/fern/generators/python_sdk/generate_docs.pydeleted file mode 100644index 0eda95829..000000000--- a/fern/generators/python_sdk/generate_docs.py+++ /dev/null@@ -1,56 +0,0 @@-#!/usr/bin/env python-"""-Generate SDK documentation for Composio Python SDK.--Usage:- uv run python generators/python-sdk/generate_docs.py-"""-import sys-from pathlib import Path--# Add current directory to path-sys.path.insert(0, str(Path(__file__).parent))--# Add local python package directory to path (for local composio package)-workspace_root = Path(__file__).parent.parent.parent.parent-python_dir = workspace_root / "python"-if python_dir.exists():- sys.path.insert(0, str(python_dir))- print(f"Using local composio package from: {python_dir}")-else:- print(f"Warning: Local python directory not found at {python_dir}")--from generators.python_sdk.process_sdk_docs import build_sdk_docs---def main():- """Generate SDK documentation."""- fern_dir = Path(__file__).parent.parent.parent- source_dir = fern_dir / "generators" / "python_sdk" / "templates"- output_dir = fern_dir / "pages" / "dist" / "sdk" / "python"-- print("Generating Composio Python SDK documentation...")- print(f"Source: {source_dir}")- print(f"Output: {output_dir}")-- try:- anchors = build_sdk_docs(- source_dir=source_dir,- output_dir=output_dir,- package_name="composio",- version="next",- clean=False # Don't clean to preserve other files- )-- print(f"\n✓ Successfully generated documentation with {len(anchors)} anchors")- print(f"✓ Output written to: {output_dir}")-- except Exception as e:- print(f"\n✗ Error generating documentation: {e}")- import traceback- traceback.print_exc()- sys.exit(1)---if __name__ == "__main__":- main()\ No newline at end of filediff --git a/fern/generators/python_sdk/markdown_formatter.py b/fern/generators/python_sdk/markdown_formatter.pydeleted file mode 100644index 667a42b5e..000000000--- a/fern/generators/python_sdk/markdown_formatter.py+++ /dev/null@@ -1,286 +0,0 @@-"""-Custom markdown formatter for autodoc output-"""-import json-import re-from typing import List, Dict, Optional, Tuple--def format_signature_markdown(name: str, anchor: str, signature: List[Dict[str, str]],- object_doc: str, source_link: Optional[str] = None,- is_getset_desc: bool = False) -> str:- """- Generate markdown documentation instead of XML/Svelte components.-- This replaces get_signature_component() to output clean Markdown.- """- output = []-- # Extract structured data from the docstring- doc_data = parse_structured_docstring(object_doc)-- # Add the main heading with an invisible anchor- # Determine heading level based on whether it's a class or method- if name.startswith('class '):- class_name = name.replace('class ', '')- heading = f'<a id="{anchor}"></a>\n\n### `{class_name}`\n'- elif '.' in anchor and not name.startswith('class'):- # This is a method - use h4- heading = f'<a id="{anchor}"></a>\n\n#### `{name}`\n'- else:- heading = f'<a id="{anchor}"></a>\n\n### `{name}`\n'- output.append(heading)-- # Add source link if available- if source_link:- output.append(f"[View source]({source_link})\n")-- # Add signature- if signature and not is_getset_desc:- params = []- for param in signature:- param_str = param["name"] + param["val"]- params.append(param_str)-- # Format signature in a code block- if name.startswith("class "):- class_name = name.replace("class ", "")- output.append(f"```python\n{class_name}({', '.join(params)})\n```\n")- else:- output.append(f"```python\n{name}({', '.join(params)})\n```\n")-- # Add the main description- if doc_data['description']:- output.append(doc_data['description'] + "\n")-- # Add parameters section- if doc_data['parameters']:- # Format parameters as a table- table = format_parameters_table(doc_data['parameters'])- output.append(table + "\n")-- # Add returns section- if doc_data['returns']:- # Parse the return description- return_desc = parse_return_line(doc_data['returns'])- if not return_desc:- # If not in :return: format, use the raw text- return_desc = doc_data['returns']-- # Format the return value- if doc_data['return_type']:- output.append(f"**Returns:** `{doc_data['return_type']}` — {return_desc}\n")- else:- output.append(f"**Returns:** {return_desc}\n")-- # Add raises section- if doc_data['raises']:- output.append("**Raises:**\n")- output.append(doc_data['raises'] + "\n")-- # Add examples- if doc_data['examples']:- for example in doc_data['examples']:- output.append(example + "\n")-- return "\n".join(output)---def parse_param_line(line: str) -> Tuple[Optional[str], Optional[str]]:- """- Parse a parameter line like ":param name: description" into (name, description).- """- match = re.match(r':param\s+(\w+):\s*(.+)', line.strip())- if match:- return match.group(1), match.group(2)- return None, None---def parse_return_line(line: str) -> Optional[str]:- """- Parse a return line like ":return: description" into description.- """- match = re.match(r':return:\s*(.+)', line.strip())- if match:- return match.group(1)- return None---def format_parameters_table(params_text: str) -> str:- """- Convert parameter text into a markdown table.- """- lines = params_text.strip().split('\n')- params = []-- for line in lines:- name, desc = parse_param_line(line)- if name and desc:- params.append((name, desc))-- if not params:- return params_text # Return original if no params found-- # Build markdown table- table = ["| Parameter | Description |", "| --- | --- |"]- for name, desc in params:- # Clean up the description - remove trailing period if present- desc = desc.rstrip('.')- table.append(f"| `{name}` | {desc} |")-- return "\n".join(table)---def parse_structured_docstring(docstring: str) -> Dict[str, any]:- """- Parse the structured docstring that contains XML tags and extract the data.- Also handles RST-style parameter documentation.- """- data = {- 'description': '',- 'parameters': None,- 'returns': None,- 'return_type': None,- 'raises': None,- 'examples': []- }-- # First, check for XML-wrapped sections- # Parameters- params_match = re.search(r'<parameters>(.*?)</parameters>', docstring, re.DOTALL)- if params_match:- data['parameters'] = params_match.group(1).strip()- docstring = docstring.replace(params_match.group(0), '')-- # Returns- returns_match = re.search(r'<returns>(.*?)</returns>', docstring, re.DOTALL)- if returns_match:- data['returns'] = returns_match.group(1).strip()- docstring = docstring.replace(returns_match.group(0), '')-- # Return type- rettype_match = re.search(r'<returntype>(.*?)</returntype>', docstring, re.DOTALL)- if rettype_match:- data['return_type'] = rettype_match.group(1).strip()- docstring = docstring.replace(rettype_match.group(0), '')-- # Raises- raises_match = re.search(r'<raises>(.*?)</raises>', docstring, re.DOTALL)- if raises_match:- data['raises'] = raises_match.group(1).strip()- docstring = docstring.replace(raises_match.group(0), '')-- # Examples- example_matches = re.findall(r'<ExampleCodeBlock[^>]*>(.*?)</ExampleCodeBlock>', docstring, re.DOTALL)- for match in example_matches:- data['examples'].append(match.strip())- docstring = docstring.replace(match, '')-- # If no XML parameters found, look for RST-style parameters- if not data['parameters']:- lines = docstring.split('\n')- param_lines = []- return_lines = []- description_lines = []- in_params = False- in_return = False-- for line in lines:- if line.strip().startswith(':param '):- in_params = True- in_return = False- param_lines.append(line)- elif line.strip().startswith(':return:'):- in_params = False- in_return = True- return_lines.append(line)- elif line.strip().startswith(':raises:') or line.strip().startswith(':rtype:'):- in_params = False- in_return = False- # Handle other RST fields if needed- elif in_params and line.strip():- param_lines.append(line)- elif in_return and line.strip():- return_lines.append(line)- elif not in_params and not in_return and not line.strip().startswith(':'):- description_lines.append(line)-- if param_lines:- data['parameters'] = '\n'.join(param_lines)- if return_lines:- data['returns'] = '\n'.join(return_lines)-- # Clean up description- data['description'] = '\n'.join(description_lines).strip()- else:- # The remaining docstring is the description- data['description'] = docstring.strip()-- return data---def create_custom_autodoc(original_autodoc):- """- Wrapper that modifies autodoc to use markdown formatting.- """- def markdown_autodoc(object_name, package, methods=None, return_anchors=False,- page_info=None, version_tag_suffix="src/"):- # Get the original result- result = original_autodoc(object_name, package, methods=methods,- return_anchors=return_anchors, page_info=page_info,- version_tag_suffix=version_tag_suffix)-- if return_anchors:- doc, anchors, errors = result- # Convert the XML documentation to markdown- doc = convert_xml_to_markdown(doc)- return doc, anchors, errors- else:- # Convert the XML documentation to markdown- return convert_xml_to_markdown(result)-- return markdown_autodoc---def convert_xml_to_markdown(xml_doc: str) -> str:- """- Convert the XML/Svelte component output to clean Markdown.- """- output_parts = []-- # Remove all wrapping divs- xml_doc = re.sub(r'<div class="[^"]*">\s*', '', xml_doc, flags=re.DOTALL)- xml_doc = re.sub(r'</div>\s*', '', xml_doc, flags=re.DOTALL)-- # Find all docstring components (main class + methods)- docstring_pattern = r'<docstring>(.*?)</docstring>(.*?)(?=<docstring>|$)'- matches = re.findall(docstring_pattern, xml_doc, re.DOTALL)-- if not matches:- # No docstring components found, return as-is- return xml_doc-- for docstring_content, remaining_doc in matches:- # Parse each docstring component- name_match = re.search(r'<name>(.*?)</name>', docstring_content)- anchor_match = re.search(r'<anchor>(.*?)</anchor>', docstring_content)- source_match = re.search(r'<source>(.*?)</source>', docstring_content)- params_match = re.search(r'<parameters>(.*?)</parameters>', docstring_content)-- name = name_match.group(1) if name_match else ""- anchor = anchor_match.group(1) if anchor_match else ""- source = source_match.group(1) if source_match else None-- # Parse parameters- signature = []- if params_match:- try:- signature = json.loads(params_match.group(1))- except:- pass-- # Format this component- formatted = format_signature_markdown(name, anchor, signature, remaining_doc.strip(), source)- output_parts.append(formatted)-- # Join all parts with appropriate spacing- return "\n\n".join(output_parts)\ No newline at end of filediff --git a/fern/generators/python_sdk/process_sdk_docs.py b/fern/generators/python_sdk/process_sdk_docs.pydeleted file mode 100644index 0ef536d59..000000000--- a/fern/generators/python_sdk/process_sdk_docs.py+++ /dev/null@@ -1,172 +0,0 @@-#!/usr/bin/env python-"""-Process SDK documentation files with autodoc markers.--This is a simplified version that doesn't require toctree validation.-"""-import os-import re-import importlib-import logging-from pathlib import Path-from typing import Dict, Optional, Tuple-from tqdm import tqdm--from .autodoc_core.autodoc import autodoc, resolve_links_in_text-from .markdown_formatter import convert_xml_to_markdown--# Pattern to find [[autodoc]] markers-_re_autodoc = re.compile(r"^\s*\[\[autodoc\]\]\s+(\S+)\s*$")--# Setup logging-logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')-logger = logging.getLogger(__name__)---def process_autodoc_file(- file_path: Path,- package,- page_info: Dict[str, str],- version_tag_suffix: str = "python/"-) -> Tuple[str, Dict[str, str]]:- """- Process a single file containing autodoc markers.-- Args:- file_path: Path to the markdown file- package: The Python package to document- page_info: Information about the documentation page- version_tag_suffix: Suffix for version tags in links-- Returns:- Tuple of (processed content, anchor mapping)- """- with open(file_path, 'r', encoding='utf-8') as f:- lines = f.read().split('\n')-- new_lines = []- idx = 0- anchors = {}-- while idx < len(lines):- if _re_autodoc.search(lines[idx]) is not None:- object_name = _re_autodoc.search(lines[idx]).groups()[0]- logger.info(f"Processing autodoc: {object_name}")-- try:- result = autodoc(- object_name,- package,- return_anchors=True,- page_info=page_info,- version_tag_suffix=version_tag_suffix- )-- doc, new_anchors, errors = result- doc = convert_xml_to_markdown(doc)-- # Collect anchors- page_name = file_path.stem- for anchor in new_anchors:- if isinstance(anchor, tuple):- for a in anchor:- anchors[a] = page_name- else:- anchors[anchor] = page_name-- if errors:- logger.warning(f"Autodoc warnings for {object_name}: {errors}")-- new_lines.append(doc.strip())-- except Exception as e:- logger.error(f"Error processing {object_name}: {e}")- new_lines.append(lines[idx])- else:- new_lines.append(lines[idx])-- idx += 1-- content = '\n'.join(new_lines)- return content, anchors---def build_sdk_docs(- source_dir: Path,- output_dir: Path,- package_name: str,- version: str = "main",- clean: bool = False-):- """- Build SDK documentation from markdown files with autodoc markers.-- Args:- source_dir: Directory containing source markdown files- output_dir: Directory where processed files will be written- package_name: Name of the Python package to document- version: Version of the documentation- clean: Whether to clean the output directory before building- """- source_dir = Path(source_dir)- output_dir = Path(output_dir)-- if not source_dir.exists():- raise ValueError(f"Source directory {source_dir} does not exist")-- # Clean output directory if requested- if clean and output_dir.exists():- import shutil- shutil.rmtree(output_dir)-- output_dir.mkdir(parents=True, exist_ok=True)-- # Import the package- try:- package = importlib.import_module(package_name)- except ImportError as e:- raise ImportError(f"Failed to import package {package_name}: {e}")-- # Page info for documentation- page_info = {- "version": version,- "version_tag": version,- "language": "en",- "package_name": package_name,- }-- # Phase 1: Process all files and collect anchors- logger.info("Phase 1: Processing autodoc markers and collecting anchors")- all_anchors = {}- file_contents = {}-- markdown_files = list(source_dir.glob("**/*.md")) + list(source_dir.glob("**/*.mdx"))-- for file_path in tqdm(markdown_files, desc="Processing files"):- if file_path.is_file():- logger.info(f"Processing: {file_path}")- content, anchors = process_autodoc_file(file_path, package, page_info)-- # Store content and anchors- relative_path = file_path.relative_to(source_dir)- file_contents[relative_path] = content- all_anchors.update(anchors)-- logger.info(f"Collected {len(all_anchors)} anchors")-- # Phase 2: Resolve cross-references- logger.info("Phase 2: Resolving cross-references")-- for relative_path, content in tqdm(file_contents.items(), desc="Resolving links"):- # Resolve cross-references- resolved_content = resolve_links_in_text(content, package, all_anchors, page_info)-- # Write output file- output_path = output_dir / relative_path- output_path.parent.mkdir(parents=True, exist_ok=True)-- with open(output_path, 'w', encoding='utf-8') as f:- f.write(resolved_content)-- logger.info(f"Documentation built successfully in {output_dir}")- return all_anchors\ No newline at end of filediff --git a/fern/generators/python_sdk/templates/index.mdx b/fern/generators/python_sdk/templates/index.mdxdeleted file mode 100644index e69de29bb..000000000diff --git a/fern/generators/python_sdk/templates/sdk-reference.md b/fern/generators/python_sdk/templates/sdk-reference.mddeleted file mode 100644index f0564260d..000000000--- a/fern/generators/python_sdk/templates/sdk-reference.md+++ /dev/null@@ -1,55 +0,0 @@-# Composio Python SDK Reference--This is the comprehensive SDK reference for the Composio Python SDK.--## Main SDK Class--The main entry point for the Composio SDK.--[[autodoc]] composio.Composio--## Core Models--### Tools--[[autodoc]] composio.core.models.Tools--### Toolkits--[[autodoc]] composio.core.models.Toolkits--### Connected Accounts--[[autodoc]] composio.core.models.ConnectedAccounts--### Auth Configs--[[autodoc]] composio.core.models.AuthConfigs--### Triggers--[[autodoc]] composio.core.models.Triggers--## Decorators--### before_execute--[[autodoc]] composio.before_execute--### after_execute--[[autodoc]] composio.after_execute--### schema_modifier--[[autodoc]] composio.schema_modifier--## Cross References--The [`Composio`] class is the main entry point for all SDK operations. It provides access to:-- [`Tools`] for tool management and execution-- [`Toolkits`] for toolkit operations-- [`ConnectedAccounts`] for managing authentication-- [`Triggers`] for webhook and event handling--When you call [`Tools.execute`], it can use the [`before_execute`] and [`after_execute`] decorators to modify behavior.\ No newline at end of filediff --git a/fern/generators/python_sdk/test_generator.py b/fern/generators/python_sdk/test_generator.pydeleted file mode 100644index f5f67104e..000000000--- a/fern/generators/python_sdk/test_generator.py+++ /dev/null@@ -1,83 +0,0 @@-#!/usr/bin/env python-"""-Test the SDK documentation generator-"""-import sys-from pathlib import Path-import tempfile-import shutil--# Add current directory to path-sys.path.insert(0, str(Path(__file__).parent))--from process_sdk_docs import build_sdk_docs---def test_generator():- """Test the documentation generator with a simple example."""-- # Use the actual fern directory structure- fern_dir = Path(__file__).parent.parent.parent- source_dir = fern_dir / "generators" / "python-sdk" / "templates"- output_dir = fern_dir / "docs" / "sdk" / "python"-- # Create source directory if it doesn't exist- source_dir.mkdir(parents=True, exist_ok=True)-- # Create a test markdown file- test_file = source_dir / "sdk-reference.md"- if not test_file.exists():- test_file.write_text("""# Composio SDK Reference--## Main Class--[[autodoc]] composio.Composio--## Tools--[[autodoc]] composio.core.models.Tools--## Cross References--The [`Composio`] class is the main entry point.-""")-- print(f"Created test file: {test_file}")- print("Running documentation generator...")-- try:- # Run the generator- anchors = build_sdk_docs(- source_dir=source_dir,- output_dir=output_dir,- package_name="composio",- version="test",- repo_owner="composio"- )-- print(f"\nGenerated {len(anchors)} anchors")- print("\nOutput files:")- for file in output_dir.rglob("*"):- if file.is_file():- print(f" - {file.relative_to(output_dir)}")- print(f" Size: {file.stat().st_size} bytes")-- # Read and display the output- output_file = output_dir / "sdk-reference.md"- if output_file.exists():- print("\nGenerated content preview:")- print("-" * 50)- content = output_file.read_text()- print(content[:500] + "..." if len(content) > 500 else content)- print("-" * 50)-- print("\nTest completed successfully!")-- except Exception as e:- print(f"\nError during test: {e}")- import traceback- traceback.print_exc()---if __name__ == "__main__":- test_generator()\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/__init__.py b/fern/generators/tool_doc_generator/__init__.pydeleted file mode 100644index a83b8f58c..000000000--- a/fern/generators/tool_doc_generator/__init__.py+++ /dev/null@@ -1 +0,0 @@-"""Tool Documentation Generator for Composio."""\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/base_docs.py b/fern/generators/tool_doc_generator/base_docs.pydeleted file mode 100644index 408ddb5fc..000000000--- a/fern/generators/tool_doc_generator/base_docs.py+++ /dev/null@@ -1,18 +0,0 @@-base_layout = [- {- "section": "Toolkits",- "skip-slug": True,- "contents": [- {- "page": "Introduction",- "path": "toolkits/src/introduction.mdx",- "slug": "toolkits/introduction"- },- {- "page": "Premium Tools",- "path": "toolkits/src/premium-tools.mdx",- "slug": "toolkits/premium-tools"- }- ]- }-]diff --git a/fern/generators/tool_doc_generator/main.py b/fern/generators/tool_doc_generator/main.pydeleted file mode 100644index 66503a46d..000000000--- a/fern/generators/tool_doc_generator/main.py+++ /dev/null@@ -1,986 +0,0 @@-#!/usr/bin/env python-"""-Tool Documentation Generator for Composio.--This script automates the generation of MDX documentation for Composio tools.-"""--import argparse-import concurrent.futures-import html-import logging-import os-import re-import sys-import threading-import traceback-import typing as t-from dataclasses import dataclass, field-from pathlib import Path--# Disable telemetry to avoid background network requests-os.environ["COMPOSIO_TELEMETRY_DISABLED"] = "true"-os.environ["COMPOSIO_DISABLE_TELEMETRY"] = "true"-os.environ["TELEMETRY_DISABLED"] = "true"--# Import MDX linting functionality-from composio import Composio-from composio.client.types import (- Tool,- toolkit_list_response,- toolkit_retrieve_response,-)-from dotenv import load_dotenv-from inflection import titleize-from generators.tool_doc_generator.mdx_formatter import MDX-from generators.tool_doc_generator.base_docs import base_layout--# Import from the same directory---IMPORTANT_TOOL_SLUGS = [- "twitter",- "gmail",- "github",- "notion",- "googlesheets",- "shopify",- "stripe",-]---try:- from ruamel.yaml import YAML-- USE_RUAMEL = True-except ImportError:- # Fallback to standard yaml if ruamel.yaml is not available- import yaml as yaml_module # Renamed to avoid unused import warning-- USE_RUAMEL = False- logger = logging.getLogger(__name__)- logger.warning(- "ruamel.yaml not found, falling back to standard yaml. Install with: uv pip install ruamel.yaml"- )---# Configure logging-logger = logging.getLogger(__name__)---class TelemetryFilter(logging.Filter):- """Filter out telemetry-related log messages"""-- def filter(self, record):- # Filter out telemetry-related messages- message = record.getMessage()- telemetry_keywords = [- "telemetry.composio.dev",- "telemetry",- "TELEMETRY",- "metrics/invocations",- "errors",- ]-- # Also filter by logger name- if "telemetry" in record.name.lower():- return False-- # Filter by message content- for keyword in telemetry_keywords:- if keyword in message:- return False-- return True---def sanitize_html(text: str) -> str:- """- Sanitize HTML content by removing HTML tags and decoding HTML entities.- Also escapes problematic characters that might break MDX parsing.-- Args:- text: The text to sanitize-- Returns:- Sanitized text safe for MDX- """- if not text:- return ""-- # Convert text to string if it's not already- text = str(text)-- # Remove HTML tags- text = re.sub(r"<.*?>", "", text)-- # Handle comparison operators that break MDX- # These are the specific patterns we saw in the error output- text = re.sub(r"<(\d+)", r"less than \1", text) # <4mb -> less than 4mb- text = re.sub(r">(\d+)", r"greater than \1", text) # >10 -> greater than 10- text = re.sub(r"<=(\d+)", r"less than or equal to \1", text)- text = re.sub(r">=(\d+)", r"greater than or equal to \1", text)-- # For standalone < and > characters, replace with safer alternatives- text = re.sub(r"(?<!\w)<(?!\w)", "<", text)- text = re.sub(r"(?<!\w)>(?!\w)", ">", text)-- # Replace quote types that can break MDX-- # Escape pipe characters that can break tables- text = text.replace("|", "\\|")- text = re.sub(r"\{([^}]*)\s+([^}]*)\}", r"{\1_\2}", text)-- # Handle JSON examples with quotes- if "{" in text and "}" in text:- # Replace single and double quotes in JSON with backticks- text = re.sub(- r"(\{[^{}]*\})", lambda m: m.group(0).replace("'", "`").replace('"', "`"), text- )-- # If we still have curly braces, wrap them in code tags- text = re.sub(r"(\{[^{}]+\})", r"`\1`", text)-- # Handle special characters that might trigger MDX parsing- text = text.replace("$", "\\$")- text = text.replace("%", "\\%")-- # Some special HTML entities need to be preserved during unescaping- text = html.unescape(text.replace("<", "_LT_").replace(">", "_GT_"))- text = text.replace("_LT_", "<").replace("_GT_", ">")-- # Remove any trailing/leading whitespace- text = text.strip()-- return text---@dataclass-class DocumentContent:- """Document content builder for Composio tool documentation."""-- _blocks: list[str] = field(default_factory=list)-- def add_frontmatter(self, app_name: str, category: t.Optional[str] = None) -> "DocumentContent":- """- Add frontmatter section to the document.-- Args:- app_name: The name of the application- category: The category of the application-- Returns:- Self reference for method chaining- """- self._blocks.append(MDX.as_frontmatter(app_name, category))- return self-- def add_overview_section(- self,- app_name: str,- app_id: str,- description: str,- auth_schemes: t.Optional[t.List[toolkit_retrieve_response.AuthConfigDetail]] = None,- tags: t.Optional[list] = None,- ) -> "DocumentContent":- """- Add overview section to the document.-- Args:- app_name: The name of the application- app_id: The application ID- description: Application description- auth_schemes: Authentication schemes for the app- tags: Tags supported by the app-- Returns:- Self reference for method chaining- """- # Main overview header- self._blocks.extend(- [- "## Overview",- f"**SLUG**: `{app_id.upper()}`",- f"### Description\n{sanitize_html(description)}",- ]- )-- # Authentication schemes if present- if auth_schemes:- self._add_auth_schemes(auth_schemes)-- # Tags if present- if tags:- self._blocks.append("### Tags Supported")- for tag in tags:- self._blocks.append(f"- `{tag}`")-- return self-- def add_connection_section(- self,- app_name: str,- app_slug: str,- auth_schemes: t.Optional[t.List[toolkit_retrieve_response.AuthConfigDetail]] = None,- ) -> None:- schemes = ", ".join(- self._get_auth_type(s) for s in (auth_schemes or []) if self._extract_auth_fields(s)- )- self._blocks.extend(- [- f"""## Connecting to {app_name}-### Create an auth config-Use the dashboard to create an auth config for the {app_name} toolkit. This allows you to connect multiple {app_name} accounts to Composio for agents to use.--<Steps>- <Step title="Select App">- Navigate to **[{app_name}](https://platform.composio.dev?next_page=/marketplace/{app_name})**.- </Step>- <Step title="Configure Auth Config Settings">- Select among the supported auth schemes of and configure them here.- </Step>- <Step title="Create and Get auth config ID">- Click **"Create {app_name} Auth Config"**. After creation, **copy the displayed ID starting with `ac_`**. This is your auth config ID. This is _not_ a sensitive ID -- you can save it in environment variables or a database.- **This ID will be used to create connections to the toolkit for a given user.**- </Step>-</Steps>-"""- ],- )-- # Add auth code snippets- self._add_auth_section(app_name, app_slug, auth_schemes)-- def _add_auth_section(- self,- app_name: str,- app_slug: str,- auth_schemes: t.List[toolkit_retrieve_response.AuthConfigDetail] = None,- ) -> None:- """Add code snippets for each auth scheme using direct template processing"""- if not auth_schemes:- return-- self._blocks.append("### Connect Your Account")-- # Group auth schemes by type to avoid duplicates- seen_auth_types = set()-- for scheme in auth_schemes:- # Get normalized auth type- auth_type_display = self._get_auth_type(scheme)- auth_type_key = auth_type_display.lower().replace(" ", "_")-- # Skip if we've already shown this auth type or if it's no_auth- if auth_type_key in seen_auth_types or auth_type_key == "no_auth":- continue- seen_auth_types.add(auth_type_key)-- # Add section for this auth type- self._blocks.append(f"#### Using {auth_type_display}")-- # Prepare variables for template replacement- template_vars = {- "toolkit_name": app_name,- "toolkit_slug": app_slug.lower(),- "auth_config_id": f"ac_YOUR_{app_slug.upper()}_CONFIG_ID",- "user_id": "[email protected]",- "api_key_placeholder": f"your_{app_slug.lower()}_api_key",- "username_placeholder": f"your_{app_slug.lower()}_username",- "password_placeholder": f"your_{app_slug.lower()}_password",- "bearer_token_placeholder": f"your_{app_slug.lower()}_bearer_token"- }-- try:- # Create code blocks using the new template method- python_block = MDX.as_code_block_from_template(- f"templates/python/{auth_type_key}.py",- template_vars=template_vars,- title="Python",- max_lines=40,- word_wrap=True- )-- typescript_block = MDX.as_code_block_from_template(- f"templates/typescript/{auth_type_key}.ts",- template_vars=template_vars,- title="TypeScript",- max_lines=40,- word_wrap=True- )-- # Add code blocks wrapped in CodeGroup- self._blocks.append(MDX.as_code_group(python_block, typescript_block))-- except Exception as e:- logger.warning(f"Failed to process auth template for {auth_type_key}: {e}")- # Fallback to a simple message if template processing fails- self._blocks.append(f"*Authentication template for {auth_type_display} coming soon*")-- def _add_auth_schemes(- self, auth_schemes: t.List[toolkit_retrieve_response.AuthConfigDetail]- ) -> None:- """Add authentication schemes section."""- self._blocks.append("### Authentication Details")-- for scheme in auth_schemes:- fields = self._extract_auth_fields(scheme)- if fields:- auth_type = self._get_auth_type(scheme)- self._blocks.append(MDX.as_accordion(auth_type, "\n".join(fields)))-- def _extract_auth_fields(- self, scheme: toolkit_retrieve_response.AuthConfigDetail- ) -> t.List[str]:- """Extract authentication fields from scheme."""- fields = []-- if hasattr(scheme, "fields") and scheme.fields:- for field in scheme.fields:- fields.extend(self._process_tuple_field(field))-- return fields-- def _process_tuple_field(self, field: tuple) -> t.List[str]:- """Process tuple-style authentication field."""- fields = []- _, field_config = field-- for field_list, required in [- (getattr(field_config, "required", []), True),- (getattr(field_config, "optional", []), False),- ]:- for f in field_list:- if hasattr(f, "name"):- fields.append(self._create_param_from_field(f, required))-- return fields-- def _create_param_from_field(- self, field: toolkit_retrieve_response.AuthConfigDetail, required: t.Optional[bool] = None- ) -> str:- """Create parameter string from field object."""- return MDX.as_param(- name=str(field.name).replace('"', '\\"'),- required=required if required is not None else getattr(field, "required", False),- typ=str(getattr(field, "type", "")).replace('"', '\\"'),- default=str(getattr(field, "default", "")).replace('"', '\\"')- if getattr(field, "default", None)- else "",- doc=str(getattr(field, "description", "")).replace('"', '\\"'),- )-- def _get_auth_type(self, scheme: toolkit_retrieve_response.AuthConfigDetail) -> str:- """Get authentication type from scheme."""- auth_type = (- getattr(scheme, "mode", None)- or getattr(scheme, "type", None)- or getattr(scheme, "auth_type", None)- or getattr(scheme, "auth_mode", None)- or "Authentication"- )-- auth_type_mapping = {- "oauth2": "OAuth2",- "OAUTH2": "OAuth2",- "api_key": "API Key",- "API_KEY": "API Key",- "bearer_token": "Bearer Token",- "BEARER_TOKEN": "Bearer Token",- "basic": "Basic Auth",- "BASIC": "Basic Auth",- "no_auth": "No Authentication",- "NO_AUTH": "No Authentication",- }-- return auth_type_mapping.get(auth_type, auth_type.replace("_", " ").title())-- def add_actions(self, actions: t.List[Tool], app_name: str, app_slug: str) -> "DocumentContent":- """- Add actions section to the document.-- Args:- actions: List of tool models to document- app_name: The name of the application- app_slug: The application slug-- Returns:- Self reference for method chaining- """- # If this is the first action, add the Actions header- if not any("## Tools" in block for block in self._blocks):- self._blocks.append("## Tools")- self._blocks.append("### Executing tools")- self._blocks.append(f"""To prototype you can execute some tools to see the responses and working on the [{app_name} toolkit's playground](https://app.composio.dev/app/{app_name})""")- self._blocks.append("")- self._blocks.append("For code examples, see the [Tool calling guide](/tool-calling/executing-tool-calls) and [Provider examples](/provider-apis).")- self._blocks.append("### Tool List")-- action_contents = []-- logger.info(f"Processing {len(actions)} actions for documentation")- for i, tool in enumerate(actions):- content = self._process_tool(tool)- if content:- action_contents.append(content)-- # Only wrap in accordion group if there are actions- if action_contents:- self._blocks.append(MDX.as_accordion_group("\n".join(action_contents)))- else:- logger.info(f"No action content generated for {len(actions)} tools")- self._blocks.append("""This app has actions coming soon! Feel free to raise a request for it in our [GitHub Issues](https://github.com/ComposioHQ/composio/issues).-- You can also create [custom actions](/tool-calling/customizing-tools#extending-composio-toolkits) for the app using Composio Auth.""")- return self-- def _process_tool(self, tool: Tool) -> t.Optional[str]:- """Process a single tool and return accordion content."""- tool_data = self._extract_tool_data(tool)- if not tool_data["name"]:- return None-- content = [- f"**Tool Name:** {self._sanitize_action_name(tool_data['name'])}\n\n**Description**\n",- MDX.as_code_block(tool_data["description"], "text"),- ]-- # Add parameters- content.append("\n**Action Parameters**\n")- content.append("\n".join(self._process_parameters(tool_data["params"])))-- # Add responses- content.append("\n**Action Response**\n")- content.append("\n".join(self._process_parameters(tool_data["response"])))-- # safe_name = self._sanitize_action_name(tool_data['name'])- return MDX.as_accordion(tool_data["slug"], "\n".join(content))-- def _extract_tool_data(self, tool: Tool) -> t.Dict[str, t.Any]:- """Extract data from tool object or dict."""-- return {- "name": tool.name or tool.slug,- "description": tool.description,- "slug": tool.slug,- "params": tool.input_parameters,- "response": tool.output_parameters,- }-- def _process_parameters(self, params: t.Any) -> t.List[str]:- """Process parameters from various formats."""- if not params or not isinstance(params, dict):- return []-- param_list = []-- if "properties" in params:- properties = params.get("properties", {})- required = params.get("required", [])-- for name, schema in properties.items():- param_list.append(- MDX.as_param(- name=name,- typ=str(schema.get("type", "")),- doc=sanitize_html(schema.get("description", "")),- default=schema.get("default", ""),- required=name in required,- )- )- else:- for name, schema in params.items():- if isinstance(schema, dict):- param_list.append(- MDX.as_param(- name=name,- typ=str(schema.get("type", "")),- doc=sanitize_html(schema.get("description", "")),- default=schema.get("default", ""),- required=schema.get("required", False),- )- )-- return param_list-- def _sanitize_action_name(self, name: str) -> str:- """Sanitize action name for MDX."""- if "<" in name or ">" in name:- replacements = [- (r"<(\d+)", r"less than \1"),- (r">(\d+)", r"greater than \1"),- (r"<=(\d+)", r"less than or equal to \1"),- (r">=(\d+)", r"greater than or equal to \1"),- ]- for pattern, replacement in replacements:- name = re.sub(pattern, replacement, name)- name = name.replace("<", "<").replace(">", ">")-- return name-- def __str__(self) -> str:- """Convert document content to string."""- return "\n\n".join(self._blocks)---class ToolDocGenerator:- """- Tool Documentation Generator for Composio.-- Generates MDX documentation files for Composio tools.- """-- def __init__(self, include_local: bool = False):- """- Initialize the tool documentation generator.-- Args:- include_local: Whether to include local development tools- """- # Load environment variables- load_dotenv()-- # Initialize composio client- self.composio = Composio()- self.include_local = include_local-- # For tracking generated tools- self.generated_tools = []- self.problematic_actions = []-- def generate_docs(- self, output_path: Path, max_workers: int | None = None, limit: int | None = None- ) -> None:- """- Generate documentation for all apps in parallel.-- Args:- output_path: Path to output directory- max_workers: Maximum number of parallel workers (default: CPU count * 5)- limit: Limit processing to first N toolkits (for debugging)- """- # Ensure output directory exists- output_path.mkdir(parents=True, exist_ok=True)-- # Get all apps- toolkits = self.composio.toolkits.get()-- # Apply limit if specified- if limit is not None:- toolkits = toolkits[:limit]- logger.info(f"Limited to first {limit} toolkits")-- logger.info(f"Starting documentation generation for {len(toolkits)} toolkits")-- # Track failures with a synchronized list- from threading import Lock-- failed_apps = []- failed_apps_lock = Lock()-- # Set default max workers if not specified- if max_workers is None:- import multiprocessing-- # Use CPU count as default but cap at 10 to avoid connection pool issues- max_workers = min(10, multiprocessing.cpu_count())-- def process_app(toolkit):- """Process a single toolkit with proper exception handling"""- try:- self._generate_app_doc(toolkit, output_path)- logger.info(f"✅ Generated docs for {toolkit.name}")- return True- except Exception as e:- with failed_apps_lock:- failed_apps.append((toolkit.name, str(e)))- logger.error(f"❌ Failed to generate docs for {toolkit.name}: {e}")- if logger.isEnabledFor(logging.DEBUG):- logger.info(traceback.format_exc())- return False-- # Use ThreadPoolExecutor for parallel processing- with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as executor:- # Submit all app processing tasks- future_to_app = {executor.submit(process_app, toolkit): toolkit for toolkit in toolkits}-- # Collect results as they complete- success_count = 0- for future in concurrent.futures.as_completed(future_to_app):- if future.result():- success_count += 1-- # Log final statistics- if failed_apps:- logger.warning("\nFailed to generate docs for the following toolkits:")- for app_name, error in failed_apps:- logger.warning(f"- {app_name}: {error}")- logger.warning(f"\nTotal failed toolkits: {len(failed_apps)}/{len(toolkits)}")- else:- logger.info(f"\nSuccessfully generated docs for all {len(toolkits)} toolkits!")-- logger.info(- f"Generated {success_count} toolkit docs in parallel using {max_workers} workers"- )-- # Update docs.yml with the generated tools- self.update_docs_yml(output_path.parent / "docs.yml")-- def _generate_app_doc(self, toolkit: toolkit_list_response.Item, output_path: Path) -> None:- """- Generate documentation for a single toolkit.-- Args:- toolkit: The toolkit to generate documentation for- output_path: Output directory path- """- # Get toolkit model and tools- toolkit_model = self.composio.toolkits.get(slug=toolkit.slug)- tools = self.composio.tools.get_raw_composio_tools(toolkits=[toolkit.slug], limit=99999)- logger.info(f"Toolkit tools: {toolkit}")-- logger.info(f"Retrieved {len(tools)} tools for {toolkit.name}")-- # Skip toolkits with zero tools- if len(tools) == 0:- logger.info(f"Skipping {toolkit.name} - no tools available")- return-- if tools:- logger.debug(f"First tool type: {type(tools[0])}")- if hasattr(tools[0], "__dict__"):- logger.debug(f"First tool attributes: {list(tools[0].__dict__.keys())}")- elif isinstance(tools[0], dict):- logger.debug(f"First tool dict keys: {list(tools[0].keys())}")- logger.debug(f"Sample tool: {str(tools[0])[:200]}...")-- # Create content- content = DocumentContent()-- # Special case for Monday - use lowercase everywhere- display_name = toolkit.name- if toolkit.name == "Monday":- display_name = "monday"-- # Extract category from toolkit meta- category = None- if toolkit_model.meta.categories:- # Use the first category if multiple exist- category = (- toolkit_model.meta.categories[0].get("name")- if isinstance(toolkit_model.meta.categories[0], dict)- else getattr(toolkit_model.meta.categories[0], "name", None)- )-- # Add frontmatter- content.add_frontmatter(display_name, category)-- # Handle auth schemes safely- auth_schemes = None- try:- auth_schemes = toolkit_model.auth_config_details- except Exception as e:- logger.info(f"Could not process auth schemes for {display_name}: {e}")- # Continue without auth schemes-- no_auth = "NO_AUTH" in (toolkit.auth_schemes or [])-- logger.info(f"No auth: {no_auth}")-- # Add overview section- # For no-auth tools, don't pass auth_schemes to avoid showing authentication details- content.add_overview_section(- app_name=display_name,- app_id=toolkit.slug,- description=toolkit.meta.description,- auth_schemes=None if no_auth else auth_schemes,- )-- # Only add connection section if authentication is required- if not no_auth:- content.add_connection_section(- app_name=display_name, app_slug=toolkit.slug, auth_schemes=auth_schemes- )-- # Filter out problematic actions- filtered_tools = []- for tool in tools:- # Extract tool slug for filtering- if isinstance(tool, dict):- if "function" in tool:- tool_slug = tool["function"].get("name", "")- else:- tool_slug = tool.get("slug", "")- else:- tool_slug = getattr(tool, "slug", "")-- if tool_slug not in self.problematic_actions:- filtered_tools.append(tool)- else:- logger.info(f"Filtered out problematic tool: {tool_slug}")-- logger.info(f"After filtering: {len(filtered_tools)} tools remaining out of {len(tools)}")-- # Add actions section (only the filtered ones)- content.add_actions(filtered_tools, app_name=display_name, app_slug=toolkit.slug)-- # Write to file- filename = f"{toolkit.slug.lower()}.mdx"- output_file = output_path / filename- content_str = str(content)-- output_file.write_text(content_str)-- # Track the generated tool for docs.yml update- with threading.Lock():- # Special case for Monday - keep it lowercase in sidebar too- if toolkit.name == "Monday":- yml_display_name = "monday"- else:- yml_display_name = titleize(toolkit.name.lower())-- self.generated_tools.append(- {- "name": toolkit.slug.lower(),- "display_name": yml_display_name,- "path": f"toolkits/{filename}",- "category": category,- "tool_count": len(tools),- "no_auth": no_auth,- }- )-- def update_docs_yml(self, docs_yml_path: Path) -> None:- """- Update the docs.yml file with the generated tools, grouped by section:- - Important- - Categories (each key becomes a section)- - Proxy Apps- - No Auth-- Args:- docs_yml_path: Path to the docs.yml file- """- import yaml # Use PyYAML for writing-- logger.info(f"Updating docs.yml with {len(self.generated_tools)} tools")-- try:- # Sort tools alphabetically by name- sorted_tools = sorted(self.generated_tools, key=lambda x: x["name"])-- # Prepare sections- important_tools = []- proxy_apps = []- no_auth_tools = []- categories: dict[str, list] = {}-- for tool in sorted_tools:- entry = {- "page": tool["display_name"],- "slug": "toolkits/" + tool["name"],- "path": tool["path"],- }- name = tool["name"]- category = tool.get("category", "").strip()-- if name in IMPORTANT_TOOL_SLUGS:- important_tools.append(entry)- elif tool.get("tool_count") == 0:- proxy_apps.append(entry)- elif tool.get("no_auth"):- no_auth_tools.append(entry)- elif category:- lower_category = category.lower()- if lower_category not in categories:- categories[lower_category] = []- categories[lower_category].append(entry)-- # Read the current docs.yml- with open(docs_yml_path, "r") as f:- docs_data = yaml.safe_load(f)-- logger.info(f"Important tools: {important_tools}")- logger.info(f"Proxy apps: {proxy_apps}")- logger.info(f"No auth tools: {no_auth_tools}")-- # Sort categories by number of elements (descending), then by name- sorted_categories = sorted(- categories.items(), key=lambda item: (-len(item[1]), item[0])- )-- logger.info(f"Category keys: {list(categories.keys())}")- logger.info(f"Sorted categories keys: {[cat for cat, _ in sorted_categories]}")-- # Find the "tools" tab section in the navigation structure- for tab_section in docs_data.get("navigation", []):- if tab_section.get("tab") == "toolkits":- logger.info(f"Tab section: {tab_section}")- new_layout = []-- # Always add the Tool section with Introduction first- new_layout.append(base_layout[0])-- # Add Important section if present- if important_tools:- new_layout.append(- {- "section": "Important",- "skip-slug": True,- "contents": important_tools,- }- )-- # Add each category as its own section- for cat, tools_list in sorted_categories:- if tools_list:- new_layout.append(- {- "section": titleize(cat),- "skip-slug": True,- "contents": tools_list,- }- )-- # Add Proxy Apps section if present- if proxy_apps:- new_layout.append(- {- "section": "Proxy Apps",- "skip-slug": True,- "contents": proxy_apps,- }- )-- # Add No Auth section if present- if no_auth_tools:- new_layout.append(- {- "section": "No Auth",- "skip-slug": True,- "contents": no_auth_tools,- }- )-- logger.info("new_layout: %s", new_layout)- tab_section["layout"] = new_layout- break-- # Write the updated YAML back to the file- with open(docs_yml_path, "w") as f:- yaml.dump(docs_data, f, default_flow_style=False, sort_keys=False)-- logger.info(f"✅ Updated docs.yml with {len(self.generated_tools)} tools")-- except Exception as e:- logger.error(f"Failed to update docs.yml: {e}")- if logger.isEnabledFor(logging.DEBUG):- logger.info(traceback.format_exc())---def configure_logging(log_level: str) -> None:- """- Configure logging settings.-- Args:- log_level: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)- """- numeric_level = getattr(logging, log_level.upper(), None)- if not isinstance(numeric_level, int):- raise ValueError(f"Invalid log level: {log_level}")-- logging.basicConfig(- level=numeric_level,- format="%(asctime)s - %(levelname)s - %(message)s",- datefmt="%Y-%m-%d %H:%M:%S",- )-- # Add telemetry filter to root logger to filter out telemetry requests- telemetry_filter = TelemetryFilter()- logging.getLogger().addFilter(telemetry_filter)-- # Also add filter to specific loggers that might handle HTTP requests- for logger_name in ["httpx", "urllib3", "requests"]:- logging.getLogger(logger_name).addFilter(telemetry_filter)---def cli_main() -> int:- """- Command-line entry point.-- Returns:- Exit code (0 for success, non-zero for failure)- """- parser = argparse.ArgumentParser(description="Generate Tool Documentation for Composio")- parser.add_argument(- "--output",- "-o",- type=str,- help="Path for documentation output (default: ./tools)",- default="./toolkits",- )- parser.add_argument(- "--include-local",- action="store_true",- help="Include local development tools",- default=False,- )- parser.add_argument(- "--log-level",- choices=["debug", "info", "warning", "error", "critical"],- default="info",- help="Set logging level",- )- parser.add_argument(- "--workers",- "-w",- type=int,- help="Number of parallel worker threads (default: CPU count)",- default=None,- )- parser.add_argument(- "--lint-only",- action="store_true",- help="Only lint existing MDX files without generating new ones",- default=False,- )- parser.add_argument(- "--no-lint",- action="store_true",- help="Skip the linting step when generating documentation",- default=False,- )- parser.add_argument(- "--limit",- "-l",- type=int,- help="Limit processing to first N toolkits (for debugging)",- default=None,- )-- args = parser.parse_args()-- try:- # Configure logging- configure_logging(args.log_level)-- # Convert output path to absolute path- output_path = Path(args.output).resolve()- # Create generator- generator = ToolDocGenerator(include_local=args.include_local)-- # Generate docs with specified number of workers- generator.generate_docs(output_path, max_workers=args.workers, limit=args.limit)-- # Force exit immediately without waiting for background telemetry- logger.info("Documentation generation complete. Exiting immediately.")- os._exit(0)- except Exception as e:- logger.error(f"Error generating documentation: {e}")- if logger.isEnabledFor(logging.DEBUG):- logger.info(traceback.format_exc())- return 1---if __name__ == "__main__":- sys.exit(cli_main())diff --git a/fern/generators/tool_doc_generator/mdx_formatter.py b/fern/generators/tool_doc_generator/mdx_formatter.pydeleted file mode 100644index e061bc36e..000000000--- a/fern/generators/tool_doc_generator/mdx_formatter.py+++ /dev/null@@ -1,557 +0,0 @@-"""-MDX Formatter for Composio tool documentation.--This module provides utilities for formatting MDX content for Composio tool documentation.-"""--import re-import typing as t-from dataclasses import dataclass-from pathlib import Path-import logging--logger = logging.getLogger(__name__)---class MDX:- """- Utilities for generating MDX components and formatting.-- This class provides static methods to format content as different MDX components- used in documentation, including frontmatter, accordions, parameter fields, etc.- """-- @staticmethod- def as_frontmatter(app_name: str | None = None, category: str | None = None) -> str:- """- Generate MDX frontmatter.-- Args:- app_name: The name of the application- category: The category of the application-- Returns:- Formatted MDX frontmatter string- """- frontmatter = f'title: "{app_name}"'- if app_name is not None:- frontmatter += f'\nsubtitle: "Learn how to use {app_name} with Composio"'- if category is not None:- frontmatter += f'\ncategory: "{category}"'- frontmatter += f'\nimage: "https://og.composio.dev/api/og?title=Using%20{app_name}%20with%20Composio"'- return "---\n" + frontmatter + "\n---\n"-- @staticmethod- def as_card(content: str) -> str:- """- Format content as a Card component.-- Args:- content: The content to be wrapped in a Card-- Returns:- Formatted MDX Card string- """- return f"<Card>\n{content}\n</Card>\n"-- @staticmethod- def escape_mdx_content(content: str) -> str:- """- Escape content for safe use inside MDX components.-- Args:- content: The content to escape-- Returns:- Escaped content safe for MDX components- """- if not content:- return ""-- # Convert to string if it's not already- content = str(content)-- # Handle very complex patterns that break MDX parsing- # Example: `value`: `slug`- if re.search(r'`[^`]+`\s*:\s*`[^`]+`', content):- # Replace patterns like `key`: `value` with "key": "value"- content = re.sub(r'`([^`]+)`\s*:\s*`([^`]+)`', r'"\1": "\2"', content)-- # Escape comparison operators with numbers (which cause common MDX parsing errors)- # Handle both with and without spaces- content = re.sub(r'<(\d+)', r'less than \1', content) # <4mb -> less than 4mb- content = re.sub(r'>(\d+)', r'greater than \1', content) # >10 -> greater than 10- content = re.sub(r'<=(\d+)', r'less than or equal to \1', content)- content = re.sub(r'>=(\d+)', r'greater than or equal to \1', content)-- # Replace standalone < and > characters with HTML entities- content = re.sub(r'(?<!\w)<(?!\w)', '<', content)- content = re.sub(r'(?<!\w)>(?!\w)', '>', content)-- # Fix pipes in tables (these break MDX table formatting)- content = content.replace("|", "\\|")-- # Replace variable placeholders like {journey id} with [journey id]- # These often cause MDX parsing issues- content = re.sub(r'\{([^{}]*?)\}', r'[\1]', content)-- # Handle JSON-like examples that contain quotes and objects- if '{' in content and '}' in content:- # First, escape all quotes in JSON examples with double quotes- # Use double quotes instead of backticks for nested JSON- content = re.sub(r"(\{[^}]*)'([^']*)'([^}]*\})", r'\1"\2"\3', content)- content = re.sub(r'(\{[^}]*)"([^"]*)"([^}]*\})', r'\1"\2"\3', content)-- # If we still have {, } in content, wrap the whole thing in quotes- content = re.sub(r'(\{[^{}]*?\})', r'"\1"', content)-- # Handle special case of "repo | slug" pattern that causes errors- content = re.sub(r'\|\s*slug', r'or slug', content)-- # Escape special format characters used in MDX- content = content.replace("$", "\\$")- content = content.replace("==", "\\=\\=")-- # Handle HTML-like tags that might appear in documentation- content = re.sub(r'<([a-zA-Z][^>]*?)>', r'<\1>', content)-- # Fix malformed HTML tags- content = re.sub(r'<ul\s*-', r'<ul><li>', content)-- # Fix nested backticks that may be causing issues- if content.count('`') > 2:- # Replace complex nested backticks with quoted text- content = re.sub(r'`([^`]*)`([^`]*)`([^`]*)`', r'"\1\2\3"', content)-- return content-- @staticmethod- def as_param(- name: str,- typ: str,- doc: str = "",- required: bool = False,- default: t.Optional[str] = None- ) -> str:- """- Format a parameter field.-- Args:- name: Parameter name- typ: Parameter type- doc: Parameter description- required: Whether the parameter is required- default: Default value for the parameter-- Returns:- Formatted ParamField component string- """- # Make sure name and type are properly escaped- safe_name = name.replace('"', '\\"')- safe_type = typ.replace('"', '\\"')-- # Handle required and default attributes- attributes = ""- if required:- attributes += ' required={true}'- if default and default != "None" and default != "":- safe_default = str(default).replace('"', '\\"')- attributes += f' default="{safe_default}"'-- return (- f'<ParamField path="{safe_name}" type="{safe_type}"{attributes}>\n'- "</ParamField>\n"- )-- @staticmethod- def as_accordion(title: str, content: str) -> str:- """- Format content as an accordion component.-- Args:- title: The title/header for the accordion- content: The content inside the accordion-- Returns:- Formatted accordion MDX string- """- # Escape characters in title that might break MDX- # First, escape quotes to avoid breaking the title attribute- safe_title = title.replace('"', '\\"')-- # Handle comparison operators that caused issues in the check- # For example: files <384kb or limited to <4mb- safe_title = re.sub(r'<(\d+)', r'less than \1', safe_title)- safe_title = re.sub(r'>(\d+)', r'greater than \1', safe_title)- safe_title = re.sub(r'<=(\d+)', r'less than or equal to \1', safe_title)- safe_title = re.sub(r'>=(\d+)', r'greater than or equal to \1', safe_title)-- # Escape standalone < and > characters- safe_title = re.sub(r'(?<!\w)<(?!\w)', '<', safe_title)- safe_title = re.sub(r'(?<!\w)>(?!\w)', '>', safe_title)-- return f'<Accordion title="{safe_title}">\n{content}\n</Accordion>\n'-- @staticmethod- def as_accordion_group(content: str) -> str:- """- Format content as an accordion group.-- Args:- content: The content inside the accordion group-- Returns:- Formatted accordion group MDX string- """- return f'<AccordionGroup>\n{content}\n</AccordionGroup>\n'-- @staticmethod- def as_code_block(- content: str,- language: str = "python",- display_name: str = None,- highlight_lines: str = None, # e.g., "25-30" or "5"- title: str = None,- max_lines: int = None,- word_wrap: bool = True- ) -> str:- """- Format content as a code block using backticks with full formatting support.-- Args:- content: The code to be displayed- language: The programming language for syntax highlighting (e.g., "python", "typescript")- display_name: Display name for the language tab (deprecated - use title instead)- highlight_lines: Lines to highlight (e.g., "25-30" or "5")- title: Title for the code block (e.g., "Python", "TypeScript")- max_lines: Maximum number of lines to display- word_wrap: Whether to wrap long lines-- Returns:- Formatted code block MDX string with all attributes- """- # Build the code fence header- header_parts = [language]-- # Add line highlighting if provided- if highlight_lines:- header_parts.append(f"{{{highlight_lines}}}")-- # Add title if provided (use display_name as fallback)- title_to_use = title or display_name- if title_to_use:- # Escape quotes in title- safe_title = title_to_use.replace('"', '\\"')- header_parts.append(f'title="{safe_title}"')-- # Add max lines if provided- if max_lines:- header_parts.append(f"maxLines={max_lines}")-- # Add word wrap if enabled (default is True)- if word_wrap:- header_parts.append("wordWrap")-- # Join all parts with spaces- header = " ".join(header_parts)-- return f"```{header}\n{content}\n```\n"-- @staticmethod- def as_code_group(*code_blocks: str) -> str:- """- Wrap multiple code blocks in a CodeGroup component.-- Args:- *code_blocks: Variable number of code block strings-- Returns:- Formatted CodeGroup MDX string containing all code blocks- """- return f"<CodeGroup>\n{''.join(code_blocks)}</CodeGroup>\n"-- @staticmethod- def _replace_template_variables(content: str, variables: dict) -> str:- """- Replace {{variable}} patterns with their values, supporting transformations.-- Supports patterns like:- - {{variable}}- - {{variable|upper}}- - {{variable|lower}}- - {{variable|title}}- - {{variable|default:'fallback value'}}-- Args:- content: Template content with {{variable}} placeholders- variables: Dictionary of variable names to values-- Returns:- Content with variables replaced- """- def replace_var(match):- var_name = match.group(1)- transform = match.group(2)- default = match.group(3)-- # Get the value or use default- value = variables.get(var_name)- if value is None:- value = default.strip("'\"") if default else match.group(0)- else:- value = str(value)-- # Apply transformation if specified- if transform:- if transform == 'upper':- value = value.upper()- elif transform == 'lower':- value = value.lower()- elif transform == 'title':- value = value.capitalize()-- return value-- # Pattern matches: {{var_name|transform|default:'value'}}- pattern = r'\{\{(\w+)(?:\|(\w+))?(?:\|default:[\'"]([^\'"]*)[\'"])?\}\}'- return re.sub(pattern, replace_var, content)-- @staticmethod- def _read_template_file(template_path: str, base_path: t.Optional[Path] = None) -> str:- """- Read a template file.-- Args:- template_path: Path to template file (can be relative)- base_path: Base path to resolve relative paths from (defaults to current file's parent)-- Returns:- Template content as string- """- if base_path is None:- # Default to the directory containing this file's parent (tool_doc_generator)- base_path = Path(__file__).parent-- # Resolve the full path- if Path(template_path).is_absolute():- full_path = Path(template_path)- else:- full_path = base_path / template_path-- try:- with open(full_path, 'r', encoding='utf-8') as f:- return f.read()- except FileNotFoundError:- logger.warning(f"Template not found: {full_path}")- return f"# Template not found: {template_path}"-- @staticmethod- def _detect_language_from_path(file_path: str) -> str:- """- Detect programming language from file extension.-- Args:- file_path: Path to the file-- Returns:- Language identifier for syntax highlighting- """- extension_map = {- '.py': 'python',- '.js': 'javascript',- '.ts': 'typescript',- '.tsx': 'typescript',- '.jsx': 'javascript',- '.java': 'java',- '.cpp': 'cpp',- '.c': 'c',- '.go': 'go',- '.rs': 'rust',- '.php': 'php',- '.rb': 'ruby',- '.swift': 'swift',- '.kt': 'kotlin',- '.scala': 'scala',- '.sh': 'bash',- '.yml': 'yaml',- '.yaml': 'yaml',- '.json': 'json',- '.xml': 'xml',- '.html': 'html',- '.css': 'css',- '.scss': 'scss',- '.sql': 'sql',- }-- suffix = Path(file_path).suffix.lower()- return extension_map.get(suffix, 'text')-- @staticmethod- def as_code_block_from_template(- template_path: str,- template_vars: dict = None,- language: str = None,- display_name: str = None,- highlight_lines: str = None,- title: str = None,- max_lines: int = None,- word_wrap: bool = True,- base_path: t.Optional[Path] = None- ) -> str:- """- Create a code block from a template file with variable replacement.-- Args:- template_path: Path to template file (relative to base_path)- template_vars: Dictionary of variables to replace in template- language: Override auto-detected language (e.g., "python", "typescript")- display_name: Display name for the language tab (deprecated - use title instead)- highlight_lines: Lines to highlight (e.g., "25-30" or "5")- title: Title for the code block (e.g., "Python", "TypeScript")- max_lines: Maximum number of lines to display- word_wrap: Whether to wrap long lines- base_path: Base path for resolving template_path-- Returns:- Formatted code block MDX string- """- # Read template file- content = MDX._read_template_file(template_path, base_path)-- # Replace variables if provided- if template_vars:- content = MDX._replace_template_variables(content, template_vars)-- # Auto-detect language from file extension if not provided- if not language:- language = MDX._detect_language_from_path(template_path)-- # Use existing as_code_block with all formatting- return MDX.as_code_block(- content=content,- language=language,- display_name=display_name,- highlight_lines=highlight_lines,- title=title,- max_lines=max_lines,- word_wrap=word_wrap- )-- @staticmethod- def as_markdown_table(headers: list, rows: list) -> str:- """- Create a markdown table with headers and rows.-- Args:- headers: List of header strings- rows: List of row lists where each inner list contains values for each column-- Returns:- Formatted markdown table string- """- if not headers or not rows:- return ""-- # Remove empty columns (all values are empty, None, or "No description provided")- cols_to_keep = []- for col_idx in range(len(headers)):- col_values = [row[col_idx] if col_idx < len(row) else "" for row in rows]- has_valid_value = any(- str(val) and str(val).strip() not in ["", "None", "No description provided"]- for val in col_values- )- if has_valid_value:- cols_to_keep.append(col_idx)-- # If no valid columns, return empty string- if not cols_to_keep:- return ""-- # Create new headers and rows with only the columns to keep- filtered_headers = [headers[i] for i in cols_to_keep]- filtered_rows = []- for row in rows:- filtered_row = []- for i in cols_to_keep:- val = row[i] if i < len(row) else ""- filtered_row.append(val)- filtered_rows.append(filtered_row)-- # Generate the table- table = "| " + " | ".join(filtered_headers) + " |\n"- table += "| " + " | ".join(["---" for _ in filtered_headers]) + " |\n"-- for row in filtered_rows:- # Ensure row has same number of columns as headers- row_data = row + [""] * (len(filtered_headers) - len(row))- # Replace None and "No description provided" with empty strings- row_data = [- str(col) if str(col).strip() not in ["None", "No description provided"] else ""- for col in row_data- ]- table += "| " + " | ".join(row_data) + " |\n"-- return table-- @staticmethod- def as_param_table(params: list) -> str:- """- Create a parameter table from param metadata.-- Args:- params: List of parameter dictionaries-- Returns:- Markdown table of parameters- """- if not params:- return ""-- headers = ["Name", "Type", "Description", "Default"]- rows = []-- for param in params:- # Check which fields exist and add them- description = param.get('description', '')- default = param.get('default', '')-- # Skip description if it's "No description provided"- if description == "No description provided":- description = ''-- # Skip default if it's "None"- if default == "None":- default = ''-- row = [- f"`{param['name']}`",- f"`{param['type']}`",- description,- default- ]- rows.append(row)-- return MDX.as_markdown_table(headers, rows)-- @staticmethod- def as_relative_link(target_name: str, target_path: str) -> str:- """- Create a relative markdown link to another doc page.-- Args:- target_name: Display name for the link- target_path: Relative path to the target doc-- Returns:- Markdown link string- """- return f"[{target_name}]({target_path})"---@dataclass-class DocumentSection:- """Base class for document sections."""-- def to_mdx(self) -> str:- """Convert section to MDX text."""- raise NotImplementedError("Subclasses must implement to_mdx()")\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/pre_commit_tool_doc.py b/fern/generators/tool_doc_generator/pre_commit_tool_doc.pydeleted file mode 100644index 69458c68d..000000000--- a/fern/generators/tool_doc_generator/pre_commit_tool_doc.py+++ /dev/null@@ -1,111 +0,0 @@-#!/usr/bin/env python-"""-Minimal docs.yml updater for pre-commit hooks.--This script provides a minimal version that just sets the base layout-for the tools section in docs.yml.-"""--import argparse-import logging-import sys-from pathlib import Path--import yaml--from generators.tool_doc_generator.base_docs import base_layout--logger = logging.getLogger(__name__)---def update_docs_yml_minimal(docs_yml_path: Path) -> None:- """- Minimal update of docs.yml file with just the base layout.-- Args:- docs_yml_path: Path to the docs.yml file- """- logger.info("Updating docs.yml with minimal base layout")-- try:- # Read the current docs.yml- with open(docs_yml_path, "r") as f:- docs_data = yaml.safe_load(f)-- # Find the "tools" tab section in the navigation structure- for tab_section in docs_data.get("navigation", []):- if tab_section.get("tab") == "tools":- logger.info("Found tools tab section, setting base layout")- tab_section["layout"] = base_layout- break- else:- logger.warning("No tools tab section found in docs.yml")- return-- # Write the updated YAML back to the file- with open(docs_yml_path, "w") as f:- yaml.dump(docs_data, f, default_flow_style=False, sort_keys=False)-- logger.info("✅ Updated docs.yml with base layout")-- except Exception as e:- logger.error(f"Failed to update docs.yml: {e}")- raise---def configure_logging(log_level: str = "info") -> None:- """Configure logging settings."""- numeric_level = getattr(logging, log_level.upper(), None)- if not isinstance(numeric_level, int):- raise ValueError(f"Invalid log level: {log_level}")-- logging.basicConfig(- level=numeric_level,- format="%(asctime)s - %(levelname)s - %(message)s",- datefmt="%Y-%m-%d %H:%M:%S",- )---def main() -> int:- """Command-line entry point for minimal docs.yml update."""- parser = argparse.ArgumentParser(- description="Minimal docs.yml updater for pre-commit hooks"- )- parser.add_argument(- "--docs-yml",- type=str,- help="Path to docs.yml file (default: ./docs.yml)",- default="./docs.yml",- )- parser.add_argument(- "--log-level",- choices=["debug", "info", "warning", "error", "critical"],- default="info",- help="Set logging level",- )-- args = parser.parse_args()-- try:- # Configure logging- configure_logging(args.log_level)-- # Convert path to absolute path- docs_yml_path = Path(args.docs_yml).resolve()-- if not docs_yml_path.exists():- logger.error(f"docs.yml file not found: {docs_yml_path}")- return 1-- # Update docs.yml with minimal layout- update_docs_yml_minimal(docs_yml_path)-- return 0-- except Exception as e:- logger.error(f"Error updating docs.yml: {e}")- return 1---if __name__ == "__main__":- sys.exit(main())\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/api_key.py b/fern/generators/tool_doc_generator/templates/python/api_key.pydeleted file mode 100644index 818ccc166..000000000--- a/fern/generators/tool_doc_generator/templates/python/api_key.py+++ /dev/null@@ -1,31 +0,0 @@-from composio import Composio--# Replace these with your actual values-{{toolkit_slug}}_auth_config_id = "{{auth_config_id|default:'ac_YOUR_AUTH_CONFIG_ID'}}" # Auth config ID created above-user_id = "0000-0000-0000" # UUID from database/app--composio = Composio()--def authenticate_toolkit(user_id: str, auth_config_id: str):- # Replace this with a method to retrieve an API key from the user.- # Or supply your own.- user_api_key = input("[!] Enter API key")-- connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}- )-- # API Key authentication is immediate - no redirect needed- print(f"Successfully connected {{toolkit_name}} for user {user_id}")- print(f"Connection status: {connection_request.status}")-- return connection_request.id---connection_id = authenticate_toolkit(user_id, {{toolkit_slug}}_auth_config_id)--# You can verify the connection using:-connected_account = composio.connected_accounts.get(connection_id)-print(f"Connected account: {connected_account}")\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/basic_auth.py b/fern/generators/tool_doc_generator/templates/python/basic_auth.pydeleted file mode 100644index e918ad162..000000000--- a/fern/generators/tool_doc_generator/templates/python/basic_auth.py+++ /dev/null@@ -1,26 +0,0 @@-from composio import Composio-from composio.types import auth_scheme--# Replace these with your actual values-{{toolkit_slug}}_auth_config_id = "{{auth_config_id|default:'ac_YOUR_AUTH_CONFIG_ID'}}"-user_id = "{{user_id|default:'[email protected]'}}"-username = "{{username_placeholder|default:'your_username'}}"-password = "{{password_placeholder|default:'your_password'}}"--composio = Composio()--# Create a new connected account for {{toolkit_name}} using Basic Auth-connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id={{toolkit_slug}}_auth_config_id,- config=auth_scheme.basic_auth(- username=username,- password=password- )-)--# Basic authentication is immediate - no redirect needed-print(f"Successfully connected {{toolkit_name}} for user {user_id}")--# You can verify the connection using:-# connected_account = composio.connected_accounts.get(user_id=user_id, app_id="{{toolkit_slug|upper}}")\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/bearer_token.py b/fern/generators/tool_doc_generator/templates/python/bearer_token.pydeleted file mode 100644index 48c4fe6c9..000000000--- a/fern/generators/tool_doc_generator/templates/python/bearer_token.py+++ /dev/null@@ -1,30 +0,0 @@-from composio import Composio--# Auth config ID created above-{{toolkit_slug}}_auth_config_id = "{{auth_config_id|default:'ac_YOUR_AUTH_CONFIG_ID'}}"--# UUID from database/application-user_id = "0000-0000-0000"--composio = Composio()---def authenticate_toolkit(user_id: str, auth_config_id: str):- # Replace this with a method to retrieve the Bearer Token from the user.- bearer_token = input("[!] Enter bearer token")- connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- config={"auth_scheme": "BEARER_TOKEN", "val": bearer_token}- )- print(f"Successfully connected {{toolkit_name}} for user {user_id}")- print(f"Connection status: {connection_request.status}")-- return connection_request.id---connection_id = authenticate_toolkit(user_id, {{toolkit_slug}}_auth_config_id)--# You can verify the connection using:-connected_account = composio.connected_accounts.get(connection_id)-print(f"Connected account: {connected_account}")\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/google_tools.py b/fern/generators/tool_doc_generator/templates/python/google_tools.pydeleted file mode 100644index d71c2c9be..000000000--- a/fern/generators/tool_doc_generator/templates/python/google_tools.py+++ /dev/null@@ -1,25 +0,0 @@-from composio import Composio-from composio_google import GoogleProvider-from google import genai-from google.genai import types--# Create composio client-composio = Composio(provider=GoogleProvider())-# Create google client-client = genai.Client()--# User ID must be a valid UUID format-user_id = "0000-0000-0000" # Replace with actual user UUID from your database--# Get tools for {{toolkit_name}}-tools = composio.tools.get(user_id, toolkits=["{{toolkit_slug|upper}}"])--print("[!] Tools:", tools)--# Create genai client config-config = types.GenerateContentConfig(tools=tools)--# Use the chat interface-chat = client.chats.create(model="gemini-2.0-flash", config=config)-response = chat.send_message("What can you do with {{toolkit_name}}?")-print("[!] Response:", response.text)\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/oauth2.py b/fern/generators/tool_doc_generator/templates/python/oauth2.pydeleted file mode 100644index e546b7126..000000000--- a/fern/generators/tool_doc_generator/templates/python/oauth2.py+++ /dev/null@@ -1,29 +0,0 @@-from composio import Composio--# Replace these with your actual values-{{toolkit_slug}}_auth_config_id = "{{auth_config_id|default:'ac_YOUR_AUTH_CONFIG_ID'}}" # Auth config ID created above-user_id = "0000-0000-0000" # UUID from database/application--composio = Composio()---def authenticate_toolkit(user_id: str, auth_config_id: str):- connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- )-- print(- f"Visit this URL to authenticate {{toolkit_name}}: {connection_request.redirect_url}"- )-- # This will wait for the auth flow to be completed- connection_request.wait_for_connection(timeout=15)- return connection_request.id---connection_id = authenticate_toolkit(user_id, {{toolkit_slug}}_auth_config_id)--# You can also verify the connection status using:-connected_account = composio.connected_accounts.get(connection_id)-print(f"Connected account: {connected_account}")\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/python/openai_tools.py b/fern/generators/tool_doc_generator/templates/python/openai_tools.pydeleted file mode 100644index d8699fa8c..000000000--- a/fern/generators/tool_doc_generator/templates/python/openai_tools.py+++ /dev/null@@ -1,33 +0,0 @@-from composio import Composio-from openai import OpenAI-import json--openai = OpenAI()-composio = Composio()--# User ID must be a valid UUID format-user_id = "0000-0000-0000" # Replace with actual user UUID from your database--tools = composio.tools.get(user_id=user_id, toolkits=["{{toolkit_slug|upper}}"])--print("[!] Tools:")-print(json.dumps(tools))--def invoke_llm(task = "What can you do?"):- completion = openai.chat.completions.create(- model="gpt-4o",- messages=[- {- "role": "user",- "content": task, # Your task here!- },- ],- tools=tools,- )-- # Handle Result from tool call- result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)- print(f"[!] Completion: {completion}")- print(f"[!] Tool call result: {result}")--invoke_llm()\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/anthropic_tools.ts b/fern/generators/tool_doc_generator/templates/typescript/anthropic_tools.tsdeleted file mode 100644index cf7256470..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/anthropic_tools.ts+++ /dev/null@@ -1,38 +0,0 @@-import { Composio } from '@composio/core';-import { AnthropicProvider } from '@composio/anthropic';-import { Anthropic } from '@anthropic-ai/sdk';--const composio = new Composio({- provider: new AnthropicProvider({- cacheTools: false, // default- }),-});--const anthropic = new Anthropic();--// User ID must be a valid UUID format-const userId = "0000-0000-0000"; // Replace with actual user UUID from your database--// Get tools for {{toolkit_name}}-const tools = await composio.tools.get(userId, {- toolkits: ["{{toolkit_slug|upper}}"],-});--console.log("[!] Tools:", tools);--// Create a message with the tools-const msg = await anthropic.messages.create({- model: 'claude-3-5-sonnet-20240620',- messages: [- {- role: 'user',- content: 'What can you do with {{toolkit_name}}?', // Your task here!- },- ],- tools: tools,- max_tokens: 1000,-});--// Handle tool calls if any-const result = await composio.provider.handleToolCalls(userId, msg);-console.log("[!] Result:", result);\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/api_key.ts b/fern/generators/tool_doc_generator/templates/typescript/api_key.tsdeleted file mode 100644index 1a4768c29..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/api_key.ts+++ /dev/null@@ -1,37 +0,0 @@-import { Composio } from '@composio/core';-import { AuthScheme } from '@composio/core';-// Replace these with your actual values-const {{toolkit_slug}}_auth_config_id = "ac_YOUR_{{toolkit_slug|upper}}_CONFIG_ID"; // Auth config ID created above-const userId = "{{user_id|default:'[email protected]'}}"; // User ID from database/application--const composio = new Composio();--async function authenticateToolkit(userId: string, authConfigId: string) {- // TODO: Replace this with a method to retrieve the API key from the user.- // In production, this should be securely retrieved from your database or user input.- // For example: const userApiKey = await getUserApiKey(userId);- const userApiKey = "your_{{toolkit_slug}}_api_key"; // Replace with actual API key-- const connectionRequest = await composio.connectedAccounts.initiate(- userId,- authConfigId,- {- config: AuthScheme.APIKey({- api_key: userApiKey- })- }- );-- // API Key authentication is immediate - no redirect needed- console.log(`Successfully connected {{toolkit_name}} for user ${userId}`);- console.log(`Connection status: ${connectionRequest.status}`);-- return connectionRequest.id;-}--// Authenticate the toolkit-const connectionId = await authenticateToolkit(userId, {{toolkit_slug}}_auth_config_id);--// You can verify the connection using:-const connectedAccount = await composio.connectedAccounts.get(connectionId);-console.log("Connected account:", connectedAccount);\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/basic_auth.ts b/fern/generators/tool_doc_generator/templates/typescript/basic_auth.tsdeleted file mode 100644index 347076b7a..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/basic_auth.ts+++ /dev/null@@ -1,40 +0,0 @@-import { Composio } from '@composio/core';--// Replace these with your actual values-const {{toolkit_slug}}_auth_config_id = "{{auth_config_id|default:'ac_YOUR_AUTH_CONFIG_ID'}}"; // Auth config ID created above-const userId = "{{user_id|default:'[email protected]'}}"; // User ID from database/application--const composio = new Composio();--async function authenticateToolkit(userId: string, authConfigId: string) {- // TODO: Replace these with a method to retrieve credentials from the user.- // In production, these should be securely retrieved from your database or user input.- // For example: const { username, password } = await getUserCredentials(userId);- const username = "{{username_placeholder|default:'your_username'}}"; // Replace with actual username- const password = "{{password_placeholder|default:'your_password'}}"; // Replace with actual password-- const connectionRequest = await composio.connectedAccounts.initiate({- userId: userId,- authConfigId: authConfigId,- config: {- authScheme: "BASIC",- config: {- username: username,- password: password- }- }- });-- // Basic authentication is immediate - no redirect needed- console.log(`Successfully connected {{toolkit_name}} for user ${userId}`);- console.log(`Connection status: ${connectionRequest.status}`);-- return connectionRequest.id;-}--// Authenticate the toolkit-const connectionId = await authenticateToolkit(userId, {{toolkit_slug}}_auth_config_id);--// You can verify the connection using:-const connectedAccount = await composio.connectedAccounts.get(connectionId);-console.log("Connected account:", connectedAccount);\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/bearer_token.ts b/fern/generators/tool_doc_generator/templates/typescript/bearer_token.tsdeleted file mode 100644index cb7306e64..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/bearer_token.ts+++ /dev/null@@ -1,37 +0,0 @@-import { Composio } from '@composio/core';-import { AuthScheme } from '@composio/core';-// Replace these with your actual values-const {{toolkit_slug}}_auth_config_id = "ac_YOUR_{{toolkit_slug|upper}}_CONFIG_ID"; // Auth config ID created above-const userId = "{{user_id|default:'[email protected]'}}"; // User ID from database/application--const composio = new Composio();--async function authenticateToolkit(userId: string, authConfigId: string) {- // TODO: Replace this with a method to retrieve the Bearer Token from the user.- // In production, this should be securely retrieved from your database or user input.- // For example: const bearerToken = await getUserBearerToken(userId);- const bearerToken = "your_{{toolkit_slug}}_bearer_token"; // Replace with actual bearer token-- const connectionRequest = await composio.connectedAccounts.initiate(- userId,- authConfigId,- {- config: AuthScheme.BearerToken({- token: bearerToken- })- }- );-- // Bearer token authentication is immediate - no redirect needed- console.log(`Successfully connected {{toolkit_name}} for user ${userId}`);- console.log(`Connection status: ${connectionRequest.status}`);-- return connectionRequest.id;-}--// Authenticate the toolkit-const connectionId = await authenticateToolkit(userId, {{toolkit_slug}}_auth_config_id);--// You can verify the connection using:-const connectedAccount = await composio.connectedAccounts.get(connectionId);-console.log("Connected account:", connectedAccount);\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/oauth2.ts b/fern/generators/tool_doc_generator/templates/typescript/oauth2.tsdeleted file mode 100644index 9ae7387f2..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/oauth2.ts+++ /dev/null@@ -1,28 +0,0 @@-import { Composio } from '@composio/core';--// Replace these with your actual values-const {{toolkit_slug}}_auth_config_id = "ac_YOUR_{{toolkit_slug|upper}}_CONFIG_ID"; // Auth config ID created above-const userId = "{{user_id|default:'[email protected]'}}"; // User ID from database/application--const composio = new Composio();--async function authenticateToolkit(userId: string, authConfigId: string) {- const connectionRequest = await composio.connectedAccounts.initiate(- userId,- authConfigId- );-- console.log(`Visit this URL to authenticate {{toolkit_name}}: ${connectionRequest.redirectUrl}`);-- // This will wait for the auth flow to be completed- await connectionRequest.waitForConnection(60);-- return connectionRequest.id;-}--// Authenticate the toolkit-const connectionId = await authenticateToolkit(userId, {{toolkit_slug}}_auth_config_id);--// You can also verify the connection status using:-const connectedAccount = await composio.connectedAccounts.get(connectionId);-console.log("Connected account:", connectedAccount);\ No newline at end of filediff --git a/fern/generators/tool_doc_generator/templates/typescript/vercel_tools.ts b/fern/generators/tool_doc_generator/templates/typescript/vercel_tools.tsdeleted file mode 100644index ea5e2f279..000000000--- a/fern/generators/tool_doc_generator/templates/typescript/vercel_tools.ts+++ /dev/null@@ -1,34 +0,0 @@-import { Composio } from '@composio/core';-import { generateText } from 'ai';-import { anthropic } from '@ai-sdk/anthropic';-import { VercelProvider } from '@composio/vercel';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--// User ID must be a valid UUID format-const userId = "0000-0000-0000"; // Replace with actual user UUID from your database--// Get tools for {{toolkit_name}}-const tools = await composio.tools.get(userId, {- toolkits: ["{{toolkit_slug|upper}}"]-});--console.log("[!] Tools:", tools);--// Generate text with tools-const { text } = await generateText({- model: anthropic('claude-3-7-sonnet-20250219'),- messages: [- {- role: 'user',- content: "What can you do with {{toolkit_name}}?", // Your task here!- },- ],- tools,- maxSteps: 3,-});--console.log("[!] Result:", text);\ No newline at end of filediff --git a/fern/llms-txt-worker/package.json b/fern/llms-txt-worker/package.jsondeleted file mode 100644index edebe8cb4..000000000--- a/fern/llms-txt-worker/package.json+++ /dev/null@@ -1,17 +0,0 @@-{- "name": "@composio/llms-txt-worker",- "version": "0.0.0",- "private": true,- "scripts": {- "build": "echo 'llms.txt generated by parent turbo task'",- "deploy": "wrangler deploy",- "publish": "wrangler deploy",- "dev": "wrangler dev",- "start": "wrangler dev"- },- "devDependencies": {- "@cloudflare/workers-types": "catalog:",- "typescript": "catalog:",- "wrangler": "catalog:"- }-}\ No newline at end of filediff --git a/fern/llms-txt-worker/public/.keepFolder b/fern/llms-txt-worker/public/.keepFolderdeleted file mode 100644index e69de29bb..000000000diff --git a/fern/llms-txt-worker/src/index.ts b/fern/llms-txt-worker/src/index.tsdeleted file mode 100644index 4a9899047..000000000--- a/fern/llms-txt-worker/src/index.ts+++ /dev/null@@ -1,31 +0,0 @@-interface Env {- ASSETS: {- fetch: (request: Request) => Promise<Response>;- };-}--interface ExecutionContext {- waitUntil(promise: Promise<unknown>): void;- passThroughOnException(): void;-}--export default {- async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {- const url = new URL(request.url);-- // Serve static llms.txt for both /llm.txt and /llms.txt- if (url.pathname === '/llms.txt' || url.pathname === '/llm.txt') {- // Always fetch the llms.txt file, regardless of which path was requested- const llmsRequest = new Request(new URL('/llms.txt', request.url).toString(), request);- return env.ASSETS.fetch(llmsRequest);- }-- // Serve robots-only/tools.json- if (url.pathname === '/robots-only/tools.json') {- return env.ASSETS.fetch(request);- }-- // Everything else — proxy to origin that docs.composio.dev points to- return fetch(request);- },-};diff --git a/fern/llms-txt-worker/tsconfig.json b/fern/llms-txt-worker/tsconfig.jsondeleted file mode 100644index 4fd58f2d7..000000000--- a/fern/llms-txt-worker/tsconfig.json+++ /dev/null@@ -1,8 +0,0 @@-{- "$schema": "https://json.schemastore.org/tsconfig",- "extends": "./tsconfig.options.json",- "compilerOptions": {- "rootDir": "./src"- },- "include": ["src/**/*.ts"]-}\ No newline at end of filediff --git a/fern/llms-txt-worker/tsconfig.options.json b/fern/llms-txt-worker/tsconfig.options.jsondeleted file mode 100644index 2e94033d9..000000000--- a/fern/llms-txt-worker/tsconfig.options.json+++ /dev/null@@ -1,18 +0,0 @@-{- "$schema": "https://json.schemastore.org/tsconfig",- "compilerOptions": {- "target": "ES2022",- "lib": ["ES2022", "DOM"],- "module": "ES2022",- "moduleResolution": "bundler",- "allowSyntheticDefaultImports": true,- "esModuleInterop": true,- "strict": true,- "skipLibCheck": true,- "pretty": true,- "noImplicitReturns": true,- "noFallthroughCasesInSwitch": true,- "types": ["@cloudflare/workers-types"]- },- "exclude": ["node_modules", "**/dist"]-}\ No newline at end of filediff --git a/fern/llms-txt-worker/turbo.json b/fern/llms-txt-worker/turbo.jsondeleted file mode 100644index 1bfd21645..000000000--- a/fern/llms-txt-worker/turbo.json+++ /dev/null@@ -1,31 +0,0 @@-{- "$schema": "https://turbo.build/schema.json",- "extends": [- "//"- ],- "tasks": {- "build": {- "cache": false- },- "publish": {- "dependsOn": [- "^build"- ],- "cache": false,- "env": [- "CLOUDFLARE_API_TOKEN",- "CLOUDFLARE_ACCOUNT_ID"- ]- },- "deploy": {- "dependsOn": [- "^build"- ],- "cache": false,- "env": [- "CLOUDFLARE_API_TOKEN",- "CLOUDFLARE_ACCOUNT_ID"- ]- }- }-}\ No newline at end of filediff --git a/fern/llms-txt-worker/wrangler.jsonc b/fern/llms-txt-worker/wrangler.jsoncdeleted file mode 100644index bfdab3b34..000000000--- a/fern/llms-txt-worker/wrangler.jsonc+++ /dev/null@@ -1,13 +0,0 @@-{- "$schema": "node_modules/wrangler/config-schema.json",- "name": "composio-docs-proxy",- "main": "src/index.ts",- "compatibility_date": "2025-07-26",- "assets": {- "directory": "./public/",- "binding": "ASSETS"- },- "routes": [- { "pattern": "docs.composio.dev/*", "zone_name": "composio.dev" }- ]- }\ No newline at end of filediff --git a/fern/package.json b/fern/package.jsondeleted file mode 100644index 67e0ac9cc..000000000--- a/fern/package.json+++ /dev/null@@ -1,79 +0,0 @@-{- "name": "composio-docs",- "version": "0.0.0",- "type": "module",- "private": true,- "packageManager": "[email protected]",- "scripts": {- "preinstall": "npx only-allow pnpm",- "clean": "git clean -xdf node_modules",- "compile": "npx tailwindcss -i ./assets/input.css -o ./dist/output.css",- "tools:generate": "uv run generators/tool_doc_generator/main.py --workers 10",- "tools:generate:dev": "uv run generators/tool_doc_generator/main.py --workers 10 --limit ${LIMIT:-5}",- "sdkdocs": "pnpm run sdkdocs:ts && pnpm run sdkdocs:python",- "sdkdocs:ts": "pnpm exec typedoc",- "sdkdocs:python": "uv run python generators/python_sdk/generate_docs.py",- "css:compile": "npx tailwindcss -i ./assets/input.css -o ./dist/output.css",- "css:watch": "npx tailwindcss -i ./assets/input.css -o ./dist/output.css --watch",- "api:pull": "bash scripts/pull-openapi-spec.sh",- "snippets:build": "bun run scripts/build-snippets.ts",- "snippets:dev": "bun watch scripts/build-snippets.ts --watch",- "add-og": "uv run scripts/add_og_imgs.py",- "check": "fern check",- "dev": "bun run scripts/build-snippets.ts && (bun run scripts/build-snippets.ts --watch & fern docs dev)",- "dev:docs": "fern docs dev",- "links": "fern docs broken-links",- "build": "echo 'Build orchestrated by Turbo'",- "preview": "fern generate --docs --preview --log-level debug",- "publish": "fern generate --docs",- "generate": "pnpm tools:generate && pnpm sdkdocs",- "snippet:new": "bun run scripts/snippet-new.ts",- "doc:new": "bun run scripts/doc-new.ts",- "llms:build": "bun run scripts/build-llms-txt.ts",- "llms:dev": "bun run scripts/build-llms-txt.ts --watch",- "llms:deploy": "turbo run deploy --filter=@composio/llms-txt-worker"- },- "dependencies": {- "fern-api": "^0.51.39",- "gray-matter": "^4.0.3",- "supergateway": "^3.4.3"- },- "devDependencies": {- "@ai-sdk/anthropic": "^1.2.12",- "@anthropic-ai/sdk": "^0.52.0",- "@composio/core": "workspace:*",- "@composio/google": "workspace:*",- "@composio/langchain": "workspace:*",- "@composio/llamaindex": "workspace:*",- "@composio/openai": "workspace:*",- "@composio/openai-agents": "workspace:*",- "@composio/vercel": "workspace:*",- "@google/genai": "^1.1.0",- "@langchain/langgraph": "^0.2.72",- "@langchain/openai": "^0.5.10",- "@llamaindex/openai": "^0.4.20",- "@llamaindex/workflow": "^1.1.24",- "@openai/agents": "^0.2.1",- "@types/convict": "^6.1.6",- "@types/glob": "^8.1.0",- "@types/node": "^20.17.57",- "@types/react": "^18.3.23",- "@types/yaml": "^1.9.7",- "ai": "catalog:",- "composio-core": "^0.5.39",- "hono": "catalog:",- "messages": "link:@langchain/core/messages",- "next": "^15.3.3",- "only-allow": "^1.2.1",- "openai": "^4.94.0",- "react": "^18.3.1",- "tailwindcss": "^3.4.17",- "typedoc": "^0.28.5",- "typedoc-plugin-markdown": "^4.6.4",- "typedoc-plugin-zod": "^1.4.1",- "typescript": "catalog:",- "uuid": "catalog:",- "vitest": "catalog:",- "yaml": "^2.8.0"- }-}\ No newline at end of filediff --git a/fern/packages/snippet-tester/package.json b/fern/packages/snippet-tester/package.jsondeleted file mode 100644index 9bbf08a4e..000000000--- a/fern/packages/snippet-tester/package.json+++ /dev/null@@ -1,30 +0,0 @@-{- "name": "snippet-tester",- "version": "1.0.0",- "description": "",- "main": "index.js",- "scripts": {- "clean": "git clean -xdf node_modules",- "test": "bun test",- "start": "bun run src/index.ts"- },- "keywords": [],- "author": "",- "license": "ISC",- "dependencies": {- "@pnpm/find-workspace-dir": "^7.0.2",- "cohere": "^1.1.1",- "cohere-ai": "^7.14.0",- "convict": "^6.2.4",- "glob": "^11.0.0",- "nodemon": "^3.1.7",- "ts-node": "^10.9.2"- },- "devDependencies": {- "@types/convict": "^6.1.6",- "@types/glob": "^8.1.0",- "@types/node": "^20.10.0",- "typescript": "catalog:",- "bun-types": "latest"- }-}diff --git a/fern/packages/snippet-tester/src/config.ts b/fern/packages/snippet-tester/src/config.tsdeleted file mode 100644index d724c150c..000000000--- a/fern/packages/snippet-tester/src/config.ts+++ /dev/null@@ -1,27 +0,0 @@-import path from "path";--export interface Language {- name: string;- exec: (file: string) => string;- snippetRoot: (base: string) => string;- glob: string;-}--export const config: {- languages: Language[];-} = {- "languages": [- {- "name": "typescript",- "exec": (file: string) => `bun run ${file}`,- "snippetRoot": (base: string) => path.join(base, "./snippets/typescript"),- "glob": "**/*.ts"- },- {- "name": "python",- "exec": (file: string) => `poetry run python ${file}`,- "snippetRoot": (base: string) => path.join(base, "./snippets/python"),- "glob": "**/*.py"- },- ]-}\ No newline at end of filediff --git a/fern/packages/snippet-tester/src/index.ts b/fern/packages/snippet-tester/src/index.tsdeleted file mode 100644index 74e296684..000000000--- a/fern/packages/snippet-tester/src/index.ts+++ /dev/null@@ -1,62 +0,0 @@-import { config } from './config';-import { execCmd, getFilesByExtension } from './utils';-import * as fs from 'fs';-import { glob } from 'glob';-import path from 'path';--// recurse up until you find a pnpm-workspace.yaml-const findPnpmWorkspaceDir = (curDir = __dirname) => {- if (curDir === "/") {- throw new Error("Could not find pnpm-workspace.yaml")- }-- if (fs.existsSync(path.resolve(curDir, "pnpm-lock.yaml"))) {- return curDir- }-- return findPnpmWorkspaceDir(fs.realpathSync(path.resolve(curDir, "..")))-}--const main = async () => {- const workspaceDir = findPnpmWorkspaceDir();-- console.log("Testing snippets in workspace directory:", workspaceDir);-- for (const lang of config.languages) {- console.log(`\nTesting ${lang.name} snippets...`);- const cwd = lang.snippetRoot(workspaceDir);-- try {- const filePaths = glob.globSync(lang.glob, { cwd });-- if (filePaths.length === 0) {- console.log(`No ${lang.name} snippets found.`);- continue;- }-- console.log(`Found ${filePaths.length} ${lang.name} snippet(s).`);-- for (const filePath of filePaths) {- console.log(`\nTesting: ${filePath}`);- const { error, stderr, stdout } = await execCmd(lang.exec(filePath), cwd);-- if (error) {- console.error(`❌ Error running ${filePath}:`);- console.error(stderr || error.message);- } else {- console.log(`✅ Success: ${filePath}`);- if (stdout) {- console.log("Output:", stdout);- }- }- }- } catch (err) {- console.error(`Error processing ${lang.name} snippets:`, err);- }- }-};--main().catch(err => {- console.error("Fatal error:", err);- process.exit(1);-});\ No newline at end of filediff --git a/fern/packages/snippet-tester/src/tests/__snapshots__/snippets.test.ts.snap b/fern/packages/snippet-tester/src/tests/__snapshots__/snippets.test.ts.snapdeleted file mode 100644index f9607546a..000000000--- a/fern/packages/snippet-tester/src/tests/__snapshots__/snippets.test.ts.snap+++ /dev/null@@ -1,1293 +0,0 @@-// Jest Snapshot v1, https://goo.gl/fbAQLP--exports[`Testing language golang testing file chat-post/default/main.go 1`] = `null`;--exports[`Testing language golang testing file chat-post/documents/main.go 1`] = `null`;--exports[`Testing language golang testing file chat-post/stream/main.go 1`] = `null`;--exports[`Testing language golang testing file chat-post/tools/main.go 1`] = `null`;--exports[`Testing language golang testing file classify-post/main.go 1`] = `null`;--exports[`Testing language golang testing file connector-create/main.go 1`] = `-[Error: Command failed: go run connector-create/main.go-2024/10/28 14:44:44 400: {"message":"a connector url must end with the path /search"}-exit status 1-]-`;--exports[`Testing language golang testing file connector-delete/main.go 1`] = `-[Error: Command failed: go run connector-delete/main.go-2024/10/28 14:44:44 404: {"message":"connector not found, id = connector_id"}-exit status 1-]-`;--exports[`Testing language golang testing file connector-get/main.go 1`] = `-[Error: Command failed: go run connector-get/main.go-2024/10/28 14:44:44 404: {"message":"connector not found, id = connector_id"}-exit status 1-]-`;--exports[`Testing language golang testing file connector-patch/main.go 1`] = `-[Error: Command failed: go run connector-patch/main.go-2024/10/28 14:44:43 404: {"message":"connector not found, id = connector_id"}-exit status 1-]-`;--exports[`Testing language golang testing file connectors-id-oauth-authorize-post/main.go 1`] = `-[Error: Command failed: go run connectors-id-oauth-authorize-post/main.go-2024/10/28 14:44:43 404: {"message":"connector not found, id = connector_id"}-exit status 1-]-`;--exports[`Testing language golang testing file connectors-list/main.go 1`] = `null`;--exports[`Testing language golang testing file dataset-delete/main.go 1`] = `-[Error: Command failed: go run dataset-delete/main.go-2024/10/28 14:44:42 404: {"message":"dataset with the id 'dataset_id' not found"}-exit status 1-]-`;--exports[`Testing language golang testing file dataset-get/main.go 1`] = `-[Error: Command failed: go run dataset-get/main.go-2024/10/28 14:44:42 404: {"message":"dataset with the id 'dataset_id' not found"}-exit status 1-]-`;--exports[`Testing language golang testing file dataset-post/main.go 1`] = `-[Error: Command failed: go run dataset-post/main.go-2024/10/28 14:44:41 400: {"message":"output dataset types are not supported for upload"}-exit status 1-]-`;--exports[`Testing language golang testing file dataset-usage-get/main.go 1`] = `-[Error: Command failed: go run dataset-usage-get/main.go-2024/10/28 14:44:41 json: cannot unmarshal string into Go struct field unmarshaler.organization_usage of type int64-exit status 1-]-`;--exports[`Testing language golang testing file detokenize-post/main.go 1`] = `null`;--exports[`Testing language golang testing file embed-jobs-cancel/main.go 1`] = `-[Error: Command failed: go run embed-jobs-cancel/main.go-2024/10/28 14:44:40 404: {"message":"resource not found: could not find embed job with the ID: embed_job_id"}-exit status 1-]-`;--exports[`Testing language golang testing file embed-jobs-get/main.go 1`] = `-[Error: Command failed: go run embed-jobs-get/main.go-2024/10/28 14:44:40 404: {"message":"resource not found: could not find embed job with the ID: embed_job_id"}-exit status 1-]-`;--exports[`Testing language golang testing file embed-jobs-post/main.go 1`] = `-[Error: Command failed: go run embed-jobs-post/main.go-2024/10/28 14:44:40 400: {"message":"a model parameter is required for this endpoint."}-exit status 1-]-`;--exports[`Testing language golang testing file embed-post/main.go 1`] = `null`;--exports[`Testing language golang testing file emebed-jobs-get/main.go 1`] = `null`;--exports[`Testing language golang testing file finetuning/create-finetuned-model/main.go 1`] = `-[Error: Command failed: go run finetuning/create-finetuned-model/main.go-2024/10/28 14:44:38 400: {"message":"dataset with id \\"my-dataset-id\\" does not exist"}-exit status 1-]-`;--exports[`Testing language golang testing file finetuning/delete-finetuned-model/main.go 1`] = `-[Error: Command failed: go run finetuning/delete-finetuned-model/main.go-2024/10/28 14:44:38 400: {"message":"fine-tuned model ID is not a valid UUID: 'test-id'"}-exit status 1-]-`;--exports[`Testing language golang testing file finetuning/get-finetuned-model/main.go 1`] = `-[Error: Command failed: go run finetuning/get-finetuned-model/main.go-2024/10/28 14:44:37 400: {"message":"finetuned_model.id is not a valid UUID: 'test-id'"}-exit status 1-]-`;--exports[`Testing language golang testing file finetuning/list-events/main.go 1`] = `-[Error: Command failed: go run finetuning/list-events/main.go-2024/10/28 14:44:35 500: {"message":"failed to retrieve total size"}-exit status 1-]-`;--exports[`Testing language golang testing file finetuning/list-finetuned-models/main.go 1`] = `null`;--exports[`Testing language golang testing file finetuning/list-training-step-metrics/main.go 1`] = `-[Error: Command failed: go run finetuning/list-training-step-metrics/main.go-2024/10/28 14:44:32 400: {"message":"invalid finetune ID"}-exit status 1-]-`;--exports[`Testing language golang testing file finetuning/update-finetuned-model/main.go 1`] = `-[Error: Command failed: go run finetuning/update-finetuned-model/main.go-2024/10/28 14:44:31 400: {"message":"finetuned_model.id is not a valid UUID: 'test-id'"}-exit status 1-]-`;--exports[`Testing language golang testing file generate-post/main.go 1`] = `null`;--exports[`Testing language golang testing file models-list-get/main.go 1`] = `null`;--exports[`Testing language golang testing file rerank-post/main.go 1`] = `null`;--exports[`Testing language golang testing file summarize-post/main.go 1`] = `null`;--exports[`Testing language golang testing file tokenize-post/main.go 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/ClassifyPost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/ConnectorCreate.java 1`] = `-[Error: Command failed: gradle -PmainClass=ConnectorCreate run-Error: Could not find or load main class ConnectorCreate-Caused by: java.lang.ClassNotFoundException: ConnectorCreate--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 3s-]-`;--exports[`Testing language java testing file app/src/main/java/ConnectorDelete.java 1`] = `-[Error: Command failed: gradle -PmainClass=ConnectorDelete run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=connector not found, id = test-id}}- at com.cohere.api.resources.connectors.ConnectorsClient.delete(ConnectorsClient.java:359)- at com.cohere.api.resources.connectors.ConnectorsClient.delete(ConnectorsClient.java:317)- at ConnectorDelete.main(ConnectorDelete.java:8)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 10s-]-`;--exports[`Testing language java testing file app/src/main/java/ConnectorGet.java 1`] = `-[Error: Command failed: gradle -PmainClass=ConnectorGet run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=connector not found, id = test-id}}- at com.cohere.api.resources.connectors.ConnectorsClient.get(ConnectorsClient.java:278)- at com.cohere.api.resources.connectors.ConnectorsClient.get(ConnectorsClient.java:237)- at ConnectorGet.main(ConnectorGet.java:9)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 10s-]-`;--exports[`Testing language java testing file app/src/main/java/ConnectorPatch.java 1`] = `-[Error: Command failed: gradle -PmainClass=ConnectorPatch run--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:compileJava'.-> Cannot access output property 'destinationDirectory' of task ':app:compileJava'. Accessing unreadable inputs or outputs is not supported. Declare the task as untracked by using Task.doNotTrackState(). For more information, please refer to https://docs.gradle.org/8.10/userguide/incremental_build.html#sec:disable-state-tracking in the Gradle documentation.- > java.nio.file.NoSuchFileException: /Users/billy/repositories/cohere-developer-experience/snippets/java/app/build/classes/java/main/DatasetDelete.class--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 9s-]-`;--exports[`Testing language java testing file app/src/main/java/ConnectorsIdOauthAuthorizePost.java 1`] = `-[Error: Command failed: gradle -PmainClass=ConnectorsIdOauthAuthorizePost run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=connector not found, id = test-id}}- at com.cohere.api.resources.connectors.ConnectorsClient.oAuthAuthorize(ConnectorsClient.java:545)- at com.cohere.api.resources.connectors.ConnectorsClient.oAuthAuthorize(ConnectorsClient.java:499)- at ConnectorsIdOauthAuthorizePost.main(ConnectorsIdOauthAuthorizePost.java:12)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 12s-]-`;--exports[`Testing language java testing file app/src/main/java/ConnectorsList.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/DatasetDelete.java 1`] = `-[Error: Command failed: gradle -PmainClass=DatasetDelete run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=dataset with the id 'id' not found}}- at com.cohere.api.resources.datasets.DatasetsClient.delete(DatasetsClient.java:489)- at com.cohere.api.resources.datasets.DatasetsClient.delete(DatasetsClient.java:447)- at DatasetDelete.main(DatasetDelete.java:8)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 12s-]-`;--exports[`Testing language java testing file app/src/main/java/DatasetGet.java 1`] = `-[Error: Command failed: gradle -PmainClass=DatasetGet run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=dataset with the id 'dataset_id' not found}}- at com.cohere.api.resources.datasets.DatasetsClient.get(DatasetsClient.java:408)- at com.cohere.api.resources.datasets.DatasetsClient.get(DatasetsClient.java:367)- at DatasetGet.main(DatasetGet.java:9)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 18s-]-`;--exports[`Testing language java testing file app/src/main/java/DatasetPost.java 1`] = `-[Error: Command failed: gradle -PmainClass=DatasetPost run-Exception in thread "main" java.lang.RuntimeException: java.lang.NullPointerException: Cannot invoke "java.io.File.toPath()" because "data" is null- at com.cohere.api.resources.datasets.DatasetsClient.create(DatasetsClient.java:219)- at com.cohere.api.resources.datasets.DatasetsClient.create(DatasetsClient.java:165)- at DatasetPost.main(DatasetPost.java:14)-Caused by: java.lang.NullPointerException: Cannot invoke "java.io.File.toPath()" because "data" is null- at com.cohere.api.resources.datasets.DatasetsClient.create(DatasetsClient.java:206)- ... 2 more--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 19s-]-`;--exports[`Testing language java testing file app/src/main/java/DatasetUsageGet.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/DetokenizePost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/EmbedJobsCancel.java 1`] = `-[Error: Command failed: gradle -PmainClass=EmbedJobsCancel run-Error: Could not find or load main class EmbedJobsCancel-Caused by: java.lang.ClassNotFoundException: EmbedJobsCancel--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 7s-]-`;--exports[`Testing language java testing file app/src/main/java/EmbedJobsGet.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/EmbedJobsPost.java 1`] = `-[Error: Command failed: gradle -PmainClass=EmbedJobsPost run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=dataset with id ds.id not found}}- at com.cohere.api.resources.embedjobs.EmbedJobsClient.create(EmbedJobsClient.java:179)- at com.cohere.api.resources.embedjobs.EmbedJobsClient.create(EmbedJobsClient.java:132)- at EmbedJobsPost.main(EmbedJobsPost.java:13)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 37s-]-`;--exports[`Testing language java testing file app/src/main/java/EmbedPost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/EmebedJobsGet.java 1`] = `-[Error: Command failed: gradle -PmainClass=EmebedJobsGet run-Exception in thread "main" CohereApiApiError{message: NotFoundError, statusCode: 404, body: {message=resource not found: could not find embed job with the ID: job_id}}- at com.cohere.api.resources.embedjobs.EmbedJobsClient.get(EmbedJobsClient.java:259)- at com.cohere.api.resources.embedjobs.EmbedJobsClient.get(EmbedJobsClient.java:218)- at EmebedJobsGet.main(EmebedJobsGet.java:9)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 6s-]-`;--exports[`Testing language java testing file app/src/main/java/GeneratePost.java 1`] = `-[Error: Command failed: gradle -PmainClass=GeneratePost run--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:compileJava'.-> Cannot access output property 'destinationDirectory' of task ':app:compileJava'. Accessing unreadable inputs or outputs is not supported. Declare the task as untracked by using Task.doNotTrackState(). For more information, please refer to https://docs.gradle.org/8.10/userguide/incremental_build.html#sec:disable-state-tracking in the Gradle documentation.- > java.nio.file.NoSuchFileException: /Users/billy/repositories/cohere-developer-experience/snippets/java/app/build/classes/java/main/DatasetDelete.class--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 22s-]-`;--exports[`Testing language java testing file app/src/main/java/ModelsListGet.java 1`] = `-[Error: Command failed: gradle -PmainClass=ModelsListGet run-Exception in thread "main" com.cohere.api.core.CohereApiError: Network error executing HTTP request- at com.cohere.api.resources.models.ModelsClient.list(ModelsClient.java:220)- at com.cohere.api.resources.models.ModelsClient.list(ModelsClient.java:137)- at com.cohere.api.resources.models.ModelsClient.list(ModelsClient.java:130)- at ModelsListGet.main(ModelsListGet.java:9)-Caused by: com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type \`com.cohere.api.types.CompatibleEndpoint\` from String "embed_image": not one of the values accepted for Enum class: [rate, summarize, classify, generate, chat, embed, rerank]- at [Source: (String)"{"models":[{"name":"embed-multilingual-v3.0","endpoints":["embed","classify"],"finetuned":false,"context_length":512,"tokenizer_url":"https://storage.googleapis.com/cohere-public/tokenizers/embed-multilingual-v3.0.json","default_endpoints":[]},{"name":"rerank-multilingual-v3-cophillips","endpoints":["rerank"],"finetuned":false,"context_length":4096,"tokenizer_url":"https://storage.googleapis.com/cohere-public/tokenizers/rerank-multilingual-v3-cophillips.json","default_endpoints":[]},{"name":"emb"[truncated 4086 chars]; line: 1, column: 1211] (through reference chain: com.cohere.api.types.ListModelsResponse$Builder["models"]->java.util.ArrayList[5]->com.cohere.api.types.GetModelResponse$Builder["endpoints"]->java.util.ArrayList[0])- at com.fasterxml.jackson.databind.exc.InvalidFormatException.from(InvalidFormatException.java:67)- at com.fasterxml.jackson.databind.DeserializationContext.weirdStringException(DeserializationContext.java:1991)- at com.fasterxml.jackson.databind.DeserializationContext.handleWeirdStringValue(DeserializationContext.java:1219)- at com.fasterxml.jackson.databind.deser.std.EnumDeserializer._deserializeAltString(EnumDeserializer.java:357)- at com.fasterxml.jackson.databind.deser.std.EnumDeserializer._fromString(EnumDeserializer.java:231)- at com.fasterxml.jackson.databind.deser.std.EnumDeserializer.deserialize(EnumDeserializer.java:198)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer._deserializeFromArray(CollectionDeserializer.java:355)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:244)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:28)- at com.fasterxml.jackson.databind.deser.std.ReferenceTypeDeserializer.deserialize(ReferenceTypeDeserializer.java:204)- at com.fasterxml.jackson.databind.deser.impl.MethodProperty.deserializeSetAndReturn(MethodProperty.java:158)- at com.fasterxml.jackson.databind.deser.BuilderBasedDeserializer.vanillaDeserialize(BuilderBasedDeserializer.java:293)- at com.fasterxml.jackson.databind.deser.BuilderBasedDeserializer.deserialize(BuilderBasedDeserializer.java:217)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer._deserializeFromArray(CollectionDeserializer.java:355)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:244)- at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:28)- at com.fasterxml.jackson.databind.deser.impl.MethodProperty.deserializeSetAndReturn(MethodProperty.java:158)- at com.fasterxml.jackson.databind.deser.BuilderBasedDeserializer.vanillaDeserialize(BuilderBasedDeserializer.java:293)- at com.fasterxml.jackson.databind.deser.BuilderBasedDeserializer.deserialize(BuilderBasedDeserializer.java:217)- at com.fasterxml.jackson.databind.deser.DefaultDeserializationContext.readRootValue(DefaultDeserializationContext.java:322)- at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4675)- at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3630)- at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3598)- at com.cohere.api.resources.models.ModelsClient.list(ModelsClient.java:173)- ... 3 more--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 21s-]-`;--exports[`Testing language java testing file app/src/main/java/RerankPost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/SummarizePost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/TokenizePost.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/chatpost/Default.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/chatpost/Documents.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/chatpost/Stream.java 1`] = `-[Error: Command failed: gradle -PmainClass=chatpost.Stream run-Exception in thread "main" java.lang.IllegalStateException: closed- at okio.RealBufferedSource.select(RealBufferedSource.kt:221)- at okhttp3.internal.Util.readBomAsCharset(Util.kt:265)- at okhttp3.ResponseBody$BomAwareReader.read(ResponseBody.kt:208)- at java.base/java.io.Reader.read(Reader.java:212)- at java.base/java.util.Scanner.readInput(Scanner.java:890)- at java.base/java.util.Scanner.hasNext(Scanner.java:1454)- at com.cohere.api.core.Stream$1.hasNext(Stream.java:60)- at chatpost.Stream.main(Stream.java:37)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 9s-]-`;--exports[`Testing language java testing file app/src/main/java/chatpost/Tools.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/finetuning/CreateFinetunedModel.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.CreateFinetunedModel run-Exception in thread "main" CohereApiApiError{message: BadRequestError, statusCode: 400, body: {message=dataset with id "my-dataset-id" does not exist}}- at com.cohere.api.resources.finetuning.FinetuningClient.createFinetunedModel(FinetuningClient.java:156)- at com.cohere.api.resources.finetuning.FinetuningClient.createFinetunedModel(FinetuningClient.java:121)- at finetuning.CreateFinetunedModel.main(CreateFinetunedModel.java:13)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 11s-]-`;--exports[`Testing language java testing file app/src/main/java/finetuning/DeleteFinetunedModel.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.DeleteFinetunedModel run-Error: Could not find or load main class finetuning.DeleteFinetunedModel-Caused by: java.lang.ClassNotFoundException: finetuning.DeleteFinetunedModel--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 6s-]-`;--exports[`Testing language java testing file app/src/main/java/finetuning/GetFinetunedModel.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.GetFinetunedModel run--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:compileJava'.-> Cannot access output property 'destinationDirectory' of task ':app:compileJava'. Accessing unreadable inputs or outputs is not supported. Declare the task as untracked by using Task.doNotTrackState(). For more information, please refer to https://docs.gradle.org/8.10/userguide/incremental_build.html#sec:disable-state-tracking in the Gradle documentation.- > java.nio.file.NoSuchFileException: /Users/billy/repositories/cohere-developer-experience/snippets/java/app/build/classes/java/main/DatasetDelete.class--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 4s-]-`;--exports[`Testing language java testing file app/src/main/java/finetuning/ListEvents.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.ListEvents run-Exception in thread "main" CohereApiApiError{message: InternalServerError, statusCode: 500, body: {message=failed to retrieve total size}}- at com.cohere.api.resources.finetuning.FinetuningClient.listEvents(FinetuningClient.java:428)- at com.cohere.api.resources.finetuning.FinetuningClient.listEvents(FinetuningClient.java:377)- at com.cohere.api.resources.finetuning.FinetuningClient.listEvents(FinetuningClient.java:372)- at finetuning.ListEvents.main(ListEvents.java:11)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 19s-]-`;--exports[`Testing language java testing file app/src/main/java/finetuning/ListFinetunedModels.java 1`] = `null`;--exports[`Testing language java testing file app/src/main/java/finetuning/ListTrainingStepMetrics.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.ListTrainingStepMetrics run-Exception in thread "main" CohereApiApiError{message: BadRequestError, statusCode: 400, body: {message=invalid finetune ID}}- at com.cohere.api.resources.finetuning.FinetuningClient.listTrainingStepMetrics(FinetuningClient.java:490)- at com.cohere.api.resources.finetuning.FinetuningClient.listTrainingStepMetrics(FinetuningClient.java:453)- at com.cohere.api.resources.finetuning.FinetuningClient.listTrainingStepMetrics(FinetuningClient.java:446)- at finetuning.ListTrainingStepMetrics.main(ListTrainingStepMetrics.java:12)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 6s-]-`;--exports[`Testing language java testing file app/src/main/java/finetuning/UpdateFinetunedModel.java 1`] = `-[Error: Command failed: gradle -PmainClass=finetuning.UpdateFinetunedModel run-Exception in thread "main" CohereApiApiError{message: BadRequestError, statusCode: 400, body: {message=finetuned_model.id is not a valid UUID: 'test-id'}}- at com.cohere.api.resources.finetuning.FinetuningClient.updateFinetunedModel(FinetuningClient.java:342)- at com.cohere.api.resources.finetuning.FinetuningClient.updateFinetunedModel(FinetuningClient.java:305)- at finetuning.UpdateFinetunedModel.main(UpdateFinetunedModel.java:17)--FAILURE: Build failed with an exception.--* What went wrong:-Execution failed for task ':app:run'.-> Process 'command '/Users/billy/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.4+7/Contents/Home/bin/java'' finished with non-zero exit value 1--* Try:-> Run with --stacktrace option to get the stack trace.-> Run with --info or --debug option to get more log output.-> Run with --scan to get full insights.-> Get more help at https://help.gradle.org.--BUILD FAILED in 7s-]-`;--exports[`Testing language node testing file chat-post/default.js 1`] = `null`;--exports[`Testing language node testing file chat-post/documents.js 1`] = `null`;--exports[`Testing language node testing file chat-post/stream.js 1`] = `-[Error: Command failed: node chat-post/stream.js-node:internal/streams/writable:474- throw new ERR_INVALID_ARG_TYPE(- ^--TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object- at _write (node:internal/streams/writable:474:13)- at Writable.write (node:internal/streams/writable:502:10)- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/chat-post/stream.js:23:22- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- code: 'ERR_INVALID_ARG_TYPE'-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file chat-post/tools.js 1`] = `null`;--exports[`Testing language node testing file classify-post.js 1`] = `null`;--exports[`Testing language node testing file connector-create.js 1`] = `-[Error: Command failed: node connector-create.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:256- throw new Cohere.BadRequestError(_response.error.body);- ^--BadRequestError: BadRequestError-Status code: 400-Body: {- "message": "connector not reachable at https://example.com/search. error: request failed with status code 405"-}- at Connectors.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:256:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 400,- body: {- message: 'connector not reachable at https://example.com/search. error: request failed with status code 405'- }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file connector-delete.js 1`] = `-[Error: Command failed: node connector-delete.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:522- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "connector not found, id = connector-id"-}- at Connectors.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:522:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: { message: 'connector not found, id = connector-id' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file connector-get.js 1`] = `-[Error: Command failed: node connector-get.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:392- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "connector not found, id = connector-id"-}- at Connectors.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:392:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: { message: 'connector not found, id = connector-id' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file connector-patch.js 1`] = `-[Error: Command failed: node connector-patch.js-file:///Users/billy/repositories/cohere-developer-experience/snippets/node/connector-patch.js:8- const connector = await cohere.connectors.update(connector.id, {- ^--ReferenceError: Cannot access 'connector' before initialization- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/connector-patch.js:8:52- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/connector-patch.js:14:3- at ModuleJob.run (node:internal/modules/esm/module_job:222:25)- at async ModuleLoader.import (node:internal/modules/esm/loader:316:24)- at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:123:5)--Node.js v20.13.0-]-`;--exports[`Testing language node testing file connectors-id-oauth-authorize-post.js 1`] = `-[Error: Command failed: node connectors-id-oauth-authorize-post.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:795- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "connector not found, id = connector-id"-}- at Connectors.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:795:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/connectors/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: { message: 'connector not found, id = connector-id' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file connectors-list.js 1`] = `null`;--exports[`Testing language node testing file dataset-get.js 1`] = `-[Error: Command failed: node dataset-get.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/datasets/client/Client.js:560- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "dataset with the id '<<datasetId>>' not found"-}- at Datasets.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/datasets/client/Client.js:560:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/datasets/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: { message: "dataset with the id '<<datasetId>>' not found" }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file dataset-post.js 1`] = `-[Error: Command failed: node dataset-post.js-file:///Users/billy/repositories/cohere-developer-experience/snippets/node/dataset-post.js:2-const fs = require('fs');- ^--ReferenceError: require is not defined in ES module scope, you can use import instead-This file is being treated as an ES module because it has a '.js' file extension and '/Users/billy/repositories/cohere-developer-experience/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/dataset-post.js:2:12- at ModuleJob.run (node:internal/modules/esm/module_job:222:25)- at async ModuleLoader.import (node:internal/modules/esm/loader:316:24)- at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:123:5)--Node.js v20.13.0-]-`;--exports[`Testing language node testing file dataset-usage-get.js 1`] = `null`;--exports[`Testing language node testing file detokenize-post.js 1`] = `null`;--exports[`Testing language node testing file embed-jobs-cancel.js 1`] = `-[Error: Command failed: node embed-jobs-cancel.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:507- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "resource not found: could not find embed job with the ID: job_id"-}- at EmbedJobs.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:507:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: {- message: 'resource not found: could not find embed job with the ID: job_id'- }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file embed-jobs-get.js 1`] = `null`;--exports[`Testing language node testing file embed-jobs-post.js 1`] = `-[Error: Command failed: node embed-jobs-post.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:253- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "dataset with id my-dataset not found"-}- at EmbedJobs.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:253:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: { message: 'dataset with id my-dataset not found' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file embed-post.js 1`] = `null`;--exports[`Testing language node testing file emebed-jobs-get.js 1`] = `-[Error: Command failed: node emebed-jobs-get.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:383- throw new Cohere.NotFoundError(_response.error.body);- ^--NotFoundError: NotFoundError-Status code: 404-Body: {- "message": "resource not found: could not find embed job with the ID: job_id"-}- at EmbedJobs.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:383:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/embedJobs/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 404,- body: {- message: 'resource not found: could not find embed job with the ID: job_id'- }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/create-finetuned-model.js 1`] = `-[Error: Command failed: node finetuning/create-finetuned-model.js-file:///Users/billy/repositories/cohere-developer-experience/snippets/node/finetuning/create-finetuned-model.js:12- base_type: Cohere.Finetuning.BaseType.BaseTypeChat,- ^--TypeError: Cannot read properties of undefined (reading 'BaseType')- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/finetuning/create-finetuned-model.js:12:38- at file:///Users/billy/repositories/cohere-developer-experience/snippets/node/finetuning/create-finetuned-model.js:19:3- at ModuleJob.run (node:internal/modules/esm/module_job:222:25)- at async ModuleLoader.import (node:internal/modules/esm/loader:316:24)- at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:123:5)--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/delete-finetuned-model.js 1`] = `-[Error: Command failed: node finetuning/delete-finetuned-model.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:379- throw new Cohere.BadRequestError(_response.error.body);- ^--BadRequestError: BadRequestError-Status code: 400-Body: {- "message": "fine-tuned model ID is not a valid UUID: 'test-id'"-}- at Finetuning.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:379:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 400,- body: { message: "fine-tuned model ID is not a valid UUID: 'test-id'" }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/get-finetuned-model.js 1`] = `-[Error: Command failed: node finetuning/get-finetuned-model.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:296- throw new Cohere.BadRequestError(_response.error.body);- ^--BadRequestError: BadRequestError-Status code: 400-Body: {- "message": "finetuned_model.id is not a valid UUID: 'test-id'"-}- at Finetuning.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:296:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 400,- body: { message: "finetuned_model.id is not a valid UUID: 'test-id'" }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/list-events.js 1`] = `-[Error: Command failed: node finetuning/list-events.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:580- throw new Cohere.InternalServerError(_response.error.body);- ^--InternalServerError: InternalServerError-Status code: 500-Body: {- "message": "failed to retrieve total size"-}- at Finetuning.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:580:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 500,- body: { message: 'failed to retrieve total size' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/list-finetuned-models.js 1`] = `null`;--exports[`Testing language node testing file finetuning/list-training-step-metrics.js 1`] = `-[Error: Command failed: node finetuning/list-training-step-metrics.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:665- throw new Cohere.BadRequestError(_response.error.body);- ^--BadRequestError: BadRequestError-Status code: 400-Body: {- "message": "invalid finetune ID"-}- at Finetuning.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:665:31)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:31:58)- at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {- statusCode: 400,- body: { message: 'invalid finetune ID' }-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file finetuning/update-finetuned-model.js 1`] = `-[Error: Command failed: node finetuning/update-finetuned-model.js-/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/core/schemas/builders/schema-utils/getSchemaUtils.js:23- throw new JsonError_1.JsonError(raw.errors);- ^--JsonError: Missing required key "settings"- at Object.jsonOrThrow (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/core/schemas/builders/schema-utils/getSchemaUtils.js:23:19)- at Finetuning.<anonymous> (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:455:73)- at Generator.next (<anonymous>)- at fulfilled (/Users/billy/repositories/cohere-developer-experience/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected]_/node_modules/cohere-ai/api/resources/finetuning/client/Client.js:31:58) {- errors: [ { path: [], message: 'Missing required key "settings"' } ]-}--Node.js v20.13.0-]-`;--exports[`Testing language node testing file generate-post.js 1`] = `null`;--exports[`Testing language node testing file models-list-get.js 1`] = `null`;--exports[`Testing language node testing file rerank-post.js 1`] = `null`;--exports[`Testing language node testing file summarize-post.js 1`] = `null`;--exports[`Testing language node testing file tokenize-post.js 1`] = `null`;--exports[`Testing language python testing file chat-post.py 1`] = `null`;--exports[`Testing language python testing file chat-post/default.py 1`] = `null`;--exports[`Testing language python testing file chat-post/documents.py 1`] = `null`;--exports[`Testing language python testing file chat-post/stream.py 1`] = `null`;--exports[`Testing language python testing file chat-post/tools.py 1`] = `null`;--exports[`Testing language python testing file classify-post.py 1`] = `null`;--exports[`Testing language python testing file connector-create.py 1`] = `-[Error: Command failed: poetry run python connector-create.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/connector-create.py", line 4, in <module>- response = co.connectors.create(- ^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/connectors/client.py", line 307, in create- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': 'connector not reachable at https://connector-example.com/search. error: Post "https://connector-example.com/search": Internal Server Error'}-]-`;--exports[`Testing language python testing file connector-delete.py 1`] = `-[Error: Command failed: poetry run python connector-delete.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/connector-delete.py", line 4, in <module>- co.connectors.delete("test-id")- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/connectors/client.py", line 653, in delete- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': 'connector not found, id = test-id'}-]-`;--exports[`Testing language python testing file connector-get.py 1`] = `-[Error: Command failed: poetry run python connector-get.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/connector-get.py", line 4, in <module>- response = co.connectors.get("test-id")- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/connectors/client.py", line 495, in get- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': 'connector not found, id = test-id'}-]-`;--exports[`Testing language python testing file connector-patch.py 1`] = `-[Error: Command failed: poetry run python connector-patch.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/connector-patch.py", line 4, in <module>- response = co.connectors.update(- ^^^^^^^^^^^^^^^^^^^^^-TypeError: ConnectorsClient.update() got an unexpected keyword argument 'connector_id'-]-`;--exports[`Testing language python testing file connectors-id-oauth-authorize-post.py 1`] = `-[Error: Command failed: poetry run python connectors-id-oauth-authorize-post.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/connectors-id-oauth-authorize-post.py", line 4, in <module>- response = co.connectors.o_auth_authorize(- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^-TypeError: ConnectorsClient.o_auth_authorize() got an unexpected keyword argument 'connector_id'-]-`;--exports[`Testing language python testing file connectors-list.py 1`] = `null`;--exports[`Testing language python testing file dataset-delete.py 1`] = `-[Error: Command failed: poetry run python dataset-delete.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/dataset-delete.py", line 6, in <module>- co.datasets.delete("id")- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/datasets/client.py", line 840, in delete- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': "dataset with the id 'id' not found"}-]-`;--exports[`Testing language python testing file dataset-get.py 1`] = `-[Error: Command failed: poetry run python dataset-get.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/dataset-get.py", line 6, in <module>- response = co.datasets.get(id="<<datasetId>>")- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/datasets/client.py", line 681, in get- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': "dataset with the id '<<datasetId>>' not found"}-]-`;--exports[`Testing language python testing file dataset-post.py 1`] = `-[Error: Command failed: poetry run python dataset-post.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/dataset-post.py", line 8, in <module>- data=open("./chat.jsonl", "rb"),- ^^^^^^^^^^^^^^^^^^^^^^^^^^-FileNotFoundError: [Errno 2] No such file or directory: './chat.jsonl'-]-`;--exports[`Testing language python testing file dataset-usage-get.py 1`] = `null`;--exports[`Testing language python testing file detokenize-post.py 1`] = `null`;--exports[`Testing language python testing file embed-jobs-cancel.py 1`] = `-[Error: Command failed: poetry run python embed-jobs-cancel.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/embed-jobs-cancel.py", line 6, in <module>- co.embed_jobs.cancel("job_id")- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/embed_jobs/client.py", line 630, in cancel- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': 'resource not found: could not find embed job with the ID: job_id'}-]-`;--exports[`Testing language python testing file embed-jobs-get.py 1`] = `null`;--exports[`Testing language python testing file embed-jobs-post.py 1`] = `-[Error: Command failed: poetry run python embed-jobs-post.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/embed-jobs-post.py", line 6, in <module>- job = co.embed_jobs.create(- ^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/embed_jobs/client.py", line 321, in create- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': 'dataset with id my-dataset-id not found'}-]-`;--exports[`Testing language python testing file embed-post.py 1`] = `null`;--exports[`Testing language python testing file emebed-jobs-get.py 1`] = `-[Error: Command failed: poetry run python emebed-jobs-get.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/emebed-jobs-get.py", line 6, in <module>- response = co.embed_jobs.get("job_id")- ^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/embed_jobs/client.py", line 479, in get- raise NotFoundError(-cohere.errors.not_found_error.NotFoundError: status_code: 404, body: {'message': 'resource not found: could not find embed job with the ID: job_id'}-]-`;--exports[`Testing language python testing file finetuning/create-finetuned-model.py 1`] = `-[Error: Command failed: poetry run python finetuning/create-finetuned-model.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/create-finetuned-model.py", line 17, in <module>- finetuned_model = co.finetuning.create_finetuned_model(- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 220, in create_finetuned_model- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': 'proto:\\xa0(line 1:258): unknown field "train_epoch"'}-]-`;--exports[`Testing language python testing file finetuning/delete-finetuned-model.py 1`] = `-[Error: Command failed: poetry run python finetuning/delete-finetuned-model.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/delete-finetuned-model.py", line 4, in <module>- co.finetuning.delete_finetuned_model("test-id")- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 436, in delete_finetuned_model- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': "fine-tuned model ID is not a valid UUID: 'test-id'"}-]-`;--exports[`Testing language python testing file finetuning/get-finetuned-model.py 1`] = `-[Error: Command failed: poetry run python finetuning/get-finetuned-model.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/get-finetuned-model.py", line 4, in <module>- response = co.finetuning.get_finetuned_model("test-id")- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 328, in get_finetuned_model- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': "finetuned_model.id is not a valid UUID: 'test-id'"}-]-`;--exports[`Testing language python testing file finetuning/list-events.py 1`] = `-[Error: Command failed: poetry run python finetuning/list-events.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/list-events.py", line 4, in <module>- response = co.finetuning.list_events(finetuned_model_id="test-id")- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 779, in list_events- raise InternalServerError(-cohere.errors.internal_server_error.InternalServerError: status_code: 500, body: {'message': 'failed to retrieve total size'}-]-`;--exports[`Testing language python testing file finetuning/list-finetuned-models.py 1`] = `null`;--exports[`Testing language python testing file finetuning/list-training-step-metrics.py 1`] = `-[Error: Command failed: poetry run python finetuning/list-training-step-metrics.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/list-training-step-metrics.py", line 4, in <module>- train_step_metrics = co.finetuning.list_training_step_metrics(- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 862, in list_training_step_metrics- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': 'invalid finetune ID'}-]-`;--exports[`Testing language python testing file finetuning/update-finetuned-model.py 1`] = `-[Error: Command failed: poetry run python finetuning/update-finetuned-model.py-Traceback (most recent call last):- File "/Users/billy/repositories/cohere-developer-experience/snippets/python/finetuning/update-finetuned-model.py", line 8, in <module>- finetuned_model = co.finetuning.update_finetuned_model(- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^- File "/Users/billy/Library/Caches/pypoetry/virtualenvs/py-snips-je53b3MO-py3.11/lib/python3.11/site-packages/cohere/finetuning/client.py", line 605, in update_finetuned_model- raise BadRequestError(-cohere.errors.bad_request_error.BadRequestError: status_code: 400, body: {'message': "finetuned_model.id is not a valid UUID: 'test-id'"}-]-`;--exports[`Testing language python testing file generate-post.py 1`] = `null`;--exports[`Testing language python testing file models-list-get.py 1`] = `null`;--exports[`Testing language python testing file rerank-post.py 1`] = `null`;--exports[`Testing language python testing file summarize-post.py 1`] = `null`;--exports[`Testing language python testing file tokenize-post.py 1`] = `null`;diff --git a/fern/packages/snippet-tester/src/tests/snippets.test.ts b/fern/packages/snippet-tester/src/tests/snippets.test.tsdeleted file mode 100644index bb7589405..000000000--- a/fern/packages/snippet-tester/src/tests/snippets.test.ts+++ /dev/null@@ -1,32 +0,0 @@-import { describe, expect, test } from 'bun:test';-import * as fs from "fs";-import { glob } from "glob";-import path from 'path';-import { config, Language } from '../config';-import { execCmd } from '../utils';--// recurse up until you find a pnpm-workspace.yaml-const findPnpmWorkspaceDir = (curDir = __dirname) => {- if (curDir === "/") {- throw new Error("Could not find pnpm-workspace.yaml")- }-- if (fs.existsSync(path.resolve(curDir, "pnpm-lock.yaml"))) {- return curDir- }-- return findPnpmWorkspaceDir(fs.realpathSync(path.resolve(curDir, "..")))-}--const workspaceDir = findPnpmWorkspaceDir()--describe.each(config.languages.map(o => [o.name, o] as [string, Language]))("Testing language %s", (name: string, lang: Language) => {- const cwd = lang.snippetRoot(workspaceDir)- const filePaths = glob.globSync(lang.glob, { cwd })-- test.each(filePaths)('testing file %s', async (filePath: string) => {- const { error } = await execCmd(lang.exec(filePath), cwd)-- expect(error).toMatchSnapshot()- }, { timeout: 1000000 });-})\ No newline at end of filediff --git a/fern/packages/snippet-tester/src/utils.ts b/fern/packages/snippet-tester/src/utils.tsdeleted file mode 100644index dafce6b93..000000000--- a/fern/packages/snippet-tester/src/utils.ts+++ /dev/null@@ -1,67 +0,0 @@-import * as childProcess from "child_process"-import fs from "fs"--export const findAndReplace = async (paths: string[], find: RegExp, replace: string) => {- await Promise.all(paths.map(async (path) => {- const file = await fs.promises.readFile(path)- const content = file.toString()- const newContent = content.replace(find, replace)- await fs.promises.writeFile(path, newContent)- }))-}--export const execCmd = async (cmd: string, cwd: string): Promise<{error: null | childProcess.ExecException, stderr: string, stdout: string}> => {- return new Promise((resolve, reject) => {- try {- childProcess.exec(cmd, {cwd}, (error, stdout, stderr) => {- if (error) {- resolve({error, stderr, stdout})- }- resolve({ error, stderr, stdout})- })- } catch (error) {- if (error instanceof Error) {- resolve({error: error as childProcess.ExecException, stderr: '', stdout: ''})- } else {- resolve({error: null, stderr: String(error), stdout: ''})- }- }- })-}--export const getFilesByExtension = async (base: string, extension: string): Promise<string[]> => {- const list = await fs.promises.readdir(base)- const all = await Promise.all(list.flatMap((file) => {- const filepath = `${base}/${file}`-- if (fs.statSync(filepath).isDirectory()) {- return getFilesByExtension(filepath, extension)- } else if (file.endsWith(extension)) {- return filepath- }-- return []- }))-- return all.flat()-}--export const execTypescriptFile = async (projectRoot: string, file: string) => {- const cmd = `bun run ${file}`- return execCmd(cmd, projectRoot)-}--export const execJavaFile = async (projectRoot: string, file: string) => {- const cmd = `java ${file}`- return execCmd(cmd, projectRoot)-}--export const execPythonFile = async (projectRoot: string, file: string) => {- const cmd = `python ${file}`- return execCmd(cmd, projectRoot)-}--export const execGoFile = async (projectRoot: string, file: string) => {- const cmd = `go run ${file}`- return execCmd(cmd, projectRoot)-}diff --git a/fern/packages/snippet-tester/tsconfig.json b/fern/packages/snippet-tester/tsconfig.jsondeleted file mode 100644index 62b6d65a0..000000000--- a/fern/packages/snippet-tester/tsconfig.json+++ /dev/null@@ -1,24 +0,0 @@-{- "compilerOptions": {- "target": "es2022",- "lib": ["ESNext"],- "module": "esnext",- "moduleResolution": "bundler",- "types": ["bun-types"],- "skipLibCheck": true,- "resolveJsonModule": true,- "allowImportingTsExtensions": true,- "isolatedModules": true,- "noEmit": true,- "strict": true,- "noUnusedLocals": true,- "noUnusedParameters": true,- "noFallthroughCasesInSwitch": true,- "outDir": "dist",- "declaration": true,- "esModuleInterop": true,- "forceConsistentCasingInFileNames": true- },- "include": ["src/**/*"],- "exclude": ["node_modules", "dist"]-}\ No newline at end of filediff --git a/fern/pages/src/authentication/connected-accounts.mdx b/fern/pages/src/authentication/connected-accounts.mdxdeleted file mode 100644index 4771342aa..000000000--- a/fern/pages/src/authentication/connected-accounts.mdx+++ /dev/null@@ -1,194 +0,0 @@-----title: Connected Accounts-image: "https://og.composio.dev/api/og?title=Connected%20Accounts"-subtitle: "Manage and monitor user connections to toolkits"-keywords: "connected accounts, manage connections, refresh tokens, account status, account credentials, disable accounts, delete accounts, redacted, mask secrets, mask connected account secrets"-hide-nav-links: true------Connected accounts are authenticated connections between your users and toolkits. After users authenticate (see [Authenticating tools](/docs/authenticating-tools)), you can manage these accounts throughout their lifecycle.--Composio automatically handles token refresh and credential management. This guide covers manual operations: listing, retrieving, refreshing, enabling, disabling, and deleting accounts.--## List accounts--Retrieve all connected accounts with optional filters:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={12}- endLine={22}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={12}- endLine={22}-/>-</CodeGroup>---## Get account details--Retrieve a connected account by ID:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={25}- endLine={28}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={25}- endLine={28}-/>-</CodeGroup>--### Get account credentials--Get account credentials for use with your own tools:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={32}- endLine={39}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={32}- endLine={40}-/>-</CodeGroup>--<Warning>-If credentials return as `REDACTED` instead of actual values, the **Mask Connected Account Secrets** setting is enabled on your account. This setting redacts all sensitive credential data (tokens, secrets, API keys) for security purposes.--To view actual credentials, navigate to **Settings → Project Settings → Project Configuration** and disable "Mask Connected Account Secrets".-</Warning>--## Refresh credentials--Manually refresh credentials for a connected account:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={43}- endLine={50}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={44}- endLine={52}-/>-</CodeGroup>---## Enable and disable accounts--Change account status without deleting. Set to INACTIVE to pause access, or ACTIVE to restore. Useful for:-- Pausing access during subscription lapses-- Temporary disconnection--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={54}- endLine={60}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={56}- endLine={62}-/>-</CodeGroup>--<Warning>-INACTIVE accounts cannot execute tools. Tool execution will fail until the status is changed.-</Warning>--## Delete accounts--Permanently remove a connected account and revoke all credentials:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={64}- endLine={66}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={66}- endLine={68}-/>-</CodeGroup>--<Warning>-Deletion is permanent. Users must re-authenticate to reconnect.-</Warning>--## Multiple accounts--Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail).--<Note>-Use `link()` for creating accounts, as it provides hosted authentication and allows multiple accounts by default. See [Connect Link authentication](/docs/authenticating-tools#hosted-authentication-connect-link).-</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={70}- endLine={93}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={72}- endLine={99}-/>-</CodeGroup>--### Execute with a specific account--When you have multiple accounts, specify which one to use with `connected_account_id`:--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connected-accounts-management.py"- title="Python"- startLine={95}- endLine={102}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connected-accounts-management.ts"- title="TypeScript"- startLine={101}- endLine={107}-/>-</CodeGroup>-diff --git a/fern/pages/src/authentication/custom-auth-configs.mdx b/fern/pages/src/authentication/custom-auth-configs.mdxdeleted file mode 100644index f8910ef60..000000000--- a/fern/pages/src/authentication/custom-auth-configs.mdx+++ /dev/null@@ -1,254 +0,0 @@-----title: Custom Auth Configs-image: "https://og.composio.dev/api/og?title=Custom%20Auth%20Configs" # image for socials-subtitle: 'Customize auth configs for any toolkit'-keywords: ''-hide-nav-links: true------Many toolkits support a level of customization for the auth config, specifically OAuth applications.--This guide will walk you through the process of customizing the auth config for toolkits where you can configure your own developer app.--## Creating a custom auth config--To create a custom auth config, click **Create Auth Config** in your dashboard, then navigate to **Authentication management** → **Manage authentication with custom credentials**.--You'll need to customize the auth config when you want to use different values than the defaults - such as your own subdomain, base URL, client ID, client secret, etc.--<Tabs>-<Tab title="Example: PostHog">-You may change the subdomain for the PostHog toolkit to match your own instance.-<Frame background="subtle" title="PostHog Auth Config Settings">-<img src="../../../assets/images/custom-auth-posthog.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>-</Tab>-<Tab title="Example: Hubspot">-For Hubspot you may customize everything here. For each auth scheme there is a different set of fields.--If you choose to use your own developer app for the OAuth2 scheme, you will have to provide the client ID and client secret.--<Frame background="subtle" title="Hubspot Auth Config Settings">-<img src="../../../assets/images/custom-auth-hubspot.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>-</Tab>-</Tabs>--Toolkits that support OAuth2 allow using your own developer app. This is the recommended approach for most cases.--<Tip title="Use your own developer app!" icon="fa-light fa-exclamation">-We recommend using your own developer app for the OAuth2 scheme as it is more suited for production usage with many users and more granular control over scopes.--However, getting OAuth approvals takes time, so Composio provides a default developer app!--</Tip>--## OAuth2 Auth Configs--<Steps>-<Step title="Generate the OAuth Client ID and Client Secret">-To set up a custom OAuth config, you'll need the OAuth Client ID and Client Secret.--You can generate the client ID and client secret from your provider's OAuth configuration page.--Examples for Google and GitHub:--<Tabs>- <Tab title="Google">- <Frame background="subtle" caption="Google OAuth Configuration">- <img src="../../../assets/images/google-oauth-config.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />- </Frame>- </Tab>- <Tab title="GitHub">- <Frame background="subtle" caption="GitHub OAuth Configuration">- <img src="../../../assets/images/github-oauth-config.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />- </Frame>- </Tab>-</Tabs>--</Step>-<Step title="Set the Authorized Redirect URI">-When creating your OAuth app, make sure to configure the Authorized Redirect URI to point to the Composio callback URL below:--```-https://backend.composio.dev/api/v3/toolkits/auth/callback-```--</Step>-<Step title="Create the auth config">-Once you have the OAuth credentials, you can add them to the auth config in the dashboard.--1. Select the OAuth2 scheme.-2. Select the scopes to request from users. Default scopes are pre-filled for most apps.-3. Add the OAuth client ID and client secret for your developer app. Keep the redirect URL as is for now!-4. Click Create!--<Frame background="subtle" title="Auth Config Settings">- <img src="../../../assets/images/integration-step-3-0.png" style={{ maxHeight: '450px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>---</Step>-</Steps>--This auth config is now ready to be used in your application!--<CodeGroup>-```python Python maxLines=60-# Create a new connected account-connection_request = composio.connected_accounts.initiate(- user_id="user_id",- auth_config_id="ac_1234",- callback_url="https://yourapp.com/oauth/callback"-)--# Redirect the user to connection_request.redirect_url-print(connection_request.redirect_url)--# Wait for the connection to be established-connected_account = connection_request.wait_for_connection()-print(connected_account)-```-```typescript TypeScript maxLines=60-const connReq = await composio.connectedAccounts.initiate(userId, "ac_1234", {- callbackUrl: "https://yourapp.com/oauth/callback",-});--// Redirect the user to connReq.redirectUrl-console.log(connReq.redirectUrl);--const connection = await composio.connectedAccounts.waitForConnection(- connReq.id-);--console.log(connection);-```--</CodeGroup>---### White-labeling the OAuth Consent Screen--By default the users will see an OAuth screen like the one below:--<Frame background="subtle" caption="Composio's Domain in OAuth Consent Screen">- <img src="../../../assets/images/oauth-branding.png" style={{ maxHeight: '350px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>--The OAuth redirect URL is surfaced in some OAuth providers' consent screens. This may cause confusion for some users as that URL is not of the same domain as the application.--To remediate this:--<Steps>-<Step title="Set the Authorized Redirect URI">-Specify the Authorized Redirect URI to your own domain in the OAuth configuration.-For example:-```-https://yourdomain.com/api/composio-redirect-```--</Step>-<Step title="Create a redirect logic">-Create a redirect logic, either through your DNS or in your application to redirect that endpoint to `https://backend.composio.dev/api/v3/toolkits/auth/callback`--**Example: API Route for OAuth Redirect**--<CodeGroup>-```python FastAPI (app.py)-from fastapi import FastAPI-from fastapi.responses import RedirectResponse--from composio import Composio--# Create a FastAPI app-app = FastAPI()--# Create a Composio client-composio = Composio()--[email protected]("/authorize/{toolkit}")-def authorize_app(toolkit: str):- # retrieve the user id from your app- user_id = "<user_id>"-- # retrieve the auth config id from your app- auth_config_id = "<auth_config_id>"-- # initiate the connection request- connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- callback_url="https://yourapp.com/oauth/callback"- )- return RedirectResponse(url=connection_request.redirect_url)-```--```typescript Next.js (pages/api/composio-redirect.ts)-import type { NextApiRequest, NextApiResponse } from 'next';--export default function handler(req: NextApiRequest, res: NextApiResponse) {- // The target Composio endpoint that handles OAuth callbacks- const composioEndpoint = 'https://backend.composio.dev/api/v3/toolkits/auth/callback';--// Extract and preserve all query parameters-const queryParams = new URLSearchParams();-Object.entries(req.query).forEach(([key, value]) => {-if (typeof value === 'string') {-queryParams.append(key, value);-}-});--// Redirect to Composio with all query parameters intact-const redirectUrl = `${composioEndpoint}?${queryParams.toString()}`;-res.redirect(302, redirectUrl);-}--```--</CodeGroup>-</Step>-<Step title="Create the auth config">-Specify your custom redirect URI in the auth config settings!--<Frame background="subtle" title="Auth Config Settings">-<img src="../../../assets/images/custom-redirect-uri.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>-</Step>-</Steps>--With this setup, you can use `https://yourdomain.com/api/composio-redirect` as your OAuth redirect URI, which will create a better user experience by keeping users on your domain during the OAuth flow.--<Accordion title="How does this work?">--The custom OAuth config allows you to use your own domain in the OAuth consent screen instead of Composio's domain. Here's the core difference:--```mermaid-flowchart TD- A[Your App initiates OAuth] --> B[User redirected to OAuth Provider]- B --> C{Redirect URI Configuration}-- C -->|Direct Setup| D[Provider redirects to<br/>backend.composio.dev]- C -->|Custom Domain| E[Provider redirects to<br/>yourdomain.com/api/composio-redirect]-- E --> F[Your endpoint forwards to<br/>backend.composio.dev]-- D --> G[Composio exchanges code for token]- F --> G-- G --> H[Connection established]-- style E fill:#e1f5fe- style F fill:#e1f5fe- style C fill:#fff3e0-```--**Key Benefits:**--- **Custom Domain**: Users see your domain in OAuth consent screens, not Composio's-- **Same Security**: Your domain just forwards the OAuth callback - no token handling-- **Better UX**: Maintains brand consistency throughout the auth flow--The custom redirect endpoint is a simple passthrough that preserves all OAuth parameters while keeping users on your domain.--</Accordion>diff --git a/fern/pages/src/authentication/custom-auth-params.mdx b/fern/pages/src/authentication/custom-auth-params.mdxdeleted file mode 100644index 76e5110b0..000000000--- a/fern/pages/src/authentication/custom-auth-params.mdx+++ /dev/null@@ -1,124 +0,0 @@-----title: Custom Auth Parameters-image: "https://og.composio.dev/api/og?title=Custom%20Auth%20Parameters" # image for socials-subtitle: "Inject custom credentials in headers or parameters"-keywords: ""-hide-nav-links: true------In cases where Composio is not being used for managing the auth but only for the tools, it is possible to use the `beforeExecute` hook to inject custom auth headers or parameters for a toolkit.--## Setup and Initialization--First, initialize the Composio SDK with your API key:--<CodeGroup>-```python Python maxLines=10-from composio import Composio--composio = Composio()-```-```typescript TypeScript maxLines=10-import { Composio } from "@composio/core";--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});-```-</CodeGroup>--## Creating the Auth Modifier Function--Define a function that modifies authentication parameters for specific toolkits. This function checks the toolkit name and adds custom authentication headers when needed.--<Card title="This is a Before Execute Modifier!" href="/docs/modifying-tool-inputs" icon="fa-light fa-magic">--Before Execute Modifiers are a way to modify the parameters of a tool before it is executed. In this case, they are useful for adding custom authentication headers or parameters to a tool.-</Card>--<CodeGroup>-```python Python maxLines=25-from composio import before_execute-from composio.types import ToolExecuteParams---@before_execute(toolkits=["NOTION"])-def add_custom_auth(- tool: str,- toolkit: str,- params: ToolExecuteParams,-) -> ToolExecuteParams:- if params["custom_auth_params"] is None:- params["custom_auth_params"] = {"parameters": []}-- params["custom_auth_params"]["parameters"].append(- {- "name": "x-api-key",- "value": os.getenv("NOTION_API_KEY"),- "in": "header",- }- )- return params-```-```typescript TypeScript maxLines=25-const authModifier = (toolSlug: string, toolkitSlug: string, params: any) => {- // Add authentication parameters for specific toolkits- if (toolkitSlug === "NOTION") {- if (!params.customAuthParams) {- params.customAuthParams = {};- }-- if (!params.customAuthParams.parameters) {- params.customAuthParams.parameters = [];- }-- // Add an API key to the headers- params.customAuthParams.parameters.push({- in: "header",- name: "X-API-Key",- value: process.env.CUSTOM_API_KEY,- });- }- return params;-};-```-</CodeGroup>--## Executing Tools with Custom Auth--Execute the tool using the custom authentication modifier. The `beforeExecute` hook allows you to modify parameters before the tool runs.---Following is an example of how to execute a tool with a custom authentication modifier for Completion Providers.--For Agentic Providers, read about [Modifying tool inputs](/docs/modifying-tool-inputs).--<CodeGroup>-```python Python maxLines=20-result = composio.tools.execute(- slug="NOTION_GET_DATABASE_ITEMS",- user_id="default",- arguments={},- modifiers=[- add_custom_auth,- ],-)-print(result)-```-```typescript TypeScript maxLines=20-const result = await composio.tools.execute(- "NOTION_GET_DATABASE_ITEMS",- {- userId: "sid",- arguments: {- database_id: "1234567890",- },- },- {- beforeExecute: authModifier,- }-);--console.log(JSON.stringify(result, null, 2));-```-</CodeGroup>\ No newline at end of filediff --git a/fern/pages/src/authentication/programmatic-auth-configs.mdx b/fern/pages/src/authentication/programmatic-auth-configs.mdxdeleted file mode 100644index c723f722a..000000000--- a/fern/pages/src/authentication/programmatic-auth-configs.mdx+++ /dev/null@@ -1,196 +0,0 @@-----title: Programmatic Auth Configs-image: "https://og.composio.dev/api/og?title=Programmatic%20Auth%20Configs" # image for socials-subtitle: "Create auth configs programmatically"-keywords: ""-hide-nav-links: true------Auth configs are created once and reused many times. However, when managing multiple toolkits, you may want to create auth configs programmatically.--- When creating and destroying auth configs multiple times in your app's lifecycle.-- When creating auth configs for your users' users.--## OAuth2 based apps--### Using Composio Default Auth-Since OAuth2 is the most common authentication type for applications, Composio provides managed auth for most OAuth2 based applications.-This is to speed up development and prototyping.-This means you don't have to provide your own OAuth credentials.--<CodeGroup>-```python Python maxLines=60 wordWrap-from composio import Composio--composio = Composio()--# Use composio managed auth-auth_config = composio.auth_configs.create(- toolkit="github",- options={- "type": "use_composio_managed_auth",- },-)-print(auth_config)-```--```typescript TypeScript maxLines=60 wordWrap {7}-import { Composio } from "@composio/core";--const composio = new Composio();--const authConfig = await composio.authConfigs.create("GITHUB", {- name: "GitHub",- type: "use_composio_managed_auth",-});--console.log(authConfig);-```-</CodeGroup>--The returned `auth_config_id` should be stored securely in your database for future use to be created and destroyed multiple times.--You can also provide your own authentication details. The required `credentials` and `authScheme` depend on the auth type.--### Using your own OAuth2 credentials-Setting up and using your own OAuth2 credentials is the recommended way when going to production or expecting high usage.--In this example, we're using our own OAuth2 client ID and secret to create the auth config for Notion.--<CodeGroup>-```python Python maxLines=60 wordWrap {7}-# Use custom auth-auth_config = composio.auth_configs.create(- toolkit="notion",- options={- "name": "Notion Auth",- "type": "use_custom_auth",- "auth_scheme": "OAUTH2",- "credentials": {- "client_id": "1234567890",- "client_secret": "1234567890",- "oauth_redirect_uri": "https://backend.composio.dev/api/v3/toolkits/auth/callback",- },- },-)-print(auth_config)-```-```typescript TypeScript maxLines=60 wordWrap {3}-const authConfig = await composio.authConfigs.create("NOTION", {- name: "Notion",- type: "use_custom_auth",- credentials: {- client_id: "1234567890",- client_secret: "1234567890",- oauth_redirect_uri: "https://backend.composio.dev/api/v3/toolkits/auth/callback",- },- authScheme: "OAUTH2",-});--console.log(authConfig);-```-</CodeGroup>--<Note>-You can specify a custom redirect URI by including the `oauth_redirect_uri` parameter in the credentials object. If not provided, Composio uses the default redirect URI.-</Note>--**Specifying the authorized redirect URI**-The process of setting up your own OAuth2 credentials usually involves generating a client ID and secret and specifying the **authorized redirect URI** in the OAuth configuration.--<Tip>-The **authorized redirect URI** is the URI that captures the OAuth code that is returned to the app.-</Tip>--While doing so, you must ensure to set the **authorized redirect URI** in the OAuth configuration to:--```-https://backend.composio.dev/api/v3/toolkits/auth/callback-```-<Tabs>-<Tab title="Redirect URI for GitHub">-<Frame>-<img src="../../../assets/images/github-callback.png" alt="Developer settings for GitHub OAuth2 app"/>-</Frame>-</Tab>-<Tab title="Redirect URI for Google">-<Frame>-<img src="../../../assets/images/google-callback.png" alt="Developer settings for Google OAuth2 app"/>-</Frame>-</Tab>-</Tabs>--### Specifying scopes-Composio requests a set of appropriate default OAuth2 scopes for each toolkit wherever possible. However, you can override or modify these scopes by passing a `scopes` field to the `credentials` object.--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/define-scopes.py"- title="Python"- startLine={1}- endLine={17}- highlightStart={11}- highlightEnd={13}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/define-scopes.ts"- title="TypeScript"- startLine={1}- endLine={17}- highlightStart={8}- highlightEnd={10}-/>-</CodeGroup>---## Other auth types-Composio supports many applications that use different authentication types like API keys, Bearer tokens, JWT and even no authentication at all.--Generating the auth config for other auth types only has minor differences.-- `use_custom_auth` is used instead of `use_composio_managed_auth`-- The `credentials` field is used to pass the authentication details-- The `authScheme` field is used to specify the auth type--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/auth-config.py"- title="Python"- startLine={5}- endLine={17}-/>-<SnippetCode- src="fern/snippets/authentication/typescript/auth-config.ts"- title="TypeScript"- startLine={5}- endLine={17}-/>-</CodeGroup>--## Programmatically inspecting fields-In cases where you need to dynamically discover the exact field names and handle different auth schemes programmatically, you can inspect the auth config details first.--This works for all auth types.--<CodeGroup>-```python Python maxLines=60 wordWrap-required_fields = composio.toolkits.get_auth_config_creation_fields(- toolkit="NOTION",- auth_scheme="OAUTH2",- required_only=True,-)-print(required_fields)-```-```typescript TypeScript maxLines=60-const toolkits = await composio.toolkits.get("NOTION");--// Extract field names from authConfigDetails-const authFields = await composio.toolkits.getAuthConfigCreationFields('NOTION', 'OAUTH2', {- requiredOnly: true,-});--console.log("Required auth config fields:", authFields);-```-</CodeGroup>--and then inspect the required fields and specify them in the `credentials` object.\ No newline at end of filediff --git a/fern/pages/src/authentication/user-management.mdx b/fern/pages/src/authentication/user-management.mdxdeleted file mode 100644index 7adf37310..000000000--- a/fern/pages/src/authentication/user-management.mdx+++ /dev/null@@ -1,316 +0,0 @@-----title: "User Management"-image: "https://og.composio.dev/api/og?title=User%20Management" # image for socials-keywords: "user management, user Id, user context, external user ID"-subtitle: "Manage users and their connected accounts"-hide-nav-links: false------## What are User IDs?-User IDs determine whose connected accounts and data you're accessing in Composio. Every tool execution, connection authorization, and account operation-requires a `userId` parameter that identifies which context to use.--User IDs act as containers that group connected accounts together across toolkits. Depending on your application, you can use User IDs to represent an-individual user, a team, or an entire organization.--## Quick Decision Guide--**How do users access connected accounts in your app?**--- **Each user connects their own personal accounts?**-Use User IDs-*Use your database UUID or primary key (e.g., `user.id`)*-*Example: Users connect their personal Gmail, GitHub*--- **Teams share the same connected accounts?**-Use Organization IDs-*Use your organization UUID or primary key (e.g., `organization.id`)*-*Example: Company Slack workspace*--## Patterns--### User IDs (Individual Accounts)--In production applications with multiple users, where each user connects and manages their own accounts.--**Choosing User IDs:**--- Recommended: Database UUID or primary key (`user.id`)-- Acceptable: Unique username (`user.username`)-- Avoid: Email addresses (emails can change)--<CodeGroup>-```typescript Typescript-// Use your database's user ID (UUID, primary key, etc.)-const userId = user.id; // e.g., "550e8400-e29b-41d4-a716-446655440000"--const tools = await composio.tools.get(userId, {- toolkits: ['github'],-});--const result = await composio.tools.execute('GITHUB_GET_REPO', {- userId: userId,- arguments: { owner: 'example', repo: 'repo' },-});-```--```python Python-# Use your database's user ID (UUID, primary key, etc.)-user_id = user.id; # e.g., "550e8400-e29b-41d4-a716-446655440000"--tools = composio.tools.get(- user_id=user_id,- toolkits=["GITHUB"],-)--result = composio.tools.execute(- "GITHUB_GET_REPO",- user_id=user_id,- arguments={- "owner": 'example',- "repo": 'repo'- }-)-```--</CodeGroup>-<Warning>-Never use 'default' as an User ID in production with users. This could expose other users' data-</Warning>--### Organization IDs (Team Accounts)--For applications where teams share connections - one admin connects accounts, all team members use them.--**When to use:**-- Team tools: Slack, Microsoft Teams, Jira-- Shared accounts: support(at)company.com, company GitHub org-- Enterprise apps: IT manages connections for all employees--<CodeGroup>-```typescript TypeScript-// Use the organization ID as userId-const userId = organization.id; // e.g., "org_550e8400"--// All users in the organization share the same connected accounts-const tools = await composio.tools.get(userId, {- toolkits: ['slack'],-});--// Execute tools in the organization context-const result = await composio.tools.execute('SLACK_SEND_MESSAGE', {- userId: userId,- arguments: {- channel: '#general',- text: 'Hello from the team!',- },-});-```-```python Python-# Use the organization ID as userId-user_id = organization.id # e.g., "org_550e8400"--# All users in the organization share the same connected accounts-tools = composio.tools.get(- user_id=user_id,- toolkits=["SLACK"],-)--# Execute tools in the organization context-result = composio.tools.execute(- "SLACK_SEND_MESSAGE",- user_id=user_id,- arguments={- "channel": '#general',- "text": 'Hello from the team!'- }-)-```-</CodeGroup>--## Multiple Connected Accounts--A single User ID can have multiple connected accounts for the same toolkit. For example, a user might connect both their personal and work Gmail accounts.--**Key concepts:**-- Each connected account gets a unique Connected Account ID-- Multiple accounts can exist under the same User ID for any toolkit-- You can specify which account to use when executing tools--**Account selection:**-- **Explicit:** Specify the Connected Account ID to target a specific account-- **Default:** If no Connected Account ID is provided, the most recently connected account is used--## Examples-### Organization-Based Application--In B2B applications, typically an admin connects accounts once and all team members share access. Here's a complete implementation:--**Key concepts:**-- Admin performs the OAuth connection using organization ID-- All team members execute tools using the same organization ID-- Permission checks ensure users can only access their organization's connections-```typescript TypeScript-import { Composio } from '@composio/core';-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});--// 1. Admin connects Slack for the entire organization-async function connectOrganizationToSlack(organizationId: string, adminUserId: string) {- // Use organization ID as userId in Composio- const connectionRequest = await composio.toolkits.authorize(organizationId, 'slack');-- // Store the connection request for the admin to complete- await storeConnectionRequest(organizationId, adminUserId, connectionRequest);-- return connectionRequest.redirectUrl;-}--// 2. Any user in the organization can use the connected tools-async function sendSlackMessage(organizationId: string, channel: string, message: string) {- return await composio.tools.execute('SLACK_SEND_MESSAGE', {- userId: organizationId, // organization ID, not individual user ID- arguments: {- channel: channel,- text: message,- },- });-}--// 3. Check if organization has required connections-async function getOrganizationTools(organizationId: string) {- return await composio.tools.get(organizationId, {- toolkits: ['slack', 'github', 'jira'],- });-}--// Usage in your API endpoint-app.post('/api/slack/message', async (req, res) => {- const { channel, message } = req.body;- const organizationId = req.user.organizationId; // Get from your auth system-- // Verify user has permission to send messages for this organization- // The userCanSendMessages function is your responsibility - implement it based on your application's permission model (role-based, feature flags, etc.).- if (!(await userCanSendMessages(req.user.id, organizationId))) {- return res.status(403).json({ error: 'Insufficient permissions' });- }-- try {- const result = await sendSlackMessage(organizationId, channel, message);- res.json(result.data);- } catch (error) {- res.status(500).json({ error: 'Failed to send message' });- }-});-```---### Multi-User Application--In B2C applications, each user connects and manages their own accounts. Every user goes through their own OAuth flow and their data remains completely isolated.--**Key concepts:**-- Each user authorizes their own accounts using their unique user ID-- Connections are isolated - users can only access their own connected accounts-- No permission checks needed since users only access their own data--```typescript TypeScript-import { Composio } from '@composio/core';-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});--// 1. User initiates GitHub connection-async function connectUserToGitHub(userId: string) {- const connectionRequest = await composio.toolkits.authorize(userId, 'github');- return connectionRequest.redirectUrl;-}--// 2. Get user's connected GitHub tools-async function getUserGitHubTools(userId: string) {- return await composio.tools.get(userId, {- toolkits: ['github'],- });-}--// 3. Execute tool for specific user-async function getUserRepos(userId: string) {- return await composio.tools.execute('GITHUB_LIST_REPOS', {- userId: userId,- arguments: {- per_page: 10,- },- });-}--// Usage in your API endpoint-app.get('/api/github/repos', async (req, res) => {- const userId = req.user.id; // Get from your auth system-- try {- const repos = await getUserRepos(userId);- res.json(repos.data);- } catch (error) {- res.status(500).json({ error: 'Failed to fetch repos' });- }-});-```--**Data isolation**: Composio ensures each userId's connections and data are completely separate. User A can never access User B's repositories.--### Hybrid Pattern--Many applications need both personal and team resources. Users might connect their personal Gmail while sharing the company Slack workspace.--**Common scenarios:**-- Personal calendars + shared project management-- Individual GitHub accounts + organization repositories--<CodeGroup>-```typescript TypeScript-// ❌ Wrong: Using individual user ID for org-connected tool-const userTools = await composio.tools.get(req.user.id, {- toolkits: ['slack'], // Fails - Slack is connected at org level-});--// ✅ Correct: Match the ID type to how the tool was connected-const userPersonalTools = await composio.tools.get(req.user.id, {- toolkits: ['gmail'], // User's personal Gmail-});--const orgSharedTools = await composio.tools.get(req.user.organizationId, {- toolkits: ['slack', 'jira'], // Organization's shared tools-});-```-```python Python-# ❌ Wrong: Using individual user ID for org-connected tool-user_tools = composio.tools.get(- user_id="user_123", # Individual user ID- toolkits=["slack"] # Fails - Slack is connected at org level-)--# ✅ Correct: Match the ID type to how the tool was connected-user_personal_tools = composio.tools.get(- user_id="user_123", # Individual user ID- toolkits=["gmail"] # User's personal Gmail-)--org_shared_tools = composio.tools.get(- user_id="org_123", # Organization ID- toolkits=["slack", "jira"] # Organization's shared tools-)-```-</CodeGroup>-Remember: The userId must match how the account was connected. If admin connected Slack with org ID, all members must use org ID to access it.--## Best Practices--**Your responsibilities:**-- Pass the correct User ID for each user-- Verify user permissions before executing organization tools-- Never use 'default' in production with multiple users-- Keep User IDs consistent across your application and Composio-- Use stable identifiers that won't change over time--**Data isolation:** Composio ensures complete isolation between User IDs. Users cannot access another ID's connections or data.\ No newline at end of filediff --git a/fern/pages/src/capabilities/managed-authentication.mdx b/fern/pages/src/capabilities/managed-authentication.mdxdeleted file mode 100644index 52aa0f0e6..000000000--- a/fern/pages/src/capabilities/managed-authentication.mdx+++ /dev/null@@ -1,39 +0,0 @@-----title: Managed Authentication-image: "https://og.composio.dev/api/og?title=Managed%20Authentication&description=Enterprise-grade%20authentication%20for%20AI%20agents"-subtitle: "Auth management for your AI agents"-description: "Let your AI agents authenticate with 500+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."-keywords: "managed authentication, ai agent auth, oauth, api keys, user isolation, white-labeling, connected accounts"-hide-nav-links: false------Composio handles OAuth flows, API keys, token refresh, and credential storage for 500+ apps.--## Quick links--<CardGroup cols={3}>- <Card- title="Authenticating tools"- icon="fa-light fa-key"- href="/docs/authenticating-tools"- >- Create auth configs and connect user accounts via Connect Link or direct SDK integration- </Card>-- <Card- title="White-labeling"- icon="fa-light fa-palette"- href="/docs/custom-auth-configs"- >- Use your own OAuth apps and remove Composio branding from auth screens- </Card>-- <Card- title="Connected Accounts API"- icon="fa-light fa-plug"- href="/api-reference/connected-accounts"- >- Manage user connections programmatically- </Card>--</CardGroup>diff --git a/fern/pages/src/capabilities/mcp.mdx b/fern/pages/src/capabilities/mcp.mdxdeleted file mode 100644index cbc954f3a..000000000--- a/fern/pages/src/capabilities/mcp.mdx+++ /dev/null@@ -1,45 +0,0 @@-----title: MCP (Model Context Protocol)-image: "https://og.composio.dev/api/og?title=MCP&description=Universal%20tool%20protocol%20for%20any%20AI%20client"-subtitle: "Universal tool protocol for any AI client"-description: "Connect 500+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."-keywords: "mcp, model context protocol, claude desktop, continue dev, ai tools, framework agnostic, tool server"-hide-nav-links: false------Connect Composio tools to Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Configure once, use everywhere.--<CardGroup cols={2}>- <Card- title="MCP quickstart"- icon="fa-light fa-rocket"- href="/mcp/quickstart"- >- Set up MCP with Claude Desktop or other clients- </Card>-- <Card- title="Server management"- icon="fa-light fa-server"- href="/mcp/server-management"- >- Configure toolkits, authentication, and permissions- </Card>-- <Card- title="MCP providers"- icon="fa-light fa-plug"- href="/mcp/providers"- >- Integration guides for Claude Desktop, Cursor, Windsurf- </Card>-- <Card- title="Tool Router"- icon="fa-light fa-route"- href="/tool-router/overview"- >- Single MCP server and Tool that can search, authenticate, and execute across all Composio tools- </Card>-</CardGroup>-diff --git a/fern/pages/src/capabilities/tools.mdx b/fern/pages/src/capabilities/tools.mdxdeleted file mode 100644index 5858a2b4c..000000000--- a/fern/pages/src/capabilities/tools.mdx+++ /dev/null@@ -1,45 +0,0 @@-----title: Tools-image: "https://og.composio.dev/api/og?title=Tools&description=500%2B%20authenticated%20actions%20for%20AI%20agents"-subtitle: "500+ authenticated actions for AI agents"-description: "Give your AI agents the ability to execute real-world actions across 500+ integrations. From GitHub commits to Slack messages—all with user authentication built in."-keywords: "ai tools, agent tools, authenticated actions, tool calling, github actions, slack integration, gmail api"-hide-nav-links: false------Pre-built tools for GitHub, Slack, Gmail, and 500+ other services. Each tool handles authentication, error handling, and returns structured JSON responses.--<CardGroup cols={2}>- <Card- title="Fetching tools"- icon="fa-light fa-download"- href="/docs/fetching-tools"- >- Retrieve and filter tools by toolkit, tags, or specific tool names- </Card>-- <Card- title="Executing tools"- icon="fa-light fa-play"- href="/docs/executing-tools"- >- Execute tools and handle responses in your application- </Card>-- <Card- title="Custom tools"- icon="fa-light fa-hammer"- href="/docs/custom-tools"- >- Build your own tools for proprietary systems and APIs- </Card>-- <Card- title="Tool Router"- icon="fa-light fa-route"- href="/tool-router/overview"- >- Single MCP server and Tool that can search, authenticate, and execute across all Composio tools- </Card>-</CardGroup>-diff --git a/fern/pages/src/capabilities/triggers.mdx b/fern/pages/src/capabilities/triggers.mdxdeleted file mode 100644index e13ad071a..000000000--- a/fern/pages/src/capabilities/triggers.mdx+++ /dev/null@@ -1,29 +0,0 @@-----title: Triggers-image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20500%2B%20integrations"-subtitle: "Real-time events from 500+ integrations"-description: "React to events as they happen across your connected services. From GitHub commits to Slack messages—build event-driven AI workflows with zero webhook infrastructure."-keywords: "webhooks, triggers, real-time events, event-driven, github webhooks, slack events, automation"-hide-nav-links: false------Subscribe to real-time events from GitHub, Slack, Gmail, and other services. Composio handles webhook configuration, retries, and delivery.--<CardGroup cols={2}>- <Card- title="Using triggers"- icon="fa-light fa-bolt"- href="/docs/using-triggers"- >- Subscribe to events and handle them in your application- </Card>-- <Card- title="Slack summarizer example"- icon="fa-light fa-diagram-project"- href="/examples/slack-summariser"- >- Event-driven workflow example- </Card>-</CardGroup>-diff --git a/fern/pages/src/changelog/01-07-26.md b/fern/pages/src/changelog/01-07-26.mddeleted file mode 100644index a8f6438f7..000000000--- a/fern/pages/src/changelog/01-07-26.md+++ /dev/null@@ -1,171 +0,0 @@-# Consistent Error Response Structure--Tool execution errors now return a standardized response format across all failure types. Previously, the `data` field was empty on errors—now it always includes `status_code` and `message`, matching the structure of successful responses.--## What Changed--All error responses from tool execution now include:-- `data.status_code`: HTTP status code (or `null` for non-HTTP errors)-- `data.message`: Detailed error message-- `error`: Same detailed message at the top level--## Before vs After--**Previous error response:**-```json-{- "data": {},- "successfull": false,- "error": "404 Client Error: Not Found for url: ...",-}-```--**New error response:**-```json-{- "data": {- "http_error": "404 Client Error: Not Found for url: ...",- "status_code": 404,- "message": "Resource not found: The requested item does not exist"- },- "successfull": false,- "error": "Resource not found: The requested item does not exist",-}-```--## Why This Matters--- **Easier parsing**: Agents and code can reliably access error details from `data.message` without special-casing empty `data` objects-- **Better debugging**: Detailed error messages replace generic HTTP error strings-- **Consistent schema**: Same response shape whether the tool succeeds or fails-------# Union Types Preserved in Tool Schemas--Tool schemas now use standard JSON Schema `anyOf` for union types, providing accurate type information for LLMs and code generators.--## What Changed--Two changes affect how types appear in request/response schemas:--| Change | Scope | Description |-|--------|-------|-------------|-| **Nullable fields** | **All toolkits** | Fields that accept `null` now use `anyOf: [{type}, {type: "null"}]` instead of `type` + `nullable: true` |-| **Multi-type fields** | 157 toolkits | Fields accepting multiple value types (e.g., `string \| number`) preserve the full `anyOf` array instead of flattening to the first type |--<Accordion title="Toolkits with multi-type union fields (157 total)">--### CRM & Sales-active_campaign, apollo, attio, autobound, capsule_crm, firmao, forcemanager, gong, hubspot, instantly, intercom, kommo, leadfeeder, lever, magnetic, pipedrive, pipeline_crm, salesforce, salesforce_service_cloud, zoominfo--### Marketing & Email-active_trail, beamer, delighted, dripcel, enginemailer, mailerlite, moosend, mopinion, sendspark, toneden--### Communication & Collaboration-chmeetings, discord, helpdesk, helpwise, missive, slack, textit--### Productivity & Project Management-basecamp, clicksend, clientary, dart, fibery, monday, notion, onedesk, productboard, rocketlane, todoist--### Developer Tools & APIs-algolia, anonyflow, api_ninjas, api_sports, apify, appdrag, backendless, browserless, bubble, cloudconvert, cloudinary, cloudlayer, convertapi, databricks, datadog, datarobot, deepseek, deployhq, digital_ocean, docmosis, docugenerate, encodian, gitea, gitlab, globalping, groqcloud, hookdeck, hyperbrowser, imgbb, imgix, kibana, neutrino, npm, openai, openrouter, parsera, parseur, phantombuster, pinecone, prismic, procfu, replicate, scrape_do, serpapi, shotstack, snowflake, supabase, tavily, v0, vercel, writer, zenrows--### E-commerce & Payments-brex, btcpay_server, coupa, flutterwave, gift_up, lemon_squeezy, quaderno, ramp, shopify, stripe, zoho_invoice--### HR & Recruiting-ashby, bamboohr, recruitee--### Data & Analytics-amplitude, census_bureau, college_football_data, currencyscoop, diffbot, ip2location, mixpanel, nasa, rosette_text_analytics, securitytrails, textrazor, twelve_data--### Documents & Files-carbone, doc_certs, documenso, dropbox, excel, files_com, grist, pdf_co, share_point--### Design & Media-canva, canvas, claid_ai, deepimage, heygen, metatextai--### Customer Support-freshdesk, retently, servicem8, sevdesk, storeganise--### Calendar & Scheduling-calendly, deadline_funnel, etermin, googlecalendar--### Social Media-facebook, instagram, reddit--### Location & Maps-addresszen, geoapify, google_maps, mapbox--### Email Verification & Validation-clearout, icypeas, neverbounce, zerobounce--### Other Integrations-bitwarden, canny, cardly, castingwords, confluence, formdesk, getform, habitica, headout, highergov, jira, keen_io, landbot, moonclerk, one_drive, outlook, googlesheets, resend, ritekit, sms_alert, tapfiliate, thanks_io, uptimerobot--</Accordion>--## Before vs After-For example, the `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` request schema changes:-**Previous (only a single type):**-```json-{- "timezone": {- "default": 0,- "description": "Timezone specification...",- "title": "Timezone",- "type": "string"- }-}-```--**Now (Union types preserved):**-```json-{- "timezone": {- "anyOf": [- { "type": "string" },- { "type": "number" }- ],- "default": 0,- "description": "Timezone specification...",- "title": "Timezone"- }-}-```--Similarly, nullable fields like `page_token` in `GOOGLECALENDAR_LIST_CALENDARS`:--**Previous:**-```json-{- "page_token": {- "default": null,- "description": "Token for the page of results to return...",- "nullable": true,- "title": "Page Token",- "type": "string"- }-}-```--**Now:**-```json-{- "page_token": {- "anyOf": [- { "type": "string" },- { "type": "null" }- ],- "default": null,- "description": "Token for the page of results to return...",- "title": "Page Token"- }-}-```--## Why This Matters--- **Accurate schemas**: LLMs and code generators see the full set of allowed types-- **Better validation**: Input validation can now correctly accept all valid types, not just the first one\ No newline at end of filediff --git a/fern/pages/src/changelog/01-08-26-mcp-api-key-enforcement.md b/fern/pages/src/changelog/01-08-26-mcp-api-key-enforcement.mddeleted file mode 100644index 26d049c5a..000000000--- a/fern/pages/src/changelog/01-08-26-mcp-api-key-enforcement.md+++ /dev/null@@ -1,144 +0,0 @@-# Optional API Key Enforcement for MCP Servers--We've introduced a new project-level security setting that allows you to require API key authentication for all MCP server requests. This opt-in feature gives you fine-grained control over who can access your MCP endpoints.--<Note>-**Opt-in today, default soon**: This feature is currently opt-in. Starting **March 1, 2026**, it will be enabled by default for new organizations. We recommend enabling it now to prepare your integrations.-</Note>--## What's New--A new **"Require API Key for MCP"** toggle is now available in your Project Settings. When enabled, all requests to your MCP servers must include a valid Composio API key in the request headers.--| Setting | Default | Impact |-|---------|---------|--------|-| `require_mcp_api_key` | `false` | Opt-in; no changes to existing behavior |--## How It Works--When the setting is **disabled** (default):-- MCP servers work without API key authentication-- Existing integrations continue to function unchanged--When the setting is **enabled**:-- All MCP requests must include the `x-api-key` header with a valid Composio API key-- Requests without a valid API key receive `401 Unauthorized`-- Only API keys belonging to the same project are accepted--### Request Examples--**Without API key (when enforcement is enabled):**-```bash-curl -X POST "https://mcp.composio.dev/{your_mcp_server_url}" \- -H "Content-Type: application/json" \- -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'--# Response: 401 Unauthorized-```--**With API key:**-```bash-curl -X POST "https://mcp.composio.dev/{your_mcp_server_url}" \- -H "Content-Type: application/json" \- -H "x-api-key: ak_your_api_key" \- -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'--# Response: 200 OK-```--## Enabling the Setting--### Via Dashboard--1. Navigate to [Project Settings](https://platform.composio.dev/{workspace}/{project}/settings)-2. Go to the **Project Configuration** tab-3. Find the **"Require API Key for MCP"** toggle-4. Enable the toggle--<Frame>- <img src="/assets/images/mcp-api-key-toggle.png" alt="MCP API Key Toggle in Project Settings" />-</Frame>--### Via API--Update your project configuration using the API:--```bash-curl -X PATCH "https://backend.composio.dev/api/v3/org/project/config" \- -H "Content-Type: application/json" \- -H "x-api-key: ak_your_api_key" \- -d '{"require_mcp_api_key": true}'-```--**Response:**-```json-{- "require_mcp_api_key": true,- "is_2FA_enabled": true,- "mask_secret_keys_in_connected_account": true,- "log_visibility_setting": "show_all"-}-```--### Via Code--<CodeGroup>-```python title="Python"-import requests--response = requests.patch(- "https://backend.composio.dev/api/v3/org/project/config",- headers={- "Content-Type": "application/json",- "x-api-key": "ak_your_api_key"- },- json={"require_mcp_api_key": True}-)--print(response.json())-```-```typescript title="TypeScript"-const response = await fetch(- "https://backend.composio.dev/api/v3/org/project/config",- {- method: "PATCH",- headers: {- "Content-Type": "application/json",- "x-api-key": "ak_your_api_key"- },- body: JSON.stringify({ require_mcp_api_key: true })- }-);--console.log(await response.json());-```-</CodeGroup>--## When to Use This--Enable API key enforcement when you need to:--- **Prevent unauthorized access** to your MCP servers-- **Control which applications** can interact with your MCP endpoints-- **Add an extra security layer** for production deployments-- **Audit and track** MCP server usage through API key attribution--## API Reference--### Get Current Setting--```http-GET /api/v3/org/project/config-```--### Update Setting--```http-PATCH /api/v3/org/project/config-```--```json-{- "require_mcp_api_key": true-}-```diff --git a/fern/pages/src/changelog/01-09-26.md b/fern/pages/src/changelog/01-09-26.mddeleted file mode 100644index 5c6699804..000000000--- a/fern/pages/src/changelog/01-09-26.md+++ /dev/null@@ -1,204 +0,0 @@-# Tool Enum Name Shortening--Shortened tool enum names across 181 actions to ensure compatibility with all AI agent frameworks.--## Why This Change?--Some agent frameworks have a **64-character limit** on tool/function names. Several tool enums exceeded this limit, causing compatibility issues.--## No Action Required--**This change will not break your integration if you are using `latest` toolkit versions** or fetching tools dynamically. The SDK automatically resolves the correct tool names.--<details>-<summary><strong>View All Enum Changes (181 tools)</strong></summary>--| Old Enum | New Enum |-|----------|----------|-| `ACTIVE_TRAIL_GET_ACCOUNT_INTEGRATIONDATA_ACTIVECOMMERCE` | `ACTIVE_TRAIL_GET_ACCOUNT_INTEGRATIONDATA` |-| `ACTIVE_TRAIL_GET_AUTOMATION_REPORTS_SMS_CAMPAIGN_SUMMARY_REPORT` | `ACTIVE_TRAIL_GET_AUTOMATION_REPORTS_SMS_CAMPAIGN_SUMMARY` |-| `BIG_DATA_CLOUD_REVERSE_GEOCODING_WITH_TIMEZONE_API` | `BIG_DATA_CLOUD_REVERSE_GEOCODING_TIMEZONE_API` |-| `CLICKSEND_RECHARGE_TRANSACTIONS_BY_TRANSACTION_ID_GET` | `CLICKSEND_RECHARGE_TXNS_BY_TXN_ID_GET` |-| `CODEMAGIC_API_V3_VARIABLE_GROUPS_VARIABLE_GROUP_ID_UPDATE_GROUP` | `CODEMAGIC_API_V3_VARIABLE_GROUPS_VARIABLE_GROUP_ID_UPDATE` |-| `COUPA_GET_ALL_FUNDS_TRANSFERS_IN_A_SPECIFIC_PAYMENT_BATCH_BY_PAYMENT_BATCH_ID` | `COUPA_GET_ALL_FUNDS_TRANSFERS_SPECIFIC_PAYMENT_BATCH` |-| `COUPA_GET_PO_CONFIRMATION_IN_CANCELLED_STATUS_AND_NOT_EXPORTED` | `COUPA_GET_PO_CONFIRMATION_CANCELLED_STATUS_NOT_EXPORTED` |-| `DATABRICKS_CATALOG_CREDENTIALS_GENERATE_TEMPORARY_SERVICE_CREDENTIAL` | `DATABRICKS_CATALOG_CREDS_GENERATE_TEMP_SERVICE_CRED` |-| `DATABRICKS_CATALOG_CREDENTIALS_VALIDATE_CREDENTIAL` | `DATABRICKS_CATALOG_CREDS_VALIDATE_CRED` |-| `DATABRICKS_CATALOG_EXTERNAL_METADATA_UPDATE_EXTERNAL_METADATA` | `DATABRICKS_CATALOG_EXTERNAL_METADATA_UPDATE_EXTERNAL` |-| `DATABRICKS_CATALOG_RFA_GET_ACCESS_REQUEST_DESTINATIONS` | `DATABRICKS_CATALOG_RFA_GET_ACCESS_REQUEST_DESTS` |-| `DATABRICKS_CATALOG_RFA_UPDATE_ACCESS_REQUEST_DESTINATIONS` | `DATABRICKS_CATALOG_RFA_UPDATE_ACCESS_REQUEST_DESTS` |-| `DATABRICKS_CATALOG_TEMPORARY_PATH_CREDENTIALS_GENERATE_TEMPORARY_PATH_CREDENTIALS` | `DATABRICKS_CATALOG_TEMP_PATH_CREDS_GENERATE_TEMP_PATH_CREDS` |-| `DATABRICKS_COMPUTE_CLUSTER_POLICIES_GET_PERMISSION_LEVELS` | `DATABRICKS_COMPUTE_CLUSTER_POLICIES_GET_PERM_LEVELS` |-| `DATABRICKS_COMPUTE_CLUSTER_POLICIES_GET_PERMISSIONS` | `DATABRICKS_COMPUTE_CLUSTER_POLICIES_GET_PERMS` |-| `DATABRICKS_COMPUTE_CLUSTER_POLICIES_SET_PERMISSIONS` | `DATABRICKS_COMPUTE_CLUSTER_POLICIES_SET_PERMS` |-| `DATABRICKS_COMPUTE_CLUSTER_POLICIES_UPDATE_PERMISSIONS` | `DATABRICKS_COMPUTE_CLUSTER_POLICIES_UPDATE_PERMS` |-| `DATABRICKS_COMPUTE_INSTANCE_POOLS_GET_PERMISSION_LEVELS` | `DATABRICKS_COMPUTE_INSTANCE_POOLS_GET_PERM_LEVELS` |-| `DATABRICKS_COMPUTE_INSTANCE_POOLS_UPDATE_PERMISSIONS` | `DATABRICKS_COMPUTE_INSTANCE_POOLS_UPDATE_PERMS` |-| `DATABRICKS_COMPUTE_POLICY_COMPLIANCE_FOR_CLUSTERS_ENFORCE_COMPLIANCE` | `DATABRICKS_COMPUTE_POLICY_COMPL_FOR_CLUSTERS_ENFORCE_COMPL` |-| `DATABRICKS_COMPUTE_POLICY_COMPLIANCE_FOR_CLUSTERS_GET_COMPLIANCE` | `DATABRICKS_COMPUTE_POLICY_COMPL_FOR_CLUSTERS_GET_COMPL` |-| `DATABRICKS_DASHBOARDS_GENIE_DELETE_CONVERSATION_MESSAGE` | `DATABRICKS_DASHBOARDS_GENIE_DELETE_CONV_MESSAGE` |-| `DATABRICKS_DASHBOARDS_GENIE_EXECUTE_MESSAGE_ATTACHMENT_QUERY` | `DATABRICKS_DASHBOARDS_GENIE_EXECUTE_MESSAGE_ATTACH_QUERY` |-| `DATABRICKS_DASHBOARDS_GENIE_GET_MESSAGE_ATTACHMENT_QUERY_RESULT` | `DATABRICKS_DASHBOARDS_GENIE_GET_MESSAGE_ATTACH_QUERY_RESULT` |-| `DATABRICKS_DASHBOARDS_GENIE_GET_MESSAGE_QUERY_RESULT_BY_ATTACHMENT` | `DATABRICKS_DASHBOARDS_GENIE_GET_MESSAGE_QUERY_RESULT_ATTACH` |-| `DATABRICKS_DASHBOARDS_GENIE_LIST_CONVERSATION_MESSAGES` | `DATABRICKS_DASHBOARDS_GENIE_LIST_CONV_MESSAGES` |-| `DATABRICKS_DASHBOARDS_LAKEVIEW_EMBEDDED_GET_PUBLISHED_DASHBOARD_TOKEN_INFO` | `DATABRICKS_DASHBOARDS_LAKEVIEW_EMBEDDED_GET_PUBLISHED_DASH` |-| `DATABRICKS_DATABASE_DATABASE_GENERATE_DATABASE_CREDENTIAL` | `DATABRICKS_DATABASE_DATABASE_GENERATE_DATABASE_CRED` |-| `DATABRICKS_IAM_PERMISSION_MIGRATION_MIGRATE_PERMISSIONS` | `DATABRICKS_IAM_PERM_MIGRATION_MIGRATE_PERMS` |-| `DATABRICKS_IAMV2_WORKSPACE_IAM_V2_GET_WORKSPACE_ACCESS_DETAIL_LOCAL` | `DATABRICKS_IAMV2_WORKSPACE_IAM_V2_GET_WORKSPACE_ACCESS` |-| `DATABRICKS_JOB_PERMISSION_LEVELS_GETPERMISSIONLEVELS` | `DATABRICKS_JOB_PERM_LEVELS_GETPERMISSIONLEVELS` |-| `DATABRICKS_JOBS_POLICY_COMPLIANCE_FOR_JOBS_GET_COMPLIANCE` | `DATABRICKS_JOBS_POLICY_COMPL_FOR_JOBS_GET_COMPL` |-| `DATABRICKS_MARKETPLACE_CONSUMER_INSTALLATIONS_CREATE` | `DATABRICKS_MKTPLACE_CONSUMER_INSTALLATIONS_CREATE` |-| `DATABRICKS_MARKETPLACE_CONSUMER_INSTALLATIONS_DELETE` | `DATABRICKS_MKTPLACE_CONSUMER_INSTALLATIONS_DELETE` |-| `DATABRICKS_MARKETPLACE_CONSUMER_INSTALLATIONS_UPDATE` | `DATABRICKS_MKTPLACE_CONSUMER_INSTALLATIONS_UPDATE` |-| `DATABRICKS_MARKETPLACE_CONSUMER_LISTINGS_BATCH_GET` | `DATABRICKS_MKTPLACE_CONSUMER_LISTINGS_BATCH_GET` |-| `DATABRICKS_MARKETPLACE_CONSUMER_PERSONALIZATION_REQUESTS_GET` | `DATABRICKS_MKTPLACE_CONSUMER_PERSONALIZATION_REQUESTS_GET` |-| `DATABRICKS_MARKETPLACE_CONSUMER_PROVIDERS_BATCH_GET` | `DATABRICKS_MKTPLACE_CONSUMER_PROVIDERS_BATCH_GET` |-| `DATABRICKS_MARKETPLACE_PROVIDER_EXCHANGES_DELETE_LISTING_FROM_EXCHANGE` | `DATABRICKS_MKTPLACE_PROVIDER_EXCHANGES_DELETE_LISTING` |-| `DATABRICKS_MARKETPLACE_PROVIDER_PROVIDER_ANALYTICS_DASHBOARDS_CREATE` | `DATABRICKS_MKTPLACE_PROVIDER_ANALYTICS_DASHBOARDS_CREATE` |-| `DATABRICKS_MARKETPLACE_PROVIDER_PROVIDER_ANALYTICS_DASHBOARDS_GET` | `DATABRICKS_MKTPLACE_PROVIDER_ANALYTICS_DASHBOARDS_GET` |-| `DATABRICKS_MARKETPLACE_PROVIDER_PROVIDER_ANALYTICS_DASHBOARDS_GET_LATEST_VERSION` | `DATABRICKS_MKTPLACE_PROVIDER_ANALYTICS_DASH_GET_LATEST` |-| `DATABRICKS_ML_FEATURE_ENGINEERING_DELETE_KAFKA_CONFIG` | `DATABRICKS_ML_FEATURE_ENG_DELETE_KAFKA_CONFIG` |-| `DATABRICKS_ML_MATERIALIZED_FEATURES_DELETE_FEATURE_TAG` | `DATABRICKS_ML_MAT_FEATURES_DELETE_FEATURE_TAG` |-| `DATABRICKS_ML_MATERIALIZED_FEATURES_GET_FEATURE_TAG` | `DATABRICKS_ML_MAT_FEATURES_GET_FEATURE_TAG` |-| `DATABRICKS_ML_MATERIALIZED_FEATURES_UPDATE_FEATURE_TAG` | `DATABRICKS_ML_MAT_FEATURES_UPDATE_FEATURE_TAG` |-| `DATABRICKS_ML_MODEL_REGISTRY_GET_PERMISSION_LEVELS` | `DATABRICKS_ML_MODEL_REGISTRY_GET_PERM_LEVELS` |-| `DATABRICKS_PIPELINES_PIPELINES_GET_PERMISSION_LEVELS` | `DATABRICKS_PIPELINES_PIPELINES_GET_PERM_LEVELS` |-| `DATABRICKS_QUALITYMONITORV2_QUALITY_MONITOR_V2_CREATE_QUALITY_MONITOR` | `DATABRICKS_QUALITYMONITORV2_QUALITY_MONITOR_V2_CREATE` |-| `DATABRICKS_SERVING_SERVING_ENDPOINTS_CREATE_PROVISIONED_THROUGHPUT_ENDPOINT` | `DATABRICKS_SERVING_SERVING_ENDPOINTS_CREATE_PROV_THPUT` |-| `DATABRICKS_SERVING_SERVING_ENDPOINTS_GET_PERMISSION_LEVELS` | `DATABRICKS_SERVING_SERVING_ENDPOINTS_GET_PERM_LEVELS` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_ACCESS_POLICY_DELETE` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_ACCESS_POLICY_DELETE` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_ACCESS_POLICY_GET` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_ACCESS_POLICY_GET` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_ACCESS_POLICY_UPDATE` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_ACCESS_POLICY_UPDATE` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_APPROVED_DOMAINS_DELETE` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_DOMAINS_DELETE` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_APPROVED_DOMAINS_GET` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_APPROVED_DOMAINS_GET` |-| `DATABRICKS_SETTINGS_AIBI_DASHBOARD_EMBEDDING_APPROVED_DOMAINS_UPDATE` | `DATABRICKS_SETTINGS_AIBI_DASH_EMBEDDING_DOMAINS_UPDATE` |-| `DATABRICKS_SETTINGS_COMPLIANCE_SECURITY_PROFILE_GET` | `DATABRICKS_SETTINGS_COMPL_SECURITY_PROFILE_GET` |-| `DATABRICKS_SETTINGS_DASHBOARD_EMAIL_SUBSCRIPTIONS_DELETE` | `DATABRICKS_SETTINGS_DASH_EMAIL_SUBS_DELETE` |-| `DATABRICKS_SETTINGS_DASHBOARD_EMAIL_SUBSCRIPTIONS_GET` | `DATABRICKS_SETTINGS_DASH_EMAIL_SUBS_GET` |-| `DATABRICKS_SETTINGS_DASHBOARD_EMAIL_SUBSCRIPTIONS_UPDATE` | `DATABRICKS_SETTINGS_DASH_EMAIL_SUBS_UPDATE` |-| `DATABRICKS_SETTINGS_ENABLE_EXPORT_NOTEBOOK_GET_ENABLE_EXPORT_NOTEBOOK` | `DATABRICKS_SETTINGS_ENABLE_EXPORT_NOTEBOOK_GET_ENABLE` |-| `DATABRICKS_SETTINGS_ENABLE_EXPORT_NOTEBOOK_PATCH_ENABLE_EXPORT_NOTEBOOK` | `DATABRICKS_SETTINGS_ENABLE_EXPORT_NOTEBOOK_PATCH_ENABLE` |-| `DATABRICKS_SETTINGS_ENABLE_NOTEBOOK_TABLE_CLIPBOARD_GET_ENABLE_NOTEBOOK_TABLE_CLIPBOARD` | `DATABRICKS_SETTINGS_ENABLE_NOTEBOOK_TABLE_CLIPBOARD_GET` |-| `DATABRICKS_SETTINGS_ENABLE_NOTEBOOK_TABLE_CLIPBOARD_PATCH_ENABLE_NOTEBOOK_TABLE_CLIPBOARD` | `DATABRICKS_SETTINGS_ENABLE_NOTEBOOK_TABLE_CLIPBOARD_PATCH` |-| `DATABRICKS_SETTINGS_ENABLE_RESULTS_DOWNLOADING_GET_ENABLE_RESULTS_DOWNLOADING` | `DATABRICKS_SETTINGS_ENABLE_RESULTS_DOWNLOADING_GET_ENABLE` |-| `DATABRICKS_SETTINGS_LLM_PROXY_PARTNER_POWERED_WORKSPACE_DELETE` | `DATABRICKS_SETTINGS_LLM_PROXY_PARTNER_WORKSPACE_DELETE` |-| `DATABRICKS_SETTINGS_LLM_PROXY_PARTNER_POWERED_WORKSPACE_UPDATE` | `DATABRICKS_SETTINGS_LLM_PROXY_PARTNER_WORKSPACE_UPDATE` |-| `DATABRICKS_SETTINGS_NOTIFICATION_DESTINATIONS_CREATE` | `DATABRICKS_SETTINGS_NOTIF_DESTS_CREATE` |-| `DATABRICKS_SETTINGS_NOTIFICATION_DESTINATIONS_DELETE` | `DATABRICKS_SETTINGS_NOTIF_DESTS_DELETE` |-| `DATABRICKS_SETTINGS_NOTIFICATION_DESTINATIONS_UPDATE` | `DATABRICKS_SETTINGS_NOTIF_DESTS_UPDATE` |-| `DATABRICKS_SETTINGS_TOKEN_MANAGEMENT_GET_PERMISSION_LEVELS` | `DATABRICKS_SETTINGS_TOKEN_MGMT_GET_PERM_LEVELS` |-| `DATABRICKS_SETTINGS_TOKEN_MANAGEMENT_GET_PERMISSIONS` | `DATABRICKS_SETTINGS_TOKEN_MGMT_GET_PERMS` |-| `DATABRICKS_SETTINGS_TOKEN_MANAGEMENT_SET_PERMISSIONS` | `DATABRICKS_SETTINGS_TOKEN_MGMT_SET_PERMS` |-| `DATABRICKS_SETTINGS_TOKEN_MANAGEMENT_UPDATE_PERMISSIONS` | `DATABRICKS_SETTINGS_TOKEN_MGMT_UPDATE_PERMS` |-| `DATABRICKS_SETTINGSV2_WORKSPACE_SETTINGS_V2_GET_PUBLIC_WORKSPACE_SETTING` | `DATABRICKS_SETTINGSV2_WORKSPACE_SETTINGS_V2_GET_PUBLIC` |-| `DATABRICKS_SQL_STATEMENT_EXECUTION_CANCEL_EXECUTION` | `DATABRICKS_SQL_STATEMENT_EXEC_CANCEL_EXEC` |-| `DATABRICKS_VECTORSEARCH_VECTOR_SEARCH_ENDPOINTS_CREATE_ENDPOINT` | `DATABRICKS_VECTORSEARCH_VECTOR_SEARCH_ENDPOINTS_CREATE` |-| `DATABRICKS_VECTORSEARCH_VECTOR_SEARCH_INDEXES_UPSERT_DATA_VECTOR_INDEX` | `DATABRICKS_VECTORSEARCH_VECTOR_SEARCH_INDEXES_UPSERT_DATA` |-| `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES_IDENTIFIER` | `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES` |-| `DROPBOX_SIGN_EDIT_AND_RESEND_EMBEDDED_SIGNATURE_REQUEST_WITH_TEMPLATE` | `DROPBOX_SIGN_EDIT_RESEND_EMBEDDED_SIGNATURE_REQUEST_TEMPLATE` |-| `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION` | `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG` |-| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS_MEASUREMENTPROTOCOLSECRETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS` |-| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINK_PROPOSALS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_LINK_PROPOSALS_LIST` |-| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINKS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_AD_LINKS_LIST` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS` |-| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS` |-| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS` |-| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360` |-| `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES_LIST_ACTION` | `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES` |-| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_DELETE` |-| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_GET` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_GET` |-| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_LIST` |-| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHS_DELETE` |-| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ATTACHS` |-| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD_ON_CONTEXT` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD` |-| `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP_LIST_POST` | `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP` |-| `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_AND_SPAM_ASSASSIN_REPORTS` | `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_SPAM_ASSASSIN` |-| `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY_KEY` | `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY` |-| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_DATABASE_ID_CANDIDATES` | `METABASE_GET_API_AUTO_DASHBOARDS_DATABASE_ID_CANDIDATES` |-| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY` |-| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY_RULE_PREFIX` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY_RULE` |-| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_QUERY_METADATA` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_QUERY_METADATA` |-| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_REMAPPING` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_REMAPPING` |-| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_VALUES` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_VALUES` |-| `METABASE_POST_API_DASHBOARD_SAVE_COLLECTION_PARENT_COLLECTION_ID` | `METABASE_POST_API_DASH_SAVE_COLLECTION_PARENT_COLLECTION_ID` |-| `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASHBOARD_SUBSCRIPTION` | `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASH_SUB` |-| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASHBOARD_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASH_DETAILS` |-| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOCUMENT_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOC_DETAILS` |-| `SALESFORCE_GET_VALUES_FOR_ALL_PICKLIST_FIELDS_OF_A_RECORD_TYPE` | `SALESFORCE_GET_PICKLIST_VALUES_BY_RECORD_TYPE` |-| `SALESFORCE_GET_UIAPI_LIST_INFO_ACCOUNT_RECENT_LISTS_ONLY_TRUE` | `SALESFORCE_GET_UI_API_LIST_INFO_RECENT` |-| `SALESFORCE_GET_UIAPI_RELATED_LIST_PREFERENCES_BATCH_ACCOUNTRELATEDCONTACTLISTACCOUNTRELATEDOPPORTUNITYLIST` | `SALESFORCE_GET_RELATED_LIST_PREFS_BATCH` |-| `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE_TRIGGERED` | `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE` |-| `SAP_SUCCESSFACTORS_CREATE_OR_UPDATE_A_SUCCESSOR_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_CREATE_UPDATE_SUCCESSOR_NOMINATION` |-| `SAP_SUCCESSFACTORS_DELETE_A_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_DELETE_NOMINATION_POSITION_TALENT_POOL` |-| `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE_VIA_SAP_BUSINESS_ACCELERATOR_HUB` | `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE` |-| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CALIBRATION_SESSION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CALIB_SESSION_SERVICE` |-| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CLOCK_INCLOCK_OUT_INTEGRATION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CLOCK_INCLOCK_OUT` |-| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_ONBOARDING_ADDITIONAL_SERVICES` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_ONBOARDING_ADDL` |-| `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_OR_FEEDBACK_REQUEST_RECORDS` | `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_FEEDBACK` |-| `SAP_SUCCESSFACTORS_QUERY_A_CLOCK_IN_CLOCK_OUT_GROUP_BY_CODE_WITH_TIME_EVENT_TYPES` | `SAP_SUCCESSFACTORS_QUERY_CLOCK_CLOCK_OUT_GROUP_CODE_TIME` |-| `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_IN_CLOCK_OUT_GROUPS` | `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_CLOCK_OUT` |-| `SAP_SUCCESSFACTORS_REFRESH_METADATA_FOR_CONTINUOUS_FEEDBACK_SERVICE` | `SAP_SUCCESSFACTORS_REFRESH_METADATA_CONT_FEEDBACK_SERVICE` |-| `SAP_SUCCESSFACTORS_UPDATE_THE_INTERNAL_USERNAME_OF_NEW_HIRES_AFTER_HIRING_PROCESS_IS_COMPLETED_FROM_ACTIVE_DIRECTORY` | `SAP_SUCCESSFACTORS_UPDATE_INTERNAL_USERNAME_NEW_HIRES_AFTER` |-| `SENTRY_RETRIEVE_CUSTOM_INTEGRATION_ISSUE_LINKS_FOR_THE_GIVEN_SENTRY_ISSUE` | `SENTRY_RETRIEVE_CUSTOM_INTEG_ISSUE_LINKS_GIVEN_SENTRY_ISSUE` |-| `SENTRY_RETRIEVE_THE_CUSTOM_INTEGRATIONS_CREATED_BY_AN_ORGANIZATION` | `SENTRY_RETRIEVE_THE_CUSTOM_INTEGS_CREATED_BY_AN_ORG` |-| `SHOPIFY_ADJUSTS_THE_INVENTORY_LEVEL_OF_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_ADJUSTS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |-| `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT_CODES` | `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT` |-| `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT_SERVICE_ID` | `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT` |-| `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |-| `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID_LOCATIONS_FOR_MOVE` | `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID` |-| `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM_BATCH_ID` | `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM` |-| `SHOPIFY_PERFORMS_BULK_OPERATIONS_FOR_MULTIPLE_CUSTOMER_ADDRESSES` | `SHOPIFY_PERFORMS_BULK_OPERATIONS_MULTIPLE_CUSTOMER_ADDRESSES` |-| `SHOPIFY_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |-| `SHOPIFY_RETRIEVE_A_LIST_OF_PRODUCTS_BELONGING_TO_A_COLLECTION` | `SHOPIFY_RETRIEVE_LIST_PRODUCTS_BELONGING_COLLECTION` |-| `SHOPIFY_RETRIEVES_A_LIST_OF_ALL_ARTICLE_TAGS_FROM_A_SPECIFIC_BLOG` | `SHOPIFY_RETRIEVES_LIST_ALL_ARTICLE_TAGS_SPECIFIC_BLOG` |-| `SHOPIFY_RETRIEVES_A_LIST_OF_DISCOUNT_CODES_FOR_A_DISCOUNT_CODE_CREATION_JOB` | `SHOPIFY_RETRIEVES_LIST_DISCOUNT_CODES_DISCOUNT_CODE` |-| `SHOPIFY_RETRIEVES_A_LIST_OF_STOREFRONT_ACCESS_TOKENS_THAT_HAVE_BEEN_ISSUED` | `SHOPIFY_RETRIEVES_LIST_STOREFRONT_ACCESS_TOKENS_THAT_HAVE` |-| `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_WITH_A_FULFILLMENT_ORDER` | `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_FULFILLMENT_ORDER` |-| `SHOPIFY_SETS_THE_INVENTORY_LEVEL_FOR_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_SETS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |-| `SHOPIFY_SHOP_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_SHOP_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |-| `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |-| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID` |-| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID_DISCOUNT` |-| `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS_TRANSACTION` | `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TXNS_TXN` |-| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |-| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID_DISCOUNT` |-| `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS_CAPABILITIES` | `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS` |-| `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TRANSACTIONS_OVERVIEW_BILLING_CREDIT_BALANCE_TRANSACTIONS` | `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TXNS_OVERVIEW_BILLING` |-| `STRIPE_GET_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_GET_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |-| `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE_ENTITLEMENT` | `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE` |-| `STRIPE_GET_V1_FINANCIAL_CONNECTIONS_ACCOUNTS_OVERVIEW_FINANCIAL_CONNECTIONS_ACCOUNTS` | `STRIPE_GET_V1_FIN_CONNS_ACCOUNTS_OVERVIEW_FIN_CONNS_ACCOUNTS` |-| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD` |-| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |-| `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL_QUOTES` | `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL` |-| `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING_REPORT_TYPES` | `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING` |-| `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_A_TEST_TEST_HELPERS_TEST_CLOCKS` | `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_TEST_TEST` |-| `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |-| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_CANCELED` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_CANCELED` |-| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_INFO` |-| `STRIPE_POST_TAX_TRANSACTIONS_CREATE_FROM_CALCULATION_OVERVIEW` | `STRIPE_POST_TAX_TXNS_CREATE_FROM_CALCULATION_OVERVIEW` |-| `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER` |-| `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER` |-| `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET` |-| `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND_A_TEST` | `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND` |-| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT_PAYMENT_METHOD` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT` |-| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED` |-| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT` |-| `STRIPE_POST_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_POST_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |-| `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |-| `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD_DOMAINS2` | `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD` |-| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_CANCELED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_CANCELED` |-| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_GUARANTEED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_GUARANTEED` |-| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_INFO` |-| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_ATTEMPT` |-| `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_A_TEST` | `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_TEST` |-| `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT_ADJUSTMENTS` | `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT` |--</details>--## Migration--If you're referencing any affected tool enums by their old names, update to the new shortened names.diff --git a/fern/pages/src/changelog/01-12-26-tool-router-improvements.md b/fern/pages/src/changelog/01-12-26-tool-router-improvements.mddeleted file mode 100644index c2046918b..000000000--- a/fern/pages/src/changelog/01-12-26-tool-router-improvements.md+++ /dev/null@@ -1,127 +0,0 @@-# Tool Router Improvements and New Features--## Version Information--### TypeScript/JavaScript-- Package: `@composio/core` and provider packages-- Version: `0.3.4` to `0.4.0`--### Python-- Package: `composio-core` and provider packages-- Version: `0.10.4` to `0.10.5`--## New Features--### 1. Wait for Connections Property--Added `waitForConnections` (TypeScript) / `wait_for_connections` (Python) property to manage connections configuration. This allows tool router sessions to wait for users to complete authentication before proceeding to the next step.--**TypeScript:**-```typescript-const session = await composio.toolRouter.create(userId, {- manageConnections: {- enable: true,- callbackUrl: 'https://example.com/callback',- waitForConnections: true // NEW- }-});-```--**Python:**-```python-session = tool_router.create(- user_id="user_123",- manage_connections={- "enable": True,- "callback_url": "https://example.com/callback",- "wait_for_connections": True # NEW- }-)-```--### 2. Session-Specific Modifier Types--Introduced new modifier types for better session-based tool execution: `SessionExecuteMetaModifiers` and `SessionMetaToolOptions`.--**TypeScript:**-```typescript-const tools = await session.tools({- modifySchema: ({ toolSlug, toolkitSlug, schema }) => schema,- beforeExecute: ({ toolSlug, toolkitSlug, sessionId, params }) => params,- afterExecute: ({ toolSlug, toolkitSlug, sessionId, result }) => result-});-```--**Python:**-```python-from composio.core.models import before_execute_meta, after_execute_meta--@before_execute_meta-def before_modifier(tool, toolkit, session_id, params):- return params--@after_execute_meta-def after_modifier(tool, toolkit, session_id, response):- return response--tools = session.tools(modifiers=[before_modifier, after_modifier])-```--### 3. Dedicated Method for Tool Router Meta Tools--Added `getRawToolRouterMetaTools` (TypeScript) / `get_raw_tool_router_meta_tools` (Python) method in the Tools class for fetching meta tools directly from a tool router session.--**TypeScript:**-```typescript-const metaTools = await composio.tools.getRawToolRouterMetaTools('session_123', {- modifySchema: ({ toolSlug, toolkitSlug, schema }) => {- // Customize schema- return schema;- }-});-```--**Python:**-```python-meta_tools = tools_model.get_raw_tool_router_meta_tools(- session_id="session_123",- modifiers=[schema_modifier]-)-```--## Internal Improvements--### 1. Performance Optimization--Eliminated unnecessary tool fetching during tool router execution, resulting in faster tool execution with fewer API calls.--### 2. Improved Architecture--Tool router sessions now fetch tools directly from the session API endpoint instead of using tool slugs, providing better consistency and reliability.--### 3. Simplified Implementation--Removed redundant tool schema fetching in execution paths, using a hardcoded 'composio' toolkit slug for meta tools.--## Backward Compatibility--This release is fully backward compatible:--- All existing code continues to work without modifications-- New properties are optional with sensible defaults-- New modifier types can be adopted incrementally-- Internal changes have no impact on public APIs-- No migration required--## Impact Summary--| Change | Runtime Breaking | TypeScript Breaking | Migration Required |-|--------|------------------|---------------------|-------------------|-| `wait_for_connections` property | No | No | No |-| Session-specific modifiers | No | No | No |-| `getRawToolRouterMetaTools` method | No | No | No |-| Tool router uses session API | No | No | No |-| Optimized tool execution | No | No | No |--All changes follow semantic versioning principles and maintain full backward compatibility.-diff --git a/fern/pages/src/changelog/01-14-26-auth-config-patch-semantics.md b/fern/pages/src/changelog/01-14-26-auth-config-patch-semantics.mddeleted file mode 100644index 4fd2e9865..000000000--- a/fern/pages/src/changelog/01-14-26-auth-config-patch-semantics.md+++ /dev/null@@ -1,189 +0,0 @@-# True PATCH Semantics for Auth Config Updates--## Version Information--### TypeScript/JavaScript-- Package: `@composio/core` and provider packages-- Version: `0.5.1`+--### Python-- Package: `composio-core` and provider packages-- Version: `0.10.7`+-------The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial update semantics. Previously, omitting fields would clear them (behaving like PUT). Now, omitted fields are preserved—only explicitly provided fields are modified.--<Warning>-**Breaking Change**: If you relied on omitting fields to clear them, you must now explicitly send `null` or `[]`. See [Migration Guide](#migration-guide) below.-</Warning>--## What Changed--| Field | Before (Buggy) | After (Correct) |-| ----------------------------- | ------------------------ | --------------------------------- |-| `credentials` | Required on every update | Optional—merged with existing |-| `tool_access_config` | Reset to `{}` if omitted | Preserved if omitted |-| `scopes` (type: default) | Cleared if omitted | Preserved if omitted |-| `restrict_to_following_tools` | Reset to `[]` if omitted | Preserved if omitted |--<Note>-**Merge Behavior**: The `credentials` object is merged—send only the fields you want to change, and existing fields are preserved.-</Note>--## New Capabilities--### Rotate a Single Credential Field--Update just `client_secret` without resending `client_id` or other fields:--<CodeBlocks>-```python title="Python SDK"-from composio import Composio--composio = Composio()--# Only send the field you want to update - other credentials are preserved--composio.auth_configs.update(-"ac_yourAuthConfigId",-options={-"type": "custom",-"credentials": {-"client_secret": "new_rotated_secret",-},-},-)--````--```typescript title="TypeScript SDK"-import { Composio } from "@composio/core";--const composio = new Composio();--// Only send the field you want to update - other credentials are preserved-await composio.authConfigs.update("ac_yourAuthConfigId", {- type: "custom",- credentials: {- client_secret: "new_rotated_secret",- },-});-````--</CodeBlocks>--### Update Tool Restrictions Without Touching Credentials--Previously, this would fail because `credentials` was required. Now it works:--<CodeBlocks>-```python title="Python SDK"-from composio import Composio--composio = Composio()--# Update tool restrictions - credentials are automatically preserved--composio.auth_configs.update(-"ac_yourAuthConfigId",-options={-"type": "custom",-"tool_access_config": {-"tools_available_for_execution": ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],-},-},-)--````--```typescript title="TypeScript SDK"-import { Composio } from "@composio/core";--const composio = new Composio();--// Note: TypeScript SDK currently requires credentials for custom type updates-await composio.authConfigs.update("ac_yourAuthConfigId", {- type: "custom",- credentials: {- // Include existing credentials when using TS SDK- },- toolAccessConfig: {- toolsAvailableForExecution: ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],- },-});-````--</CodeBlocks>--## Migration Guide--### Am I Affected?--**Yes**, if your code relied on omitting fields to clear them.--**No**, if you always send complete payloads or only use PATCH to update specific fields.--### How to Clear Fields Explicitly--| To Clear | Python SDK | TypeScript SDK |-| -------------------- | ------------------------------------------------------------- | ------------------------------------------------------ |-| `tool_access_config` | `"tool_access_config": {"tools_available_for_execution": []}` | `toolAccessConfig: { toolsAvailableForExecution: [] }` |-| `scopes` (default) | `"scopes": ""` | `scopes: ""` (via HTTP API) |--<CodeBlocks>-```python title="Python SDK - Clear tool restrictions"-from composio import Composio--composio = Composio()--# Explicitly clear tool restrictions with empty array--composio.auth_configs.update(-"ac_yourAuthConfigId",-options={-"type": "custom",-"tool_access_config": {-"tools_available_for_execution": [],-},-},-)--````--```typescript title="TypeScript SDK - Clear tool restrictions"-import { Composio } from "@composio/core";--const composio = new Composio();--// Explicitly clear tool restrictions with empty array-await composio.authConfigs.update("ac_yourAuthConfigId", {- type: "custom",- credentials: {- // Include existing credentials when using TS SDK- },- toolAccessConfig: {- toolsAvailableForExecution: [],- },-});-````--</CodeBlocks>--### Raw HTTP API--For users calling the API directly:--```bash-# Rotate single credential-curl -X PATCH "https://backend.composio.dev/api/v3/auth_configs/{id}" \- -H "x-api-key: YOUR_API_KEY" \- -H "Content-Type: application/json" \- -d '{"type": "custom", "credentials": {"client_secret": "new_secret"}}'--# Clear tool restrictions-curl -X PATCH "https://backend.composio.dev/api/v3/auth_configs/{id}" \- -H "x-api-key: YOUR_API_KEY" \- -H "Content-Type: application/json" \- -d '{"type": "custom", "tool_access_config": {"tools_available_for_execution": []}}'-```diff --git a/fern/pages/src/changelog/01-20-26-file-modifier-anyof-support.md b/fern/pages/src/changelog/01-20-26-file-modifier-anyof-support.mddeleted file mode 100644index 5488a9257..000000000--- a/fern/pages/src/changelog/01-20-26-file-modifier-anyof-support.md+++ /dev/null@@ -1,136 +0,0 @@-# [Critical] File Upload/Download Fixes for `latest` tool with anyOf, oneOf, and allOf Schemas--## Version Information--### TypeScript/JavaScript-- Package: `@composio/core` and provider packages-- Version: `0.5.3`+--### Python-- Package: `composio` and provider packages-- Version: `0.10.8`+-------The file handling modifiers now properly handle `file_uploadable` and `file_downloadable` properties nested within `anyOf`, `oneOf`, and `allOf` JSON Schema declarations. Previously, only direct child properties (and partial `allOf` support) were detected for file upload/download transformations.--<Note>-We recommend updating to version `0.5.3` (TypeScript) or `0.10.8` (Python) or later to ensure file uploads and downloads work correctly with tools that use union or intersection types in their schemas.-</Note>--## What Changed--### Before (Bug)--File properties inside `anyOf`, `oneOf`, or `allOf` were not detected:--```typescript-// This schema's file_uploadable was NOT being processed-inputParameters: {- type: 'object',- properties: {- fileInput: {- anyOf: [- {- type: 'string',- file_uploadable: true // ❌ Not detected- },- {- type: 'null'- }- ]- }- }-}-```--### After (Fixed)--File properties are now correctly detected and processed at any nesting level:--```typescript-// Now properly detected and transformed-inputParameters: {- type: 'object',- properties: {- fileInput: {- anyOf: [- {- type: 'string',- file_uploadable: true // ✅ Detected and processed- },- {- type: 'null'- }- ]- }- }-}-```--## Affected Scenarios--| Scenario | Before | After |-|----------|--------|-------|-| `file_uploadable` in `anyOf` | Not detected | ✅ Works |-| `file_uploadable` in `oneOf` | Not detected | ✅ Works |-| `file_uploadable` in `allOf` | Not detected | ✅ Works |-| `file_downloadable` in `anyOf` | Not detected | ✅ Works |-| `file_downloadable` in `oneOf` | Not detected | ✅ Works |-| `file_downloadable` in `allOf` | Not detected | ✅ Works |-| Nested objects inside union types | Not detected | ✅ Works |-| Array items with union types | Not detected | ✅ Works |--## How to Update--### TypeScript/JavaScript--<CodeBlocks>-```bash title="npm"-npm update @composio/core@latest-```--```bash title="pnpm"-pnpm update @composio/core@latest-```--```bash title="yarn"-yarn upgrade @composio/core@latest-```-</CodeBlocks>--### Python--<CodeBlocks>-```bash title="pip"-pip install --upgrade composio-```--```bash title="uv"-uv pip install --upgrade composio-```--```bash title="poetry"-poetry update composio-```-</CodeBlocks>--## Backward Compatibility--This release is fully backward compatible:--- All existing code continues to work without modifications-- No migration required-- File upload/download for direct properties continues to work as before-- The fix only adds support for previously unsupported schema patterns--## Impact Summary--| Change | Runtime Breaking | TypeScript Breaking | Migration Required |-|--------|------------------|---------------------|-------------------|-| `anyOf` support for file uploads | No | No | No |-| `oneOf` support for file uploads | No | No | No |-| `allOf` support for file uploads | No | No | No |-| `anyOf` support for file downloads | No | No | No |-| `oneOf` support for file downloads | No | No | No |-| `allOf` support for file downloads | No | No | No |diff --git a/fern/pages/src/changelog/01-20-26-file-ttl.md b/fern/pages/src/changelog/01-20-26-file-ttl.mddeleted file mode 100644index 9941f2a23..000000000--- a/fern/pages/src/changelog/01-20-26-file-ttl.md+++ /dev/null@@ -1,56 +0,0 @@-# File handling in tool execution now uses presigned URLs--## Summary--Files involved in tool execution are now shared via presigned URLs with a default TTL (time-to-live) of 1 hour. You can customize the file TTL through your project configuration.--## What changed--When tools return files (images, documents, exports, etc.), these files are now delivered as presigned URLs with a configurable TTL instead of non-expiring URLs. This provides:--- **Automatic cleanup** - Files expire after the configured TTL-- **Configurable retention** - Adjust file availability based on your application's needs--## Default behavior--All files returned from tool execution now have a **1 hour TTL** by default. After this period, the presigned URLs expire and files are no longer accessible.--## Configuring file TTL--You can adjust the file TTL to match your application's needs.--### Via Dashboard--1. Navigate to **Project Settings** in your Composio dashboard-2. Find the **File TTL** configuration option-3. Set your desired TTL value--### Via API--Use the [Update Project Config API](https://docs.composio.dev/rest-api/projects/patch-org-project-config) to programmatically configure the file TTL:--```bash-curl -X PATCH "https://backend.composio.dev/api/v3/org/projects/config" \- -H "x-api-key: YOUR_API_KEY" \- -H "Content-Type: application/json" \- -d '{- "fileTtl": 3600- }'-```--## Impact--| Aspect | Before | After |-|--------|--------|-------|-| File delivery | Non-expiring URLs | Presigned URLs with TTL |-| Default expiry | None | 1 hour |-| TTL customization | Not available | Configurable via project settings |--## Migration--No code changes are required. Your existing integrations will continue to receive file URLs as before, but these URLs will now expire after the configured TTL.--If your application stores or caches file URLs for later use, ensure you handle URL expiration appropriately by either:-- Downloading files before the TTL expires-- Re-executing the tool to obtain fresh URLs when needed-- Increasing the TTL via project settings to match your retention requirementsdiff --git a/fern/pages/src/changelog/01-21-26-initiate-active-status-filter.md b/fern/pages/src/changelog/01-21-26-initiate-active-status-filter.mddeleted file mode 100644index e79767ee8..000000000--- a/fern/pages/src/changelog/01-21-26-initiate-active-status-filter.md+++ /dev/null@@ -1,44 +0,0 @@-# Connected Account Initiate Now Filters by ACTIVE Status--## Version Information--### TypeScript/JavaScript-- Package: `@composio/core`-- Version: `0.5.4`+--### Python-- Package: `composio`-- Version: `0.10.9`+-------The `initiate()` method now only considers ACTIVE connected accounts when checking for duplicates. Previously, expired or inactive accounts would incorrectly trigger the multiple accounts error.--## What Changed--When calling `connectedAccounts.initiate()`, the SDK now filters by `statuses: ["ACTIVE"]` when checking for existing accounts. This prevents expired or inactive accounts from blocking new connection creation.--### Before (Bug)--```typescript-// Expired accounts would incorrectly trigger ComposioMultipleConnectedAccountsError-await composio.connectedAccounts.initiate(userId, authConfigId);-// ❌ Error: Multiple connected accounts found (even if they're all expired)-```--### After (Fixed)--```typescript-// Only ACTIVE accounts are considered-await composio.connectedAccounts.initiate(userId, authConfigId);-// ✅ Works - expired/inactive accounts are ignored-```--## Affected SDKs--- **TypeScript**: `@composio/core`-- **Python**: `composio`--## Backward Compatibility--This is a bug fix with no breaking changes. The behavior now matches the expected intent of the multiple accounts check.diff --git a/fern/pages/src/changelog/01-22-26-experimental-assistive-prompts.md b/fern/pages/src/changelog/01-22-26-experimental-assistive-prompts.mddeleted file mode 100644index 1b533d6b4..000000000--- a/fern/pages/src/changelog/01-22-26-experimental-assistive-prompts.md+++ /dev/null@@ -1,113 +0,0 @@-# Experimental Assistive Prompts and API Updates--## Version Information--### TypeScript/JavaScript-- Package: `@composio/core`-- Version: `0.5.5`+--### Python-- Package: `composio`-- Version: `0.10.10`+--## New Features--### Experimental Assistive Prompt Configuration--Tool Router sessions now support experimental configuration for timezone-aware assistive prompts. When you provide a user's timezone, the session returns a contextual assistive prompt that includes timezone-specific guidance.--<Warning>-This is an experimental feature. The API may change or be removed in future versions.-</Warning>--<CodeBlocks>-```python title="Python SDK"-from composio import Composio--composio = Composio()--session = composio.tool_router.create(- user_id="user_123",- toolkits=["github"],- experimental={- "assistive_prompt": {- "user_timezone": "America/New_York",- }- },-)--# Access the generated assistive prompt-if session.experimental:- print(session.experimental.assistive_prompt)-```--```typescript title="TypeScript SDK"-import { Composio } from "@composio/core";--const composio = new Composio();--const session = await composio.toolRouter.create("user_123", {- toolkits: ["github"],- experimental: {- assistivePrompt: {- userTimezone: "America/New_York",- },- },-});--// Access the generated assistive prompt-if (session.experimental) {- console.log(session.experimental.assistivePrompt);-}-```-</CodeBlocks>--<Note>-The `experimental` field is only available on sessions created with `create()`. Sessions retrieved with `use()` do not include the experimental data.-</Note>--### Toolkit Endpoint Method--The toolkit retrieve response now includes `getCurrentUserEndpointMethod` (TypeScript) / `get_current_user_endpoint_method` (Python) to indicate the HTTP method for the current user endpoint.--## Breaking Changes--### Trigger Pagination: `page` Replaced with `cursor`--The `page` parameter in `listActive` / `list_active` for trigger instances has been replaced with `cursor` for cursor-based pagination. There was a bug in earlier APIs which caused `page` param to be ignored, going ahead for pagination please use `cursor` instead.--<CodeBlocks>-```python title="Python SDK"-# Before (deprecated)-triggers = composio.triggers.list_active(page=1, limit=10)--# After-triggers = composio.triggers.list_active(cursor="cursor_string", limit=10)-# Use response.next_cursor for the next page-```--```typescript title="TypeScript SDK"-// Before (deprecated)-const triggers = await composio.triggers.listActive({ page: 1, limit: 10 });--// After-const triggers = await composio.triggers.listActive({ cursor: "cursor_string", limit: 10 });-// Use response.nextCursor for the next page-```-</CodeBlocks>--## Impact Summary--| Change | Runtime Breaking | TypeScript Breaking | Migration Required |-|--------|------------------|---------------------|-------------------|-| Experimental assistive prompts | No | No | No |-| `getCurrentUserEndpointMethod` field | No | No | No |-| `page` → `cursor` in triggers | Yes | Yes | Yes (if using `page`) |--## Migration Guide--If you are using the `page` parameter in `listActive` / `list_active`:--1. Replace `page` with `cursor`-2. For the first request, omit the `cursor` parameter or pass `undefined`/`None`-3. Use the `nextCursor` / `next_cursor` from the response for subsequent requestsdiff --git a/fern/pages/src/changelog/09-15-25.md b/fern/pages/src/changelog/09-15-25.mddeleted file mode 100644index 58c359e48..000000000--- a/fern/pages/src/changelog/09-15-25.md+++ /dev/null@@ -1,86 +0,0 @@-# Introducing Composio Auth Links--Composio Auth Links provide a **hosted authentication solution** that eliminates the need for developers to build custom authentication forms. Instead of manually rendering OAuth consent screens, API key input forms, or custom authentication fields, developers can simply redirect users to a Composio-hosted URL that handles the entire authentication process automatically.--## Why Use Auth Links?--- **Zero UI Development**: No need to build forms for OAuth, API keys, or custom fields like subdomains-- **Universal Authentication**: Works seamlessly across all supported third-party services-- **Reduced Complexity**: Replace complex OAuth flows with a simple redirect-- **Better UX**: Professional, consistent authentication experience for end users-- **Faster Integration**: Get authentication working in minutes, not hours-------## Python SDK (v0.8.11)--**Added**--- **Composio Connect Link Support**: New `link()` method for creating external authentication links- - Added `link()` method to `ConnectedAccounts` class for generating user authentication links- - Support for callback URL redirection after authentication- - Enhanced user experience with external link-based authentication flow- - **No manual form rendering required** - Composio handles all authentication UI--**Examples:**--```python-# Basic usage - create a connection request-connection_request = composio.connected_accounts.link('user_123', 'auth_config_123')-redirect_url = connection_request.redirect_url-print(f"Visit: {redirect_url} to authenticate your account")--# Wait for the connection to be established-connected_account = connection_request.wait_for_connection()--# With callback URL-connection_request = composio.connected_accounts.link(- 'user_123',- 'auth_config_123',- callback_url='<https://your-app.com/callback>'-)--```--## TypeScript SDK (v0.1.51)--**Added**--- **Composio Connect Links**: Added support for composio connect links- - New `link()` method in `ConnectedAccounts` class for generating authentication URLs- - Support for callback URL redirection with `CreateConnectedAccountLinkOptions`- - Comprehensive TypeScript types and validation for link creation options- - **Eliminates need for custom authentication forms** - just redirect users to the link--**Examples:**--```tsx-// Basic usage - create a connection request-const connectionRequest = await composio.connectedAccounts.link('user_123', 'auth_config_123');-const redirectUrl = connectionRequest.redirectUrl;-console.log(`Visit: ${redirectUrl} to authenticate your account`);--// Wait for the connection to be established-const connectedAccount = await connectionRequest.waitForConnection();--// With callback URL-const connectionRequest = await composio.connectedAccounts.link('user_123', 'auth_config_123', {- callbackUrl: '<https://your-app.com/callback>'-});--```--## Key Benefits--- **No Form Building**: Composio handles OAuth consent, API key collection, and custom field inputs-- **Hosted Authentication Flow**: Professional UI that works across all supported services-- **Callback URL Support**: Control where users return after successful authentication-- **Connection Waiting**: Built-in polling to detect when authentication completes-- **Cross-Platform Consistency**: Identical developer experience across Python and TypeScript--## Customisation--You can customise the app logo and name showed in the authentication page via the dashboard. Head over your project via `platform.composio.dev` and choose Settings → Auth Links to upload a new logo and change the name.--## Migration Note-This feature replaces manual authentication form development with a simple redirect-based approach, significantly reducing integration time and complexity while providing a better user experience. Auth links are drop in replacement for `composio.connectedAccounts.initate`, you can safely swap this to `composio.connectedAccounts.link`\ No newline at end of filediff --git a/fern/pages/src/changelog/09-16-25.md b/fern/pages/src/changelog/09-16-25.mddeleted file mode 100644index fd7b27bea..000000000--- a/fern/pages/src/changelog/09-16-25.md+++ /dev/null@@ -1,123 +0,0 @@-# Toolkit Versioning in SDKs--Composio Toolkit Versioning provides **granular control over tool versions** across all your integrations. Instead of always using the latest version of tools, developers can now specify exact toolkit versions, ensuring consistent behavior and controlled updates in production environments.--## Why Use Toolkit Versioning?--- **Version Stability**: Pin specific toolkit versions to avoid unexpected changes in production-- **Controlled Updates**: Test new toolkit versions before deploying to production-- **Environment Consistency**: Ensure the same toolkit versions across development, staging, and production-- **Rollback Capability**: Easily revert to previous toolkit versions if issues arise-- **Fine-grained Control**: Set different versions for different toolkits based on your needs-------## Python SDK (v0.8.11)--**Added**--- **Toolkit Versioning Support**: New `toolkit_versions` parameter for controlling tool versions- - Added `toolkit_versions` parameter to `Composio` class initialization- - Support for global version setting (e.g., `'latest'`)- - Support for per-toolkit version mapping (e.g., `{'github': '20250902_00', 'slack': '20250902_00'}`)- - Environment variable support with `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_NAME>` pattern- - New `toolkit_version.py` utility module for version resolution logic--**Examples:**--```python-# Global version for all toolkits, only `latest` is supported-composio = Composio(toolkit_versions='latest')--# Per-toolkit version mapping-composio = Composio(toolkit_versions={- 'github': '20250902_00',- 'slack': '20250902_00',- 'gmail': '20250901_01'-})--# Using environment variables-# Set COMPOSIO_TOOLKIT_VERSION_GITHUB=20250902_00-composio = Composio() # Automatically picks up env vars--# Get tools with specific versions-tools = composio.tools.get('default', {'toolkits': ['github']})-```--## TypeScript SDK (v0.1.52)--**Added**--- **Toolkit Versioning Support**: Added `toolkitVersions` configuration option- - New `toolkitVersions` parameter in `Composio` class constructor- - Support for global version string or per-toolkit version mapping- - Environment variable parsing with `getToolkitVersionsFromEnv()` utility- - Enhanced `getRawComposioToolBySlug()` method for version-specific tool retrieval- - Version-aware tool filtering and search capabilities--**Examples:**--```typescript-// Global version for all toolkits-const composio = new Composio({- toolkitVersions: '20250902_00'-});--// Per-toolkit version mapping-const composio = new Composio({- toolkitVersions: {- 'github': '20250902_00',- 'slack': '20250902_00',- 'gmail': '20250901_01'- }-});--// Using environment variables-// Set COMPOSIO_TOOLKIT_VERSION_GITHUB=20250902_00-const composio = new Composio(); // Automatically picks up env vars--// Get specific tool version-const tool = await composio.tools.getRawComposioToolBySlug(- 'GITHUB_GET_REPO',-);--// Get tools with version-aware filtering-const tools = await composio.tools.get('default', {- toolkits: ['github'],- limit: 10-});-```--## Key Benefits--- **Environment Variables**: Set `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_NAME>=<VERSION>` for automatic version resolution-- **Flexible Configuration**: Choose between global versions or per-toolkit version mapping-- **Backward Compatibility**: Existing code works unchanged - versioning is opt-in-- **Version Fallback**: Automatically falls back to 'latest' when no version is specified-- **Cross-Platform Consistency**: Identical developer experience across Python and TypeScript--## Version Format--Toolkit versions follow the format: `YYYYMMDD_NN` (e.g., `20250902_00`) or use `'latest'` for the most recent version only supported at global scope and not individual toolkit level.--## Environment Variables--```bash-# Set specific versions for different toolkits-export COMPOSIO_TOOLKIT_VERSION_GITHUB=20250902_00-export COMPOSIO_TOOLKIT_VERSION_SLACK=20250902_00-export COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_01-```--## Migration Note--This feature is fully backward compatible. Existing code will continue to work without changes, using the latest versions by default. To enable versioning, simply add the `toolkit_versions` parameter during SDK initialization.-------## Additional Updates--- **Package Updates**: Bumped all Python provider packages to v0.8.10-- **Documentation**: Enhanced API documentation with versioning examples-- **Testing**: Added comprehensive test coverage (400+ new test cases) for versioning functionality-- **Examples**: New versioning examples demonstrating practical usage patternsdiff --git a/fern/pages/src/changelog/09-26-25.md b/fern/pages/src/changelog/09-26-25.mddeleted file mode 100644index db797013c..000000000--- a/fern/pages/src/changelog/09-26-25.md+++ /dev/null@@ -1,511 +0,0 @@-# MCP (Model Control Protocol) & Experimental ToolRouter--Composio now introduces **comprehensive MCP (Model Control Protocol) support** and an **experimental ToolRouter** for creating isolated, scoped sessions with advanced toolkit management. These features enable seamless integration with modern AI frameworks and provide powerful session-based tool routing capabilities.--## Why Use MCP & ToolRouter?--- **Framework Integration**: Native MCP support for Vercel AI, Mastra, OpenAI Agents, and LangChain-- **Session Isolation**: Create isolated sessions with specific toolkit configurations-- **Advanced Authentication**: Flexible auth config management per toolkit-- **Scoped Access**: Control which tools are available within each session-- **Multi-Service Workflows**: Route tool calls efficiently across different services-- **Development & Testing**: Perfect for testing and development with scoped MCP server access--## TypeScript SDK (v0.1.53)--### **Added: MCP API**--**Core MCP Features:**-- **MCP Server Creation**: Create and manage MCP server configurations-- **User-Specific URLs**: Generate unique MCP server URLs for individual users-- **Toolkit Configuration**: Support for multiple toolkits with custom auth configs-- **Tool Filtering**: Specify allowed tools per configuration-- **Connection Management**: Choose between manual and automatic account management--**Basic Usage:**--```typescript-import { Composio } from '@composio/core';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});--// Create MCP configuration-const mcpConfig = await composio.mcp.create('my-server-name', {- toolkits: [- { toolkit: 'github', authConfigId: 'ac_233434343' },- { toolkit: 'gmail', authConfigId: 'ac_567890123' }- ],- allowedTools: ['GITHUB_CREATE_ISSUE', 'GMAIL_SEND_EMAIL'],- manuallyManageConnections: false,-});--// Generate server instance for a user-const serverInstance = await composio.mcp.generate('user123', mcpConfig.id);-console.log('MCP URL:', serverInstance.url);-```--**Framework Integration Examples:**--```typescript-// Vercel AI Integration-import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';-import { experimental_createMCPClient as createMCPClient } from 'ai';--const mcpClient = await createMCPClient({- name: 'composio-mcp-client',- transport: new SSEClientTransport(new URL(serverInstance.url)),-});--// Mastra Integration-import { MCPClient as MastraMCPClient } from '@mastra/mcp';--const mcpClient = new MastraMCPClient({- servers: {- composio: { url: new URL(mcpSession.url) },- },-});--// OpenAI Agents Integration-import { hostedMcpTool } from '@openai/agents';--const tools = [- hostedMcpTool({- serverLabel: 'composio',- serverUrl: mcpSession.url,- }),-];-```--### **Added: Experimental ToolRouter**--**Core ToolRouter Features:**-- **Session-Based Routing**: Create isolated sessions for specific users and toolkit combinations-- **Dynamic Configuration**: Configure toolkits and auth configs per session-- **MCP Server URLs**: Each session gets a unique MCP server endpoint-- **Flexible Toolkit Management**: Support for string names or detailed toolkit configurations-- **Connection Control**: Manual or automatic connection management per session--**Basic Usage:**--```typescript-// Create session with simple toolkit names-const session = await composio.experimental.toolRouter.createSession('user_123', {- toolkits: ['gmail', 'slack', 'github'],-});--// Create session with auth configs-const session = await composio.experimental.toolRouter.createSession('user_456', {- toolkits: [- { toolkit: 'gmail', authConfigId: 'ac_gmail_work' },- { toolkit: 'slack', authConfigId: 'ac_slack_team' },- { toolkit: 'github', authConfigId: 'ac_github_personal' },- ],- manuallyManageConnections: true,-});--console.log('Session ID:', session.sessionId);-console.log('MCP URL:', session.url);-```--**Advanced Multi-Service Integration:**--```typescript-// Complex workflow session-const integrationSession = await composio.experimental.toolRouter.createSession('user_789', {- toolkits: [- { toolkit: 'gmail', authConfigId: 'ac_gmail_work' },- { toolkit: 'slack', authConfigId: 'ac_slack_team' },- { toolkit: 'github', authConfigId: 'ac_github_personal' },- { toolkit: 'notion', authConfigId: 'ac_notion_workspace' },- { toolkit: 'calendar', authConfigId: 'ac_gcal_primary' },- ],-});--// Use with any MCP client-const mcpClient = new MCPClient(integrationSession.url);-```--**Framework-Specific Examples:**--```typescript-// Mastra Integration-const mcpSession = await composio.experimental.toolRouter.createSession(userId, {- toolkits: ["gmail"],- manuallyManageConnections: true,-});--const agent = new MastraAgent({- name: 'Gmail Assistant',- model: openai('gpt-4o-mini'),- tools: await mcpClient.getTools(),-});--// OpenAI Agents Integration-const tools = [- hostedMcpTool({- serverLabel: 'composio tool router',- serverUrl: mcpSession.url,- requireApproval: {- never: { toolNames: ['GMAIL_FETCH_EMAILS'] },- },- }),-];-```----## Python SDK (v0.8.17)--### **Added: MCP Support**--**Core MCP Features:**-- **Server Configuration**: Create and manage MCP server configurations-- **Toolkit Management**: Support for both simple toolkit names and detailed configurations-- **Authentication Control**: Per-toolkit auth config specification-- **Tool Filtering**: Specify allowed tools across all toolkits-- **User Instance Generation**: Generate user-specific MCP server instances--**Basic Usage:**--```python-from composio import Composio--composio = Composio()--# Create MCP server with toolkit configurations-server = composio.mcp.create(- 'personal-mcp-server',- toolkits=[- {- 'toolkit': 'github',- 'auth_config_id': 'ac_xyz',- },- {- 'toolkit': 'slack',- 'auth_config_id': 'ac_abc',- },- ],- allowed_tools=['GITHUB_CREATE_ISSUE', 'SLACK_SEND_MESSAGE'],- manually_manage_connections=False-)--# Generate server instance for a user-mcp_instance = server.generate('user_12345')-print(f"MCP URL: {mcp_instance['url']}")-```--**Simple Toolkit Usage:**--```python-# Using simple toolkit names-server = composio.mcp.create(- 'simple-mcp-server',- toolkits=['composio_search', 'text_to_pdf'],- allowed_tools=['COMPOSIO_SEARCH_DUCK_DUCK_GO_SEARCH', 'TEXT_TO_PDF_CONVERT_TEXT_TO_PDF']-)--# All tools from toolkits (default behavior)-server = composio.mcp.create(- 'all-tools-server',- toolkits=['composio_search', 'text_to_pdf']- # allowed_tools=None means all tools from these toolkits-)-```--**LangChain Integration:**--```python-import asyncio-from composio import Composio-from langchain_mcp_adapters.client import MultiServerMCPClient-from langgraph.prebuilt import create_react_agent--composio = Composio()--mcp_config = composio.mcp.create(- name="langchain-slack-mcp",- toolkits=[{"toolkit": "slack", "auth_config_id": "<auth-config-id>"}],-)--mcp_server = mcp_config.generate(user_id='<user-id>')--client = MultiServerMCPClient({- "composio": {- "url": mcp_server["url"],- "transport": "streamable_http",- }-})--async def langchain_mcp(message: str):- tools = await client.get_tools()- agent = create_react_agent("openai:gpt-4.1", tools)- response = await agent.ainvoke({"messages": message})- return response--response = asyncio.run(langchain_mcp("Show me 20 most used slack channels"))-```--### **Added: Experimental ToolRouter**--**Core ToolRouter Features:**-- **Session Management**: Create isolated tool routing sessions for users-- **Toolkit Configuration**: Support for both simple toolkit names and detailed configurations-- **Session Isolation**: Each session gets its own MCP URL and session ID-- **Flexible Authentication**: Per-session auth config management-- **Scoped Tool Access**: Control which tools are available within each session--**Basic Usage:**--```python-from composio import Composio--composio = Composio()--# Create a tool router session-session = composio.experimental.tool_router.create_session(- user_id='user_123',- toolkits=['github', 'slack'],- manually_manage_connections=False-)--print(f"Session ID: {session['session_id']}")-print(f"MCP URL: {session['url']}")-```--**Advanced Configuration:**--```python-# Create session with detailed toolkit configurations-session = composio.experimental.tool_router.create_session(- user_id='user_456',- toolkits=[- {- 'toolkit': 'github',- 'auth_config_id': 'ac_github_123'- },- {- 'toolkit': 'slack',- 'auth_config_id': 'ac_slack_456'- }- ],- manually_manage_connections=True-)--# Minimal session (no specific toolkits)-session = composio.experimental.tool_router.create_session(- user_id='user_789'-)-```--**Integration with AI Frameworks:**--```python-import asyncio-from composio import Composio-from langchain_mcp_adapters.client import MultiServerMCPClient--composio = Composio()--# Create tool router session-session = composio.experimental.tool_router.create_session(- user_id='ai_user',- toolkits=['composio_search', 'text_to_pdf']-)--# Use with LangChain MCP client-client = MultiServerMCPClient({- "composio": {- "url": session["url"],- "transport": "streamable_http",- }-})--async def use_tool_router():- tools = await client.get_tools()- # Use tools in your AI workflow- return tools--tools = asyncio.run(use_tool_router())-```----## Migration Guide--### **TypeScript SDK: Migrating to New MCP API**--The new MCP API provides enhanced functionality and better integration patterns. Here's how to migrate from the previous MCP implementation:--#### **Before (Legacy MCP)**--```typescript-// Legacy MCP approach (still accessible via deprecated.mcp)-import { Composio } from '@composio/core';--const composio = new Composio();--// Old MCP server creation-const legacyMCP = await composio.deprecated.mcp.createServer({- name: 'my-server',- toolkits: ['github', 'gmail'],-});--// Direct URL usage-const mcpUrl = legacyMCP.url;-```--#### **After (New MCP API)**--```typescript-// New MCP API approach-import { Composio } from '@composio/core';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});--// Step 1: Create MCP configuration-const mcpConfig = await composio.mcp.create('my-server', {- toolkits: [- { toolkit: 'github', authConfigId: 'ac_github_123' },- { toolkit: 'gmail', authConfigId: 'ac_gmail_456' }- ],- allowedTools: ['GITHUB_CREATE_ISSUE', 'GMAIL_SEND_EMAIL'],- manuallyManageConnections: false,-});--// Step 2: Generate user-specific server instance-const serverInstance = await composio.mcp.generate('user_123', mcpConfig.id);-const mcpUrl = serverInstance.url;-```--#### **Key Migration Changes**--1. **Two-Step Process**:- - **Before**: Single step server creation- - **After**: Create configuration, then generate user instances--2. **Enhanced Configuration**:- - **Before**: Simple toolkit names only- - **After**: Detailed toolkit configs with auth, tool filtering, connection management--3. **User-Specific URLs**:- - **Before**: Single server URL for all users- - **After**: Unique URLs per user for better isolation--4. **Backward Compatibility**:- - **Legacy Access**: Old MCP functionality remains available via `composio.deprecated.mcp`- - **Gradual Migration**: Migrate at your own pace without breaking existing implementations--#### **Migration Benefits**--- **Better Security**: User-specific sessions with isolated access-- **Enhanced Control**: Fine-grained toolkit and tool management-- **Framework Integration**: Native support for modern AI frameworks-- **Scalability**: Better resource management and user isolation--#### **Migration Timeline**--- **Phase 1**: New MCP API available alongside legacy implementation-- **Phase 2**: Legacy MCP accessible via `deprecated.mcp` namespace-- **Phase 3**: Full deprecation (timeline to be announced)--**Recommendation**: Start new projects with the new MCP API and gradually migrate existing implementations to benefit from enhanced features and better framework integration.---## Key Benefits & Use Cases--### **Development & Testing**-- **Isolated Environments**: Test different toolkit combinations without affecting production-- **Scoped Access**: Limit tool access for security and testing purposes-- **Framework Flexibility**: Works with any MCP-compatible client or framework--### **Production Workflows**-- **Multi-Service Integration**: Seamlessly combine tools from different services-- **User-Specific Sessions**: Each user gets their own isolated session with appropriate permissions-- **Authentication Management**: Fine-grained control over authentication per toolkit--### **Framework Compatibility**-- **Vercel AI**: Native integration with Vercel AI SDK-- **Mastra**: Full support for Mastra agents and workflows-- **OpenAI Agents**: Direct integration with OpenAI's agent framework-- **LangChain**: Complete LangGraph and LangChain compatibility-- **Custom Clients**: Works with any MCP-compatible client--### **Enterprise Features**-- **Session Management**: Track and manage multiple user sessions-- **Resource Control**: Limit concurrent sessions and resource usage-- **Audit Trail**: Full logging and monitoring of tool usage-- **Security**: Isolated sessions prevent cross-user data access---## Migration & Compatibility--Both MCP and ToolRouter features are designed to complement existing Composio functionality:--```typescript-// Can be used alongside regular tool management-const regularTools = await composio.tools.get({ toolkits: ['github'] });-const mcpSession = await composio.experimental.toolRouter.createSession(userId, {- toolkits: ['gmail', 'slack']-});--// Both approaches can coexist and serve different purposes-```--The experimental ToolRouter API provides a preview of advanced session management capabilities, while the MCP API offers production-ready Model Control Protocol support for modern AI frameworks.----## Bug Fixes--### **Fixed: ToolRouter Dependency Issue**--**Python SDK (v0.8.19)**--**Issue Fixed:**-- **ToolRouter Functionality**: Fixed ToolRouter tests that were failing due to missing `tool_router` attribute in HttpClient-- **Dependency Update**: Updated `composio-client` dependency from version 1.9.1 to 1.10.0+ to include ToolRouter functionality-- **Version Compatibility**: Resolved compatibility issues between ToolRouter implementation and client library--**Details:**-ToolRouter functionality was briefly broken in versions 0.8.15 to 0.8.18 due to a dependency version mismatch. The `composio-client` library version 1.9.1 did not include the `tool_router` attribute, causing all ToolRouter integration tests to fail with `AttributeError: 'HttpClient' object has no attribute 'tool_router'`.--This has been fixed in version 0.8.19 by:-- Updating the `composio-client` dependency to version 1.10.0+-- Ensuring all ToolRouter functionality is now available-- All ToolRouter integration tests now pass successfully--**Previous Issue:**-```python-# This would fail in versions 0.8.15-0.8.18-session = composio.experimental.tool_router.create_session(user_id='test')-# AttributeError: 'HttpClient' object has no attribute 'tool_router'-```--**Fixed in 0.8.19:**-```python-# This now works correctly-session = composio.experimental.tool_router.create_session(user_id='test')-# Returns: {'session_id': '...', 'url': '...'}-```--### **Fixed: Missing Descriptions in Auth Config Fields**--**Python SDK (v0.8.17) & TypeScript SDK (v0.1.53)**--**Issue Fixed:**-- **Auth Config Connection Fields**: Added missing descriptions to toolkit auth configuration connection fields-- **Auth Config Creation Fields**: Added missing descriptions to toolkit auth configuration creation fields-- **Field Documentation**: Improved field documentation and help text for better developer experience--**Details:**-Previously, when developers were setting up auth configurations for toolkits, many fields lacked proper descriptions, making it difficult to understand what information was required. This fix ensures all auth config fields now include:--- Clear, descriptive field labels-- Helpful placeholder text where appropriate-- Detailed explanations of field requirements--This improvement affects all toolkits and makes the authentication setup process more intuitive and error-free.diff --git a/fern/pages/src/changelog/10-22-25.md b/fern/pages/src/changelog/10-22-25.mddeleted file mode 100644index 70a5de808..000000000--- a/fern/pages/src/changelog/10-22-25.md+++ /dev/null@@ -1,48 +0,0 @@-## Adds Version Checks for Tool Execution and Improved Execution Speed in TS SDK--### Summary-Added version validation for manual tool execution to prevent unexpected behavior when using `latest` toolkit versions. This ensures users explicitly specify toolkit versions when executing tools manually, while allowing flexibility through a skip flag.--This release also eliminates a lot of redundant API calls made to check connected account during tool execution, effectively increasing the performance of tool execution.--### Key Changes--#### Python SDK (`python/`)-- ✅ Added `ToolVersionRequiredError` exception with detailed error messages and fix suggestions-- ✅ Added `dangerously_skip_version_check` parameter to `execute()` method-- ✅ Modified `_execute_tool()` to validate version is not `latest` unless skip flag is set-- ✅ Automatically passes `dangerously_skip_version_check=True` for agentic provider flows-- ✅ Added comprehensive test coverage (19 test methods) in `test_tool_execution.py`--#### TypeScript SDK (`ts/packages/core/`)-- ✅ Added `ComposioToolVersionRequiredError` error class with possible fixes-- ✅ Added `dangerouslySkipVersionCheck` parameter to execute flow-- ✅ Modified tool execution to validate version before API calls-- ✅ Updated execution type definitions in `tool.types.ts` and `modifiers.types.ts`-- ✅ Updated test files with date-based version format (`20251201_xx`)-- ✅ Improved tool execution by eliminating redundant API calls--### Behavior-**Before:** Tools could be executed with `latest` version, risking unexpected behavior on toolkit updates--**After:** Manual execution requires specific version or explicit skip flag:-```python-# ❌ Raises ToolVersionRequiredError-tools.execute("GITHUB_CREATE_ISSUE", {...})--# ✅ Works - explicit version-tools.execute("GITHUB_CREATE_ISSUE", {...}, version="20251201_01")--# ✅ Works - configured toolkit versions-tools = Tools(client, provider, toolkit_versions={"github": "20251201_01"})--# ✅ Works - with skip flag (use cautiously)-tools.execute("GITHUB_CREATE_ISSUE", {...}, dangerously_skip_version_check=True)-```--### Breaking Changes-⚠️ Manual tool execution without version specification now throws an error. Users must either:-1. Pass explicit version parameter-2. Configure toolkit versions in SDK initialization-3. Set environment variable `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_SLUG>`-4. Use `dangerously_skip_version_check=True` flag\ No newline at end of filediff --git a/fern/pages/src/changelog/11-05-25.md b/fern/pages/src/changelog/11-05-25.mddeleted file mode 100644index 47755cc5c..000000000--- a/fern/pages/src/changelog/11-05-25.md+++ /dev/null@@ -1,57 +0,0 @@-# Enhanced MCP URL Security Requirements--We're introducing improved security requirements for Model Context Protocol (MCP) URLs to ensure better isolation between user connections and prevent unauthorized access.--## What's Changing?--Starting today, **all new Composio projects** must include at least one of the following parameters in their MCP URLs:-- `user_id` - Identifies the specific user-- `connected_account_id` - Identifies the specific connected account--## Why This Matters--This change ensures that:-- **User Isolation**: Each user's connections remain completely separate from others-- **Enhanced Security**: Prevents potential cross-user data access scenarios-- **Better Multi-Tenancy**: Enables safer multi-tenant application architectures-- **Explicit Access Control**: Forces developers to explicitly specify which user or account context they're operating in--## Impact on Existing Projects--**For existing projects**: We understand the importance of backward compatibility. While we've sent email notifications to project owners about upgrading their MCP URLs, your existing integrations will continue to work until **January 15th, 2026**.--**Important**: After January 15th, 2026, MCP URLs without `user_id` or `connected_account_id` query parameters will no longer be supported. Please ensure you update your MCP URLs before this date to avoid service disruption.--**Note**: If your MCP URLs already include either `user_id` or `connected_account_id` query parameters, no action is required—you can safely ignore this notice.--## Implementation Example--**Before:**-```-https://platform.composio.dev/v3/mcp/{id}-```--**After (with user_id):**-```-https://platform.composio.dev/v3/mcp/{id}?user_id=user_123-```--**After (with connected_account_id):**-```-https://platform.composio.dev/v3/mcp/{id}?connected_account_id=ca_xyz-```--## Migration Guide--If you're using an existing project and want to adopt this security enhancement:--1. Review your current MCP URL configuration-2. Add either `user_id` or `connected_account_id` parameter to your URLs-3. Update your application code to pass the appropriate identifier-4. Test the updated URLs in your development environment--For more details on choosing the right user identifiers for your application, see our [User Management documentation](https://docs.composio.dev/docs/user-management).--## Questions?--If you have any questions about this security enhancement or need assistance with migration, please reach out to our support team or check our [MCP documentation](#).\ No newline at end of filediff --git a/fern/pages/src/changelog/11-10-25.md b/fern/pages/src/changelog/11-10-25.mddeleted file mode 100644index 5abff2423..000000000--- a/fern/pages/src/changelog/11-10-25.md+++ /dev/null@@ -1,125 +0,0 @@-# Toolkit Version Support for Triggers--### Summary-Added toolkit version support to trigger operations (`create` and `getType`) in both Python and TypeScript SDKs. This allows users to explicitly specify which toolkit version to use when creating trigger instances and retrieving trigger type information, ensuring consistent behavior across different toolkit versions.--Trigger operations now respect the global `toolkitVersions` configuration set during Composio initialization, providing better control over which trigger versions are used in your applications.--### Key Changes--#### TypeScript SDK (`ts/packages/core/`)-- Added `toolkit_versions` parameter to `triggers.create()` method- - Passes the global toolkit versions configuration when creating trigger instances- - Defaults to `'latest'` when no version is specified-- Modified `triggers.getType()` to respect global toolkit versions- - Now accepts toolkit version configuration to fetch trigger types for specific versions- - Improved error messages to include version-related fixes-- Updated trigger type documentation with comprehensive examples-- Added behavior documentation explaining version usage patterns--#### Python SDK (`python/composio/core/models/`)-- Added `toolkit_versions` parameter to `triggers.create()` method- - Uses global toolkit version configuration when creating trigger instances- - Converts `None` to `omit` for API compatibility-- Modified `triggers.get_type()` to respect toolkit versions- - Implemented custom method replacing direct client binding- - Passes toolkit version configuration to API calls-- Added comprehensive docstrings explaining version behavior--### Behavior--**Creating Triggers with Toolkit Versions:**--```typescript-// TypeScript - Configure versions at initialization-const composio = new Composio({- apiKey: 'your-api-key',- toolkitVersions: {- gmail: '12082025_00',- github: '10082025_01'- }-});--// Create trigger - uses version '12082025_00' for Gmail-const trigger = await composio.triggers.create('[email protected]', 'GMAIL_NEW_MESSAGE', {- connectedAccountId: 'ca_abc123',- triggerConfig: {- labelIds: 'INBOX',- userId: 'me',- interval: 60,- },-});-```--```python-# Python - Configure versions at initialization-composio = Composio(- api_key="your-api-key",- toolkit_versions={"gmail": "12082025_00", "github": "10082025_01"}-)--# Create trigger - uses version '12082025_00' for Gmail-trigger = composio.triggers.create(- slug="GMAIL_NEW_MESSAGE",- user_id="[email protected]",- trigger_config={"labelIds": "INBOX", "userId": "me", "interval": 60}-)-```--**Retrieving Trigger Types with Specific Versions:**--```typescript-// TypeScript-const composio = new Composio({- apiKey: 'your-api-key',- toolkitVersions: { github: '10082025_01' }-});--// Get trigger type for specific version-const triggerType = await composio.triggers.getType('GITHUB_COMMIT_EVENT');-// Returns trigger type for version '10082025_01'-```--```python-# Python-composio = Composio(- api_key="your-api-key",- toolkit_versions={"github": "10082025_01"}-)--# Get trigger type for specific version-trigger_type = composio.triggers.get_type("GITHUB_COMMIT_EVENT")-# Returns trigger type for version '10082025_01'-```--### Benefits--- **Version Control**: Explicitly specify which toolkit version to use for triggers-- **Consistency**: Ensure trigger behavior remains consistent across toolkit updates-- **Testing**: Test trigger integrations with specific versions before updating-- **Debugging**: Easier to debug issues by pinning to specific toolkit versions-- **Production Safety**: Avoid unexpected changes from automatic version updates--### Migration Guide--This is a **non-breaking change**. Existing code will continue to work with default behavior:--**Before (still works):**-```typescript-// Uses 'latest' version by default-const trigger = await composio.triggers.create('user', 'GITHUB_COMMIT_EVENT', {...});-```--**After (recommended for production):**-```typescript-// Explicitly configure versions for better control-const composio = new Composio({- apiKey: 'your-api-key',- toolkitVersions: { github: '10082025_01' }-});--const trigger = await composio.triggers.create('user', 'GITHUB_COMMIT_EVENT', {...});-```--For more details on toolkit versioning, see the [Toolkit Versioning documentation](/docs/toolkit-versioning).-diff --git a/fern/pages/src/changelog/11-13-25.md b/fern/pages/src/changelog/11-13-25.mddeleted file mode 100644index 92a10bea3..000000000--- a/fern/pages/src/changelog/11-13-25.md+++ /dev/null@@ -1,34 +0,0 @@-# Required API Key Authentication for MCP URLs--We're strengthening the security of Model Context Protocol (MCP) URLs by making API key authentication mandatory for all requests.--## What's Changing?--Starting **December 15th, 2025**, **all new Composio projects** must include the `x-api-key` header when making requests to MCP URLs. This header authenticates your application and ensures secure communication with the Composio platform.--## Why This Matters--This change provides:-- **Enhanced Authentication**: Ensures only authorized applications can access MCP endpoints-- **Industry Best Practices**: Aligns with standard API security patterns--## Impact on Existing Projects--**For existing projects**: We value backward compatibility and understand the need for a smooth transition. Your existing MCP URLs will continue to work without the `x-api-key` header until **April 15th, 2026**.--**Important**: After April 15th, 2026, all MCP URL requests without the `x-api-key` header will be rejected. Please ensure you update your applications before this date to avoid service disruption.--**Note**: If you're already passing the `x-api-key` header in your MCP requests, no action is required—you're all set!--## Migration Guide--To adopt this security enhancement in your existing projects:--1. **Locate Your API Key**: Find your API key in the Composio dashboard under Project Settings-2. **Update Your Code**: Add the `x-api-key` header to all MCP URL requests-3. **Test Thoroughly**: Verify the updated requests work in your development environment-4. **Deploy**: Roll out the changes to your production environment--## Questions?--If you have any questions about this security enhancement or need assistance with migration, please reach out to our support team or check our [MCP documentation](https://docs.composio.dev/docs/mcp).\ No newline at end of filediff --git a/fern/pages/src/changelog/12-03-25.md b/fern/pages/src/changelog/12-03-25.mddeleted file mode 100644index 2c45597c2..000000000--- a/fern/pages/src/changelog/12-03-25.md+++ /dev/null@@ -1,22 +0,0 @@-# Connected Account Expiration for Incomplete Connections--We're implementing automatic expiration for connected accounts that remain in incomplete states, helping maintain a cleaner and more efficient authentication system.--## What's Changing?--Connected accounts in `Initializing` and `Initiated` states will now automatically expire after **10 minutes**. This applies to connection attempts that were started but never completed.--## Why This Matters--This change provides:-- **Better Resource Management**: Automatically cleans up incomplete connection attempts-- **Improved System Hygiene**: Prevents accumulation of stale, unused connection records-- **Enhanced User Experience**: Reduces clutter from abandoned authentication flows--<Note>-This is a **non-breaking change**. Your existing integrations and completed connections will continue to work as expected. This change only affects connection attempts that are never completed.-</Note>--## Questions?--If you have any questions about this change, please reach out to our support team or check our [Connected Accounts documentation](https://docs.composio.dev/docs/connected-accounts).diff --git a/fern/pages/src/changelog/12-09-25.md b/fern/pages/src/changelog/12-09-25.mddeleted file mode 100644index 418e57282..000000000--- a/fern/pages/src/changelog/12-09-25.md+++ /dev/null@@ -1,35 +0,0 @@-# Transition to Self-Managed Credentials for Select Applications--<Note>-This is a **non-breaking change**. Your existing integrations will continue to work as expected. This change only affects new integrations with the applications listed below.-</Note>--## What's Changing?--Starting today, the following applications will require **your own developer credentials** instead of Composio-managed credentials:--- **Auth0**-- **Blackbaud**-- **BoldSign**-- **Deel**-- **Front**-- **GoToWebinar**-- **PagerDuty**-- **Pipedrive**-- **Shopify**-- **Strava**-- **SurveyMonkey**-- **Webex**--## What You Need to Do--To continue using these applications with Composio:--1. **Create Developer Accounts**: Register for developer accounts on the platforms you need-2. **Generate API Credentials**: Create OAuth apps following each platform's documentation-3. **Configure in Composio**: Add your credentials to Composio using [custom auth configs](https://docs.composio.dev/docs/custom-auth-configs)-4. **Test Your Integration**: Test your integration with the new credentials--<Note>-All other Composio applications continue to work with Composio-managed credentials. This change only affects the 12 applications listed above.-</Note>diff --git a/fern/pages/src/changelog/12-10-25-labels-deprecation.md b/fern/pages/src/changelog/12-10-25-labels-deprecation.mddeleted file mode 100644index 6905f4a41..000000000--- a/fern/pages/src/changelog/12-10-25-labels-deprecation.md+++ /dev/null@@ -1,15 +0,0 @@-# Removal of label query parameter from connected accounts API--The `label` query parameter has been removed from the `GET /api/v3/connected_accounts` endpoint.--## What's changing?--The `label` query parameter is no longer supported when listing connected accounts. This parameter was previously accepted but had no functional behavior since label ingestion was removed in an earlier update.--## Impact--**None** - This is a cleanup change. The `label` query parameter was not performing any filtering since the underlying label ingestion functionality was already removed. If your code was passing this parameter, it was being silently ignored.--## Migration--No action required. If your code was passing the `label` query parameter, you can safely remove it from your API calls.diff --git a/fern/pages/src/changelog/12-10-25-masking.md b/fern/pages/src/changelog/12-10-25-masking.mddeleted file mode 100644index 923799791..000000000--- a/fern/pages/src/changelog/12-10-25-masking.md+++ /dev/null@@ -1,22 +0,0 @@-## Enhanced Security Masking for Sensitive Fields--We've improved the security masking for `REDACTED` fields in the following APIs:--- [Get Connected Account](https://docs.composio.dev/rest-api/connected-accounts/get-connected-accounts-by-nanoid)-- [List Connected Accounts](https://docs.composio.dev/rest-api/connected-accounts/get-connected-accounts)--**What's Changed:**-Sensitive fields are now partially masked, revealing only the **first 4 characters** to help with debugging while maintaining security.--**Example:**-```-Before: REDACTED-After: abcd...-```--### Disabling Masking--If you need to disable masking for your use case, you have two options:--1. **Via UI:** Navigate to **Project Settings** → **Configuration** tab and update the masking settings-2. **Via API:** Use the [Patch Project Config API](https://docs.composio.dev/rest-api/projects/patch-org-project-config)\ No newline at end of filediff --git a/fern/pages/src/changelog/12-10-25.md b/fern/pages/src/changelog/12-10-25.mddeleted file mode 100644index 274036eca..000000000--- a/fern/pages/src/changelog/12-10-25.md+++ /dev/null@@ -1,97 +0,0 @@-# Typed Responses Across Toolkits--We've updated many toolkits so their outputs are now strongly typed objects instead of a generic `response_data` blob, meaning tools like Outlook, HubSpot, Notion, etc. now return well-shaped, documented fields you can rely on directly in your code and agents. These improvements apply to the latest toolkit versions—see our [toolkit versioning docs](https://docs.composio.dev/docs/toolkit-versioning) for how versions are managed.--<Callout intent="warn">-**Breaking Change for `latest` Version**--If you're using the `latest` version and your code post-processes the old `response_data` structure, you'll need to update your code to work with the new flattened, typed response schemas.-</Callout>--## Why This Matters-- Better developer experience for direct execute: clear fields and types-- Improved agent performance: flatter output shapes with explicit fields reduce nesting and invalid params-- Clearer docs and type safety: richer metadata for IDEs and autocomplete--<Accordion title="Impacted Toolkits (57 total)">--### Communication & Collaboration-discordbot, microsoft_teams, slack, zoom--### CRM & Sales-apollo, attio, hubspot, instantly, intercom, kommo, salesforce--### Productivity & Docs-coda, confluence, googledocs, googletasks, notion, todoist--### Marketing & Social Media-facebook, instagram, klaviyo, linkedin, metaads, reddit, tiktok--### E-commerce & Payments-brex, quickbooks, ramp, shopify, square, stripe, xero--### Project Management-clickup, linear--### Design & Creative-canva, figma--### Data & Analytics-ahrefs, airtable, apify, exa, pplx, serpapi, tavily--### Email & Calendar-calendly, outlook--### Storage & Files-one_drive--### Web Tools-firecrawl, fireflies, google_maps, google_search_console--### AI & Media-elevenlabs, heygen, lmnt, mem0--### Customer Support-freshdesk, zendesk--### Video & Content-youtube--</Accordion>--## Before vs After-**Previous (generic, version `20251202_00`):**-```json-{- "data": {- "response_data": { "...": "..." }- },- "successful": true-}-```--**Now (typed example – Outlook List Messages, version `20251209_00`):**-```json-{- "data": {- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/messages",- "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?$skip=10",- "value": [- {- "id": "abc123",- "subject": "Hi there",- "from": { "emailAddress": { "address": "[email protected]", "name": "Alice" } },- "hasAttachments": true- }- ]- },- "successful": true-}-```--For the exact field mapping per toolkit, open `platform.composio.dev` → Toolkits → List Messages (or the relevant tool).--## Migration Notes-- Breaking change for consumers on the `latest` version who post-process the old nested `response_data` shape: outputs are now flattened and explicitly typed.-- New and modified fields include richer descriptions and examples; some legacy placeholders were removed.-- Re-fetch schemas for your tool/version to see the typed definitions. Use the toolkit view in `platform.composio.dev` for authoritative field details.\ No newline at end of filediff --git a/fern/pages/src/changelog/12-15-25.md b/fern/pages/src/changelog/12-15-25.mddeleted file mode 100644index b59cd1fea..000000000--- a/fern/pages/src/changelog/12-15-25.md+++ /dev/null@@ -1,281 +0,0 @@-# Tool Router is Generally Available in TS and PY SDKs--**Release Date:** December 15, 2025-**Python SDK Version:** 0.10.1-**TypeScript SDK Version:** 0.3.0--## Major Features Added--### 1. Tool Router - Stable Release-**Status:** Moved from experimental to stable production feature--The Tool Router is now a fully supported feature that enables creating isolated MCP (Model Context Protocol) sessions for users with scoped access to toolkits and tools.--**Key Capabilities:**-- Create isolated sessions with specific toolkit configurations-- Manage authentication flows for users across multiple toolkits-- Access tools via MCP-compatible server URL-- Query toolkit connection states-- Integrate with multiple AI frameworks (OpenAI, Anthropic, LangChain, LlamaIndex, CrewAI, Vercel AI SDK)--**Changes:**-- Removed experimental warnings and deprecated MCP functionality-- Updated all examples and documentation to reflect stable API-- Both Python and TypeScript SDKs now have full Tool Router support--**Files Modified:**-- `python/composio/core/models/tool_router.py` - Major refactoring-- `ts/packages/core/src/models/ToolRouter.ts` - Enhanced implementation-- All tool router examples updated across both SDKs--### 2. Native Tool Execution Support for Tool Router--**Python SDK:**-- Added native tool execution capabilities directly through Tool Router sessions-- Enhanced `ToolRouterSession` with improved tool execution methods-- Better integration with provider-wrapped tools--**TypeScript SDK:**-- Added native tool support for Tool Router sessions-- Improved type safety and error handling-- Enhanced `session.tools()` method for framework-specific tool objects--**Impact:**-- Users can now execute tools directly through Tool Router sessions without additional setup-- Improved performance and reduced complexity-- Better error handling and debugging capabilities--### 3. Webhook Verification Feature--**New Method:** `composio.triggers.verifyWebhook()`--Added comprehensive webhook verification functionality for secure webhook handling:--**Python SDK:**-- New `verify_webhook()` method in `Triggers` class-- Support for signature verification-- Enhanced error handling with new exception types--**TypeScript SDK:**-- New `verifyWebhook()` method in `Triggers` class-- Type-safe webhook verification-- Comprehensive test coverage (592+ test cases)--**Use Cases:**-- Secure webhook endpoint validation-- Signature verification for incoming webhooks-- Enhanced security for trigger-based workflows--### 4. LangChain v1 Support (Python SDK)--**Upgrade:** Ported LangChain provider to support LangChain v1--- Updated LangChain provider to work with LangChain v1 APIs-- Improved compatibility and performance-- Updated dependencies and examples--**Files Modified:**-- `python/providers/langchain/` - Complete v1 port-- Updated demo scripts and documentation--### 5. CommonJS Support Fixes (TypeScript SDK)--**Major Fix:** Fixed CommonJS usage of `@composio/core`--**Changes:**-- Switched bundler from `tsup` to `tsdown` for better CommonJS compatibility-- Added new CommonJS example (`ts/examples/cjs/`)-- Fixed compatibility issues with Node.js CommonJS environments-- Updated package configuration and build process--**Impact:**-- Better support for Node.js projects using CommonJS-- Improved compatibility with various build tools-- Enhanced developer experience---## Improvements & Enhancements--### TypeScript SDK Improvements--1. **Type Safety Enhancements**- - Fixed Parameters type in `@composio/ts-builders` package- - Improved type inference for Tool Router sessions- - Enhanced error type definitions--2. **Error Handling**- - Added `options` parameter to `ComposioMultipleConnectedAccountsError` constructor- - Fixed typo in deprecate decorator error message- - Standardized error codes (using `SDKErrorCodes.NO_API_KEY_PROVIDED`)--3. **Telemetry Improvements**- - Fixed telemetry duration calculation (now calculated after method execution)- - Improved performance tracking accuracy--4. **Dependency Updates**- - Updated `zod-to-json-schema` to 3.25.0 (supports zod/3)- - Removed package override in `.pnpmfile.cjs`- - Fixed version range for zod peerDependency--### Python SDK Improvements--1. **Bug Fixes**- - Fixed KeyError: 'type' when SUPABASE_BETA_RUN_SQL_QUERY is used with Agents- - Fixed typo in `auth_scheme.status` property- - Improved error handling and validation--2. **Documentation**- - Added changelog entries for new features- - Updated examples and usage guides- - Improved API documentation--3. **Testing**- - Added comprehensive tests for Tool Router functionality- - Enhanced test coverage for connected accounts- - Improved test reliability--## Removed Features & Deprecations--### Removed Features--1. **Deprecated MCP Functionality**- - Removed deprecated MCP methods and classes- - Cleaned up experimental MCP code- - Simplified API surface---## Security & Quality Improvements--1. **Security Audits**- - Added `pnpm audit --prod` checks- - Automated security vulnerability scanning- - Improved dependency management--2. **Code Quality**- - Enhanced linting and type checking- - Improved test coverage- - Better error handling--3. **Documentation Security**- - Added webhook verification documentation- - Improved security best practices guides- - Enhanced API security documentation---## Migration Guide--### For Tool Router Users--If you were using the experimental Tool Router API:--**Before (Experimental):**-```python-# Old experimental API-composio.experimental.tool_router.create(...)-```--**After (Stable):**-```python-# New stable API-composio.create(...)-```--### For CommonJS Users (TypeScript)--The CommonJS support has been significantly improved. If you were experiencing issues:--1. Update to latest version: `@composio/[email protected]`-2. Check the new CommonJS example: `ts/examples/cjs/`-3. No code changes required - improved compatibility out of the box--### For LangChain Users (Python)--If you're using the LangChain provider:--1. Update to LangChain v1-2. Update Composio SDK to latest version-3. Check updated examples in `python/providers/langchain/`---## Bug Fixes--### Python SDK-- Fixed KeyError when using SUPABASE_BETA_RUN_SQL_QUERY with Agents-- Fixed typo in `auth_scheme.status` property-- Improved error handling for connected accounts-- Fixed array parsing in JSON schema conversion--### TypeScript SDK-- Fixed CommonJS compatibility issues-- Fixed Parameters type in ts-builders-- Fixed telemetry duration calculation-- Fixed error message typos-- Improved error handling for multiple connected accounts---## Package Updates--### Python Packages-- All provider packages updated to v0.10.0-- Core SDK: `composio==0.10.0`-- LangChain provider: Updated for v1 compatibility--### TypeScript Packages-- Core SDK: `@composio/[email protected]`-- All provider packages updated-- Dependencies updated for better compatibility---## Next Steps--### Recommended Actions--1. **Update Dependencies**- ```bash- # Python- pip install --upgrade composio-- # TypeScript- npm install @composio/core@latest- ```--2. **Review Breaking Changes**- - Tool Router API changes (experimental → stable)- - Removed deprecated MCP methods- - Updated LangChain provider requirements--3. **Test Your Integration**- - Run your test suites- - Verify Tool Router functionality- - Check webhook verification if applicable--4. **Update Documentation**- - Review API changes- - Update code examples- - Check migration guides--## Contributors--Thank you to all contributors who made this release possible:--- Musthaq Ahamad (@haxzie)-- Alberto Schiabel (@jkomyno)-- Sushmitha Mallesh (@Sushmithamallesh)--## Resources--- **Documentation:** https://docs.composio.dev-- **GitHub Repository:** https://github.com/composiohq/composio-- **Issue Tracker:** https://github.com/composiohq/composio/issues---## Notes--- This is a major release with significant new features and improvements-- Tool Router is now production-ready and recommended for all new projects-- Python SDK is approaching v0.10.0 stable release-- TypeScript SDK continues to improve with better CommonJS support-- All changes are backward compatible where possible, with clear migration paths--**For questions or support, please reach out through our GitHub issues or Support channels.**-diff --git a/fern/pages/src/changelog/12-16-25.md b/fern/pages/src/changelog/12-16-25.mddeleted file mode 100644index a73792668..000000000--- a/fern/pages/src/changelog/12-16-25.md+++ /dev/null@@ -1,59 +0,0 @@-# Deprecation of `is_local_toolkit` Field and Removal of `is_local` Query Parameter--We're cleaning up the Toolkits API by deprecating the `is_local_toolkit` response field and removing the `is_local` query parameter filter.--## What's Changing?--### Response Field: `is_local_toolkit` (Deprecated)--The `is_local_toolkit` field in toolkit API responses is now **deprecated**. This field was originally intended to indicate whether a toolkit was local to a specific project, but it is no longer meaningful as no toolkits use this classification.--**Affected Endpoints:**-- `GET /api/v3/toolkits` - List toolkits-- `GET /api/v3/toolkits/{slug}` - Get single toolkit-- `GET /api/v3/toolkits/multi` - Get multiple toolkits--The field will continue to be returned in API responses for backward compatibility, but it will always return `false`. It is marked as `deprecated: true` in the OpenAPI specification.--### Query Parameter: `is_local` (Removed)--The `is_local` query parameter filter has been **removed** from the following endpoints:-- `GET /api/v3/toolkits`-- `GET /api/v3/toolkits/multi`--This parameter was used to filter toolkits by their local status, but since no toolkits are classified as local, it served no practical purpose.--## Impact on Your Code--### If You're Using the `is_local` Query Parameter--**Before:**-```typescript-// This will no longer work-const toolkits = await fetch('/api/v3/toolkits?is_local=true');-```--**After:**-```typescript-// Simply remove the is_local parameter-const toolkits = await fetch('/api/v3/toolkits');-```--### If You're Reading the `is_local_toolkit` Response Field--The field will continue to be present in responses but will always return `false`. You can safely ignore this field or remove any logic that depends on it.--**Before:**-```typescript-const toolkit = await composio.toolkits.get('github');-if (toolkit.is_local_toolkit) {- // This condition will never be true- handleLocalToolkit(toolkit);-}-```--**After:**-```typescript-const toolkit = await composio.toolkits.get('github');-// Remove is_local_toolkit checks - they're no longer meaningful-```diff --git a/fern/pages/src/changelog/12-19-25.md b/fern/pages/src/changelog/12-19-25.mddeleted file mode 100644index e1f7be86c..000000000--- a/fern/pages/src/changelog/12-19-25.md+++ /dev/null@@ -1,54 +0,0 @@-# Toolkit Deprecation: Streamlining Our Platform--## What's Changed--We're deprecating **60 toolkits** that currently have no supported actions. These toolkits will be reactivated once we add functional actions to them, ensuring you only see integrations that are ready to use.--## Deprecated Toolkits--The following toolkits are now deprecated:--- `ACCELO`, `ADOBE`, `AERO_WORKFLOW`, `AMAZON`, `APEX27`-- `APPOINTO`, `APPSFLYER`, `ATLASSIAN`, `AUTH0`, `AXONAUT`-- `BATTLENET`, `BOLDSIGN`, `BRAINTREE`, `BREEZY_HR`, `BREX_STAGING`-- `BRIGHTPEARL`, `BROWSERHUB`, `CUSTOMER_IO`, `DEEL`, `DRIP_JOBS`-- `EPIC_GAMES`, `FACTORIAL`, `FITBIT`, `FRONT`, `GO_TO_WEBINAR`-- `GURU`, `HELCIM`, `HIGHLEVEL`, `ICIMS_TALENT_CLOUD`, `IDEA_SCALE`-- `KEAP`, `LASTPASS`, `LEVER_SANDBOX`, `LEXOFFICE`, `MANY_CHAT`-- `MBOUM`, `MICROSOFT_TENANT`, `MOXIE`, `ONCEHUB`, `POPTIN`-- `PRECORO`, `PRINTNODE`, `QUALAROO`, `RAVENSEOTOOLS`, `RING_CENTRAL`-- `RIPPLING`, `SAGE`, `SALESFORCE_MARKETING_CLOUD`, `SEISMIC`, `SMARTRECRUITERS`-- `TAPFORM`, `TERMINUS`, `TIMEKIT`, `TWITCH`, `VENLY`-- `VERO`, `VISME`, `WAVE_ACCOUNTING`, `WIZ`, `ZOHO_DESK`--## Impact on Your Integration--### API Behavior Changes--**List Toolkits Endpoint**--The [GET /toolkits](https://docs.composio.dev/rest-api/toolkits/get-toolkits) endpoint will now exclude deprecated toolkits by default.--**Need to see deprecated toolkits?** Use the new `include_deprecated` query parameter.--### Backward Compatibility--**Your existing integrations are safe.** All other endpoints continue to work with deprecated toolkits:--- ✅ Retrieve the toolkit details-- ✅ Create auth configurations-- ✅ Manage connected accounts-- ✅ Configure MCP Servers--This ensures zero breaking changes to your current implementations.--## Why This Matters--This change helps you:-- **Focus on working integrations** - No clutter from non-functional toolkits-- **Avoid integration attempts** with toolkits that have no actions-- **Better developer experience** with a cleaner, more actionable toolkit list--## Questions?--If you have questions or need support with any deprecated toolkit, reach out to our team or check our [documentation](https://docs.composio.dev).\ No newline at end of filediff --git a/fern/pages/src/changelog/12-22-25.md b/fern/pages/src/changelog/12-22-25.mddeleted file mode 100644index eba98c602..000000000--- a/fern/pages/src/changelog/12-22-25.md+++ /dev/null@@ -1,45 +0,0 @@-# Toolkit Deprecation: Removing Empty Toolkits--## What's Changed--We're deprecating **15 toolkits** that currently have no supported actions. These toolkits will be reactivated once we add functional actions to them, ensuring you only see integrations that are ready to use.--## Deprecated Toolkits--The following toolkits are now deprecated:--- `BREATHEHR`, `DIXA`, `EGNYTE`, `EXPENSIFY`, `FREEAGENT`-- `GUSTO`, `NUTSHELL`, `OPENNUTRITION`, `OYSTERHR`, `RAKUTEN`-- `SALESFLARE`, `TEAMLEADER`, `WALGREENS`, `WHOOP`, `WIX`--## Impact on Your Integration--### API Behavior Changes--**List Toolkits Endpoint**--The [GET /toolkits](https://docs.composio.dev/rest-api/toolkits/get-toolkits) endpoint will now exclude deprecated toolkits by default.--**Need to see deprecated toolkits?** Use the `include_deprecated` query parameter.--### Backward Compatibility--**Your existing integrations are safe.** All other endpoints continue to work with deprecated toolkits:--- Retrieve the toolkit details-- Create auth configurations-- Manage connected accounts-- Configure MCP Servers--This ensures zero breaking changes to your current implementations.--## Why This Matters--This change helps you:-- **Focus on working integrations** - No clutter from non-functional toolkits-- **Avoid integration attempts** with toolkits that have no actions-- **Better developer experience** with a cleaner, more actionable toolkit list--## Questions?--If you have questions or need support with any deprecated toolkit, reach out to our team or check our [documentation](https://docs.composio.dev).diff --git a/fern/pages/src/changelog/12-26-25.md b/fern/pages/src/changelog/12-26-25.mddeleted file mode 100644index aa18dd6df..000000000--- a/fern/pages/src/changelog/12-26-25.md+++ /dev/null@@ -1,89 +0,0 @@-# Authentication Updates Across Multiple Toolkits--We've updated authentication configurations for several toolkits to improve security, fix issues, and support additional deployment options.--## Summary--| Toolkit | Change Type | Action Required |-|-------------|-------------|-----------------|-| Ashby | Deprecated | No |-| Freshdesk | Deprecated | No |-| Freshservice | Deprecated | No |-| Make | Breaking | New auth config + user reconnect |-| Mixpanel | Fix | No |-| Recall AI | Breaking | New auth config + user reconnect |-| Relevance AI | Breaking | New auth config + user reconnect |-| SmartRecruiters | Breaking | New auth config + user reconnect |-| Supabase | Improvement | No |-| Trello | Deprecated | No |-| ZoomInfo | Deprecated | No |--## Breaking Changes--These toolkits had incorrect or outdated authentication configurations that needed fixing. We verified that active usage for these toolkits is practically zero before proceeding with these changes.--**Impact**: Existing connections will stop working. You'll need to create new auth configs and ask affected users to reconnect.--### Make--Replaced region-based configuration with full base URL input. Users now provide the complete Make instance URL (e.g., `https://us2.make.com` or `https://us1.make.celonis.com`) instead of just a region code.--### Recall AI--Updated from region-based to full base URL configuration. Fixed field descriptions and metadata. Updated categories to AI/Productivity/Communication and added proper documentation links.--### Relevance AI--Simplified authentication by removing deprecated Project ID field. Added conditional mapping for region codes to API subdomains (AU→f1db6c, EU→d7b62b, US→bcbe5a). Region field now defaults to US.--### SmartRecruiters--Fixed OAuth configuration with correct SmartRecruiters endpoints. Added proper default scopes for candidates, jobs, and users. Enabled PKCE and added refresh token support.--## Deprecated (Still Working)--These changes introduce new auth methods while keeping old ones functional:--### Ashby--Added new API Key authentication scheme with automatic base64 encoding and proper authorization headers.--**No Action Required**: Old Basic Auth method is deprecated but continues to work. Existing connections are unaffected.--### Freshdesk--Added new API Key authentication scheme requiring subdomain and API key with automatic base64 encoding.--**No Action Required**: Old Basic Auth method is deprecated but continues to work. Existing connections are unaffected.--### Freshservice--Added new API Key authentication scheme requiring subdomain and API key with automatic base64 encoding.--**No Action Required**: Old Basic Auth method is deprecated but continues to work. Existing connections are unaffected.--### Trello--Marked Bearer Token authentication as deprecated in favor of OAuth authentication.--**No Action Required**: Old Bearer auth continues to function. OAuth is recommended for new connections.--### ZoomInfo--Added new OAuth2 authentication scheme with comprehensive scopes for contacts, companies, audiences, scoops, news, and intent data. Deprecated the old JWT-based Basic authentication. Password field now properly marked as secret.--**No Action Required**: Old JWT auth continues to function. New connections will use OAuth2.--## Non-Breaking Improvements--### Mixpanel--Fixed region mapping logic for data residency. Added proper conditional evaluation to map regions to correct API hosts (EU, India, or Standard). Region field is now optional and defaults to Standard server. Service account secret now properly marked as secret.--**No Action Required**: Existing connections continue to work without changes.--### Supabase--Changed `base_url` field type from `auth_config_field` to `connection_field` for both OAuth and API Key schemes. Updated base action logic to respect user-provided base URLs, enabling support for self-hosted Supabase instances.--**No Action Required**: Existing connections continue to work. Self-hosted instances now supported.\ No newline at end of filediff --git a/fern/pages/src/changelog/12-29-25.md b/fern/pages/src/changelog/12-29-25.mddeleted file mode 100644index 4ecd94552..000000000--- a/fern/pages/src/changelog/12-29-25.md+++ /dev/null@@ -1,108 +0,0 @@-# Authentication & Configuration Updates Across Multiple Toolkits--## Summary--This release includes significant authentication and configuration improvements across 16+ toolkits. The changes standardize Base URL handling, modernize authentication methods, and fix various endpoint configurations to improve reliability and flexibility.--| Toolkit | Change Type | Description |-|---------|-------------|-------------|-| **Make** | Breaking | Removed Region field, replaced with Base URL |-| **Linear** | Improvement | Base URL is no longer configurable |-| **Kibana** | Improvement | Removed default value for Base URL |-| **Insightly** | Fix | Added default value for Pod field |-| **HelloBar** | Deprecated | Deprecated bearer authentication |-| **Gong** | Fix | Added default value for Base URL |-| **FormSite** | Deprecated | Deprecated bearer auth, added API key authentication |-| **DataScope** | Fix | Fixed Get Current User Endpoint |-| **D2L Brightspace** | Fix | Updated Get Current User Endpoint |-| **ClickUp** | Fix | Changed Base URL field type |-| **Bubble** | Breaking | Fixed Base URL field, removed Subdomain |-| **Brilliant Directories** | Fix | Implemented dynamic Base URL for user endpoint |-| **Braintree** | Improvement | Updated to production defaults with dynamic endpoints |-| **Auth0** | Improvement | Replaced hardcoded endpoint with dynamic tenant Base URL |--## Breaking Changes--We verified that active usage for these toolkits is practically zero before proceeding with these changes.--### Make Toolkit-- **Removed Region field** in favor of explicit Base URL configuration-- Users must now provide the full Base URL instead of selecting a region-- This change provides more flexibility for custom deployments and regional endpoints--### Bubble Toolkit-- **Removed Subdomain field** and restructured Base URL handling-- Users must now provide the complete Base URL instead of just the Subdomain-- This change standardizes URL configuration across all toolkits--## Deprecated Features--### HelloBar Toolkit-- **Bearer authentication is now deprecated**-- While still functional, users are encouraged to migrate to newer authentication methods-- Support for bearer tokens will be removed in a future release--### FormSite Toolkit-- **Bearer authentication deprecated** in favor of API key authentication-- New integrations should use API key authentication for improved security-- Existing bearer token implementations will continue to work but should be migrated--## Improvements & Fixes--### Configuration Improvements--#### Linear Toolkit-- Base URL is no longer a configurable field-- The toolkit now uses a fixed endpoint, simplifying the authentication process--#### Kibana Toolkit-- Removed the default value for Base URL, allowing for more flexible deployment configurations-- Users can now specify custom Kibana instances without overriding defaults--#### Gong Toolkit-- Added a sensible default value for Base URL to simplify initial setup-- New users can connect without manually configuring the endpoint--#### Insightly Toolkit-- Added default value for the Pod field to streamline configuration-- Reduces setup complexity for standard deployments--#### ClickUp Toolkit-- Fixed the Base URL field type for proper validation and handling-- Ensures consistent URL formatting across all operations--### Dynamic Endpoint Updates--#### Brilliant Directories Toolkit-- Implemented dynamic Base URL resolution for the Get Current User Endpoint-- Automatically adapts to different deployment environments--#### Braintree Toolkit-- Updated configuration to use production defaults-- Implemented dynamic endpoint resolution for better environment handling-- Improved reliability for production deployments--#### Auth0 Toolkit-- Replaced hardcoded endpoints with dynamic tenant-based URL resolution-- Supports multi-tenant deployments without manual configuration-- Automatically constructs the correct endpoint based on the tenant configuration--### Endpoint Fixes--#### DataScope Toolkit-- Fixed the Get Current User Endpoint to use the correct API path-- Resolves authentication verification issues--#### D2L Brightspace Toolkit-- Updated the Get Current User Endpoint to match the latest API specifications-- Ensures proper user identification and session validation--## Migration Guide--For toolkits with breaking changes, please update your configurations as follows:--1. **Make**: Replace Region with the full Base URL (e.g., `https://us-east-1.make.com`)-2. **Bubble**: Replace Subdomain with the full Base URL (e.g., `https://myapp.bubbleapps.io`)--For deprecated authentication methods:-- **HelloBar & FormSite**: Generate new API keys from your account settings and update your authentication configurationdiff --git a/fern/pages/src/changelog/12-30-25-proxy-binary-data.md b/fern/pages/src/changelog/12-30-25-proxy-binary-data.mddeleted file mode 100644index 837eb02b0..000000000--- a/fern/pages/src/changelog/12-30-25-proxy-binary-data.md+++ /dev/null@@ -1,88 +0,0 @@-## Binary Data Support for Proxy Execute--The `/api/v3/tools/execute/proxy` endpoint now supports binary data for both file uploads and downloads.--### File Uploads (`binary_body`)--To upload a file via the proxy, use the `binary_body` field in your request payload. This supports two approaches: specifying either a URL pointing to the file or providing the base64-encoded content directly.--#### Upload File via URL--```bash-curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \- --header 'accept: application/json' \- --header 'x-api-key: <YOUR_API_KEY>' \- --header 'Content-Type: application/json' \- --data '{- "endpoint": "/upload-endpoint",- "method": "POST",- "connected_account_id": "<CONNECTED_ACCOUNT_ID>",- "binary_body": {- "url": "{URL_TO_THE_FILE}"- }- }'-```--#### Upload File via Base64 Content--Supported up to 4MB file size.--```bash-curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \- --header 'accept: application/json' \- --header 'x-api-key: <YOUR_API_KEY>' \- --header 'Content-Type: application/json' \- --data '{- "endpoint": "/upload-endpoint",- "method": "POST",- "connected_account_id": "<CONNECTED_ACCOUNT_ID>",- "binary_body": {- "base64": "JVBERi0xLjQKJ...<base64_data>...",- "content_type": "application/pdf"- }- }'-```--### File Downloads (`binary_data`)--When the proxied request returns a binary response (for example, a PDF or image), the proxy automatically uploads the file to temporary storage, and you receive a signed URL in the `binary_data` field. This enables you to download large files securely.--#### File Download Request--```bash-curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \- --header 'accept: application/json' \- --header 'x-api-key: <YOUR_API_KEY>' \- --header 'Content-Type: application/json' \- --data '{- "endpoint": "{YOUR_ENDPOINT}",- "method": "GET",- "connected_account_id": "{YOUR_CONNECTED_ACCOUNT_ID}"- }'-```--#### File Download Response--```json-{- "data": {},- "binary_data": {- "url": "url to the file",- "content_type": "content type of the file",- "size": "size of the file",- "expires_at": "expires at of the file"- },- "status": "status code of the response",- "headers": "headers of the response"-}-```--### Summary--| Feature | Field | Description |-|---------|-------|-------------|-| File Upload via URL | `binary_body.url` | Provide a URL pointing to the file to upload |-| File Upload via Base64 | `binary_body.base64` + `binary_body.content_type` | Provide base64-encoded content (up to 4MB) |-| File Download | `binary_data` in response | Receive a signed URL to download binary responses |--We'd love your feedback on the new proxy execute capabilities. If anything feels unclear or you have suggestions for improvement, please reach out.diff --git a/fern/pages/src/changelog/12-30-25.md b/fern/pages/src/changelog/12-30-25.mddeleted file mode 100644index 0ce34c96b..000000000--- a/fern/pages/src/changelog/12-30-25.md+++ /dev/null@@ -1,148 +0,0 @@-## Lookahead Announcement--We're introducing **Webhook Payload V3** - a redesigned webhook structure that follows industry standards and provides better developer experience. This update affects how you receive trigger events via webhooks and Pusher.--## What's Changing?--### New Webhook Structure--We're adopting the [Standard Webhooks specification](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md) for better consistency and reliability.--#### Headers-A new header will identify the webhook version:-```-x-composio-webhook-version: V3-```--#### Payload Structure-The payload structure is being reorganized to separate Composio metadata from trigger data:--**Before (V2):**-```json-{- "log_id": "log_TpxVOLXYnwXZ",- "timestamp": "2025-12-23T13:06:07.695Z",- "type": "gmail_new_gmail_message",- "data": {- "connection_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",- "connection_nano_id": "ca_xYz9AbCdEfGh",- "trigger_nano_id": "ti_JZFoTyYKbzhB",- "trigger_id": "7f8e9d0c-1b2a-3c4d-5e6f-7a8b9c0d1e2f",- "user_id": "usr-demo-12a3b4c5...",- // ... actual trigger data mixed with metadata- }-}-```--**After (V3):**-```json-{- "id": "msg_a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",- "timestamp": "2025-12-23T13:06:07.695Z",- "type": "composio.trigger.message",- "metadata": {- "log_id": "log_TpxVOLXYnwXZ",- "trigger_slug": "GMAIL_NEW_GMAIL_MESSAGE",- "auth_config_id": "ac_aCYTppZ5RsRc",- "connected_account_id": "ca_cATYssZ5RrSc",- "trigger_id": "ti_JZFoTyYKbzhB",- "user_id": "pg-test-86c9fc84..."- },- "data": {- // Clean trigger data without Composio metadata- }-}-```--### Key Improvements--1. **Metadata Separation**: Composio-specific fields (connection IDs, trigger IDs, user IDs) are now in a dedicated `metadata` object-2. **Clean Data**: The `data` field now contains only the actual trigger payload without infrastructure metadata-3. **Standardized Type Field**: The `type` field now follows a consistent format (`composio.trigger.message`) instead of trigger-specific names like `gmail_new_gmail_message`-4. **Trigger Slug in Metadata**: The trigger slug (e.g., `GMAIL_NEW_GMAIL_MESSAGE`) is now available in `metadata.trigger_slug` for easy identification-5. **Standards Compliance**: Follows Standard Webhooks specification for better interoperability-6. **Consistent Structure**: Same payload structure for both webhooks and Pusher channels--## Migration Guide--### Updating Your Webhook Handlers--If you're accessing Composio metadata fields, update your code:--```python-# Before (V2)-trigger_type = payload["type"] # "gmail_new_gmail_message"-connection_id = payload["data"]["connection_id"]-trigger_id = payload["data"]["trigger_id"]-message_text = payload["data"]["message_text"]--# After (V3)-trigger_type = payload["type"] # "composio.trigger.message"-trigger_slug = payload["metadata"]["trigger_slug"] # "GMAIL_NEW_GMAIL_MESSAGE"-connection_id = payload["metadata"]["connected_account_id"]-trigger_id = payload["metadata"]["trigger_id"]-message_text = payload["data"]["message_text"]-```--```typescript-// Before (V2)-const triggerSlug = payload.type; // "gmail_new_gmail_message"-const connectionId = payload.data.connection_id;-const triggerId = payload.data.trigger_id;-const messageText = payload.data.message_text;--// After (V3)-const webhookType = payload.type; // "composio.trigger.message"-const triggerSlug = payload.metadata.trigger_slug; // "GMAIL_NEW_GMAIL_MESSAGE"-const connectionId = payload.metadata.connected_account_id;-const triggerId = payload.metadata.trigger_id;-const messageText = payload.data.message_text;-```--### Checking Webhook Version--You can detect the webhook version from headers:--```python-webhook_version = headers.get("x-composio-webhook-version", "V2")-if webhook_version == "V3":- # Use new structure- metadata = payload["metadata"]-else:- # Use old structure- metadata = payload["data"]-```--## Rollout Timeline--- **December 2025**: V3 released, opt-in via project settings-- **February 15, 2026**: All new organizations will default to V3-- **Existing organizations**: Continue using V2 by default, can opt-in to V3 anytime--## How to Opt-In--1. Go to your project settings in the Composio dashboard-2. Navigate to the Webhooks section-3. Select "Webhook Payload Version: V3"-4. Update your webhook handlers to use the new structure-5. Test thoroughly before enabling in production--<Note>-Organizations created **before February 15, 2026** will remain on V2 by default. You can switch to V3 at your convenience.--Organizations created **on or after February 15, 2026** will use V3 by default.-</Note>--## Benefits--- **Better DX**: Clear separation between metadata and actual trigger data-- **Standards Compliance**: Follows industry-standard webhook specifications-- **Consistency**: Same structure across webhooks and Pusher channels-- **Future-Proof**: Built on established standards for long-term compatibility--## Need Help?--If you have questions about migrating to V3 or need assistance:-- Join our [Discord community](https://discord.gg/composio)-- Check our [documentation](https://docs.composio.dev)-- Contact support at [email protected]diff --git a/fern/pages/src/changelog/12-31-25.md b/fern/pages/src/changelog/12-31-25.mddeleted file mode 100644index 859606bc7..000000000--- a/fern/pages/src/changelog/12-31-25.md+++ /dev/null@@ -1,36 +0,0 @@-## Deprecating `BEARER_TOKEN` auth scheme for 19 toolkits--We’ve **deprecated** the `BEARER_TOKEN` auth scheme for the following **19 toolkits**:--- `Airtable`-- `Discord`-- `Discordbot`-- `Gmail`-- `Google Classroom`-- `Google Search Console`-- `Google Calendar`-- `Google Docs`-- `Google Drive`-- `Google Slides`-- `Google Super`-- `Instagram`-- `Ntfy`-- `Sapling AI`-- `Slack`-- `Slackbot`-- `Tawk To`-- `TikTok`-- `Twitter`--### Recommendation--For these toolkits, we recommend using **alternative auth schemes** (for example, `OAUTH2`, `API_KEY`, or other toolkit-supported schemes) instead of `BEARER_TOKEN`.--### Backward compatibility (explicit)--This change is **fully backward compatible**:--- **Existing** auth configs and connected accounts created with `BEARER_TOKEN` **will continue to function**.-- **Creating new** auth configs and connected accounts with `BEARER_TOKEN` **will continue to work** (e.g., via API/SDK).-- To discourage new usage, `BEARER_TOKEN` auth configs / connected accounts **will not be displayed in the UI** for these toolkits.-diff --git a/fern/pages/src/examples/chat_applications/vercel_chat.mdx b/fern/pages/src/examples/chat_applications/vercel_chat.mdxdeleted file mode 100644index c476bd88d..000000000--- a/fern/pages/src/examples/chat_applications/vercel_chat.mdx+++ /dev/null@@ -1,300 +0,0 @@-----title: Full Stack Chat App-subtitle: Build a chat interface where users can connect and use their own apps-image: "https://og.composio.dev/api/og?title=Full%20Stack%20Chat%20App" # image for socials-keywords: ''-hide-nav-links: false------In this example, you will learn how to build a chatbot that:--- Lets users connect their various apps to the chatbot using the Composio SDK.-- Uses the Vercel provider in the Composio SDK to handle and execute tool calls from the LLM.--This page gives a high-level overview of the Composio SDK and how it is used in the-GitHub repository: [composiohq/chat](https://github.com/composiohq/chat). You can-find the demo live [here](https://chat.composio.dev/).--## Prerequisites--Ensure you've followed the README.md in the [composiohq/chat](https://github.com/composiohq/chat)-repository to set up the project locally.--## Creating auth configs--For all the apps you want to connect to the chatbot, you need to create their-respective auth configs. Learn how to create auth configs [here](/docs/authenticating-tools#creating-an-auth-config).-Once done, your auth configs will be available in the [Composio dashboard](https://app.composio.dev/integrations).--<Frame>- <img src="../../../../assets/images/examples/auth-configs.png" alt="Auth configs" />-</Frame>--### Save auth config IDs to environment variables--For this project, the auth config IDs should be saved to the environment variables-with the `NEXT_PUBLIC_` prefix.--```bash .env.local-NEXT_PUBLIC_GMAIL_AUTH_CONFIG_ID=ac_1234567890-NEXT_PUBLIC_GITHUB_AUTH_CONFIG_ID=ac_1234567890-```--## Create a Composio client instance--We create a Composio client instance for server-side operations like API routes,-server components, etc.--```typescript lib/service/composio.ts-import { Composio } from '@composio/core';-import { VercelProvider } from '@composio/vercel';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--export default composio;-```--## Creating an API for fetching toolkits--The Composio SDK is meant to be used only in server-side code. For client-side-functionality, we create API endpoints in the `/app/api/` directory. In order to-list the toolkits and their connection status, we create a Next.js API route to-fetch the toolkits using Composio SDK.--<Frame>- <img src="../../../../assets/images/examples/toolkits.png" />-</Frame>--### 1. Listing connected accounts--First, we fetch all connected accounts for a user and create a mapping of toolkit-slugs to their connection IDs:--```typescript app/api/composio/toolkits.ts-export async function GET() {- // ... auth logic ...-- // List connected accounts to get connection IDs for each toolkit- const connectedAccounts = await composio.connectedAccounts.list({- userIds: [session.user.id],- });-- const connectedToolkitMap = new Map();- connectedAccounts.items.forEach(account => {- connectedToolkitMap.set(account.toolkit.slug.toUpperCase(), account.id);- });-- // ... continue with toolkit fetching ...-}-```--### 2. Fetching toolkit data and building response--Next, we fetch toolkit information for each supported toolkit and combine it with the connection status:--```typescript app/api/composio/toolkits.ts-export async function GET() {- // ... auth logic ...- // ... connected accounts mapping ...-- const SUPPORTED_TOOLKITS = ['GMAIL', 'GOOGLECALENDAR', 'GITHUB', 'NOTION'];-- // Fetch toolkit data from slugs- const toolkitPromises = SUPPORTED_TOOLKITS.map(async slug => {- const toolkit = await composio.toolkits.get(slug);- const connectionId = connectedToolkitMap.get(slug.toUpperCase());-- return {- name: toolkit.name,- slug: toolkit.slug,- description: toolkit.meta?.description,- logo: toolkit.meta?.logo,- categories: toolkit.meta?.categories,- isConnected: !!connectionId,- connectionId: connectionId || undefined,- };- });-- const toolkits = await Promise.all(toolkitPromises);- return NextResponse.json({ toolkits });-}-```--## Managing connections--Users need to connect and disconnect their accounts from the chatbot to enable tool usage. When users click "Connect" on a toolkit, we initiate an OAuth flow, and when they click "Disconnect", we remove their connection.--### 1. Initiating a connection--When a user wants to connect their account, we create a connection request that redirects them to the OAuth provider:--<Frame>- <img src="../../../../assets/images/examples/create-connection.png" />-</Frame>--```typescript app/api/connections/initiate/route.ts-export async function POST(request: Request) {- // ... auth and validation ...-- const { authConfigId } = requestBody;-- // Initiate connection with Composio- const connectionRequest = await composio.connectedAccounts.initiate(- session.user.id,- authConfigId- );-- return NextResponse.json({- redirectUrl: connectionRequest.redirectUrl,- connectionId: connectionRequest.id,- });-}-```--### 2. Checking connection status--After initiating a connection, we need to wait for the OAuth flow to complete. We check the connection status to know when it's ready to use:--<Frame>- <img src="../../../../assets/images/examples/connection-status.png" />-</Frame>--```typescript app/api/connections/status/route.ts-export async function GET(request: Request) {- // ... auth and validation ...-- const connectionId = searchParams.get('connectionId');-- // Wait for connection to complete- const connection = await composio.connectedAccounts.waitForConnection(connectionId);-- return NextResponse.json({- id: connection.id,- status: connection.status,- authConfig: connection.authConfig,- data: connection.data,- });-}-```--### 3. Deleting a connection--When a user wants to disconnect their account, we remove the connection using the connection ID:--```typescript app/api/connections/delete/route.ts-export async function DELETE(request: Request) {- // ... auth and validation ...-- const connectionId = searchParams.get('connectionId');-- // Delete the connection- await composio.connectedAccounts.delete(connectionId);-- return NextResponse.json({- success: true,- message: 'Connection deleted successfully',- });-}-```--## Working with tools--Once users have connected their accounts, we need to track which toolkits are enabled and fetch the corresponding tools for the LLM.--### 1. Tracking enabled toolkits--We keep track of which toolkits the user has enabled in the chat interface:--```typescript components/chat.tsx-const { ... } = useChat({- // ... other config ...- experimental_prepareRequestBody: (body) => {- // Get current toolbar state- const currentToolbarState = toolbarStateRef.current;- const enabledToolkits = Array.from(- currentToolbarState.enabledToolkitsWithStatus.entries(),- ).map(([slug, isConnected]) => ({ slug, isConnected }));-- return {- // ... other fields ...- enabledToolkits,- };- },- // ... other handlers ...- });-```--### 2. Fetching tools for enabled toolkits--We fetch Composio tools based on the enabled toolkit slugs:--```typescript lib/ai/tools/composio.ts-export async function getComposioTools(userId: string, toolkitSlugs: string[]) {- // ... validation ...-- const tools = await composio.tools.get(userId, {- toolkits: toolkitSlugs,- });- return tools || {};-}-```--```typescript app/api/chat.ts-export async function POST(request: Request) {- // ... auth and parsing ...-- const toolkitSlugs = enabledToolkits?.map(t => t.slug) || [];-- const composioTools = await getComposioTools(session.user.id, toolkitSlugs);-- const result = streamText({- // ... model config ...- tools: {- ...composioTools,- },- });-}-```--## Bonus: Creating custom component to show tool calls--By default, tool calls appear as raw JSON in the chat interface. To create a better user experience, we can build custom components that display tool calls with proper formatting and loading states.--<Frame>- <img src="../../../../assets/images/examples/custom-tool-component.png" />-</Frame>--You can find the `ToolCall` component at `components/tool-call.tsx`. Here's how to integrate it into your message rendering:--```typescript components/messages.tsx-if (type === 'tool-invocation') {- const { toolInvocation } = part;- const { toolName, toolCallId, state, args, result } = toolInvocation;-- if (state === 'call') {- return (- <ToolCall- key={toolCallId}- toolName={toolName}- args={args}- isLoading={true}- />- );- }-- if (state === 'result') {- return (- <ToolCall- key={toolCallId}- toolName={toolName}- args={args}- result={result}- isLoading={false}- />- );- }-}-```diff --git a/fern/pages/src/examples/fast-api.mdx b/fern/pages/src/examples/fast-api.mdxdeleted file mode 100644index 45a0a7b2d..000000000--- a/fern/pages/src/examples/fast-api.mdx+++ /dev/null@@ -1,401 +0,0 @@-----title: Basic FastAPI Server-subtitle: "Build a simple Gmail agent with Composio and FastAPI"-image: "https://og.composio.dev/api/og?title=Basic%20FastAPI%20Server" # image for socials-keywords: "fastapi, composio, openai, gmail, agent"-hide-nav-links: false------This cookbook will guide you through building agents equipped with tools using `Composio`, `OpenAI`, and `FastAPI`.--## Prerequisites--* Python 3.10+-* [UV](https://docs.astral.sh/uv/getting-started/installation/)-* Composio API key-* OpenAI API key--## Building an AI agent that can interact with `gmail` service--First, let's start with building a simple AI agent with Composio tools that lets the agent interact with `gmail`.--```python-from openai import OpenAI-from composio import Composio-from composio_openai import OpenAIProvider-import os--def run_gmail_agent(- composio_client: Composio[OpenAIProvider],- openai_client: OpenAI,- user_id: str, # Composio uses the User ID to store and access user-level authentication tokens.- prompt: str,-):- """- Run the Gmail agent using composio and openai clients.- """- # Step 1: Fetch the necessary Gmail tools list with Composio- tools = composio_client.tools.get(- user_id=user_id,- tools=[- "GMAIL_FETCH_EMAILS",- "GMAIL_SEND_EMAIL",- "GMAIL_CREATE_EMAIL_DRAFT"- ]- )-- # Step 2: Use OpenAI to generate a response based on the prompt and available tools- response = openai_client.chat.completions.create(- model="gpt-4.1",- tools=tools,- messages=[{"role": "user", "content": prompt}],- )-- # Step 3: Handle tool calls with Composio and return the result- result = composio_client.provider.handle_tool_calls(response=response, user_id=user_id)- return result-```--<Note>-This example demonstrates a basic agent without state management or agentic loops,-suitable for simple one-step tasks. For complex multi-step workflows requiring-memory and iterative reasoning, see our cookbooks with frameworks like LangChain,-CrewAI, or AutoGen.-</Note>--To invoke this agent, authenticate your users with Composio's managed authentication service.--## Authenticating users---To authenticate your users with Composio you need an authentication config for the given app. In this case you need one for gmail.--To create an authentication config for `gmail` you need `client_id` and `client_secret` from your [Google OAuth Console](https://developers.google.com/identity/protocols/oauth2). Once you have the credentials, use the following piece of code to set up authentication for `gmail`.--```python-from composio import Composio-from composio_openai import OpenAIProvider--def create_auth_config(composio_client: Composio[OpenAIProvider]):- """- Create a auth config for the gmail toolkit.- """- client_id = os.getenv("GMAIL_CLIENT_ID")- client_secret = os.getenv("GMAIL_CLIENT_SECRET")- if not client_id or not client_secret:- raise ValueError("GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET must be set")-- return composio_client.auth_configs.create(- toolkit="GMAIL",- options={- "name": "default_gmail_auth_config",- "type": "use_custom_auth",- "auth_scheme": "OAUTH2",- "credentials": {- "client_id": client_id,- "client_secret": client_secret,- },- },- )-```--This will create a Gmail authentication config to authenticate your app’s users. Ideally, create one authentication object per project, so check for an existing auth config before creating a new one.--```python-def fetch_auth_config(composio_client: Composio[OpenAIProvider]):- """- Fetch the auth config for a given user id.- """- auth_configs = composio_client.auth_configs.list()- for auth_config in auth_configs.items:- if auth_config.toolkit == "GMAIL":- return auth_config-- return None-```--<Note>-Composio platform provides composio managed authentication for some apps to-fast-track your development, `gmail` being one of them. You can use these-default auth configs for development, but for production, always use your-own oauth app configuration.-</Note>--Once you have authentication management in place, we can start with connecting your users to your `gmail` app. Let's implement a function to connect users to your `gmail` app via composio.--```python-from fastapi import FastAPI--# Function to initiate a connected account-def create_connection(composio_client: Composio[OpenAIProvider], user_id: str):- """- Create a connection for a given user id and auth config id.- """- # Fetch or create the auth config for the gmail toolkit- auth_config = fetch_auth_config(composio_client=composio_client)- if not auth_config:- auth_config = create_auth_config(composio_client=composio_client)-- # Create a connection for the user- return composio_client.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config.id,- )--# Setup FastAPI-app = FastAPI()--# Connection initiation endpoint[email protected]("/connection/create")-def _create_connection(- request: CreateConnectionRequest,- composio_client: ComposioClient,-) -> dict:- """- Create a connection for a given user id.- """- # For demonstration, using a default user_id. Replace with real user logic in production.- user_id = "default"-- # Create a new connection for the user- connection_request = create_connection(composio_client=composio_client, user_id=user_id)- return {- "connection_id": connection_request.id,- "redirect_url": connection_request.redirect_url,- }-```--Now, you can make a request to this endpoint on your client app, and your user will get a URL which they can use to authenticate.--## Set Up FastAPI service--We will use [`FastApi`](https://fastapi.tiangolo.com/) to build an HTTP service that authenticates your users and lets them interact with your agent. This guide will provide best practices for using composio client in production environments.--### Setup dependencies--FastAPI allows [dependency injection](https://fastapi.tiangolo.com/reference/dependencies/) to simplify the usage of SDK clients that must be singletons. We recommend using composio SDK client as singleton.--```python-import os-import typing_extensions as te--from composio import Composio-from composio_openai import OpenAIProvider--from fastapi import Depends--_composio_client: Composio[OpenAIProvider] | None = None--def provide_composio_client():- """- Provide a Composio client.- """- global _composio_client- if _composio_client is None:- _composio_client = Composio(provider=OpenAIProvider())- return _composio_client---ComposioClient = te.Annotated[Composio, Depends(provide_composio_client)]-"""-A Composio client dependency.-"""-```--Check [dependencies](./simple_gmail_agent/server/dependencies.py) module for more details.--### Invoke agent via FastAPI--When invoking an agent, make sure you validate the `user_id`.--```python-def check_connected_account_exists(- composio_client: Composio[OpenAIProvider],- user_id: str,-):- """- Check if a connected account exists for a given user id.- """- # Fetch all connected accounts for the user- connected_accounts = composio_client.connected_accounts.list(- user_ids=[user_id],- toolkit_slugs=["GMAIL"],- )-- # Check if there's an active connected account- for account in connected_accounts.items:- if account.status == "ACTIVE":- return True-- # Ideally you should not have inactive accounts, but if you do, delete them.- print(f"[warning] inactive account {account.id} found for user id: {user_id}")- return False--def validate_user_id(user_id: str, composio_client: ComposioClient):- """- Validate the user id, if no connected account is found, create a new connection.- """- if check_connected_account_exists(composio_client=composio_client, user_id=user_id):- return user_id-- raise HTTPException(- status_code=404, detail={"error": "No connected account found for the user id"}- )--# Endpoint: Run the Gmail agent for a given user id and prompt[email protected]("/agent")-def _run_gmail_agent(- request: RunGmailAgentRequest,- composio_client: ComposioClient,- openai_client: OpenAIClient, # OpenAI client will be injected as dependency-) -> List[ToolExecutionResponse]:- """- Run the Gmail agent for a given user id and prompt.- """- # For demonstration, using a default user_id. Replace with real user logic in production.- user_id = "default"-- # Validate the user id before proceeding- user_id = validate_user_id(user_id=user_id, composio_client=composio_client)-- # Run the Gmail agent using Composio and OpenAI- result = run_gmail_agent(- composio_client=composio_client,- openai_client=openai_client,- user_id=user_id,- prompt=request.prompt,- )- return result-```--<Note>-Check [server](./simple_gmail_agent/server/) module for service implementation-</Note>--## Putting everything together--So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a FastAPI service. Now let's run the service.--<Note>-Before proceeding, check the [code](./simple_gmail_agent/server/api.py) for utility endpoints not discussed in the cookbook-</Note>---1. Clone the repository- ```bash- git clone [email protected]:composiohq/composio-fastapi- cd composio-fastapi/- ```-2. Setup environment- ```bash- cp .env.example .env- ```-- Fill the api keys- ```dotenv- COMPOSIO_API_KEY=- OPENAI_API_KEY=- ```-- Create the virtual env- ```bash- make env- source .venv/bin/activate- ```-3. Run the HTTP server- ```bash- uvicorn simple_gmail_agent.server.api:create_app --factory- ```-## Testing the API with curl--Assuming the server is running locally on `http://localhost:8000`.--### Check if a connection exists-```bash-curl -X POST http://localhost:8000/connection/exists-```--### Create a connection-Note: The body fields are required by the API schema, but are ignored internally in this example service.-```bash-curl -X POST http://localhost:8000/connection/create \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "auth_config_id": "AUTH_CONFIG_ID_FOR_GMAIL_FROM_THE_COMPOSIO_DASHBOARD"- }'-```-Response includes `connection_id` and `redirect_url`. Complete the OAuth flow at the `redirect_url`.--### Check connection status-Use the `connection_id` returned from the create step.-```bash-curl -X POST http://localhost:8000/connection/status \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "connection_id": "CONNECTION_ID_FROM_CREATE_RESPONSE"- }'-```--### Run the Gmail agent-Requires an active connected account for the `default` user.-```bash-curl -X POST http://localhost:8000/agent \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "prompt": "Summarize my latest unread emails from the last 24 hours."- }'-```--### Fetch emails (direct action)-```bash-curl -X POST http://localhost:8000/actions/fetch_emails \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "limit": 5- }'-```--These examples are intended solely for testing purposes.--## Using Composio for managed auth and tools--Composio reduces boilerplate for building AI agents that access and use various apps. In this cookbook, to build Gmail integration without Composio, you would have to write code to--- manage Gmail OAuth app-- manage user connections-- tools for your agents to interact with Gmail--Using Composio simplifies all of the above to a few lines of code as shown in the cookbook.--## Best practices--**🎯 Effective Prompts**:-- Be specific: "Send email to [email protected] about tomorrow's 2pm meeting" works better than "send email"-- Include context: "Reply to Sarah's email about the budget with our approval"-- Use natural language: The agent understands conversational requests--**🔒 User Management**:-- Use unique, consistent `user_id` values for each person-- Each user maintains their own Gmail connection-- User IDs can be email addresses, usernames, or any unique identifier---## Troubleshooting--**Connection Issues**:-- Ensure your `.env` file has valid `COMPOSIO_API_KEY` and `OPENAI_API_KEY`-- Check if the user has completed Gmail authorization.-- Verify the user_id matches exactly between requests--**API Errors**:-- Check the server logs for detailed error messages-- Ensure request payloads match the expected format-- Visit `/docs` endpoint for API schema validation--**Gmail API Limits**:-- Gmail has rate limits; the agent will handle these gracefully-- For high-volume usage, consider implementing request queuingdiff --git a/fern/pages/src/examples/hono.mdx b/fern/pages/src/examples/hono.mdxdeleted file mode 100644index b31aeb233..000000000--- a/fern/pages/src/examples/hono.mdx+++ /dev/null@@ -1,423 +0,0 @@-----title: Basic Hono Server-subtitle: Build a Gmail agent HTTP service with Hono-image: "https://og.composio.dev/api/og?title=Basic%20Hono%20Server" # image for socials-keywords: "hono, composio, openai, gmail, agent"-hide-nav-links: false-description: Build a simple Gmail agent with Composio and Hono.js------With Composio's managed authentication and tool calling, it's easy to build-AI agents that interact with the real world while reducing boilerplate for-setup and authentication management. This cookbook will guide you through-building and serving agents using `Composio`, `OpenAI`, and `Hono.js`.--## Prerequisites--* Node.js 18.x or higher-* npm or yarn package manager-* Composio API key-* OpenAI API key-* Basic knowledge of OAuth-* Understanding of building HTTP services (preferably using Hono.js)--## Building an AI agent that can interact with `gmail` service--First, let's start with building a simple AI agent embedded with tools from-Composio that lets the agent interact with the `gmail` service.--```typescript-import { OpenAI } from 'openai';-import { Composio } from '@composio/core';-import { OpenAIProvider } from '@composio/openai';--export async function runGmailAgent(- composioClient: Composio<OpenAIProvider>,- openaiClient: OpenAI,- userId: string, // Composio uses the User ID to store and access user-level authentication tokens.- prompt: string,-): Promise<any[]> {- // Step 1: Fetch the necessary Gmail tools list with Composio- const tools = await composioClient.tools.get(- userId,- {- tools: [- "GMAIL_FETCH_EMAILS",- "GMAIL_SEND_EMAIL",- "GMAIL_CREATE_EMAIL_DRAFT"- ]- }- );-- // Step 2: Use OpenAI to generate a response based on the prompt and available tools- const response = await openaiClient.chat.completions.create({- model: "gpt-4.1",- tools,- messages: [{ role: "user", content: prompt }],- });-- // Step 3: Handle tool calls with Composio and return the result- const result = await composioClient.provider.handleToolCalls(- userId,- response- );- return result;-}-```--<Note>- This is a simple agent without state management and agentic loop implementation,- so the agent can't perform complicated tasks. If you want to understand how- composio can be used with agentic loops, check other cookbooks with more- agentic frameworks.-</Note>--To invoke this agent, authenticate your users with Composio's managed authentication service.--## Authenticating users--To authenticate your users with Composio you need an authentication config for the given app. In this case you need one for gmail.--To create an authentication config for `gmail` you need `client_id` and `client_secret` from your [Google OAuth Console](https://developers.google.com/identity/protocols/oauth2). Once you have the credentials, use the following piece of code to set up authentication for `gmail`.--```typescript-import { Composio } from '@composio/core';-import { OpenAIProvider } from '@composio/openai';--export async function createAuthConfig(composioClient: Composio<OpenAIProvider>) {- /**- * Create a auth config for the gmail toolkit.- */- const clientId = process.env.GMAIL_CLIENT_ID;- const clientSecret = process.env.GMAIL_CLIENT_SECRET;- if (!clientId || !clientSecret) {- throw new Error("GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET must be set");- }-- return composioClient.authConfigs.create(- "GMAIL",- {- "name": "default_gmail_auth_config",- "type": "use_custom_auth",- "authScheme": "OAUTH2",- "credentials": {- "clientId": clientId,- "clientSecret": clientSecret,- },- },- );-}-```--This will create a Gmail authentication config to authenticate your app's users. Ideally, create one authentication object per project, so check for an existing auth config before creating a new one.--```typescript-export async function fetchAuthConfig(composioClient: Composio<OpenAIProvider>) {- /**- * Fetch the auth config for a given user id.- */- const authConfigs = await composioClient.authConfigs.list();- for (const authConfig of authConfigs.items) {- if (authConfig.toolkit.slug === "gmail") {- return authConfig;- }- }-- return null;-}-```--<Note>- Composio platform provides composio managed authentication for some apps to- fast-track your development, `gmail` being one of them. You can use these- default auth configs for development, but for production, always use your- own oauth app configuration.-</Note>--Once you have authentication management in place, we can start with connecting your users to your `gmail` app. Let's implement a function to connect users to your `gmail` app via composio.--```typescript-import { Hono } from 'hono';--// Function to initiate a connected account-export async function createConnection(composioClient: Composio<OpenAIProvider>, userId: string) {- /**- * Create a connection for a given user id and auth config id.- */- // Fetch or create the auth config for the gmail toolkit- let authConfig = await fetchAuthConfig(composioClient);- if (!authConfig) {- authConfig = await createAuthConfig(composioClient);- }-- // Create a connection for the user- return composioClient.connectedAccounts.initiate(- userId,- authConfig.id,- );-}--// Setup Hono-const app = new Hono();--// Connection initiation endpoint-app.post("/connection/create", async (c) => {- /**- * Create a connection for a given user id.- */- // For demonstration, using a default user_id. Replace with real user logic in production.- const userId = "default";-- // Create a new connection for the user- const connectionRequest = await createConnection(composioClient, userId);- return c.json({- "connection_id": connectionRequest.id,- "redirect_url": connectionRequest.redirectUrl,- });-});-```--Now, you can make a request to this endpoint on your client app, and your user will get a URL which they can use to authenticate.--## Set Up Hono service--We will use [`Hono.js`](https://hono.dev/) to build an HTTP service that authenticates your users and lets them interact with your agent. This guide will provide best practices for using composio client in production environments.--### Setup dependencies--Hono allows dependency injection patterns to simplify the usage of SDK clients that must be singletons. We recommend using composio SDK client as singleton.--```typescript-import { Composio } from '@composio/core';-import { OpenAIProvider } from '@composio/openai';-import { OpenAI } from 'openai';--let _composioClient: Composio<OpenAIProvider> | null = null;--export function provideComposioClient(): Composio<OpenAIProvider> {- /**- * Provide a Composio client.- */- if (_composioClient === null) {- _composioClient = new Composio({- provider: new OpenAIProvider()- });- }- return _composioClient;-}--// A Composio client dependency.-export type ComposioClient = Composio<OpenAIProvider>;-```--Check [config/composio.ts](./src/config/composio.ts) module for more details.--### Invoke agent via Hono--When invoking an agent, make sure you validate the `user_id`.--```typescript-export function checkConnectedAccountExists(- composioClient: Composio<OpenAIProvider>,- userId: string,-): Promise<boolean> {- /**- * Check if a connected account exists for a given user id.- */- // Fetch all connected accounts for the user- return composioClient.connectedAccounts.list({ userIds: [userId], toolkitSlugs: ["GMAIL"] }).then(connectedAccounts => {-- // Check if there's an active connected account- for (const account of connectedAccounts.items) {- if (account.status === "ACTIVE") {- return true;- }-- // Ideally you should not have inactive accounts, but if you do, delete them.- console.log(`[warning] inactive account ${account.id} found for user id: ${userId}`);- }- return false;- });-}--export async function validateUserId(userId: string, composioClient: ComposioClient): Promise<string> {- /**- * Validate the user id, if no connected account is found, create a new connection.- */- if (await checkConnectedAccountExists(composioClient, userId)) {- return userId;- }-- throw new Error("No connected account found for the user id");-}--// Endpoint: Run the Gmail agent for a given user id and prompt-app.post("/agent", async (c) => {- /**- * Run the Gmail agent for a given user id and prompt.- */- const request = await c.req.json();-- // For demonstration, using a default user_id. Replace with real user logic in production.- const userId = "default";-- // Validate the user id before proceeding- await validateUserId(userId, composioClient);-- // Run the Gmail agent using Composio and OpenAI- const result = await runGmailAgent(- composioClient,- openaiClient,- userId,- request.prompt,- );- return c.json(result);-});-```--<Note>- Check [src/api.ts](./src/api.ts) module for service implementation-</Note>--## Putting everything together--So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a Hono service. Now let's run the service.--<Note>- Before proceeding, check the [code](./src/api.ts) for utility endpoints not discussed in the cookbook-</Note>--1. Clone the repository- ```bash- git clone [email protected]:composiohq/composio-hono- cd composio-hono/- ```-2. Setup environment-- ```bash- cp .env.example .env- ```-- Fill the api keys-- ```dotenv- COMPOSIO_API_KEY=- OPENAI_API_KEY=- ```-- Install dependencies-- ```bash- npm install- ```-3. Run the HTTP server- ```bash- npm run dev- ```--## Testing the API with curl--Assuming the server is running locally on `http://localhost:8000`.--### Check if a connection exists--```bash-curl -X POST http://localhost:8000/connection/exists-```--### Create a connection--Note: The body fields are required by the API schema, but are ignored internally in this example service.--```bash-curl -X POST http://localhost:8000/connection/create \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "auth_config_id": "AUTH_CONFIG_ID_FOR_GMAIL_FROM_THE_COMPOSIO_DASHBOARD"- }'-```--Response includes `connection_id` and `redirect_url`. Complete the OAuth flow at the `redirect_url`.--### Check connection status--Use the `connection_id` returned from the create step.--```bash-curl -X POST http://localhost:8000/connection/status \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "connection_id": "CONNECTION_ID_FROM_CREATE_RESPONSE"- }'-```--### Run the Gmail agent--Requires an active connected account for the `default` user.--```bash-curl -X POST http://localhost:8000/agent \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "prompt": "Summarize my latest unread emails from the last 24 hours."- }'-```--### Fetch emails (direct action)--```bash-curl -X POST http://localhost:8000/actions/fetch_emails \- -H "Content-Type: application/json" \- -d '{- "user_id": "default",- "limit": 5- }'-```--These examples are intended solely for testing purposes.--## Using Composio for managed auth and tools--Composio reduces boilerplate for building AI agents that access and use various apps. In this cookbook, to build Gmail integration without Composio, you would have to write code to--* manage Gmail OAuth app-* manage user connections-* tools for your agents to interact with Gmail--Using Composio simplifies all of the above to a few lines of code as shown in the cookbook.--## Best practices--**🎯 Effective Prompts**:--* Be specific: "Send email to [[email protected]](mailto:[email protected]) about tomorrow's 2pm meeting" works better than "send email"-* Include context: "Reply to Sarah's email about the budget with our approval"-* Use natural language: The agent understands conversational requests--**🔑 User Management**:--* Use unique, consistent `user_id` values for each person-* Each user maintains their own Gmail connection-* User IDs can be email addresses, usernames, or any unique identifier--## Troubleshooting--**Connection Issues**:--* Ensure your `.env` file has valid `COMPOSIO_API_KEY` and `OPENAI_API_KEY`-* Check if the user has completed Gmail authorization.-* Verify the user\_id matches exactly between requests--**API Errors**:--* Check the server logs for detailed error messages-* Ensure request payloads match the expected format-* Visit `/docs` endpoint for API schema validation--**Gmail API Limits**:--* Gmail has rate limits; the agent will handle these gracefully-* For high-volume usage, consider implementing request queuing\ No newline at end of filediff --git a/fern/pages/src/examples/tool-generator/output.json b/fern/pages/src/examples/tool-generator/output.jsondeleted file mode 100644index 71929de24..000000000--- a/fern/pages/src/examples/tool-generator/output.json+++ /dev/null@@ -1,3335 +0,0 @@-[- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Modify email labels",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Modify email labels"- },- "description": "Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids).",- "input_parameters": {- "properties": {- "add_label_ids": {- "default": [],- "description": "Label IDs to add. For custom labels, obtain IDs via 'listLabels'. System labels (e.g., 'INBOX', 'SPAM') can also be used.",- "examples": [- "STARRED",- "IMPORTANT",- "Label_123"- ],- "items": {- "type": "string"- },- "title": "Add Label Ids",- "type": "array"- },- "message_id": {- "description": "Immutable ID of the message to modify (e.g., from 'fetchEmails' or 'fetchMessagesByThreadId').",- "examples": [- "17f1b2b9c1b2a3d4"- ],- "title": "Message Id",- "type": "string"- },- "remove_label_ids": {- "default": [],- "description": "Label IDs to remove. For custom labels, obtain IDs via 'listLabels'. System labels can also be used.",- "examples": [- "UNREAD",- "Label_456"- ],- "items": {- "type": "string"- },- "title": "Remove Label Ids",- "type": "array"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "message_id"- ],- "title": "AddLabelToEmailRequest",- "type": "object"- },- "name": "Modify email labels",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "description": "Full `Message` resource with updated labels.",- "title": "Response Data",- "type": "object"- }- },- "required": [- "response_data"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "AddLabelToEmailResponseWrapper",- "type": "object"- },- "slug": "GMAIL_ADD_LABEL_TO_EMAIL",- "tags": [- "idempotentHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Create email draft",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Create email draft"- },- "description": "Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading.",- "input_parameters": {- "properties": {- "attachment": {- "default": null,- "description": "File to attach to the email.",- "file_uploadable": true,- "properties": {- "mimetype": {- "title": "Mimetype",- "type": "string"- },- "name": {- "title": "Name",- "type": "string"- },- "s3key": {- "title": "S3Key",- "type": "string"- }- },- "required": [- "name",- "mimetype",- "s3key"- ],- "title": "FileUploadable",- "type": "object"- },- "bcc": {- "default": [],- "description": "'Bcc' (blind carbon copy) recipient email addresses.",- "examples": [- "[\"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Bcc",- "type": "array"- },- "body": {- "description": "Email body content (plain text or HTML); `is_html` must be True if HTML.",- "examples": [- "Hello Team,\n\nPlease find the attached report for your review.\n\nBest regards,\nYour Name",- "<h1>Meeting Confirmation</h1><p>This email confirms our meeting scheduled for next Tuesday.</p>"- ],- "title": "Body",- "type": "string"- },- "cc": {- "default": [],- "description": "'Cc' (carbon copy) recipient email addresses.",- "examples": [- "[\"[email protected]\", \"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Cc",- "type": "array"- },- "extra_recipients": {- "default": [],- "description": "Additional 'To' recipient email addresses.",- "examples": [- "[\"[email protected]\", \"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Extra Recipients",- "type": "array"- },- "is_html": {- "default": false,- "description": "Set to True if `body` is HTML, otherwise the action may fail.",- "examples": [- "True",- "False"- ],- "title": "Is Html",- "type": "boolean"- },- "recipient_email": {- "description": "Primary recipient's email address.",- "examples": [- ],- "title": "Recipient Email",- "type": "string"- },- "subject": {- "description": "Email subject line.",- "examples": [- "Project Update Q3",- "Meeting Reminder"- ],- "title": "Subject",- "type": "string"- },- "thread_id": {- "default": null,- "description": "ID of an existing Gmail thread to reply to; omit for new thread.",- "examples": [- "17f45ec49a9c3f1b"- ],- "title": "Thread Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "recipient_email",- "subject",- "body"- ],- "title": "CreateEmailDraftRequest",- "type": "object"- },- "name": "Create email draft",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "default": null,- "description": "Gmail API response with created draft details, including ID.",- "title": "Response Data",- "type": "object"- }- },- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "CreateEmailDraftResponseWrapper",- "type": "object"- },- "slug": "GMAIL_CREATE_EMAIL_DRAFT",- "tags": [- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/gmail.readonly",- "https://www.googleapis.com/auth/gmail.send",- "https://www.googleapis.com/auth/gmail.compose"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Create label",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Create label"- },- "description": "Creates a new label with a unique name in the specified user's gmail account.",- "input_parameters": {- "properties": {- "label_list_visibility": {- "default": "labelShow",- "description": "Controls how the label is displayed in the label list in the Gmail sidebar.",- "examples": [- "labelShow",- "labelShowIfUnread",- "labelHide"- ],- "title": "Label List Visibility",- "type": "string"- },- "label_name": {- "description": "The name for the new label.",- "examples": [- "Work",- "Important Documents",- "Receipts 2024"- ],- "title": "Label Name",- "type": "string"- },- "message_list_visibility": {- "default": "show",- "description": "Controls how messages with this label are displayed in the message list.",- "examples": [- "show",- "hide"- ],- "title": "Message List Visibility",- "type": "string"- },- "user_id": {- "default": "me",- "description": "The email address of the user in whose account the label will be created.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "label_name"- ],- "title": "CreateLabelRequest",- "type": "object"- },- "name": "Create label",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "description": "Full API response from Gmail for the created label.",- "title": "Response Data",- "type": "object"- }- },- "required": [- "response_data"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "CreateLabelResponseWrapper",- "type": "object"- },- "slug": "GMAIL_CREATE_LABEL",- "tags": [- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Delete Draft",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Delete Draft"- },- "description": "Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`.",- "input_parameters": {- "properties": {- "draft_id": {- "description": "Immutable ID of the draft to delete, typically obtained when the draft was created.",- "examples": [- "r-8388446164079304564"- ],- "title": "Draft Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user; 'me' is recommended.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "draft_id"- ],- "title": "DeleteDraftRequest",- "type": "object"- },- "name": "Delete Draft",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "success": {- "description": "Indicates successful deletion; an exception is raised on error rather than returning false.",- "title": "Success",- "type": "boolean"- }- },- "required": [- "success"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "DeleteDraftResponseWrapper",- "type": "object"- },- "slug": "GMAIL_DELETE_DRAFT",- "tags": [- "destructiveHint",- "idempotentHint",- "important",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Delete message",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Delete message"- },- "description": "Permanently deletes a specific email message by its id from a gmail mailbox; for `user id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.",- "input_parameters": {- "properties": {- "message_id": {- "description": "Identifier of the email message to delete.",- "examples": [- "185120e4428ba8cf",- "17a872b77b9e7a3b"- ],- "title": "Message Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address. The special value 'me' refers to the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "message_id"- ],- "title": "DeleteMessageRequest",- "type": "object"- },- "name": "Delete message",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "success": {- "description": "True if the message was successfully deleted.",- "title": "Success",- "type": "boolean"- }- },- "required": [- "success"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "DeleteMessageResponseWrapper",- "type": "object"- },- "slug": "GMAIL_DELETE_MESSAGE",- "tags": [- "destructiveHint",- "important",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Fetch emails",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Fetch emails"- },- "description": "Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.",- "input_parameters": {- "properties": {- "include_payload": {- "default": true,- "description": "Set to true to include full message payload (headers, body, attachments); false for metadata only.",- "examples": [- "True",- "False"- ],- "title": "Include Payload",- "type": "boolean"- },- "include_spam_trash": {- "default": false,- "description": "Set to true to include messages from 'SPAM' and 'TRASH'.",- "examples": [- "True",- "False"- ],- "title": "Include Spam Trash",- "type": "boolean"- },- "label_ids": {- "description": "Filter by label IDs; only messages with all specified labels are returned. Common IDs: 'INBOX', 'SPAM', 'TRASH', 'UNREAD', 'STARRED', 'IMPORTANT', 'CATEGORY_PERSONAL', 'CATEGORY_SOCIAL', 'CATEGORY_PROMOTIONS', 'CATEGORY_UPDATES', 'CATEGORY_FORUMS'. Use 'listLabels' action for custom IDs.",- "examples": [- "['INBOX', 'UNREAD']",- "['IMPORTANT']",- "[]"- ],- "items": {- "type": "string"- },- "title": "Label Ids",- "type": "array"- },- "max_results": {- "default": 1,- "description": "Maximum number of messages to retrieve per page.",- "examples": [- "10",- "100",- "500"- ],- "maximum": 500,- "minimum": 1,- "title": "Max Results",- "type": "integer"- },- "page_token": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Token for retrieving a specific page, obtained from a previous response's `nextPageToken`. Omit for the first page.",- "title": "Page Token",- "type": "string"- },- "query": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Gmail advanced search query (e.g., 'from:user subject:meeting'). Supports operators like 'from:', 'to:', 'subject:', 'label:', 'has:attachment', 'is:unread', 'after:YYYY/MM/DD', 'before:YYYY/MM/DD', AND/OR/NOT. Use quotes for exact phrases. Omit for no query filter.",- "examples": [- "from:[email protected] is:unread",- "subject:meeting has:attachment",- "after:2024/01/01 before:2024/02/01",- "is:important OR is:starred",- "label:work -label:spam"- ],- "title": "Query",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "title": "FetchEmailsRequest",- "type": "object"- },- "name": "Fetch emails",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "messages": {- "description": "List of retrieved email messages. Includes full content if `include_payload` was true, otherwise metadata.",- "items": {- "description": "This model represents the body a Gmail message.",- "properties": {- "attachmentList": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The list of attachments",- "title": "Attachmentlist"- },- "labelIds": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The label IDs of the message",- "title": "Labelids"- },- "messageId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The message ID of the message",- "title": "Messageid"- },- "messageText": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The text of the message",- "title": "Messagetext"- },- "messageTimestamp": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The timestamp of the message",- "title": "Messagetimestamp"- },- "payload": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The payload of the message",- "title": "Payload"- },- "preview": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The preview of the message",- "title": "Preview"- },- "sender": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The sender of the message",- "title": "Sender"- },- "subject": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The subject of the message",- "title": "Subject"- },- "threadId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The thread ID of the message",- "title": "Threadid"- },- "to": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The recipient of the message",- "title": "To"- }- },- "title": "MessageBody",- "type": "object"- },- "title": "Messages",- "type": "array"- },- "nextPageToken": {- "description": "Token for the next page of results; use in subsequent `page_token` request. Empty if no more results.",- "title": "Next Page Token",- "type": "string"- },- "resultSizeEstimate": {- "description": "Estimated total messages matching the query (not just this page).",- "title": "Result Size Estimate",- "type": "integer"- }- },- "required": [- "nextPageToken",- "resultSizeEstimate",- "messages"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "FetchEmailsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_FETCH_EMAILS",- "tags": [- "important",- "openWorldHint",- "readOnlyHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/gmail.readonly",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.metadata"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Fetch message by message ID",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Fetch message by message ID"- },- "description": "Fetches a specific email message by its id, provided the `message id` exists and is accessible to the authenticated `user id`.",- "input_parameters": {- "properties": {- "format": {- "default": "full",- "description": "Format for message content: 'minimal' (ID/labels), 'full' (complete data), 'raw' (base64url string), 'metadata' (ID/labels/headers).",- "examples": [- "minimal",- "full",- "raw",- "metadata"- ],- "title": "Format",- "type": "string"- },- "message_id": {- "description": "Unique ID of the email message to retrieve, obtainable from actions like 'List Messages'.",- "examples": [- "xsdfe3264vrfw"- ],- "minLength": 1,- "title": "Message Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "[email protected]",- "me"- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "message_id"- ],- "title": "FetchMessageByMessageIdRequest",- "type": "object"- },- "name": "Fetch message by message ID",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "attachmentList": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The list of attachments",- "title": "Attachment List"- },- "labelIds": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The label IDs of the message",- "title": "Label Ids"- },- "messageId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The message ID of the message",- "title": "Message Id"- },- "messageText": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The text of the message",- "title": "Message Text"- },- "messageTimestamp": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The timestamp of the message",- "title": "Message Timestamp"- },- "payload": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The payload of the message",- "title": "Payload"- },- "preview": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The preview of the message",- "title": "Preview"- },- "sender": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The sender of the message",- "title": "Sender"- },- "subject": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The subject of the message",- "title": "Subject"- },- "threadId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The thread ID of the message",- "title": "Thread Id"- },- "to": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The recipient of the message",- "title": "To"- }- },- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "FetchMessageByMessageIdResponseWrapper",- "type": "object"- },- "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Fetch Message by Thread ID",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Fetch Message by Thread ID"- },- "description": "Retrieves messages from a gmail thread using its `thread id`, where the thread must be accessible by the specified `user id`.",- "input_parameters": {- "properties": {- "page_token": {- "default": "",- "description": "Opaque page token for fetching a specific page of messages if results are paginated.",- "examples": [- "CiAKGhIKJdealEffectivelyPageToken"- ],- "title": "Page Token",- "type": "string"- },- "thread_id": {- "description": "Unique ID of the thread, obtainable from actions like 'listThreads' or 'fetchEmails'.",- "examples": [- "xsdfe3264vrfw"- ],- "title": "Thread Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "The email address of the user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "thread_id"- ],- "title": "FetchMessageByThreadIdRequest",- "type": "object"- },- "name": "Fetch Message by Thread ID",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "messages": {- "description": "Retrieved messages from the thread.",- "items": {- "description": "This model represents the body a Gmail message.",- "properties": {- "attachmentList": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The list of attachments",- "title": "Attachmentlist"- },- "labelIds": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "description": "The label IDs of the message",- "title": "Labelids"- },- "messageId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The message ID of the message",- "title": "Messageid"- },- "messageText": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The text of the message",- "title": "Messagetext"- },- "messageTimestamp": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The timestamp of the message",- "title": "Messagetimestamp"- },- "payload": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The payload of the message",- "title": "Payload"- },- "preview": {- "anyOf": [- {- "type": "object"- },- {- "type": "null"- }- ],- "description": "The preview of the message",- "title": "Preview"- },- "sender": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The sender of the message",- "title": "Sender"- },- "subject": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The subject of the message",- "title": "Subject"- },- "threadId": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The thread ID of the message",- "title": "Threadid"- },- "to": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "description": "The recipient of the message",- "title": "To"- }- },- "title": "MessageBody",- "type": "object"- },- "title": "Messages",- "type": "array"- }- },- "required": [- "messages"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "FetchMessageByThreadIdResponseWrapper",- "type": "object"- },- "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Get Gmail attachment",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Get Gmail attachment"- },- "description": "Retrieves a specific attachment by id from a message in a user's gmail mailbox, requiring valid message and attachment ids.",- "input_parameters": {- "properties": {- "attachment_id": {- "description": "ID of the attachment to retrieve.",- "examples": [- "A_PART0.1_18exampleAttachmentId7f9"- ],- "title": "Attachment Id",- "type": "string"- },- "file_name": {- "description": "Desired filename for the downloaded attachment.",- "examples": [- "invoice.pdf",- "report.docx"- ],- "title": "File Name",- "type": "string"- },- "message_id": {- "description": "Immutable ID of the message containing the attachment.",- "examples": [- "18exampleMessageId7f9"- ],- "title": "Message Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address ('me' for authenticated user).",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "message_id",- "attachment_id",- "file_name"- ],- "title": "GetAttachmentRequest",- "type": "object"- },- "name": "Get Gmail attachment",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "file": {- "description": "Retrieved attachment, prepared for download.",- "file_downloadable": true,- "properties": {- "mimetype": {- "description": "Mime type of the file.",- "title": "Mimetype",- "type": "string"- },- "name": {- "description": "Name of the file",- "title": "Name",- "type": "string"- },- "s3url": {- "description": "URL of the file.",- "title": "S3Url",- "type": "string"- }- },- "required": [- "name",- "mimetype",- "s3url"- ],- "title": "File",- "type": "object"- }- },- "required": [- "file"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "GetAttachmentResponseWrapper",- "type": "object"- },- "slug": "GMAIL_GET_ATTACHMENT",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Get contacts",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Get contacts"- },- "description": "Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination.",- "input_parameters": {- "properties": {- "page_token": {- "description": "Token to retrieve a specific page of results, obtained from 'nextPageToken' in a previous response.",- "title": "Page Token",- "type": "string"- },- "person_fields": {- "default": "emailAddresses,names,birthdays,genders",- "description": "Comma-separated person fields to retrieve for each contact (e.g., 'names,emailAddresses').",- "examples": [- "addresses",- "ageRanges",- "biographies",- "birthdays",- "coverPhotos",- "emailAddresses",- "events",- "genders",- "imClients",- "interests",- "locales",- "memberships",- "metadata",- "names",- "nicknames",- "occupations",- "organizations",- "phoneNumbers",- "photos",- "relations",- "residences",- "sipAddresses",- "skills",- "urls",- "userDefined"- ],- "title": "Person Fields",- "type": "string"- },- "resource_name": {- "default": "people/me",- "description": "Identifier for the person resource whose connections are listed; use 'people/me' for the authenticated user.",- "title": "Resource Name",- "type": "string"- }- },- "title": "GetContactsRequest",- "type": "object"- },- "name": "Get contacts",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "description": "Raw JSON response from the Google People API, typically containing a list of 'connections' (contacts) with requested 'personFields' and potentially a 'nextPageToken'.",- "title": "Response Data",- "type": "object"- }- },- "required": [- "response_data"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "GetContactsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_GET_CONTACTS",- "tags": [- "important",- "openWorldHint",- "readOnlyHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/contacts",- "https://www.googleapis.com/auth/contacts.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Get People",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Get People"- },- "description": "Retrieves either a specific person's details (using `resource name`) or lists 'other contacts' (if `other contacts` is true), with `person fields` specifying the data to return.",- "input_parameters": {- "properties": {- "other_contacts": {- "default": false,- "description": "If true, retrieves 'Other Contacts' (people interacted with but not explicitly saved), ignoring `resource_name` and enabling pagination/sync. If false, retrieves information for the single person specified by `resource_name`.",- "title": "Other Contacts",- "type": "boolean"- },- "page_size": {- "default": 10,- "description": "The number of 'Other Contacts' to return per page. Applicable only when `other_contacts` is true.",- "maximum": 1000,- "minimum": 1,- "title": "Page Size",- "type": "integer"- },- "page_token": {- "default": "",- "description": "An opaque token from a previous response to retrieve the next page of 'Other Contacts' results. Applicable only when `other_contacts` is true and paginating.",- "title": "Page Token",- "type": "string"- },- "person_fields": {- "default": "emailAddresses,names,birthdays,genders",- "description": "A comma-separated field mask to restrict which fields on the person (or persons) are returned. Consult the Google People API documentation for a comprehensive list of valid fields.",- "examples": [- "names,emailAddresses",- "emailAddresses,names,birthdays,genders",- "addresses,phoneNumbers,metadata"- ],- "title": "Person Fields",- "type": "string"- },- "resource_name": {- "default": "people/me",- "description": "Resource name identifying the person for whom to retrieve information (like the authenticated user or a specific contact). Used only when `other_contacts` is false.",- "examples": [- "people/me",- "people/c12345678901234567890",- "people/102345678901234567890"- ],- "title": "Resource Name",- "type": "string"- },- "sync_token": {- "default": "",- "description": "A token from a previous 'Other Contacts' list call to retrieve only changes since the last sync; leave empty for an initial full sync. Applicable only when `other_contacts` is true.",- "title": "Sync Token",- "type": "string"- }- },- "title": "GetPeopleRequest",- "type": "object"- },- "name": "Get People",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "other_contacts": {- "default": {},- "description": "Contains the list of 'Other Contacts', potentially including tokens for pagination or future syncs. Populated when `other_contacts` is true.",- "title": "Other Contacts",- "type": "object"- },- "people_data": {- "default": {},- "description": "Contains the person's data as requested, populated when `other_contacts` is false and a single person is fetched.",- "title": "People Data",- "type": "object"- }- },- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "GetPeopleResponseWrapper",- "type": "object"- },- "slug": "GMAIL_GET_PEOPLE",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/contacts.other.readonly",- "https://www.googleapis.com/auth/contacts.other"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Get Profile",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Get Profile"- },- "description": "Retrieves key gmail profile information (email address, message/thread totals, history id) for a user.",- "input_parameters": {- "properties": {- "user_id": {- "default": "me",- "description": "The email address of the Gmail user whose profile is to be retrieved, or the special value 'me' to indicate the currently authenticated user.",- "examples": [- "[email protected]",- "me"- ],- "title": "User Id",- "type": "string"- }- },- "title": "GetProfileRequest",- "type": "object"- },- "name": "Get Profile",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "description": "The user's Gmail profile information. Key fields typically include 'emailAddress' (primary email), 'messagesTotal' (total messages), 'threadsTotal' (total threads), and 'historyId' (mailbox history ID).",- "title": "Response Data",- "type": "object"- }- },- "required": [- "response_data"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "GetProfileResponseWrapper",- "type": "object"- },- "slug": "GMAIL_GET_PROFILE",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": []- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "List drafts",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "List drafts"- },- "description": "Retrieves a paginated list of email drafts from a user's gmail account.",- "input_parameters": {- "properties": {- "max_results": {- "default": 1,- "description": "Maximum number of drafts to return per page.",- "examples": [- 10,- 100,- 500- ],- "maximum": 500,- "minimum": 1,- "title": "Max Results",- "type": "integer"- },- "page_token": {- "default": "",- "description": "Token from a previous response to retrieve a specific page of drafts.",- "examples": [- "CiaKJDhWSE5UURE9PSIsImMiOiJhYmMxMjMifQ=="- ],- "title": "Page Token",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's mailbox ID; use 'me' for the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "title": "ListDraftsRequest",- "type": "object"- },- "name": "List drafts",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "drafts": {- "description": "List of draft resources, each usually including draft 'id' and 'message' details.",- "items": {- "type": "object"- },- "title": "Drafts",- "type": "array"- },- "next_page_token": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Token for fetching the next page of drafts, if more are available.",- "title": "Next Page Token"- }- },- "required": [- "drafts"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "ListDraftsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_LIST_DRAFTS",- "tags": [- "important",- "openWorldHint",- "readOnlyHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "List Gmail labels",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "List Gmail labels"- },- "description": "Retrieves a list of all system and user-created labels for the specified gmail account.",- "input_parameters": {- "properties": {- "user_id": {- "default": "me",- "description": "Identifies the Gmail account (owner's email or 'me' for authenticated user) for which labels will be listed.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "title": "ListLabelsRequest",- "type": "object"- },- "name": "List Gmail labels",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "labels": {- "description": "Retrieved label resources, each providing `id`, `name`, `type` ('system'/'user'), `messageListVisibility` (message list visibility), and `labelListVisibility` (label list visibility).",- "items": {},- "title": "Labels",- "type": "array"- }- },- "required": [- "labels"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "ListLabelsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_LIST_LABELS",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/gmail.labels"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "List threads",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "List threads"- },- "description": "Retrieves a list of email threads from a gmail account, identified by `user id` (email address or 'me'), supporting filtering and pagination.",- "input_parameters": {- "properties": {- "max_results": {- "default": 10,- "description": "Maximum number of threads to return.",- "examples": [- "10",- "50",- "100"- ],- "maximum": 500,- "minimum": 1,- "title": "Max Results",- "type": "integer"- },- "page_token": {- "default": "",- "description": "Token from a previous response to retrieve a specific page of results; omit for the first page.",- "examples": [- "abcPageToken123"- ],- "title": "Page Token",- "type": "string"- },- "query": {- "default": "",- "description": "Filter for threads, using Gmail search query syntax (e.g., 'from:[email protected] is:unread').",- "examples": [- "is:unread",- "from:[email protected]",- "subject:important"- ],- "title": "Query",- "type": "string"- },- "user_id": {- "default": "me",- "description": "The user's email address or 'me' to specify the authenticated Gmail account.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "title": "ListThreadsRequest",- "type": "object"- },- "name": "List threads",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "next_page_token": {- "default": null,- "description": "Token for the next page of results; if present, use as `page_token` in a subsequent request to fetch more threads.",- "title": "Next Page Token",- "type": "string"- },- "threads": {- "description": "List of email thread resources, each usually containing 'id', 'snippet', and 'historyId'.",- "items": {},- "title": "Threads",- "type": "array"- }- },- "required": [- "threads"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "ListThreadsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_LIST_THREADS",- "tags": [- "readOnlyHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.metadata",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.readonly"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Modify thread labels",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Modify thread labels"- },- "description": "Adds or removes specified existing label ids from a gmail thread, affecting all its messages; ensure the thread id is valid.",- "input_parameters": {- "properties": {- "add_label_ids": {- "default": [],- "description": "List of label IDs to add to the thread; these labels must exist.",- "examples": [- [- "STARRED",- "INBOX"- ]- ],- "items": {- "type": "string"- },- "title": "Add Label Ids",- "type": "array"- },- "remove_label_ids": {- "default": [],- "description": "List of label IDs to remove from the thread; these labels must exist.",- "examples": [- [- "IMPORTANT",- "CATEGORY_UPDATES"- ]- ],- "items": {- "type": "string"- },- "title": "Remove Label Ids",- "type": "array"- },- "thread_id": {- "description": "Immutable ID of the thread to modify.",- "examples": [- "18ea7715b619f09c"- ],- "title": "Thread Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "[email protected]",- "me"- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "thread_id"- ],- "title": "ModifyThreadLabelsRequest",- "type": "object"- },- "name": "Modify thread labels",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_dict": {- "description": "Full Thread resource from the Gmail API as a dictionary, representing the thread's state after modification.",- "title": "Response Dict",- "type": "object"- },- "success": {- "description": "Indicates whether the labels were successfully modified on the thread.",- "title": "Success",- "type": "boolean"- }- },- "required": [- "success",- "response_dict"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "ModifyThreadLabelsResponseWrapper",- "type": "object"- },- "slug": "GMAIL_MODIFY_THREAD_LABELS",- "tags": [- "idempotentHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Move to Trash",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Move to Trash"- },- "description": "Moves an existing, non-deleted email message to the trash for the specified user.",- "input_parameters": {- "properties": {- "message_id": {- "description": "Identifier of the email message to move to trash.",- "examples": [- "1875f42779f726f2"- ],- "title": "Message Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "[email protected]",- "me"- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "message_id"- ],- "title": "MoveToTrashRequest",- "type": "object"- },- "name": "Move to Trash",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "email": {- "description": "The Message resource that was moved to trash, including ID, thread ID, and 'TRASH' in label IDs.",- "title": "Email",- "type": "object"- }- },- "required": [- "email"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "MoveToTrashResponseWrapper",- "type": "object"- },- "slug": "GMAIL_MOVE_TO_TRASH",- "tags": [- "destructiveHint",- "important",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Patch Label",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Patch Label"- },- "description": "Patches the specified label.",- "input_parameters": {- "properties": {- "color": {- "anyOf": [- {- "properties": {- "backgroundColor": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The background color of the label, represented as a hex string. Example: #ffffff",- "examples": [- "#ffffff"- ],- "title": "Backgroundcolor"- },- "textColor": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The text color of the label, represented as a hex string. Example: #000000",- "examples": [- "#000000"- ],- "title": "Textcolor"- }- },- "title": "PatchLabelColor",- "type": "object"- },- {- "type": "null"- }- ],- "default": null,- "description": "The color to assign to the label. Color is only available for labels that have their `type` set to `user`.",- "title": "Color",- "type": "object"- },- "id": {- "description": "The ID of the label to update.",- "examples": [- "LABEL_123"- ],- "title": "Id",- "type": "string"- },- "labelListVisibility": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The visibility of the label in the label list in the Gmail web interface.",- "examples": [- "labelShow",- "labelShowIfUnread",- "labelHide"- ],- "title": "Label List Visibility",- "type": "string"- },- "messageListVisibility": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The visibility of messages with this label in the message list in the Gmail web interface.",- "examples": [- "show",- "hide"- ],- "title": "Message List Visibility",- "type": "string"- },- "name": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The display name of the label.",- "examples": [- "My Updated Label"- ],- "title": "Name",- "type": "string"- },- "userId": {- "description": "The user's email address. The special value `me` can be used to indicate the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "userId",- "id"- ],- "title": "PatchLabelRequest",- "type": "object"- },- "name": "Patch Label",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "color": {- "anyOf": [- {- "properties": {- "backgroundColor": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The background color of the label, represented as a hex string. Example: #ffffff",- "examples": [- "#ffffff"- ],- "title": "Backgroundcolor"- },- "textColor": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The text color of the label, represented as a hex string. Example: #000000",- "examples": [- "#000000"- ],- "title": "Textcolor"- }- },- "title": "PatchLabelColor",- "type": "object"- },- {- "type": "null"- }- ],- "default": null,- "description": "The color assigned to the label.",- "title": "Color"- },- "id": {- "description": "The immutable ID of the label.",- "title": "Id",- "type": "string"- },- "labelListVisibility": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The visibility of the label in the label list in the Gmail web interface.",- "title": "Label List Visibility"- },- "messageListVisibility": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The visibility of messages with this label in the message list in the Gmail web interface.",- "title": "Message List Visibility"- },- "messagesTotal": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "default": null,- "description": "The total number of messages with this label.",- "title": "Messages Total"- },- "messagesUnread": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "default": null,- "description": "The number of unread messages with this label.",- "title": "Messages Unread"- },- "name": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The display name of the label.",- "title": "Name"- },- "threadsTotal": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "default": null,- "description": "The total number of threads with this label.",- "title": "Threads Total"- },- "threadsUnread": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "default": null,- "description": "The number of unread threads with this label.",- "title": "Threads Unread"- },- "type": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "The owner type for the label. User labels are created by the user and can be modified and deleted by the user and can be applied to any message or thread.",- "title": "Type"- }- },- "required": [- "id"- ],- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "LabelResponseWrapper",- "type": "object"- },- "slug": "GMAIL_PATCH_LABEL",- "tags": [- "idempotentHint",- "important",- "labels",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": []- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Remove label",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Remove label"- },- "description": "Permanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels.",- "input_parameters": {- "properties": {- "label_id": {- "description": "ID of the user-created label to be permanently deleted; must exist and not be a system label.",- "examples": [- "Label_123",- "Label_xyz789"- ],- "title": "Label Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "User's email address or 'me' for the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "label_id"- ],- "title": "RemoveLabelRequest",- "type": "object"- },- "name": "Remove label",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "success": {- "default": null,- "description": "True if the label deletion was successful (e.g., API returned 204 status).",- "title": "Success",- "type": "boolean"- }- },- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "RemoveLabelResponseWrapper",- "type": "object"- },- "slug": "GMAIL_REMOVE_LABEL",- "tags": [- "destructiveHint",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://www.googleapis.com/auth/gmail.modify"- ]- },- {- "deprecated": {- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "display_name": "Reply to email thread",- "is_deprecated": false,- "toolkit": {- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "version": "0_1",- "displayName": "Reply to email thread"- },- "description": "Sends a reply within a specific gmail thread using the original thread's subject, requiring a valid `thread id` and correctly formatted email addresses.",- "input_parameters": {- "properties": {- "bcc": {- "default": [],- "description": "BCC recipients' email addresses (hidden from other recipients).",- "examples": [- "[\"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Bcc",- "type": "array"- },- "cc": {- "default": [],- "description": "CC recipients' email addresses.",- "examples": [- "[\"[email protected]\", \"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Cc",- "type": "array"- },- "extra_recipients": {- "default": [],- "description": "Additional 'To' recipients' email addresses.",- "examples": [- "[\"[email protected]\", \"[email protected]\"]"- ],- "items": {- "type": "string"- },- "title": "Extra Recipients",- "type": "array"- },- "is_html": {- "default": false,- "description": "Indicates if `message_body` is HTML; if True, body must be valid HTML, if False, body should not contain HTML tags.",- "examples": [- "True",- "False"- ],- "title": "Is Html",- "type": "boolean"- },- "message_body": {- "description": "Content of the reply message, either plain text or HTML.",- "examples": [- "Dear Sir, Nice talking to you. Yours respectfully, John"- ],- "title": "Message Body",- "type": "string"- },- "recipient_email": {- "description": "Primary recipient's email address.",- "examples": [- ],- "title": "Recipient Email",- "type": "string"- },- "thread_id": {- "description": "Identifier of the Gmail thread for the reply.",- "examples": [- "x53r3vdevff"- ],- "title": "Thread Id",- "type": "string"- },- "user_id": {- "default": "me",- "description": "Identifier for the user sending the reply; 'me' refers to the authenticated user.",- "examples": [- "me",- ],- "title": "User Id",- "type": "string"- }- },- "required": [- "thread_id",- "message_body",- "recipient_email"- ],- "title": "ReplyToThreadRequest",- "type": "object"- },- "name": "Reply to email thread",- "no_auth": false,- "output_parameters": {- "properties": {- "data": {- "description": "Data from the action execution",- "properties": {- "response_data": {- "default": null,- "description": "Raw response data from the Gmail API after sending the reply, typically including the sent message's ID.",- "title": "Response Data",- "type": "object"- }- },- "title": "Data",- "type": "object"- },- "error": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Error if any occurred during the execution of the action",- "title": "Error"- },- "successful": {- "description": "Whether or not the action execution was successful or not",- "title": "Successful",- "type": "boolean"- }- },- "required": [- "data",- "successful"- ],- "title": "ReplyToThreadResponseWrapper",- "type": "object"- },- "slug": "GMAIL_REPLY_TO_THREAD",- "tags": [- "important",- "openWorldHint"- ],- "toolkit": {- "name": "gmail",- "slug": "gmail",- "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/gmail.svg"- },- "available_versions": [- "0_1",- "latest",- "latest:base"- ],- "version": "0_1",- "scopes": [- "https://mail.google.com/",- "https://www.googleapis.com/auth/gmail.modify",- "https://www.googleapis.com/auth/gmail.compose",- "https://www.googleapis.com/auth/gmail.send"- ]- }-]\ No newline at end of filediff --git a/fern/pages/src/examples/tool-generator/tool-generator.mdx b/fern/pages/src/examples/tool-generator/tool-generator.mdxdeleted file mode 100644index 41c1ad0ca..000000000--- a/fern/pages/src/examples/tool-generator/tool-generator.mdx+++ /dev/null@@ -1,99 +0,0 @@-----title: Tool Type Generator-image: "https://og.composio.dev/api/og?title=Tool%20Type%20Generator" # image for socials-description: "An example that show you how to showcase auth scheme and action params for tools"-keywords: "tool type generator, composio, sdk, tool calling"-subtitle: "Build your own platform using raw tool definitions"-hide-nav-links: true------This is a bit of a checky tutorial as it is dogfooding the `docs` tool generation process.--To motivate this example clearly, in our tools section — we have details about let's say [`Github`](/tools/github) tool, that shows its auth scheme, actions and their params.--Now why would anyone outside of Composio want to do this? Well if you are building a platform on top of Composio, perchance a Workflow builder like langflow. You would want to show some or all of this information to your users.--This is a non standard use case, that we support and love users building on top of us but if this is uninteresting to you, you can skip this tutorial.--## How does one build a tool type generator?--In composio, we have two internal states for tools--1. Raw tool definition-2. Provider tool definition--The raw tool definition is an generic input output schema definition that we internally for tools, we expose it for customers if they want to build on top of it but it is not the primary way tools are normally used.--The provider tool definition, translates this raw tool definition to the specific schema of a provider (by default `openai`).--For building something like this, we need to use the raw tool definition.---## Getting the raw tool definition--Of course, you need to initiate the `Composio` sdk first and use a `COMPOSIO_API_KEY` environment variable.---<SnippetCode src="fern/generators/tool_doc_generator/main.py" path="tool_doc_generator/main.py" startLine={532} endLine={534} relativeHighlightStart={2} relativeHighlightEnd={2} wordWrap />---Let us see an example output for a raw `GMAIL` toolkit, with all of its tools.--this is just a taste but you can see the full output [here](https://github.com/composio-dev/composio/blob/next/fern/pages/src/examples/tool-generator/output.json).--<SnippetCode src="./output.json" path="output.json" startLine={1} endLine={100} />--```sh-jq '.[0] | keys' pages/src/examples/tool-generator/output.json-[- "available_versions",- "deprecated",- "description",- "input_parameters",- "name",- "no_auth",- "output_parameters",- "scopes",- "slug",- "tags",- "toolkit",- "version"-]-```--There is a bunch of useful information here, around the `input_parameters` and `output_parameters` for this example but `scopes` is very valuable to know what permissions are required for this tool.--Now from these `input_parameters` and `output_parameters` you can showcase the tool definitions.---<SnippetCode src="fern/generators/tool_doc_generator/main.py" path="tool_doc_generator/main.py" startLine={346} endLine={355} />--There is a bunch of other processing things happening here that are super generally relevant, so not going to call them out here that said there is another thing i want to showcase--## Toolkit Information--Toolkis are what we call apps or integrations, for us they are a collection of tools. `GMAIL` has `GMAIL_SEND_EMAIL` as a tool.--Now for building something out like this, you might also want information about the toolkit itself.--A toolkit has information like `categories` or `auth_schemes`--<SnippetCode src="fern/generators/tool_doc_generator/main.py" path="tool_doc_generator/main.py" startLine={534} endLine={537} />--`auth_schemes` here are `OAUTH2`, `API_KEY` or `BASIC_AUTH`, etc — essentially the types of how one could authenticate with the toolkit.--<SnippetCode src="fern/generators/tool_doc_generator/main.py" path="tool_doc_generator/main.py" startLine={543} endLine={552} />--Here is a way to parse the `auth_scheme` data---these are `tuple` objects as they have different schema for specific conditions like `auth_config_creation` or `connected_account_initiation`--they also have `required` and `optional` fields.--the context here is there are some fields you need while creating an auth config and some you need while connecting an account. this separation is done by the `tuple` here--<SnippetCode src="fern/generators/tool_doc_generator/main.py" path="tool_doc_generator/main.py" startLine={224} endLine={268} />---This is a fairly minimal explanation for the amount of code, as most of it is not super related to composio but it will be a good example on seeing behind the scenes of how composio is working and how to leverage the platform further.\ No newline at end of filediff --git a/fern/pages/src/examples/utility_agents/gmail_labeler.mdx b/fern/pages/src/examples/utility_agents/gmail_labeler.mdxdeleted file mode 100644index 4e3aee718..000000000--- a/fern/pages/src/examples/utility_agents/gmail_labeler.mdx+++ /dev/null@@ -1,384 +0,0 @@-----title: Gmail Labeler-subtitle: Build an agent that automatically labels incoming Gmail messages using triggers-image: "https://og.composio.dev/api/og?title=Gmail%20Labeler" # image for socials-description: Build an Gmail auto labeler agent with Composio and Langchain-keywords: gmail labeler, utility agent, triggers------With Composio's managed authentication, tool calling and triggers, it's easy to-build the AI agents that can interact and react the real world events reducing-the boilerplate required to setup and manage the authentication. This cookbook-will walk you through the process of building agents using `Composio`, `LangChain`.--## Prerequisites--* Python3.x-* [UV](https://docs.astral.sh/uv/getting-started/installation/)-* Composio API key-* OpenAI API key-* Understanding of building AI agents (Preferably with LangChain)--## Build gmail agent to label your messages--```python-from composio import Composio-from composio_langchain import LangchainProvider--from langchain import hub-from langchain.agents import AgentExecutor, create_openai_functions_agent-from langchain_openai import ChatOpenAI---def create_agent(user_id: str, composio_client: Composio[LangchainProvider]):- """- Create an agent for a given user id.- """- # Step 1: Get all the tools- tools = composio_client.tools.get(- user_id=user_id,- tools=[- "GMAIL_LIST_LABELS",- "GMAIL_ADD_LABEL_TO_EMAIL",- "GMAIL_CREATE_LABEL",- ],- )-- # Step 2: Pull relevant agent prompt.- prompt = hub.pull("hwchase17/openai-functions-agent")-- # Step 3: Initialize chat model.- openai_client = ChatOpenAI(model="gpt-5")-- # Step 4: Define agent- return AgentExecutor(- agent=create_openai_functions_agent(- openai_client,- tools,- prompt,- ),- tools=tools,- verbose=False,- )-```--## Authenticating users--To authenticate your users with Composio you need an auth config for the given-app, In this case you need one for gmail. You can create and manage auth configs-from the [dashboard](https://platform.composio.dev/?next_page=/auth-configs?create_auth_config=gmail).-Composio platform provides composio managed authentication for some apps to help-you fast-track your development, `gmail` being one of them. You can use these-default auth configs for development, but for production you should always use-your own oauth app configuration.--Using dashboard is the preferred way of managing authentication configs, but if-you want to do it manually you can follow the guide below--<details>--<summary>Click to expand</summary>--To create an authentication config for `gmail` you need `client_id` and `client_secret`-from your from your [Google OAuth Console](https://developers.google.com/identity/protocols/oauth2).-Once you have the required credentials you can use the following piece of-code to set up authentication for `gmail`.--```python-from composio import Composio-from composio_langchain import LangchainProvider--def create_auth_config(composio_client: Composio[OpenAIProvider]):- """- Create a auth config for the gmail toolkit.- """- client_id = os.getenv("GMAIL_CLIENT_ID")- client_secret = os.getenv("GMAIL_CLIENT_SECRET")- if not client_id or not client_secret:- raise ValueError("GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET must be set")-- return composio_client.auth_configs.create(- toolkit="gmail",- options={- "name": "default_gmail_auth_config",- "type": "use_custom_auth",- "auth_scheme": "OAUTH2",- "credentials": {- "client_id": client_id,- "client_secret": client_secret,- },- },- )-```--This will create an authentication config for `gmail` which you can use to-authenticate your users for your app. Ideally you should just create one-authentication object per project, so check for an existing auth config-before you create a new one.--```python-def fetch_auth_config(composio_client: Composio[OpenAIProvider]):- """- Fetch the auth config for a given user id.- """- auth_configs = composio_client.auth_configs.list()- for auth_config in auth_configs.items:- if auth_config.toolkit == "gmail":- return auth_config-- return None-```-</details>--Once you have authentication management in place, we can start with connecting-your users to your `gmail` app. Let's implement a function to connect the users-to your `gmail` app via composio.--```python-# Function to initiate a connected account-def create_connection(composio_client: Composio[OpenAIProvider], user_id: str):- """- Create a connection for a given user id and auth config id.- """- # Fetch or create the auth config for the gmail toolkit- auth_config = fetch_auth_config(composio_client=composio_client)- if not auth_config:- auth_config = create_auth_config(composio_client=composio_client)-- # Create a connection for the user- return composio_client.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config.id,- )-```--Now, when creating tools for your agent always check if the user already has a-connected account before creating a new one.--```python-def check_connected_account_exists(- composio_client: Composio[LangchainProvider],- user_id: str,-):- """- Check if a connected account exists for a given user id.- """- # Fetch all connected accounts for the user- connected_accounts = composio_client.connected_accounts.list(- user_ids=[user_id],- toolkit_slugs=["GMAIL"],- )-- # Check if there's an active connected account- for account in connected_accounts.items:- if account.status == "ACTIVE":- return True-- # Ideally you should not have inactive accounts, but if you do, you should delete them- print(f"[warning] inactive account {account.id} found for user id: {user_id}")- return False-```---## Creating Triggers--You can use triggers to make your agents react to real world events. In this example,-we will use triggers to invoke your agent everytime there's a new message in your-gmail inbox.--```python-# Create a new trigger-def create_trigger(- composio_client: Composio[LangchainProvider],- connected_account_id: str,-) -> str:- """- Create a trigger.- """- response = composio_client.triggers.create(- slug="GMAIL_NEW_GMAIL_MESSAGE",- connected_account_id=connected_account_id,- trigger_config={},- )- return response.trigger_id-```--When creating triggers, make sure there are no duplicate triggers. Use following-code as reference for checking if trigger for given connected account exists or not.--```python-def check_trigger_exists(- composio_client: Composio[LangchainProvider],- connected_account_id: str,-) -> t.Optional[str]:- """- Check if a trigger exists.- """- triggers = composio_client.triggers.list_active(- trigger_names=["GMAIL_NEW_GMAIL_MESSAGE"],- connected_account_ids=[connected_account_id],- )- for trigger in triggers.items:- return trigger.id- return None-```---Once trigger is created, you can listen to events using a trigger subscription.--```python-# Create subscription object-trigger_subscription = composio_client.triggers.subscribe()--# Register event handler-@trigger_subscription.handle(- trigger_id="<TRIGGER_ID>", # Filter out events that does not belong this trigger id- trigger_slug="GMAIL_NEW_GMAIL_MESSAGE",-)-def handle_event(event: TriggerEvent):- print("> Received email with subject: ", event["payload"]["subject"])--# Wait for events-trigger_subscription.wait_forever()-```--## Putting everything together--Let's put together everything by making the agent react to new messages in your-inbox.--```python-# Create a trigger subscription factory--def create_trigger_subscription(- composio_client: Composio[LangchainProvider],- trigger_slug: str,- trigger_id: str,- agent: AgentExecutor,-):- """- Create a trigger subscription for the given agent.- """- trigger_subscription = composio_client.triggers.subscribe()-- @trigger_subscription.handle(- trigger_slug=trigger_slug,- trigger_id=trigger_id,- )- def handle_event(event: TriggerEvent):- print("> Received email with subject: ", event["payload"]["subject"])- result = agent.invoke(- input={- "input": APPLY_NEW_LABEL.format( # Check `gmail_labeler/prompt.py`- message_id=event["payload"]["id"],- message_subject=event["payload"]["subject"],- message_text=event["payload"]["message_text"],- )- }- )- print("> Result: ", result["output"])-- return trigger_subscription-```--Package everything as a single entry point.--```python-def run_agent(user_id: str):- # Create composio client- composio_client = Composio(provider=LangchainProvider())-- # Validate conected account- connected_account_id = check_connected_account_exists(composio_client, user_id)- if connected_account_id is None:- connection_request = create_connection(composio_client, user_id)- print(- f"Authenticate with the following link: {connection_request.redirect_url}"- )- connection_request.wait_for_connection()- connected_account_id = connection_request.id-- # Check if trigger exists, create if not- trigger_id = check_trigger_exists(- composio_client=composio_client,- connected_account_id=connected_account_id,- )- if trigger_id is None:- trigger_id = create_trigger(- composio_client=composio_client,- connected_account_id=connected_account_id,- )-- # Create agent- agent = create_agent(user_id=user_id, composio_client=composio_client)-- # Create trigger subscription- trigger_subscription = create_trigger_subscription(- composio_client=composio_client,- trigger_slug=GMAIL_NEW_GMAIL_MESSAGE_TRIGGER,- trigger_id=trigger_id,- agent=agent,- )-- # Wait forever- print("Waiting for events...")- trigger_subscription.wait_forever()-```--To test the above function as CLI, follow the steps below--1. Clone the repository- ```bash- git clone [email protected]:composiohq/gmail-labeler- cd gmail-labeler/- ```-2. Setup environment- ```bash- cp .env.example .env- ```-- Fill the api keys- ```dotenv- COMPOSIO_API_KEY=- OPENAI_API_KEY=- ```-- Create the virtual env- ```bash- make env- source .venv/bin/activate- ```-3. Run the agent- ```bash- python gmail_labeler --user-id "default"- ```--## Using Composio for managed auth and tools--Composio reduces a lot of boilerplate for building AI agents with ability access and use a wide variety of apps. For example in this cookbook, to build `gmail` integration without composio you would have to write code to-- manage `gmail` oauth app-- manage user connections-- tools for your agents to interact with `gmail`-- Infra for listening to changes in your gmail inbox--Using composio simplifies all of the above to a few lines of code as we've seen the cookbook.--## Best practices--**🔒 User Management**:--- Use unique, consistent `user_id` values for each person-- Each user maintains their own gmail connection-- User IDs can be email addresses, usernames, or any unique identifier--## Troubleshooting--**Connection Issues**:-- Ensure your `.env` file has valid `COMPOSIO_API_KEY` and `OPENAI_API_KEY`-- Check that the user has completed `gmail` authorization-- Verify the user_id matches exactly between requests--**API Errors**:-- Check the server logs for detailed error messages-- Ensure request payloads match the expected format-- Visit `/docs` endpoint for API schema validationdiff --git a/fern/pages/src/examples/utility_agents/slack_summariser.mdx b/fern/pages/src/examples/utility_agents/slack_summariser.mdxdeleted file mode 100644index cb71b05c0..000000000--- a/fern/pages/src/examples/utility_agents/slack_summariser.mdx+++ /dev/null@@ -1,306 +0,0 @@-----title: Slack summariser-subtitle: Build an agent that summarizes Slack channel messages-image: "https://og.composio.dev/api/og?title=Slack%20summariser" # image for socials-description: Build a slack summarizer using Composio and Langchain-keywords: slack, summariser, utility agent------With Composio's managed authentication and tool calling, it's easy to build the-AI agents that can interact with the real world while reducing the boilerplate-required to setup and manage the authentication. This cookbook will walk you through-the process of building agents using `Composio`, `LangChain`.--## Prerequisites--* Python3.x-* [UV](https://docs.astral.sh/uv/getting-started/installation/)-* Composio API key-* OpenAI API key-* Understanding of building AI agents (Preferably with LangChain)--## Build slack agent--Let's start by building an agent that can interact with your slack workspace using Composio.--```python-from composio import Composio-from composio_langchain import LangchainProvider--from langchain import hub-from langchain.agents import AgentExecutor, create_openai_functions_agent-from langchain_openai import ChatOpenAI---def create_agent(user_id: str, composio_client: Composio[LangchainProvider]):- """- Create an agent for a given user id.- """- # Step 1: Get all the tools- tools = composio_client.tools.get(- user_id=user_id,- toolkits=["SLACK"],- )-- # Step 2: Pull relevant agent prompt.- prompt = hub.pull("hwchase17/openai-functions-agent")-- # Step 3: Initialize chat model.- openai_client = ChatOpenAI(model="gpt-5")-- # Step 4: Define agent- return AgentExecutor(- agent=create_openai_functions_agent(- openai_client,- tools,- prompt,- ),- tools=tools,- verbose=True,- )-```---## Authenticating users--To authenticate your users with Composio you need an auth config for the given-app, In this case you need one for slack. You can create and manage auth configs-from the [dashboard](https://platform.composio.dev/?next_page=/auth-configs?create_auth_config=slack).--Composio platform provides composio managed authentication for some apps to help-you fast-track your development, `slack` being one of them. You can use these-default auth configs for development, but for production you should always use-your own oauth app configuration.--Using dashboard is the preferred way of managing authentication configs, but if-you want to do it manually you can follow the guide below--<details>--<summary>Click to expand</summary>-------To create an authentication config for `slack` you need `client_id` and `client_secret`-from your Slack [App](https://api.slack.com/apps). Once you have the required credentials-you can use the following piece of code to set up authentication for `slack`.--```python-from composio import Composio-from composio_langchain import LangchainProvider--def create_auth_config(composio_client: Composio[OpenAIProvider]):- """- Create a auth config for the slack toolkit.- """- client_id = os.getenv("SLACK_CLIENT_ID")- client_secret = os.getenv("SLACK_CLIENT_SECRET")- if not client_id or not client_secret:- raise ValueError("SLACK_CLIENT_ID and SLACK_CLIENT_SECRET must be set")-- return composio_client.auth_configs.create(- toolkit="SLACK",- options={- "name": "default_slack_auth_config",- "type": "use_custom_auth",- "auth_scheme": "OAUTH2",- "credentials": {- "client_id": client_id,- "client_secret": client_secret,- },- },- )-```--This will create an authentication config for `slack` which you can use to-authenticate your users for your app. Ideally you should just create one-authentication object per project, so check for an existing auth config-before you create a new one.--```python-def fetch_auth_config(composio_client: Composio[OpenAIProvider]):- """- Fetch the auth config for a given user id.- """- auth_configs = composio_client.auth_configs.list()- for auth_config in auth_configs.items:- if auth_config.toolkit == "SLACK":- return auth_config-- return None-```-</details>--Once you have authentication management in place, we can start with connecting-your users to your `slack` app. Let's implement a function to connect the users-to your `slack` app via composio.--```python--# Function to initiate a connected account-def create_connection(composio_client: Composio[OpenAIProvider], user_id: str):- """- Create a connection for a given user id and auth config id.- """- # Fetch or create the auth config for the slack toolkit- auth_config = fetch_auth_config(composio_client=composio_client)- if not auth_config:- auth_config = create_auth_config(composio_client=composio_client)-- # Create a connection for the user- return composio_client.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config.id,- )-```--Now, when creating tools for your agent always check if the user already has a-connected account before creating a new one.--```python-def check_connected_account_exists(- composio_client: Composio[LangchainProvider],- user_id: str,-):- """- Check if a connected account exists for a given user id.- """- # Fetch all connected accounts for the user- connected_accounts = composio_client.connected_accounts.list(- user_ids=[user_id],- toolkit_slugs=["SLACK"],- )-- # Check if there's an active connected account- for account in connected_accounts.items:- if account.status == "ACTIVE":- return True-- # Ideally you should not have inactive accounts, but if you do, you should delete them- print(f"[warning] inactive account {account.id} found for user id: {user_id}")- return False-```--## Modifiers--In the current setup, we are expanding too much unnecessary tokens because response-from `SLACK_FETCH_CONVERSATION_HISTORY` tool call contains too much unnecessary-information. This can be fixed using `after_execute` modifier. An after execute-modifier is called after a tool execution is complete, here you can process-and modify the response object to make it more easy to consume for your agent.--```python-from composio import after_execute-from composio.types import ToolExecutionResponse---@after_execute(tools=["SLACK_FETCH_CONVERSATION_HISTORY"])-def clean_conversation_history(- tool: str,- toolkit: str,- response: ToolExecutionResponse,-) -> ToolExecutionResponse:- """- Clean the conversation history.- """- if not response["data"]["ok"]:- return response-- try:- response["data"]["messages"] = [- {"user": message["user"], "text": message["text"]}- for message in response["data"]["messages"]- if message["type"] == "message"- ]- except KeyError:- pass-- return response-```--To register modifiers, include them in the `composio.tools.get` call.--```python-tools = composio_client.tools.get(- user_id=user_id,- toolkits=[SLACK_TOOLKIT],- modifiers=[clean_conversation_history],-)-```--## Putting everything together--So far, we have created an agent with ability to interact with your `slack`-workspace using the `composio` SDK, functions to manage connected accounts-for users and a simple agent runner. Let's package this as a CLI tool.--```python-def run_agent(user_id: str, prompt: str):- composio_client = Composio(provider=LangchainProvider())- if not check_connected_account_exists(composio_client, user_id):- connection_request = create_connection(composio_client, user_id)- print(- f"Authenticate with the following link: {connection_request.redirect_url}"- )- connection_request.wait_for_connection()-- agent = create_agent(user_id, composio_client)- agent.invoke({"input": prompt})-```--To test the above function as CLI, follow the steps below--1. Clone the repository- ```bash- git clone [email protected]:composiohq/slack-summarizer- cd slack-summarizer/- ```-2. Setup environment- ```bash- cp .env.example .env- ```-- Fill the api keys- ```dotenv- COMPOSIO_API_KEY=- OPENAI_API_KEY=- ```-- Create the virtual env- ```bash- make env- source .venv/bin/activate- ```-3. Run the agent- ```bash- python slack_summariser --user-id "default" --prompt "summarise last 5 messages from #general channel"- ```--## Using Composio for managed auth and tools--Composio reduces a lot of boilerplate for building AI agents with ability access and use a wide variety of apps. For example in this cookbook, to build `slack` integration without composio you would have to write code to-- manage `slack` oauth app-- manage user connections-- tools for your agents to interact with `slack`--Using composio simplifies all of the above to a few lines of code as we've seen the cookbook.--## Best practices--**🔒 User Management**:--- Use unique, consistent `user_id` values for each person-- Each user maintains their own slack connection-- User IDs can be email addresses, usernames, or any unique identifier--## Troubleshooting--**Connection Issues**:-- Ensure your `.env` file has valid `COMPOSIO_API_KEY` and `OPENAI_API_KEY`-- Check that the user has completed `slack` authorization-- Verify the user_id matches exactly between requests--**API Errors**:-- Check the server logs for detailed error messages-- Ensure request payloads match the expected format-- Visit `/docs` endpoint for API schema validationdiff --git a/fern/pages/src/examples/utility_agents/supabase_sql_agent.mdx b/fern/pages/src/examples/utility_agents/supabase_sql_agent.mdxdeleted file mode 100644index cacbfe56e..000000000--- a/fern/pages/src/examples/utility_agents/supabase_sql_agent.mdx+++ /dev/null@@ -1,257 +0,0 @@-----title: Supabase SQL Agent-subtitle: Build an agent that executes SQL queries on Supabase using natural language-image: "https://og.composio.dev/api/og?title=Supabase%20SQL%20Agent" # image for socials-description: Build a Supabase SQL Agent with Composio and LlamaIndex.-keywords: supabase, sql, agent, utility agent, llama-index------With Composio's managed authentication and tool calling, it's easy to build-AI agents that interact with the real world while reducing boilerplate for-setup and authentication management. This guide will walk you through using-the Supabase CLI agent built with `Composio` and `LlamaIndex`.---## Requirements--* Python 3.10+-* [UV](https://docs.astral.sh/uv/getting-started/installation/) (recommended) or pip-* Composio API key-* OpenAI API key-* Understanding of building AI agents (Preferably with LlamaIndex)--## Build an agent to perform Supabase tasks--```python-from composio import Composio-from composio_llamaindex import LlamaIndexProvider--from llama_index.llms.openai import OpenAI-from llama_index.core.agent.workflow import FunctionAgent-from llama_index.core.workflow import Context---def create_agent(user_id: str, composio_client: Composio[LlamaIndexProvider]):- """- Create a function agent that can perform Supabase tasks.- """-- # Setup client- llm = OpenAI(model="gpt-5")-- # Get All the tools- tools = composio_client.tools.get(- user_id=user_id,- tools=[- "SUPABASE_LIST_ALL_PROJECTS",- "SUPABASE_BETA_RUN_SQL_QUERY",- ],- )-- agent = FunctionAgent(- tools=tools,- llm=llm,- system_prompt=(- "You are a helpful assistant that can help with supabase queries."- ),- )-- # Since this is a continuosly running agent, we need to maintain state across- # different user messages- ctx = Context(workflow=agent)- return agent, ctx-```--This agent can convert your natural language queries to SQL queries and execute-them on supabase for you. For you agent to be able to execute queries, you need-to authenticate the agent for supabase.---## Authenticating users--To authenticate your users with Composio you need an auth config for the given-app, In this case you need one for supabase. You can create and manage auth configs-from the [dashboard](https://platform.composio.dev/?next_page=/auth-configs?create_auth_config=supabase).-Composio platform provides composio managed authentication for some apps to help-you fast-track your development, `supabase` being one of them. You can use these-default auth configs for development, but for production you should always use-your own oauth app configuration.--Using dashboard is the preferred way of managing authentication configs, but if-you want to do it manually you can follow the guide below--<details>--<summary>Click to expand</summary>-------To create an authentication config for `supabase` you need `client_id` and `client_secret`-from your from your [Google OAuth Console](https://developers.google.com/identity/protocols/oauth2).-Once you have the required credentials you can use the following piece of-code to set up authentication for `supabase`.--```python-from composio import Composio-from composio_langchain import LangchainProvider--def create_auth_config(composio_client: Composio[OpenAIProvider]):- """- Create a auth config for the supabase toolkit.- """- client_id = os.getenv("SUPABASE_CLIENT_ID")- client_secret = os.getenv("SUPABASE_CLIENT_SECRET")- if not client_id or not client_secret:- raise ValueError("SUPABASE_CLIENT_ID and SUPABASE_CLIENT_SECRET must be set")-- return composio_client.auth_configs.create(- toolkit="supabase",- options={- "name": "default_supabase_auth_config",- "type": "use_custom_auth",- "auth_scheme": "OAUTH2",- "credentials": {- "client_id": client_id,- "client_secret": client_secret,- },- },- )-```--This will create an authentication config for `supabase` which you can use to-authenticate your users for your app. Ideally you should just create one-authentication object per project, so check for an existing auth config-before you create a new one.--```python-def fetch_auth_config(composio_client: Composio[OpenAIProvider]):- """- Fetch the auth config for a given user id.- """- auth_configs = composio_client.auth_configs.list()- for auth_config in auth_configs.items:- if auth_config.toolkit == "supabase":- return auth_config-- return None-```-</details>--Once you have authentication management in place, we can start with connecting-your users to your `supabase` app. Let's implement a function to connect the users-to your `supabase` app via composio.--```python-# Function to initiate a connected account-def create_connection(composio_client: Composio[OpenAIProvider], user_id: str):- """- Create a connection for a given user id and auth config id.- """- # Fetch or create the auth config for the supabase toolkit- auth_config = fetch_auth_config(composio_client=composio_client)- if not auth_config:- auth_config = create_auth_config(composio_client=composio_client)-- # Create a connection for the user- return composio_client.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config.id,- )-```--Now, when creating tools for your agent always check if the user already has a-connected account before creating a new one.--```python-def check_connected_account_exists(- composio_client: Composio[LangchainProvider],- user_id: str,-):- """- Check if a connected account exists for a given user id.- """- # Fetch all connected accounts for the user- connected_accounts = composio_client.connected_accounts.list(- user_ids=[user_id],- toolkit_slugs=["SUPABASE"],- )-- # Check if there's an active connected account- for account in connected_accounts.items:- if account.status == "ACTIVE":- return True-- # Ideally you should not have inactive accounts, but if you do, you should delete them- print(f"[warning] inactive account {account.id} found for user id: {user_id}")- return False-```---## Create a chat loop--```python-async def run_loop(user_id: str):- # Initialize composio client.- composio_client = Composio(provider=LlamaIndexProvider())-- # Setup connection if required- if not check_connected_account_exists(- composio_client=composio_client,- user_id=user_id,- ):- connection_request = create_connection(- composio_client=composio_client,- user_id=user_id,- )- print(- f"Authenticate with the following link: {connection_request.redirect_url}"- )-- # Create agent- agent, ctx = create_agent(- user_id=user_id,- composio_client=composio_client,- )-- # Run a simple REPL loop- while True:- user_input = input("user > ")- if user_input.lower() == "exit":- break-- result = await agent.run(user_msg=user_input, ctx=ctx)- print("agent > ", result)- print("Exiting...")-```--## Using Composio for managed auth and tools--Composio reduces a lot of boilerplate for building AI agents with ability access-and use a wide variety of apps. For example in this cookbook, to build `supabase`-integration without composio you would have to write code to--- manage `supabase` oauth app-- manage user connections-- tools for your agents to interact with `supabase`--Using composio simplifies all of the above to a few lines of code as we've seen the cookbook.--## Best practices--**🔒 User Management**:--- Use unique, consistent `user_id` values for each person-- Each user maintains their own supabase connection-- User IDs can be email addresses, usernames, or any unique identifier--## Troubleshooting--**Connection Issues**:-- Ensure your `.env` file has valid `COMPOSIO_API_KEY` and `OPENAI_API_KEY`-- Check that the user has completed `supabase` authorization-- Verify the user_id matches exactly between requests--**API Errors**:-- Check the server logs for detailed error messages-- Ensure request payloads match the expected format-- Visit `/docs` endpoint for API schema validationdiff --git a/fern/pages/src/get-started/dev-setup.mdx b/fern/pages/src/get-started/dev-setup.mdxdeleted file mode 100644index b1118c00a..000000000--- a/fern/pages/src/get-started/dev-setup.mdx+++ /dev/null@@ -1,85 +0,0 @@-----title: IDE and Agent Setup-subtitle: 'Setup your AI IDE and agent to help you ship faster with Composio'-slug: /docs/dev-setup-image: "https://og.composio.dev/api/og?title=IDE%20and%20Agent%20Setup" # image for socials-keywords: ''-hide-nav-links: false------This comprehensive guide explains how to set up your IDE and coding agents to help you ship faster with Composio. We'll cover optimal configurations for popular editors and AI coding assistants.--<Tip>-For LLMs: Use [llms.txt](https://docs.composio.dev/llms.txt) to index our documentation-</Tip>--## Cursor-Cursor is an AI-powered code editor that can significantly accelerate your development with Composio. Here's how to set it up optimally.--### Index Documentation-Cursor can index documentation, making it easy to ask questions about Composio and get contextual answers while coding.--<Frame>- <img src="../../../assets/images/index-docs.png" alt="Index docs" />-</Frame>--### To index Composio documentation:--1. Open Cursor Settings (Shift + Cmd/Ctrl + J)-2. Navigate to "Features" → "Codebase indexing"-3. Add the Composio documentation URLs:--- https://docs.composio.dev-- https://github.com/ComposioHQ/composio (for source code reference)--Once indexed, you can ask questions directly in the chat!-<Frame>- <img src="../../../assets/images/ask-index-docs.png" alt="Index docs question" />-</Frame>---### Optimize Cursor with Custom Rules-To get the best experience building with Composio, add custom instructions to Cursor's AI system. This helps the AI understand Composio's patterns and best practices.--<Frame>- <img src="../../../assets/images/cursor-settings.png" alt="Cursor settings" />-</Frame>--**To add custom rules:**--1. Open Cursor Settings (Shift + Cmd/Ctrl + J)-2. Go to "General" → "Rules for AI"-3. Add the appropriate prompt below based on your language--```md-Below is a list of Composio documentation. Use your web and fetch capabilities to read the documentation you need.-[Composio Documentation](https://docs.composio.dev)--For AI agents and LLMs, we also provide a structured documentation index at:-[LLMs Text Documentation](https://docs.composio.dev/llms.txt)--- [Quickstart](https://docs.composio.dev/docs/quickstart.mdx): Add authenticated tool-calling to any LLM agent in three steps.-- [Configuration](https://docs.composio.dev/docs/configuration.mdx)-- [Providers](https://docs.composio.dev/docs/providers.mdx)-- [Executing Tools](https://docs.composio.dev/docs/executing-tools.mdx): Learn how to execute Composio's tools with different providers and frameworks-- [Authenticating Tools](https://docs.composio.dev/docs/authenticating-tools.mdx): Learn how to authenticate tools-- [Fetching and Filtering Tools](https://docs.composio.dev/docs/fetching-tools.mdx): Learn how to fetch and filter Composio's tools and toolkits-- [Modifying tool schemas](https://docs.composio.dev/docs/modifying-tool-schemas): Learn how to use schema modifiers to transform tool schemas before they are seen by agents.-- [Modifying tool inputs](https://docs.composio.dev/docs/modifying-tool-inputs): Learn how to use before execution modifiers to modify tool arguments before execution.-- [Modifying tool outputs](https://docs.composio.dev/docs/modifying-tool-outputs): Learn how to use after execution modifiers to transform tool results after execution.-- [Creating custom tools](https://docs.composio.dev/docs/custom-tools.mdx): Learn how to extend Composio's toolkits with your own tools-- [Custom Auth Configs](https://docs.composio.dev/docs/custom-auth-configs.mdx): Guide to using customizing auth configs for a toolkit-- [Programmatic Auth Configs](https://docs.composio.dev/docs/programmatic-auth-configs.mdx): Guide to creating auth configs programmatically-- [Custom Auth Parameters](https://docs.composio.dev/docs/custom-auth-params.mdx): Guide to injecting custom credentials in headers or parameters for a toolkit-- [Using Triggers](https://docs.composio.dev/docs/using-triggers.mdx): Send payloads to your system based on external events-- [OpenAI Providers](https://docs.composio.dev/providers/openai.mdx)-- [Anthropic Provider](https://docs.composio.dev/providers/anthropic.mdx)-- [LangGraph Provider](https://docs.composio.dev/providers/langgraph.mdx)-- [CrewAI Provider](https://docs.composio.dev/providers/crewai.mdx)-- [Vercel AI SDK Provider](https://docs.composio.dev/providers/vercel.mdx)-- [Google ADK Provider](https://docs.composio.dev/providers/google-adk.mdx)-- [OpenAI Agents Provider](https://docs.composio.dev/providers/openai-agents.mdx)-- [Mastra Provider](https://docs.composio.dev/providers/mastra.mdx)-- [Custom Providers](https://docs.composio.dev/toolsets/custom.mdx)--```diff --git a/fern/pages/src/get-started/providers.mdx b/fern/pages/src/get-started/providers.mdxdeleted file mode 100644index 928a6d409..000000000--- a/fern/pages/src/get-started/providers.mdx+++ /dev/null@@ -1,277 +0,0 @@-----title: Providers-subtitle: Use Composio with any AI framework-image: "https://og.composio.dev/api/og?title=Providers" # image for socials-keywords: ''-hide-nav-links: false------Providers in Composio act as bridges between your AI models and external tools. They transform Composio's tools into formats that different AI frameworks can understand and use, making it possible to integrate with any AI framework seamlessly.--## What are Providers?-Think of providers as translators. Different AI frameworks (like OpenAI, Anthropic Claude, or LangChain) expect tools to be formatted in their specific way. Instead of manually converting Composio tools for each framework, providers handle this transformation automatically.--For example:-- OpenAI expects tools in a specific JSON schema format with type: "function"-- Anthropic Claude expects tools with an input_schema structure-- LangChain expects tools as callable functions with specific parameters--Providers ensure that Composio tools work correctly with your chosen AI platform without you having to worry about the technical details.---## Using Providers-Here's how you can generate text with various providers using Composio SDK:--### Default Provider (OpenAI)-If you don't specify a provider, Composio uses the OpenAI provider by default:-<CodeGroup>-```python Python-from openai import OpenAI-from composio import Composio--# Initialize tools.-openai_client = OpenAI()-composio = Composio(api_key="your-composio-api-key")--# Define task.-task = "Star a repo composiohq/composio on GitHub"--# Get GitHub tools that are pre-configured-tools = composio.tools.get(user_id="default", toolkits=["GITHUB"])--# Get response from the LLM-response = openai_client.chat.completions.create(- model="gpt-4o-mini",- tools=tools,- messages=[- {"role": "system", "content": "You are a helpful assistant."},- {"role": "user", "content": task},- ],-)-print(response)--# Execute the function calls.-result = composio.provider.handle_tool_calls(response=response, user_id="default")-print(result)---```-```typescript TypeScript-import { Composio } from '@composio/core';--// Uses OpenAI provider automatically-const composio = new Composio({- apiKey: 'your-composio-api-key'-});--// Get tools formatted for OpenAI-const tools = await composio.tools.get('default', {- toolkits: ['github']-});--// Use with OpenAI-const completion = await openai.chat.completions.create({- model: 'gpt-4',- messages: [- { role: 'system', content: 'You are a helpful assistant.' },- { role: 'user', content: 'Star the repo composiohq/composio on GitHub' },- ],- tools: tools // Already formatted for OpenAI-});--// Execute the function calls.-const result = await composio.provider.handleToolCalls("[email protected]", completion)-console.log(result)--```-</CodeGroup>--### Using a Different Provider-Different providers may require additional packages:---<CodeGroup>-```shell Python-# Core SDK (includes OpenAI provider)-pip install composio==0.8.0--# Additional providers-pip install composio_anthropic==0.8.0-pip install composio_google==0.8.0-pip install composio_langchain==0.8.0-pip install composio_crewai==0.8.0-```-```shell Typescript-# Core SDK (includes OpenAI provider)-npm install @composio/core--# Additional providers-npm install @composio/anthropic-npm install @composio/google-npm install @composio/langchain-npm install @composio/vercel-```-</CodeGroup>--To use a different provider, specify it when initializing Composio:--<Tabs>-<Tab title="OpenAI (Default)">-OpenAI is a completion provider. You can use it to generate text, function calls.-<CodeGroup>-```python Python-from composio import Composio-from composio_openai import OpenAIProvider--composio = Composio(provider=OpenAIProvider())-```-```typescript TypeScript-import { Composio } from "@composio/core";-import { OpenAIProvider } from "@composio/openai";--const composio = new Composio({ provider: new OpenAIProvider() });--```--</CodeGroup>-</Tab>-<Tab title="Anthropic">-Anthropic is a completion provider. You can use it to generate text, function calls.-<CodeGroup>-```python Python-from composio import Composio-from composio_anthropic import AnthropicProvider--composio = Composio(provider=AnthropicProvider())-```-```typescript TypeScript-import { Composio } from "@composio/core";-import { AnthropicProvider } from "@composio/anthropic";-import { Anthropic } from "@anthropic-ai/sdk";--const composio = new Composio({ provider: new AnthropicProvider() });--```-</CodeGroup>-</Tab>-<Tab title="Vercel AI SDK">-```typescript TypeScript-import { Composio } from "@composio/core";-import { VercelProvider } from "@composio/vercel";--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--```-</Tab>-<Tab title="Mastra">-```typescript TypeScript-import { MastraProvider } from '@composio/mastra';-import { Agent } from '@mastra/core/agent';-import { Composio } from '@composio/core';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new MastraProvider(),-});--```--</Tab>-<Tab title="OpenAI Agents">-```python Python-import asyncio--from agents import Agent, Runner--from composio import Composio-from composio_openai_agents import OpenAIAgentsProvider--# Initialize Composio toolset-composio = Composio(provider=OpenAIAgentsProvider())-```-</Tab>-</Tabs>---## Supported Providers-Composio supports two different types of providers based on the type of AI framework you are using:--### Non-Agentic Providers-These providers work with AI platforms that use chat completion APIs, where you control the tool execution flow. The AI model analyzes your conversation and suggests which tools to use, but your code decides when and how to execute them.-With chat completion APIs, the typical flow is:--1. You send a message to the AI model along with available tools-2. The AI responds with either a text message or a request to use specific tools-3. If tools are requested, you execute them and send the results back to continue the conversation--<CardGroup cols={3}>- <Card- title="OpenAI Provider"- icon={<img src="../../../assets/images/openai-logo.svg" width="24" height="24" />}- href="/providers/openai"- >- Integrate with OpenAI's tool calling and agents.- </Card>- <Card- title="Anthropic Provider"- icon={<img src="../../../assets/images/anthropic-logo.svg" width="24" height="24" />}- href="/providers/anthropic"- >- Use Anthropic's Claude models with Composio tools.- </Card>- <Card- title="Gemini Provider"- icon={<img src="../../../assets/images/google-logo.svg" width="24" height="24" />}- href="/providers/google"- >- Integrate with Google's Gemini models.- </Card>-</CardGroup>--### Agentic Providers-These providers work with AI frameworks that can execute tools autonomously. The AI agent can decide to run tools on its own without your direct intervention.--<CardGroup cols={3}>- <Card- title="LangChain Provider"- icon={<img src="../../../assets/images/langgraph-logo.svg"/>}- href="/providers/langchain"- >- Add tools to LangChain agent flows.- </Card>- <Card- title="CrewAI Provider"- icon="fa-light fa-people-group"- href="/providers/crewai"- >- Enable tool calling in CrewAI multi-agent systems.- </Card>- <Card- title="Vercel AI SDK Provider"- icon={<img src="../../../assets/images/vercel-logo.svg" width="24" height="24" />}- href="/providers/vercel"- >- Use Composio tools with Vercel's AI SDK.- </Card>- <Card- title="OpenAI Agents Provider"- icon="fa-light fa-user-astronaut"- href="/providers/openai-agents"- >- Add tools to OpenAI's new Agents API.- </Card>- <Card- title="Mastra Provider"- icon="fa-light fa-cubes"- href="/providers/mastra"- >- Use Composio tools with Mastra agent framework.- </Card>-</CardGroup>--<Tip title="Custom Providers" icon="fa-light fa-puzzle">-Using a framework not yet supported by Composio? Create a custom provider in [TypeScript](/providers/custom/typescript) or [Python](/providers/custom/python)!-</Tip>diff --git a/fern/pages/src/get-started/quickstart.mdx b/fern/pages/src/get-started/quickstart.mdxdeleted file mode 100644index 8256d7e15..000000000--- a/fern/pages/src/get-started/quickstart.mdx+++ /dev/null@@ -1,117 +0,0 @@-----title: Quickstart-image: "https://og.composio.dev/api/og?title=Quickstart" # image for socials-description: "Add authenticated tool-calling to any LLM agent in three steps."-keywords: ""-subtitle: "Add composio tools to your AI agents"-hide-nav-links: false------This guide walks you through **authenticated tool calling**—the foundation of how Composio connects your AI agents to real-world actions.--You'll learn how to:-1. **Discover and add tools** relevant to your use case (e.g., Slack, GitHub, Notion) to your AI agent-2. **Authenticate tools** securely on behalf of a specific user, with fine-grained access control-3. **Enable your LLM** (like OpenAI, Claude, or LangChain) to invoke these tools reliably using structured tool call formats--## Prerequisites--Before you begin, ensure you have:--1. **A Composio account** - [Sign up here](https://platform.composio.dev) if you haven't already-2. **Python 3.10+** or **Node.js 18+** installed on your system-3. **Your API key** - Get it from the [developer dashboard](https://platform.composio.dev?next_page=/settings) and set it as an environment variable:--```bash-export COMPOSIO_API_KEY=your_api_key-```--## Install the SDK-First, install the Composio SDK for your preferred language:--<CodeGroup>-```bash title="Python" for="python"-pip install composio-```-```bash title="TypeScript" for="typescript"-npm install @composio/core-```-</CodeGroup>--## Authorize Tools & Run Them with an Agent-Composio supports multiple LLM providers. Here’s how to use Composio with some of the most popular ones:-<Tabs>-<Tab title="OpenAI Agent(Python)">-Install the OpenAI Agents provider!--**Installation**-```bash-pip install composio openai-agents composio-openai-agents-```--<SnippetCode- src="fern/snippets/get-started/python/quickstart.py"- startLine={1}- endLine={46}-/>-</Tab>-<Tab title="Anthropic (TypeScript)">-Install the Composio Anthropic provider--**Installation**-```bash-npm i @composio/core @composio/anthropic-npm i @anthropic-ai/sdk-```--<SnippetCode- src="fern/snippets/get-started/typescript/quickstart.ts"- startLine={1}- endLine={57}-/>--</Tab>-<Tab title="Vercel AI SDK (Typescript)">-Install the Composio Vercel Provider--**Installation**-```bash-npm i @composio/core @composio/vercel-npm i ai @ai-sdk/openai-```--<SnippetCode- src="fern/snippets/get-started/typescript/vercel-quickstart.ts"- startLine={1}- endLine={43}-/>--</Tab>-</Tabs>--<Note title="What just happened?">-You just:-1. Authorized a user account with Composio-2. Passed those tool permissions into an LLM framework-3. Let the LLM securely call real tools on the user’s behalf--All OAuth flows and tool execution were automatically handled by Composio.-</Note>---## Next steps--<CardGroup cols={2}>- <Card title="Use Providers" icon="fa-light fa-plug" href="/providers/openai">- Learn how to use Composio with various agent SDK and frameworks.- </Card>- <Card title="Work with tools" icon="fa-light fa-toolbox" href="/docs/executing-tools">- Learn how to work with tools and tool calling on a deeper level with Composio.- </Card>- <Card title="Manage authentication" icon="fa-light fa-key" href="/docs/custom-auth-configs">- Authorize tools for multiple users.- </Card>- <Card title="Triggers" icon="fa-light fa-bolt" href="/docs/using-triggers">- Listen for external events to trigger actions in your agents- </Card>-</CardGroup>\ No newline at end of filediff --git a/fern/pages/src/get-started/welcome.mdx b/fern/pages/src/get-started/welcome.mdxdeleted file mode 100644index 0b0cb5fa1..000000000--- a/fern/pages/src/get-started/welcome.mdx+++ /dev/null@@ -1,106 +0,0 @@-----title: Welcome to Composio-subtitle: Composio is the simplest way to connect AI agents to external tools and services.-image: "https://og.composio.dev/api/og?title=Welcome%20to%20Composio"-keywords: ''-hide-nav-links: false------<Launch>Tool Router is now out of beta. Go check it out!</Launch>-<Card icon="fa-light fa-sparkles" title="Tool Router" href="/tool-router/overview" >- Single MCP server and Tool that can search, authenticate, and execute across all Composio tools-</Card>--<CardGroup cols={2}>- <Card- icon="fa-light fa-key"- title="Managed authentication"- href="/docs/authenticating-tools"- >- Handle OAuth, API keys, and custom auth flows automatically- </Card>-- <Card- icon="fa-light fa-wrench"- title="Tool execution"- href="/docs/executing-tools"- >- Execute actions across 500+ toolkits with support for most AI frameworks- </Card>-- <Card- icon="fa-light fa-database"- title="MCP server"- href="/docs/mcp-quickstart"- >- Hosted MCP servers for all 500+ toolkits.- </Card>-- <Card- icon="fa-light fa-bolt"- title="Triggers"- href="/docs/using-triggers"- >- Subscribe to external events and trigger workflows automatically- </Card>-</CardGroup>--***--## Get started--<CardGroup cols={2}>- <Card icon="fa-light fa-rocket" title="Quickstart" href="/docs/quickstart">- Build your first agent- </Card>-- <Card icon="fa-light fa-code" title="Providers" href="/docs/providers">- Integrate with OpenAI, Anthropic, Vercel AI SDK, and more- </Card>-</CardGroup>--<Tabs>-<Tab title="Python">-<div style={{position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden', marginBottom: '20px', marginTop: '20px'}}>- <iframe- style={{position: 'absolute', top: 0, left: 0, width: '100%', height: '100%'}}- src="https://www.youtube.com/embed/wkqlR8322F4"- title="Composio Python Quickstart"- frameBorder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"- allowFullScreen- ></iframe>-</div>-</Tab>-<Tab title="TypeScript">-<div style={{position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden', marginBottom: '20px', marginTop: '20px'}}>- <iframe- style={{position: 'absolute', top: 0, left: 0, width: '100%', height: '100%'}}- src="https://www.youtube.com/embed/ZRGb4xGl-kc"- title="Composio TypeScript Quickstart"- frameBorder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"- allowFullScreen- ></iframe>-</div>-</Tab>-</Tabs>--***--## Why Composio?--Composio is the fastest way to enable your AI agents to take real-world actions—without dealing with individual API integrations, authentication flows, or complex tool formatting.--- **Access 500+ toolkits** out of the box across popular apps like Slack, GitHub, Notion, and more. [Browse toolkits →](/toolkits/introduction)-- **Enforce strict access and data controls** with [fine-grained permissions](/docs/authenticating-tools) for each tool and user.-- **Trigger agents and workflows** using [external events](/docs/using-triggers) (e.g., new message in Slack, new issue in GitHub).-- **Use MCP servers** for all 500+ toolkits, compatible with any [MCP client](/docs/mcp-quickstart).-- **Search, plan and authenticate** across all tools with [Tool Router](/tool-router/overview).-- **Integrate seamlessly** with frameworks like [OpenAI](/providers/openai), [Anthropic](/providers/anthropic), [LangChain](/providers/langchain), [Vercel AI SDK](/providers/vercel), and more.--***--## Community--Join our [Discord](https://discord.gg/composio) community!\ No newline at end of filediff --git a/fern/pages/src/mcp/providers.mdx b/fern/pages/src/mcp/providers.mdxdeleted file mode 100644index eafc70b1d..000000000--- a/fern/pages/src/mcp/providers.mdx+++ /dev/null@@ -1,43 +0,0 @@-----title: Provider integrations-image: "https://og.composio.dev/api/og?title=Provider%20integrations" # image for socials-subtitle: Connect MCP servers to AI frameworks------Integrate your MCP servers with popular AI SDKs and frameworks.--<Note>-Composio MCP servers only support Streamable HTTP transport.-</Note>--## Anthropic SDK--Use MCP servers with the Anthropic Claude API.--<CodeGroup>-<CodeGroupItem title="Python">-<SnippetCode src="fern/snippets/mcp/python/anthropic-provider.py" />-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-<SnippetCode src="fern/snippets/mcp/typescript/anthropic-provider.ts" />-</CodeGroupItem>-</CodeGroup>--## OpenAI SDK--Integrate MCP servers with OpenAI GPT models.--<CodeGroup>-<CodeGroupItem title="Python">-<SnippetCode src="fern/snippets/mcp/python/openai-provider.py" />-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-<SnippetCode src="fern/snippets/mcp/typescript/openai-provider.ts" />-</CodeGroupItem>-</CodeGroup>--## Mastra--Use MCP servers with Mastra framework.--<SnippetCode src="fern/snippets/mcp/typescript/mastra-provider.ts" />\ No newline at end of filediff --git a/fern/pages/src/mcp/quickstart.mdx b/fern/pages/src/mcp/quickstart.mdxdeleted file mode 100644index c95266077..000000000--- a/fern/pages/src/mcp/quickstart.mdx+++ /dev/null@@ -1,96 +0,0 @@-----title: MCP quickstart-image: "https://og.composio.dev/api/og?title=MCP%20quickstart" # image for socials-subtitle: Create your first MCP server-----[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) is an open-source standard for connecting AI applications to external tools. All the 500+ tools available in Composio are also available as MCP servers.--Composio lets you create MCP servers that handle authentication (OAuth, API keys), generate unique URLs for each user, and control which tools are exposed. You can combine multiple toolkits in a single server.--<Note>-Composio MCP servers only support Streamable HTTP transport.-</Note>--## Install the SDK-First, install the Composio SDK for your preferred language:--<CodeGroup>-```bash title="Python" for="python"-pip install composio-```-```bash title="TypeScript" for="typescript"-npm install @composio/core-```-</CodeGroup>--## Create an MCP server--<Steps>- <Step title="Initialize Composio">- <CodeGroup>- <SnippetCode src="fern/snippets/mcp/python/quickstart.py" title="Python" startLine={1} endLine={4} />- <SnippetCode src="fern/snippets/mcp/typescript/quickstart.ts" title="TypeScript" startLine={1} endLine={6} />- </CodeGroup>- </Step>-- <Step title="Create server configuration">- <Warning>- **Before you begin:** [Create an auth configuration](/docs/authenticating-tools#creating-an-auth-config) for your toolkit.- </Warning>-- Create an MCP server with your auth config. You can also set list of specific tools to enable across all toolkits-- <CodeGroup>- <SnippetCode src="fern/snippets/mcp/python/quickstart.py" title="Python" startLine={6} endLine={22} />- <SnippetCode src="fern/snippets/mcp/typescript/quickstart.ts" title="TypeScript" startLine={8} endLine={23} />- </CodeGroup>-- <Note>- **Alternative:** You can also create and manage MCP configs directly from the [Composio dashboard → MCP Configs](https://platform.composio.dev?next_page=/mcp-configs).- </Note>-- </Step>-- <Step title="Generate user URLs">- <Warning>- **Before generating URLs:** Users must authenticate with the toolkits configured in your MCP server. See [hosted authentication](/docs/authenticating-tools#hosted-authentication-connect-link) for how to connect user accounts.- </Warning>-- Get server URLs for your users to connect:-- <CodeGroup>- <SnippetCode src="fern/snippets/mcp/python/quickstart.py" title="Python" startLine={24} endLine={28} />- <SnippetCode src="fern/snippets/mcp/typescript/quickstart.ts" title="TypeScript" startLine={25} endLine={29} />- </CodeGroup>-- <Note>- If users haven't authenticated, the MCP server will still generate a URL but tools requiring authentication won't work until the user connects their accounts.- </Note>- </Step>-- <Step title="Use with AI providers">- Use the MCP server URL with your AI provider:-- <CodeGroup>- <SnippetCode src="fern/snippets/mcp/python/openai-client.py" title="OpenAI (Python)" />- <SnippetCode src="fern/snippets/mcp/python/anthropic-client.py" title="Anthropic (Python)" />- <SnippetCode src="fern/snippets/mcp/typescript/mastra-client.ts" title="Mastra (TypeScript)" />- </CodeGroup>-- </Step>-</Steps>--## Next steps--<Cards>- <Card title="Server management" href="/docs/mcp-server-management" icon="fa-light fa-server">- Create and manage MCP servers- </Card>- <Card title="Providers" href="/docs/mcp-providers" icon="fa-light fa-code">- Use with Anthropic, OpenAI, and other frameworks- </Card>-</Cards>--<Tip>-Need help? Join our [Discord](https://discord.com/invite/composio) or [raise an issue on GitHub](https://github.com/ComposioHQ/composio/issues/new?labels=bug).-</Tip>\ No newline at end of filediff --git a/fern/pages/src/mcp/server-management.mdx b/fern/pages/src/mcp/server-management.mdxdeleted file mode 100644index 27fbf2a7b..000000000--- a/fern/pages/src/mcp/server-management.mdx+++ /dev/null@@ -1,286 +0,0 @@-----title: Server management-image: "https://og.composio.dev/api/og?title=Server%20management" # image for socials-subtitle: Create, update, and manage MCP servers------This guide covers all server management operations for MCP servers.--## Create a server--<CodeGroup>-<CodeGroupItem title="Python">-```python-server = composio.mcp.create(- name="my-gmail-server",- toolkits=[{- "toolkit": "gmail",- "auth_config": "ac_xyz123"- }],- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]-)--print(f"Created server: {server.id}")-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-const server = await composio.mcp.create(- "my-gmail-server",- {- toolkits: [- {- authConfigId: "ac_xyz123",- toolkit: "gmail"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"],- manuallyManageConnections: false- }-);--console.log(`Created server: ${server.id}`);-```-</CodeGroupItem>-</CodeGroup>--## List servers--Find and filter your MCP servers.--<CodeGroup>-<CodeGroupItem title="Python">-```python-# List all servers-servers = composio.mcp.list()-print(f"Found {len(servers['items'])} servers")--# Filter by toolkit-gmail_servers = composio.mcp.list(- toolkits="gmail",- limit=20-)--# Filter by name-production_servers = composio.mcp.list(- name="production"-)-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-// List all servers-const servers = await composio.mcp.list({- limit: 10,- page: 1,- authConfigs: [],- toolkits: []-});-console.log(`Found ${servers.items.length} servers`);--// Filter by toolkit-const gmailServers = await composio.mcp.list({- limit: 20,- page: 1,- authConfigs: [],- toolkits: ["gmail"]-});--// Filter by name-const productionServers = await composio.mcp.list({- limit: 10,- page: 1,- authConfigs: [],- toolkits: [],- name: "production"-});-```-</CodeGroupItem>-</CodeGroup>--## Get server details--<CodeGroup>-<CodeGroupItem title="Python">-```python-# Get by ID-server = composio.mcp.get("mcp_server_id")-print(f"Server name: {server.name}")-print(f"Toolkits: {server.toolkits}")-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-// Get by ID-const server = await composio.mcp.get("mcp_server_id");--console.log(`Server: ${server.name}`);-console.log(`Toolkits: ${server.toolkits}`);-```-</CodeGroupItem>-</CodeGroup>--## Update a server--Modify server configuration, tools, or auth configs.--<CodeGroup>-<CodeGroupItem title="Python">-```python-updated = composio.mcp.update(- server_id="mcp_server_id",- name="updated-name",- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]-)-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-const updated = await composio.mcp.update(- "mcp_server_id",- {- name: "updated-name",- toolkits: [- {- toolkit: "gmail",- authConfigId: "ac_new_config"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"],- manuallyManageConnections: false- }-);--console.log(updated);-```-</CodeGroupItem>-</CodeGroup>--## Delete a server--<CodeGroup>-<CodeGroupItem title="Python">-```python-result = composio.mcp.delete("mcp_server_id")-if result['deleted']:- print("Server deleted successfully")-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-const result = await composio.mcp.delete("mcp_server_id");-if (result.deleted) {- console.log("Server deleted successfully");-}-```-</CodeGroupItem>-</CodeGroup>--## Multi-toolkit servers--Combine multiple services in a single MCP server.--<CodeGroup>-<CodeGroupItem title="Python">-```python-server = composio.mcp.create(- name="productivity-suite",- toolkits=[- {"toolkit": "gmail", "auth_config": "ac_gmail"},- {"toolkit": "slack", "auth_config": "ac_slack"},- {"toolkit": "github", "auth_config": "ac_github"}- ],- allowed_tools=[- "GMAIL_FETCH_EMAILS",- "SLACK_SEND_MESSAGE",- "GITHUB_CREATE_ISSUE"- ]-)-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-const server = await composio.mcp.create(- "productivity-suite",- {- toolkits: [- {- authConfigId: "ac_gmail",- toolkit: "gmail"- },- {- authConfigId: "ac_slack",- toolkit: "slack"- },- {- authConfigId: "ac_github",- toolkit: "github"- }- ],- allowedTools: [- "GMAIL_FETCH_EMAILS",- "SLACK_SEND_MESSAGE",- "GITHUB_CREATE_ISSUE"- ],- manuallyManageConnections: false- }-);-```-</CodeGroupItem>-</CodeGroup>--## Generate user URLs--After creating a server, generate unique URLs for each user.--<CodeGroup>-<CodeGroupItem title="Python">-```python-# Generate instance for user-instance = server.generate("[email protected]")--print(f"URL: {instance['url']}")-print(f"Tools: {instance['allowed_tools']}")--# Chat-based authentication is enabled by default-# Set manually_manage_connections=True to disable it:-instance_manual = server.generate(- "[email protected]",- manually_manage_connections=True-)-```-</CodeGroupItem>-<CodeGroupItem title="TypeScript">-```typescript-// Generate instance for user-const instance = await server.generate("[email protected]");--console.log("URL:", instance.url);-console.log("Tools:", instance.allowedTools);--// Chat-based authentication is enabled by default-// Set manuallyManageConnections: true to disable it:-const instanceManual = await composio.mcp.generate(- "[email protected]",- server.id,- { manuallyManageConnections: true }-);-```-</CodeGroupItem>-</CodeGroup>--<Note>-**Chat-based authentication:**-- **TypeScript**: Enabled by default (set `manuallyManageConnections=false` or omit it)-- **Python**: Enabled by default (set `manually_manage_connections=False` or omit it)--When enabled, the agent can authenticate users dynamically during conversation if they're missing required connections. Set `manuallyManageConnections=true` (TypeScript) or `manually_manage_connections=True` (Python) to disable it.-</Note>--## Best practices--- **Use descriptive names** - Makes servers easy to find-- **Limit tools appropriately** - Only include necessary tools-- **Reuse servers** - Don't create duplicates for same configuration-- **Store server IDs** - Keep track of created server IDs-diff --git a/fern/pages/src/migration-guide/index.mdx b/fern/pages/src/migration-guide/index.mdxdeleted file mode 100644index 34cfb2b2d..000000000--- a/fern/pages/src/migration-guide/index.mdx+++ /dev/null@@ -1,23 +0,0 @@-----title: Migration guides-subtitle: Guides for migrating to newer versions of Composio-image: "https://og.composio.dev/api/og?title=Migration%20guides"-keywords: "migration, upgrade, sdk, versioning"-hide-nav-links: false------## Available migration guides--<AccordionGroup>- <Accordion title="New SDK migration">- Migrate from the old Composio SDK to the new new SDK, including breaking changes, new features, and updated APIs.-- [View SDK migration guide →](/docs/migration-guide/new-sdk)- </Accordion>-- <Accordion title="Toolkit versioning migration">- Migrate to use the toolkit versioning system.-- [View versioning migration guide →](/docs/migration-guide/toolkit-versioning)- </Accordion>-</AccordionGroup>\ No newline at end of filediff --git a/fern/pages/src/migration-guide/new-sdk.mdx b/fern/pages/src/migration-guide/new-sdk.mdxdeleted file mode 100644index 27bc068eb..000000000--- a/fern/pages/src/migration-guide/new-sdk.mdx+++ /dev/null@@ -1,675 +0,0 @@-----title: Our next generation SDKs-subtitle: Learn more about Composio's next generation SDKs and how to migrate-image: "https://og.composio.dev/api/og?title=New%20SDK%20migration"-keywords: 'sdk, migration, upgrade'-hide-nav-links: false------In the last few months, we have experienced very rapid growth in usage of our platform. As such, our team has been working hard to radically improve the performance and developer experience of our platform.--A lot of these changes have happened in the background, but we are excited to finally share our new SDKs with you that complement our new infra.--The new API features improved usability, enhanced stability, and better scalability. The SDKs built on top of it simplify the developer experience, making it easier than ever to build useful agents.--## What's new?--A lot of the changes are on the infra side, but from the SDK point of view, here is what you can expect:-- Faster and more reliable tool execution-- A simpler but more opinionated SDK-- Much more intuitive and consistent naming conventions-- A vastly improved TypeScript SDK that is meaningfully more type-safe and has full feature parity with the Python SDK--There aren't too many new flashy features here (yet) mainly because we wanted to get the bones right — but we feel we have a solid foundation to ship incredible new experiences on top very quickly.---## State of the new SDK and what is happening with the old SDKs?--Currently, the new SDKs are in a preview release. These new SDKs come almost fully formed, we do not expect many breaking changes to them but are releasing them in a preview state to get feedback and make necessary changes before locking them in.--As we lock the new SDKs in place, we will deprecate support for the old SDKs. They will continue to work for the foreseeable future but are no longer actively maintained. We will continue to push security updates and fix any critical bugs but will not support any new functionality in them.--We urge you to upgrade to the new SDKs as soon as possible.---## Nomenclature--We have updated several key terms in the SDK and API to improve clarity and consistency. The following table summarizes these changes:--| Previous Term | Current Term | Definition |-|---------------|--------------------|--------------------------------------------------------------------------|-| Actions | Tools | Individual operations or capabilities that can be performed by an LLM agent |-| Apps | Toolkits | A collection of tools grouped under a single application |-| Integration | Auth Config | Configuration containing developer credentials and application-level settings such as scopes and API endpoints. Scoped to a toolkit. |-| Connection | Connected accounts | User-linked accounts associated with a toolkit |-| Entity ID | User ID | The identifier of the user performing the action (UUID or email) |-| Trigger | Trigger | An event that can be subscribed to |-| Toolsets | Providers | LLM or agent framework that can be used with Composio to create agents |--## Switch to nano IDs from UUIDs--We have transitioned from UUIDs to nano IDs throughout the platform for the following reasons:--- **Improved readability**: UUIDs are lengthy and difficult to read-- **Better usability**: Easier to copy with a single double-click-- **Better organization**: Nano IDs allow us to distinguish between different resource types through prefixes--| Feature | Nano ID Prefix | Example |-|-------------------|----------------|--------------------|-| Connected Account | `ca_` | `ca_8x9w2l3k5m` |-| Auth Config | `ac_` | `ac_1234567890` |-| Trigger | `ti_` | `ti_So9EQf8XnAcy` |--> **Note:** Nano IDs are short, unique, and prefixed to indicate the resource type.----## SDK Changes--Upgrade to the latest SDK version using the appropriate package manager:--<CodeGroup>-```python Python-pip install -U composio-```-```typescript TypeScript-npm install @composio/core-```-</CodeGroup>--Both SDKs now implement proper namespacing for each concept.--### User ID scoping--The concept of `entity_id` has been expanded and renamed to `user_id`.--All operations are now scoped to a user ID, including:-- Fetching tools-- Initiating connections-- Executing tools-- Managing triggers--This change provides explicit specification of the user for whom the action is being performed. When a user may have multiple accounts (such as work and personal Gmail connections), you can use the more specific connected account ID.--### Replacing ToolSets with [Providers](/docs/providers)--We have deprecated "toolsets" in favor of "providers". This change allows Composio to provide deeper standardization for tool implementation across different frameworks.--Previously, you needed to import and use a framework-specific `ComposioToolSet` class:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_tools.py"- startLine={1}- endLine={3}- title="Python (previous)"-/>--<SnippetCode- src="fern/snippets/migration/old_tools.ts"- startLine={1}- endLine={3}- title="TypeScript (previous)"-/>-</CodeGroup>--The SDK structure is now framework-agnostic and includes the OpenAI provider out of the box:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/providers.py"- startLine={1}- endLine={12}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/providers.ts"- startLine={1}- endLine={12}- title="TypeScript (current)"-/>-</CodeGroup>--You can now use the same tools across any framework with our unified interface, or create custom toolsets for frameworks we don't yet support.--Read more about [providers in our documentation](/docs/providers) and explore the [complete list of available providers](/providers/openai).--### Fetching and filtering tools--Previously, you could filter tools by:-- Apps-- Action names (tool names)-- Tags--You could also specify an `important` flag to retrieve the most important tools:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_tools.py"- startLine={1}- endLine={11}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_tools.ts"- startLine={1}- endLine={11}- title="TypeScript (previous)"-/>-</CodeGroup>--You can now filter tools by:-- Toolkits-- Tool slugs-- Limit parameter-- Search query--The `important` flag has been removed. Instead, tools are returned in order of importance by default:--<Note>Since `user_id` is now explicitly required, the `check_connected_accounts` flag is no longer necessary.</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_tools.py"- startLine={1}- endLine={17}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/new_tools.ts"- startLine={1}- endLine={25}- title="TypeScript (current)"-/>-</CodeGroup>--### Fetching raw tool data--To examine the raw schema definition of a tool for understanding input/output parameters or building custom logic around tool definitions, use the following methods:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/raw_tools.py"- startLine={1}- endLine={11}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/tool-calling/typescript/raw_tools.ts"- startLine={1}- endLine={11}- title="TypeScript (current)"-/>-</CodeGroup>--### Executing tools--Tool execution remains largely unchanged, with `user_id` now explicitly required.--For agentic frameworks, the tool object returned from `tools.get` is now the respective framework's native tool object. Tool call execution is handled by the agentic framework itself.--<Note>-For non-agentic frameworks, Composio provides a helper function to execute tool calls.-</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_execute_tools.py"- startLine={1}- endLine={17}- title="Python v3"- highlightStart={16}- highlightEnd={16}-/>--<SnippetCode- src="fern/snippets/migration/new_execute_tools.ts"- startLine={1}- endLine={30}- title="TypeScript v3"- highlightStart={27}- highlightEnd={27}-/>-</CodeGroup>--For more information on executing tools for different frameworks, see [Replacing ToolSets with Providers](#replacing-toolsets-with-providers).--### Tool Modifiers (formerly Tool Processors)--Tool processors have been renamed to *tool modifiers* and now provide an improved developer experience. The implementation is now available in TypeScript too! (previously Python-only).--<SnippetCode- src="fern/snippets/migration/old_tool_modifiers.py"- startLine={1}- endLine={23}- title="Python (previous)"-/>--| Previous | Current |-|-------------------|-------------------------|-| `pre` processor | `beforeExecute` modifier |-| `post` processor | `afterExecute` modifier |-| `schema` processor| `schema` modifier |--The modifiers now leverage language-specific features to provide a more natural developer experience.--While tool processors could previously be applied during SDK initialization, tool fetching, and tool execution, we have restructured them as follows:-- **Chat Completion providers**: Modifiers are specified and applied during tool execution-- **Agentic frameworks**: Modifiers are specified and applied during tool fetching--#### [Schema Modifiers](/docs/modifying-tool-schemas)--The following example demonstrates schema modifier usage, applicable across all providers:--<CodeGroup>-```python Python (current)-from composio import Composio, schema_modifier-from composio.types import Tool--user_id = "[email protected]"--@schema_modifier(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def modify_schema(- tool: str,- toolkit: str,- schema: Tool,-) -> Tool:- _ = schema.input_parameters["properties"].pop("page", None)- schema.input_parameters["required"] = ["size"]- return schema--tools = composio.tools.get(- user_id=user_id,- tools=["HACKERNEWS_GET_LATEST_POSTS", "HACKERNEWS_GET_USER"],- modifiers=[- modify_schema,- ]-)-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={1}- endLine={26}- title="TypeScript (current)"-/>-</CodeGroup>--#### [Before Modifiers](/docs/modifying-tool-inputs)--The following example shows creating and using a before modifier for a Chat Completion provider. For agentic frameworks, view the [complete before modifier documentation](/docs/modifying-tool-inputs):--<CodeGroup>-```python Python (current)-@before_execute(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def before_execute_modifier(- tool: str,- toolkit: str,- params: ToolExecuteParams,-) -> ToolExecuteParams:- params["arguments"]["size"] = 1- return params---# Get tools-tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_LATEST_POSTS")-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={53}- endLine={68}- title="TypeScript (current)"-/>-</CodeGroup>--#### [After Modifiers](/docs/modifying-tool-outputs)--The following example shows creating and using an after modifier for a Chat Completion provider. For agentic frameworks, view the [complete after modifier documentation](/docs/modifying-tool-outputs):--<CodeGroup>--```python Python (current)-@after_execute(tools=["HACKERNEWS_GET_USER"])-def after_execute_modifier(- tool: str,- toolkit: str,- response: ToolExecutionResponse,-) -> ToolExecutionResponse:- return {- **response,- "data": {- "karma": response["data"]["karma"],- },- }--tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_USER")-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={69}- endLine={90}- title="TypeScript (current)"-/>-</CodeGroup>--### Custom Tools--The SDK continues to support custom tools. [Creating tools from your methods](/docs/custom-tools#creating-a-custom-tool) remains possible. We recommend reviewing the [detailed custom tools documentation](/docs/custom-tools#creating-a-custom-tool) for more information.--Due to changes in the SDK architecture, creating custom tools that use Composio's managed authentication has been modified. In the previous SDK, you could create a custom tool as follows:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_custom_tools.py"- startLine={1}- endLine={39}- highlightStart={14}- highlightEnd={17}- title="Python (previous)"-/>--<SnippetCode- src="fern/snippets/migration/old_custom_tools.ts"- startLine={1}- endLine={39}- highlightStart={16}- highlightEnd={20}- title="TypeScript (previous)"-/>-</CodeGroup>--The *execute tool request* method handles injection of the appropriate base URL and authentication credentials for the tool:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_custom_tools.py"- startLine={1}- endLine={39}- highlightStart={22}- highlightEnd={22}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/new_custom_tools.ts"- startLine={1}- endLine={39}- highlightStart={17}- highlightEnd={17}- title="TypeScript (current)"-/>-</CodeGroup>--For more information, including executing custom tools and defining custom headers and query parameters, refer to the [Custom Tools](/docs/custom-tools) documentation.--### Auth configs (formerly integrations)--Integrations are now called *auth configs*. While the terminology has changed, the underlying concept remains the same.--Auth configs store the configuration required for authentication with a given toolkit, including OAuth developer credentials, configurable base URLs, and scopes.--Auth configs now use nano IDs instead of UUIDs:--| Previous (UUID) Example | Current (Nano ID) Example |-| :----------------------------------- | :------------------------ |-| `b7a9c1e2-3f4d-4a6b-8c2e-1d2f3a4b5c6d` | `ac_8x9w2l3k5m` |--We recommend storing auth config nano IDs in your database for connecting users to the appropriate auth configuration.--For most use cases, you will create auth configs through the dashboard, and this process remains unchanged. Read more about [creating auth configs](/docs/authenticating-tools#creating-an-auth-config) and [customizing auth configs](/docs/custom-auth-configs).--Creating auth configs programmatically in the previous SDK:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_auth_config.py"- startLine={1}- endLine={15}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_auth_config.ts"- startLine={1}- endLine={15}- title="TypeScript (previous)"-/>-</CodeGroup>--Creating auth configs programmatically in the current SDK:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_auth_config.py"- startLine={1}- endLine={15}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_auth_config.ts"- startLine={1}- endLine={15}- title="TypeScript (current)"-/>-</CodeGroup>--For using custom authentication credentials, refer to the [Programmatic Auth Configs](/docs/programmatic-auth-configs) documentation.--<Note>The callback URL for creating custom OAuth configs is now `https://backend.composio.dev/api/v3/toolkits/auth/callback`. The previous URL was `https://backend.composio.dev/api/v1/auth-apps/add`.</Note>--### Connected accounts / User IDs--The primary change in connected accounts and user IDs is that user IDs are now a more prominent concept compared to entities in previous versions.--We have simplified the process of connecting a user to a toolkit. Instead of multiple methods and parameters for initiating a connection, both the SDK and API now require only a `user_id` and `auth_config_id` to initiate a connection.--This approach is more explicit and works well with the ability for developers to have multiple auth configs for a given toolkit.--Connected accounts now use nano IDs instead of UUIDs:--| Previous (UUID) Example | Current (Nano ID) Example |-| :----------------------------------- | :------------------------ |-| `b7a9c1e2-3f4d-4a6b-8c2e-1d2f3a4b5c6d` | `ca_8x9w2l3k5m` |--Previously, you might have initiated a connection like this:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_connected_acc.py"- startLine={1}- endLine={30}- highlightStart={11}- highlightEnd={16}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_connected_acc.ts"- startLine={1}- endLine={30}- highlightStart={8}- highlightEnd={13}- title="TypeScript (previous)"-/>-</CodeGroup>--The current process for initiating a connection is as follows:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_connected_acc.py"- startLine={1}- endLine={15}- highlightStart={8}- highlightEnd={11}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_connected_acc.ts"- startLine={1}- endLine={15}- highlightStart={8}- highlightEnd={11}- title="TypeScript (current)"-/>-</CodeGroup>--### Triggers--Composio continues to support listening to application events using triggers through WebSockets and webhooks.--#### Creating triggers--The process for creating triggers and specifying their configuration has been redesigned for improved clarity and intuitiveness.--Some triggers require configuration, such as repository names for GitHub triggers or channel names for Slack triggers. The process usually follows the pattern of fetching the trigger type and then creating the trigger with the appropriate configuration.--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_triggers.py"- startLine={1}- endLine={33}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_triggers.ts"- startLine={1}- endLine={35}- title="TypeScript (current)"-/>-</CodeGroup>--#### Enabling/Disabling triggers--You can enable or disable triggers through either the SDK or the dashboard. The dashboard process remains unchanged.--Managing triggers with the SDK:--<CodeGroup>- ```python Python maxLines=60 wordWrap- # Disable a trigger instance- disabled_instance = composio.triggers.disable(trigger_id="ti_abcd123")- print(disabled_instance)- ```- ```typescript TypeScript maxLines=60 wordWrap- await composio.triggers.disable("ti_abcd123");- ```-</CodeGroup>--If needed, the trigger can be enabled again.--<CodeGroup>- ```python Python maxLines=60 wordWrap- # Enable a trigger instance- enabled_instance = composio.triggers.enable(trigger_id="ti_abcd123")- print(enabled_instance)- ```- ```typescript TypeScript maxLines=60 wordWrap- await composio.triggers.enable("ti_abcd123");- ```-</CodeGroup>--#### Listening to triggers--We recommend listening to triggers through webhooks. The following are example routes for Next.js and FastAPI.--For development, you can also [listen to triggers through the SDK](/docs/using-triggers#subscribing-to-triggers-using-the-sdk-for-development).--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/python/trigger-webhook.py"- title="app/route.py (FastAPI)"-/>-<SnippetCode- src="fern/snippets/triggers/typescript/trigger-webhook.ts"- title="app/api/webhook/route.ts (Next.js)"-/>-</CodeGroup>--## 🚧 Coming Soon--### Local tools--Previously, the Python SDK included *[local tools](https://github.com/ComposioHQ/composio/tree/master/python/composio/tools/local)*. These were tools defined within the SDK and consisted of local shell and code-related tools such as "clipboard", "sqltool", and "shelltool".--This feature is currently in development for both Python and TypeScript SDKs, with newly created tools built for improved agent accuracy.--{/* ### Generated types--In the previous Python SDK, you could generate types for tools using the CLI:--```bash-composio apps generate-types-```--This provided app slugs and tool slugs with IntelliSense support:--```python Python (previous)-from composio_openai import ComposioToolSet, App, Action--print(App.GITHUB)-print(Action.GITHUB_CREATE_ISSUE)-``` */}--This feature is currently in development for both Python and TypeScript SDKs.--## API Endpoints--The following table lists important API endpoints that have changed. You can use this reference to quickly find the new v3 API endpoint for migration:--<Note>This list is not exhaustive. Please refer to the [API Reference](/api-reference) for the complete list of endpoints.</Note>--### Toolkits (formerly Apps)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/apps`](https://docs.composio.dev/api-reference/api-reference/apps/get-apps) | [`GET /api/v3/toolkits`](https://docs.composio.dev/api-reference/toolkits/get-toolkits) |-| [`GET /api/v1/apps/list/categories`](https://docs.composio.dev/api-reference/api-reference/apps/list-app-categories) | [`GET /api/v3/toolkits/categories`](https://docs.composio.dev/api-reference/toolkits/get-toolkits-categories) |-| [`GET /api/v1/apps/{appName}`](https://docs.composio.dev/api-reference/api-reference/apps/get-app) | [`GET /api/v3/toolkits/{slug}`](https://docs.composio.dev/api-reference/toolkits/get-toolkits-by-slug) |--### Tools (formerly Actions)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v2/actions`](https://docs.composio.dev/api-reference/api-reference/actions/list-actions-minimal-v-2) | [`GET /api/v3/tools`](https://docs.composio.dev/api-reference/tools/get-tools) |-| [`GET /api/v2/actions/list/enums`](https://docs.composio.dev/api-reference/api-reference/actions/list-action-enums) | [`GET /api/v3/tools/enum`](https://docs.composio.dev/api-reference/tools/get-tools-enum) |-| [`GET /api/v2/actions/{actionId}`](https://docs.composio.dev/api-reference/api-reference/actions/get-action-v-2) | [`GET /api/v3/tools/{tool_slug}`](https://docs.composio.dev/api-reference/tools/get-tools-by-tool-slug) |-| [`POST /api/v2/actions/{actionId}/execute`](https://docs.composio.dev/api-reference/api-reference/actions/execute-action-v-2) | [`POST /api/v3/tools/execute/{tool_slug}`](https://docs.composio.dev/api-reference/tools/post-tools-execute-by-tool-slug)|-| [`POST /api/v2/actions/{actionId}/execute/get.inputs`](https://docs.composio.dev/api-reference/api-reference/actions/get-action-inputs-v-2)| [`POST /api/v3/tools/execute/{tool_slug}/input`](https://docs.composio.dev/api-reference/tools/post-tools-execute-by-tool-slug-input)|-| [`POST /api/v2/actions/proxy`](https://docs.composio.dev/api-reference/api-reference/actions/execute-action-proxy-v-2) | [`POST /api/v3/tools/execute/proxy`](https://docs.composio.dev/api-reference/tools/post-tools-execute-proxy)|--### Auth Configs (formerly Integrations/Connectors)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/integrations`](https://docs.composio.dev/api-reference/api-reference/integrations/list-all-connectors) | [`GET /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/get-auth-configs) |-| [`POST /api/v1/integrations`](https://docs.composio.dev/api-reference/api-reference/integrations/create-connector) | [`POST /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/post-auth-configs) |-| [`GET /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/get-connector-info) | [`GET /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/get-auth-configs-by-nanoid) |-| [`PATCH /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/modify-connector) | [`PATCH /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/patch-auth-configs-by-nanoid) |-| [`DELETE /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/delete-connector) | [`DELETE /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/delete-auth-configs-by-nanoid) |-| [`POST /api/v2/integrations/create`](https://docs.composio.dev/api-reference/api-reference/integrations-v-2/create-connector-v-2) | [`POST /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/post-auth-configs) |--### Connected Accounts (formerly Connections)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/connectedAccounts`](https://docs.composio.dev/api-reference/api-reference/connections/get-connections) | [`GET /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/get-connected-accounts) |-| [`POST /api/v1/connectedAccounts`](https://docs.composio.dev/api-reference/api-reference/connections/initiate-connection) | [`POST /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts) |-| [`POST /api/v2/connectedAccounts/initiateConnection`](https://docs.composio.dev/api-reference/api-reference/connectionsv-2/initiate-connection-v-2)| [`POST /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts) |-| [`GET /api/v1/connectedAccounts/{connectedAccountId}`](https://docs.composio.dev/api-reference/api-reference/connections/get-connection)| [`GET /api/v3/connected_accounts/{nanoid}`](https://docs.composio.dev/api-reference/connected-accounts/get-connected-accounts-by-nanoid)|-| [`DELETE /api/v1/connectedAccounts/{connectedAccountId}`](https://docs.composio.dev/api-reference/api-reference/connections/delete-connection)| [`DELETE /api/v3/connected_accounts/{nanoid}`](https://docs.composio.dev/api-reference/connected-accounts/delete-connected-accounts-by-nanoid) |-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/disable`](https://docs.composio.dev/api-reference/api-reference/connections/disable-connection)| [`PATCH /api/v3/connected_accounts/{nanoId}/status`](https://docs.composio.dev/api-reference/connected-accounts/patch-connected-accounts-by-nano-id-status)|-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/enable`](https://docs.composio.dev/api-reference/api-reference/connections/enable-connection) | [`PATCH /api/v3/connected_accounts/{nanoId}/status`](https://docs.composio.dev/api-reference/connected-accounts/patch-connected-accounts-by-nano-id-status)|-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/reinitiate`](https://docs.composio.dev/api-reference/api-reference/connections/reinitiate-connection)| [`POST /api/v3/connected_accounts/{nanoid}/refresh`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts-by-nanoid-refresh)|--### Triggers--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/triggers`](https://docs.composio.dev/api-reference/api-reference/triggers/list-triggers) | [`GET /api/v3/triggers_types`](https://docs.composio.dev/api-reference/triggers/get-triggers-types) |-| [`GET /api/v1/triggers/list/enums`](https://docs.composio.dev/api-reference/api-reference/triggers/list-trigger-enums) | [`GET /api/v3/triggers_types/list/enum`](https://docs.composio.dev/api-reference/triggers/get-triggers-types-list-enum)|-| [`GET /api/v2/triggers/{triggerName}`](https://docs.composio.dev/api-reference/api-reference/triggers/get-trigger-info-v-2) | [`GET /api/v3/triggers_types/{slug}`](https://docs.composio.dev/api-reference/triggers/get-triggers-types-by-slug)|-| [`GET /api/v1/triggers/active_triggers`](https://docs.composio.dev/api-reference/api-reference/triggers/get-active-triggers)| [`GET /api/v3/trigger_instances/active`](https://docs.composio.dev/api-reference/triggers/get-trigger-instances-active)|-| [`POST /api/v1/triggers/enable/{connectedAccountId}/{triggerName}`](https://docs.composio.dev/api-reference/api-reference/triggers/enable-trigger)| [`POST /api/v3/trigger_instances/{slug}/upsert`](https://docs.composio.dev/api-reference/triggers/post-trigger-instances-by-slug-upsert)|-| [`DELETE /api/v1/triggers/instance/{triggerInstanceId}`](https://docs.composio.dev/api-reference/api-reference/triggers/delete-trigger)| [`DELETE /api/v3/trigger_instances/manage/{triggerId}`](https://docs.composio.dev/api-reference/triggers/delete-trigger-instances-manage-by-trigger-id)|-| [`PATCH /api/v1/triggers/instance/{triggerId}/status`](https://docs.composio.dev/api-reference/api-reference/triggers/switch-trigger-instance-status)| [`PATCH /api/v3/trigger_instances/manage/{triggerId}`](https://docs.composio.dev/api-reference/triggers/patch-trigger-instances-manage-by-trigger-id)|diff --git a/fern/pages/src/migration-guide/toolkit-versioning.mdx b/fern/pages/src/migration-guide/toolkit-versioning.mdxdeleted file mode 100644index 6cab52ed9..000000000--- a/fern/pages/src/migration-guide/toolkit-versioning.mdx+++ /dev/null@@ -1,115 +0,0 @@-----title: Toolkit versioning migration-subtitle: Migrate to the new toolkit versioning system-image: "https://og.composio.dev/api/og?title=Toolkit%20versioning%20migration"-keywords: "toolkit versioning, migration"-hide-nav-links: false------Starting with Python SDK v0.9.0 and TypeScript SDK v0.2.0, manual tool execution requires explicit version specification. This is a breaking change from earlier versions where toolkit versioning was optional.--## Breaking change--Manual tool execution now requires explicit version specification. The `tools.execute()` method will fail without a version.--### Before (will fail)--<CodeGroup>-```python Python-# Raises ToolVersionRequiredError-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {"user_id": "user-123", "arguments": {...}}-)-```--```typescript TypeScript-// Throws ComposioToolVersionRequiredError-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...}-});-```-</CodeGroup>--### After (required)--Choose one of three migration strategies:--#### Option 1: Configure version at SDK level--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/versioning-sdk-init.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"- title="TypeScript"-/>-</CodeGroup>--#### Option 2: Pass version with each execution--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/versioning-per-execution.py"- startLine={6}- endLine={15}- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"- startLine={6}- endLine={14}- title="TypeScript"-/>-</CodeGroup>--#### Option 3: Use environment variables--```bash-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"-```--## Migration checklist--1. **Audit your code**: Find all `tools.execute()` calls in your codebase-2. **Choose a strategy**: Select one of the three options above based on your needs-3. **Test thoroughly**: Verify tools work correctly with pinned versions-4. **Deploy gradually**: Roll out changes incrementally to minimize risk--## Temporary workaround--During migration, you can temporarily skip version checks (not recommended for production):--<CodeGroup>-```python Python-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {...}- },- dangerously_skip_version_check=True-)-```--```typescript TypeScript-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...},- dangerouslySkipVersionCheck: true-});-```-</CodeGroup>--<Warning>-The `dangerouslySkipVersionCheck` flag is only for migration or debugging. Never use in production.-</Warning>--## Next steps--For complete documentation on toolkit versioning, including best practices and advanced configuration, see [Toolkit versioning](/docs/toolkit-versioning).\ No newline at end of filediff --git a/fern/pages/src/providers/anthropic.mdx b/fern/pages/src/providers/anthropic.mdxdeleted file mode 100644index a0c18a4a3..000000000--- a/fern/pages/src/providers/anthropic.mdx+++ /dev/null@@ -1,108 +0,0 @@-----title: Anthropic Provider-subtitle: Use Composio tools with Claude-slug: /providers/anthropic-image: "https://og.composio.dev/api/og?title=Anthropic%20Provider" # image for socials-keywords: ""-hide-nav-links: false-------The Anthropic Provider transforms Composio tools into a format compatible with Anthropic's function calling capabilities through its Messages API.--## Setup-The Anthropic provider can be installed for both SDKs.--<CodeGroup>-```bash title="Python" for="python" maxLines=60 wordWrap-pip install composio composio-anthropic-```--```bash title="TypeScript" for="typescript" maxLines=60 wordWrap-npm install @composio/anthropic @anthropic-ai/sdk-```-</CodeGroup>--You can specify the provider in the constructor. The constructor also takes in an optional `cacheTools` parameter.--<CodeGroup>-```python Python maxLines=60 wordWrap-import anthropic--from composio import Composio-from composio_anthropic import AnthropicProvider--# Initialize tools.-anthropic_client = anthropic.Anthropic()-composio = Composio(provider=AnthropicProvider())-```--```typescript TypeScript maxLines=60 wordWrap {5}-import { Composio } from "@composio/core";-import { AnthropicProvider } from "@composio/anthropic";-import Anthropic from '@anthropic-ai/sdk';--const composio = new Composio({- provider: new AnthropicProvider({- cacheTools: false, // default- }),-});--const anthropic = new Anthropic();-```-</CodeGroup>--## Usage--<CodeGroup>-```python Python maxLines=60 wordWrap-# Define your user ID-user_id = "your-user-id"--# Get GitHub tool for listing stargazers-tools = composio.tools.get(user_id=user_id, tools=["GITHUB_LIST_STARGAZERS"])--# Get response from the LLM-response = anthropic_client.messages.create(- model="claude-sonnet-4-5",- max_tokens=1024,- tools=tools,- messages=[- {"role": "user", "content": "List my github stargazers. for the repo composiohq/composio"},- ],-)--# Execute the function calls.-result = composio.provider.handle_tool_calls(user_id=user_id, response=response)-print(result)-```--```typescript TypeScript maxLines=60 wordWrap-const userId = "your-user-id";-const tools = await composio.tools.get(userId, {- tools: ["GITHUB_LIST_STARGAZERS"]-})--const msg = await anthropic.messages.create({- model: "claude-sonnet-4-5",- messages: [- {- role: "user",- content: "List my github stargazers. for the repo composiohq/composio",- },- ],- tools: tools,- max_tokens: 1000,-});--const res = await composio.provider.handleToolCalls(userId, msg);--console.log(res[0].content);-```-</CodeGroup>---## Modifiers-Modifiers are functions that can be used to intercept and optionally modify the schema, the tool call request and the response from the tool call.--Anthropic provider modifiers are the standard framework modifiers. Read more here: [Modifying tool schemas](/docs/modifying-tool-schemas).\ No newline at end of filediff --git a/fern/pages/src/providers/crewai.mdx b/fern/pages/src/providers/crewai.mdxdeleted file mode 100644index 6b48f66e9..000000000--- a/fern/pages/src/providers/crewai.mdx+++ /dev/null@@ -1,64 +0,0 @@-----title: CrewAI Provider-subtitle: Use Composio tools with CrewAI agents-slug: /providers/crewai-image: "https://og.composio.dev/api/og?title=CrewAI%20Provider" # image for socials-keywords: ""-hide-nav-links: false------## CrewAI Provider--The CrewAI Provider formats the Composio tools into an object compatible with CrewAI's tool calling capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.--## Setup--The CrewAI provider is available for only the Python SDK.--```python Python maxLines=60 wordWrap-pip install composio_crewai==0.8.0-```--## Usage--```python Python maxLines=60 wordWrap-from crewai import Agent, Crew, Task-from langchain_openai import ChatOpenAI--from composio import Composio-from composio_crewai import CrewAIProvider--# Initialize tools.-openai_client = ChatOpenAI()-composio = Composio(provider=CrewAIProvider())--# Get All the tools-tools = composio.tools.get(user_id="default", toolkits=["GITHUB"])--# Define agent-crewai_agent = Agent(- role="Github Agent",- goal="""You take action on Github using Github APIs""",- backstory=(- "You are AI agent that is responsible for taking actions on Github "- "on users' behalf. You need to take action on Github using Github APIs"- ),- verbose=True,- tools=tools,- llm=openai_client,-)--# Define task-task = Task(- description=(- "Star a repo composiohq/composio on GitHub, if the action is successful "- "include Action executed successfully"- ),- agent=crewai_agent,- expected_output="if the star happened",-)--my_crew = Crew(agents=[crewai_agent], tasks=[task])-result = my_crew.kickoff()-print(result)-```\ No newline at end of filediff --git a/fern/pages/src/providers/google-adk.mdx b/fern/pages/src/providers/google-adk.mdxdeleted file mode 100644index 8acd3e880..000000000--- a/fern/pages/src/providers/google-adk.mdx+++ /dev/null@@ -1,20 +0,0 @@-----title: Google ADK Provider-subtitle: Use Composio with Google's ADK-slug: /providers/google-adk-image: "https://og.composio.dev/api/og?title=Google%20ADK%20Provider" # image for socials-keywords: ""-hide-nav-links: false------- [ ] Pending on Python SDK--## Google ADK Provider--The Google ADK Provider formats the Composio tools into an object compatible with Google's ADK capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.--## Setup--```typescript TypeScript maxLines=60 wordWrap--```\ No newline at end of filediff --git a/fern/pages/src/providers/google.mdx b/fern/pages/src/providers/google.mdxdeleted file mode 100644index 8418d0e6c..000000000--- a/fern/pages/src/providers/google.mdx+++ /dev/null@@ -1,58 +0,0 @@-----title: Google Gen AI Provider-subtitle: Use Composio with Gemini through the Google Gen AI SDK-slug: /providers/google-image: "https://og.composio.dev/api/og?title=Google%20Gen%20AI%20Provider" # image for socials-keywords: ""-hide-nav-links: false-----The Google provider transforms Composio tools into a format compatible with Gemini's function calling capabilities through it's API--## Setup-The Google Gen AI SDK and theprovider can only be installed for the Python SDK.--<CodeGroup>--```bash title="python" for="python"-pip install google-genai composio_google-```-```bash title="typescript" for="typescript"-npm install @google/genai-npm i @composio/core @composio/gemini-```--</CodeGroup>--<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/google.py"- startLine={1}- endLine={9}-/>-<SnippetCode- src="fern/snippets/providers/typescript/google.ts"- startLine={1}- endLine={12}-/>-</CodeGroup>--## Usage-<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/google.py"- startLine={10}- endLine={21}-/>-<SnippetCode- src="fern/snippets/providers/typescript/google.ts"- startLine={14}- endLine={39}-/>-</CodeGroup>--## Modifiers-Modifiers are functions that can be used to intercept and optionally **modify** the schema, the tool call request and the response from the tool call.--OpenAI provider modifiers are the standard framework modifiers.-Read more here: [Modifying tool schemas](/docs/modifying-tool-schemas)-diff --git a/fern/pages/src/providers/langchain.mdx b/fern/pages/src/providers/langchain.mdxdeleted file mode 100644index da6a6ce9f..000000000--- a/fern/pages/src/providers/langchain.mdx+++ /dev/null@@ -1,33 +0,0 @@-----title: LangChain Provider-subtitle: Use Composio tools with LangChain-slug: /providers/langchain-image: "https://og.composio.dev/api/og?title=LangChain%20Provider" # image for socials-keywords: ""-hide-nav-links: false------The LangChain Provider transforms Composio tools into a format compatible with LangChain's function calling capabilities.--## Setup-<CodeGroup>-```bash title="Python" for="python"-pip install composio_langchain==0.8.0 langchain-```-```bash title="TypeScript" for="typescript"-npm install @composio/langchain-```-</CodeGroup>--## Usage--<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/langchain-provider.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/providers/typescript/langchain.ts"- title="TypeScript"-/>-</CodeGroup>\ No newline at end of filediff --git a/fern/pages/src/providers/llamaindex.mdx b/fern/pages/src/providers/llamaindex.mdxdeleted file mode 100644index 89976aa5d..000000000--- a/fern/pages/src/providers/llamaindex.mdx+++ /dev/null@@ -1,44 +0,0 @@-----title: LlamaIndex Provider-subtitle: Use Composio tools with LlamaIndex-slug: /providers/llamaindex-image: "https://og.composio.dev/api/og?title=LlamaIndex%20Provider" # image for socials-keywords: ""-hide-nav-links: false------The LlamaIndex Provider transforms Composio tools into a format compatible with LlamaIndex's function calling capabilities.--## Setup-<CodeGroup>-```bash title="Python" for="python"-pip install composio_llamaindex==0.8.0 llama-index-```-```bash title="TypeScript" for="typescript"-npm install @composio/llamaindex @llamaindex/openai @llamaindex/workflow-```-</CodeGroup>--## Usage--<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/llamaindex-provider.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/providers/typescript/llamaindex-provider.ts"- title="TypeScript"-/>-</CodeGroup>--## Advanced Usage--### Streaming Agent with Multiple Toolkits--<CodeGroup>-<SnippetCode- src="fern/snippets/providers/typescript/llamaindex-streaming.ts"- title="TypeScript"-/>-</CodeGroup>\ No newline at end of filediff --git a/fern/pages/src/providers/mastra.mdx b/fern/pages/src/providers/mastra.mdxdeleted file mode 100644index 140c5f571..000000000--- a/fern/pages/src/providers/mastra.mdx+++ /dev/null@@ -1,66 +0,0 @@-----title: Mastra Provider-subtitle: Use Composio with Mastra's TypeScript framework-slug: /providers/mastra-image: "https://og.composio.dev/api/og?title=Mastra%20Provider" # image for socials-keywords: ""-hide-nav-links: false------Mastra is a TypeScript native framework for building agents with tools and MCPs. It expects tools to be in the following format:-- Inputs: What information the tool needs to run (defined with an `inputSchema`, often using Zod).-- Outputs: The structure of the data the tool returns (defined with an `outputSchema`).-- Execution Logic: The code that performs the tool's action.-- Description: Text that helps the agent understand what the tool does and when to use it.--More documentation [here](https://mastra.ai/en/docs/tools-mcp/overview#creating-tools)--The Mastra provider formats the Composio tools into this format along with the execution logic so that agents can call and execute the Composio tools.--## Setup--```typescript TypeScript maxLines=60 wordWrap-npm install @composio/mastra-```--You can specify the provider in the constructor.--```typescript TypeScript maxLines=60 wordWrap-import { Composio } from "@composio/core";-import { MastraProvider } from "@composio/mastra";-import { Agent } from "@mastra/core/agent";-import { openai } from "@ai-sdk/openai";--const composio = new Composio({- provider: new MastraProvider(),-});-```--## Usage--The tools are passed to the agent as a parameter.--```typescript TypeScript maxLines=60 wordWrap-const userId = "john doe";--const tools = await composio.tools.get(- userId,- {- toolkits: ["SUPABASE"],- }-);--const agent = new Agent({- name: "Supabase Agent",- instructions: "You think therefore you are.",- model: openai("gpt-4.1"),- tools: tools,-});--const { text } = await agent.generate([- { role: "user", content: "Tell me about my Supabase project" },-]);--console.log("\n🤖 Agent Response:\n");-console.log(text);-```\ No newline at end of filediff --git a/fern/pages/src/providers/openai-agents.mdx b/fern/pages/src/providers/openai-agents.mdxdeleted file mode 100644index 7fe505650..000000000--- a/fern/pages/src/providers/openai-agents.mdx+++ /dev/null@@ -1,47 +0,0 @@-----title: OpenAI Agents Provider-subtitle: Use Composio with OpenAI's Agents SDK-slug: /providers/openai-agents-image: "https://og.composio.dev/api/og?title=OpenAI%20Agents%20Provider" # image for socials-keywords: ""-hide-nav-links: false------## OpenAI Agents Provider--The OpenAI Agents Provider is a provider that formats the Composio tools into an object compatible with OpenAI's Agents API.--OpenAI Agents SDK is different from the OpenAI SDK. It helps build agentic AI apps in a lightweight, easy-to-use package with very few abstractions.--<Tabs>- <Tab title="Python">- ### Setup-- ```bash- pip install composio openai-agents composio-openai-agents- ```-- ### Usage-- <SnippetCode- src="fern/snippets/providers/python/openai-agents.py"- startLine={1}- endLine={26}- />- </Tab>- <Tab title="TypeScript">- ### Setup-- ```bash- npm install @composio/core @openai/agents @composio/openai-agents- ```-- ### Usage-- <SnippetCode- src="fern/snippets/providers/typescript/openai-agents.ts"- startLine={1}- endLine={33}- />- </Tab>-</Tabs>diff --git a/fern/pages/src/providers/openai.mdx b/fern/pages/src/providers/openai.mdxdeleted file mode 100644index 773e734b2..000000000--- a/fern/pages/src/providers/openai.mdx+++ /dev/null@@ -1,78 +0,0 @@-----title: OpenAI Providers-subtitle: Use Composio with OpenAI's Responses and Chat Completion APIs-slug: /providers/openai-image: "https://og.composio.dev/api/og?title=OpenAI%20Providers" # image for socials-keywords: ""-hide-nav-links: false------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.--## Setup-By default, the OpenAI Provider is installed when you install the Composio SDK. You can also install it manually:--<CodeGroup>-```bash title="Python" for="python"-pip install composio_openai-```-```bash title="TypeScript" for="typescript"-npm install @composio/openai-```-</CodeGroup>--## Responses API-The Responses API is the recommended way to build more agentic flows with the OpenAI API.-Read more about it in the [OpenAI documentation](https://platform.openai.com/docs/api-reference/responses)--<Note>-Before executing any tools that require authentication (like Gmail), you'll need to:-1. [Create an Auth Configuration](/docs/authenticating-tools#creating-an-auth-config) for your integration-2. [Set up a Connected Account](/docs/authenticating-tools#connecting-an-account) for the user.-</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/openai-responses-provider.py"- startLine={1}- endLine={39}-/>-<SnippetCode- src="fern/snippets/providers/typescript/openairesponses.ts"- startLine={1}- endLine={38}-/>--</CodeGroup>--## Chat Completion API-The Chat Completion API generates a model response from a list of messages. Read more about it in the [OpenAI documentation](https://platform.openai.com/docs/api-reference/chat).-The OpenAI Chat Provider is the default provider used by Composio SDK, but you can also explicitly initialise it.--<Note>-Before executing any tools that require authentication (like Gmail), you'll need to:-1. [Create an Auth Configuration](/docs/authenticating-tools#creating-an-auth-config) for your integration-2. [Set up a Connected Account](/docs/authenticating-tools#connecting-an-account) for the user.--</Note>-<CodeGroup>-<SnippetCode- src="fern/snippets/providers/python/openai-provider.py"- startLine={1}- endLine={25}-/>-<SnippetCode- src="fern/snippets/providers/typescript/openai.ts"- startLine={1}- endLine={40}-/>--</CodeGroup>---## Modifiers-Modifiers are functions that can be used to intercept and optionally **modify** the schema, the tool call request and the response from the tool call.--OpenAI provider modifiers are the standard framework modifiers.-Read more here: [Modifying tool schemas](/docs/modifying-tool-schemas)-diff --git a/fern/pages/src/providers/py-custom.mdx b/fern/pages/src/providers/py-custom.mdxdeleted file mode 100644index 5deb934a8..000000000--- a/fern/pages/src/providers/py-custom.mdx+++ /dev/null@@ -1,447 +0,0 @@-----title: Python Custom Provider-subtitle: Learn how to create custom providers for any AI framework in Python-image: "https://og.composio.dev/api/og?title=Python%20Custom%20Provider" # image for socials-keywords: ""-hide-nav-links: false------This guide shows how to create custom providers for the Composio Python SDK. Custom providers enable integration with different AI frameworks and platforms.--## Provider architecture--The Composio SDK uses a provider architecture to adapt tools for different AI frameworks. The provider handles:--1. **Tool format transformation**: Converting Composio tools into formats compatible with specific AI platforms-2. **Platform-specific integration**: Providing helper methods for seamless integration--## Types of providers--There are two types of providers:--1. **Non-agentic providers**: Transform tools for platforms that don't have their own agency (e.g., OpenAI, Anthropic)-2. **Agentic providers**: Transform tools for platforms that have their own agency (e.g., LangChain, CrewAI)--## Provider class hierarchy--```-BaseProvider (Abstract)-├── NonAgenticProvider (Abstract)-│ └── OpenAIProvider (Concrete)-│ └── AnthropicProvider (Concrete)-│ └── [Your Custom Non-Agentic Provider] (Concrete)-└── AgenticProvider (Abstract)- └── LangchainProvider (Concrete)- └── [Your Custom Agentic Provider] (Concrete)-```--## Quick start--The fastest way to create a new provider is using the provider scaffolding script:--```bash-# Create a non-agentic provider-make create-provider name=myprovider--# Create an agentic provider-make create-provider name=myagent agentic=true--# Create provider with custom output directory-make create-provider name=myprovider output=/path/to/custom/dir--# Combine options-make create-provider name=myagent agentic=true output=/my/custom/path-```--This will create a new provider in the specified directory (default: `python/providers/<provider-name>/`) with:-- Complete package structure with `pyproject.toml`-- Provider implementation template-- Demo script-- README with usage examples-- Type annotations and proper inheritance--<Tip>-The scaffolding script creates a fully functional provider template. You just need to implement the tool transformation logic specific to your platform. You can maintain your provider implementation in your own repository.-</Tip>--### Generated structure--The create-provider script generates the following structure:--```-python/providers/<provider-name>/-├── README.md # Documentation and usage examples-├── pyproject.toml # Project configuration-├── setup.py # Setup script for pip compatibility-├── <provider-name>_demo.py # Demo script showing usage-└── composio_<provider-name>/ # Package directory- ├── __init__.py # Package initialization- ├── provider.py # Provider implementation- └── py.typed # PEP 561 type marker-```--After generation, you can:-1. Navigate to the provider directory: `cd python/providers/<provider-name>`-2. Install in development mode: `uv pip install -e .`-3. Implement your provider logic in `composio_<provider-name>/provider.py`-4. Test with the demo script: `python <provider-name>_demo.py`--## Creating a non-agentic provider--Non-agentic providers inherit from the `NonAgenticProvider` abstract class:--```python-from typing import List, Optional, Sequence, TypeAlias-from composio.core.provider import NonAgenticProvider-from composio.types import Tool, Modifiers, ToolExecutionResponse--# Define your tool format-class MyAITool:- def __init__(self, name: str, description: str, parameters: dict):- self.name = name- self.description = description- self.parameters = parameters--# Define your tool collection format-MyAIToolCollection: TypeAlias = List[MyAITool]--# Create your provider-class MyAIProvider(NonAgenticProvider[MyAITool, MyAIToolCollection], name="my-ai-platform"):- """Custom provider for My AI Platform"""-- def wrap_tool(self, tool: Tool) -> MyAITool:- """Transform a single tool to platform format"""- return MyAITool(- name=tool.slug,- description=tool.description or "",- parameters={- "type": "object",- "properties": tool.input_parameters.get("properties", {}),- "required": tool.input_parameters.get("required", [])- }- )-- def wrap_tools(self, tools: Sequence[Tool]) -> MyAIToolCollection:- """Transform a collection of tools"""- return [self.wrap_tool(tool) for tool in tools]-- # Optional: Custom helper methods for your AI platform- def execute_my_ai_tool_call(- self,- user_id: str,- tool_call: dict,- modifiers: Optional[Modifiers] = None- ) -> ToolExecutionResponse:- """Execute a tool call in your platform's format-- Example usage:- result = my_provider.execute_my_ai_tool_call(- user_id="default",- tool_call={"name": "GITHUB_STAR_REPO", "arguments": {"owner": "composiohq", "repo": "composio"}}- )- """- # Use the built-in execute_tool method- return self.execute_tool(- slug=tool_call["name"],- arguments=tool_call["arguments"],- modifiers=modifiers,- user_id=user_id- )-```--## Creating an agentic provider--Agentic providers inherit from the `AgenticProvider` abstract class:--```python-from typing import Callable, Dict, List, Sequence-from composio.core.provider import AgenticProvider, AgenticProviderExecuteFn-from composio.types import Tool-from my_provider import AgentTool--# Import the Tool/Function class that represents a callable tool for your framework-# Optionally define your custom tool format below-# class AgentTool:-# def __init__(self, name: str, description: str, execute: Callable, schema: dict):-# self.name = name-# self.description = description-# self.execute = execute-# self.schema = schema--# Define your tool collection format (typically a List)-AgentToolCollection: TypeAlias = List[AgentTool]--# Create your provider-class MyAgentProvider(AgenticProvider[AgentTool, List[AgentTool]], name="my-agent-platform"):- """Custom provider for My Agent Platform"""-- def wrap_tool(self, tool: Tool, execute_tool: AgenticProviderExecuteFn) -> AgentTool:- """Transform a single tool with execute function"""- def execute_wrapper(**kwargs) -> Dict:- result = execute_tool(tool.slug, kwargs)- if not result.get("successful", False):- raise Exception(result.get("error", "Tool execution failed"))- return result.get("data", {})-- return AgentTool(- name=tool.slug,- description=tool.description or "",- execute=execute_wrapper,- schema=tool.input_parameters- )-- def wrap_tools(- self,- tools: Sequence[Tool],- execute_tool: AgenticProviderExecuteFn- ) -> AgentToolCollection:- """Transform a collection of tools with execute function"""- return [self.wrap_tool(tool, execute_tool) for tool in tools]-```--## Using your custom provider--After creating your provider, use it with the Composio SDK:--### Non-agentic provider example--```python-from composio import Composio-from composio_myai import MyAIProvider-from myai import MyAIClient # Your AI platform's client--# Initialize tools-myai_client = MyAIClient()-composio = Composio(provider=MyAIProvider())--# Define task-task = "Star a repo composiohq/composio on GitHub"--# Get GitHub tools that are pre-configured-tools = composio.tools.get(user_id="default", toolkits=["GITHUB"])--# Get response from your AI platform (example)-response = myai_client.chat.completions.create(- model="your-model",- tools=tools, # These are in your platform's format- messages=[- {"role": "system", "content": "You are a helpful assistant."},- {"role": "user", "content": task},- ],-)-print(response)--# Execute the function calls-result = composio.provider.handle_tool_calls(response=response, user_id="default")-print(result)-```--### Agentic provider example--```python-import asyncio-from agents import Agent, Runner-from composio_myagent import MyAgentProvider-from composio import Composio--# Initialize Composio toolset-composio = Composio(provider=MyAgentProvider())--# Get all the tools-tools = composio.tools.get(- user_id="default",- tools=["GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"],-)--# Create an agent with the tools-agent = Agent(- name="GitHub Agent",- instructions="You are a helpful assistant that helps users with GitHub tasks.",- tools=tools,-)--# Run the agent-async def main():- result = await Runner.run(- starting_agent=agent,- input=(- "Star the repository composiohq/composio on GitHub. If done "- "successfully, respond with 'Action executed successfully'"- ),- )- print(result.final_output)--asyncio.run(main())-```---## Example: Anthropic Claude provider--Here's a complete example for Anthropic's Claude:--```python-import typing as t--from anthropic.types.beta.beta_tool_use_block import BetaToolUseBlock-from anthropic.types.message import Message as ToolsBetaMessage-from anthropic.types.tool_param import ToolParam-from anthropic.types.tool_use_block import ToolUseBlock--from composio.core.provider import NonAgenticProvider-from composio.types import Modifiers, Tool, ToolExecutionResponse---class AnthropicProvider(- NonAgenticProvider[ToolParam, list[ToolParam]],- name="anthropic",-):- """Composio toolset for Anthropic Claude platform."""-- def wrap_tool(self, tool: Tool) -> ToolParam:- return ToolParam(- input_schema=tool.input_parameters,- name=tool.slug,- description=tool.description,- )-- def wrap_tools(self, tools: t.Sequence[Tool]) -> list[ToolParam]:- return [self.wrap_tool(tool) for tool in tools]-- def execute_tool_call(- self,- user_id: str,- tool_call: ToolUseBlock,- modifiers: t.Optional[Modifiers] = None,- ) -> ToolExecutionResponse:- """Execute a tool call.-- :param user_id: User ID to use for executing function calls.- :param tool_call: Tool call metadata.- :param modifiers: Modifiers to use for executing function calls.- :return: Object containing output data from the tool call.- """- return self.execute_tool(- slug=tool_call.name,- arguments=t.cast(t.Dict, tool_call.input),- modifiers=modifiers,- user_id=user_id,- )-- def handle_tool_calls(- self,- user_id: str,- response: t.Union[dict, ToolsBetaMessage],- modifiers: t.Optional[Modifiers] = None,- ) -> t.List[ToolExecutionResponse]:- """Handle tool calls from Anthropic Claude chat completion object.-- :param response: Chat completion object from- `anthropic.Anthropic.beta.tools.messages.create` function call.- :param user_id: User ID to use for executing function calls.- :param modifiers: Modifiers to use for executing function calls.- :return: A list of output objects from the tool calls.- """- if isinstance(response, dict):- response = ToolsBetaMessage(**response)-- outputs = []- for content in response.content:- if isinstance(content, (ToolUseBlock, BetaToolUseBlock)):- outputs.append(- self.execute_tool_call(- user_id=user_id,- tool_call=content,- modifiers=modifiers,- )- )- return outputs-```--## Example: OpenAI Agents provider--Here's an example for OpenAI Agents framework:--```python-import asyncio-import json-import typing as t--import pydantic-from agents import FunctionTool--from composio.core.provider import AgenticProvider, AgenticProviderExecuteFn-from composio.types import Tool-from composio.utils.pydantic import parse_pydantic_error---class OpenAIAgentsProvider(- AgenticProvider[FunctionTool, list[FunctionTool]],- name="openai_agents",-):- """Provider for OpenAI Agents framework"""-- def wrap_tool(- self,- tool: Tool,- execute_tool: AgenticProviderExecuteFn,- ) -> FunctionTool:- """Wrap a tool as a FunctionTool"""-- # Create an async wrapper for the tool execution- async def execute_tool_wrapper(_ctx, payload):- """Execute Composio action with the given arguments"""- try:- return json.dumps(- obj=(- await asyncio.to_thread( # Running in thread since execute_tool is not async- execute_tool,- slug=tool.slug,- arguments=json.loads(payload) if payload else {},- )- )- )- except pydantic.ValidationError as e:- return json.dumps({- "successful": False,- "error": parse_pydantic_error(e),- "data": None,- })- except Exception as e:- return json.dumps({- "successful": False,- "error": str(e),- "data": None,- })-- # Ensure the schema has additionalProperties set to false- modified_schema = tool.input_parameters.copy()- modified_schema["additionalProperties"] = False-- # Create a FunctionTool with the appropriate schema- return FunctionTool(- name=tool.slug,- description=tool.description,- params_json_schema=modified_schema,- on_invoke_tool=execute_tool_wrapper,- strict_json_schema=False, # Composio tools already have optimal schemas- )-- def wrap_tools(- self,- tools: t.Sequence[Tool],- execute_tool: AgenticProviderExecuteFn,- ) -> list[FunctionTool]:- """Wrap multiple tools for OpenAI Agents"""- return [self.wrap_tool(tool, execute_tool) for tool in tools]-```--## Best practices--1. **Keep providers focused**: Each provider should integrate with one specific platform-2. **Handle errors gracefully**: Catch and transform errors from tool execution-3. **Follow platform conventions**: Adopt naming and structural conventions of the target platform-4. **Use type annotations**: Leverage Python's typing system for better IDE support and documentation-5. **Cache transformed tools**: Store transformed tools when appropriate to improve performance-6. **Add helper methods**: Provide convenient methods for common platform-specific operations-7. **Document your provider**: Include docstrings and usage examples-8. **Set meaningful provider names**: Use the name parameter for telemetry and debugging\ No newline at end of filediff --git a/fern/pages/src/providers/ts-custom.mdx b/fern/pages/src/providers/ts-custom.mdxdeleted file mode 100644index 998b89eaf..000000000--- a/fern/pages/src/providers/ts-custom.mdx+++ /dev/null@@ -1,484 +0,0 @@-----title: TypeScript Custom Provider-subtitle: Learn how to create custom providers for any AI platform in TypeScript-image: "https://og.composio.dev/api/og?title=TypeScript%20Custom%20Provider" # image for socials-keywords: ""-hide-nav-links: false------This guide provides a comprehensive walkthrough of creating custom providers for the Composio TypeScript SDK, enabling integration with different AI frameworks and platforms.--## Provider Architecture--The Composio SDK uses a provider architecture to adapt tools for different AI frameworks. The provider handles:--1. **Tool Format Transformation**: Converting Composio tools into formats compatible with specific AI platforms-2. **Tool Execution**: Managing the flow of tool execution and results-3. **Platform-Specific Integration**: Providing helper methods for seamless integration--## Types of Providers--There are two types of providers:--1. **Non-Agentic Providers**: Transform tools for platforms that don't have their own agency (e.g., OpenAI)-2. **Agentic Providers**: Transform tools for platforms that have their own agency (e.g., LangChain, AutoGPT)--## Provider Class Hierarchy--```-BaseProvider (Abstract)-├── BaseNonAgenticProvider (Abstract)-│ └── OpenAIProvider (Concrete)-│ └── [Your Custom Non-Agentic Provider] (Concrete)-└── BaseAgenticProvider (Abstract)- └── [Your Custom Agentic Provider] (Concrete)-```--## Creating a Non-Agentic Provider--Non-agentic providers implement the `BaseNonAgenticProvider` abstract class:--```typescript-import { BaseNonAgenticProvider, Tool } from '@composio/core';--// Define your tool format-interface MyAITool {- name: string;- description: string;- parameters: {- type: string;- properties: Record<string, unknown>;- required?: string[];- };-}--// Define your tool collection format-type MyAIToolCollection = MyAITool[];--// Create your provider-export class MyAIProvider extends BaseNonAgenticProvider<MyAIToolCollection, MyAITool> {- // Required: Unique provider name for telemetry- readonly name = 'my-ai-platform';-- // Required: Method to transform a single tool- override wrapTool(tool: Tool): MyAITool {- return {- name: tool.slug,- description: tool.description || '',- parameters: {- type: 'object',- properties: tool.inputParameters?.properties || {},- required: tool.inputParameters?.required || [],- },- };- }-- // Required: Method to transform a collection of tools- override wrapTools(tools: Tool[]): MyAIToolCollection {- return tools.map(tool => this.wrapTool(tool));- }-- // Optional: Custom helper methods for your AI platform- async executeMyAIToolCall(- userId: string,- toolCall: {- name: string;- arguments: Record<string, unknown>;- }- ): Promise<string> {- // Use the built-in executeTool method- const result = await this.executeTool(toolCall.name, {- userId,- arguments: toolCall.arguments,- });-- return JSON.stringify(result.data);- }-}-```--## Creating an Agentic Provider--Agentic providers implement the `BaseAgenticProvider` abstract class:--```typescript-import { BaseAgenticProvider, Tool, ExecuteToolFn } from '@composio/core';--// Define your tool format-interface AgentTool {- name: string;- description: string;- execute: (args: Record<string, unknown>) => Promise<unknown>;- schema: Record<string, unknown>;-}--// Define your tool collection format-interface AgentToolkit {- tools: AgentTool[];- createAgent: (config: Record<string, unknown>) => unknown;-}--// Create your provider-export class MyAgentProvider extends BaseAgenticProvider<AgentToolkit, AgentTool> {- // Required: Unique provider name for telemetry- readonly name = 'my-agent-platform';-- // Required: Method to transform a single tool with execute function- override wrapTool(tool: Tool, executeToolFn: ExecuteToolFn): AgentTool {- return {- name: tool.slug,- description: tool.description || '',- schema: tool.inputParameters || {},- execute: async (args: Record<string, unknown>) => {- const result = await executeToolFn(tool.slug, args);- if (!result.successful) {- throw new Error(result.error || 'Tool execution failed');- }- return result.data;- },- };- }-- // Required: Method to transform a collection of tools with execute function- override wrapTools(tools: Tool[], executeToolFn: ExecuteToolFn): AgentToolkit {- const agentTools = tools.map(tool => this.wrapTool(tool, executeToolFn));-- return {- tools: agentTools,- createAgent: config => {- // Create an agent using the tools- return {- run: async (prompt: string) => {- // Implementation depends on your agent framework- console.log(`Running agent with prompt: ${prompt}`);- // The agent would use the tools.execute method to run tools- },- };- },- };- }-- // Optional: Custom helper methods for your agent platform- async runAgent(agentToolkit: AgentToolkit, prompt: string): Promise<unknown> {- const agent = agentToolkit.createAgent({});- return await agent.run(prompt);- }-}-```--## Using Your Custom Provider--After creating your provider, use it with the Composio SDK:--```typescript-import { Composio } from '@composio/core';-import { MyAIProvider } from './my-ai-provider';--// Create your provider instance-const myProvider = new MyAIProvider();--// Initialize Composio with your provider-const composio = new Composio({- apiKey: 'your-composio-api-key',- provider: myProvider,-});--// Get tools - they will be transformed by your provider-const tools = await composio.tools.get('default', {- toolkits: ['github'],-});--// Use the tools with your AI platform-console.log(tools); // These will be in your custom format-```--## Provider State and Context--Your provider can maintain state and context:--```typescript-export class StatefulProvider extends BaseNonAgenticProvider<ToolCollection, Tool> {- readonly name = 'stateful-provider';-- // Provider state- private requestCount = 0;- private toolCache = new Map<string, any>();- private config: ProviderConfig;-- constructor(config: ProviderConfig) {- super();- this.config = config;- }-- override wrapTool(tool: Tool): ProviderTool {- this.requestCount++;-- // Use the provider state/config- const enhancedTool = {- // Transform the tool- name: this.config.useUpperCase ? tool.slug.toUpperCase() : tool.slug,- description: tool.description,- schema: tool.inputParameters,- };-- // Cache the transformed tool- this.toolCache.set(tool.slug, enhancedTool);-- return enhancedTool;- }-- override wrapTools(tools: Tool[]): ProviderToolCollection {- return tools.map(tool => this.wrapTool(tool));- }-- // Custom methods that use provider state- getRequestCount(): number {- return this.requestCount;- }-- getCachedTool(slug: string): ProviderTool | undefined {- return this.toolCache.get(slug);- }-}-```--## Advanced: Provider Composition--You can compose functionality by extending existing providers:--```typescript-import { OpenAIProvider } from '@composio/openai';--// Extend the OpenAI provider with custom functionality-export class EnhancedOpenAIProvider extends OpenAIProvider {- // Add properties- private analytics = {- toolCalls: 0,- errors: 0,- };-- // Override methods to add functionality- override async executeToolCall(userId, tool, options, modifiers) {- this.analytics.toolCalls++;-- try {- // Call the parent implementation- const result = await super.executeToolCall(userId, tool, options, modifiers);- return result;- } catch (error) {- this.analytics.errors++;- throw error;- }- }-- // Add new methods- getAnalytics() {- return this.analytics;- }-- async executeWithRetry(userId, tool, options, modifiers, maxRetries = 3) {- let attempts = 0;- let lastError;-- while (attempts < maxRetries) {- try {- return await this.executeToolCall(userId, tool, options, modifiers);- } catch (error) {- lastError = error;- attempts++;- await new Promise(resolve => setTimeout(resolve, 1000 * attempts));- }- }-- throw lastError;- }-}-```--## Example: Anthropic Claude Provider--Here's a more complete example for Anthropic's Claude:--```typescript-import { BaseNonAgenticProvider, Tool } from '@composio/core';-import Anthropic from '@anthropic-ai/sdk';--interface ClaudeTool {- name: string;- description: string;- input_schema: {- type: string;- properties: Record<string, unknown>;- required?: string[];- };-}--type ClaudeToolCollection = ClaudeTool[];--export class ClaudeProvider extends BaseNonAgenticProvider<ClaudeToolCollection, ClaudeTool> {- readonly name = 'claude';- private client: Anthropic;-- constructor(apiKey: string) {- super();- this.client = new Anthropic({- apiKey,- });- }-- override wrapTool(tool: Tool): ClaudeTool {- return {- name: tool.slug,- description: tool.description || '',- input_schema: {- type: 'object',- properties: tool.inputParameters?.properties || {},- required: tool.inputParameters?.required || [],- },- };- }-- override wrapTools(tools: Tool[]): ClaudeToolCollection {- return tools.map(tool => this.wrapTool(tool));- }-- // Helper method to create a Claude message with tools- async createMessage(prompt: string, tools: ClaudeToolCollection, userId: string) {- const response = await this.client.messages.create({- model: 'claude-3-opus-20240229',- max_tokens: 1024,- system: 'You are a helpful assistant with access to tools.',- messages: [{ role: 'user', content: prompt }],- tools,- });-- // Process tool calls if any- if (- response.content.some(- content => content.type === 'tool_use' && 'name' in content && 'input' in content- )- ) {- const toolResponses = await Promise.all(- response.content- .filter(content => content.type === 'tool_use')- .map(async (content: any) => {- const result = await this.executeTool(content.name, {- userId,- arguments: content.input,- });-- return {- type: 'tool_result',- tool_use_id: content.id,- content: JSON.stringify(result.data),- };- })- );-- // Continue the conversation with tool results- const followupResponse = await this.client.messages.create({- model: 'claude-3-opus-20240229',- max_tokens: 1024,- system: 'You are a helpful assistant with access to tools.',- messages: [- { role: 'user', content: prompt },- { role: 'assistant', content: response.content },- { role: 'user', content: toolResponses },- ],- tools,- });-- return followupResponse;- }-- return response;- }-}-```--## Example: LangChain Provider--Here's an example for LangChain:--```typescript-import { BaseAgenticProvider, Tool, ExecuteToolFn } from '@composio/core';-import { DynamicTool } from 'langchain/tools';-import { ChatOpenAI } from 'langchain/chat_models/openai';-import { initializeAgentExecutorWithOptions } from 'langchain/agents';--interface LangChainTool extends DynamicTool {- name: string;- description: string;- func: (input: Record<string, unknown>) => Promise<string>;-}--interface LangChainToolkit {- tools: LangChainTool[];- createExecutor: (options: { model: string }) => Promise<any>;-}--export class LangChainProvider extends BaseAgenticProvider<LangChainToolkit, LangChainTool> {- readonly name = 'langchain';-- override wrapTool(tool: Tool, executeToolFn: ExecuteToolFn): LangChainTool {- return new DynamicTool({- name: tool.slug,- description: tool.description || '',- func: async (input: string) => {- try {- // Parse input from string to object- const args = typeof input === 'string' ? JSON.parse(input) : input;-- // Execute the tool- const result = await executeToolFn(tool.slug, args);-- if (!result.successful) {- throw new Error(result.error || 'Tool execution failed');- }-- // Return the result- return JSON.stringify(result.data);- } catch (error) {- return `Error: ${error.message}`;- }- },- }) as LangChainTool;- }-- override wrapTools(tools: Tool[], executeToolFn: ExecuteToolFn): LangChainToolkit {- const langchainTools = tools.map(tool => this.wrapTool(tool, executeToolFn));-- return {- tools: langchainTools,- createExecutor: async ({ model }) => {- const llm = new ChatOpenAI({- modelName: model || 'gpt-4',- temperature: 0,- });-- return await initializeAgentExecutorWithOptions(langchainTools, llm, {- agentType: 'chat-zero-shot-react-description',- verbose: true,- });- },- };- }-- // Helper method to run the agent- async runAgent(toolkit: LangChainToolkit, prompt: string, model = 'gpt-4'): Promise<string> {- const executor = await toolkit.createExecutor({ model });- const result = await executor.call({ input: prompt });- return result.output;- }-}-```--## Best Practices--1. **Keep providers focused**: Each provider should integrate with one specific platform-2. **Handle errors gracefully**: Catch and transform errors from tool execution-3. **Follow platform conventions**: Adopt naming and structural conventions of the target platform-4. **Optimize for performance**: Cache transformed tools when possible-5. **Add helper methods**: Provide convenient methods for common platform-specific operations-6. **Provide clear documentation**: Document your provider's unique features and usage-7. **Use telemetry**: Set a meaningful provider name for telemetry insightsdiff --git a/fern/pages/src/providers/vercel.mdx b/fern/pages/src/providers/vercel.mdxdeleted file mode 100644index 7e4708b81..000000000--- a/fern/pages/src/providers/vercel.mdx+++ /dev/null@@ -1,56 +0,0 @@-----title: Vercel AI SDK Provider-subtitle: Use Composio with Vercel AI SDK-slug: /providers/vercel-image: "https://og.composio.dev/api/og?title=Vercel%20AI%20SDK%20Provider" # image for socials-keywords: ''-hide-nav-links: false------Vercel AI SDK allows you to configure an optional async `execute` function that the framework uses to execute the tool calls.--The Vercel provider for Composio formats the Composio tools and adds this `execute` function to the tool calls.--## Setup--Vercel AI SDK and the provider are only available for the TypeScript SDK.--```typescript TypeScript maxLines=60 wordWrap-npm install @composio/vercel-```--You can specify and import the provider in the constructor.--```typescript TypeScript maxLines=60 wordWrap-import { Composio } from '@composio/core';-import { VercelProvider } from '@composio/vercel';-import { generateText } from 'ai';-import { openai } from "@ai-sdk/openai";--const composio = new Composio({- provider: new VercelProvider(),-});-```--## Usage--```typescript TypeScript maxLines=60 wordWrap-// create an auth config for gmail-// then create a connected account with an external user id that identifies the user-const externalUserId = "your-external-user-id";-const tools = await composio.tools.get(externalUserId, "GMAIL_SEND_EMAIL");--// env: OPENAI_API_KEY-const { text } = await generateText({- model: openai("gpt-5"),- messages: [- {- role: "user",- content: `Send an email to [email protected] with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'`,- },- ],- tools,-});--console.log("Email sent successfully!", { text });-```diff --git a/fern/pages/src/resources/cli.mdx b/fern/pages/src/resources/cli.mdxdeleted file mode 100644index c83db90d1..000000000--- a/fern/pages/src/resources/cli.mdx+++ /dev/null@@ -1,137 +0,0 @@-----title: CLI-subtitle: Generate type definitions and manage authentication-image: "https://og.composio.dev/api/og?title=Composio%20CLI"-keywords: 'composio cli, command line, type generation, composio generate, typescript types, python types'-slug: /docs/cli-hide-nav-links: false------The Composio CLI helps you generate type-safe code and manage your Composio workspace.--## Installation--Install the Composio CLI using the installation script:--```bash-curl -fsSL https://composio.dev/install | bash-```--Or using wget:-```bash-wget -qO- https://composio.dev/install | bash-```--## Authentication--Manage your Composio authentication directly from the terminal.--### Login--Authenticate with your Composio account:--```bash-composio login-```--This opens your browser to complete authentication and stores your API key locally.--To authenticate without opening a browser (useful for SSH/remote sessions):--```bash-composio login --no-browser-```--This displays a URL to manually open in your browser.--### Check authentication status--Verify your current authentication:--```bash-composio whoami-```--This displays your current API key or indicates if you're not authenticated.--### Logout--Remove stored authentication:--```bash-composio logout-```--## Generate type definitions--Generate TypeScript or Python type definitions for all Composio tools. These types provide type safety when using direct tool execution (`composio.tools.execute()`), helping you pass the correct parameters and catch errors early.--### Auto-detect and generate--The CLI auto-detects your project language.-In your project directory:--```bash-composio generate-```--For TypeScript projects only, include individual tool types:-```bash-composio generate --type-tools-```--The CLI automatically:-- Detects your project type (Python or TypeScript)-- Generates appropriate type definitions--### Specify output directory--```bash-composio generate --output-dir ./my-types-```--### Language-specific commands--For explicit control, use language-specific commands:--<Tabs>- <Tab title="TypeScript">- Basic generation:- ```bash- composio ts generate- ```-- Generate as single file:- ```bash- composio ts generate --compact- ```-- Include individual tool types:- ```bash- composio ts generate --type-tools- ```-- Generate both .ts and .js files:- ```bash- composio ts generate --transpiled- ```-- Custom output directory:- ```bash- composio ts generate --output-dir ./my-types- ```- </Tab>- <Tab title="Python">- Basic generation:- ```bash- composio py generate- ```-- Custom output directory:- ```bash- composio py generate --output-dir ./my_types- ```- </Tab>-</Tabs>--diff --git a/fern/pages/src/resources/debugging-info.mdx b/fern/pages/src/resources/debugging-info.mdxdeleted file mode 100644index 8fa2be4e3..000000000--- a/fern/pages/src/resources/debugging-info.mdx+++ /dev/null@@ -1,51 +0,0 @@-----title: Debugging Info-image: "https://og.composio.dev/api/og?title=Debugging%20Info"-keywords: 'debugging, troubleshooting, project id, org id'-subtitle: 'Share your debugging info with Composio team for faster issue resolution'-hide-nav-links: false------Your debugging info is tied to your project and it helps us trace what happened and debug the issue faster.--## Finding Your Debugging Info--Navigate to your project settings to find your debugging information:--<Frame>- <img src="../../../assets/images/debugging-info/project-settings.jpeg" alt="Project Settings Debugging Info" />-</Frame>--<Frame>- <img src="../../../assets/images/debugging-info/debugging-info.png" alt="Debugging Info Location" />-</Frame>--## What to Share--When reaching out for support, share these identifiers:--```-@project_id: pr_xxxxxxxxxxxxx-@org_id: ok_xxxxxxxxxxxxx-@org_member_email: [email protected]-```--The identifiers with `pr_` (project) and `ok_` (organization) prefixes let us quickly check your logs inside our internal tracing tools, helping us resolve issues faster.--## Getting Help--<CardGroup cols={2}>- <Card title="Join Discord" icon="fa-brands fa-discord" href="https://discord.gg/composio">- Get basic support from the community and Composio team- </Card>- <Card title="GitHub Discussions" icon="fa-brands fa-github" href="https://github.com/ComposioHQ/composio/discussions">- Request new tools and share feedback- </Card>- <Card title="File an Issue" icon="fa-light fa-bug" href="https://github.com/ComposioHQ/composio/issues">- Report SDK issues and bugs- </Card>- <Card title="Contact Support" icon="fa-light fa-envelope" href="mailto:[email protected]">- Reach out for dedicated support channels on Growth and Enterprise plans- </Card>-</CardGroup>-diff --git a/fern/pages/src/resources/migration-guide.mdx b/fern/pages/src/resources/migration-guide.mdxdeleted file mode 100644index 57a0c5019..000000000--- a/fern/pages/src/resources/migration-guide.mdx+++ /dev/null@@ -1,675 +0,0 @@-----title: Our next generation SDKs-subtitle: Learn more about Composio's next generation SDKs and how to migrate-image: "https://og.composio.dev/api/og?title=Our%20next%20generation%20SDKs" # image for socials-keywords: ''-hide-nav-links: true------In the last few months, we have experienced very rapid growth in usage of our platform. As such, our team has been working hard to radically improve the performance and developer experience of our platform.--A lot of these changes have happened in the background, but we are excited to finally share our new SDKs with you that complement our new infra.--The new API features improved usability, enhanced stability, and better scalability. The SDKs built on top of it simplify the developer experience, making it easier than ever to build useful agents.--## What's new?--A lot of the changes are on the infra side, but from the SDK point of view, here is what you can expect:-- Faster and more reliable tool execution-- A simpler but more opinionated SDK-- Much more intuitive and consistent naming conventions-- A vastly improved TypeScript SDK that is meaningfully more type-safe and has full feature parity with the Python SDK--There aren't too many new flashy features here (yet) mainly because we wanted to get the bones right — but we feel we have a solid foundation to ship incredible new experiences on top very quickly.---## State of the new SDK and what is happening with the old SDKs?--Currently, the new SDKs are in a preview release. These new SDKs come almost fully formed, we do not expect many breaking changes to them but are releasing them in a preview state to get feedback and make necessary changes before locking them in.--As we lock the new SDKs in place, we will deprecate support for the old SDKs. They will continue to work for the foreseeable future but are no longer actively maintained. We will continue to push security updates and fix any critical bugs but will not support any new functionality in them.--We urge you to upgrade to the new SDKs as soon as possible.---## Nomenclature--We have updated several key terms in the SDK and API to improve clarity and consistency. The following table summarizes these changes:--| Previous Term | Current Term | Definition |-|---------------|--------------------|--------------------------------------------------------------------------|-| Actions | Tools | Individual operations or capabilities that can be performed by an LLM agent |-| Apps | Toolkits | A collection of tools grouped under a single application |-| Integration | Auth Config | Configuration containing developer credentials and application-level settings such as scopes and API endpoints. Scoped to a toolkit. |-| Connection | Connected accounts | User-linked accounts associated with a toolkit |-| Entity ID | User ID | The identifier of the user performing the action (UUID or email) |-| Trigger | Trigger | An event that can be subscribed to |-| Toolsets | Providers | LLM or agent framework that can be used with Composio to create agents |--## Switch to nano IDs from UUIDs--We have transitioned from UUIDs to nano IDs throughout the platform for the following reasons:--- **Improved readability**: UUIDs are lengthy and difficult to read-- **Better usability**: Easier to copy with a single double-click-- **Better organization**: Nano IDs allow us to distinguish between different resource types through prefixes--| Feature | Nano ID Prefix | Example |-|-------------------|----------------|--------------------|-| Connected Account | `ca_` | `ca_8x9w2l3k5m` |-| Auth Config | `ac_` | `ac_1234567890` |-| Trigger | `ti_` | `ti_So9EQf8XnAcy` |--> **Note:** Nano IDs are short, unique, and prefixed to indicate the resource type.----## SDK Changes--Upgrade to the latest SDK version using the appropriate package manager:--<CodeGroup>-```python Python-pip install -U composio-```-```typescript TypeScript-npm install @composio/core-```-</CodeGroup>--Both SDKs now implement proper namespacing for each concept.--### User ID scoping--The concept of `entity_id` has been expanded and renamed to `user_id`.--All operations are now scoped to a user ID, including:-- Fetching tools-- Initiating connections-- Executing tools-- Managing triggers--This change provides explicit specification of the user for whom the action is being performed. When a user may have multiple accounts (such as work and personal Gmail connections), you can use the more specific connected account ID.--### Replacing ToolSets with [Providers](/docs/providers)--We have deprecated "toolsets" in favor of "providers". This change allows Composio to provide deeper standardization for tool implementation across different frameworks.--Previously, you needed to import and use a framework-specific `ComposioToolSet` class:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_tools.py"- startLine={1}- endLine={3}- title="Python (previous)"-/>--<SnippetCode- src="fern/snippets/migration/old_tools.ts"- startLine={1}- endLine={3}- title="TypeScript (previous)"-/>-</CodeGroup>--The SDK structure is now framework-agnostic and includes the OpenAI provider out of the box:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/providers.py"- startLine={1}- endLine={12}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/providers.ts"- startLine={1}- endLine={12}- title="TypeScript (current)"-/>-</CodeGroup>--You can now use the same tools across any framework with our unified interface, or create custom toolsets for frameworks we don't yet support.--Read more about [providers in our documentation](/docs/providers) and explore the [complete list of available providers](/providers/openai).--### Fetching and filtering tools--Previously, you could filter tools by:-- Apps-- Action names (tool names)-- Tags--You could also specify an `important` flag to retrieve the most important tools:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_tools.py"- startLine={1}- endLine={11}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_tools.ts"- startLine={1}- endLine={11}- title="TypeScript (previous)"-/>-</CodeGroup>--You can now filter tools by:-- Toolkits-- Tool slugs-- Limit parameter-- Search query--The `important` flag has been removed. Instead, tools are returned in order of importance by default:--<Note>Since `user_id` is now explicitly required, the `check_connected_accounts` flag is no longer necessary.</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_tools.py"- startLine={1}- endLine={17}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/new_tools.ts"- startLine={1}- endLine={25}- title="TypeScript (current)"-/>-</CodeGroup>--### Fetching raw tool data--To examine the raw schema definition of a tool for understanding input/output parameters or building custom logic around tool definitions, use the following methods:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/raw_tools.py"- startLine={1}- endLine={11}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/tool-calling/typescript/raw_tools.ts"- startLine={1}- endLine={11}- title="TypeScript (current)"-/>-</CodeGroup>--### Executing tools--Tool execution remains largely unchanged, with `user_id` now explicitly required.--For agentic frameworks, the tool object returned from `tools.get` is now the respective framework's native tool object. Tool call execution is handled by the agentic framework itself.--<Note>-For non-agentic frameworks, Composio provides a helper function to execute tool calls.-</Note>--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_execute_tools.py"- startLine={1}- endLine={17}- title="Python v3"- highlightStart={16}- highlightEnd={16}-/>--<SnippetCode- src="fern/snippets/migration/new_execute_tools.ts"- startLine={1}- endLine={30}- title="TypeScript v3"- highlightStart={27}- highlightEnd={27}-/>-</CodeGroup>--For more information on executing tools for different frameworks, see [Replacing ToolSets with Providers](#replacing-toolsets-with-providers).--### Tool Modifiers (formerly Tool Processors)--Tool processors have been renamed to *tool modifiers* and now provide an improved developer experience. The implementation is now available in TypeScript too! (previously Python-only).--<SnippetCode- src="fern/snippets/migration/old_tool_modifiers.py"- startLine={1}- endLine={23}- title="Python (previous)"-/>--| Previous | Current |-|-------------------|-------------------------|-| `pre` processor | `beforeExecute` modifier |-| `post` processor | `afterExecute` modifier |-| `schema` processor| `schema` modifier |--The modifiers now leverage language-specific features to provide a more natural developer experience.--While tool processors could previously be applied during SDK initialization, tool fetching, and tool execution, we have restructured them as follows:-- **Chat Completion providers**: Modifiers are specified and applied during tool execution-- **Agentic frameworks**: Modifiers are specified and applied during tool fetching--#### [Schema Modifiers](/docs/modifying-tool-schemas)--The following example demonstrates schema modifier usage, applicable across all providers:--<CodeGroup>-```python Python (current)-from composio import Composio, schema_modifier-from composio.types import Tool--user_id = "[email protected]"--@schema_modifier(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def modify_schema(- tool: str,- toolkit: str,- schema: Tool,-) -> Tool:- _ = schema.input_parameters["properties"].pop("page", None)- schema.input_parameters["required"] = ["size"]- return schema--tools = composio.tools.get(- user_id=user_id,- tools=["HACKERNEWS_GET_LATEST_POSTS", "HACKERNEWS_GET_USER"],- modifiers=[- modify_schema,- ]-)-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={1}- endLine={26}- title="TypeScript (current)"-/>-</CodeGroup>--#### [Before Modifiers](/docs/modifying-tool-inputs)--The following example shows creating and using a before modifier for a Chat Completion provider. For agentic frameworks, view the [complete before modifier documentation](/docs/modifying-tool-inputs):--<CodeGroup>-```python Python (current)-@before_execute(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def before_execute_modifier(- tool: str,- toolkit: str,- params: ToolExecuteParams,-) -> ToolExecuteParams:- params["arguments"]["size"] = 1- return params---# Get tools-tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_LATEST_POSTS")-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={53}- endLine={68}- title="TypeScript (current)"-/>-</CodeGroup>--#### [After Modifiers](/docs/modifying-tool-outputs)--The following example shows creating and using an after modifier for a Chat Completion provider. For agentic frameworks, view the [complete after modifier documentation](/docs/modifying-tool-outputs):--<CodeGroup>--```python Python (current)-@after_execute(tools=["HACKERNEWS_GET_USER"])-def after_execute_modifier(- tool: str,- toolkit: str,- response: ToolExecutionResponse,-) -> ToolExecutionResponse:- return {- **response,- "data": {- "karma": response["data"]["karma"],- },- }--tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_USER")-```-<SnippetCode- src="fern/snippets/migration/tool_modifiers.ts"- startLine={69}- endLine={90}- title="TypeScript (current)"-/>-</CodeGroup>--### Custom Tools--The SDK continues to support custom tools. [Creating tools from your methods](/docs/custom-tools#creating-a-custom-tool) remains possible. We recommend reviewing the [detailed custom tools documentation](/docs/custom-tools#creating-a-custom-tool) for more information.--Due to changes in the SDK architecture, creating custom tools that use Composio's managed authentication has been modified. In the previous SDK, you could create a custom tool as follows:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_custom_tools.py"- startLine={1}- endLine={39}- highlightStart={14}- highlightEnd={17}- title="Python (previous)"-/>--<SnippetCode- src="fern/snippets/migration/old_custom_tools.ts"- startLine={1}- endLine={39}- highlightStart={16}- highlightEnd={20}- title="TypeScript (previous)"-/>-</CodeGroup>--The *execute tool request* method handles injection of the appropriate base URL and authentication credentials for the tool:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_custom_tools.py"- startLine={1}- endLine={39}- highlightStart={22}- highlightEnd={22}- title="Python (current)"-/>--<SnippetCode- src="fern/snippets/migration/new_custom_tools.ts"- startLine={1}- endLine={39}- highlightStart={17}- highlightEnd={17}- title="TypeScript (current)"-/>-</CodeGroup>--For more information, including executing custom tools and defining custom headers and query parameters, refer to the [Custom Tools](/docs/custom-tools) documentation.--### Auth configs (formerly integrations)--Integrations are now called *auth configs*. While the terminology has changed, the underlying concept remains the same.--Auth configs store the configuration required for authentication with a given toolkit, including OAuth developer credentials, configurable base URLs, and scopes.--Auth configs now use nano IDs instead of UUIDs:--| Previous (UUID) Example | Current (Nano ID) Example |-| :----------------------------------- | :------------------------ |-| `b7a9c1e2-3f4d-4a6b-8c2e-1d2f3a4b5c6d` | `ac_8x9w2l3k5m` |--We recommend storing auth config nano IDs in your database for connecting users to the appropriate auth configuration.--For most use cases, you will create auth configs through the dashboard, and this process remains unchanged. Read more about [creating auth configs](/docs/authenticating-tools#creating-an-auth-config) and [customizing auth configs](/docs/custom-auth-configs).--Creating auth configs programmatically in the previous SDK:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_auth_config.py"- startLine={1}- endLine={15}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_auth_config.ts"- startLine={1}- endLine={15}- title="TypeScript (previous)"-/>-</CodeGroup>--Creating auth configs programmatically in the current SDK:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_auth_config.py"- startLine={1}- endLine={15}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_auth_config.ts"- startLine={1}- endLine={15}- title="TypeScript (current)"-/>-</CodeGroup>--For using custom authentication credentials, refer to the [Programmatic Auth Configs](/docs/programmatic-auth-configs) documentation.--<Note>The callback URL for creating custom OAuth configs is now `https://backend.composio.dev/api/v3/toolkits/auth/callback`. The previous URL was `https://backend.composio.dev/api/v1/auth-apps/add`.</Note>--### Connected accounts / User IDs--The primary change in connected accounts and user IDs is that user IDs are now a more prominent concept compared to entities in previous versions.--We have simplified the process of connecting a user to a toolkit. Instead of multiple methods and parameters for initiating a connection, both the SDK and API now require only a `user_id` and `auth_config_id` to initiate a connection.--This approach is more explicit and works well with the ability for developers to have multiple auth configs for a given toolkit.--Connected accounts now use nano IDs instead of UUIDs:--| Previous (UUID) Example | Current (Nano ID) Example |-| :----------------------------------- | :------------------------ |-| `b7a9c1e2-3f4d-4a6b-8c2e-1d2f3a4b5c6d` | `ca_8x9w2l3k5m` |--Previously, you might have initiated a connection like this:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/old_connected_acc.py"- startLine={1}- endLine={30}- highlightStart={11}- highlightEnd={16}- title="Python (previous)"-/>-<SnippetCode- src="fern/snippets/migration/old_connected_acc.ts"- startLine={1}- endLine={30}- highlightStart={8}- highlightEnd={13}- title="TypeScript (previous)"-/>-</CodeGroup>--The current process for initiating a connection is as follows:--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_connected_acc.py"- startLine={1}- endLine={15}- highlightStart={8}- highlightEnd={11}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_connected_acc.ts"- startLine={1}- endLine={15}- highlightStart={8}- highlightEnd={11}- title="TypeScript (current)"-/>-</CodeGroup>--### Triggers--Composio continues to support listening to application events using triggers through WebSockets and webhooks.--#### Creating triggers--The process for creating triggers and specifying their configuration has been redesigned for improved clarity and intuitiveness.--Some triggers require configuration, such as repository names for GitHub triggers or channel names for Slack triggers. The process usually follows the pattern of fetching the trigger type and then creating the trigger with the appropriate configuration.--<CodeGroup>-<SnippetCode- src="fern/snippets/migration/new_triggers.py"- startLine={1}- endLine={33}- title="Python (current)"-/>-<SnippetCode- src="fern/snippets/migration/new_triggers.ts"- startLine={1}- endLine={35}- title="TypeScript (current)"-/>-</CodeGroup>--#### Enabling/Disabling triggers--You can enable or disable triggers through either the SDK or the dashboard. The dashboard process remains unchanged.--Managing triggers with the SDK:--<CodeGroup>- ```python Python maxLines=60 wordWrap- # Disable a trigger instance- disabled_instance = composio.triggers.disable(trigger_id="ti_abcd123")- print(disabled_instance)- ```- ```typescript TypeScript maxLines=60 wordWrap- await composio.triggers.disable("ti_abcd123");- ```-</CodeGroup>--If needed, the trigger can be enabled again.--<CodeGroup>- ```python Python maxLines=60 wordWrap- # Enable a trigger instance- enabled_instance = composio.triggers.enable(trigger_id="ti_abcd123")- print(enabled_instance)- ```- ```typescript TypeScript maxLines=60 wordWrap- await composio.triggers.enable("ti_abcd123");- ```-</CodeGroup>--#### Listening to triggers--We recommend listening to triggers through webhooks. The following are example routes for Next.js and FastAPI.--For development, you can also [listen to triggers through the SDK](/docs/using-triggers#subscribing-to-triggers-using-the-sdk-for-development).--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/python/trigger-webhook.py"- title="app/route.py (FastAPI)"-/>-<SnippetCode- src="fern/snippets/triggers/typescript/trigger-webhook.ts"- title="app/api/webhook/route.ts (Next.js)"-/>-</CodeGroup>--## 🚧 Coming Soon--### Local tools--Previously, the Python SDK included *[local tools](https://github.com/ComposioHQ/composio/tree/master/python/composio/tools/local)*. These were tools defined within the SDK and consisted of local shell and code-related tools such as "clipboard", "sqltool", and "shelltool".--This feature is currently in development for both Python and TypeScript SDKs, with newly created tools built for improved agent accuracy.--{/* ### Generated types--In the previous Python SDK, you could generate types for tools using the CLI:--```bash-composio apps generate-types-```--This provided app slugs and tool slugs with IntelliSense support:--```python Python (previous)-from composio_openai import ComposioToolSet, App, Action--print(App.GITHUB)-print(Action.GITHUB_CREATE_ISSUE)-``` */}--This feature is currently in development for both Python and TypeScript SDKs.--## API Endpoints--The following table lists important API endpoints that have changed. You can use this reference to quickly find the new v3 API endpoint for migration:--<Note>This list is not exhaustive. Please refer to the [API Reference](/api-reference) for the complete list of endpoints.</Note>--### Toolkits (formerly Apps)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/apps`](https://docs.composio.dev/api-reference/api-reference/apps/get-apps) | [`GET /api/v3/toolkits`](https://docs.composio.dev/api-reference/toolkits/get-toolkits) |-| [`GET /api/v1/apps/list/categories`](https://docs.composio.dev/api-reference/api-reference/apps/list-app-categories) | [`GET /api/v3/toolkits/categories`](https://docs.composio.dev/api-reference/toolkits/get-toolkits-categories) |-| [`GET /api/v1/apps/{appName}`](https://docs.composio.dev/api-reference/api-reference/apps/get-app) | [`GET /api/v3/toolkits/{slug}`](https://docs.composio.dev/api-reference/toolkits/get-toolkits-by-slug) |--### Tools (formerly Actions)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v2/actions`](https://docs.composio.dev/api-reference/api-reference/actions/list-actions-minimal-v-2) | [`GET /api/v3/tools`](https://docs.composio.dev/api-reference/tools/get-tools) |-| [`GET /api/v2/actions/list/enums`](https://docs.composio.dev/api-reference/api-reference/actions/list-action-enums) | [`GET /api/v3/tools/enum`](https://docs.composio.dev/api-reference/tools/get-tools-enum) |-| [`GET /api/v2/actions/{actionId}`](https://docs.composio.dev/api-reference/api-reference/actions/get-action-v-2) | [`GET /api/v3/tools/{tool_slug}`](https://docs.composio.dev/api-reference/tools/get-tools-by-tool-slug) |-| [`POST /api/v2/actions/{actionId}/execute`](https://docs.composio.dev/api-reference/api-reference/actions/execute-action-v-2) | [`POST /api/v3/tools/execute/{tool_slug}`](https://docs.composio.dev/api-reference/tools/post-tools-execute-by-tool-slug)|-| [`POST /api/v2/actions/{actionId}/execute/get.inputs`](https://docs.composio.dev/api-reference/api-reference/actions/get-action-inputs-v-2)| [`POST /api/v3/tools/execute/{tool_slug}/input`](https://docs.composio.dev/api-reference/tools/post-tools-execute-by-tool-slug-input)|-| [`POST /api/v2/actions/proxy`](https://docs.composio.dev/api-reference/api-reference/actions/execute-action-proxy-v-2) | [`POST /api/v3/tools/execute/proxy`](https://docs.composio.dev/api-reference/tools/post-tools-execute-proxy)|--### Auth Configs (formerly Integrations/Connectors)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/integrations`](https://docs.composio.dev/api-reference/api-reference/integrations/list-all-connectors) | [`GET /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/get-auth-configs) |-| [`POST /api/v1/integrations`](https://docs.composio.dev/api-reference/api-reference/integrations/create-connector) | [`POST /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/post-auth-configs) |-| [`GET /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/get-connector-info) | [`GET /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/get-auth-configs-by-nanoid) |-| [`PATCH /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/modify-connector) | [`PATCH /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/patch-auth-configs-by-nanoid) |-| [`DELETE /api/v1/integrations/{integrationId}`](https://docs.composio.dev/api-reference/api-reference/integrations/delete-connector) | [`DELETE /api/v3/auth_configs/{nanoid}`](https://docs.composio.dev/api-reference/auth-configs/delete-auth-configs-by-nanoid) |-| [`POST /api/v2/integrations/create`](https://docs.composio.dev/api-reference/api-reference/integrations-v-2/create-connector-v-2) | [`POST /api/v3/auth_configs`](https://docs.composio.dev/api-reference/auth-configs/post-auth-configs) |--### Connected Accounts (formerly Connections)--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/connectedAccounts`](https://docs.composio.dev/api-reference/api-reference/connections/get-connections) | [`GET /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/get-connected-accounts) |-| [`POST /api/v1/connectedAccounts`](https://docs.composio.dev/api-reference/api-reference/connections/initiate-connection) | [`POST /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts) |-| [`POST /api/v2/connectedAccounts/initiateConnection`](https://docs.composio.dev/api-reference/api-reference/connectionsv-2/initiate-connection-v-2)| [`POST /api/v3/connected_accounts`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts) |-| [`GET /api/v1/connectedAccounts/{connectedAccountId}`](https://docs.composio.dev/api-reference/api-reference/connections/get-connection)| [`GET /api/v3/connected_accounts/{nanoid}`](https://docs.composio.dev/api-reference/connected-accounts/get-connected-accounts-by-nanoid)|-| [`DELETE /api/v1/connectedAccounts/{connectedAccountId}`](https://docs.composio.dev/api-reference/api-reference/connections/delete-connection)| [`DELETE /api/v3/connected_accounts/{nanoid}`](https://docs.composio.dev/api-reference/connected-accounts/delete-connected-accounts-by-nanoid) |-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/disable`](https://docs.composio.dev/api-reference/api-reference/connections/disable-connection)| [`PATCH /api/v3/connected_accounts/{nanoId}/status`](https://docs.composio.dev/api-reference/connected-accounts/patch-connected-accounts-by-nano-id-status)|-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/enable`](https://docs.composio.dev/api-reference/api-reference/connections/enable-connection) | [`PATCH /api/v3/connected_accounts/{nanoId}/status`](https://docs.composio.dev/api-reference/connected-accounts/patch-connected-accounts-by-nano-id-status)|-| [`POST /api/v1/connectedAccounts/{connectedAccountId}/reinitiate`](https://docs.composio.dev/api-reference/api-reference/connections/reinitiate-connection)| [`POST /api/v3/connected_accounts/{nanoid}/refresh`](https://docs.composio.dev/api-reference/connected-accounts/post-connected-accounts-by-nanoid-refresh)|--### Triggers--| Previous Endpoint | Current Endpoint |-| :--- | :--- |-| [`GET /api/v1/triggers`](https://docs.composio.dev/api-reference/api-reference/triggers/list-triggers) | [`GET /api/v3/triggers_types`](https://docs.composio.dev/api-reference/triggers/get-triggers-types) |-| [`GET /api/v1/triggers/list/enums`](https://docs.composio.dev/api-reference/api-reference/triggers/list-trigger-enums) | [`GET /api/v3/triggers_types/list/enum`](https://docs.composio.dev/api-reference/triggers/get-triggers-types-list-enum)|-| [`GET /api/v2/triggers/{triggerName}`](https://docs.composio.dev/api-reference/api-reference/triggers/get-trigger-info-v-2) | [`GET /api/v3/triggers_types/{slug}`](https://docs.composio.dev/api-reference/triggers/get-triggers-types-by-slug)|-| [`GET /api/v1/triggers/active_triggers`](https://docs.composio.dev/api-reference/api-reference/triggers/get-active-triggers)| [`GET /api/v3/trigger_instances/active`](https://docs.composio.dev/api-reference/triggers/get-trigger-instances-active)|-| [`POST /api/v1/triggers/enable/{connectedAccountId}/{triggerName}`](https://docs.composio.dev/api-reference/api-reference/triggers/enable-trigger)| [`POST /api/v3/trigger_instances/{slug}/upsert`](https://docs.composio.dev/api-reference/triggers/post-trigger-instances-by-slug-upsert)|-| [`DELETE /api/v1/triggers/instance/{triggerInstanceId}`](https://docs.composio.dev/api-reference/api-reference/triggers/delete-trigger)| [`DELETE /api/v3/trigger_instances/manage/{triggerId}`](https://docs.composio.dev/api-reference/triggers/delete-trigger-instances-manage-by-trigger-id)|-| [`PATCH /api/v1/triggers/instance/{triggerId}/status`](https://docs.composio.dev/api-reference/api-reference/triggers/switch-trigger-instance-status)| [`PATCH /api/v3/trigger_instances/manage/{triggerId}`](https://docs.composio.dev/api-reference/triggers/patch-trigger-instances-manage-by-trigger-id)|diff --git a/fern/pages/src/resources/troubleshooting/api.mdx b/fern/pages/src/resources/troubleshooting/api.mdxdeleted file mode 100644index 26dee5cbd..000000000--- a/fern/pages/src/resources/troubleshooting/api.mdx+++ /dev/null@@ -1,21 +0,0 @@-----title: API-subtitle: Troubleshooting API issues-image: "https://og.composio.dev/api/og?title=API%20Troubleshooting"-keywords: 'api, rest, troubleshooting, curl, debugging'-hide-nav-links: true------## Reporting API issues--When reporting API issues to support, provide the following:--- **cURL command**: Include the exact cURL to reproduce the issue-- **Request ID**: Add `x-request-id: <uuid>` header to your request and share the UUID (generate at [uuidgenerator.net](https://www.uuidgenerator.net/))-- **Error details**: Share the complete error message-- **Reproduction steps**: Include any steps needed to reproduce the issue--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/authentication.mdx b/fern/pages/src/resources/troubleshooting/authentication.mdxdeleted file mode 100644index aa142e89d..000000000--- a/fern/pages/src/resources/troubleshooting/authentication.mdx+++ /dev/null@@ -1,46 +0,0 @@-----title: Authentication-subtitle: Troubleshooting authentication issues-image: "https://og.composio.dev/api/og?title=Authentication%20Troubleshooting"-keywords: 'authentication, oauth, connections, scopes, troubleshooting, redacted, mask secrets, mask connected account secrets'-hide-nav-links: true------## Using Composio's default OAuth app--When using our default OAuth configuration:--- **Don't add additional scopes** - They may not be approved in our OAuth app-- Use only the pre-configured scopes provided--## Using custom OAuth apps--Ensure your OAuth app is configured correctly:--- **Redirect URL**: Must match exactly what's configured in your OAuth provider-- **Scopes**: Auth config scopes must match your OAuth app configuration-- **Credentials**: Verify client ID and secret are correct--For setup guides by toolkit: [OAuth Configuration Guides](https://composio.dev/oauth)--## Common authentication issues--- **Invalid redirect URI**: Check the callback URL matches exactly-- **Scope mismatch**: Ensure requested scopes are configured in both auth config and OAuth app-- **Expired tokens**: Try refreshing the connection-- **Rate limits**: Some providers limit authentication attempts-- **Credentials showing as `REDACTED`**: The "Mask Connected Account Secrets" setting is enabled on your account, which redacts all sensitive credential data. Navigate to **Settings → Project Settings → Project Configuration** and disable "Mask Connected Account Secrets" to view actual values--## Reporting authentication issues--When reporting to support, provide:--- **Error message**: Complete error details and screenshots-- **Auth config ID**: The `authConfigId` being used-- **Connected account ID**: If a connection was already created-- **OAuth provider**: Which service you're trying to connect--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/cli.mdx b/fern/pages/src/resources/troubleshooting/cli.mdxdeleted file mode 100644index 40832df93..000000000--- a/fern/pages/src/resources/troubleshooting/cli.mdx+++ /dev/null@@ -1,94 +0,0 @@-----title: CLI-subtitle: Troubleshooting CLI issues-image: "https://og.composio.dev/api/og?title=CLI%20Troubleshooting"-keywords: 'cli, command line, troubleshooting, installation, authentication'-hide-nav-links: true------## Command not found--Verify the CLI is installed and in your PATH:--```bash-which composio-```--If not found, reinstall:--```bash-curl -fsSL https://composio.dev/install | bash-```--Or add to PATH:--```bash-echo 'export PATH="$HOME/.composio:$PATH"' >> ~/.bashrc && source ~/.bashrc-```--## Authentication errors--Check current authentication:--```bash-composio whoami-```--Re-authenticate if needed:--```bash-composio logout-composio login-```--For CI/CD, use environment variable:--```bash-export COMPOSIO_API_KEY="your-api-key"-```--## Type generation issues--### Project type not detected--Use language-specific commands:--```bash-composio ts generate # TypeScript-composio py generate # Python-```--### Output directory missing--Specify output directory explicitly:--```bash-composio generate --output-dir ./my-types-```--## Debug CLI issues--Enable debug logging:--```bash-composio --log-level debug [command]-```--Check version compatibility:--```bash-composio version-```--## Common issues--- **API key not found**: Run `composio login`-- **Project type detection fails**: Use language-specific commands or ensure you're in project root-- **Network timeout**: Check internet connection and proxy settings-- **Permission denied**: Check directory write permissions--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)-- **GitHub**: [Create an issue](https://github.com/ComposioHQ/composio/issues/new?labels=bug)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/dashboard.mdx b/fern/pages/src/resources/troubleshooting/dashboard.mdxdeleted file mode 100644index 9df2e960f..000000000--- a/fern/pages/src/resources/troubleshooting/dashboard.mdx+++ /dev/null@@ -1,23 +0,0 @@-----title: Dashboard-subtitle: Troubleshooting dashboard issues-image: "https://og.composio.dev/api/og?title=Dashboard%20Troubleshooting"-keywords: 'dashboard, platform, UI, troubleshooting, debugging'-hide-nav-links: true------## Reporting dashboard issues--When reporting dashboard issues to support, provide:--- **Screenshot or recording**: Visual evidence of the issue-- **Error details**: Complete error message shown in the UI-- **Network logs**: Check browser DevTools for failing API calls and share:- - Error message- - Request ID (`x-request-id` header)- - Failed endpoint URL--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/mcp.mdx b/fern/pages/src/resources/troubleshooting/mcp.mdxdeleted file mode 100644index cb15dd5ac..000000000--- a/fern/pages/src/resources/troubleshooting/mcp.mdx+++ /dev/null@@ -1,51 +0,0 @@-----title: MCP-subtitle: Troubleshooting MCP server issues-image: "https://og.composio.dev/api/og?title=MCP%20Troubleshooting"-keywords: 'mcp, model context protocol, server, troubleshooting, debugging'-hide-nav-links: true------## Connected account not found error--This error occurs when MCP cannot find a valid connected account for authentication:--- **Specify an account**: Provide either `connected_account_id` or `user_id` in your MCP configuration-- **Default behavior**: Without specification, MCP uses `user_id=default`. If multiple connections exist with the same user_id, the most recent is used-- **Verification checklist**:- - Account status is `ACTIVE` (not deleted)- - Account belongs to the same auth config used to create the MCP server--Learn more: [MCP Developer Guide](/docs/mcp-developers#client-applications-connect-to-the-server)--## Getting 404 errors--Verify your URL format matches one of these patterns:--- `https://mcp.composio.dev/composio/server/<UUID>/mcp`-- `https://apollo-<randomID>-composio.vercel.app/v3/mcp/<UUID>`-- `https://apollo.composio.dev/v3/mcp/<UUID>`--## Testing and debugging--If experiencing issues, test your MCP server with:--- [Postman MCP Requests](https://learning.postman.com/docs/postman-ai-developer-tools/mcp-requests/create/)-- [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector)--This helps identify whether the issue is with your MCP client or the server.--## Reporting MCP issues--When reporting to support, provide:--- **Error message**: Complete error details-- **MCP server URL**: The exact URL you're connecting to-- **Testing results**: Whether issue reproduces in MCP Inspector/Postman or only in specific client-- **Connected account ID**: If facing connection issues-- **Reproduction steps**: Clear steps to reproduce the issue--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/overview.mdx b/fern/pages/src/resources/troubleshooting/overview.mdxdeleted file mode 100644index 533a9fa69..000000000--- a/fern/pages/src/resources/troubleshooting/overview.mdx+++ /dev/null@@ -1,58 +0,0 @@-----title: Troubleshooting-subtitle: Common issues and quick links-image: "https://og.composio.dev/api/og?title=Troubleshooting"-keywords: 'troubleshooting, errors, issues, debugging, problems'-hide-nav-links: true------This section is designed to help you quickly identify and resolve common issues encountered with the Composio.--Some quick links:-<Card- title="Report issues"- icon="fa-light fa-bug"- href="https://github.com/ComposioHQ/composio/issues/new?labels=bug"->- Found a bug? Please create a Github issue!-</Card>--<Card- title="Ask AI"- icon="fa-light fa-brain"- href="https://deepwiki.com/ComposioHQ/composio"->- Try to use Ask AI in the docs or deepwiki to get the fastes responses on features, types, and best practices.-</Card>--<Card- title="Feature requests"- icon="fa-light fa-sparkles"- href="https://github.com/ComposioHQ/composio/issues/new?labels=enhancement"->- Have an idea for improving Composio? Share your feature suggestions with us and we will prioritise your requests-</Card>--<Card- title="Ask the community"- icon="fa-light fa-comments"- href="https://github.com/ComposioHQ/composio/discussions"->- Join our GitHub discussions to get help from the community-</Card>--<Card- title="Discord community"- icon="fa-brands fa-discord"- href="https://discord.com/channels/1170785031560646836/1268871288156323901"->- Post support queries on our discord channel or reachout to [email protected]-</Card>--<Card- title="Migration guides"- icon="fa-light fa-book"- href="/docs/migration"->- Check out our migration guides to help you upgrade to the latest version.-</Card>\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/sdks.mdx b/fern/pages/src/resources/troubleshooting/sdks.mdxdeleted file mode 100644index d459fa6e2..000000000--- a/fern/pages/src/resources/troubleshooting/sdks.mdx+++ /dev/null@@ -1,50 +0,0 @@-----title: SDKs-subtitle: Troubleshooting SDK issues-image: "https://og.composio.dev/api/og?title=SDK%20Troubleshooting"-keywords: 'sdk, python, typescript, troubleshooting, debugging'-hide-nav-links: true------## Debug network issues--Enable debug logging to see API calls and identify if issues are SDK or API related. Look for the `x-request-id` in logs to share with support.--<CodeGroup>-```python Python-# Set environment variable-COMPOSIO_LOGGING_LEVEL=debug-```-```typescript TypeScript-// Set environment variable-COMPOSIO_LOG_LEVEL=debug-```-</CodeGroup>--## Check SDK version--Ensure you're using the latest version:--<CodeGroup>-```bash Python-pip install --upgrade composio-```-```bash TypeScript-npm install @composio/core@latest-```-</CodeGroup>--Check current version:-- Python: [PyPI](https://pypi.org/project/composio/)-- TypeScript: [npm](https://www.npmjs.com/package/@composio/core)--## Common issues--- **Type errors or parameter confusion**: Search [DeepWiki](https://deepwiki.com/ComposioHQ/composio) or use the Ask AI assistant-- **Tool-specific issues**: Check the [specific tool's documentation](/toolkits/introduction)-- **Bug reporting**: Create a [GitHub issue](https://github.com/ComposioHQ/composio/issues/new?labels=bug) with debug logs and reproduction steps--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/tools.mdx b/fern/pages/src/resources/troubleshooting/tools.mdxdeleted file mode 100644index cefb046ad..000000000--- a/fern/pages/src/resources/troubleshooting/tools.mdx+++ /dev/null@@ -1,55 +0,0 @@-----title: Tools & Toolkits-subtitle: Troubleshooting tool execution issues-image: "https://og.composio.dev/api/og?title=Tools%20Troubleshooting"-keywords: 'tools, toolkits, execution, permissions, troubleshooting'-hide-nav-links: true------## Tool execution failures (401/403 errors)--Authentication and permission errors typically occur due to:--### Missing scopes--Check if your connection has the required scopes using this API:--```bash-curl --location 'https://backend.composio.dev/api/v3/tools/get_scopes_required' \---header 'x-api-key: YOUR_COMPOSIO_API_KEY' \---header 'Content-Type: application/json' \---data '{- "tools": [- "SLACK_SENDS_A_MESSAGE_TO_A_SLACK_CHANNEL",- "SLACK_CREATE_A_REMINDER"- ]-}'-```--### Insufficient permissions--Verify the connected account has necessary permissions:--- **Admin requirements**: Some tools require admin-level access-- **Paid accounts**: Certain toolkits need paid subscriptions- - Example: MS Teams requires Microsoft 365 account + Azure AD tenant--## Tool not working--- Check [tool-specific documentation](/toolkits/introduction) for requirements-- Verify the connected account is active and properly authenticated-- Test with the latest SDK version--## Reporting tool issues--When reporting to support, provide:--- **Error message**: Complete error details-- **Log ID**: From the error response-- **Tool name**: Exact tool slug being executed-- **Connected account ID**: Account used for execution--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/resources/troubleshooting/triggers.mdx b/fern/pages/src/resources/troubleshooting/triggers.mdxdeleted file mode 100644index 8ef7fa443..000000000--- a/fern/pages/src/resources/troubleshooting/triggers.mdx+++ /dev/null@@ -1,36 +0,0 @@-----title: Triggers-subtitle: Troubleshooting trigger issues-image: "https://og.composio.dev/api/og?title=Triggers%20Troubleshooting"-keywords: 'triggers, webhooks, events, troubleshooting, debugging'-hide-nav-links: true------## Unable to create trigger--Check the error message - the account might not have sufficient permissions or required scopes.--## Type errors with trigger payloads--Having issues with trigger payload types? Search [DeepWiki](https://deepwiki.com/ComposioHQ/composio) or use the Ask AI assistant for type definitions and examples.--## Not receiving trigger payloads--Even if the action occurred (email received, Jira issue created, etc.), there may be delays:--- **Gmail triggers**: Uses polling with minimum 1-minute frequency - expect delays of up to a minute-- **Other services**: May have their own polling intervals or webhook delivery delays--## Reporting trigger issues--When reporting to support, provide:--- **Error message**: Complete error details-- **Connected account**: The account ID used for creating the trigger-- **cURL command**: To reproduce the issue-- **Reproduction steps**: Any additional steps needed--## Getting help--- **Email**: [email protected]-- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)\ No newline at end of filediff --git a/fern/pages/src/tool-router/authentication.mdx b/fern/pages/src/tool-router/authentication.mdxdeleted file mode 100644index 2f577884f..000000000--- a/fern/pages/src/tool-router/authentication.mdx+++ /dev/null@@ -1,70 +0,0 @@-----title: Authentication-image: "https://og.composio.dev/api/og?title=Authentication"-description: "Understand how Tool Router handles user authentication to toolkits"-keywords: "authentication, tool router, oauth, api key, connected accounts"-hide-nav-links: false------Tool Router handles authentication through [Connect Links](/docs/authenticating-tools#hosted-authentication-connect-link), hosted pages where users complete OAuth or enter credentials.--## In-chat authentication--By default, when a tool requires authentication, the agent prompts the user with a Connect Link. The user authenticates and confirms in chat. The agent handles OAuth flows, token refresh, and credential management automatically.--Here's what this looks like in a conversation:--```-You: Star the composio repo on GitHub--Agent: I need you to connect your GitHub account first.- Please click here to authorize: https://connect.composio.dev/link/ln_abc123--You: Done--Agent: Done! I've starred ComposioHQ/composio.-```--This flow works well for chat applications where users interact directly with the agent. See [Using in-chat authentication](/tool-router/using-in-chat-authentication).--## Manual authentication--For apps that manage auth outside of chat, use `session.authorize()` to generate Connect Links programmatically:--<CodeGroup>-```python-connection_request = session.authorize("github")-print(connection_request.redirect_url)-# https://connect.composio.dev/link/ln_abc123-```-```typescript-const connectionRequest = await session.authorize("github");-console.log(connectionRequest.redirectUrl);-// https://connect.composio.dev/link/ln_abc123-```-</CodeGroup>--Use this when you want users to connect accounts during onboarding, or when building a custom connections page. See [Manually authenticating users](/tool-router/manually-authenticating-users) for a detailed guide.--## How Tool Router manages auth configs--When executing a tool, Tool Router needs an auth config to find or create a connected account. It handles this automatically:--1. Uses your `authConfigs` override if provided-2. Otherwise, reuses an auth config it previously created for this toolkit-3. If none exists, creates one using Composio managed auth--You don't need to create auth configs manually for most toolkits.--## Supported auth methods--Tool Router supports **Composio managed OAuth** (GitHub, Gmail, Slack, and most toolkits) and **API key auth** (users enter their own keys via Connect Link).--<Note>-Toolkits without Composio managed auth require a custom auth config. See [Using custom auth configs](/tool-router/using-custom-auth-configs).-</Note>--## White-labeling--Show your own branding on OAuth consent screens by creating your own OAuth app. See [White-labeling authentication](/tool-router/white-labeling-authentication).-diff --git a/fern/pages/src/tool-router/managing-multiple-accounts.mdx b/fern/pages/src/tool-router/managing-multiple-accounts.mdxdeleted file mode 100644index 105cbc2fe..000000000--- a/fern/pages/src/tool-router/managing-multiple-accounts.mdx+++ /dev/null@@ -1,123 +0,0 @@-----title: Managing multiple accounts-image: "https://og.composio.dev/api/og?title=Managing%20Multiple%20Accounts"-description: "Handle users with multiple accounts for the same toolkit"-keywords: "tool router, multiple accounts, connected accounts, account selection"------Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail accounts). This is useful when users need to manage different email accounts, GitHub organizations, or separate work and personal contexts. This guide explains how to connect, select, and manage multiple accounts.--## Default account behavior--When multiple accounts are connected for the same toolkit:-- Each session can only use **one account per toolkit** at a time-- Tool Router uses the **most recently connected account** by default-- You can override this by explicitly selecting an account-- Each account maintains its own authentication and permissions--## Connecting multiple accounts--Call `session.authorize()` multiple times for the same toolkit. Each authorization creates a separate connected account with its own ID. The most recently connected account becomes the active one for that session. New sessions will also use the most recent account unless you [explicitly select a different one](#selecting-a-specific-account-for-a-session).--<CodeGroup>-```python-session = composio.create(user_id="user_123")--# Connect first account (work)-work_auth = session.authorize("gmail")-print(f"Connect work Gmail: {work_auth.redirect_url}")-work_connection = work_auth.wait_for_connection()-print(f"Work account connected: {work_connection.id}")--# Connect second account (personal)-personal_auth = session.authorize("gmail")-print(f"Connect personal Gmail: {personal_auth.redirect_url}")-personal_connection = personal_auth.wait_for_connection()-print(f"Personal account connected: {personal_connection.id}")-```-```typescript-const session = await composio.create("user_123");--// Connect first account (work)-const workAuth = await session.authorize("gmail");-console.log(`Connect work Gmail: ${workAuth.redirectUrl}`);-const workConnection = await workAuth.waitForConnection();-console.log(`Work account connected: ${workConnection.id}`);--// Connect second account (personal)-const personalAuth = await session.authorize("gmail");-console.log(`Connect personal Gmail: ${personalAuth.redirectUrl}`);-const personalConnection = await personalAuth.waitForConnection();-console.log(`Personal account connected: ${personalConnection.id}`);-```-</CodeGroup>--<Note>-Store the account IDs returned after connection to explicitly select accounts later.-</Note>--## Selecting a specific account for a session--Each Tool Router session can only use one account per toolkit at a time. To use a specific account in a session, pass it in the session config:--<CodeGroup>-```python-# This session will use a specific Gmail account-session = composio.create(- user_id="user_123",- connected_accounts={- "gmail": "ca_specific_account_id", # Connected account ID- },-)--# To switch accounts, create a new session with a different account ID-session2 = composio.create(- user_id="user_123",- connected_accounts={- "gmail": "ca_different_account_id", # Different account- },-)-```-```typescript-// This session will use a specific Gmail account-const session = await composio.create("user_123", {- connectedAccounts: {- gmail: "ca_specific_account_id", // Connected account ID- },-});--// To switch accounts, create a new session with a different account ID-const session2 = await composio.create("user_123", {- connectedAccounts: {- gmail: "ca_different_account_id", // Different account- },-});-```-</CodeGroup>--## Listing all user accounts--To list all accounts a user has connected (not just the active one), see [List accounts](/docs/connected-accounts#list-accounts).--## Viewing session's active account--Use `session.toolkits()` to see which account is currently active in the session:--<CodeGroup>-```python-toolkits = session.toolkits()--for toolkit in toolkits.items:- if toolkit.connection.connected_account:- print(f"{toolkit.name}: {toolkit.connection.connected_account.id}")-```-```typescript-const toolkits = await session.toolkits();--for (const toolkit of toolkits.items) {- if (toolkit.connection.connectedAccount) {- console.log(`${toolkit.name}: ${toolkit.connection.connectedAccount.id}`);- }-}-```-</CodeGroup>diff --git a/fern/pages/src/tool-router/manually-authenticating-users.mdx b/fern/pages/src/tool-router/manually-authenticating-users.mdxdeleted file mode 100644index a7ec99272..000000000--- a/fern/pages/src/tool-router/manually-authenticating-users.mdx+++ /dev/null@@ -1,93 +0,0 @@-----title: Manually authenticating users-image: "https://og.composio.dev/api/og?title=Manually%20Authenticating%20Users"-description: "Authenticate users to toolkits outside of chat"-keywords: "tool router, authentication, manual, authorize, toolkits"------Manual authentication lets you connect users to toolkits outside of the chat flow. Use this when you want to:-- Pre-authenticate users before they start chatting-- Build a custom connections UI in your app--## Authorize a toolkit--Use `session.authorize()` to generate a [Connect Link](/docs/authenticating-tools#hosted-authentication-connect-link) URL, redirect the user, and wait for them to complete:--<CodeGroup>-```python-session = composio.create(user_id="user_123")--connection_request = session.authorize("gmail")--print(connection_request.redirect_url)-# https://connect.composio.dev/link/ln_abc123--connected_account = connection_request.wait_for_connection(60000)-print(f"Connected: {connected_account.id}")-```-```typescript-const session = await composio.create("user_123");--const connectionRequest = await session.authorize("gmail");--console.log(connectionRequest.redirectUrl);-// https://connect.composio.dev/link/ln_abc123--const connectedAccount = await connectionRequest.waitForConnection(60000);-console.log(`Connected: ${connectedAccount.id}`);-```-</CodeGroup>--Redirect the user to the redirect URL. After they authenticate, they'll return to your callback URL. The connection request polls until the user completes authentication (default timeout: 60 seconds).--<Note>-If the user closes the Connect Link without completing auth, the connection remains in `INITIATED` status until it expires.-</Note>--## Check connection status--Use `session.toolkits()` to see all toolkits in the session and their connection status:--<CodeGroup>-```python-toolkits = session.toolkits()--for toolkit in toolkits.items:- status = toolkit.connection.connected_account.id if toolkit.connection.is_active else "Not connected"- print(f"{toolkit.name}: {status}")-```-```typescript-const toolkits = await session.toolkits();--toolkits.items.forEach((toolkit) => {- console.log(`${toolkit.name}: ${toolkit.connection.connectedAccount?.id ?? "Not connected"}`);-});-```-</CodeGroup>--## Disabling in-chat auth--By default, Tool Router includes the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool that prompts users to authenticate during chat. To disable this and handle auth entirely in your UI:--<CodeGroup>-```python-session = composio.create(- user_id="user_123",- manage_connections=False,-)-```-```typescript-const session = await composio.create("user_123", {- manageConnections: false,-});-```-</CodeGroup>--## Putting it together--A common pattern is to verify all required connections before starting the agent:--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/manual-auth.py" title="Python" />-<SnippetCode src="fern/snippets/tool-router/typescript/manual-auth.ts" title="TypeScript" />-</CodeGroup>diff --git a/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx b/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdxdeleted file mode 100644index 7adab6395..000000000--- a/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx+++ /dev/null@@ -1,86 +0,0 @@-----title: Migration from the beta release version-subtitle: Migrate from Tool Router beta to the stable version-image: "https://og.composio.dev/api/og?title=Tool%20Router%20Migration"-keywords: "tool router migration"-hide-nav-links: false-----The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.--## The basics--<Steps>- <Step title="Upgrade composio package">- Upgrade to the latest stable version:- <CodeGroup>- ```bash title="Python" for="python"- pip install --upgrade composio- ```- ```bash title="TypeScript" for="typescript"- npm install @composio/core@latest- ```- </CodeGroup>- </Step>- <Step title="Update session creation">- <CodeGroup>- ```python title="Python" for="python"- # Beta (before)- session = composio.experimental.tool_router.create_session(- user_id="[email protected]"- )-- # Stable (after)- session = composio.create(- user_id="[email protected]"- )- ```- ```typescript title="TypeScript" for="typescript"- // Beta (before)- const session = await composio.experimental.toolRouter.createSession('user_123');-- // Stable (after)- const session = await composio.create('user_123');- ```- </CodeGroup>- </Step>- <Step title="Moving users (optional)">- If you have existing users on tool router and you don't want them to authenticate again:- - Tool Router will auto-detect auth configs and connected accounts it created(from the beta version).- - If you have custom auth configs (not created by Tool Router):- - Search for the Auth config for that connected account. See [Connected Accounts](/docs/connected-accounts) to fetch existing accounts programmatically.- - While creating a session configure to use this Auth config.- - You need to repeat this for each toolkit you want to enable for that session.- <CodeGroup>- ```python title="Python" for="python"- session = composio.create(- user_id="user_123",- auth_configs={- "github": "ac_your_github_config",- "slack": "ac_your_slack_config"- }- )- ```- ```typescript title="TypeScript" for="typescript"- const session = await composio.create('user_123',- {- authConfigs: {- github: "ac_your_github_config",- slack: "ac_your_slack_config",- },- }- );- ```- </CodeGroup>- </Step>- <Step title="Explore new capabilities">- Check out these new features available in the stable version:-- - **[Native tools](/tool-router/using-as-a-native-tool)**: Use Tool Router with any AI framework- - **Better [session](/tool-router/users-and-sessions) and [auth](/tool-router/authentication) config**- - **[Multi-account support](/tool-router/managing-multiple-accounts)**: Manage multiple accounts per user seamlessly- - **[Manual authentication](/tool-router/manually-authenticating-users)**: Control when and how users authenticate- - **[Custom auth](/tool-router/using-custom-auth-configs)**: Support for toolkits that don't have composio managed auth- - **[White labeling](/tool-router/white-labeling-authentication)**: Customize authentication screens with your branding- </Step>-</Steps>-diff --git a/fern/pages/src/tool-router/overview.mdx b/fern/pages/src/tool-router/overview.mdxdeleted file mode 100644index 4e904637e..000000000--- a/fern/pages/src/tool-router/overview.mdx+++ /dev/null@@ -1,24 +0,0 @@-----title: Tool Router-image: "https://og.composio.dev/api/og?title=Tool%20Router"-description: "Give your AI agent access to thousands of tools through a unified interface"-keywords: "tool router"------Tool Router is a unified interface that lets an agent **search**, **plan**, **authenticate**, and **execute** actions across thousands of Composio tools.--Consider an agent that works across Gmail, Notion, Slack, Google Drive, and hundreds of other apps. The challenges:--- **Search**: Identifying the right tool for the task-- **Context Management**: Managing context for complex queries with large responses-- **Authentication**: Handling authentication across all of them--Tool Router exposes a set of meta-tools that handle all this complexity including search to discover the right tools, and a workbench to process results without flooding context.--This is what powers complex agentic products like [Rube](https://rube.app).--## Quick links--- [Quickstart](/tool-router/quickstart): Build your first AI agent with Tool Router.-- [Using with MCP clients](/tool-router/using-with-mcp-clients): Guides on how to use Tool Router MCP with popular MCP clients.-- [Using as a native tool](/tool-router/using-as-a-native-tool): Guide on how to use Tool Router as a native tool with any AI framework.diff --git a/fern/pages/src/tool-router/quick-start-deprecated.mdx b/fern/pages/src/tool-router/quick-start-deprecated.mdxdeleted file mode 100644index dab22ae16..000000000--- a/fern/pages/src/tool-router/quick-start-deprecated.mdx+++ /dev/null@@ -1,238 +0,0 @@-----title: Tool Router Quick Start-image: "https://og.composio.dev/api/og?title=Tool%20Router%20Quick%20Start" # image for socials-keywords: ''-subtitle: 'Learn how to use tool router to route tool calls to the correct tool.'-hide-nav-links: false------<Launch>-Tool Router is now out of beta and available with powerful new capabilities!--[Check out the updated documentation →](/tool-router/overview)-</Launch>--Tool Router automatically discovers, authenticates, and executes the right tools for any task. It's an experimental feature that handles the entire workflow—from finding relevant tools across 500+ integrations to managing authentication and parallel execution.--This is what powers complex agentic products like [Rube](https://rube.app).--## Quick start--<Steps toc={true}>- <Step title="Install SDKs">- Install the Composio SDK and OpenAI Agents SDK:-- <CodeGroup>-- ```bash Python- pip install composio_openai_agents openai-agents- ```-- ```bash TypeScript- pnpm install @composio/core @composio/openai-agents @openai/agents- ```-- </CodeGroup>-- Get your Composio API key from [settings](https://platform.composio.dev/?next_page=/settings) and set it as an environment variable:-- ```bash- export COMPOSIO_API_KEY="your-api-key"- ```- </Step>-- <Step title="Create Tool Router session">- Initialize Composio and create a session for your user:-- <Tip icon="info">- **Authentication is handled automatically**-- Tool Router provides auth URLs when needed. For production, consider [pre-configuring authentication](/docs/authenticating-tools).- </Tip>-- <CodeGroup>-- <SnippetCode- src="fern/snippets/tool-router/python/quickstart.py"- startLine={1}- endLine={16}- title="Python"- />-- <SnippetCode- src="fern/snippets/tool-router/typescript/quickstart.ts"- startLine={1}- endLine={18}- title="TypeScript"- />-- </CodeGroup>-- This generates a secure MCP endpoint URL that your AI agent will use to access Tool Router.-- <Tip icon="info">- **What are sessions?**-- Sessions are designed for security. Each presigned URL contains user authentication credentials and should never be stored long-term or exposed to the client. Generate a new URL for each conversation.- </Tip>- </Step>-- <Step title="Set up your agent">- Configure an OpenAI agent with the Tool Router MCP endpoint:-- <CodeGroup>-- <SnippetCode- src="fern/snippets/tool-router/python/quickstart.py"- startLine={17}- endLine={33}- title="Python"- />-- <SnippetCode- src="fern/snippets/tool-router/typescript/quickstart.ts"- startLine={20}- endLine={30}- title="TypeScript"- />-- </CodeGroup>- </Step>-- <Step title="Run your agent">- Execute the agent with a task:-- <CodeGroup>-- <SnippetCode- src="fern/snippets/tool-router/python/quickstart.py"- startLine={34}- endLine={42}- title="Python"- />-- <SnippetCode- src="fern/snippets/tool-router/typescript/quickstart.ts"- startLine={32}- endLine={41}- title="TypeScript"- />-- </CodeGroup>- </Step>-</Steps>---## How Tool Router works--The Tool Router executes a three-phase workflow:--**1. Discovery**-Searches across all available tools to find ones matching your task. Returns relevant toolkits with their descriptions, schemas, and connection status.--**2. Authentication**-Checks if the user has an active connection to the required toolkit. If not, creates an auth config and returns a connection URL using [Auth Link](/docs/authenticating-tools#hosted-authentication-connect-link). The user completes authentication through this link.--**3. Execution**-Loads authenticated tools into context and executes them. Supports parallel execution across multiple tools for efficiency.--These phases are orchestrated through a set of meta tools, which handle search, planning, connection management, execution, and remote workbench.--<Warning>-**Experimental Feature**--Tool Router is under active development. The meta tools, their schemas, parameters, and behaviors are subject to change as we iterate and improve the functionality. We recommend not using these tools individually.-</Warning>--## Works with any MCP client--The session URL you created is a standard MCP endpoint. Use it with any framework that supports MCP:--<Info>-Tool Router uses Streamable HTTP transport for MCP communication. Make sure your MCP client supports HTTP transport (most do).-</Info>--<CardGroup cols={2}>- <Card- title="Vercel AI SDK"- icon={<img src="../../../assets/images/vercel-logo.svg" width="24" height="24" />}- href="https://ai-sdk.dev/cookbook/next/mcp-tools#mcp-tools"- >- Use experimental_createMCPClient with StreamableHTTPClientTransport to integrate with Next.js apps- </Card>- <Card- title="Claude"- icon={<img src="../../../assets/images/anthropic-logo.svg" width="24" height="24" />}- href="https://docs.claude.com/en/docs/agents-and-tools/remote-mcp-servers"- >- Connect remote MCP servers through Anthropic's MCP connector API- </Card>- <Card- title="LangChain"- icon={<img src="../../../assets/images/langgraph-logo.svg" width="24" height="24" />}- href="https://docs.langchain.com/oss/python/langchain/mcp"- >- Load Tool Router tools using langchain_mcp_adapters for Python workflows- </Card>-</CardGroup>--<Note>-The necessary scaffolding will be integrated into existing provider abstractions before Tool Router is generally available.-</Note>--## Customization--### Restricting toolkits--Control which toolkits are available by specifying them during session creation. This limits which apps your users can access.--<CodeGroup>-```python-session = composio.experimental.tool_router.create_session(- user_id="[email protected]",- toolkits=["github", "slack", "gmail"]-)-```--```typescript-const session = await composio.experimental.toolRouter.createSession(- "[email protected]",- {- toolkits: ["github", "slack", "gmail"]- }-);-```-</CodeGroup>---### Manual connection management--For advanced use cases, you can manually manage connections:--<CodeGroup>-```python-session = composio.experimental.tool_router.create_session(- user_id="[email protected]",- toolkits=[{"toolkit": "gmail", "auth_config_id": "ac_nnn"}],- manually_manage_connections=True-)-```--```typescript-const session = await composio.experimental.toolRouter.createSession(- "[email protected]",- {- toolkits: [{ toolkit: 'gmail', authConfigId: 'ac_nnn' }],- manuallyManageConnections: true- }-);-```-</CodeGroup>--When you pass the auth config ID, you can use regular Composio functions to connect accounts and check authentication status.--## Feedback--This is still very experimental and work in progress, and you can expect the contracts to change and improve as we iterate on this. That said, we would love to hear your feedback on this.--Give us feedback on this GitHub discussion [here](https://github.com/ComposioHQ/composio/discussions/2011).\ No newline at end of filediff --git a/fern/pages/src/tool-router/quickstart.mdx b/fern/pages/src/tool-router/quickstart.mdxdeleted file mode 100644index ec0722c26..000000000--- a/fern/pages/src/tool-router/quickstart.mdx+++ /dev/null@@ -1,210 +0,0 @@-----title: Quickstart-image: "https://og.composio.dev/api/og?title=Tool%20Router%20Quickstart"-description: "Build an AI agent with access to 1000+ tools"-keywords: "tool router quickstart, quickstart"-hide-nav-links: false------Choose how you want to integrate Tool Router:--<AccordionGroup>-<Accordion title="Using Tool Router MCP">--<Tabs>-<Tab title="Claude Agent SDK">--<Steps>-<Step title="Install">-<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio claude-agent-sdk-```-```bash title="TypeScript" for="typescript"-npm install dotenv @composio/core @anthropic-ai/claude-agent-sdk-```-</CodeGroup>-</Step>--<Step title="Create session and run agent">-[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).-- `userId` is your user's unique identifier. See [User Management](/docs/user-management) for details.-</Info>--When the agent needs authentication, it will prompt the user with a link to connect their account. If you want to customise the authentication flow and have more control over the user experience, see [Manual Authentication](/tool-router/manually-authenticating-users).--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/quickstart-mcp-claude.py" title="Python" for="python" />-<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-mcp-claude.ts" title="TypeScript" for="typescript" />-</CodeGroup>-</Step>-</Steps>--</Tab>--<Tab title="OpenAI Agents SDK">--<Steps>-<Step title="Install">-<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio openai-agents-```-```bash title="TypeScript" for="typescript"-npm install dotenv @composio/core @openai/agents zod@3-```-</CodeGroup>-</Step>--<Step title="Create session and run agent">-[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).-- `userId` is your user's unique identifier. See [User Management](/docs/user-management) for details.-</Info>--When the agent needs authentication, it will prompt the user with a link to connect their account. If you want to customise the authentication flow and have more control over the user experience, see [Manual Authentication](/tool-router/manually-authenticating-users).--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/quickstart-mcp-openai.py" title="Python" for="python" />-<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts" title="TypeScript" for="typescript" />-</CodeGroup>--</Step>-</Steps>--</Tab>--<Tab title="Vercel AI SDK">--<Steps>-<Step title="Install Composio SDK">-```bash-npm install dotenv @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp-```-</Step>--<Step title="Create session and run agent">-[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).-- `userId` is your user's unique identifier. See [User Management](/docs/user-management) for details.-</Info>--When the agent needs authentication, it will prompt the user with a link to connect their account. If you want to customise the authentication flow and have more control over the user experience, see [Manual Authentication](/tool-router/manually-authenticating-users).--<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-mcp-vercel.ts" />-</Step>-</Steps>--</Tab>-</Tabs>--### What just happened?--When you run this agent, Tool Router:-1. **Creates an MCP server** with your session configuration-2. **Searches** for the right tools based on your request-3. **Handles authentication** if needed-4. **Executes tools** and uses a workbench for processing large responses--</Accordion>--<Accordion title="Using Tool router as a native tool">--<Tabs>-<Tab title="OpenAI">--<Steps>-<Step title="Install">-<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio composio-openai-agents openai-agents-```-```bash title="TypeScript" for="typescript"-npm install @composio/core @composio/openai-agents @openai/agents-```-</CodeGroup>-</Step>--<Step title="Create session and use as native tool">-Tool Router can be added as a single native tool to your agent. This provides a meta-tool that handles search, authentication, and execution across all 1000+ Composio tools.--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).-- `userId` is your user's unique identifier. See [User Management](/docs/user-management) for details.-</Info>--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/quickstart-native-openai.py" title="Python" for="python" />-<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-native-openai.ts" title="TypeScript" for="typescript" />-</CodeGroup>-</Step>-</Steps>--</Tab>--<Tab title="Vercel AI SDK">--<Steps>-<Step title="Install">-```bash title="TypeScript"-npm install @composio/core @composio/vercel ai @ai-sdk/anthropic-```-</Step>--<Step title="Create session and use as native tool">-Tool Router can be added as a single native tool to your agent. This provides a meta-tool that handles search, authentication, and execution across all 1000+ Composio tools.--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://console.anthropic.com/settings/keys).-- `userId` is your user's unique identifier. See [User Management](/docs/user-management) for details.-</Info>--<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-native-vercel.ts" title="TypeScript" />-</Step>-</Steps>--</Tab>-</Tabs>--### What just happened?--When you run this agent, Tool Router:-1. **Provides a single tool** to your agent framework-2. **Interprets requests** and **searches** for the right tools internally-3. **Handles authentication** if needed-4. **Executes tools** and uses a workbench for processing large responses--</Accordion>-</AccordionGroup>--## Next steps--<CardGroup cols={2}>- <Card title="Session management" href="/tool-router/users-and-sessions">- Learn about users, sessions, and how they work.- </Card>- <Card title="Tools and toolkits" href="/tool-router/tools-and-toolkits">- Learn about tools, toolkits, and how to configure them.- </Card>- <Card title="Manual authentication" href="/tool-router/manually-authenticating-users">- Customise the authentication flow for your users.- </Card>- <Card title="Using MCP" href="/tool-router/using-with-mcp-clients">- Connect Tool Router to any MCP-compatible client.- </Card>- <Card title="Using as a native tool" href="/tool-router/using-as-a-native-tool">- Use Tool Router as a native tool with any AI framework.- </Card>-</CardGroup>diff --git a/fern/pages/src/tool-router/tools-and-toolkits.mdx b/fern/pages/src/tool-router/tools-and-toolkits.mdxdeleted file mode 100644index 924e0f396..000000000--- a/fern/pages/src/tool-router/tools-and-toolkits.mdx+++ /dev/null@@ -1,73 +0,0 @@-----title: Tools and toolkits-image: "https://og.composio.dev/api/og?title=Tools%20and%20Toolkits"-description: "Access 800+ integrations through Tool Router"-keywords: "tool router, tools, toolkits, integrations, composio"------Tool Router gives your agent access to most Composio toolkits by default. For details on configuring which toolkits are available in a session, see [Users and sessions](/tool-router/users-and-sessions#enabling-toolkits).--## Toolkits and tools--A **toolkit** is a collection of related tools for a service and a **tool** is an individual action your agent can execute.--| Toolkit | Tools |-|---------|-------|-| `github` | `GITHUB_CREATE_A_COMMIT`, `GITHUB_ACTIVITY_LIST_STARGAZERS_FOR_REPO`, `GITHUB_SEARCH_REPO_S`, ... |-| `gmail` | `GMAIL_SEND_EMAIL`, `GMAIL_FETCH_EMAILS`, `GMAIL_CREATE_EMAIL_DRAFT`, ... |-| `linear` | `LINEAR_CREATE_LINEAR_ISSUE`, `LINEAR_UPDATE_ISSUE`, `LINEAR_CREATE_LINEAR_LABEL`, ... |--## Available toolkits--Browse all available toolkits in the [Composio platform](https://platform.composio.dev) under "All Toolkits". Each toolkit page shows its tools (with input and output parameters) and authentication methods supported for that toolkit.--You can also list toolkits programmatically:--<CodeGroup>-```python Python-# Returns top 20 toolkits by default-toolkits = composio.toolkits.get()--for toolkit in toolkits:- print(toolkit.name)-```--```typescript TypeScript-// Returns top 20 toolkits by default-const toolkits = await composio.toolkits.get();--for (const toolkit of toolkits) {- console.log(toolkit.name);-}-```-</CodeGroup>--For details on browsing tools within toolkits and inspecting schemas, see [Fetching tools and schemas](/docs/fetching-tools).--<Note>-Some toolkits require you to provide your own credentials. See [Using custom auth configs](/tool-router/using-custom-auth-configs).-</Note>--<Tip>-Need a toolkit that doesn't exist? [Request it here](https://request.composio.dev/boards/tool-requests).-</Tip>---## Default session behavior--When you create a session, all toolkits are available:--<CodeGroup>-```python-session = composio.create(user_id="user_123")-```-```typescript-const session = await composio.create("user_123");-```-</CodeGroup>--Your agent can search and use tools from any toolkit. To restrict or configure which toolkits are available, see [Users and sessions](/tool-router/users-and-sessions#enabling-toolkits).--<Tip>-Triggers can be used alongside Tool Router to respond to events in connected apps. See [Using triggers](/docs/tools-and-triggers/using-triggers) for setup instructions.-</Tip>diff --git a/fern/pages/src/tool-router/users-and-sessions.mdx b/fern/pages/src/tool-router/users-and-sessions.mdxdeleted file mode 100644index 8675fb0cb..000000000--- a/fern/pages/src/tool-router/users-and-sessions.mdx+++ /dev/null@@ -1,230 +0,0 @@-----title: Users and sessions-image: "https://og.composio.dev/api/og?title=Users%20and%20Sessions"-description: "Understand how Tool Router scopes tools and connections per user"-keywords: "sessions, users, tool router, configuration"-hide-nav-links: false------A **user ID** is an identifier from your system (database ID, UUID, or any unique string) that scopes connected accounts and tool access to a specific user. User IDs can represent individuals, teams, or organizations. See [User Management](/docs/user-management) for patterns.--A **session** is an ephemeral configuration that combines:-- Which user's connected accounts to use-- Which toolkits are available-- Which auth configs to use--Tool Router's meta-tools are the same for everyone. The session determines the context they operate within.--## Creating a session--<CodeGroup>-```python Python-session = composio.create(user_id="user_123")-```--```typescript TypeScript-const session = await composio.create("user_123");-```-</CodeGroup>--### Enabling toolkits--Restrict the session to specific toolkits:--<CodeGroup>-```python Python-# Using array format-session = composio.create(- user_id="user_123",- toolkits=["github", "gmail", "slack"]-)--# Using object format with enable key-session = composio.create(- user_id="user_123",- toolkits={"enable": ["github", "gmail", "slack"]}-)-```--```typescript TypeScript-// Using array format-const session = await composio.create("user_123", {- toolkits: ["github", "gmail", "slack"],-});--// Using object format with enable key-const session = await composio.create("user_123", {- toolkits: { enable: ["github", "gmail", "slack"] },-});-```-</CodeGroup>--### Disabling toolkits--Keep all toolkits enabled except specific ones:--<CodeGroup>-```python Python-session = composio.create(- user_id="user_123",- toolkits={"disable": ["exa", "firecrawl"]}-)-```--```typescript TypeScript-const session = await composio.create("user_123", {- toolkits: { disable: ["exa", "firecrawl"] },-});-```-</CodeGroup>--### Custom auth configs--Use your own OAuth credentials instead of Composio's defaults:--<CodeGroup>-```python Python-session = composio.create(- user_id="user_123",- auth_configs={- "github": "ac_your_github_config",- "slack": "ac_your_slack_config"- }-)-```--```typescript TypeScript-const session = await composio.create("user_123", {- authConfigs: {- github: "ac_your_github_config",- slack: "ac_your_slack_config",- },-});-```-</CodeGroup>--See [White-labeling authentication](/tool-router/white-labeling-authentication) for branding, or [Using custom auth configs](/tool-router/using-custom-auth-configs) for toolkits that require your own credentials.--## Connected accounts--Connected accounts are stored in Composio and persist across sessions. When a user connects their GitHub account in one session, it remains available in future sessions. Sessions configure *which* connections to use, but don't own the connections themselves.--### Account selection--If a user has multiple connected accounts for the same toolkit, you can specify which one to use:--<CodeGroup>-```python Python-session = composio.create(- user_id="user_123",- connected_accounts={- "gmail": "ca_work_gmail",- "github": "ca_personal_github"- }-)-```--```typescript TypeScript-const session = await composio.create("user_123", {- connectedAccounts: {- gmail: "ca_work_gmail",- github: "ca_personal_github",- },-});-```-</CodeGroup>--### Precedence--When executing a tool, Tool Router selects the connected account in this order:--1. `connectedAccounts` override if provided in session config-2. `authConfigs` override - finds or creates connection on that config-3. Auth config previously created by Tool Router for this toolkit-4. Creates new auth config using Composio managed auth (tagged as Tool Router created)-5. Error if no Composio managed auth scheme exists for the toolkit--If a user has multiple connected accounts for a toolkit, the most recently connected one is used.--## Session methods--### mcp--Get the MCP server URL to use with any MCP-compatible client.--<CodeGroup>-```python Python-mcp_url = session.mcp.url-```--```typescript TypeScript-const { mcp } = session;-console.log(mcp.url);-```-</CodeGroup>--For framework examples, see [Using with MCP clients](/tool-router/using-with-mcp-clients) or [Using as a native tool](/tool-router/using-as-a-native-tool).--### tools()--Get native tools from the session for use with AI frameworks.--<CodeGroup>-```python Python-tools = session.tools()-```--```typescript TypeScript-const tools = await session.tools();-```-</CodeGroup>--### authorize()--Manually authenticate a user to a toolkit outside of the chat flow.--<CodeGroup>-```python Python-connection_request = session.authorize("github")--print(connection_request.redirect_url)--connected_account = connection_request.wait_for_connection()-```--```typescript TypeScript-const connectionRequest = await session.authorize("github", {- callbackUrl: "https://myapp.com/callback",-});--console.log(connectionRequest.redirectUrl);--const connectedAccount = await connectionRequest.waitForConnection();-```-</CodeGroup>--For more details, see [Manually authenticating users](/tool-router/manually-authenticating-users).--### toolkits()--List available toolkits and their connection status. You can use this to build a UI showing which apps are connected.--<CodeGroup>-```python Python-toolkits = session.toolkits()--for toolkit in toolkits.items:- status = toolkit.connection.connected_account.id if toolkit.connection.is_active else "Not connected"- print(f"{toolkit.name}: {status}")-```--```typescript TypeScript-const toolkits = await session.toolkits();--toolkits.items.forEach((toolkit) => {- console.log(`${toolkit.name}: ${toolkit.connection.connectedAccount?.id ?? "Not connected"}`);-});-```-</CodeGroup>--Returns the first 20 toolkits by default.diff --git a/fern/pages/src/tool-router/using-as-a-native-tool.mdx b/fern/pages/src/tool-router/using-as-a-native-tool.mdxdeleted file mode 100644index 3334cf5a0..000000000--- a/fern/pages/src/tool-router/using-as-a-native-tool.mdx+++ /dev/null@@ -1,77 +0,0 @@-----title: Using as a native tool-image: "https://og.composio.dev/api/og?title=Using%20as%20a%20Native%20Tool"-description: "Use Tool Router as a native tool with any AI framework"-keywords: "native tool, tool router, meta-tool"------Tool Router can be used as a single native tool with any AI framework. The tool handles search, authentication, and execution internally.--## Examples for popular frameworks--Jump to examples for:-- [OpenAI](#openai) - Python, TypeScript-- [Vercel AI SDK](#vercel-ai-sdk) - TypeScript--## OpenAI--### Installation--<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio composio-openai-agents openai-agents-```-```bash title="TypeScript" for="typescript"-npm install @composio/core @composio/openai-agents @openai/agents-```-</CodeGroup>--### Usage--Create a Tool Router session and use it as a native tool with OpenAI Agents SDK:--<Info>-- Set your `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set your `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).-</Info>--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/native-tools-openai.py" title="Python" />-<SnippetCode src="fern/snippets/tool-router/typescript/native-tools-openai.ts" title="TypeScript" />-</CodeGroup>--## Vercel AI SDK--### Installation--```bash-npm install @composio/core @composio/vercel ai @ai-sdk/anthropic-```--### Usage--Create a Tool Router session and use it as a native tool with Vercel AI SDK:--<Info>-- Set your `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set your `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://console.anthropic.com/settings/keys).-</Info>--<SnippetCode src="fern/snippets/tool-router/typescript/native-tools-vercel.ts" />--## Next steps--<CardGroup cols={2}>- <Card title="Quickstart" href="/tool-router/quickstart">- See both MCP and native tool in action- </Card>- <Card title="Using with MCP" href="/tool-router/using-with-mcp-clients">- Use Tool Router with MCP-compatible clients- </Card>- <Card title="Authentication" href="/tool-router/authentication">- Learn about authentication options- </Card>- <Card title="Session management" href="/tool-router/users-and-sessions">- Configure sessions for your users- </Card>-</CardGroup>\ No newline at end of filediff --git a/fern/pages/src/tool-router/using-custom-auth-configs.mdx b/fern/pages/src/tool-router/using-custom-auth-configs.mdxdeleted file mode 100644index 0109f683c..000000000--- a/fern/pages/src/tool-router/using-custom-auth-configs.mdx+++ /dev/null@@ -1,53 +0,0 @@-----title: Using custom auth configs-image: "https://og.composio.dev/api/og?title=Using%20Custom%20Auth%20Configs"-description: "Set up auth configs for toolkits without Composio managed authentication"-keywords: "tool router, auth config, custom credentials, oauth"------Some toolkits don't have Composio managed authentication and require you to provide your own credentials. When Tool Router tries to use these toolkits, it will throw an error asking you to create an auth config.--<Steps>-<Step title="Check if a toolkit needs custom credentials">-In the [Composio platform](https://platform.composio.dev), go to "All Toolkits" and select the toolkit. If it shows no Composio managed auth schemes, you'll need to create an auth config.-</Step>--<Step title="Create an auth config">-1. Go to **Authentication management** in the [dashboard](https://app.composio.dev)-2. Click **Create Auth Config**-3. Select the toolkit-4. Choose the auth scheme (OAuth2, API Key, etc.)-5. Enter your credentials (client ID, client secret, API key, etc.)-6. Click **Create**--Copy the auth config ID (e.g., `ac_1234abcd`).--<Tip>-For detailed instructions on getting credentials for specific toolkits, see [Custom auth configs](/docs/authentication/custom-auth-configs).-</Tip>-</Step>--<Step title="Use in Tool Router">-Pass your auth config ID when creating a session:--<CodeGroup>-```python-session = composio.create(- user_id="user_123",- auth_configs={- "posthog": "ac_your_posthog_config"- }-)-```-```typescript-const session = await composio.create("user_123", {- authConfigs: {- posthog: "ac_your_posthog_config",- },-});-```-</CodeGroup>--Tool Router will now use your auth config when users connect to this toolkit.-</Step>-</Steps>diff --git a/fern/pages/src/tool-router/using-in-chat-authentication.mdx b/fern/pages/src/tool-router/using-in-chat-authentication.mdxdeleted file mode 100644index 3a26ca83b..000000000--- a/fern/pages/src/tool-router/using-in-chat-authentication.mdx+++ /dev/null@@ -1,72 +0,0 @@-----title: Using In-chat authentication-image: "https://og.composio.dev/api/og?title=Using%20In-chat%20Authentication"-description: "Let your agent prompt users to connect accounts during conversation"-keywords: "tool router, authentication, in-chat, MANAGE_CONNECTIONS"------In-chat authentication lets your agent prompt users to connect accounts during chat. When a tool requires authentication, the agent returns a Connect Link URL. The user authenticates, confirms in chat, and the agent retries.--## How it works--1. Agent searches for tools via the `COMPOSIO_SEARCH_TOOLS` meta-tool-2. The `COMPOSIO_MANAGE_CONNECTIONS` meta-tool checks connection status, returns Connect Link URL if needed-3. User authenticates, confirms in chat, agent continues--## Configuration--By just creating a session with default configs, you are enabling in-chat auth. The `manage_connections` parameter defaults to `True`, which includes the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool automatically:--<CodeGroup>-```python-session = composio.create(user_id="user_123")-```-```typescript-const session = await composio.create("user_123");-```-</CodeGroup>--### Custom callback URL--Redirect users back to your chat page after they complete authentication:--<CodeGroup>-```python-session = composio.create(- user_id="user_123",- manage_connections={- "callback_url": "https://yourapp.com/chat"- },-)-```-```typescript-const session = await composio.create("user_123", {- manageConnections: {- callbackUri: "https://yourapp.com/chat",- },-});-```-</CodeGroup>--## Examples--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/quickstart-native-openai.py" title="Python" />-<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-native-openai.ts" title="TypeScript" />-</CodeGroup>--What this looks like when you run the code:--```-Assistant: What would you like me to do today? Type 'exit' to end the conversation.--> Star the composio repo on GitHub-Assistant: I need you to connect your GitHub account first.-Please click here to authorize: https://connect.composio.dev/link/ln_abc123--> Done--Assistant: Done! I've starred ComposioHQ/composio.-```--To manage authentication outside of chat, see [Manually authenticating users](/tool-router/manually-authenticating-users).diff --git a/fern/pages/src/tool-router/using-with-mcp-clients.mdx b/fern/pages/src/tool-router/using-with-mcp-clients.mdxdeleted file mode 100644index ff32fc287..000000000--- a/fern/pages/src/tool-router/using-with-mcp-clients.mdx+++ /dev/null@@ -1,88 +0,0 @@-----title: Using with MCP clients-image: "https://og.composio.dev/api/og?title=Using%20with%20MCP%20Clients"-description: "Use Tool Router as an MCP server with any MCP client"-keywords: "tool router, mcp, model context protocol, claude agent sdk, vercel ai"------Every Tool Router session provides a unique MCP server URL. This URL exposes the exact session you created - with the specific user, toolkits, and auth configs you configured. Any MCP client that supports HTTP transport can connect using just the URL and your API key.--## Examples for popular frameworks--Jump to examples for:-- [Claude Agent SDK](#claude-agent-sdk) - Python, TypeScript-- [OpenAI Agents SDK](#openai-agents-sdk) - Python, TypeScript-- [Vercel AI SDK](#vercel-ai-sdk) - TypeScript--## Claude Agent SDK--### Installation--<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio claude-agent-sdk-```-```bash title="TypeScript" for="typescript"-npm install dotenv @composio/core @anthropic-ai/claude-agent-sdk-```-</CodeGroup>--### Usage--Create a Tool Router session and execute tasks with Claude:--<Info>-- Set your `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set your `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).-</Info>--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/mcp-claude.py" title="Python" for="python" />-<SnippetCode src="fern/snippets/tool-router/typescript/mcp-claude.ts" title="TypeScript" for="typescript" />-</CodeGroup>--## OpenAI Agents SDK--### Installation--<CodeGroup>-```bash title="Python" for="python"-pip install python-dotenv composio openai-agents-```-```bash title="TypeScript" for="typescript"-npm install dotenv @composio/core @openai/agents zod@3-```-</CodeGroup>--### Usage--Create a Tool Router session and execute tasks with OpenAI agents:--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).-</Info>--<CodeGroup>-<SnippetCode src="fern/snippets/tool-router/python/mcp-openai.py" title="Python" for="python" />-<SnippetCode src="fern/snippets/tool-router/typescript/mcp-openai.ts" title="TypeScript" for="typescript" />-</CodeGroup>--## Vercel AI SDK--### Installation--```bash-npm install dotenv @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp-```--### Usage--Use Tool Router with Vercel AI SDK's `generateText` for single completions:--<Info>-- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).-- Set `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).-</Info>--<SnippetCode src="fern/snippets/tool-router/typescript/mcp-vercel.ts" />\ No newline at end of filediff --git a/fern/pages/src/tool-router/white-labeling-authentication.mdx b/fern/pages/src/tool-router/white-labeling-authentication.mdxdeleted file mode 100644index 92dfe386c..000000000--- a/fern/pages/src/tool-router/white-labeling-authentication.mdx+++ /dev/null@@ -1,145 +0,0 @@-----title: White-labeling authentication-image: "https://og.composio.dev/api/og?title=White-labeling%20Authentication"-description: "Use your own OAuth apps and branded auth screens"-keywords: "tool router, white-label, oauth, custom auth, branding"------White-labeling lets you use your own OAuth apps instead of Composio's. Users will see your app name on consent screens instead of "Composio".--By default, OAuth screens show Composio's branding:--<Frame>- <img src="../../../assets/images/oauth-composio-branding.png" />-</Frame>--With white-labeling, they'll see your app name and logo.--<Steps>-<Step title="Create an OAuth app">-Create a developer app in the toolkit's developer portal. You'll need the client ID and client secret. Set the callback URL to:--```-https://backend.composio.dev/api/v3/toolkits/auth/callback-```--<Tip>-For step-by-step guides on creating OAuth apps for some toolkits, see [composio.dev/auth](https://composio.dev/auth).-</Tip>-</Step>--<Step title="Create auth config">-Create an auth config in the [Composio dashboard](https://app.composio.dev):--1. Go to **Authentication management** → **Create Auth Config**-2. Select the toolkit (e.g., GitHub)-3. Choose **OAuth2** scheme-4. Enter your **Client ID** and **Client Secret**-5. Select the scopes you need-6. Click **Create**--Copy the auth config ID (e.g., `ac_1234abcd`).--<Tip>-For detailed instructions with screenshots, see [Custom auth configs](/docs/authentication/custom-auth-configs).-</Tip>-</Step>--<Step title="Use in Tool Router">-Pass your auth config ID in the session:--<CodeGroup>-```python-session = composio.create(- user_id="user_123",- auth_configs={- "github": "ac_your_github_config"- },-)-```-```typescript-const session = await composio.create("user_123", {- authConfigs: {- github: "ac_your_github_config",- },-});-```-</CodeGroup>--When users connect GitHub, they'll see your OAuth app's name and logo on the consent screen.-</Step>-</Steps>--## Mixing custom and Composio-managed auth--You can white-label some toolkits while using Composio's managed credentials for others:--<CodeGroup>-```python-session = composio.create(- user_id="user_123",- auth_configs={- "github": "ac_your_github_config",- "slack": "ac_your_slack_config",- # gmail, linear, etc. use Composio managed auth- },-)-```-```typescript-const session = await composio.create("user_123", {- authConfigs: {- github: "ac_your_github_config",- slack: "ac_your_slack_config",- // gmail, linear, etc. use Composio managed auth- },-});-```-</CodeGroup>--## Custom redirect domain--When users authenticate, they briefly see `backend.composio.dev` in their browser URL. Composio needs to receive the OAuth callback to capture and store the authentication tokens.--If you need to hide this URL (for enterprise compliance or complete white-labeling), you can proxy the redirect through your own domain:--1. Set your OAuth app's redirect URI to your domain:-```-https://yourdomain.com/api/composio-redirect-```--2. Create an endpoint that forwards the OAuth callback to Composio:--<CodeGroup>-```python-from fastapi import FastAPI, Request-from fastapi.responses import RedirectResponse--app = FastAPI()-[email protected]("/api/composio-redirect")-def composio_redirect(request: Request):- # Forward all OAuth parameters to Composio- composio_url = "https://backend.composio.dev/api/v3/toolkits/auth/callback"- return RedirectResponse(url=f"{composio_url}?{request.url.query}")-```-```typescript-// pages/api/composio-redirect.ts (Next.js)-import type { NextApiRequest, NextApiResponse } from "next";--export default function handler(req: NextApiRequest, res: NextApiResponse) {- // Forward all OAuth parameters to Composio- const composioUrl = "https://backend.composio.dev/api/v3/toolkits/auth/callback";- const params = new URLSearchParams(req.query as Record<string, string>);- res.redirect(302, `${composioUrl}?${params.toString()}`);-}-```-</CodeGroup>--3. Update your auth config in the Composio dashboard to use your custom redirect URI:--<Frame caption="Enter your custom redirect URI in the auth config" background="subtle">- <img src="../../../assets/images/tool-router/auth-config-custom-redirect.png" style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }} />-</Frame>--This makes the OAuth flow go through your domain first, then to Composio for token storage.-diff --git a/fern/pages/src/tools-and-triggers/after-execution-modifiers.mdx b/fern/pages/src/tools-and-triggers/after-execution-modifiers.mdxdeleted file mode 100644index ca930fd27..000000000--- a/fern/pages/src/tools-and-triggers/after-execution-modifiers.mdx+++ /dev/null@@ -1,188 +0,0 @@-----title: After Execution Modifiers-image: "https://og.composio.dev/api/og?title=After%20Execution%20Modifiers" # image for socials-keywords: ''-subtitle: 'Transform tool results after execution'-hide-nav-links: false------After execution modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.--## After Execution Modifiers--These modifiers are called after the tool is executed by the LLM. This allows you to modify the _result_ of the tool before it is returned to the agent.--**Useful for:**--- Modifying or truncating the output of the tool.-- Converting the output to a different format before returning it to the agent.--<Frame>- <img src="../../../assets/images/after-execute.png" alt="After Execution Modifier" />-</Frame>--<Note>- Below we use the `afterExecute` modifier to truncate the output of the `HACKERNEWS_GET_USER`- tool and only return the karma of the user.-</Note>--<Tabs>-<Tab title="With Chat Completions">-Since completion providers don't have a function execution step -- Composio will execute the tool call directly.--Hence, the modifier is configured on the `tools.execute` method.--<CodeGroup>-```python Python maxLines=60 wordWrap-from composio import Composio, after_execute-from composio.types import ToolExecutionResponse--@after_execute(tools=["HACKERNEWS_GET_USER"])-def after_execute_modifier(- tool: str,- toolkit: str,- response: ToolExecutionResponse,-) -> ToolExecutionResponse:- return {- **response,- "data": {- "karma": response["data"]["karma"],- },- }--tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_USER")-# Get response from the LLM-response = openai_client.chat.completions.create(- model="gpt-4o-mini",- tools=tools,- messages=messages,-)-print(response)--# Execute the function calls.-result = composio.provider.handle_tool_calls(- response=response,- user_id="default",- modifiers=[- after_execute_modifier,- ]-)-print(result)-```-```typescript TypeScript maxLines=60 wordWrap-const response = await openai.chat.completions.create({- model: "gpt-4o-mini",- messages,- tools,- tool_choice: "auto",-});--const { tool_calls } = response.choices[0].message;-console.log(tool_calls);--if (tool_calls) {- const {- function: { arguments: toolArgs },- } = tool_calls[0];-- const result = await composio.tools.execute(- "HACKERNEWS_GET_USER",- {- userId,- arguments: JSON.parse(toolArgs),- },- {- afterExecute: ({ toolSlug, toolkitSlug, result }) => {- if (toolSlug === "HACKERNEWS_GET_USER") {- const { data } = result;- const { karma } = data.response_data as { karma: number };- return {- ...result,- data: { karma },- };- }- return result;- },- }- );- console.log(JSON.stringify(result, null, 2));-}--```--</CodeGroup>-</Tab>--<Tab title="With Agentic Frameworks">-Agentic providers have a function execution step.-The modifier is configured on the `tools.get` method which modifies the execution logic within the framework!-<CodeGroup>-```python Python (CrewAI) maxLines=60 wordWrap-from composio import Composio, after_execute-from composio.types import ToolExecutionResponse-from composio_crewai import CrewAIProvider--composio = Composio(provider=CrewAIProvider())--@after_execute(tools=["HACKERNEWS_GET_USER"])-def after_execute_modifier(- tool: str,- toolkit: str,- response: ToolExecutionResponse,-) -> ToolExecutionResponse:- return {- **response,- "data": {- "karma": response["data"]["karma"],- },- }---tools = composio.tools.get(- user_id="default",- slug="HACKERNEWS_GET_USER",- modifiers=[- after_execute_modifier,- ]-)-```-```typescript TypeScript (Vercel) maxLines=60 wordWrap {24-27}-import { Composio } from "@composio/core";-import { VercelProvider } from "@composio/vercel";-import { generateText } from "ai";-import { openai } from "@ai-sdk/openai";-import { v4 as uuidv4 } from "uuid";--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--const userId = uuidv4(); // The user's ID.--const agenticTools = await composio.tools.get(- userId,- {- tools: ["HACKERNEWS_GET_USER"],- },- {- afterExecute: ({ toolSlug, toolkitSlug, result }) => {- if (toolSlug === "HACKERNEWS_GET_USER") {- const {- data: { response_data: { karma } = {} } = {},- } = result;- return {- ...result,- data: { karma },- };- }- return result;- },- }-);--```--</CodeGroup>-</Tab>-</Tabs>diff --git a/fern/pages/src/tools-and-triggers/authenticating-tools.mdx b/fern/pages/src/tools-and-triggers/authenticating-tools.mdxdeleted file mode 100644index 850eda76c..000000000--- a/fern/pages/src/tools-and-triggers/authenticating-tools.mdx+++ /dev/null@@ -1,423 +0,0 @@-----title: Authenticating Tools-image: "https://og.composio.dev/api/og?title=Authenticating%20Tools" # image for socials-keywords: 'auth config, authentication, oauth, api key, user authentication'-subtitle: 'Create auth configs and connect user accounts'-hide-nav-links: false------The first step in authenticating your Users is to create an **Auth Config**. Every toolkit has its own _authentication method_ such as **OAuth**, **API key**, **Basic Auth**, or custom schemes.--An **Auth Config** is a _blueprint_ that defines how authentication works for a toolkit across all your users. It defines:--1. **Authentication method** - _OAuth2_, _Bearer token_, _API key_, or _Basic Auth_-2. **Scopes** - _what actions your tools can perform_-3. **Credentials** - _whether you'll use your own app credentials or Composio's managed auth_--<Frame>- <img src="../../../assets/images/executingtools.png" alt="Composio introduction image" />-</Frame>--## Creating an auth config--### Using the Dashboard--<Steps>- <Step title="**Selecting a toolkit**">- Navigate to <a target="_blank"href="https://platform.composio.dev?next_page=%2Fauth-configs"target="_blank">Auth Configs</a> 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 title="**Selecting the Authentication method**">- Each toolkit supports different authentication methods such as **OAuth**, **API Key**, **Bearer- Token**. Select from the available options for your toolkit.- </Step>- <Step title="**Configure scopes**">- Depending on your authentication method, you may need to configure scopes:- - **OAuth2**: Configure scopes for what data and actions your integration can access.- - **API Key/Bearer Token**: Permissions are typically fixed based on the key's access level.- </Step>- <Step title="**Authentication Management**">- **For OAuth toolkits:**- - **Development/Testing**: Use Composio's managed authentication (no setup required)- - **Production**: Generate your own OAuth credentials from the toolkit's developer portal-- **For custom authentication schemes:**-- You must provide your own credentials regardless of environment.-- <Tip>- Want to remove Composio branding from OAuth screens? See [Custom Auth Configs](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen) for white-labeling options.- </Tip>- </Step>- <Step title="**You are all set!**">- Click "**Create Auth Configuration**" button and you have completed your first step! Now you can- move ahead to authenticating your users by [Connecting an Account](#connecting-an-account).- </Step>-</Steps>--<Note title="Auth configs are reusable">- Auth configs contain your developer credentials and app-level settings (*scopes*, *authentication- method*, etc.). Once created, you can reuse the same auth config for all your users.-</Note>--### When to create multiple auth configs?--You should create multiple auth configs for the same toolkit when you need:--- **Different authentication methods** - One OAuth config and one API key config-- **Different scopes** - Separate configs for read-only vs full access-- **Different OAuth apps** - Using separate client credentials for different environments-- **Different permission levels** - Limiting actions for specific use cases--<CardGroup cols={2}>-<Card title="Programmatic creation" href="/docs/programmatic-auth-configs" icon="fa-light fa-code">- For managing auth configs across multiple projects, you can create them programmatically via the- API-</Card>-<Card title="Production white-labeling" href="/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen" icon="fa-light fa-palette">- Remove Composio branding from OAuth screens for a fully white-labeled authentication experience-</Card>-</CardGroup>--## Connecting an account--With an auth config created, you're ready to authenticate your users!--You can either use [**Connect Link**](#hosted-authentication-connect-link) for a hosted authentication flow, or use [**Direct SDK Integration**](#direct-sdk-integration).--<Note>-User authentication requires a User ID - a unique identifier that groups connected accounts together. Learn more about [User Management](/docs/user-management) to understand how to structure User IDs for your application.-</Note>--**Choose the section below that matches your toolkit's authentication method:**--### Hosted Authentication (Connect Link)--Redirect users to a Composio-hosted URL that handles the entire authentication process—OAuth flows, API key collection, or custom fields like subdomain. You can specify a callback URL to control where users return after authentication.--<Frame caption="Connect Link authentication screen">- <img- src="../../../assets/images/auth-screen-example.png"- alt="Composio authentication screen showing Gmail connection"- style={{ maxWidth: '350px', maxHeight: '400px', width: 'auto', height: 'auto', margin: '0 auto', display: 'block' }}- />-</Frame>--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connect-link.py"- title="Python"- startLine={1}- endLine={22}- highlightStart={11}- highlightEnd={15}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connect-link.ts"- title="TypeScript"- startLine={1}- endLine={19}- highlightStart={11}- highlightEnd={13}-/>-</CodeGroup>--#### Customizing Connect Link--By default, users will see a Composio-branded authentication experience when connecting their accounts. To customize this interface with your application's branding:--1. Navigate to your Project Settings and select [Auth Screen](https://platform.composio.dev?next_page=/settings/auth-screen)-2. Configure your **Logo** and **App Title**--These settings will apply to all authentication flows using Connect Link, providing a white-labeled experience that maintains your brand identity throughout the authentication process.--<Note>-For complete white-labeling including OAuth consent screens (removing Composio's domain), see [Custom Auth Configs - White-labeling](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).-</Note>----### Direct SDK Integration--**Choose the section below that matches your toolkit's authentication method:**--#### OAuth Connections--For OAuth flows, you'll redirect users to complete authorization. You can specify a callback URL to control-where users return after authentication:--<CodeGroup>-```python Python {11-16}-from composio import Composio--composio = Composio(api_key="YOUR_COMPOSIO_API_KEY")--# Use the "AUTH CONFIG ID" from your dashboard-auth_config_id = "your_auth_config_id"--# Use a unique identifier for each user in your application-user_id = "user-1349-129-12"--connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- config={"auth_scheme": "OAUTH2"},- callback_url="https://www.yourapp.com/callback"-)-print(f"Redirect URL: {connection_request.redirect_url}")--connected_account = connection_request.wait_for_connection()--# Alternative: if you only have the connection request ID-# connected_account = composio.connected_accounts.wait_for_connection(-# connection_request.id)-# Recommended when the connection_request object is no longer available--print(f"Connection established: {connected_account.id}")--````--```typescript {10-16}-import { Composio } from '@composio/core';--const composio = new Composio({apiKey: "YOUR_COMPOSIO_API_KEY"});--// Use the "AUTH CONFIG ID" from your dashboard-const authConfigId = 'your_auth_config_id';-// Use a unique identifier for each user in your application-const userId = 'user_4567';--const connRequest = await composio.connectedAccounts.initiate(- userId,- authConfigId,- {- callbackUrl: 'https://www.yourapp.com/callback',- }-);-console.log(`Redirect URL: ${connRequest.redirectUrl}`);--const connectedAccount = await connRequest.waitForConnection();--// Alternative: if you only have the connection request ID-// const connectedAccount = await composio.connectedAccounts-// .waitForConnection(connRequest.id);-// Recommended when the connRequest object is no longer available--console.log(`Connection established: ${connectedAccount.id}`);-````--</CodeGroup>--#### Services with Additional Parameters--Some services like Zendesk require additional parameters such as `subdomain`:--<CodeGroup>-```python-# For Zendesk - include subdomain-connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- config=auth_scheme.oauth2(subdomain="mycompany") # For mycompany.zendesk.com-)-```--```typescript-import { AuthScheme } from '@composio/core';-// For Zendesk - include subdomain-const connRequest = await composio.connectedAccounts.initiate(userId, authConfigId, {- config: AuthScheme.OAuth2({- subdomain: 'mycompany',- }),-});-```--</CodeGroup>--#### API Key Connections--For API key authentication, you can either _collect API keys from each user_ or _use your own API key_ for all users. Popular Toolkits that use API Keys include Stripe, Perplexity etc.--Here is how to initiate the flow:--<CodeGroup>-```python {16-22}-from composio import Composio--composio = Composio(api_key="your_api_key")--# Use the "AUTH CONFIG ID" from your dashboard-auth_config_id = "your_auth_config_id"--# Use a unique identifier for each user in your application-user_id = "user_12323"--# API key provided by the user (collected from your app's UI)-# or use your own key-user_api_key = "user_api_key_here"--connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- config={- "auth_scheme": "API_KEY", "val": {"api_key": user_api_key}- }-)--print(f"Connection established: {connection_request.id}")--````--```typescript {12-16}-import { Composio, AuthScheme } from '@composio/core';--const composio = new Composio({ apiKey: 'your_api_key' });--// Use the "AUTH CONFIG ID" from your dashboard-const authConfigId = 'your_auth_config_id';-// Use a unique identifier for each user in your application-const userId = 'user12345678';-// API key provided by the user (collected from your app's UI)-const userApiKey = 'user_api_key_here';--const connectionRequest = await composio.connectedAccounts.initiate(userId, authConfigId, {- config: AuthScheme.APIKey({- api_key: userApiKey,- }),-});--console.log(`Connection established: ${connectionRequest.id}`);-````--</CodeGroup>--## Fetching the required `config` parameters for an Auth Config--When working with any toolkits, you can **inspect an auth config** to understand its _authentication requirements_ and _expected parameters_.--Here is how you would fetch the authentication method and input fields:--<CodeGroup>-```python {9}-from composio import Composio--composio = Composio(api_key="your_api_key")--# Use the "AUTH CONFIG ID" from your dashboard-auth_config_id = "your_auth_config_id"--# Fetch the auth configuration details-auth_config = composio.auth_configs.get(auth_config_id)--# Check what authentication method this config uses-print(f"Authentication method: {auth_config.auth_scheme}")--# See what input fields are required-print(f"Required fields: {auth_config.expected_input_fields}")--````--```typescript {9}-import { Composio } from '@composio/core';--const composio = new Composio({ apiKey: 'your_api_key' });--// Use the "AUTH CONFIG ID" from your dashboard-const authConfigId = 'your_auth_config_id';--// Fetch the auth configuration details-const authConfig = await composio.authConfigs.get(authConfigId);--console.log(`Authentication method: ${authConfig.authScheme}`);-console.log(`Required fields:`, authConfig.expectedInputFields);-````--</CodeGroup>--## Other Authentication Methods--Composio also supports a wide range of other auth schemas:--**Bearer Token** - Similar to API keys, provide the user's bearer token directly when creating the connection.--**Basic Auth** - Provide username and password credentials for services that use HTTP Basic Authentication.--**Custom Schemes** - Some toolkits use their own custom authentication methods. Follow the toolkit-specific requirements for such cases.--<Note title="Fetching auth config">- For any of these methods, [fetch the config- parameter](#fetching-the-required-config-parameters-for-an-auth-config) to determine the exact- fields required. Every toolkit has its own requirements, and understanding these is essential for- successfully creating connections.-</Note>--Learn how to [Manage connected accounts](/docs/connected-accounts) after users authenticate.--## Connection Statuses--After creating a connection, it will have one of the following statuses that indicates its current state:--| Status | Description |-|--------|-------------|-| **ACTIVE** | Connection is established and working. You can execute tools with this connection. |-| **INACTIVE** | Connection is temporarily disabled. Re-enable it to use the connection again. |-| **PENDING** | Connection is being processed. Wait for it to become active. |-| **INITIATED** | Connection request has started but not yet completed. User may still need to complete authentication. |-| **EXPIRED** | Connection credentials have expired. Composio automatically attempts to refresh credentials before marking as expired. Re-authenticate to restore access. |-| **FAILED** | Connection attempt failed. Check error details and try creating a new connection. |--<Note>-When credentials expire for OAuth connections, Composio automatically attempts to refresh them using the refresh token. The connection is only marked as **EXPIRED** after multiple refresh attempts have failed.-</Note>--### Waiting for Connection Establishment--The `waitForConnection` method allows you to poll for a connection to become active after initiating authentication. This is useful when you need to ensure a connection is ready before proceeding.--<CodeGroup>-<SnippetCode- src="fern/snippets/authentication/python/connect-link.py"- title="Python"- startLine={20}- endLine={29}-/>--<SnippetCode- src="fern/snippets/authentication/typescript/connect-link.ts"- title="TypeScript"- startLine={17}- endLine={26}-/>-</CodeGroup>--The method continuously polls the Composio API until the connection:-- Becomes **ACTIVE** (returns the connected account)-- Enters a terminal state like **FAILED** or **EXPIRED** (throws an error)-- Exceeds the specified timeout (throws a timeout error)--### Checking Connection Status--You can check the status of a connected account programmatically:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/checking-connection-status.py"- title="Python"- startLine={5}- endLine={16}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/checking-connection-status.ts"- title="Typescript"- startLine={5}- endLine={17}-/>-</CodeGroup>--<Note>-Only connections with **ACTIVE** status can be used to execute tools. If a connection is in any other state, you'll need to take appropriate action (re-authenticate, wait for processing, etc.) before using it.-</Note>--## Next Step--With authentication set up, you can now fetch and execute tools. See [Executing Tools](/docs/executing-tools) to get started.diff --git a/fern/pages/src/tools-and-triggers/before-execution-modifiers.mdx b/fern/pages/src/tools-and-triggers/before-execution-modifiers.mdxdeleted file mode 100644index c4cd22648..000000000--- a/fern/pages/src/tools-and-triggers/before-execution-modifiers.mdx+++ /dev/null@@ -1,193 +0,0 @@-----title: Before Execution Modifiers-image: "https://og.composio.dev/api/og?title=Before%20Execution%20Modifiers" # image for socials-keywords: ''-subtitle: 'Modify tool arguments before execution'-hide-nav-links: false------Before execution modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.--## Before Execution Modifiers--These modifiers are called before the tool is executed by the LLM. This allows you to modify the _arguments_ called by the LLM before they are executed by Composio.--**Useful for:**--- Injecting an argument into the tool execution.-- Overriding the arguments emitted by the LLM.--<Frame>- <img src="../../../assets/images/before-execute.png" alt="Before Execution Modifier" />-</Frame>--<Note>- Below we use the `beforeExecute` modifier to modify the number of posts returned by the- `HACKERNEWS_GET_LATEST_POSTS` tool.-</Note>--<Tabs>-<Tab title="With Chat Completions">-Since completion providers don't have a function execution step -- Composio will execute the tool call directly.--Hence, the modifier is configured on the `tools.execute` method.--<CodeGroup>-```python Python maxLines=60 wordWrap-from openai import OpenAI-from composio import Composio, before_execute-from composio.types import ToolExecuteParams--composio = Composio()-openai_client = OpenAI()-user_id = "[email protected]"--@before_execute(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def before_execute_modifier(- tool: str,- toolkit: str,- params: ToolExecuteParams,-) -> ToolExecuteParams:- params["arguments"]["size"] = 1- return params---# Get tools-tools = composio.tools.get(user_id=user_id, slug="HACKERNEWS_GET_LATEST_POSTS")--# Get response from the LLM-response = openai_client.chat.completions.create(- model="gpt-4o-mini",- tools=tools,- messages=[{"role": "user", "content": "Fetch latest posts from hackernews"}],-)-print(response)--# Execute the function calls.-result = composio.provider.handle_tool_calls(- response=response,- user_id="default",- modifiers=[- before_execute_modifier,- ],-)-print(result)-```-```typescript TypeScript maxLines=60 wordWrap {11, 20-28}-const response = await openai.chat.completions.create({- model: "gpt-4o-mini",- messages,- tools,- tool_choice: "auto",-});--const { tool_calls } = response.choices[0].message;-console.log(tool_calls);--if (tool_calls) {- const {- function: { arguments: toolArgs },- } = tool_calls[0];-- const result = await composio.tools.execute(- "HACKERNEWS_GET_LATEST_POSTS",- {- userId,- arguments: JSON.parse(toolArgs),- },- {- beforeExecute: ({ toolSlug, toolkitSlug, params }) => {- if (toolSlug === "HACKERNEWS_GET_LATEST_POSTS") {- params.arguments.size = 1;- }- console.log(params);- return params;- },- }- );- console.log(JSON.stringify(result, null, 2));-}--```--</CodeGroup>-</Tab>--<Tab title="With Agentic Frameworks">-Agentic providers have a function execution step.-The modifier is configured on the `tools.get` method which modifies the execution logic within the framework!--<CodeGroup>-```python Python (CrewAI) maxLines=60 wordWrap-from composio import Composio, before_execute-from composio.types import ToolExecuteParams-from composio_crewai import CrewAIProvider--composio = Composio(provider=CrewAIProvider())--@before_execute(tools=["LINEAR_CREATE_LINEAR_ISSUE"])-def modify_linear_project_id(- tool: str,- toolkit: str,- params: ToolExecuteParams,-) -> ToolExecuteParams:- params["arguments"]["project_id"] = "1234567890"- return params--tools = composio.tools.get(- user_id="default",- tools=[- "HACKERNEWS_GET_LATEST_POSTS",- "HACKERNEWS_GET_USER",- "LINEAR_CREATE_LINEAR_ISSUE",- ],- modifiers=[- modify_linear_project_id,- ]-)-```-```typescript TypeScript (Mastra) maxLines=60 wordWrap {22-26}-import { Composio } from "@composio/core";-import { MastraProvider } from "@composio/mastra";-import { Agent } from "@mastra/core/agent";--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new MastraProvider(),-});--const userId = "[email protected]"; // The user's ID.--const agenticTools = await composio.tools.get(- userId,- {- tools: [- "HACKERNEWS_GET_LATEST_POSTS",- "HACKERNEWS_GET_USER",- "LINEAR_CREATE_LINEAR_ISSUE",- ],- },- {- beforeExecute: ({toolSlug, toolkitSlug, params}) => {- if (toolSlug === "LINEAR_CREATE_LINEAR_ISSUE") {- params.arguments.project_id = "1234567890";- }- return params;- },- }-);--const { text } = await generateText({- model: openai("gpt-4o-mini"),- messages: [- { role: "user", content: "Create an issue to `sid` to add RLS" },- ],- tools: agenticTools,- maxSteps: 5,-});--```--</CodeGroup>-</Tab>-</Tabs>diff --git a/fern/pages/src/tools-and-triggers/custom-tools.mdx b/fern/pages/src/tools-and-triggers/custom-tools.mdxdeleted file mode 100644index 8b16a4eb2..000000000--- a/fern/pages/src/tools-and-triggers/custom-tools.mdx+++ /dev/null@@ -1,330 +0,0 @@-----title: Creating custom tools-image: "https://og.composio.dev/api/og?title=Creating%20custom%20tools" # image for socials-keywords: ''-subtitle: "Learn how to extend Composio's toolkits with your own tools"-hide-nav-links: false------Custom tools allow you to create your own tools that can be used with Composio.--1. Standalone tools - Simple tools that don't require any authentication-2. Toolkit-based tools - Tools that require authentication and can use toolkit credentials--## Creating a Custom Tool--### Standalone Tool--A standalone tool is the simplest form of custom tool. It only requires input parameters and an execute function:--<CodeGroup>-```python Python maxLines=60 wordWrap-from pydantic import BaseModel, Field--from composio import Composio-from composio.types import ExecuteRequestFn--composio = Composio()---class AddTwoNumbersInput(BaseModel):- a: int = Field(- ...,- description="The first number to add",- )- b: int = Field(- ...,- description="The second number to add",- )--# function name will be used as slug[email protected]_tool-def add_two_numbers(request: AddTwoNumbersInput) -> int:- """Add two numbers."""- return request.a + request.b-```-```typescript TypeScript maxLines=60 wordWrap-const tool = await composio.tools.createCustomTool({- slug: 'CALCULATE_SQUARE',- name: 'Calculate Square',- description: 'Calculates the square of a number',- inputParams: z.object({- number: z.number().describe('The number to calculate the square of'),- }),- execute: async input => {- const { number } = input;- return {- data: { result: number * number },- error: null,- successful: true,- };- },-});-```-</CodeGroup>--### Toolkit-based Tool--A toolkit-based tool has access to two ways of making authenticated requests:--1. Using `executeToolRequest` - The recommended way to make authenticated requests to the toolkit's API endpoints. Composio automatically handles credential injection and baseURL resolution:--<CodeGroup>-```python Python maxLines=60 wordWrap-class GetIssueInfoInput(BaseModel):- issue_number: int = Field(- ...,- description="The number of the issue to get information about",- )--# function name will be used as slug[email protected]_tool(toolkit="github")-def get_issue_info(- request: GetIssueInfoInput,- execute_request: ExecuteRequestFn,- auth_credentials: dict,-) -> dict:- """Get information about a GitHub issue."""- response = execute_request(- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",- method="GET",- parameters=[- {- "name": "Accept",- "value": "application/vnd.github.v3+json",- "type": "header",- },- {- "name": "Authorization",- "value": f"Bearer {auth_credentials['access_token']}",- "type": "header",- },- ],- )- return {"data": response.data}-```-```typescript TypeScript maxLines=60 wordWrap-const tool = await composio.tools.createCustomTool({- slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',- name: 'Github star composio repositories',- toolkitSlug: 'github',- description: 'Star any specified repo of `composiohq` user',- inputParams: z.object({- repository: z.string().describe('The repository to star'),- page: z.number().optional().describe('Pagination page number'),- customHeader: z.string().optional().describe('Custom header'),- }),- execute: async (input, connectionConfig, executeToolRequest) => {- // This method makes authenticated requests to the relevant API- // You can use relative paths!- // Composio will automatically inject the baseURL- const result = await executeToolRequest({- endpoint: `/user/starred/composiohq/${input.repository}`,- method: 'PUT',- body: {},- // Add custom headers or query parameters- parameters: [- // Add query parameters- {- name: 'page',- value: input.page?.toString() || '1',- in: 'query',- },- // Add custom headers- {- name: 'x-custom-header',- value: input.customHeader || 'default-value',- in: 'header',- },- ],- });- return result;- },-});-```--</CodeGroup>--2. Using `connectionConfig` - For making direct API calls when needed:--<CodeGroup>-```python Python maxLines=60 wordWrap-import requests-[email protected]_tool(toolkit="github")-def get_issue_info_direct(- request: GetIssueInfoInput,- execute_request: ExecuteRequestFn,- auth_credentials: dict,-) -> dict:- """Get information about a GitHub issue."""- response = requests.get(- f"https://api.github.com/repos/composiohq/composio/issues/{request.issue_number}",- headers={- "Accept": "application/vnd.github.v3+json",- "Authorization": f"Bearer {auth_credentials['access_token']}",- },- )- return {"data": response.json()}-```-```typescript TypeScript maxLines=60 wordWrap-const tool = await composio.tools.createCustomTool({- slug: 'GITHUB_DIRECT_API',- name: 'Direct GitHub API Call',- description: 'Makes direct calls to GitHub API',- toolkitSlug: 'github',- inputParams: z.object({- repo: z.string().describe('Repository name'),- }),- execute: async (input, connectionConfig, executeToolRequest) => {- // Use connectionConfig for direct API calls- const result = await fetch(`https://api.github.com/repos/${input.repo}`, {- headers: {- Authorization: `Bearer ${connectionConfig.access_token}`,- },- });-- return {- data: await result.json(),- error: null,- successful: true,- };--},-});--```-</CodeGroup>--### Using Custom Headers and Query Parameters--You can add custom headers and query parameters to your toolkit-based tools using the `parameters` option in `executeToolRequest`:--<CodeGroup>-```python Python maxLines=60 wordWrap[email protected]_tool(toolkit="github")-def get_issue_info(- request: GetIssueInfoInput,- execute_request: ExecuteRequestFn,- auth_credentials: dict,-) -> dict:- """Get information about a GitHub issue."""- response = execute_request(- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",- method="GET",- parameters=[- {- "name": "Accept",- "value": "application/vnd.github.v3+json",- "type": "header",- },- {- "name": "Authorization",- "value": f"Bearer {auth_credentials['access_token']}",- "type": "header",- },- {- "name": 'X-Custom-Header',- "value": 'custom-value',- "type": 'header',- },- ],- )- return {"data": response.data}-```-```typescript TypeScript maxLines=60-const tool = await composio.tools.createCustomTool({- slug: 'GITHUB_SEARCH_REPOSITORIES',- name: 'Search GitHub Repositories',- description: 'Search for repositories with custom parameters',- toolkitSlug: 'github',- inputParams: z.object({- query: z.string().describe('Search query'),- perPage: z.number().optional().describe('Results per page'),- acceptType: z.string().optional().describe('Custom accept header'),- }),- execute: async (input, connectionConfig, executeToolRequest) => {- const result = await executeToolRequest({- endpoint: '/search/repositories',- method: 'GET',- parameters: [- // Add query parameters for pagination- {- name: 'q',- value: input.query,- in: 'query',- },- {- name: 'per_page',- value: (input.perPage || 30).toString(),- in: 'query',- },- // Add custom headers- {- name: 'Accept',- value: input.acceptType || 'application/vnd.github.v3+json',- in: 'header',- },- {- name: 'X-Custom-Header',- value: 'custom-value',- in: 'header',- },- ],- });- return result;- },-});-```-</CodeGroup>--## Executing Custom Tools--You can execute custom tools just like any other tool:--<CodeGroup>-```python Python maxLines=60 wordWrap-response = composio.tools.execute(- user_id="default",- slug="TOOL_SLUG", # For the tool above you can use `get_issue_info.slug`- arguments={"issue_number": 1},-)-```-```typescript TypeScript maxLines=60 wordWrap-const result = await composio.tools.execute('TOOL_SLUG', {- arguments: {- // Tool input parameters- },- userId: 'user-id',- connectedAccountId: 'optional-account-id', // Required for toolkit-based tools-});-```-</CodeGroup>--## Best Practices--1. Use descriptive names and slugs for your tools-2. Always provide descriptions for input parameters using `describe()`-3. Handle errors gracefully in your execute function-4. For toolkit-based tools:- - Prefer `executeToolRequest` over direct API calls when possible- - Use relative paths with `executeToolRequest` - Composio will automatically inject the correct baseURL- - Use the `parameters` option to add custom headers or query parameters:- ```typescript- parameters: [- { name: 'page', value: '1', in: 'query' }, // Adds ?page=1 to URL- { name: 'x-custom', value: 'value', in: 'header' }, // Adds header- ];- ```- - Remember that `executeToolRequest` can only call tools from the same toolkit- - Use `executeToolRequest` to leverage Composio's automatic credential handling- - Only use `connectionConfig` when you need to make direct API calls or interact with different services-5. Chain multiple toolkit operations using `executeToolRequest` for better maintainability--## Limitations--1. Custom tools are stored in memory and are not persisted-2. They need to be recreated when the application restarts-3. Toolkit-based tools require a valid connected account with the specified toolkit-4. `executeToolRequest` can only execute tools from the same toolkit that the custom tool belongs to-5. Each toolkit-based tool can only use one connected account at a timediff --git a/fern/pages/src/tools-and-triggers/executing-tools.mdx b/fern/pages/src/tools-and-triggers/executing-tools.mdxdeleted file mode 100644index 11d03a371..000000000--- a/fern/pages/src/tools-and-triggers/executing-tools.mdx+++ /dev/null@@ -1,174 +0,0 @@-----title: Executing Tools-image: "https://og.composio.dev/api/og?title=Executing%20Tools" # image for socials-keywords: ''-subtitle: "Learn how to execute Composio's tools with different providers and frameworks"-hide-nav-links: false------LLMs on their own can only do generation. Tool calling changes that by letting them interact with external services. Instead of just drafting an email, the model can call `GMAIL_SEND_EMAIL` to actually send it. The tool's results feed back to the LLM, closing the loop so it can decide, _act,_ observe, and adapt.--In Composio, every **tool** is a single API action—fully described with schema, parameters, and return type. Tools live inside **toolkits** like _Gmail, Slack, or GitHub_, and Composio handles authentication and user scoping.--<Tip icon="fa-light fa-info">- **User Scoping**: All tools are scoped to a specific user - that's why every example includes a- `user_id`. Learn how to structure User IDs in [User Management](./user-management). Each user must authenticate with their respective services (Gmail, Calendar, etc.) - see [Authentication](./authenticating-tools)-</Tip>--## Using Chat Completions--Use the Composio SDK with providers like OpenAI, Anthropic, and Google AI. To learn how to set-up these providers, see [Providers](/providers/openai).--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/exec-tool-completions.py"- title="Python (OpenAI)"- highlightStart={32}- highlightEnd={33}- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/exec-tool-completions.ts"- title="TypeScript (Anthropic)"- highlightStart={37}- highlightEnd={38}- />-</CodeGroup>--## Using Agentic Frameworks--Agentic frameworks automatically handle the tool execution loop.-Composio provides support for frameworks like this by making sure the tools are formatted into the correct objects for the agentic framework to execute.--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/exec-tool-agentic.py"- title="Python (OpenAI Agents SDK)"- highlightStart={19}- highlightEnd={23}- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/exec-tool-agentic.ts"- title="TypeScript (Vercel AI SDK)"- highlightStart={22}- highlightEnd={31}- />-</CodeGroup>--## Direct Tool execution--In case you just want to call a tool without using any framework or LLM provider, you can use the `execute` method directly.--<Tip icon="fa-light fa-lightbulb">- **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-- **CLI**: For python and typescript projects, run `composio generate` to generate types. [Learn more →](/docs/cli#generate-type-definitions)-</Tip>--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/direct-tool-call.py"- title="Python"- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/direct-tool-call.ts"- title="TypeScript"- />-</CodeGroup>--<Note>-The examples above configure toolkit versions at SDK initialization. You can also pass versions per-execution or use environment variables. See [toolkit versioning](/docs/toolkit-versioning) for all configuration options.-</Note>--### Proxy Execute -- Manually calling toolkit APIs--You can proxy requests to any supported toolkit API and let Composio inject the **authentication state**. This is useful when you need an API endpoint that isn't available as a predefined tool.--The `endpoint` can be a relative path or absolute URL. Composio uses the `connected_account_id` to determine the toolkit and resolve relative paths against the appropriate base URL.--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/proxy-tool.py"- title="Python"- startLine={5}- highlightStart={9}- highlightEnd={9}- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/proxy-tool.ts"- title="TypeScript"- startLine={5}- highlightStart={9}- highlightEnd={9}-/>--</CodeGroup>--<Tip icon="fa-light fa-info">- Need an API that isn't supported by any Composio toolkit, or want to extend an existing one? Learn- how to [create custom tools](/docs/custom-tools).-</Tip>--## Automatic File Handling--Composio handles file operations automatically. Pass file paths to tools that need them, and get local file paths back from tools that return files.--### File Upload--Pass local file paths, URLs, or File objects to tools that accept files:--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/file-upload.py"- title="Python"- startLine={7}- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/file-upload.ts"- title="TypeScript"- startLine={8}- />-</CodeGroup>--### File Download--When tools return files, Composio downloads them to the local directory and provides file path in the response:-When tools return files, Composio downloads them to the local directory and provides the file path in the response:--<CodeGroup>- <SnippetCode- src="fern/snippets/tool-calling/python/file-download.py"- title="Python"- startLine={4}- />- <SnippetCode- src="fern/snippets/tool-calling/typescript/file-download.ts"- title="TypeScript"- startLine={4}- />--</CodeGroup>--### Disabling Auto File Handling--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`:--<CodeGroup>-```typescript TypeScript maxLines=60 wordWrap-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- autoUploadDownloadFiles: false-});--// Now you need to handle files manually using composio.files API-const fileData = await composio.files.upload({-filePath: path.join(\_\_dirname, 'document.pdf'),-toolSlug: 'GOOGLEDRIVE_UPLOAD_FILE',-toolkitSlug: 'googledrive'-});--```-</CodeGroup>--```diff --git a/fern/pages/src/tools-and-triggers/fetching-tools.mdx b/fern/pages/src/tools-and-triggers/fetching-tools.mdxdeleted file mode 100644index f57b11cc9..000000000--- a/fern/pages/src/tools-and-triggers/fetching-tools.mdx+++ /dev/null@@ -1,137 +0,0 @@-----title: Fetching tools and schemas-image: "https://og.composio.dev/api/og?title=Fetching%20tools%20and%20schemas" # image for socials-keywords: "fetch tool, filter tool, tool schema, tool types, inspect schema, raw tools"-subtitle: "Fetch and filter tools, and inspect schemas"-hide-nav-links: false------Fetch specific tools, filter by permissions or search, and inspect schemas for type information. Tools are automatically formatted for your provider.--## Basic usage--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={6}- endLine={9}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={6}- endLine={8}-/>-</CodeGroup>--Returns top 20 tools by default. Tools require a `user_id` because they're scoped to authenticated accounts. See [User management](./user-management) and [Authentication](./authenticating-tools).--## Tool schemas--Inspect tool parameters and types without a user_id:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={66}- endLine={66}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={60}- endLine={60}-/>-</CodeGroup>--Generate type-safe code for direct SDK execution with [`composio generate`](/docs/cli#generate-type-definitions). This creates TypeScript or Python types from tool schemas.--<Tip>-View tool parameters and schemas visually in the [Composio platform](https://platform.composio.dev). Navigate to any toolkit and select a tool to see its input/output parameters.-</Tip>--## Filtering tools--### By toolkit--Get tools from specific apps. Returns top 20 tools by default.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={12}- endLine={23}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={11}- endLine={21}-/>-</CodeGroup>---### By name--Fetch specific tools when you know their names.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={25}- endLine={34}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={23}- endLine={31}-/>-</CodeGroup>---### By scopes--Filter OAuth tools by permission level. Only works with a single toolkit.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={36}- endLine={41}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={33}- endLine={37}-/>-</CodeGroup>--### By search (experimental)--Find tools semantically.--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/fetching-tools.py"- title="Python"- startLine={43}- endLine={65}-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/fetching-tools.ts"- title="TypeScript"- startLine={39}- endLine={59}-/>-</CodeGroup>--<Tip>-Use specific toolkit versions in production to prevent breaking changes. See [toolkit versioning](./toolkit-versioning).-</Tip>\ No newline at end of filediff --git a/fern/pages/src/tools-and-triggers/schema-modifiers.mdx b/fern/pages/src/tools-and-triggers/schema-modifiers.mdxdeleted file mode 100644index 45a8531b1..000000000--- a/fern/pages/src/tools-and-triggers/schema-modifiers.mdx+++ /dev/null@@ -1,223 +0,0 @@-----title: Schema Modifiers-image: "https://og.composio.dev/api/og?title=Schema%20Modifiers" # image for socials-keywords: ''-subtitle: 'Customize how tools appear to agents'-hide-nav-links: false------Schema modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.--## Schema Modifiers--Schema modifiers transform a tool's schema before the tool is seen by an agent.--<Frame>- <img src="../../../assets/images/schema-modifier.png" alt="Schema Modifier" />-</Frame>-**Useful for:**-- Modifying or rewriting the tool description to better fit your use case.-- Adding arguments to the tool. For example, adding a `thought` argument to the tool to prompt the agent to explain the reasoning.-- Hiding arguments from the tool. In cases where the argument is irrelevant to the tool.-- Adding extra arguments to the tool schema for custom use cases or execution.-- Adding default values to tool arguments.--<Note>- Below we modify the schema of the `HACKERNEWS_GET_LATEST_POSTS` to make the `size` argument- required and remove the `page` argument.-</Note>--<CodeGroup>-```python Python maxLines=60 wordWrap-from composio import Composio, schema_modifier-from composio.types import Tool--user_id = "[email protected]"--@schema_modifier(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def modify_schema(- tool: str,- toolkit: str,- schema: Tool,-) -> Tool:- _ = schema.input_parameters["properties"].pop("page", None)- schema.input_parameters["required"] = ["size"]- return schema--tools = composio.tools.get(- user_id=user_id,- tools=["HACKERNEWS_GET_LATEST_POSTS", "HACKERNEWS_GET_USER"],- modifiers=[- modify_schema,- ]-)-```-```typescript TypeScript maxLines=60 wordWrap-const userId = "[email protected]";--const tools = await composio.tools.get(- userId,- {- tools: ["HACKERNEWS_GET_LATEST_POSTS", "HACKERNEWS_GET_USER"],- },- {- modifySchema: ({ toolSlug, toolkitSlug, schema }) => {- if (toolSlug === "HACKERNEWS_GET_LATEST_POSTS") {- const { inputParameters } = schema;- if (inputParameters?.properties) {- delete inputParameters.properties["page"];- }- inputParameters.required = ["size"];- }- return schema;- },- }-);--console.log(JSON.stringify(tools, null, 2));--```--</CodeGroup>--In using the above modified tool schema, the `page` argument is removed and the `size` argument is required.--You can test this out by viewing the tool call response in the LLM too!--<Accordion title="Schema modified tool call">-<CodeGroup>--```python Python maxLines=60 wordWrap--from openai import OpenAI-from composio import Composio, schema_modifier-from composio.types import Tool-from composio_openai import OpenAIProvider---@schema_modifier(tools=["HACKERNEWS_GET_LATEST_POSTS"])-def modify_schema(- tool: str,- toolkit: str,- schema: Tool,-) -> Tool:- _ = schema.input_parameters["properties"].pop("page", None)- schema.input_parameters["required"] = ["size"]- return schema--# Initialize tools.-openai_client = OpenAI()-composio = Composio(provider=OpenAIProvider())--# Define task.-task = "Get the latest posts from Hacker News"--# Get GitHub tools that are pre-configured-tools = composio.tools.get(- user_id="default",- tools=['HACKERNEWS_GET_LATEST_POSTS', 'HACKERNEWS_GET_USER'],- modifiers=[- modify_schema,- ],-)--# Get response from the LLM-response = openai_client.chat.completions.create(- model="gpt-4o-mini",- tools=tools,- messages=[- {"role": "system", "content": "You are a helpful assistant."},- {"role": "user", "content": task},- ],-)-print(response)--# Execute the function calls.-result = composio.provider.handle_tool_calls(response=response, user_id="default")-print(result)-```--```typescript TypeScript maxLines=60 wordWrap-import { Composio } from '@composio/core';-import { OpenAI } from 'openai';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,-});-const openai = new OpenAI();--const userId = '[email protected]';--const tools = await composio.tools.get(- userId,- {- tools: ['HACKERNEWS_GET_LATEST_POSTS', 'HACKERNEWS_GET_USER'],- },- {- modifySchema: ({ toolSlug, toolkitSlug, schema }) => {- if (toolSlug === 'HACKERNEWS_GET_LATEST_POSTS') {- const { inputParameters } = schema;- if (inputParameters?.properties) {- delete inputParameters.properties['page'];- }- inputParameters.required = ['size'];- }- return schema;- },- }-);--console.log(JSON.stringify(tools, null, 2));--const response = await openai.chat.completions.create({- model: 'gpt-4o-mini',- messages: [- {- role: 'system',- content: 'You are a helpful assistant that can help with tasks.',- },- { role: 'user', content: 'Get the latest posts from Hacker News' },- ],- tools: tools,- tool_choice: 'auto',-});--console.log(response.choices[0].message.tool_calls);-```--</CodeGroup>-</Accordion>---## Example: Modifying the tool description--Sometimes you need to provide additional context to help the agent understand how to use a tool correctly. This example demonstrates modifying the description of the `GITHUB_LIST_REPOSITORY_ISSUES` tool to specify a default repository when none is provided.--<Note>-This approach is particularly useful when you want to guide the agent's behavior without changing the tool's underlying functionality.-</Note>--In this example:-- We append additional instructions to the tool's description-- The modified description tells the agent to use `composiohq/composio` as the default repository-- This helps prevent errors when the agent forgets to specify a repository parameter--<CodeGroup>-<SnippetCode- src="fern/snippets/modifiers/python/description.py"- title="Python"- startLine={1}- endLine={27}- highlightStart={13}- highlightEnd={20}-/>-<SnippetCode- src="fern/snippets/modifiers/typescript/description.ts"- title="TypeScript"- startLine={1}- endLine={31}- highlightStart={13}- highlightEnd={18}-/>--</CodeGroup>diff --git a/fern/pages/src/tools-and-triggers/toolkit-versioning.mdx b/fern/pages/src/tools-and-triggers/toolkit-versioning.mdxdeleted file mode 100644index 6fce7f3c6..000000000--- a/fern/pages/src/tools-and-triggers/toolkit-versioning.mdx+++ /dev/null@@ -1,97 +0,0 @@-----title: Toolkit versioning-image: "https://og.composio.dev/api/og?title=Toolkit%20versioning"-keywords: "toolkit versioning, tool version, version pinning, stable tools"-subtitle: "Pin specific tool versions for consistent behavior in production"-hide-nav-links: false------Toolkit versioning ensures your tools behave consistently across deployments. You can pin specific versions in production, test new releases in development, and roll back when needed.--<Note>-Starting from Python SDK v0.9.0 and TypeScript SDK v0.2.0, specifying versions is required for manual tool execution.-</Note>--## Configuration methods--Configure toolkit versions using one of three methods:--### SDK initialization--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/versioning-sdk-init.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"- title="TypeScript"-/>-</CodeGroup>--### Environment variables--```bash-# Set versions for specific toolkits-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"-export COMPOSIO_TOOLKIT_VERSION_SLACK="20251027_00"-export COMPOSIO_TOOLKIT_VERSION_GMAIL="20251027_00"-```--### Per-execution override--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/versioning-per-execution.py"- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"- title="TypeScript"-/>-</CodeGroup>--## Version format--Versions follow the format `YYYYMMDD_NN`:-- `YYYYMMDD`: Release date-- `NN`: Sequential release number--```python-# Production-toolkit_versions = {"github": "20251027_00"}--# Development-toolkit_versions = {"github": "latest"}-```--<Warning>-Never use `latest` in production. It can introduce breaking changes.-</Warning>--## Version resolution order--1. Per-execution version (highest priority)-2. SDK initialization version-3. Environment variable (toolkit-specific)--## Managing versions--Check available versions using:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/python/versioning-manage.py"- startLine={5}- endLine={11}- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/typescript/versioning-manage.ts"- startLine={5}- endLine={12}- title="TypeScript"-/>-</CodeGroup>--diff --git a/fern/pages/src/tools-and-triggers/using-triggers.mdx b/fern/pages/src/tools-and-triggers/using-triggers.mdxdeleted file mode 100644index 7f0136ad0..000000000--- a/fern/pages/src/tools-and-triggers/using-triggers.mdx+++ /dev/null@@ -1,262 +0,0 @@-----title: Using Triggers-subtitle: Send payloads to your AI agents or systems based on events in apps.-image: "https://og.composio.dev/api/og?title=Using%20Triggers" # image for socials-keywords: 'triggers, webhooks, websockets, events, active triggers, trigger types, verify triggers'-hide-nav-links: true------When **events** occur in connected apps (like new Slack messages or GitHub commits), triggers automatically send the event data to your application.--Each event is delivered as a **structured payload** to your webhook endpoint (via webhooks or WebSockets), enabling your applications or AI agents to respond proactively.--<Frame caption="Triggers through Composio" background="subtle">- -</Frame>--<Tip title="Prerequisites">- Before proceeding, ensure you've created an [auth- config](/docs/authenticating-tools#creating-an-auth-config) and [established a- connection](/docs/authenticating-tools#oauth-connections) to an app (e.g., Slack, GitHub).- Triggers are scoped to specific users - learn about [User Management](/docs/user-management) for guidance on structuring User IDs.-</Tip>--## Creating a trigger--You can create triggers using either the Composio dashboard or programmatically via the SDK.--### Using dashboard-To create triggers through the **dashboard**:--- Navigate to the <a href="https://platform.composio.dev?next_page=%2Fauth-configs" target="_blank">Auth Configs</a> page-- Select the auth config-- Click "Add Trigger" and navigate to "Active Triggers" tab to fetch the trigger ID.- <video- src="../../../assets/videos/enabling-triggers.mp4"- width="854"- height="480"- autoplay- loop- playsinline- controls- ></video>--Some triggers require additional configuration. The dashboard will prompt you for any required fields during setup.--<Frame caption="Example: Gmail trigger configuration" background="subtle">- <img- src="../../../assets/images/trigger-config.png"- alt="Trigger configuration example"- style={{ maxHeight: '400px', width: 'auto', display: 'block', margin: '0 auto' }}- />-</Frame>--### Using SDK-Create triggers programmatically by providing the trigger type and any required configuration. The trigger instance will be created using the toolkit version configured during Composio initialization (defaults to `'latest'`).--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/python/triggers.py"- title="Python"- startLine={1}- endLine={18}- highlightStart={12}- highlightEnd={16}-/>--<SnippetCode- src="fern/snippets/triggers/typescript/triggers.ts"- startLine={1}- endLine={22}- highlightStart={12}- highlightEnd={21}- title="TypeScript"-/>-</CodeGroup>--<Note>-To use a specific toolkit version when creating triggers, configure `toolkitVersions` during initialization. See [Toolkit Versioning](/docs/toolkit-versioning) for more details.-</Note>---## Subscribing to triggers--### Webhooks--The recommended way to subscribe to triggers is through webhooks. Configure your webhook URL in the [Event & Trigger settings](https://platform.composio.dev?next_page=/settings/webhook).--Use a publicly accessible URL where Composio can send event payloads. This endpoint should be able to process incoming POST requests containing the trigger data.--<Tip>- **Local development:** Use [ngrok](https://ngrok.com) or [webhook.site](https://webhook.site) to- expose your local server to the internet for testing.-</Tip>--Webhook payloads contain:-- `type`: The trigger type identifier-- `data`: The actual event data-- `timestamp`: When the event occurred-- `log_id`: Unique identifier for this event--Below are examples of webhook handlers for FastAPI and Next.js applications:--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/python/trigger-webhook.py"- title="Python (FastAPI)"- startLine={34}- endLine={47}-/>--<SnippetCode- src="fern/snippets/triggers/typescript/trigger-webhook.ts"- title="TypeScript (Next.js)"- startLine={39}- endLine={57}-/>-</CodeGroup>--### Verifying webhook signatures--Composio signs all webhook requests so you can verify they're authentic. Each webhook includes these headers:--- `webhook-signature`: HMAC signature in format `v1,<base64_signature>`-- `webhook-id`: Unique message identifier-- `webhook-timestamp`: Unix timestamp when the webhook was sent--To enable verification:--1. Obtain your webhook secret from the [Composio dashboard](https://platform.composio.dev?next_page=/settings/webhook) under Project Settings → Webhook.-2. Set it as the `COMPOSIO_WEBHOOK_SECRET` environment variable-3. Use the verification function in your webhook handler:--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/python/trigger-webhook.py"- title="Python"- startLine={10}- endLine={32}-/>--<SnippetCode- src="fern/snippets/triggers/typescript/trigger-webhook.ts"- title="TypeScript"- startLine={12}- endLine={37}-/>-</CodeGroup>--The signature is calculated as:-```-signing_string = "{webhook-id}.{webhook-timestamp}.{raw_body}"-signature = HMAC-SHA256(signing_string, secret)-```--### Prototyping with trigger subscriptions--During development, you can subscribe to triggers directly through the SDK without setting up webhooks.--You can subscribe to **multiple** trigger events by **configuring the filters**. When you specify multiple filters, ALL of them must match for the trigger to be subscribed to.--<CodeGroup>- <SnippetCode src="fern/snippets/triggers/python/trigger-subscription.py" title="Python" />- <SnippetCode src="fern/snippets/triggers/typescript/trigger-subscription.ts" title="Typescript" />-</CodeGroup>--## Trigger payload types--To see what data you'll receive in your webhook handler, inspect the trigger's payload:--<CodeGroup>-```python Python maxLines=60 wordWrap-# Get trigger type to inspect payload structure-trigger = composio.triggers.get_type(slug="GITHUB_COMMIT_EVENT")-print(trigger.payload)-```--```typescript TypeScript maxLines=60 wordWrap-// Get trigger type to inspect payload structure-const triggerType = await composio.triggers.getType('GITHUB_COMMIT_EVENT');--console.log(triggerType.payload);-```--</CodeGroup>--### Type-safe trigger handling (TypeScript)--For better type safety and developer experience in TypeScript, you can define specific payload types and use the `TriggerEvent<T>` interface:--<CodeGroup>-<SnippetCode- src="fern/snippets/triggers/typescript/trigger-types.ts"- title="Type-safe trigger subscription"- startLine={3}- endLine={26}-/>--<SnippetCode- src="fern/snippets/triggers/typescript/trigger-webhook.ts"- title="Type-safe webhook handling"- startLine={3}- endLine={18}-/>-</CodeGroup>--This approach provides:--- **IntelliSense support** for trigger payload fields-- **Compile-time error checking** for typos and invalid field access-- **Better documentation** through TypeScript types-- **Improved maintainability** of trigger handling code--## Managing triggers--### Enable/disable triggers--You can pause triggers temporarily without deleting them.--<Tabs>-<Tab title="Dashboard">-1. Go to the [Auth Config](https://platform.composio.dev?next_page=/auth-configs) page-2. Select your auth config-3. Navigate to "Active Triggers"-4. Disable/Enable the trigger--<Frame caption="Enable/disable triggers" background="subtle">- <img- src="../../../assets/images/trigger-enable-disable.png"- alt="Enable/disable triggers"- width="400px"- height="auto"- />-</Frame>-</Tab>--<Tab title="SDK">-<CodeGroup>-```python Python-# Disable a trigger-composio.triggers.disable(trigger_id="ti_abcd123")--# Re-enable when needed--composio.triggers.enable(trigger_id="ti_abcd123")--````-``` typescript TypeScript-// Disable a trigger-await composio.triggers.disable('ti_abcd123');--// Re-enable when needed-await composio.triggers.enable('ti_abcd123');--````--</CodeGroup>-</Tab>-</Tabs>--## Troubleshooting--View detailed trigger logs and debug issues on the [Composio dashboard](https://platform.composio.dev?next_page=/logs/triggers).\ No newline at end of filediff --git a/fern/pyproject.toml b/fern/pyproject.tomldeleted file mode 100644index 373767b79..000000000--- a/fern/pyproject.toml+++ /dev/null@@ -1,59 +0,0 @@-[project]-name = "fern"-version = "0.1.0"-description = "Documentation generators for Composio"-readme = "README.md"-requires-python = ">=3.12"-dependencies = [- "python-dotenv>=1.1.0",- "inflection>=0.5.1",- "click>=8.1.7",- "ruamel-yaml>=0.18.10",- "typing-extensions>=4.13.0",- "composio-client==1.27.0",- "openai>=1.79.0",- "composio==1.0.0rc5",- # Dependencies for SDK doc generation- "tqdm>=4.62.0",- "pyyaml>=6.0",- "GitPython>=3.1.0",- "packaging>=20.0",- "nbformat>=5.0.0",- "composio-langchain",- "composio-openai",- "composio-gemini",-]--[tool.ruff]-line-length = 100-target-version = "py312"--[tool.black]-line-length = 100-target-version = ["py312"]-----[build-system]-requires = ["hatchling"]-build-backend = "hatchling.build"--[tool.hatch.build.targets.wheel]-packages = ["generators"]--[tool.uv.sources]-composio-openai-agents = { workspace = true }-composio-gemini = { workspace = true }-composio = { workspace = true }--[dependency-groups]-dev = [- "composio==1.0.0rc6",- "composio-gemini",- "composio-langchain",- "composio-openai-agents",- "google-genai>=1.20.0",- "langchain>=0.3.25",- "openai-agents>=0.0.19",-]diff --git a/fern/scripts/add_og_imgs.py b/fern/scripts/add_og_imgs.pydeleted file mode 100644index 062bcff30..000000000--- a/fern/scripts/add_og_imgs.py+++ /dev/null@@ -1,213 +0,0 @@-#!/usr/bin/env python3-"""-Script to update image properties in MDX frontmatter for social media previews.--This script processes all MDX files in the fern/pages directory and adds or updates-the 'image' property in the frontmatter with a URL that generates social media-preview images based on the page title.--Usage:- python scripts/update_mdx_images.py [--dry-run] [--verbose]--Options:- --dry-run Show what would be changed without making actual changes- --verbose Show detailed output for all processed files-"""--import argparse-import os-import re-import sys-from pathlib import Path-from urllib.parse import quote---def extract_title_from_frontmatter(frontmatter):- """Extract the title from frontmatter string."""- # Handle different title formats:- # title: Simple Title- # title: "Quoted Title"- # title: 'Single Quoted Title'- title_patterns = [- r"^title:\s*[\"']([^\"']+)[\"']\s*$", # Quoted titles- r"^title:\s*([^#\n]+?)(?:\s*#.*)?$", # Unquoted titles (with optional comments)- ]-- for pattern in title_patterns:- match = re.search(pattern, frontmatter, re.MULTILINE)- if match:- return match.group(1).strip()-- return None---def has_frontmatter(content):- """Check if content has valid frontmatter."""- return content.startswith("---") and content.count("---") >= 2---def update_mdx_image(file_path, dry_run=False, verbose=False):- """- Update the image property in MDX frontmatter based on the title.-- Args:- file_path: Path to the MDX file- dry_run: If True, don't actually modify files- verbose: If True, show detailed output-- Returns:- dict: Result information with keys 'updated', 'message', 'title'- """- try:- with open(file_path, "r", encoding="utf-8") as f:- content = f.read()- except Exception as e:- return {"updated": False, "message": f"Error reading file: {e}", "title": None}-- # Check if file has frontmatter- if not has_frontmatter(content):- return {"updated": False, "message": "No frontmatter found", "title": None}-- # Split frontmatter and content- parts = content.split("---", 2)- if len(parts) < 3:- return {"updated": False, "message": "Invalid frontmatter format", "title": None}-- frontmatter = parts[1]- body = parts[2]-- # Extract title from frontmatter- title = extract_title_from_frontmatter(frontmatter)- if not title:- return {"updated": False, "message": "No title found in frontmatter", "title": None}-- # Create the image URL- encoded_title = quote(title)- image_url = f'"https://og.composio.dev/api/og?title={encoded_title}"'-- # Check if image property already exists- image_pattern = r"^image:\s*.*$"- image_match = re.search(image_pattern, frontmatter, re.MULTILINE)-- if image_match:- return {- "updated": False,- "message": "Image property already present, skipping",- "title": title,- }- else:- # Add image property after title- title_pattern = r"^title:\s*.*$"- title_match = re.search(title_pattern, frontmatter, re.MULTILINE)-- if not title_match:- return {- "updated": False,- "message": "Could not find title line to insert image after",- "title": title,- }-- title_line = title_match.group(0)- new_image_line = f"image: {image_url} # image for socials"- new_frontmatter = frontmatter.replace(title_line, f"{title_line}\n{new_image_line}")- action = "Added new"-- # Don't write if dry run- if dry_run:- return {"updated": True, "message": f"{action} image property (DRY RUN)", "title": title}-- # Reconstruct the file content- new_content = f"---{new_frontmatter}---{body}"-- # Write back to file- try:- with open(file_path, "w", encoding="utf-8") as f:- f.write(new_content)-- return {"updated": True, "message": f"{action} image property", "title": title}- except Exception as e:- return {"updated": False, "message": f"Error writing file: {e}", "title": title}---def main():- """Process all MDX files in fern/pages directory."""- parser = argparse.ArgumentParser(- description="Update image properties in MDX frontmatter for social media previews"- )- parser.add_argument(- "--dry-run",- action="store_true",- help="Show what would be changed without making actual changes",- )- parser.add_argument(- "--verbose", action="store_true", help="Show detailed output for all processed files"- )-- args = parser.parse_args()-- # Determine the pages directory relative to script location- script_dir = Path(__file__).parent- pages_dir = script_dir.parent / "pages"-- if not pages_dir.exists():- print(f"Error: Pages directory not found at {pages_dir}")- print("Make sure to run this script from the fern directory")- sys.exit(1)-- # Find all MDX files- mdx_files = list(pages_dir.rglob("*.mdx"))-- if not mdx_files:- print("No MDX files found in pages directory")- return-- print(f"Found {len(mdx_files)} MDX files")- if args.dry_run:- print("🔍 DRY RUN MODE - No files will be modified")- print()-- # Process files- updated_count = 0- skipped_count = 0- error_count = 0-- for mdx_file in sorted(mdx_files):- rel_path = mdx_file.relative_to(pages_dir)-- try:- result = update_mdx_image(mdx_file, dry_run=args.dry_run, verbose=args.verbose)-- if result["updated"]:- updated_count += 1- status = "✅" if not args.dry_run else "🔄"- print(f"{status} {rel_path}")- if args.verbose or args.dry_run:- print(f" Title: {result['title']}")- print(f" Action: {result['message']}")- else:- skipped_count += 1- if args.verbose:- print(f"⏭️ {rel_path}")- print(f" Reason: {result['message']}")- if result["title"]:- print(f" Title: {result['title']}")-- except Exception as e:- error_count += 1- print(f"❌ {rel_path}")- print(f" Error: {e}")-- # Summary- print(f"\n📊 Summary:")- print(f" Total files: {len(mdx_files)}")- print(f" Updated: {updated_count}")- print(f" Skipped: {skipped_count}")- if error_count > 0:- print(f" Errors: {error_count}")-- if args.dry_run and updated_count > 0:- print(f"\n💡 Run without --dry-run to apply {updated_count} changes")---if __name__ == "__main__":- main()diff --git a/fern/scripts/build-llms-txt.ts b/fern/scripts/build-llms-txt.tsdeleted file mode 100644index 718cf90c0..000000000--- a/fern/scripts/build-llms-txt.ts+++ /dev/null@@ -1,261 +0,0 @@-#!/usr/bin/env bun-/* eslint-disable no-console */--import fs from 'fs';-import path from 'path';-import yaml from 'yaml';--const FERN_DIR = path.join(import.meta.dir, '..');-const DOCS_YML_PATH = path.join(FERN_DIR, 'docs.yml');-const LLMS_TXT_PATH = path.join(FERN_DIR, 'llms-txt-worker', 'public', 'llms.txt');--interface DocsConfig {- title: string;- navigation: Array<{- tab: string;- layout?: LayoutItem[];- }>;- tabs?: {- [key: string]: {- 'display-name': string;- 'skip-slug'?: boolean;- };- };-}--interface LayoutItem {- section?: string;- contents?: ContentItem[];- page?: string;- path?: string;- slug?: string;-}--interface ContentItem {- page?: string;- path?: string;- slug?: string;- section?: string;- contents?: ContentItem[];-}--interface LlmsEntry {- title: string;- url: string;- description?: string;- parentSection?: string; // for prefixing nested items-}--function extractFrontmatter(mdxPath: string): { title?: string; description?: string } {- try {- const fullPath = path.join(FERN_DIR, mdxPath);- if (!fs.existsSync(fullPath)) {- return {};- }-- const content = fs.readFileSync(fullPath, 'utf8');- const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);-- if (!frontmatterMatch) {- return {};- }-- const frontmatter = frontmatterMatch[1];-- // Extract title from frontmatter- const titleMatch = frontmatter.match(/title:\s*["']?(.+?)["']?\s*$/m);- const title = titleMatch ? titleMatch[1].trim() : undefined;-- // Extract subtitle (used as description in llms.txt)- const descMatch = frontmatter.match(/subtitle:\s*["']?(.+?)["']?\s*$/m);- const description = descMatch ? descMatch[1].trim() : undefined;-- return { title, description };- } catch (error) {- return {};- }-}--function buildUrl(item: ContentItem, tabSlug: string, parentSlug?: string): string {- const BASE_URL = 'https://docs.composio.dev';-- if (item.slug) {- const urlParts = [tabSlug, parentSlug, item.slug].filter(Boolean);- return `${BASE_URL}/${urlParts.join('/')}`;- }-- if (item.path) {- const urlPath = item.path- .replace(/^pages\/(dist|src)\//, '')- .replace(/^pages\//, '')- .replace(/\.(mdx?|md)$/, '');- return `${BASE_URL}/${urlPath}`;- }-- console.warn(`No slug or path for: ${item.page}`);- return BASE_URL;-}--function processItem(- item: ContentItem,- tabSlug: string,- parentSlug?: string,- parentSection?: string-): LlmsEntry | null {- if (!item.page || !item.path) return null;-- const url = buildUrl(item, tabSlug, parentSlug);- const frontmatter = extractFrontmatter(item.path);-- return {- title: frontmatter.title || item.page,- url,- description: frontmatter.description,- parentSection,- };-}--function processContentItems(- items: ContentItem[],- tabSlug: string,- parentSlug?: string,- parentSection?: string-): LlmsEntry[] {- const entries: LlmsEntry[] = [];-- for (const item of items) {- const entry = processItem(item, tabSlug, parentSlug, parentSection);- if (entry) {- entries.push(entry);- }-- if (item.contents) {- const nestedSlug = item.slug- ? (parentSlug ? `${parentSlug}/${item.slug}` : item.slug)- : parentSlug;-- // pass section name to children for prefixing- const nestedEntries = processContentItems(- item.contents,- tabSlug,- nestedSlug,- item.section ?? parentSection- );- entries.push(...nestedEntries);- }- }-- return entries;-}--function getSectionName(tab: string, layoutItem: LayoutItem, tabDisplayName: string): string {- if (tab === 'docs' && layoutItem.section) {- return layoutItem.section;- }- return tabDisplayName;-}--function processNavigation(config: DocsConfig): Array<[string, LlmsEntry[]]> {- const sections = new Map<string, LlmsEntry[]>();-- for (const navItem of config.navigation) {- if (!navItem.layout) continue;-- const tab = navItem.tab;- const tabConfig = config.tabs?.[tab];- const skipSlug = tabConfig?.['skip-slug'] || false;- const tabSlug = skipSlug ? '' : tab;- const tabDisplayName = tabConfig?.['display-name'] || tab;-- for (const layoutItem of navItem.layout) {- const sectionName = getSectionName(tab, layoutItem, tabDisplayName);- const sectionEntries: LlmsEntry[] = [];-- // direct page- if (layoutItem.page && layoutItem.path && layoutItem.slug) {- const entry = processItem(layoutItem as ContentItem, tabSlug);- if (entry) {- sectionEntries.push(entry);- }- }-- // nested contents- if (layoutItem.contents) {- const entries = processContentItems(- layoutItem.contents,- tabSlug,- layoutItem.slug,- undefined // no parent section for top-level- );- sectionEntries.push(...entries);- }-- if (sectionEntries.length > 0) {- const existing = sections.get(sectionName) || [];- sections.set(sectionName, [...existing, ...sectionEntries]);- }- }- }-- return Array.from(sections.entries());-}--function formatEntry(entry: LlmsEntry): string {- const displayTitle = entry.parentSection- ? `${entry.parentSection}: ${entry.title}`- : entry.title;-- const link = `[${displayTitle}](${entry.url})`;- return entry.description- ? `- ${link}: ${entry.description}`- : `- ${link}`;-}--function generateLlmsTxt(sections: Array<[string, LlmsEntry[]]>): string {- let content = '# Composio\n\n';- content += '> Composio is a platform that connects AI agents to 500+ external tools and services through managed authentication, tool execution, and triggers. It simplifies integrating AI agents with SaaS applications, developer tools, and custom APIs.\n\n';- content += 'Composio provides managed OAuth and API key authentication, tool execution across multiple AI frameworks (OpenAI, Anthropic, LangChain, CrewAI, etc.), MCP server support, and webhooks/triggers for real-time agent actions.\n';-- for (const [sectionName, entries] of sections) {- content += `\n## ${sectionName}\n`;-- if (sectionName === 'Toolkits') {- content += '- [Tools JSON](https://docs.composio.dev/robots-only/tools.json): Machine-readable JSON with all 700+ toolkit slugs, descriptions, and tool names\n';- } else {- for (const entry of entries) {- content += formatEntry(entry) + '\n';- }- }- }-- return content;-}--async function main(): Promise<void> {- console.log('Building llms.txt...');-- try {- const docsYmlContent = fs.readFileSync(DOCS_YML_PATH, 'utf8');- const config = yaml.parse(docsYmlContent) as DocsConfig;- const sections = processNavigation(config);-- const totalEntries = sections.reduce((total, [_, entries]) => total + entries.length, 0);- console.log(`Found ${totalEntries} pages across ${sections.length} sections`);-- const llmsTxtContent = generateLlmsTxt(sections);- fs.writeFileSync(LLMS_TXT_PATH, llmsTxtContent);-- console.log(`Generated ${LLMS_TXT_PATH}`);- } catch (error) {- console.error('Error:', error);- process.exit(1);- }-}--// @ts-ignore - bun-specific-if (import.meta.main) {- main().catch(error => {- console.error('Fatal error:', error);- process.exit(1);- });-}\ No newline at end of filediff --git a/fern/scripts/build-snippets.ts b/fern/scripts/build-snippets.tsdeleted file mode 100644index 233935136..000000000--- a/fern/scripts/build-snippets.ts+++ /dev/null@@ -1,586 +0,0 @@-#!/usr/bin/env bun-/* eslint-disable no-console */--import fs, { watch } from 'fs';-import path from 'path';--// Use default directories (no positional args for folder names)-const DOCS_SRC_DIR = path.join(import.meta.dir, '../pages/src');-const PAGES_DIST_DIR = path.join(import.meta.dir, '../pages/dist');-const PROJECT_ROOT = path.join(import.meta.dir, '../..');--// Custom error class for SnippetCode errors-class SnippetCodeError extends Error {- constructor(message: string) {- super(message);- this.name = 'SnippetCodeError';- }-}--// Type for parsed GitHub URL-interface ParsedGitHubUrl {- owner: string;- repo: string;- branch: string;- filePath: string;- startLine?: number;- endLine?: number;-}--interface SnippetCodeProps {- src?: string;- githubUrl?: string;- startLine?: number;- endLine?: number;- highlightStart?: number;- highlightEnd?: number;- title?: string;- language?: string;- wordWrap?: boolean;- relativeHighlightStart?: number;- relativeHighlightEnd?: number;- path?: string;- vars?: Record<string, string>;-}--// Parse GitHub URL and extract components-function parseGitHubUrl(url: string): ParsedGitHubUrl {- try {- // Validate URL format- const githubRegex = /^https:\/\/github\.com\/([^\/]+)\/([^\/]+)\/blob\/([^\/]+)\/(.+?)(?:#L(\d+)(?:-L(\d+))?)?$/;- const match = url.match(githubRegex);-- if (!match) {- throw new SnippetCodeError(- `Invalid GitHub URL format. Expected: https://github.com/owner/repo/blob/branch/path/to/file.ext#L1-L10\nReceived: ${url}`- );- }-- const [, owner, repo, branch, filePath, startLineStr, endLineStr] = match;-- return {- owner,- repo,- branch,- filePath,- startLine: startLineStr ? parseInt(startLineStr, 10) : undefined,- endLine: endLineStr ? parseInt(endLineStr, 10) : startLineStr ? parseInt(startLineStr, 10) : undefined- };- } catch (error) {- if (error instanceof SnippetCodeError) {- throw error;- }- throw new SnippetCodeError(`Failed to parse GitHub URL: ${error.message}`);- }-}--// Cache for GitHub content to avoid repeated fetches-const githubContentCache = new Map<string, { content?: string; error?: string }>();--// Fetch content from GitHub with error handling-async function fetchGitHubContent(parsedUrl: ParsedGitHubUrl): Promise<{ content?: string; error?: string }> {- const cacheKey = `${parsedUrl.owner}/${parsedUrl.repo}/${parsedUrl.branch}/${parsedUrl.filePath}`;-- // Check cache first- if (githubContentCache.has(cacheKey)) {- return githubContentCache.get(cacheKey)!;- }-- try {- const rawUrl = `https://raw.githubusercontent.com/${parsedUrl.owner}/${parsedUrl.repo}/${parsedUrl.branch}/${parsedUrl.filePath}`;-- // Create abort controller for timeout- const controller = new AbortController();- const timeoutId = setTimeout(() => controller.abort(), 10000); // 10 second timeout-- const response = await fetch(rawUrl, { signal: controller.signal });- clearTimeout(timeoutId);-- if (!response.ok) {- let error: string;- if (response.status === 404) {- error = `File not found: ${parsedUrl.filePath} in ${parsedUrl.owner}/${parsedUrl.repo}@${parsedUrl.branch}`;- } else {- error = `GitHub API error: ${response.status} ${response.statusText}`;- }- const result = { error };- githubContentCache.set(cacheKey, result);- return result;- }-- const content = await response.text();- const result = { content };- githubContentCache.set(cacheKey, result);- return result;- } catch (error: any) {- let errorMessage: string;- if (error.name === 'AbortError') {- errorMessage = `Timeout fetching from GitHub: ${parsedUrl.owner}/${parsedUrl.repo}/${parsedUrl.filePath}`;- } else if (error.message.includes('fetch')) {- errorMessage = `Network error fetching from GitHub: ${error.message}`;- } else {- errorMessage = `Error fetching from GitHub: ${error.message}`;- }- const result = { error: errorMessage };- githubContentCache.set(cacheKey, result);- return result;- }-}--// Extract lines from content-function extractLinesFromContent(content: string, startLine?: number, endLine?: number): string {- const lines = content.split('\n');- const start = startLine ? startLine - 1 : 0;- const end = endLine ? endLine : Math.min(lines.length, 100); // Default to first 100 lines-- return lines.slice(start, end).join('\n');-}--function ensureDistDir() {- // Remove existing dist directory to ensure clean build-- // Create fresh dist directory- fs.mkdirSync(PAGES_DIST_DIR, { recursive: true });-}--// Replace template variables in content-function replaceTemplateVariables(content: string, vars: Record<string, string> = {}): string {- // Replace {{variable}} patterns with their values- return content.replace(/\{\{(\w+)(?:\|(\w+)(?::([^}]+))?)?\}\}/g, (match, varName, transform, defaultValue) => {- let value = vars[varName];-- // Use default value if variable not found- if (value === undefined || value === null) {- if (defaultValue !== undefined) {- value = defaultValue.replace(/^["']|["']$/g, ''); // Remove quotes from default value- } else {- return match; // Keep original placeholder if no value and no default- }- }-- // Apply transformations- if (transform) {- switch (transform.toLowerCase()) {- case 'lower':- value = value.toLowerCase();- break;- case 'upper':- value = value.toUpperCase();- break;- case 'title':- value = value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();- break;- }- }-- return value;- });-}--function getLanguageFromPath(filePath: string): { syntax: string; displayName: string } {- const extension = filePath.split('.').pop()?.toLowerCase();- const languageMap: Record<string, { syntax: string; displayName: string }> = {- py: { syntax: 'python', displayName: 'Python' },- js: { syntax: 'javascript', displayName: 'JavaScript' },- ts: { syntax: 'typescript', displayName: 'TypeScript' },- tsx: { syntax: 'typescript', displayName: 'TypeScript' },- jsx: { syntax: 'javascript', displayName: 'JavaScript' },- java: { syntax: 'java', displayName: 'Java' },- cpp: { syntax: 'cpp', displayName: 'C++' },- c: { syntax: 'c', displayName: 'C' },- go: { syntax: 'go', displayName: 'Go' },- rs: { syntax: 'rust', displayName: 'Rust' },- php: { syntax: 'php', displayName: 'PHP' },- rb: { syntax: 'ruby', displayName: 'Ruby' },- swift: { syntax: 'swift', displayName: 'Swift' },- kt: { syntax: 'kotlin', displayName: 'Kotlin' },- scala: { syntax: 'scala', displayName: 'Scala' },- sh: { syntax: 'bash', displayName: 'Bash' },- yml: { syntax: 'yaml', displayName: 'YAML' },- yaml: { syntax: 'yaml', displayName: 'YAML' },- json: { syntax: 'json', displayName: 'JSON' },- xml: { syntax: 'xml', displayName: 'XML' },- html: { syntax: 'html', displayName: 'HTML' },- css: { syntax: 'css', displayName: 'CSS' },- scss: { syntax: 'scss', displayName: 'SCSS' },- sql: { syntax: 'sql', displayName: 'SQL' },- };- return languageMap[extension || ''] || { syntax: 'text', displayName: 'Text' };-}--function readFileLines(- filePath: string,- contextDir: string,- startLine?: number,- endLine?: number-): string {- try {- let fullPath: string;-- // If the path starts with './' or '../', resolve it relative to the context directory- if (filePath.startsWith('./') || filePath.startsWith('../')) {- fullPath = path.resolve(contextDir, filePath);- } else if (filePath.startsWith('fern/')) {- // For paths starting with 'fern/', we need to find the actual fern directory- // The MDX file might be in tools/, pages/dist/, etc., but we want to resolve- // relative to the actual fern directory-- // Try multiple possible locations for the fern directory- const possiblePaths = [- path.resolve(PROJECT_ROOT, '..', filePath), // composio1/fern/...- path.resolve(PROJECT_ROOT, filePath), // Already in fern/...- path.resolve(contextDir, '..', '..', filePath), // Relative to context- ];-- // Find the first path that exists- for (const possiblePath of possiblePaths) {- if (fs.existsSync(possiblePath)) {- fullPath = possiblePath;- break;- }- }-- if (!fullPath) {- // If none found, use the most likely path- fullPath = path.resolve(PROJECT_ROOT, '..', filePath);- }- } else {- // Otherwise, resolve it relative to the project root- fullPath = path.resolve(PROJECT_ROOT, filePath);- }-- const content = fs.readFileSync(fullPath, 'utf8');- const lines = content.split('\n');-- const start = startLine ? startLine - 1 : 0;- const end = endLine ? endLine : lines.length;-- return lines.slice(start, end).join('\n');- } catch (error) {- console.warn(`⚠️ Failed to read file: ${filePath} (resolved to: ${fullPath})`, error);- return `// File not found: ${filePath}`;- }-}--function generateHighlightString(- startLine: number,- highlightStart?: number,- highlightEnd?: number-): string {- if (!highlightStart || !highlightEnd) return '';-- // Convert to relative line numbers (relative to the excerpt)- const relativeStart = highlightStart - startLine + 1;- const relativeEnd = highlightEnd - startLine + 1;-- if (relativeStart === relativeEnd) {- return `{${relativeStart}}`;- }- return `{${relativeStart}-${relativeEnd}}`;-}--async function parseSnippetCodeTags(content: string, contextDir: string): Promise<string> {- const exampleCodeRegex = /<SnippetCode\s+([^>]*?)(?:\s*\/?>|>\s*<\/SnippetCode>)/g;- const matches: Array<{ match: string; propsString: string }> = [];-- let match;- while ((match = exampleCodeRegex.exec(content)) !== null) {- matches.push({ match: match[0], propsString: match[1] });- }-- let result = content;-- for (const { match, propsString } of matches) {- const replacement = await (async () => {- // Parse props from the tag- const props: Partial<SnippetCodeProps> = {};-- // Extract src- const srcMatch = propsString.match(/src=["']([^"']+)["']/);- if (srcMatch) props.src = srcMatch[1];-- // Extract githubUrl- const githubUrlMatch = propsString.match(/githubUrl=["']([^"']+)["']/);- if (githubUrlMatch) props.githubUrl = githubUrlMatch[1];-- // Extract other numeric props (handle both JSX {1} and quoted "1" syntax)- const startLineMatch = propsString.match(/startLine=(?:["'](\d+)["']|{(\d+)})/);- if (startLineMatch) props.startLine = parseInt(startLineMatch[1] || startLineMatch[2]);-- const endLineMatch = propsString.match(/endLine=(?:["'](\d+)["']|{(\d+)})/);- if (endLineMatch) props.endLine = parseInt(endLineMatch[1] || endLineMatch[2]);-- const highlightStartMatch = propsString.match(/highlightStart=(?:["'](\d+)["']|{(\d+)})/);- if (highlightStartMatch)- props.highlightStart = parseInt(highlightStartMatch[1] || highlightStartMatch[2]);-- const highlightEndMatch = propsString.match(/highlightEnd=(?:["'](\d+)["']|{(\d+)})/);- if (highlightEndMatch)- props.highlightEnd = parseInt(highlightEndMatch[1] || highlightEndMatch[2]);-- // Extract string props- const titleMatch = propsString.match(/title=["']([^"']+)["']/);- if (titleMatch) props.title = titleMatch[1];-- const pathMatch = propsString.match(/path=["']([^"']+)["']/);- if (pathMatch) props.path = pathMatch[1];-- const languageMatch = propsString.match(/language=["']([^"']+)["']/);- if (languageMatch) props.language = languageMatch[1];-- const relativeHighlightStartMatch = propsString.match(- /relativeHighlightStart=(?:["'](\d+)["']|{(\d+)})/- );- if (relativeHighlightStartMatch)- props.relativeHighlightStart = parseInt(- relativeHighlightStartMatch[1] || relativeHighlightStartMatch[2]- );-- const relativeHighlightEndMatch = propsString.match(- /relativeHighlightEnd=(?:["'](\d+)["']|{(\d+)})/- );- if (relativeHighlightEndMatch)- props.relativeHighlightEnd = parseInt(- relativeHighlightEndMatch[1] || relativeHighlightEndMatch[2]- );-- // Extract vars object prop- const varsMatch = propsString.match(/vars=\{({[^}]*})\}/);- if (varsMatch) {- try {- // Parse the vars object - need to handle JSX syntax- const varsString = varsMatch[1];- // Convert JSX object syntax to JSON- const jsonString = varsString- .replace(/(\w+):/g, '"$1":') // Add quotes around keys- .replace(/:\s*"([^"]+)"/g, ':"$1"') // Ensure values are quoted- .replace(/:\s*'([^']+)'/g, ':"$1"'); // Convert single quotes to double- props.vars = JSON.parse(`{${jsonString}}`);- } catch (error) {- console.warn(`⚠️ Failed to parse vars prop: ${varsMatch[1]}`);- }- }-- // Extract wordWrap boolean prop- const wordWrapMatch = propsString.match(/wordWrap=(?:["']?(true|false)["']?|{(true|false)})/);- if (wordWrapMatch) {- props.wordWrap = (wordWrapMatch[1] || wordWrapMatch[2]) === 'true';- } else if (propsString.includes('wordWrap')) {- // Handle case where wordWrap is specified without a value (defaults to true)- props.wordWrap = true;- }-- // Validate that either src or githubUrl is provided- if (!props.src && !props.githubUrl) {- const errorMessage = 'SnippetCode tag missing both src and githubUrl attributes';- console.warn(`⚠️ ${errorMessage}:`, match);- return `\`\`\`error\n${errorMessage}\n\nProps: ${JSON.stringify(props, null, 2)}\n\nFix the issue above and rebuild.\n\`\`\``;- }-- let codeContent: string;- let filePath: string;- let langInfo: { syntax: string; displayName: string };-- try {- if (props.githubUrl) {- // Handle GitHub URL- const parsedUrl = parseGitHubUrl(props.githubUrl);-- // Fetch content from GitHub- const fetchResult = await fetchGitHubContent(parsedUrl);-- if (fetchResult.error) {- console.error(`❌ SnippetCode Error: ${fetchResult.error}`);- return `\`\`\`error\nSnippetCode Error: ${fetchResult.error}\n\nProps: ${JSON.stringify(props, null, 2)}\n\nFix the issue above and rebuild.\n\`\`\``;- }-- // Extract lines based on URL or manual overrides- const startLine = props.startLine || parsedUrl.startLine || 1;- const endLine = props.endLine || parsedUrl.endLine || 100;-- codeContent = extractLinesFromContent(fetchResult.content!, startLine, endLine);- filePath = parsedUrl.filePath;- langInfo = getLanguageFromPath(filePath);- } else {- // Handle local file- codeContent = readFileLines(props.src!, contextDir, props.startLine, props.endLine);- filePath = props.src!;- langInfo = getLanguageFromPath(filePath);- }-- // Apply variable replacements if vars are provided- if (props.vars && Object.keys(props.vars).length > 0) {- codeContent = replaceTemplateVariables(codeContent, props.vars);- }- } catch (error) {- const errorMessage = error instanceof SnippetCodeError ? error.message : `Unexpected error: ${error.message}`;- console.error(`❌ SnippetCode Error: ${errorMessage}`);- return `\`\`\`error\nSnippetCode Error: ${errorMessage}\n\nProps: ${JSON.stringify(props, null, 2)}\n\nFix the issue above and rebuild.\n\`\`\``;- }-- const syntax = props.language || langInfo.syntax;- const displayName = langInfo.displayName;-- // Generate highlight string if needed- let highlightString = '';- if (props.relativeHighlightStart && props.relativeHighlightEnd) {- // Use relative highlights directly- if (props.relativeHighlightStart === props.relativeHighlightEnd) {- highlightString = `{${props.relativeHighlightStart}}`;- } else {- highlightString = `{${props.relativeHighlightStart}-${props.relativeHighlightEnd}}`;- }- } else if (props.highlightStart && props.highlightEnd) {- // Use absolute highlights and convert to relative- highlightString = generateHighlightString(- props.startLine || 1,- props.highlightStart,- props.highlightEnd- );- }-- // Use title priority: explicit title > path > implicit title (displayName)- const title = props.title || props.path || displayName;- const titleComment = ` title="${title}"`;-- // Create the code block with syntax, display name, and maxLines- const codeBlock = `\`\`\`${syntax} ${displayName}${highlightString ? ` ${highlightString}` : ''}${titleComment} maxLines=40 ${props.wordWrap ? 'wordWrap' : ''}\n${codeContent}\n\`\`\``;-- return codeBlock;- })();-- result = result.replace(match, replacement);- }-- return result;-}--async function processFile(srcPath: string, distPath: string) {- try {- const content = fs.readFileSync(srcPath, 'utf8');- const contextDir = path.dirname(srcPath);- const processedContent = await parseSnippetCodeTags(content, contextDir);-- // Ensure the directory exists- const distDir = path.dirname(distPath);- if (!fs.existsSync(distDir)) {- fs.mkdirSync(distDir, { recursive: true });- }-- fs.writeFileSync(distPath, processedContent);- console.log(- `✅ Processed: ${path.relative(DOCS_SRC_DIR, srcPath)} -> ${path.relative(PAGES_DIST_DIR, distPath)}`- );- } catch (error) {- console.error(`❌ Error processing ${srcPath}:`, error);- }-}--function isMarkdownFile(filename: string): boolean {- return filename.endsWith('.mdx') || filename.endsWith('.md');-}--async function processAllFiles() {- console.log('🔄 Processing all .mdx and .md files...');-- async function processDirectory(srcDir: string) {- const entries = fs.readdirSync(srcDir, { withFileTypes: true });- const promises: Promise<void>[] = [];-- for (const entry of entries) {- const srcPath = path.join(srcDir, entry.name);-- if (entry.isDirectory()) {- // Skip dist directory to avoid infinite loops- if (entry.name === 'dist') continue;- promises.push(processDirectory(srcPath));- } else if (entry.isFile() && isMarkdownFile(entry.name)) {- // Calculate the relative path from the source directory- const relativePath = path.relative(DOCS_SRC_DIR, srcPath);-- // Always preserve directory structure- const distPath = path.join(PAGES_DIST_DIR, relativePath);-- promises.push(processFile(srcPath, distPath));- }- }-- await Promise.all(promises);- }-- await processDirectory(DOCS_SRC_DIR);- console.log('✅ All files processed');-}--// Watch for changes and reprocess-function startWatchMode() {- console.log('👀 Watching for changes...');-- const watcher = watch(DOCS_SRC_DIR, { recursive: true }, (eventType, filename) => {- if (!filename) return;- if (!isMarkdownFile(filename)) return;-- const srcPath = path.join(DOCS_SRC_DIR, filename);-- // Always preserve directory structure- const distPath = path.join(PAGES_DIST_DIR, filename);-- if (eventType === 'change' && fs.existsSync(srcPath)) {- console.log(`🔄 File changed: ${filename}`);- processFile(srcPath, distPath).catch(error => {- console.error(`❌ Error processing ${filename}:`, error);- });- }- });-- // Also watch source files that might be referenced- const sourceWatcher = watch(PROJECT_ROOT, { recursive: true }, (eventType, filename) => {- if (!filename) return;- if (filename.includes('node_modules')) return;- if (filename.includes('.git')) return;- if (filename.includes('fern/pages')) return; // Skip pages (output) files- if (filename.includes('fern/scripts')) return; // Skip the script itself-- // If a source file changes, reprocess all .mdx and .md files since we don't know which ones reference it- if (- eventType === 'change' &&- (filename.endsWith('.ts') || filename.endsWith('.js') || filename.endsWith('.py'))- ) {- console.log(`🔄 Source file changed: ${filename}, reprocessing all .mdx and .md files...`);- processAllFiles();- }- });-- // Cleanup on exit- process.on('SIGINT', () => {- console.log('\n👋 Stopping watchers...');- watcher.close();- sourceWatcher.close();- process.exit(0);- });-}--// Main function-async function main() {- console.log('🚀 Starting SnippetCode processor...');- console.log(`Source: ${DOCS_SRC_DIR}`);- console.log(`Dist: ${PAGES_DIST_DIR}`);-- ensureDistDir();- await processAllFiles();-- // Check if we should run in watch mode- const isWatchMode = process.argv.includes('--watch') || process.argv.includes('-w');-- if (isWatchMode) {- startWatchMode();- } else {- console.log('✅ Processing complete. Use --watch flag to enable watch mode.');- }-}--// Run the main function directly-main().catch(error => {- console.error('❌ Fatal error:', error);- process.exit(1);-});\ No newline at end of filediff --git a/fern/scripts/build-tools-json.ts b/fern/scripts/build-tools-json.tsdeleted file mode 100644index d1e3d58a8..000000000--- a/fern/scripts/build-tools-json.ts+++ /dev/null@@ -1,119 +0,0 @@-#!/usr/bin/env bun-/* eslint-disable no-console */--import fs from 'fs';-import path from 'path';--const FERN_DIR = path.join(import.meta.dir, '..');-const TOOLKITS_DIR = path.join(FERN_DIR, 'toolkits');-const TOOLS_JSON_PATH = path.join(- FERN_DIR,- 'llms-txt-worker',- 'public',- 'robots-only',- 'tools.json'-);--interface ToolkitInfo {- slug: string;- description: string;- tools: string[];-}--interface ToolsData {- toolkitNames: string[];- [key: string]: string[] | ToolkitInfo;-}--function parseToolkitMdx(toolMdxPath: string): ToolkitInfo | null {- try {- const fullPath = path.join(TOOLKITS_DIR, toolMdxPath);- if (!fs.existsSync(fullPath)) {- return null;- }-- const content = fs.readFileSync(fullPath, 'utf8');-- const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);- if (!frontmatterMatch) return null;-- const frontmatter = frontmatterMatch[1];- const titleMatch = frontmatter.match(/title:\s*["']?(.+?)["']?\s*$/m);- if (!titleMatch) return null;-- const slugMatch = content.match(/\*\*SLUG\*\*:\s*`([^`]+)`/);- if (!slugMatch) return null;-- const descriptionMatch = content.match(/### Description\s*\n(.+?)(?:\n|$)/);- const description = descriptionMatch ? descriptionMatch[1].trim() : '';-- const toolNames: string[] = [];- const accordionMatches = content.matchAll(/<Accordion title="([^"]+)">/g);-- for (const match of accordionMatches) {- const toolName = match[1];- if (toolName.startsWith(slugMatch[1] + '_')) {- toolNames.push(toolName);- }- }-- return {- slug: slugMatch[1],- description,- tools: toolNames,- };- } catch (error) {- console.warn(`Error parsing ${toolMdxPath}:`, error);- return null;- }-}--function buildToolsData(): ToolsData {- const toolsData: ToolsData = { toolkitNames: [] };-- if (!fs.existsSync(TOOLKITS_DIR)) {- console.error(`Toolkits directory not found: ${TOOLKITS_DIR}`);- return toolsData;- }-- const files = fs.readdirSync(TOOLKITS_DIR);- const mdxFiles = files.filter(file => file.endsWith('.mdx'));- console.log(`Found ${mdxFiles.length} MDX files`);-- for (const file of mdxFiles) {- const toolkitInfo = parseToolkitMdx(file);- if (toolkitInfo) {- toolsData.toolkitNames.push(toolkitInfo.slug);- toolsData[toolkitInfo.slug] = toolkitInfo;- console.log(` ${toolkitInfo.slug}: ${toolkitInfo.tools.length} tools`);- }- }-- toolsData.toolkitNames.sort();- return toolsData;-}--function main() {- console.log('Building tools.json...');- try {- const toolsData = buildToolsData();-- console.log(`\nSummary:`);- console.log(` Total toolkits: ${toolsData.toolkitNames.length}`);-- let totalTools = 0;- for (const name of toolsData.toolkitNames) {- const toolkit = toolsData[name] as ToolkitInfo;- totalTools += toolkit.tools.length;- }- console.log(` Total tools: ${totalTools}`);-- fs.writeFileSync(TOOLS_JSON_PATH, JSON.stringify(toolsData, null, 2));- console.log(`\nGenerated ${TOOLS_JSON_PATH}`);- } catch (error) {- console.error('Error:', error);- process.exit(1);- }-}--main();\ No newline at end of filediff --git a/fern/scripts/doc-new.ts b/fern/scripts/doc-new.tsdeleted file mode 100755index 6f9c39729..000000000--- a/fern/scripts/doc-new.ts+++ /dev/null@@ -1,287 +0,0 @@-#!/usr/bin/env bun--import fs from 'fs';-import path from 'path';-import { parseArgs } from 'util';-import readline from 'readline';--const PAGES_SRC_DIR = path.join(import.meta.dir, '../pages/src');-const SNIPPETS_DIR = path.join(import.meta.dir, '../snippets');--const FEATURES = [- 'get-started',- 'tool-calling',- 'authentication',- 'triggers',- 'providers',- 'examples',- 'migration',- 'mcp',-];--const DOC_TYPES = ['guide', 'example', 'provider', 'reference'];--const DOC_TEMPLATES: Record<string, (name: string) => string> = {- guide: (name: string) => `----title: ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}-description: ""-keywords: ""-subtitle: ""-hide-nav-links: false------## Introduction--[Add your introduction here]--## Getting Started--[Add getting started content]--## Examples--[Add examples here]--## Next Steps--[Add next steps]-`,- example: (name: string) => `----title: ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}-description: ""-keywords: ""-subtitle: ""-hide-nav-links: true------This example demonstrates...--## Prerequisites--- [List prerequisites]--## Implementation--[Add implementation details]--## Running the Example--[Add instructions]--## Next Steps--[Add next steps]-`,- provider: (name: string) => `----title: ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')} Provider-slug: /providers/${name}-image: "https://og.composio.dev/api/og?title=${encodeURIComponent(name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' '))}%20Provider"-keywords: ""-hide-nav-links: false------The ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')} Provider transforms Composio tools into a format compatible with ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}'s function calling capabilities.--## Setup--<CodeGroup>-\`\`\`typescript TypeScript-npm install @composio/${name}-\`\`\`-\`\`\`python Python-pip install composio[${name}]-\`\`\`-</CodeGroup>--## Usage--<Tabs>-<Tab title="TypeScript">-<SnippetCode- src="fern/snippets/providers/typescript/${name}.ts"- title="${name}-provider.ts"-/>-</Tab>-<Tab title="Python">-<SnippetCode- src="fern/snippets/providers/python/${name}.py"- title="${name}-provider.py"-/>-</Tab>-</Tabs>-`,- reference: (name: string) => `----title: ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}-description: ""-keywords: ""-subtitle: ""-hide-nav-links: false------## Overview--[Add overview]--## API Reference--[Add API reference]--## Examples--[Add examples]-`,-};--const rl = readline.createInterface({- input: process.stdin,- output: process.stdout,-});--function question(prompt: string): Promise<string> {- return new Promise((resolve) => {- rl.question(prompt, resolve);- });-}--function validateFeature(feature: string): boolean {- return FEATURES.includes(feature);-}--function validateDocType(type: string): boolean {- return DOC_TYPES.includes(type);-}--async function createDoc(feature: string, name: string, type: string) {- if (!validateFeature(feature)) {- console.error(`❌ Invalid feature: ${feature}`);- console.log(`Valid features: ${FEATURES.join(', ')}`);- process.exit(1);- }-- if (!validateDocType(type)) {- console.error(`❌ Invalid type: ${type}`);- console.log(`Valid types: ${DOC_TYPES.join(', ')}`);- process.exit(1);- }-- const featureDir = path.join(PAGES_SRC_DIR, feature);- const fileName = `${name}.mdx`;- const filePath = path.join(featureDir, fileName);-- // Create directory if it doesn't exist- if (!fs.existsSync(featureDir)) {- fs.mkdirSync(featureDir, { recursive: true });- console.log(`📁 Created directory: ${path.relative(PAGES_SRC_DIR, featureDir)}`);- }-- // Check if file already exists- if (fs.existsSync(filePath)) {- console.error(`❌ File already exists: ${path.relative(PAGES_SRC_DIR, filePath)}`);- process.exit(1);- }-- // Write the template- const template = DOC_TEMPLATES[type];- fs.writeFileSync(filePath, template(name));- console.log(`✅ Created doc: ${path.relative(PAGES_SRC_DIR, filePath)}`);-- // Ask about creating snippet files- if (type === 'provider' || type === 'example') {- const createSnippets = await question('\n📝 Create matching snippet files? (y/n): ');- if (createSnippets.toLowerCase() === 'y') {- await createMatchingSnippets(feature, name);- }- }-- // Show navigation update suggestion- console.log(`\n📋 To add this to navigation, update fern/docs.yml:`);- console.log(` - page: ${name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}`);- console.log(` path: pages/dist/${feature}/${fileName}`);- if (type === 'provider') {- console.log(` slug: ${name}`);- }-- rl.close();-}--async function createMatchingSnippets(feature: string, name: string) {- const languages = ['python', 'typescript'];- const extensions = { python: 'py', typescript: 'ts' };-- for (const lang of languages) {- const snippetFeatureDir = path.join(SNIPPETS_DIR, feature, lang);- const snippetFileName = `${name}.${extensions[lang]}`;- const snippetFilePath = path.join(snippetFeatureDir, snippetFileName);-- // Create directory if it doesn't exist- if (!fs.existsSync(snippetFeatureDir)) {- fs.mkdirSync(snippetFeatureDir, { recursive: true });- }-- // Skip if file exists- if (fs.existsSync(snippetFilePath)) {- console.log(`⚠️ Snippet already exists: ${path.relative(SNIPPETS_DIR, snippetFilePath)}`);- continue;- }-- // Create snippet with boilerplate- const boilerplate = lang === 'python'- ? `from composio import Composio\n\n# Initialize Composio client\ncomposio = Composio()\n\n# TODO: Add ${name} provider example\n`- : `import { Composio } from '@composio/core';\n\n// Initialize Composio client\nconst composio = new Composio();\n\n// TODO: Add ${name} provider example\n`;-- fs.writeFileSync(snippetFilePath, boilerplate);- console.log(`✅ Created snippet: ${path.relative(SNIPPETS_DIR, snippetFilePath)}`);- }-}--function showHelp() {- console.log(`-Usage: pnpm doc:new --feature=<feature> --name=<name> --type=<type>--Options:- --feature The feature category (required)- Valid values: ${FEATURES.join(', ')}-- --name The name of the doc file (required)- Will be saved as <name>.mdx-- --type The type of documentation (required)- Valid values: ${DOC_TYPES.join(', ')}-- --help Show this help message--Examples:- pnpm doc:new --feature=providers --name=gemini --type=provider- pnpm doc:new --feature=examples --name=calendar-sync --type=example- pnpm doc:new --feature=authentication --name=oauth-flow --type=guide-`);-}--async function main() {- const { values } = parseArgs({- args: process.argv.slice(2),- options: {- feature: { type: 'string' },- name: { type: 'string' },- type: { type: 'string' },- help: { type: 'boolean' },- },- });-- if (values.help) {- showHelp();- process.exit(0);- }-- const { feature, name, type } = values;-- if (!feature || !name || !type) {- console.error('❌ Missing required arguments');- showHelp();- process.exit(1);- }-- await createDoc(feature, name, type);-}--main();\ No newline at end of filediff --git a/fern/scripts/examples-dev.ts b/fern/scripts/examples-dev.tsdeleted file mode 100755index 51e67e51e..000000000--- a/fern/scripts/examples-dev.ts+++ /dev/null@@ -1,286 +0,0 @@-#!/usr/bin/env bun-/* eslint-disable no-console */--import fs from 'fs';-import path from 'path';-import { watch } from 'fs';--const EXAMPLES_SRC_DIR = path.join(import.meta.dir, '../pages/examples');-const EXAMPLES_DIST_DIR = path.join(import.meta.dir, '../pages/examples/dist');-const PROJECT_ROOT = path.join(import.meta.dir, '../..');--interface ExampleCodeProps {- src: string;- startLine?: number;- endLine?: number;- highlightStart?: number;- highlightEnd?: number;- title?: string;- language?: string;-}--// Ensure dist directory exists-function ensureDistDir() {- if (!fs.existsSync(EXAMPLES_DIST_DIR)) {- fs.mkdirSync(EXAMPLES_DIST_DIR, { recursive: true });- }-}--// Get language from file extension-function getLanguageFromPath(filePath: string): string {- const extension = filePath.split('.').pop()?.toLowerCase();- const languageMap: Record<string, string> = {- py: 'python',- js: 'javascript',- ts: 'typescript',- tsx: 'typescript',- jsx: 'javascript',- java: 'java',- cpp: 'cpp',- c: 'c',- go: 'go',- rs: 'rust',- php: 'php',- rb: 'ruby',- swift: 'swift',- kt: 'kotlin',- scala: 'scala',- sh: 'bash',- yml: 'yaml',- yaml: 'yaml',- json: 'json',- xml: 'xml',- html: 'html',- css: 'css',- scss: 'scss',- sql: 'sql',- };- return languageMap[extension || ''] || 'text';-}--// Read and extract lines from a file-function readFileLines(filePath: string, startLine?: number, endLine?: number): string {- try {- const fullPath = path.resolve(PROJECT_ROOT, filePath);- const content = fs.readFileSync(fullPath, 'utf8');- const lines = content.split('\n');-- const start = startLine ? startLine - 1 : 0;- const end = endLine ? endLine : lines.length;-- return lines.slice(start, end).join('\n');- } catch (error) {- console.warn(`⚠️ Failed to read file: ${filePath}`, error);- return `// File not found: ${filePath}`;- }-}--// Generate highlight string for Fern-function generateHighlightString(- startLine: number,- highlightStart?: number,- highlightEnd?: number-): string {- if (!highlightStart || !highlightEnd) return '';-- // Convert to relative line numbers (relative to the excerpt)- const relativeStart = highlightStart - startLine + 1;- const relativeEnd = highlightEnd - startLine + 1;-- if (relativeStart === relativeEnd) {- return `{${relativeStart}}`;- }- return `{${relativeStart}-${relativeEnd}}`;-}--// Parse ExampleCode tags and replace with actual code blocks-function parseExampleCodeTags(content: string): string {- const exampleCodeRegex = /<ExampleCode\s+([^>]*?)(?:\s*\/?>|>\s*<\/ExampleCode>)/g;-- return content.replace(exampleCodeRegex, (match, propsString) => {- // Parse props from the tag- const props: Partial<ExampleCodeProps> = {};-- // Extract src- const srcMatch = propsString.match(/src=["']([^"']+)["']/);- if (srcMatch) props.src = srcMatch[1];-- // Extract other numeric props (handle both JSX {1} and quoted "1" syntax)- const startLineMatch = propsString.match(/startLine=(?:["'](\d+)["']|{(\d+)})/);- if (startLineMatch) props.startLine = parseInt(startLineMatch[1] || startLineMatch[2]);-- const endLineMatch = propsString.match(/endLine=(?:["'](\d+)["']|{(\d+)})/);- if (endLineMatch) props.endLine = parseInt(endLineMatch[1] || endLineMatch[2]);-- const highlightStartMatch = propsString.match(/highlightStart=(?:["'](\d+)["']|{(\d+)})/);- if (highlightStartMatch)- props.highlightStart = parseInt(highlightStartMatch[1] || highlightStartMatch[2]);-- const highlightEndMatch = propsString.match(/highlightEnd=(?:["'](\d+)["']|{(\d+)})/);- if (highlightEndMatch)- props.highlightEnd = parseInt(highlightEndMatch[1] || highlightEndMatch[2]);-- // Extract string props- const titleMatch = propsString.match(/title=["']([^"']+)["']/);- if (titleMatch) props.title = titleMatch[1];-- const languageMatch = propsString.match(/language=["']([^"']+)["']/);- if (languageMatch) props.language = languageMatch[1];-- if (!props.src) {- console.warn('⚠️ ExampleCode tag missing src attribute:', match);- return '```\n// Error: ExampleCode tag missing src attribute\n```';- }-- // Read the file content- const codeContent = readFileLines(props.src, props.startLine, props.endLine);- const language = props.language || getLanguageFromPath(props.src);-- // Generate highlight string if needed- const highlightString =- props.highlightStart && props.highlightEnd- ? generateHighlightString(props.startLine || 1, props.highlightStart, props.highlightEnd)- : '';-- // Generate the title comment- const titleComment = props.title ? ` title="${props.title}"` : '';-- // Create the code block- const codeBlock = `\`\`\`${language}${highlightString ? ` ${highlightString}` : ''}${titleComment}\n${codeContent}\n\`\`\``;-- return codeBlock;- });-}--// Process a single .mdx file-function processFile(srcPath: string, distPath: string) {- try {- const content = fs.readFileSync(srcPath, 'utf8');- const processedContent = parseExampleCodeTags(content);-- // Ensure the directory exists- const distDir = path.dirname(distPath);- if (!fs.existsSync(distDir)) {- fs.mkdirSync(distDir, { recursive: true });- }-- fs.writeFileSync(distPath, processedContent);- console.log(- `✅ Processed: ${path.relative(EXAMPLES_SRC_DIR, srcPath)} -> ${path.relative(EXAMPLES_DIST_DIR, distPath)}`- );- } catch (error) {- console.error(`❌ Error processing ${srcPath}:`, error);- }-}--// Process all .mdx files in the source directory-function processAllFiles() {- console.log('🔄 Processing all .mdx files...');-- function processDirectory(srcDir: string) {- const entries = fs.readdirSync(srcDir, { withFileTypes: true });-- for (const entry of entries) {- const srcPath = path.join(srcDir, entry.name);-- if (entry.isDirectory()) {- // Skip dist directory to avoid infinite loops- if (entry.name === 'dist') continue;- processDirectory(srcPath);- } else if (entry.isFile() && entry.name.endsWith('.mdx')) {- // Calculate the relative path from the source directory- const relativePath = path.relative(EXAMPLES_SRC_DIR, srcPath);-- // Remove 'src/' prefix if it exists and create dist path- const cleanRelativePath = relativePath.startsWith('src/')- ? relativePath.substring(4) // Remove 'src/' prefix- : relativePath;-- const distPath = path.join(EXAMPLES_DIST_DIR, cleanRelativePath);- processFile(srcPath, distPath);- }- }- }-- processDirectory(EXAMPLES_SRC_DIR);- console.log('✅ All files processed');-}--// Watch for changes and reprocess-function startWatchMode() {- console.log('👀 Watching for changes...');-- const watcher = watch(EXAMPLES_SRC_DIR, { recursive: true }, (eventType, filename) => {- if (!filename) return;- if (!filename.endsWith('.mdx')) return;-- // Skip dist files completely - they should never trigger processing- if (filename.includes('dist/') || filename.includes('dist\\')) {- return;- }-- // Only process files in src/ subdirectory- if (!filename.startsWith('src/') && !filename.startsWith('src\\')) {- return;- }-- const srcPath = path.join(EXAMPLES_SRC_DIR, filename);-- // Remove 'src/' prefix and create dist path- const cleanFilename = filename.substring(4); // Remove 'src/' prefix- const distPath = path.join(EXAMPLES_DIST_DIR, cleanFilename);-- if (eventType === 'change' && fs.existsSync(srcPath)) {- console.log(`🔄 File changed: ${filename}`);- processFile(srcPath, distPath);- }- });-- // Also watch source files that might be referenced- const sourceWatcher = watch(PROJECT_ROOT, { recursive: true }, (eventType, filename) => {- if (!filename) return;- if (filename.includes('node_modules')) return;- if (filename.includes('.git')) return;- if (filename.includes('fern/pages/examples/dist')) return; // Skip dist files- if (filename.includes('fern/scripts')) return; // Skip the script itself-- // If a source file changes, reprocess all .mdx files since we don't know which ones reference it- if (- eventType === 'change' &&- (filename.endsWith('.ts') || filename.endsWith('.js') || filename.endsWith('.py'))- ) {- console.log(`🔄 Source file changed: ${filename}, reprocessing all .mdx files...`);- processAllFiles();- }- });-- // Cleanup on exit- process.on('SIGINT', () => {- console.log('\n👋 Stopping watchers...');- watcher.close();- sourceWatcher.close();- process.exit(0);- });-}--// Main function-function main() {- console.log('🚀 Starting ExampleCode processor...');-- ensureDistDir();- processAllFiles();-- // Check if we should run in watch mode- const isWatchMode = process.argv.includes('--watch') || process.argv.includes('-w');-- if (isWatchMode) {- startWatchMode();- } else {- console.log('✅ Processing complete. Use --watch flag to enable watch mode.');- }-}--// Run if this is the main module-if (import.meta.main) {- main();-}diff --git a/fern/scripts/manage-tool-docs.py b/fern/scripts/manage-tool-docs.pydeleted file mode 100755index c9e59e28d..000000000--- a/fern/scripts/manage-tool-docs.py+++ /dev/null@@ -1,185 +0,0 @@-#!/usr/bin/env python3-"""-Script to comment/uncomment tool docs in docs.yml, leaving only the introduction.-Uses ruamel.yaml to properly parse and modify the YAML structure.-"""--import argparse-from pathlib import Path-from ruamel.yaml import YAML-from ruamel.yaml.comments import CommentedMap, CommentedSeq-import io---def process_tool_docs(file_path: Path, action: str) -> None:- """- Process the docs.yml file to comment or uncomment tool docs.-- Args:- file_path: Path to the docs.yml file- action: Either 'comment' or 'uncomment'- """- yaml = YAML()- yaml.preserve_quotes = True- yaml.width = 4096 # Prevent line wrapping- yaml.indent(mapping=2, sequence=2, offset=0)-- # Read the file content- with open(file_path, 'r') as f:- content = f.read()-- if action == 'uncomment':- # First, uncomment any commented lines in the toolkits section- lines = content.split('\n')- new_lines = []- in_tools_section = False-- for i, line in enumerate(lines):- # Check if we're entering the toolkits tab- if '- tab: toolkits' in line:- in_tools_section = True- # Check if we're leaving the toolkits tab- elif in_tools_section and line.strip().startswith('- tab:'):- in_tools_section = False-- # Uncomment lines in toolkits section- if in_tools_section and line.strip().startswith('#') and ('- page:' in line or 'path:' in line):- # Remove comment while preserving indentation- uncommented = line.replace('# ', '', 1) if '# ' in line else line.replace('#', '', 1)- new_lines.append(uncommented)- else:- new_lines.append(line)-- content = '\n'.join(new_lines)-- # Parse the YAML- data = yaml.load(content)-- # Find the navigation section- if 'navigation' not in data:- print("Error: No navigation section found in docs.yml")- return-- # Find the toolkits tab- tools_tab = None- for tab in data['navigation']:- if isinstance(tab, CommentedMap) and tab.get('tab') == 'toolkits':- tools_tab = tab- break-- if not tools_tab:- print("Error: No toolkits tab found in navigation")- return-- # Find the toolkits section within the toolkits tab- if 'layout' not in tools_tab:- print("Error: No layout found in toolkits tab")- return-- tools_section = None- for section in tools_tab['layout']:- if isinstance(section, CommentedMap) and section.get('section') == 'Toolkits':- tools_section = section- break-- if not tools_section or 'contents' not in tools_section:- print("Error: No contents found in Toolkits section")- return-- if action == 'comment':- # Write the data to a string first- stream = io.StringIO()- yaml.dump(data, stream)- content = stream.getvalue()-- # Now manually comment out toolkits after the 1st one (introduction)- lines = content.split('\n')- new_lines = []- in_tools_section = False- tool_count = 0- i = 0-- while i < len(lines):- line = lines[i]-- # Check if we're entering the toolkits section- if '- section: Toolkits' in line and 'toolkits' in '\n'.join(lines[max(0, i-10):i]):- in_tools_section = True- new_lines.append(line)- i += 1- continue-- # Check if we're leaving the tools section- if in_tools_section and line.strip().startswith('- tab:'):- in_tools_section = False- tool_count = 0-- # Count and process tool entries- if in_tools_section and '- page:' in line and line.strip().startswith('- page:'):- tool_count += 1- if tool_count > 1: # Skip only the introduction- # Comment out this line and the next one (path line)- indent = len(line) - len(line.lstrip())- new_lines.append(' ' * indent + '# ' + line.lstrip())- # Also comment the next line if it's a path line- if i + 1 < len(lines) and 'path:' in lines[i + 1]:- i += 1- line = lines[i]- indent = len(line) - len(line.lstrip())- new_lines.append(' ' * indent + '# ' + line.lstrip())- else:- new_lines.append(line)- else:- new_lines.append(line)-- i += 1-- # Write the commented version- with open(file_path, 'w') as f:- f.write('\n'.join(new_lines))- else:- # For uncomment, just write the parsed data back- with open(file_path, 'w') as f:- yaml.dump(data, f)-- print(f"Successfully {action}ed tool docs in {file_path}")- if action == 'comment':- print("Left uncommented: Introduction only")- else:- print("All tool docs are now uncommented")---def main():- parser = argparse.ArgumentParser(- description='Comment or uncomment tool docs in docs.yml using ruamel.yaml'- )- parser.add_argument(- 'action',- choices=['comment', 'uncomment'],- help='Action to perform: comment or uncomment tool docs'- )- parser.add_argument(- '--file',- type=Path,- default=Path(__file__).parent.parent / 'docs.yml',- help='Path to docs.yml file (default: ../docs.yml relative to script)'- )-- args = parser.parse_args()-- if not args.file.exists():- print(f"Error: File {args.file} does not exist")- return 1-- try:- process_tool_docs(args.file, args.action)- return 0- except Exception as e:- print(f"Error processing file: {e}")- import traceback- traceback.print_exc()- return 1---if __name__ == '__main__':- exit(main())diff --git a/fern/scripts/pull-openapi-spec.sh b/fern/scripts/pull-openapi-spec.shdeleted file mode 100755index 3b482e94e..000000000--- a/fern/scripts/pull-openapi-spec.sh+++ /dev/null@@ -1,65 +0,0 @@-#!/bin/bash--# Exit on any error-set -e--OPENAPI_URL="https://backend.composio.dev/api/v3/openapi.json"-OPENAPI_MCP_URL="https://mcp.composio.dev/openapi.json"--# Get the directory where the script is located, works in both CI and local environments-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}" 2>/dev/null || dirname "$0")" && pwd)"-FERN_DIR="$(dirname "$SCRIPT_DIR")"-API_DIR="$FERN_DIR/apis"-OUTPUT_FILE="$API_DIR/openapi.json"-# OUTPUT_V3_FILE="$API_DIR/openapi-v3.json"-OUTPUT_MCP_FILE="$API_DIR/openapi-mcp.json"--# Debug information-echo "Script directory: $SCRIPT_DIR"-echo "Fern directory: $FERN_DIR"-echo "API directory: $API_DIR"--# Create API directory if it doesn't exist-mkdir -p "$API_DIR"--echo "Pulling latest OpenAPI specification from $OPENAPI_URL"--# Use curl to fetch the OpenAPI specification directly to output file-if curl -f -o "$OUTPUT_FILE" "$OPENAPI_URL"; then- echo "Successfully downloaded OpenAPI specification to $OUTPUT_FILE"-else- echo "Failed to download OpenAPI specification"- exit 1-fi--# Validate that the file exists and is not empty-if [ -s "$OUTPUT_FILE" ]; then- echo "Verified OpenAPI specification file exists and is not empty"-else- echo "Error: OpenAPI specification file is empty or does not exist"- exit 1-fi--# Fetch the MCP OpenAPI specification directly to output file-echo "Pulling latest MCP OpenAPI specification from $OPENAPI_MCP_URL"-if curl -f -o "$OUTPUT_MCP_FILE" "$OPENAPI_MCP_URL"; then- echo "Successfully downloaded MCP OpenAPI specification to $OUTPUT_MCP_FILE"-else- echo "Failed to download MCP OpenAPI specification"- exit 1-fi--# Validate that the MCP file exists and is not empty-if [ -s "$OUTPUT_MCP_FILE" ]; then- echo "Verified MCP OpenAPI specification file exists and is not empty"-else- echo "Error: MCP OpenAPI specification file is empty or does not exist"- exit 1-fi--# For debugging-ls -la "$API_DIR"-echo "FERN_DIR=$FERN_DIR"-echo "API_DIR=$API_DIR"--echo "OpenAPI specifications successfully updated"diff --git a/fern/scripts/snippet-new.ts b/fern/scripts/snippet-new.tsdeleted file mode 100755index 2701cdf6f..000000000--- a/fern/scripts/snippet-new.ts+++ /dev/null@@ -1,140 +0,0 @@-#!/usr/bin/env bun--import fs from 'fs';-import path from 'path';-import { parseArgs } from 'util';--const SNIPPETS_DIR = path.join(import.meta.dir, '../snippets');--const FEATURES = [- 'get-started',- 'tool-calling',- 'authentication',- 'triggers',- 'providers',- 'examples',- 'migration',- 'mcp',-];--const LANGUAGES = ['python', 'typescript'];--const LANGUAGE_EXTENSIONS: Record<string, string> = {- python: 'py',- typescript: 'ts',-};--const LANGUAGE_BOILERPLATES: Record<string, string> = {- python: `from composio import Composio--# Initialize Composio client-composio = Composio()--# TODO: Add your code here-`,- typescript: `import { Composio } from '@composio/core';--// Initialize Composio client-const composio = new Composio();--// TODO: Add your code here-`,-};--function validateFeature(feature: string): boolean {- return FEATURES.includes(feature);-}--function validateLanguage(lang: string): boolean {- return LANGUAGES.includes(lang);-}--function createSnippet(feature: string, name: string, lang: string) {- if (!validateFeature(feature)) {- console.error(`❌ Invalid feature: ${feature}`);- console.log(`Valid features: ${FEATURES.join(', ')}`);- process.exit(1);- }-- if (!validateLanguage(lang)) {- console.error(`❌ Invalid language: ${lang}`);- console.log(`Valid languages: ${LANGUAGES.join(', ')}`);- process.exit(1);- }-- const extension = LANGUAGE_EXTENSIONS[lang];- const boilerplate = LANGUAGE_BOILERPLATES[lang];-- const featureDir = path.join(SNIPPETS_DIR, feature, lang);- const fileName = `${name}.${extension}`;- const filePath = path.join(featureDir, fileName);-- // Create directory if it doesn't exist- if (!fs.existsSync(featureDir)) {- fs.mkdirSync(featureDir, { recursive: true });- console.log(`📁 Created directory: ${path.relative(SNIPPETS_DIR, featureDir)}`);- }-- // Check if file already exists- if (fs.existsSync(filePath)) {- console.error(`❌ File already exists: ${path.relative(SNIPPETS_DIR, filePath)}`);- process.exit(1);- }-- // Write the boilerplate- fs.writeFileSync(filePath, boilerplate);- console.log(`✅ Created snippet: ${path.relative(SNIPPETS_DIR, filePath)}`);- console.log(`\nYou can now reference this snippet in your docs with:`);- console.log(`<SnippetCode src="fern/snippets/${feature}/${lang}/${fileName}" />`);-}--function showHelp() {- console.log(`-Usage: pnpm snippet:new --feature=<feature> --name=<name> --lang=<language>--Options:- --feature The feature category (required)- Valid values: ${FEATURES.join(', ')}-- --name The name of the snippet file (required)- Will be saved as <name>.<extension>-- --lang The programming language (required)- Valid values: ${LANGUAGES.join(', ')}-- --help Show this help message--Examples:- pnpm snippet:new --feature=providers --name=anthropic --lang=python- pnpm snippet:new --feature=triggers --name=slack-events --lang=typescript-`);-}--function main() {- const { values } = parseArgs({- args: process.argv.slice(2),- options: {- feature: { type: 'string' },- name: { type: 'string' },- lang: { type: 'string' },- help: { type: 'boolean' },- },- });-- if (values.help) {- showHelp();- process.exit(0);- }-- const { feature, name, lang } = values;-- if (!feature || !name || !lang) {- console.error('❌ Missing required arguments');- showHelp();- process.exit(1);- }-- createSnippet(feature, name, lang);-}--main();\ No newline at end of filediff --git a/fern/snippets/authentication/python/auth-config.py b/fern/snippets/authentication/python/auth-config.pydeleted file mode 100644index 63c88eecd..000000000--- a/fern/snippets/authentication/python/auth-config.py+++ /dev/null@@ -1,14 +0,0 @@-from composio import Composio--composio = Composio()--# Use custom auth-auth_config = composio.auth_configs.create(- toolkit="perplexityai",- options={- "type": "use_custom_auth",- "auth_scheme": "API_KEY",- "credentials": {}- },-)-print(auth_config)diff --git a/fern/snippets/authentication/python/connect-link.py b/fern/snippets/authentication/python/connect-link.pydeleted file mode 100644index d67c8dfc2..000000000--- a/fern/snippets/authentication/python/connect-link.py+++ /dev/null@@ -1,29 +0,0 @@-from composio import Composio--composio = Composio(api_key="your_api_key")--# Use the "AUTH CONFIG ID" from your dashboard-auth_config_id = "your_auth_config_id"--# Use a unique identifier for each user in your application-user_id = 'user-1349-129-12'--connection_request = composio.connected_accounts.link(- user_id=user_id,- auth_config_id=auth_config_id,- callback_url='https://your-app.com/callback'-)--redirect_url = connection_request.redirect_url-print(f"Visit: {redirect_url} to authenticate your account")--# Wait for the connection to be established-connected_account = connection_request.wait_for_connection()-print(connected_account.id)--# Alternative: Wait with custom timeout-# connected_account = connection_request.wait_for_connection(120) # 2 minute timeout--# Alternative: If you only have the connection request ID (e.g., stored in database)-# connection_id = connection_request.id # You can store this ID in your database-# connected_account = composio.connected_accounts.wait_for_connection(connection_id, 60)\ No newline at end of filediff --git a/fern/snippets/authentication/python/connected-accounts-management.py b/fern/snippets/authentication/python/connected-accounts-management.pydeleted file mode 100644index bd6b7589f..000000000--- a/fern/snippets/authentication/python/connected-accounts-management.py+++ /dev/null@@ -1,103 +0,0 @@-from composio import Composio--composio = Composio(api_key="YOUR_COMPOSIO_API_KEY")--# Define variables-user_id = "user-123"-auth_config_id = "auth-config-id"-connected_account_id = "conn_abc123"--# --- Listing Connected Accounts -----# List all accounts for a user-accounts = composio.connected_accounts.list(- user_ids=[user_id]-)--# Filter by status-active_accounts = composio.connected_accounts.list(- user_ids=[user_id],- statuses=["ACTIVE"]-)--# --- Retrieving a Specific Account -----account = composio.connected_accounts.get(connected_account_id)--print(f"Status: {account.status}")-print(f"Toolkit: {account.toolkit.slug}")--# --- Using Account Credentials -----# Get the connected account's authentication state-if account.state:- # The state contains the auth scheme and credentials- auth_scheme = account.state.auth_scheme- credentials = account.state.val-- print(f"Auth scheme: {auth_scheme}")- print(f"Credentials: {credentials}")--# --- Refreshing Credentials -----try:- refreshed = composio.connected_accounts.refresh(connected_account_id)- print(f"Redirect URL: {refreshed.redirect_url}")-- # Wait for the connection to be established- composio.connected_accounts.wait_for_connection(refreshed.id)-except Exception as e:- print(f"Failed to refresh tokens: {e}")--# --- Enabling and Disabling Accounts -----# Disable an account-disabled = composio.connected_accounts.disable(connected_account_id)-print(f"Account disabled status: {disabled.success}")--# Re-enable when needed-enabled = composio.connected_accounts.enable(connected_account_id)-print(f"Account enabled status: {enabled.success}")--# --- Deleting Accounts -----# Delete a connected account-composio.connected_accounts.delete(connected_account_id)-print("Account deleted successfully")--# --- Managing Multiple Accounts -----# First account-try:- first_account = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id- )- print(f"First account redirect URL: {first_account.redirect_url}")- connected_first_account = first_account.wait_for_connection()- print(f"First account status: {connected_first_account.status}")-except Exception as e:- print(f"Error initiating first account: {e}")--# Second account - must explicitly allow multiple-try:- second_account = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=auth_config_id,- allow_multiple=True # Required for additional accounts- )- print(f"Second account redirect URL: {second_account.redirect_url}")- connected_second_account = second_account.wait_for_connection()- print(f"Second account status: {connected_second_account.status}")-except Exception as e:- print(f"Error initiating second account: {e}")--# Execute tool with a specific connected account-result = composio.tools.execute(- "GMAIL_GET_PROFILE",- user_id=user_id,- connected_account_id=connected_account_id, # Specify which account to use- version="20251111_00",- arguments={}-)-print(f"Tool executed: {result}")\ No newline at end of filediff --git a/fern/snippets/authentication/python/define-scopes.py b/fern/snippets/authentication/python/define-scopes.pydeleted file mode 100644index 415231768..000000000--- a/fern/snippets/authentication/python/define-scopes.py+++ /dev/null@@ -1,17 +0,0 @@-from composio import Composio--composio = Composio()--response = composio.auth_configs.create(- toolkit="HUBSPOT",- options={- "name": "HubspotConfig",- "authScheme": "OAUTH2",- "type": "use_composio_managed_auth",- "credentials": {- "scopes": "sales-email-read,tickets"- }- }-)--print(response.id)\ No newline at end of filediff --git a/fern/snippets/authentication/typescript/auth-config.ts b/fern/snippets/authentication/typescript/auth-config.tsdeleted file mode 100644index e68b999d8..000000000--- a/fern/snippets/authentication/typescript/auth-config.ts+++ /dev/null@@ -1,12 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio();--const authConfig = await composio.authConfigs.create('PERPLEXITYAI', {- name: 'Perplexity AI',- type: 'use_custom_auth',- credentials: {},- authScheme: 'API_KEY',-});--console.log(authConfig);diff --git a/fern/snippets/authentication/typescript/connect-link.ts b/fern/snippets/authentication/typescript/connect-link.tsdeleted file mode 100644index 23c0a0dc9..000000000--- a/fern/snippets/authentication/typescript/connect-link.ts+++ /dev/null@@ -1,26 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio({apiKey: "your_api_key"});--// Use the "AUTH CONFIG ID" from your dashboard-const authConfigId = 'your_auth_config_id';--// Use a unique identifier for each user in your application-const userId = 'user-1349-129-12';--const connectionRequest = await composio.connectedAccounts.link(userId, authConfigId, {- callbackUrl: 'https://your-app.com/callback'-});-const redirectUrl = connectionRequest.redirectUrl;-console.log(`Visit: ${redirectUrl} to authenticate your account`);--// Wait for the connection to be established-const connectedAccount = await connectionRequest.waitForConnection();-console.log(connectedAccount.id);--// Alternative: Wait with custom timeout-// const connectedAccount = await connectionRequest.waitForConnection(120000); // 2 minutes--// Alternative: If you only have the connection request ID (e.g., stored in database)-// const connectionId = connectionRequest.id; // You can store this ID in your database-// const connectedAccount = await composio.connectedAccounts.waitForConnection(connectionId, 60000);\ No newline at end of filediff --git a/fern/snippets/authentication/typescript/connected-accounts-management.ts b/fern/snippets/authentication/typescript/connected-accounts-management.tsdeleted file mode 100644index 4ce01c65a..000000000--- a/fern/snippets/authentication/typescript/connected-accounts-management.ts+++ /dev/null@@ -1,108 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio({ apiKey: 'YOUR_COMPOSIO_API_KEY' });--// Define variables-const userId = 'user-123';-const authConfigId = 'auth-config-id';-const connectedAccountId = 'conn_abc123';--// --- Listing Connected Accounts -----// List all accounts for a user-const accounts = await composio.connectedAccounts.list({- userIds: [userId]-});--// Filter by status-const activeAccounts = await composio.connectedAccounts.list({- userIds: [userId],- statuses: ['ACTIVE']-});--// --- Retrieving a Specific Account -----const account = await composio.connectedAccounts.get(connectedAccountId);--console.log('Status:', account.status);-console.log('Toolkit:', account.toolkit.slug);--// --- Using Account Credentials -----// Get the connected account's authentication state-if (account.state) {- // The state contains the auth scheme and credentials- const authScheme = account.state.authScheme;- const credentials = account.state.val;-- console.log('Auth scheme:', authScheme);- console.log('Credentials:', credentials);-}--// --- Refreshing Credentials -----try {- const refreshed = await composio.connectedAccounts.refresh(connectedAccountId);- console.log('Redirect URL:', refreshed.redirect_url);-- // Wait for the connection to be established- await composio.connectedAccounts.waitForConnection(refreshed.id);-} catch (error) {- console.error('Failed to refresh tokens:', error);-}--// --- Enabling and Disabling Accounts -----// Disable an account-const disabled = await composio.connectedAccounts.disable(connectedAccountId);-console.log('Account disabled status:', disabled.success);--// Re-enable when needed-const enabled = await composio.connectedAccounts.enable(connectedAccountId);-console.log('Account enabled status:', enabled.success);--// --- Deleting Accounts -----// Delete a connected account-await composio.connectedAccounts.delete(connectedAccountId);-console.log('Account deleted successfully');--// --- Managing Multiple Accounts -----// First account-try {- const firstAccount = await composio.connectedAccounts.initiate(- userId,- authConfigId- );- console.log('First account redirect URL:', firstAccount.redirectUrl);- const connectedFirstAccount = await firstAccount.waitForConnection();- console.log('First account status:', connectedFirstAccount.status);-} catch (error) {- console.error('Error initiating first account:', error);-}--// Second account - must explicitly allow multiple-try {- const secondAccount = await composio.connectedAccounts.initiate(- userId,- authConfigId,- {- allowMultiple: true // Required for additional accounts- }- );- console.log('Second account redirect URL:', secondAccount.redirectUrl);- const connectedSecondAccount = await secondAccount.waitForConnection();- console.log('Second account status:', connectedSecondAccount.status);-} catch (error) {- console.error('Error initiating second account:', error);-}--// Execute tool with a specific connected account-const result = await composio.tools.execute('GMAIL_GET_PROFILE', {- userId: userId,- connectedAccountId: connectedAccountId, // Specify which account to use- version: '20251111_00',- arguments: {}-});-console.log('Tool executed:', result);\ No newline at end of filediff --git a/fern/snippets/authentication/typescript/define-scopes.ts b/fern/snippets/authentication/typescript/define-scopes.tsdeleted file mode 100644index 7fa57838f..000000000--- a/fern/snippets/authentication/typescript/define-scopes.ts+++ /dev/null@@ -1,13 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio();--const authConfig = await composio.authConfigs.create("HUBSPOT", {- name: "HubspotConfig",- type: "use_composio_managed_auth",- credentials: {- scopes: "sales-email-read,tickets",- },-});--console.log(authConfig);\ No newline at end of filediff --git a/fern/snippets/get-started/python/quickstart-openai-agents.py b/fern/snippets/get-started/python/quickstart-openai-agents.pydeleted file mode 100644index bfdbfaaec..000000000--- a/fern/snippets/get-started/python/quickstart-openai-agents.py+++ /dev/null@@ -1,45 +0,0 @@-import asyncio--from agents import Agent, Runner--from composio import Composio-from composio_openai_agents import OpenAIAgentsProvider--# Initialize Composio toolset-user_id = "[email protected]"-composio = Composio(provider=OpenAIAgentsProvider(), api_key="your-composio-api-key")--# Initialize connection request-connection_request = composio.toolkits.authorize(user_id=user_id, toolkit="github")-print(f"🔗 Visit the URL to authorize:\n👉 {connection_request.redirect_url}")--# wait for the connection to be active-connection_request.wait_for_connection()--# Get all the tools-tools = composio.tools.get(- user_id=user_id,- tools=["GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"],-)--# Create an agent with the tools-agent = Agent(- name="GitHub Agent",- instructions="You are a helpful assistant that helps users with GitHub tasks.",- tools=tools,-)---# Run the agent-async def main():- result = await Runner.run(- starting_agent=agent,- input=(- "Star the repository composiohq/composio on GitHub. If done "- "successfully, respond with 'Action executed successfully'"- ),- )- print(result.final_output)---asyncio.run(main())diff --git a/fern/snippets/get-started/python/quickstart.py b/fern/snippets/get-started/python/quickstart.pydeleted file mode 100644index 89d511ec9..000000000--- a/fern/snippets/get-started/python/quickstart.py+++ /dev/null@@ -1,46 +0,0 @@-import asyncio-from composio import Composio-from agents import Agent, Runner-from composio_openai_agents import OpenAIAgentsProvider--composio = Composio(api_key="your-api-key", provider=OpenAIAgentsProvider())--# Id of the user in your system-externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ad9ebc4"--# Create an auth config for gmail from the dashboard or programmatically-auth_config_id = "your-auth-config-id"-connection_request = composio.connected_accounts.link(- user_id=externalUserId,- auth_config_id=auth_config_id,-)--# Redirect user to the OAuth flow-redirect_url = connection_request.redirect_url--print(- f"Please authorize the app by visiting this URL: {redirect_url}"-) # Print the redirect url to the user--# Wait for the connection to be established-connected_account = connection_request.wait_for_connection()-print(- f"Connection established successfully! Connected account id: {connected_account.id}"-)--# Get Gmail tools that are pre-configured-tools = composio.tools.get(user_id=externalUserId, tools=["GMAIL_SEND_EMAIL"])--agent = Agent(- name="Email Manager", instructions="You are a helpful assistant", tools=tools-)--# Run the agent-async def main():- result = await Runner.run(- starting_agent=agent,- input="Send an email to [email protected] with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'",- )- print(result.final_output)--asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/get-started/typescript/quickstart.ts b/fern/snippets/get-started/typescript/quickstart.tsdeleted file mode 100644index 90964311d..000000000--- a/fern/snippets/get-started/typescript/quickstart.ts+++ /dev/null@@ -1,57 +0,0 @@-import { Composio } from "@composio/core";-import { AnthropicProvider } from "@composio/anthropic";-import Anthropic from "@anthropic-ai/sdk";--// env: ANTHROPIC_API_KEY-const anthropic = new Anthropic();--const composio = new Composio({- apiKey: "your-api-key",- provider: new AnthropicProvider(),- toolkitVersions: {- "gmail": "20251111_00",- }-});--// Id of the user in your system-const externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ad9ebc4";--// Create an auth config for gmail from the dashboard or programmatically-const authConfigId = "your-auth-config-id";--const connectionRequest = await composio.connectedAccounts.link(- externalUserId,- authConfigId-);--// redirect the user to the OAuth flow-const redirectUrl = connectionRequest.redirectUrl;-console.log(`Please authorize the app by visiting this URL: ${redirectUrl}`);--// wait for connection to be established-const connectedAccount = await connectionRequest.waitForConnection();-console.log(-`Connection established successfully! Connected account id: ${connectedAccount.id}`-);--// Fetch tools for your user and execute-const tools = await composio.tools.get(externalUserId, {- tools: ["GMAIL_SEND_EMAIL"],-});--console.log(tools);-const msg = await anthropic.messages.create({- model: "claude-sonnet-4-5",- messages: [- {- role: "user",- content: `Send an email to [email protected] with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'`,- },- ],- tools: tools,- max_tokens: 1000,-});---const res = await composio.provider.handleToolCalls(externalUserId, msg);-console.log("Email sent successfully!");diff --git a/fern/snippets/get-started/typescript/vercel-quickstart.ts b/fern/snippets/get-started/typescript/vercel-quickstart.tsdeleted file mode 100644index 864740718..000000000--- a/fern/snippets/get-started/typescript/vercel-quickstart.ts+++ /dev/null@@ -1,43 +0,0 @@-import { Composio } from "@composio/core";-import { VercelProvider } from "@composio/vercel";-import { generateText } from "ai";-import { openai } from "@ai-sdk/openai";--const composio = new Composio({- apiKey: "your-api-key",- provider: new VercelProvider(),-});--// Id of the user in your system-const externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ac9ebc4";--// Create an auth config for gmail from the dashboard or programmatically-const authConfigId = "your-auth-config-id";--const connectionRequest = await composio.connectedAccounts.link(- externalUserId,- authConfigId-);--// redirect the user to the OAuth flow-const redirectUrl = connectionRequest.redirectUrl;-console.log(`Please authorize the app by visiting this URL: ${redirectUrl}`);--// wait for connection to be established-const connectedAccount = await connectionRequest.waitForConnection();--const tools = await composio.tools.get(externalUserId, "GMAIL_SEND_EMAIL");--// env: OPENAI_API_KEY-const { text } = await generateText({- model: openai("gpt-5"),- messages: [- {- role: "user",- content: `Send an email to [email protected] with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'`,- },- ],- tools: tools // cast to `any` to fix type mismatch-});--console.log("Email sent successfully!", { text });\ No newline at end of filediff --git a/fern/snippets/mcp/python/anthropic-client.py b/fern/snippets/mcp/python/anthropic-client.pydeleted file mode 100644index e273a513f..000000000--- a/fern/snippets/mcp/python/anthropic-client.py+++ /dev/null@@ -1,26 +0,0 @@-from anthropic import Anthropic--# Initialize Anthropic client-client = Anthropic(api_key="your-anthropic-api-key")--# Use the MCP server URL you generated-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"--# Use MCP with Anthropic (beta feature)-response = client.beta.messages.create(- model="claude-sonnet-4-5",- system="You are a helpful assistant with access to various tools through MCP. Use these tools to help the user. Do not ask for confirmation before using the tools.",- max_tokens=1000,- messages=[{- "role": "user",- "content": "What meetings do I have tomorrow? Also check if I have any urgent emails"- }],- mcp_servers=[{- "type": "url",- "url": mcp_server_url,- "name": "composio-gmail-calendar-mcp-server"- }],- betas=["mcp-client-2025-04-04"] # Enable MCP beta-)--print(response.content)\ No newline at end of filediff --git a/fern/snippets/mcp/python/anthropic-provider.py b/fern/snippets/mcp/python/anthropic-provider.pydeleted file mode 100644index 0b278e486..000000000--- a/fern/snippets/mcp/python/anthropic-provider.py+++ /dev/null@@ -1,38 +0,0 @@-from anthropic import Anthropic-from composio import Composio--# Initialize clients-composio = Composio()-anthropic = Anthropic(api_key="your-anthropic-api-key")--# Create MCP server with GitHub and Linear tools-server = composio.mcp.create(- name="dev-workflow-server",- toolkits=[- {"toolkit": "github", "auth_config": "ac_github_id"},- {"toolkit": "linear", "auth_config": "ac_linear_id"}- ],- allowed_tools=["GITHUB_LIST_PRS", "GITHUB_CREATE_COMMENT", "LINEAR_CREATE_ISSUE"]-)--# Generate MCP instance for user-instance = server.generate("[email protected]")--# Use MCP with Anthropic to manage development workflow-response = anthropic.beta.messages.create(- model="claude-sonnet-4-5",- system="You are a helpful assistant with access to GitHub and Linear tools. Use these tools to help manage development workflows. Do not ask for confirmation before using the tools.",- max_tokens=1000,- messages=[{- "role": "user",- "content": "Check my GitHub PRs for review comments, create Linear tasks for any requested changes, and update the PR descriptions with task links"- }],- mcp_servers=[{- "type": "url",- "url": instance['url'],- "name": "composio-mcp-server"- }],- betas=["mcp-client-2025-04-04"] # Enable MCP beta-)--print(response.content)\ No newline at end of filediff --git a/fern/snippets/mcp/python/openai-client.py b/fern/snippets/mcp/python/openai-client.pydeleted file mode 100644index a30b635b3..000000000--- a/fern/snippets/mcp/python/openai-client.py+++ /dev/null@@ -1,24 +0,0 @@-from openai import OpenAI--# Initialize OpenAI client-client = OpenAI(api_key="your-openai-api-key")--# Use the MCP server URL you generated-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"--# Use MCP with OpenAI Responses API-response = client.responses.create(- model="gpt-5",- tools=[- {- "type": "mcp",- "server_label": "composio-server",- "server_description": "Composio MCP server for Gmail and Calendar integrations",- "server_url": mcp_server_url,- "require_approval": "never",- },- ],- input="What meetings do I have tomorrow? Also check if I have any urgent emails",-)--print("OpenAI MCP Response:", response.output_text)\ No newline at end of filediff --git a/fern/snippets/mcp/python/openai-provider.py b/fern/snippets/mcp/python/openai-provider.pydeleted file mode 100644index 4ea8b32f8..000000000--- a/fern/snippets/mcp/python/openai-provider.py+++ /dev/null@@ -1,36 +0,0 @@-from openai import OpenAI-from composio import Composio--# Initialize clients-composio = Composio()-openai = OpenAI(api_key="your-openai-api-key")--# Create MCP server with Google Sheets and Notion tools-server = composio.mcp.create(- name="data-docs-server",- toolkits=[- {"toolkit": "googlesheets", "auth_config": "ac_sheets_id"},- {"toolkit": "notion", "auth_config": "ac_notion_id"}- ],- allowed_tools=["GOOGLESHEETS_GET_DATA", "GOOGLESHEETS_UPDATE_DATA", "NOTION_CREATE_PAGE"]-)--# Generate MCP instance for user-instance = server.generate("[email protected]")--# Use MCP with OpenAI for data management-response = openai.responses.create(- model="gpt-5",- tools=[- {- "type": "mcp",- "server_label": "composio-server",- "server_description": "Composio MCP server with Google Sheets and Notion integrations",- "server_url": instance['url'],- "require_approval": "never",- },- ],- input="Export the Q4 metrics from Google Sheets and create a comprehensive Notion page with charts and analysis",-)--print("OpenAI MCP Response:", response.output_text)\ No newline at end of filediff --git a/fern/snippets/mcp/python/quickstart.py b/fern/snippets/mcp/python/quickstart.pydeleted file mode 100644index 88fd2a738..000000000--- a/fern/snippets/mcp/python/quickstart.py+++ /dev/null@@ -1,28 +0,0 @@-from composio import Composio--# Initialize Composio-composio = Composio(api_key="YOUR_API_KEY")--# Create MCP server with multiple toolkits-server = composio.mcp.create(- name="mcp-config-73840", # Pick a unique name for your MCP server- toolkits=[- {- "toolkit": "gmail",- "auth_config": "ac_xyz123" # Your Gmail auth config ID- },- {- "toolkit": "googlecalendar",- "auth_config": "ac_abc456" # Your Google Calendar auth config ID- }- ],- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]-)--print(f"Server created: {server.id}")-print(server.id)--# Generate server instance for user-instance = composio.mcp.generate(user_id="user-73840", mcp_config_id=server.id) # Use the user ID for which you created the connected account--print(f"MCP Server URL: {instance['url']}")\ No newline at end of filediff --git a/fern/snippets/mcp/typescript/anthropic-provider.ts b/fern/snippets/mcp/typescript/anthropic-provider.tsdeleted file mode 100644index 36ea228d9..000000000--- a/fern/snippets/mcp/typescript/anthropic-provider.ts+++ /dev/null@@ -1,41 +0,0 @@-import Anthropic from '@anthropic-ai/sdk';-import { Composio } from '@composio/core';--// Initialize clients-const composio = new Composio();-const anthropic = new Anthropic({- apiKey: process.env.ANTHROPIC_API_KEY,-});--// Create MCP server with Google Sheets tools-const server = await composio.mcp.create(- "analytics-server",- {- toolkits: [- { toolkit: "googlesheets", authConfigId: "ac_sheets_id" }- ],- allowedTools: ["GOOGLESHEETS_GET_DATA", "GOOGLESHEETS_UPDATE_DATA", "GOOGLESHEETS_CREATE_SHEET"]- }-);--// Generate MCP instance for user-const instance = await server.generate("[email protected]");--// Use MCP with Anthropic for spreadsheet operations-const response = await anthropic.beta.messages.create({- model: "claude-sonnet-4-5",- system: "You are a helpful assistant with access to Google Sheets tools. Use these tools to analyze and manage spreadsheet data. Do not ask for confirmation before using the tools.",- max_tokens: 1000,- messages: [{- role: "user",- content: "Analyze the sales data in my Google Sheets 'Q4 Revenue' spreadsheet, calculate month-over-month growth, and add a new summary sheet with visualizations"- }],- mcp_servers: [{- type: "url",- url: instance.url,- name: "composio-mcp-server"- }],- betas: ["mcp-client-2025-04-04"] // Enable MCP beta-});--console.log(response.content);\ No newline at end of filediff --git a/fern/snippets/mcp/typescript/mastra-client.ts b/fern/snippets/mcp/typescript/mastra-client.tsdeleted file mode 100644index e333d5543..000000000--- a/fern/snippets/mcp/typescript/mastra-client.ts+++ /dev/null@@ -1,26 +0,0 @@-import { MCPClient } from "@mastra/mcp";-import { openai } from "@ai-sdk/openai";-import { Agent } from "@mastra/core/agent";--// Use the MCP server URL you generated-const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID";--export const client = new MCPClient({- id: "docs-mcp-client",- servers: {- composio: { url: new URL(MCP_URL) },- }-});--export const agent = new Agent({- name: "Assistant",- description: "Helpful AI with MCP tools",- instructions: "Use the MCP tools to answer.",- model: openai("gpt-4-turbo"),- tools: await client.getTools()-});--(async () => {- const res = await agent.generate("What meetings do I have tomorrow? Also check if I have any urgent emails");- console.log(res.text);-})();\ No newline at end of filediff --git a/fern/snippets/mcp/typescript/mastra-provider.ts b/fern/snippets/mcp/typescript/mastra-provider.tsdeleted file mode 100644index 93906105a..000000000--- a/fern/snippets/mcp/typescript/mastra-provider.ts+++ /dev/null@@ -1,52 +0,0 @@-import { MCPClient } from "@mastra/mcp";-import { openai } from "@ai-sdk/openai";-import { Agent } from "@mastra/core/agent";-import { Composio } from "@composio/core";--// Initialize Composio-const composio = new Composio();--// Create MCP server with GitHub, Linear, and Notion tools-const server = await composio.mcp.create(- "dev-automation-server",- {- toolkits: [- { toolkit: "github", authConfigId: "ac_github_id" },- { toolkit: "linear", authConfigId: "ac_linear_id" },- { toolkit: "notion", authConfigId: "ac_notion_id" }- ],- allowedTools: [- "GITHUB_LIST_ISSUES", "GITHUB_CREATE_ISSUE",- "LINEAR_CREATE_ISSUE", "LINEAR_UPDATE_ISSUE",- "NOTION_CREATE_PAGE", "NOTION_UPDATE_PAGE"- ]- }-);--// Generate MCP instance for user-const instance = await server.generate("[email protected]");--// Create MCP client with Composio server-export const mcpClient = new MCPClient({- id: "composio-mcp-client",- servers: {- composio: { url: new URL(instance.url) },- }-});--// Create a development workflow agent-export const devAgent = new Agent({- name: "Dev Assistant",- description: "AI assistant for development workflow automation",- instructions: "Help manage GitHub repos, Linear issues, and Notion documentation.",- model: openai("gpt-4-turbo"),- tools: await mcpClient.getTools()-});--// Example: Automate development workflow-(async () => {- const response = await devAgent.generate(- "Review open GitHub issues, create Linear tasks for bugs labeled 'priority', and update the Notion roadmap page"- );- console.log(response.text);-})();\ No newline at end of filediff --git a/fern/snippets/mcp/typescript/openai-provider.ts b/fern/snippets/mcp/typescript/openai-provider.tsdeleted file mode 100644index 5addfc5d8..000000000--- a/fern/snippets/mcp/typescript/openai-provider.ts+++ /dev/null@@ -1,40 +0,0 @@-import OpenAI from 'openai';-import { Composio } from '@composio/core';--// Initialize clients-const composio = new Composio();-const openai = new OpenAI({- apiKey: process.env.OPENAI_API_KEY,-});--// Create MCP server with Linear and Notion tools-const server = await composio.mcp.create(- "project-docs-server",- {- toolkits: [- { toolkit: "linear", authConfigId: "ac_linear_id" },- { toolkit: "notion", authConfigId: "ac_notion_id" }- ],- allowedTools: ["LINEAR_LIST_ISSUES", "LINEAR_GET_ISSUE", "NOTION_CREATE_PAGE"]- }-);--// Generate MCP instance for user-const instance = await server.generate("[email protected]");--// Use MCP with OpenAI for project documentation-const response = await openai.responses.create({- model: "gpt-5",- tools: [- {- type: "mcp",- server_label: "composio-server",- server_description: "Composio MCP server with Linear and Notion integrations",- server_url: instance.url,- require_approval: "never",- },- ],- input: "Find all completed Linear issues from this sprint and create a Notion page documenting the release notes",-});--console.log("OpenAI MCP Response:", response.output_text);\ No newline at end of filediff --git a/fern/snippets/mcp/typescript/quickstart.ts b/fern/snippets/mcp/typescript/quickstart.tsdeleted file mode 100644index 27cb4706f..000000000--- a/fern/snippets/mcp/typescript/quickstart.ts+++ /dev/null@@ -1,29 +0,0 @@-import { Composio } from '@composio/core';--// Initialize Composio-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY-});--// Create MCP server with multiple toolkits-const server = await composio.mcp.create("mcp-config-73840", { // Pick a unique name for your MCP server- toolkits: [- {- authConfigId: "ac_xyz123", // Your Gmail auth config ID- toolkit: "gmail"- },- {- authConfigId: "ac_abc456", // Your Google Calendar auth config ID- toolkit: "googlecalendar"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]-});--console.log(`Server created: ${server.id}`);-console.log(server.id);--// Generate server instance for user-const instance = await composio.mcp.generate("user-73840", server.id); // Use the user ID for which you created the connected account--console.log("MCP Server URL:", instance.url);\ No newline at end of filediff --git a/fern/snippets/migration/new_auth_config.py b/fern/snippets/migration/new_auth_config.pydeleted file mode 100644index 851577f03..000000000--- a/fern/snippets/migration/new_auth_config.py+++ /dev/null@@ -1,19 +0,0 @@-from composio import Composio--composio = Composio()--# Use composio managed auth-auth_config = composio.auth_configs.create(- toolkit="notion",- options={- "type": "use_composio_managed_auth",- # "type": "use_custom_auth",- # "auth_scheme": "OAUTH2",- # "credentials": {- # "client_id": "1234567890",- # "client_secret": "1234567890",- # "oauth_redirect_uri": "https://backend.composio.dev/api/v3/toolkits/auth/callback",- # },- },-)-print(auth_config)diff --git a/fern/snippets/migration/new_auth_config.ts b/fern/snippets/migration/new_auth_config.tsdeleted file mode 100644index e43c72920..000000000--- a/fern/snippets/migration/new_auth_config.ts+++ /dev/null@@ -1,16 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio();--const authConfig = await composio.authConfigs.create('LINEAR', {- name: 'Linear',- type: 'use_composio_managed_auth',- // type: "use_custom_auth",- // credentials: {- // client_id: "1234567890",- // client_secret: "1234567890",- // oauth_redirect_uri: "https://backend.composio.dev/api/v3/toolkits/auth/callback",- // },-});--console.log(authConfig);diff --git a/fern/snippets/migration/new_connected_acc.py b/fern/snippets/migration/new_connected_acc.pydeleted file mode 100644index 1490215c5..000000000--- a/fern/snippets/migration/new_connected_acc.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--linear_auth_config_id = "ac_1234"-user_id = "[email protected]"-composio = Composio()--# Create a new connected account-connection_request = composio.connected_accounts.initiate(- user_id=user_id,- auth_config_id=linear_auth_config_id,-)-print(connection_request.redirect_url)--# Wait for the connection to be established-connected_account = connection_request.wait_for_connection()-print(connected_account)diff --git a/fern/snippets/migration/new_connected_acc.ts b/fern/snippets/migration/new_connected_acc.tsdeleted file mode 100644index e184cb939..000000000--- a/fern/snippets/migration/new_connected_acc.ts+++ /dev/null@@ -1,18 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio();-const linearAuthConfigId = "ac_1234";-const userId = "[email protected]";--// Initiate the OAuth connection request-const connRequest = await composio.connectedAccounts.initiate(userId, linearAuthConfigId);--const { redirectUrl, id } = connRequest;-console.log(redirectUrl);--// Wait for the connection to be established-await connRequest.waitForConnection();--// If you only have the connection request ID, you can also wait using:-await composio.connectedAccounts.waitForConnection(id);-diff --git a/fern/snippets/migration/new_custom_tools.py b/fern/snippets/migration/new_custom_tools.pydeleted file mode 100644index 9b3c25571..000000000--- a/fern/snippets/migration/new_custom_tools.py+++ /dev/null@@ -1,38 +0,0 @@-from pydantic import BaseModel, Field-from composio import Composio-from composio.core.models.custom_tools import ExecuteRequestFn---composio = Composio()--class GetIssueInfoInput(BaseModel):- issue_number: int = Field(- ...,- description="The number of the issue to get information about",- )--# function name will be used as slug[email protected]_tool(toolkit="github")-def get_issue_info(- request: GetIssueInfoInput,- execute_request: ExecuteRequestFn,- auth_credentials: dict,-) -> dict:- """Get information about a GitHub issue."""- response = execute_request(- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",- method="GET",- parameters=[- {- "name": "Accept",- "value": "application/vnd.github.v3+json",- "type": "header",- },- {- "name": "Authorization",- "value": f"Bearer {auth_credentials['access_token']}",- "type": "header",- },- ],- )- return {"data": response.data}diff --git a/fern/snippets/migration/new_custom_tools.ts b/fern/snippets/migration/new_custom_tools.tsdeleted file mode 100644index 43254367b..000000000--- a/fern/snippets/migration/new_custom_tools.ts+++ /dev/null@@ -1,37 +0,0 @@-import { Composio } from "@composio/core";-import z from "zod";--const composio = new Composio();--const tool = await composio.tools.createCustomTool({- slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',- name: 'Github star composio repositories',- toolkitSlug: 'github',- description: 'Star any specificied repo of `composiohq` user',- inputParams: z.object({- repository: z.string().describe('The repository to star'),- page: z.number().optional().describe('Pagination page number'),- customHeader: z.string().optional().describe('Custom header'),- }),- execute: async (input, connectionConfig, executeToolRequest) => {- const result = await executeToolRequest({- endpoint: `/user/starred/composiohq/${input.repository}`,- method: 'PUT',- body: {},- parameters: [- {- name: 'page',- value: input.page?.toString() || '1',- in: 'query',- },- {- name: 'x-custom-header',- value: input.customHeader || 'default-value',- in: 'header',- },- ],- });- return result;- },- });-\ No newline at end of filediff --git a/fern/snippets/migration/new_execute_tools.py b/fern/snippets/migration/new_execute_tools.pydeleted file mode 100644index 3f73dd0ff..000000000--- a/fern/snippets/migration/new_execute_tools.py+++ /dev/null@@ -1,15 +0,0 @@-from composio import Composio-from openai import OpenAI--openai_client = OpenAI()-composio = Composio()--tools = composio.tools.get(user_id="[email protected]", tools=["GITHUB_GET_THE_ZEN_OF_GITHUB"])-response = openai_client.chat.completions.create(- model="gpt-4.1",- messages=[{"role": "user", "content": "gimme some zen."}],- tools=tools,-)--result = composio.provider.handle_tool_calls(user_id="[email protected]", response=response)-print(result)diff --git a/fern/snippets/migration/new_execute_tools.ts b/fern/snippets/migration/new_execute_tools.tsdeleted file mode 100644index 84ed4c2be..000000000--- a/fern/snippets/migration/new_execute_tools.ts+++ /dev/null@@ -1,28 +0,0 @@-import { Composio } from '@composio/core';-import { AnthropicProvider } from '@composio/anthropic';-import Anthropic from '@anthropic-ai/sdk';--const anthropic = new Anthropic();-const composio = new Composio({- provider: new AnthropicProvider(),-});--const userId = '[email protected]';-const tools = await composio.tools.get(userId, {- toolkits: ['GMAIL'],-});--const msg = await anthropic.messages.create({- model: 'claude-3-7-sonnet-latest',- tools: tools,- messages: [- {- role: 'user',- content: "Say hi to '[email protected]'",- },- ],- max_tokens: 1024,-});--const result = await composio.provider.handleToolCalls(userId, msg);-console.log('✅ Tool results:', result);diff --git a/fern/snippets/migration/new_tools.py b/fern/snippets/migration/new_tools.pydeleted file mode 100644index b3d0ced25..000000000--- a/fern/snippets/migration/new_tools.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--composio = Composio()--user_id = "[email protected]"--tools_1 = composio.tools.get(user_id=user_id, toolkits=["GITHUB", "LINEAR"])--tools_2 = composio.tools.get(user_id=user_id, toolkits=["SLACK"], limit=5) # Default limit=20--tools_3 = composio.tools.get(- user_id=user_id,- tools=["GITHUB_CREATE_AN_ISSUE", "GITHUB_CREATE_AN_ISSUE_COMMENT", "GITHUB_CREATE_A_COMMIT"],-)--tools_4 = composio.tools.get(user_id="john", search="hackernews posts")diff --git a/fern/snippets/migration/new_tools.ts b/fern/snippets/migration/new_tools.tsdeleted file mode 100644index ec33abc43..000000000--- a/fern/snippets/migration/new_tools.ts+++ /dev/null@@ -1,22 +0,0 @@-import { Composio } from '@composio/core';--const userId = '[email protected]';--const composio = new Composio();--const tools_1 = await composio.tools.get(userId, {- toolkits: ['GITHUB', 'LINEAR'],-});--const tools_2 = await composio.tools.get(userId, {- toolkits: ['GITHUB'],- limit: 5, // Default limit=20-});--const tools_3 = await composio.tools.get(userId, {- tools: ['GITHUB_CREATE_AN_ISSUE', 'GITHUB_CREATE_AN_ISSUE_COMMENT', 'GITHUB_CREATE_A_COMMIT'],-});--const tools_4 = await composio.tools.get(userId, {- search: 'hackernews posts',-});diff --git a/fern/snippets/migration/new_triggers.py b/fern/snippets/migration/new_triggers.pydeleted file mode 100644index ac47a1df7..000000000--- a/fern/snippets/migration/new_triggers.py+++ /dev/null@@ -1,36 +0,0 @@-from composio import Composio--composio = Composio()--user_id = "[email protected]"-trigger_config = composio.triggers.get_type("GITHUB_COMMIT_EVENT")-print(trigger_config.config)-### Trigger Config-# {-# "properties": {-# "owner": {-# "description": "Owner of the repository",-# "title": "Owner",-# "type": "string"-# },-# "repo": {-# "description": "Repository name",-# "title": "Repo",-# "type": "string"-# }-# },-# "required": ["owner", "repo"],-# "title": "WebhookConfigSchema",-# "type": "object"--trigger = composio.triggers.create(- slug="GITHUB_COMMIT_EVENT",- user_id=user_id,- trigger_config={"repo": "composiohq", "owner": "composio"},-)-print(trigger)---# Managing triggers--composio.triggers.enable(id="ti_abcd123")\ No newline at end of filediff --git a/fern/snippets/migration/new_triggers.ts b/fern/snippets/migration/new_triggers.tsdeleted file mode 100644index 29afa5389..000000000--- a/fern/snippets/migration/new_triggers.ts+++ /dev/null@@ -1,35 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio();--const userId = '[email protected]';-// Fetch the trigger details-const triggerType = await composio.triggers.getType('GITHUB_COMMIT_EVENT');-console.log(JSON.stringify(triggerType.config, null, 2));-/*--- Trigger config ----{- "properties": {- "owner": {- "description": "Owner of the repository",- "title": "Owner",- "type": "string"- },- "repo": {- "description": "Repository name",- "title": "Repo",- "type": "string"- }- },- "required": ["owner", "repo"],- "title": "WebhookConfigSchema",- "type": "object"-}-*/--const createResponse = await composio.triggers.create(userId, 'GITHUB_COMMIT_EVENT', {- triggerConfig: {- owner: 'composiohq',- repo: 'composio',- },-});-console.log(createResponse);\ No newline at end of filediff --git a/fern/snippets/migration/old_auth_config.py b/fern/snippets/migration/old_auth_config.pydeleted file mode 100644index 0836d3e6c..000000000--- a/fern/snippets/migration/old_auth_config.py+++ /dev/null@@ -1,16 +0,0 @@-from composio_openai import App, ComposioToolSet--toolset = ComposioToolSet()--integration = toolset.create_integration(- app=App.GITHUB,- auth_mode="OAUTH2",- use_composio_oauth_app=True,- # For use_composio_oauth_app=False, you can provide your own OAuth app credentials here- # auth_config={- # "client_id": "123456",- # "client_secret": "123456"- # }--)-print(integration.id)\ No newline at end of filediff --git a/fern/snippets/migration/old_auth_config.ts b/fern/snippets/migration/old_auth_config.tsdeleted file mode 100644index ee20fc821..000000000--- a/fern/snippets/migration/old_auth_config.ts+++ /dev/null@@ -1,18 +0,0 @@-import { OpenAIToolSet } from "composio-core";--const composioToolset = new OpenAIToolSet();--const integration = await composioToolset.integrations.create({- name: "gmail_integration",- appUniqueKey: "gmail",- forceNewIntegration: true,- useComposioAuth: false,- // For useComposioAuth: false, you can provide your own OAuth app credentials here- // authScheme: "OAUTH2",- // authConfig: {- // clientId: "123456",- // clientSecret: "123456"- // }-})--console.log(integration.id)diff --git a/fern/snippets/migration/old_connected_acc.py b/fern/snippets/migration/old_connected_acc.pydeleted file mode 100644index 8ec0b5d03..000000000--- a/fern/snippets/migration/old_connected_acc.py+++ /dev/null@@ -1,26 +0,0 @@-from composio_openai import ComposioToolSet--toolset = ComposioToolSet()-user_id = "your_user_unique_id"-google_integration_id = "0000-0000"--entity = toolset.get_entity(id=user_id)--try:- print(f"Initiating OAuth connection for entity {entity.id}...")- connection_request = toolset.initiate_connection(- integration_id=google_integration_id,- entity_id=user_id,- # Optionally add: redirect_url="https://yourapp.com/final-destination"- # if you want user sent somewhere specific *after* Composio finishes.- )-- # Check if a redirect URL was provided (expected for OAuth)- if connection_request.redirectUrl:- print(f"Received redirect URL: {connection_request.redirectUrl}")- else:- print("Error: Expected a redirectUrl for OAuth flow but didn't receive one.")---except Exception as e:- print(f"Error initiating connection: {e}")diff --git a/fern/snippets/migration/old_connected_acc.ts b/fern/snippets/migration/old_connected_acc.tsdeleted file mode 100644index 55c969008..000000000--- a/fern/snippets/migration/old_connected_acc.ts+++ /dev/null@@ -1,22 +0,0 @@-import { OpenAIToolSet } from "composio-core";--const toolset = new OpenAIToolSet();-const userId = "your_user_unique_id";-const googleIntegrationId = "0000-0000";--console.log(`Initiating OAuth connection for entity ${userId}...`);-const connectionRequest = await toolset.connectedAccounts.initiate({- integrationId: googleIntegrationId,- entityId: userId,- // Optionally add: redirectUri: "https://yourapp.com/final-destination"- // if you want user sent somewhere specific *after* Composio finishes.-});--// Check if a redirect URL was provided (expected for OAuth)-if (connectionRequest?.redirectUrl) {- console.log(`Received redirect URL: ${connectionRequest.redirectUrl}`);- // Proceed to Step 2: Redirect the user- // Return or pass connectionRequest to the next stage-} else {- console.error("Error: Expected a redirectUrl for OAuth flow but didn't receive one.");-}diff --git a/fern/snippets/migration/old_custom_tools.py b/fern/snippets/migration/old_custom_tools.pydeleted file mode 100644index 39fbfd68c..000000000--- a/fern/snippets/migration/old_custom_tools.py+++ /dev/null@@ -1,19 +0,0 @@-# Python Example using execute_request-from composio import action, ComposioToolSet-import typing as t--toolset = ComposioToolSet()--@action(toolname="github") # Associate with GitHub app for auth-def get_github_repo_topics(- owner: t.Annotated[str, "Repository owner username"],- repo: t.Annotated[str, "Repository name"],- execute_request: t.Callable # Injected by Composio-) -> dict:- """Gets the topics associated with a specific GitHub repository."""- response_data = execute_request(- endpoint=f"/repos/{owner}/{repo}/topics", # API path relative to base URL- method="GET"- )- if isinstance(response_data, dict):- return {"topics": response_data.get("names", [])}\ No newline at end of filediff --git a/fern/snippets/migration/old_custom_tools.ts b/fern/snippets/migration/old_custom_tools.tsdeleted file mode 100644index 8b5fed4a5..000000000--- a/fern/snippets/migration/old_custom_tools.ts+++ /dev/null@@ -1,25 +0,0 @@-import { OpenAIToolSet, type ActionExecutionResDto } from "composio-core";-import { z } from "zod";--const toolset = new OpenAIToolSet();--await toolset.createAction({- actionName: "get_github_repo_topics",- toolName: "github",- description: "Gets the topics associated with a specific GitHub repository.",- inputParams: z.object({- owner: z.string().describe("Repository owner username"),- repo: z.string().describe("Repository name"),- }),- callback: async (inputParams, _authCredentials, executeRequest): Promise<ActionExecutionResDto> => {- const { owner, repo } = inputParams as { owner: string, repo: string };- const response = await executeRequest({- endpoint: `/repos/${owner}/${repo}/topics`,- method: "GET",- parameters: [],- });-- const topics = (response as any)?.names ?? [];- return { successful: true, data: { topics: topics } };- }-});\ No newline at end of filediff --git a/fern/snippets/migration/old_tool_modifiers.py b/fern/snippets/migration/old_tool_modifiers.pydeleted file mode 100644index 0fb6c8e13..000000000--- a/fern/snippets/migration/old_tool_modifiers.py+++ /dev/null@@ -1,22 +0,0 @@-from composio_openai import ComposioToolSet, Action--toolset = ComposioToolSet()---def my_schema_processor(schema: dict) -> dict: ...-def my_preprocessor(inputs: dict) -> dict: ...-def my_postprocessor(result: dict) -> dict: ...---# Get tools with the modified schema-processed_tools = toolset.get_tools(- actions=[Action.GMAIL_SEND_EMAIL],- processors={- # Applied BEFORE the LLM sees the schema- "schema": {Action.SOME_ACTION: my_schema_processor},- # Applied BEFORE the tool executes- "pre": {Action.SOME_ACTION: my_preprocessor},- # Applied AFTER the tool executes, BEFORE the result is returned- "post": {Action.SOME_ACTION: my_postprocessor},- },-)\ No newline at end of filediff --git a/fern/snippets/migration/old_tools.py b/fern/snippets/migration/old_tools.pydeleted file mode 100644index f6fb6d277..000000000--- a/fern/snippets/migration/old_tools.py+++ /dev/null@@ -1,21 +0,0 @@-from composio_openai import ComposioToolSet, Action, App-from openai import OpenAI--toolset = ComposioToolSet()-client = OpenAI()--tools = toolset.get_tools(- actions=[Action.GITHUB_GET_THE_AUTHENTICATED_USER], check_connected_accounts=True-)--tools = toolset.get_tools(apps=[App.GITHUB, App.LINEAR, App.SLACK], check_connected_accounts=True)--messages = [...]-response = client.chat.completions.create(- model="gpt-4o-mini",- messages=messages,- tools=tools,-)--result = toolset.handle_tool_calls(response)-print(result)diff --git a/fern/snippets/migration/old_tools.ts b/fern/snippets/migration/old_tools.tsdeleted file mode 100644index 3a6ee975c..000000000--- a/fern/snippets/migration/old_tools.ts+++ /dev/null@@ -1,8 +0,0 @@-import { OpenAIToolSet } from 'composio-core';--const toolset = new OpenAIToolSet();--const tools_1 = await toolset.getTools({ apps: ['GITHUB'] });-const tools_2 = await toolset.getTools({- actions: ['GITHUB_GET_THE_AUTHENTICATED_USER', 'LINEAR_CREATE_LINEAR_ISSUE'],-});diff --git a/fern/snippets/migration/providers.py b/fern/snippets/migration/providers.pydeleted file mode 100644index 713b6b8f8..000000000--- a/fern/snippets/migration/providers.py+++ /dev/null@@ -1,11 +0,0 @@-from composio import Composio-# from composio_langchain import LangchainProvider--composio = Composio()-# composio = Composio(provider=LangchainProvider())--tools = composio.tools.get(- user_id="0001",- tools=["LINEAR_CREATE_LINEAR_ISSUE", "GITHUB_CREATE_COMMIT"]-)-# tools returned is formatted for the provider. by default, OpenAI.diff --git a/fern/snippets/migration/providers.ts b/fern/snippets/migration/providers.tsdeleted file mode 100644index a520f8447..000000000--- a/fern/snippets/migration/providers.ts+++ /dev/null@@ -1,12 +0,0 @@-import { Composio } from '@composio/core';-// import { VercelProvider } from '@composio/vercel';--const composio = new Composio({- // provider: new VercelProvider(),-});-// Can specify other providers too, like OpenAI, Anthropic, Vercel AI SDK.--const tools = await composio.tools.get('[email protected]', {- tools: ['LINEAR_CREATE_LINEAR_ISSUE', 'GITHUB_CREATE_COMMIT'],-});-// tools returned is formatted for the provider. by default, OpenAI.\ No newline at end of filediff --git a/fern/snippets/migration/pyproject.toml b/fern/snippets/migration/pyproject.tomldeleted file mode 100644index ec55527e0..000000000--- a/fern/snippets/migration/pyproject.toml+++ /dev/null@@ -1,9 +0,0 @@-[project]-name = "migration"-version = "0.1.0"-description = "Add your description here"-readme = "README.md"-requires-python = ">=3.12"-dependencies = [- "composio",-]diff --git a/fern/snippets/migration/tool_modifiers.ts b/fern/snippets/migration/tool_modifiers.tsdeleted file mode 100644index a6b9a9a5b..000000000--- a/fern/snippets/migration/tool_modifiers.ts+++ /dev/null@@ -1,91 +0,0 @@-import { Composio } from '@composio/core';-import { OpenAI } from 'openai';--const userId = '[email protected]';-const composio = new Composio();--// Schema modifier to delete the `page` argument from the `HACKERNEWS_GET_LATEST_POSTS` tool-const tools = await composio.tools.get(- userId,- {- tools: ['HACKERNEWS_GET_LATEST_POSTS', 'HACKERNEWS_GET_USER'],- },- {- modifySchema: ({ toolSlug, toolkitSlug, schema }) => {- if (toolSlug === 'HACKERNEWS_GET_LATEST_POSTS') {- const { inputParameters } = schema;- if (inputParameters?.properties) {- delete inputParameters.properties['page'];- }- inputParameters.required = ['size'];- }- return schema;- },- }-);--console.log(JSON.stringify(tools, null, 2));--const openai = new OpenAI();--const messages = [- {- role: 'user',- content: 'What are the latest posts on Hacker News?',- },-];--const response = await openai.chat.completions.create({- model: 'gpt-4o-mini',- messages,- tools,- tool_choice: 'auto',-});--const { tool_calls } = response.choices[0].message;-console.log(tool_calls);--if (tool_calls) {- const {- function: { arguments: toolArgs },- } = tool_calls[0];-- const result_1 = await composio.tools.execute(- 'HACKERNEWS_GET_LATEST_POSTS',- {- userId,- arguments: JSON.parse(toolArgs),- },- {- beforeExecute: ({ toolSlug, toolkitSlug, params }) => {- if (toolSlug === 'HACKERNEWS_GET_LATEST_POSTS') {- params.arguments.size = 1;- }- console.log(params);- return params;- },- }- );- const result_2 = await composio.tools.execute(- 'HACKERNEWS_GET_USER',- {- userId,- arguments: JSON.parse(toolArgs),- },- {- afterExecute: ({ toolSlug, toolkitSlug, result }) => {- if (toolSlug === 'HACKERNEWS_GET_USER') {- const { data } = result;- const { karma } = data.response_data as { karma: number };- return {- ...result,- data: { karma },- };- }- return result;- },- }- );-- console.log(JSON.stringify(result, null, 2));-}diff --git a/fern/snippets/modifiers/python/description.py b/fern/snippets/modifiers/python/description.pydeleted file mode 100644index fce5b6198..000000000--- a/fern/snippets/modifiers/python/description.py+++ /dev/null@@ -1,43 +0,0 @@-from composio import Composio, schema_modifier-from composio.types import Tool-from composio_google import GoogleProvider-from google import genai-from google.genai import types-from uuid import uuid4--composio = Composio(provider=GoogleProvider())-client = genai.Client()-user_id = uuid4() # User ID from DB/App---@schema_modifier(tools=["GITHUB_LIST_REPOSITORY_ISSUES"])-def append_repository(- tool: str,- toolkit: str,- schema: Tool,-) -> Tool:- schema.description += " When not specified, use the `composiohq/composio` repository"- return schema---tools = composio.tools.get(- user_id=user_id, tools=["GITHUB_LIST_REPOSITORY_ISSUES"], modifiers=[append_repository]-)--print(tools)--model = "gemini-2.5-pro"-config = types.GenerateContentConfig(- temperature=1.5,- system_instruction="You're a GitHub Taskmaster. Help me with managing my GitHub",- max_output_tokens=65536,- top_p=0.95,- tools=tools,-)---response = client.models.generate_content(- model=model, config=config, contents=["What are some issues on my GitHub repo?"]-)--print(response.text)diff --git a/fern/snippets/modifiers/typescript/description.ts b/fern/snippets/modifiers/typescript/description.tsdeleted file mode 100644index 36bce2640..000000000--- a/fern/snippets/modifiers/typescript/description.ts+++ /dev/null@@ -1,44 +0,0 @@-import { Composio } from '@composio/core';-import { generateText } from 'ai';-import { anthropic } from '@ai-sdk/anthropic';-import { VercelProvider } from '@composio/vercel';-import { v4 as uuidv4 } from 'uuid';--const userId = uuidv4(); // The user's ID.-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--const addDescription = ({ toolSlug, toolkitSlug, schema }) => {- if (toolSlug === 'GITHUB_LIST_REPOSITORY_ISSUES') {- schema.description += 'If not specified, use the `composiohq/composio` repository';- }- return schema;-};--const tools = await composio.tools.get(- userId,- {- tools: ['GITHUB_LIST_REPOSITORY_ISSUES'],- },- {- modifySchema: addDescription,- }-);--console.log(tools);--// const { text } = await generateText({-// model: anthropic('claude-4-sonnet'),-// messages: [-// {-// role: 'user',-// content: 'What are some issues on my GitHub repo?',-// },-// ],-// tools,-// maxSteps: 3,-// });--// console.log(text);diff --git a/fern/snippets/providers/python/google.py b/fern/snippets/providers/python/google.pydeleted file mode 100644index 1e2a42721..000000000--- a/fern/snippets/providers/python/google.py+++ /dev/null@@ -1,20 +0,0 @@-from composio import Composio-from composio_gemini import GeminiProvider-from google import genai-from google.genai import types--# Create composio client-composio = Composio(provider=GeminiProvider())-# Create google client-client = genai.Client()--user_id = "0000-1111-2222"-tools = composio.tools.get(user_id, tools=["COMPOSIO_SEARCH_DUCK_DUCK_GO_SEARCH"])--# Create genai client config-config = types.GenerateContentConfig(tools=tools)--# # Use the chat interface.-chat = client.chats.create(model="gemini-2.0-flash", config=config)-response = chat.send_message("search about the latest info on windsurf acquisition.")-print(response.text)diff --git a/fern/snippets/providers/python/langchain-provider.py b/fern/snippets/providers/python/langchain-provider.pydeleted file mode 100644index 82342795d..000000000--- a/fern/snippets/providers/python/langchain-provider.py+++ /dev/null@@ -1,26 +0,0 @@-from composio import Composio-from composio_langchain import LangchainProvider-from langchain import hub # type: ignore-from langchain.agents import AgentExecutor, create_openai_functions_agent-from langchain_openai import ChatOpenAI--# Pull relevant agent model.-prompt = hub.pull("hwchase17/openai-functions-agent")--# Initialize tools.-openai_client = ChatOpenAI(model="gpt-5")--composio = Composio(provider=LangchainProvider())--# Get All the tools-tools = composio.tools.get(user_id="default", toolkits=["GITHUB"])--# Define task-task = "Star a repo composiohq/composio on GitHub"--# Define agent-agent = create_openai_functions_agent(openai_client, tools, prompt)-agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)--# Execute using agent_executor-agent_executor.invoke({"input": task})diff --git a/fern/snippets/providers/python/llamaindex-provider.py b/fern/snippets/providers/python/llamaindex-provider.pydeleted file mode 100644index f41e4a3ba..000000000--- a/fern/snippets/providers/python/llamaindex-provider.py+++ /dev/null@@ -1,36 +0,0 @@-import asyncio-import dotenv-from composio_llamaindex import LlamaIndexProvider-from llama_index.core.agent.workflow import FunctionAgent-from llama_index.llms.openai import OpenAI--from composio import Composio--# Load environment variables from .env-dotenv.load_dotenv()--# Setup client-llm = OpenAI(model="gpt-5")-composio = Composio(provider=LlamaIndexProvider())--tools = composio.tools.get(- user_id="[email protected]",- tools=["GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"],-)--workflow = FunctionAgent(- tools=tools,- llm=llm,- system_prompt="You are an agent that performs github actions.",-)---async def main():- result = await workflow.run(- user_msg="Hello! I would like to star a repo composiohq/composio on GitHub"- )- print(result)---if __name__ == "__main__":- asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/providers/python/openai-agents.py b/fern/snippets/providers/python/openai-agents.pydeleted file mode 100644index 81e06595b..000000000--- a/fern/snippets/providers/python/openai-agents.py+++ /dev/null@@ -1,26 +0,0 @@-import asyncio-from composio import Composio-from agents import Agent, Runner-from composio_openai_agents import OpenAIAgentsProvider--composio = Composio(api_key="your-api-key", provider=OpenAIAgentsProvider())--# Create a connected account for the user for the gmail toolkit and replace with your own user id-externalUserId = "your-user-id"--# Get Gmail tools that are pre-configured-tools = composio.tools.get(user_id=externalUserId, tools=["GMAIL_SEND_EMAIL"])--agent = Agent(- name="Email Manager", instructions="You are a helpful assistant", tools=tools-)--# Run the agent-async def main():- result = await Runner.run(- starting_agent=agent,- input="Send an email to [email protected] with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'",- )- print(result.final_output)--asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/providers/python/openai-provider.py b/fern/snippets/providers/python/openai-provider.pydeleted file mode 100644index 6081b9575..000000000--- a/fern/snippets/providers/python/openai-provider.py+++ /dev/null@@ -1,25 +0,0 @@-from openai import OpenAI-from composio import Composio-from composio_openai import OpenAIProvider--# Initialize Composio client with OpenAI Provider-composio = Composio(provider=OpenAIProvider())-openai = OpenAI()--# Make sure to create an auth config and a connected account for the user with gmail toolkit-# Make sure to replace "your-user-id" with the actual user ID-user_id = "your-user-id"--tools = composio.tools.get(user_id=user_id, tools=["GMAIL_SEND_EMAIL"])--response = openai.chat.completions.create(- model="gpt-5",- tools=tools,- messages=[- {"role": "user", "content": "Send an email to [email protected] with the subject 'Running OpenAI Provider snippet' and body 'Hello from the code snippet in openai docs'"},- ],-)--# Execute the function calls-result = composio.provider.handle_tool_calls(response=response, user_id=user_id)-print(result)diff --git a/fern/snippets/providers/python/openai-responses-provider.py b/fern/snippets/providers/python/openai-responses-provider.pydeleted file mode 100644index 2a75ed869..000000000--- a/fern/snippets/providers/python/openai-responses-provider.py+++ /dev/null@@ -1,28 +0,0 @@-from openai import OpenAI-from composio import Composio-from composio_openai import OpenAIResponsesProvider--# Initialize Composio client with OpenAI Provider-composio = Composio(provider=OpenAIResponsesProvider())-openai = OpenAI()--# Make sure to create an auth config and a connected account for the user with gmail toolkit-# Make sure to replace "your-user-id" with the actual user ID-user_id = "your-user-id"--tools = composio.tools.get(user_id=user_id, tools=["GMAIL_SEND_EMAIL"])--response = openai.responses.create(- model="gpt-5",- tools=tools,- input=[- {- "role": "user",- "content": "Send an email to [email protected] with the subject 'Running OpenAI Provider snippet' and body 'Hello from the code snippet in openai docs'"- }- ]-)--# Execute the function calls-result = composio.provider.handle_tool_calls(response=response, user_id=user_id)-print(result)diff --git a/fern/snippets/providers/typescript/google.ts b/fern/snippets/providers/typescript/google.tsdeleted file mode 100644index 2d4143c4e..000000000--- a/fern/snippets/providers/typescript/google.ts+++ /dev/null@@ -1,39 +0,0 @@-import {Composio} from '@composio/core';-import {GoogleProvider} from '@composio/google'-import {GoogleGenAI} from '@google/genai'--const composio = new Composio({- apiKey: "your-composio-api-key",- provider: new GoogleProvider()-})--const ai = new GoogleGenAI({- apiKey: "your-gemini-api-key"-})--// Use a unique identifier for each user in your application-const user_id = "your-external-user-id"--// Get tools - this returns already wrapped tools when using GoogleProvider-const tools = await composio.tools.get(user_id, 'HACKERNEWS_GET_USER')--const response = await ai.models.generateContent({- model: 'gemini-2.0-flash-001',- contents: "Search for the user 'pg's",- config: {- tools: [{ functionDeclarations: tools }],- },-});--if (response.functionCalls && response.functionCalls.length > 0) {- console.log(`Calling tool ${response.functionCalls[0].name}`);- const functionCall = {- name: response.functionCalls[0].name || '',- args: response.functionCalls[0].args || {},- };- const result = await composio.provider.executeToolCall(user_id, functionCall);- console.log(`Result: ${result}`);-} else {- console.log('No function calls in the response');- console.log(response.text);-}\ No newline at end of filediff --git a/fern/snippets/providers/typescript/langchain.ts b/fern/snippets/providers/typescript/langchain.tsdeleted file mode 100644index 0f43c52ea..000000000--- a/fern/snippets/providers/typescript/langchain.ts+++ /dev/null@@ -1,71 +0,0 @@-import { ChatOpenAI } from '@langchain/openai';-import { HumanMessage, AIMessage } from '@langchain/core/messages';-import { ToolNode } from '@langchain/langgraph/prebuilt';-import { StateGraph, MessagesAnnotation } from '@langchain/langgraph';-import { Composio } from '@composio/core';-import { LangchainProvider } from '@composio/langchain';-// initiate composio-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new LangchainProvider(),-});--// fetch the tool-console.log(`🔄 Fetching the tool...`);-const tools = await composio.tools.get('default', 'HACKERNEWS_GET_USER');--// Define the tools for the agent to use-const toolNode = new ToolNode(tools);--// Create a model and give it access to the tools-const model = new ChatOpenAI({- model: 'gpt-4o-mini',- temperature: 0,-}).bindTools(tools);--// Define the function that determines whether to continue or not-function shouldContinue({ messages }: typeof MessagesAnnotation.State) {- const lastMessage = messages[messages.length - 1] as AIMessage;-- // If the LLM makes a tool call, then we route to the "tools" node- if (lastMessage.tool_calls?.length) {- return 'tools';- }- // Otherwise, we stop (reply to the user) using the special "__end__" node- return '__end__';-}--// Define the function that calls the model-async function callModel(state: typeof MessagesAnnotation.State) {- console.log(`🔄 Calling the model...`);- const response = await model.invoke(state.messages);-- // We return a list, because this will get added to the existing list- return { messages: [response] };-}--// Define a new graph-const workflow = new StateGraph(MessagesAnnotation)- .addNode('agent', callModel)- .addEdge('__start__', 'agent') // __start__ is a special name for the entrypoint- .addNode('tools', toolNode)- .addEdge('tools', 'agent')- .addConditionalEdges('agent', shouldContinue);--// Finally, we compile it into a LangChain Runnable.-const app = workflow.compile();--// Use the agent-const finalState = await app.invoke({- messages: [new HumanMessage('Find the details of the user `pg` on HackerNews')],-});-console.log(`✅ Message recieved from the model`);-console.log(finalState.messages[finalState.messages.length - 1].content);--const nextState = await app.invoke({- // Including the messages from the previous run gives the LLM context.- // This way it knows we're asking about the weather in NY- messages: [...finalState.messages, new HumanMessage('what about haxzie')],-});-console.log(`✅ Message recieved from the model`);-console.log(nextState.messages[nextState.messages.length - 1].content);diff --git a/fern/snippets/providers/typescript/llamaindex-provider.ts b/fern/snippets/providers/typescript/llamaindex-provider.tsdeleted file mode 100644index c79057b0f..000000000--- a/fern/snippets/providers/typescript/llamaindex-provider.ts+++ /dev/null@@ -1,36 +0,0 @@-import { Composio } from '@composio/core';-import { LlamaindexProvider } from '@composio/llamaindex';-import { openai } from '@llamaindex/openai';-import { agent } from '@llamaindex/workflow';-import 'dotenv/config';--// Initialize Composio with LlamaIndex provider-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new LlamaindexProvider(),-});--async function main() {- // Get tools- const tools = await composio.tools.get('[email protected]', {- tools: ['GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER'],- });-- // Create LlamaIndex agent with Composio tools- const githubAgent = agent({- name: 'GitHub Agent',- description: 'An agent that performs GitHub actions',- llm: openai({ model: 'gpt-4o-mini' }),- systemPrompt: 'You are an agent that performs github actions.',- tools,- });-- // Run the agent- const result = await githubAgent.run(- 'Hello! I would like to star a repo composiohq/composio on GitHub'- );-- console.log(result);-}--main().catch(console.error);diff --git a/fern/snippets/providers/typescript/llamaindex-streaming.ts b/fern/snippets/providers/typescript/llamaindex-streaming.tsdeleted file mode 100644index 2591959b6..000000000--- a/fern/snippets/providers/typescript/llamaindex-streaming.ts+++ /dev/null@@ -1,53 +0,0 @@-import { Composio } from '@composio/core';-import { LlamaindexProvider } from '@composio/llamaindex';-import { openai } from '@llamaindex/openai';-import { agent, agentStreamEvent } from '@llamaindex/workflow';-import 'dotenv/config';--const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new LlamaindexProvider(),-});--async function streamingExample() {- // Get tools from multiple toolkits with execution modifiers- const tools = await composio.tools.get(- 'default',- {- toolkits: ['gmail', 'googlecalendar', 'slack'],- limit: 20,- },- {- beforeExecute: ({ toolSlug, params }) => {- console.log(`🔄 Executing ${toolSlug} with:`, params);- return params;- },- afterExecute: ({ toolSlug, result }) => {- console.log(`✅ ${toolSlug} completed:`, result);- return result;- },- }- );-- // Create streaming agent- const assistantAgent = agent({- name: 'Personal Assistant',- description: 'A helpful personal assistant',- llm: openai({ model: 'gpt-4o-mini' }),- systemPrompt: 'You are a helpful personal assistant that can manage emails, calendar events, and slack messages.',- tools,- });-- // Stream the response- const stream = await assistantAgent.runStream(- 'Schedule a meeting for tomorrow at 2 PM and send a slack message about it'- );-- for await (const event of stream) {- if (agentStreamEvent.include(event)) {- process.stdout.write(event.data.delta);- }- }-}--streamingExample().catch(console.error);diff --git a/fern/snippets/providers/typescript/openai-agents.ts b/fern/snippets/providers/typescript/openai-agents.tsdeleted file mode 100644index 8ba2330d4..000000000--- a/fern/snippets/providers/typescript/openai-agents.ts+++ /dev/null@@ -1,33 +0,0 @@-import { Composio } from "@composio/core";-import { Agent, run } from "@openai/agents";-import { OpenAIAgentsProvider } from "@composio/openai-agents";--// add OPENAI_API_KEY in your .env file-const composio = new Composio({- apiKey: "your-api-key",- provider: new OpenAIAgentsProvider(),-});--// Create a connected account for the user for the gmail toolkit and replace with your own user id-const externalUserId = "your-user-id";--// Fetch tools for GMAIL toolkit on behalf of the user-const tools = await composio.tools.get(externalUserId, {- tools: ["GMAIL_SEND_EMAIL"],- });--const agent = new Agent({- name: "Email Manager",- tools: tools,-});--console.log(`Running agent...`);-const result = await run(- agent,- "Send an email to [email protected] with the subject 'Hello from composio' and the body 'Congratulations on sending your first email using AI Agents and Composio!'"-);--console.log(`Received response from agent`);-if (result.finalOutput) {- console.log(JSON.stringify(result.finalOutput, null, 2));-}\ No newline at end of filediff --git a/fern/snippets/providers/typescript/openai.ts b/fern/snippets/providers/typescript/openai.tsdeleted file mode 100644index b833f2c66..000000000--- a/fern/snippets/providers/typescript/openai.ts+++ /dev/null@@ -1,39 +0,0 @@-import OpenAI from 'openai';-import { Composio } from '@composio/core';-import { OpenAIProvider } from '@composio/openai';--// Initialize Composio client with OpenAI Provider-const composio = new Composio({- provider: new OpenAIProvider(),-});--const openai = new OpenAI();--// Make sure to create an auth config and a connected account for the user with gmail toolkit-// Make sure to replace "your-user-id" with the actual user ID-const userId = "your-user-id";--async function main() {- try {- const tools = await composio.tools.get(userId, {tools: ["GMAIL_SEND_EMAIL"]});-- const response = await openai.chat.completions.create({- model: "gpt-5",- tools: tools,- messages: [- {- role: "user",- content: "Send an email to [email protected] with the subject 'Running OpenAI Provider snippet' and body 'Hello from the code snippet in openai docs'"- },- ],- });-- // Execute the function calls- const result = await composio.provider.handleToolCalls(userId, response);- console.log(result);- } catch (error) {- console.error('Error:', error);- }-}--main();diff --git a/fern/snippets/providers/typescript/openairesponses.ts b/fern/snippets/providers/typescript/openairesponses.tsdeleted file mode 100644index ed310737d..000000000--- a/fern/snippets/providers/typescript/openairesponses.ts+++ /dev/null@@ -1,38 +0,0 @@-import OpenAI from 'openai';-import { Composio } from '@composio/core';-import { OpenAIResponsesProvider } from '@composio/openai';--// Initialize Composio client with OpenAI Provider-const composio = new Composio({- provider: new OpenAIResponsesProvider(),-});-const openai = new OpenAI({});--// Make sure to create an auth config and a connected account for the user with gmail toolkit-// Make sure to replace "your-user-id" with the actual user ID-const userId = "your-user-id";--async function main() {- try {- const tools = await composio.tools.get(userId, {tools: ["GMAIL_SEND_EMAIL"]});-- const response = await openai.responses.create({- model: "gpt-5",- tools: tools,- input: [- {- role: "user",- content: "Send an email to [email protected] with the subject 'Running OpenAI Provider snippet' and body 'Hello from the code snippet in openai docs'"- },- ],- });-- // Execute the function calls- const result = await composio.provider.handleToolCalls(userId, response.output);- console.log(result);- } catch (error) {- console.error('Error:', error);- }-}--main();diff --git a/fern/snippets/tool-calling/python/checking-connection-status.py b/fern/snippets/tool-calling/python/checking-connection-status.pydeleted file mode 100644index 4411ef9a2..000000000--- a/fern/snippets/tool-calling/python/checking-connection-status.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--composio = Composio(api_key="your_api_key")--# Get a specific connected account-connected_account = composio.connected_accounts.get("your_connected_account_id")-print(f"Status: {connected_account.status}")--# Filter connections by user_id, auth_config_id, and status (only active accounts)-filtered_connections = composio.connected_accounts.list(- user_ids=["user_123"],- auth_config_ids=["your_auth_config_id"],- statuses=["ACTIVE"]-)-for connection in filtered_connections.items:- print(f"{connection.id}: {connection.status}")diff --git a/fern/snippets/tool-calling/python/direct-tool-call.py b/fern/snippets/tool-calling/python/direct-tool-call.pydeleted file mode 100644index 9378486f0..000000000--- a/fern/snippets/tool-calling/python/direct-tool-call.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--user_id = "user-k7334"-# Configure toolkit versions at SDK level-composio = Composio(- api_key="your_composio_key",- toolkit_versions={"github": "20251027_00"}-)--# Find available arguments for any tool in the Composio dashboard-result = composio.tools.execute(- "GITHUB_LIST_STARGAZERS",- user_id=user_id,- arguments={"owner": "ComposioHQ", "repo": "composio", "page": 1, "per_page": 5}-)-print(result)\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/exec-tool-agentic.py b/fern/snippets/tool-calling/python/exec-tool-agentic.pydeleted file mode 100644index 5a61d8f01..000000000--- a/fern/snippets/tool-calling/python/exec-tool-agentic.py+++ /dev/null@@ -1,33 +0,0 @@-import asyncio-from agents import Agent, Runner-from composio import Composio-from composio_openai_agents import OpenAIAgentsProvider--# Use a unique identifier for each user in your application-user_id = "user-k7334"--# Initialize Composio toolset-composio = Composio(provider=OpenAIAgentsProvider(), api_key="your_composio_api_key")--# Get all tools for the user-tools = composio.tools.get(- user_id=user_id,- toolkits=["COMPOSIO_SEARCH"],-)--# Create an agent with the tools-agent = Agent(- name="Deep Researcher",- instructions="You are an investigative journalist.",- tools=tools,-)--async def main():- result = await Runner.run(- starting_agent=agent,- input=("Do a thorough DEEP research on Golden Gate Bridge"),- )- print(result.final_output)--# Run the agent-asyncio.run(main())diff --git a/fern/snippets/tool-calling/python/exec-tool-completions.py b/fern/snippets/tool-calling/python/exec-tool-completions.pydeleted file mode 100644index 980097c5b..000000000--- a/fern/snippets/tool-calling/python/exec-tool-completions.py+++ /dev/null@@ -1,34 +0,0 @@-from composio import Composio-from composio_openai import OpenAIProvider-from openai import OpenAI-from datetime import datetime--# Use a unique identifier for each user in your application-user_id = "user-k7334"--# Create composio client-composio = Composio(provider=OpenAIProvider(), api_key="your_composio_api_key")--# Create openai client-openai = OpenAI()--# Get calendar tools for this user-tools = composio.tools.get(- user_id=user_id,- tools=["GOOGLECALENDAR_EVENTS_LIST"]-)--# Ask the LLM to check calendar-result = openai.chat.completions.create(- model="gpt-4o-mini",- tools=tools,- messages=[- {"role": "system", "content": "You are a helpful assistant."},- {"role": "user", "content": f"What's on my calendar for the next 7 days. Its {datetime.now().strftime("%Y-%m-%d")} today.",}- ]-)---# Handle tool calls-result = composio.provider.handle_tool_calls(user_id=user_id, response=result)-print(result)\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/fetching-tools.py b/fern/snippets/tool-calling/python/fetching-tools.pydeleted file mode 100644index e7565a3a6..000000000--- a/fern/snippets/tool-calling/python/fetching-tools.py+++ /dev/null@@ -1,66 +0,0 @@-from composio import Composio--composio = Composio()-user_id = "uuid-1234-5678-9012"--tools = composio.tools.get(- user_id,- toolkits=["GITHUB"]-)--# Fetch with limit for a specific user-tools = composio.tools.get(- user_id,- toolkits=["GITHUB"],- limit=5 # Get top 5 tools-)--# Same filter but without user_id (for schemas)-raw_tools = composio.tools.get_raw_composio_tools(- toolkits=["GITHUB"],- limit=5-)--# Fetch specific tools by name-tools = composio.tools.get(- user_id,- tools=["GITHUB_CREATE_ISSUE", "GITHUB_CREATE_PULL_REQUEST"]-)--# Get schemas without user_id-raw_tools = composio.tools.get_raw_composio_tools(- tools=["GITHUB_CREATE_ISSUE", "GITHUB_CREATE_PULL_REQUEST"]-)--# Filter by OAuth scopes (single toolkit only)-tools = composio.tools.get(- user_id,- toolkits=["GITHUB"],- scopes=["write:org"]-)--# Search tools semantically-tools = composio.tools.get(- user_id,- search="create calendar event"-)--# Search schemas without user_id-raw_tools = composio.tools.get_raw_composio_tools(- search="create calendar event"-)--# Search within a specific toolkit-tools = composio.tools.get(- user_id,- search="issues",- toolkits=["GITHUB"],-)--# Search toolkit schemas without user_id-raw_tools = composio.tools.get_raw_composio_tools(- search="issues",- toolkits=["GITHUB"]-)--tool = composio.tools.get_raw_composio_tool_by_slug("GMAIL_SEND_EMAIL")\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/file-download.py b/fern/snippets/tool-calling/python/file-download.pydeleted file mode 100644index 483d84bfe..000000000--- a/fern/snippets/tool-calling/python/file-download.py+++ /dev/null@@ -1,15 +0,0 @@-from composio import Composio---composio = Composio(- api_key="your_composio_key", file_download_dir="./downloads"-) # Optional: Specify the directory to download files to--result = composio.tools.execute(- "GOOGLEDRIVE_DOWNLOAD_FILE",- user_id="user-1235***",- arguments={"file_id": "your_file_id"},-)--# Result includes local file path-print(result)diff --git a/fern/snippets/tool-calling/python/file-upload.py b/fern/snippets/tool-calling/python/file-upload.pydeleted file mode 100644index 09e14ad6c..000000000--- a/fern/snippets/tool-calling/python/file-upload.py+++ /dev/null@@ -1,14 +0,0 @@-import os--from composio import Composio--composio = Composio(api_key="your_composio_key")--# Upload a local file to Google Drive-result = composio.tools.execute(- slug="GOOGLEDRIVE_UPLOAD_FILE",- user_id="user-1235***",- arguments={"file_to_upload": os.path.join(os.getcwd(), "document.pdf")}, # Local file path-)--print(result) # Print Google Drive file detailsdiff --git a/fern/snippets/tool-calling/python/proxy-tool.py b/fern/snippets/tool-calling/python/proxy-tool.pydeleted file mode 100644index 622ca146e..000000000--- a/fern/snippets/tool-calling/python/proxy-tool.py+++ /dev/null@@ -1,19 +0,0 @@-from composio import Composio--composio = Composio(api_key="your_composio_key")--# Send a proxy request to the endpoint-response = composio.tools.proxy(- endpoint="/repos/composiohq/composio/issues/1",- method="GET",- connected_account_id="ca_jI6********", # use connected account for github- parameters=[- {- "name": "Accept",- "value": "application/vnd.github.v3+json",- "type": "header",- },- ],-)--print(response)diff --git a/fern/snippets/tool-calling/python/raw_tools.py b/fern/snippets/tool-calling/python/raw_tools.pydeleted file mode 100644index 8f8b22e85..000000000--- a/fern/snippets/tool-calling/python/raw_tools.py+++ /dev/null@@ -1,7 +0,0 @@-from composio import Composio--composio = Composio()--tool = composio.tools.get_raw_composio_tool_by_slug("HACKERNEWS_GET_LATEST_POSTS")--print(tool.model_dump_json())diff --git a/fern/snippets/tool-calling/python/versioning-manage.py b/fern/snippets/tool-calling/python/versioning-manage.pydeleted file mode 100644index c661e9e6a..000000000--- a/fern/snippets/tool-calling/python/versioning-manage.py+++ /dev/null@@ -1,11 +0,0 @@-from composio import Composio--composio = Composio(api_key="YOUR_API_KEY")--# Get toolkit information including available versions-toolkit = composio.toolkits.get(slug="github")--# Extract and print version information-print(f"Toolkit: {toolkit.name}")-print(f"Current Version: {toolkit.meta.version}")-print(f"Available Versions: {toolkit.meta.available_versions}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/versioning-per-execution.py b/fern/snippets/tool-calling/python/versioning-per-execution.pydeleted file mode 100644index 2e1c64482..000000000--- a/fern/snippets/tool-calling/python/versioning-per-execution.py+++ /dev/null@@ -1,15 +0,0 @@-from composio import Composio--composio = Composio(api_key="YOUR_API_KEY")--# Specify version directly in execute call-result = composio.tools.execute(- "GITHUB_LIST_STARGAZERS",- arguments={- "owner": "ComposioHQ",- "repo": "composio"- },- user_id="user-k7334",- version="20251027_00" # Override version for this execution-)-print(result)\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/versioning-sdk-init.py b/fern/snippets/tool-calling/python/versioning-sdk-init.pydeleted file mode 100644index fc9ef0959..000000000--- a/fern/snippets/tool-calling/python/versioning-sdk-init.py+++ /dev/null@@ -1,11 +0,0 @@-from composio import Composio--# Pin specific versions for each toolkit-composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={- "github": "20251027_00",- "slack": "20251027_00",- "gmail": "20251027_00"- }-)\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/checking-connection-status.ts b/fern/snippets/tool-calling/typescript/checking-connection-status.tsdeleted file mode 100644index 996c504d0..000000000--- a/fern/snippets/tool-calling/typescript/checking-connection-status.ts+++ /dev/null@@ -1,17 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio({ apiKey: 'your_api_key' });--// Get a specific connected account by its nanoid-const connectedAccount = await composio.connectedAccounts.get('your_connected_account_id');-console.log(`Status: ${connectedAccount.status}`);--// Filter connections by user_id, auth_config_id, and status (only active accounts)-const filteredConnections = await composio.connectedAccounts.list({- userIds: ['user_123'],- authConfigIds: ['your_auth_config_id'],- statuses: ['ACTIVE']-});-filteredConnections.items.forEach(connection => {- console.log(`${connection.id}: ${connection.status}`);-});diff --git a/fern/snippets/tool-calling/typescript/direct-tool-call.ts b/fern/snippets/tool-calling/typescript/direct-tool-call.tsdeleted file mode 100644index 12c4825d9..000000000--- a/fern/snippets/tool-calling/typescript/direct-tool-call.ts+++ /dev/null@@ -1,20 +0,0 @@-import { Composio } from "@composio/core";--const userId = "user-k7334";-// Configure toolkit versions at SDK level-const composio = new Composio({- apiKey: "your_composio_key",- toolkitVersions: { github: "20251027_00" }-});--// Find available arguments for any tool in the Composio dashboard-const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {- userId,- arguments: {- "owner": "ComposioHQ",- "repo": "composio",- "page": 1,- "per_page": 5- },-});-console.log('GitHub stargazers:', JSON.stringify(result, null, 2));\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/exec-tool-agentic.ts b/fern/snippets/tool-calling/typescript/exec-tool-agentic.tsdeleted file mode 100644index a9658e8b2..000000000--- a/fern/snippets/tool-calling/typescript/exec-tool-agentic.ts+++ /dev/null@@ -1,33 +0,0 @@-import { Composio } from '@composio/core';-import { generateText } from 'ai';-import { anthropic } from '@ai-sdk/anthropic';-import { VercelProvider } from '@composio/vercel';--// Use a unique identifier for each user in your application-const userId = 'user-k7334';--// Initialize Composio toolset-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new VercelProvider(),-});--// Get all tools for the user-const tools = await composio.tools.get(userId, {- toolkits: ['HACKERNEWS_GET_LATEST_POSTS'],- limit: 10,-});--// Generate a deep research on hackernews-const { text } = await generateText({- model: anthropic('claude-sonnet-4-20250514'),- messages: [- {- role: 'user',- content: 'Do a thorough DEEP research on the top articles on Hacker News about Composio',- },- ],- tools,-});--console.log(text);diff --git a/fern/snippets/tool-calling/typescript/exec-tool-completions.ts b/fern/snippets/tool-calling/typescript/exec-tool-completions.tsdeleted file mode 100644index e0fd2df1c..000000000--- a/fern/snippets/tool-calling/typescript/exec-tool-completions.ts+++ /dev/null@@ -1,39 +0,0 @@-import { Composio } from '@composio/core';-import { AnthropicProvider } from '@composio/anthropic';-import { Anthropic } from '@anthropic-ai/sdk';--// Use a unique identifier for each user in your application-const userId = 'user-k7334';--// Create anthropic client-const anthropic = new Anthropic();--// Create Composio client-const composio = new Composio({- apiKey: "your-composio-api-key",- provider: new AnthropicProvider(),-});--// Get calendar tools for this user-const tools = await composio.tools.get(userId, {- tools: ['GOOGLECALENDAR_EVENTS_LIST'],-});--const today = new Date();--// Ask the LLM to check calendar-const msg = await anthropic.messages.create({- model: 'claude-sonnet-4-20250514',- tools: tools,- messages: [- {- role: 'user',- content: `What's on my calendar for the next 7 days starting today:${today.toLocaleDateString()}?`,- },- ],- max_tokens: 1024,-});--// Handle tool calls-const result = await composio.provider.handleToolCalls(userId, msg);-console.log('Results:', JSON.stringify(result, null, 2));diff --git a/fern/snippets/tool-calling/typescript/fetching-tools.ts b/fern/snippets/tool-calling/typescript/fetching-tools.tsdeleted file mode 100644index cbc6259d4..000000000--- a/fern/snippets/tool-calling/typescript/fetching-tools.ts+++ /dev/null@@ -1,60 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio();-const userId = "uuid-1234-5678-9012";--const tools = await composio.tools.get(userId, {- toolkits: ["GITHUB"]-});--// Fetch with limit for a specific user-const limitedTools = await composio.tools.get(userId, {- toolkits: ["GITHUB"],- limit: 5 // Get top 5 tools-});--// Same filter but without userId (for schemas)-const rawTools = await composio.tools.getRawComposioTools({- toolkits: ["GITHUB"],- limit: 5-});--// Fetch specific tools by name-const specificTools = await composio.tools.get(userId, {- tools: ["GITHUB_LIST_STARGAZERS", "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"]-});--// Get schemas without userId-const specificRawTools = await composio.tools.getRawComposioTools({- tools: ["GITHUB_LIST_STARGAZERS", "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"]-});--// Filter by OAuth scopes (single toolkit only)-const scopedTools = await composio.tools.get(userId, {- toolkits: ["GITHUB"],- scopes: ["write:org"]-});--// Search tools semantically-const searchResults = await composio.tools.get(userId, {- search: "create google calendar event"-});--// Search schemas without userId-const searchRawTools = await composio.tools.getRawComposioTools({- search: "create google calendar event"-});--// Search within a specific toolkit-const toolkitSearch = await composio.tools.get(userId, {- search: "star a repository",- toolkits: ["GITHUB"]-});--// Search toolkit schemas without userId-const toolkitSearchRaw = await composio.tools.getRawComposioTools({- search: "star a repository",- toolkits: ["GITHUB"]-});--const tool = await composio.tools.getRawComposioToolBySlug("GMAIL_SEND_EMAIL");\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/file-download.ts b/fern/snippets/tool-calling/typescript/file-download.tsdeleted file mode 100644index 904852c71..000000000--- a/fern/snippets/tool-calling/typescript/file-download.ts+++ /dev/null@@ -1,13 +0,0 @@-import { Composio } from '@composio/core';-const composio = new Composio({apiKey: 'your-composio-api-key'});--// Download a file from Google Drive-const result = await composio.tools.execute('GOOGLEDRIVE_DOWNLOAD_FILE', {- userId: 'user-1235***',- arguments: {- file_id: 'your-file-id'- }- });--// Result includes local file path-console.log(result);\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/file-upload.ts b/fern/snippets/tool-calling/typescript/file-upload.tsdeleted file mode 100644index 70ea7ba9a..000000000--- a/fern/snippets/tool-calling/typescript/file-upload.ts+++ /dev/null@@ -1,16 +0,0 @@-import { Composio } from '@composio/core';-import path from 'path';--const composio = new Composio({- apiKey: 'your-composio-api-key'-});--// Upload a local file to Google Drive-const result = await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {- userId: 'user-4235***',- arguments: {- file_to_upload: path.join(__dirname, 'document.pdf') // Local file path- }-});--console.log(result.data); // Contains Google Drive file detailsdiff --git a/fern/snippets/tool-calling/typescript/proxy-tool.ts b/fern/snippets/tool-calling/typescript/proxy-tool.tsdeleted file mode 100644index 8cc370bee..000000000--- a/fern/snippets/tool-calling/typescript/proxy-tool.ts+++ /dev/null@@ -1,20 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio({apiKey: "your_composio_key"});--// Send a proxy request to the endpoint-const { data } = await composio.tools.proxyExecute({- endpoint:'/repos/composiohq/composio/issues/1',- method: 'GET',- connectedAccountId: 'ca_jI*****', // use connected account for github- parameters:[- {- "name": "Accept",- "value": "application/vnd.github.v3+json",- "in": "header",- },- ],-});--console.log(data);-\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/raw_tools.ts b/fern/snippets/tool-calling/typescript/raw_tools.tsdeleted file mode 100644index 68b6f01d1..000000000--- a/fern/snippets/tool-calling/typescript/raw_tools.ts+++ /dev/null@@ -1,7 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio();--const tool = await composio.tools.getRawComposioToolBySlug('GITHUB_GET_OCTOCAT');--console.log(JSON.stringify(tool, null, 2));diff --git a/fern/snippets/tool-calling/typescript/versioning-manage.ts b/fern/snippets/tool-calling/typescript/versioning-manage.tsdeleted file mode 100644index 6bc364555..000000000--- a/fern/snippets/tool-calling/typescript/versioning-manage.ts+++ /dev/null@@ -1,12 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "YOUR_API_KEY" });--// Get toolkit information including available versions-const toolkit = await composio.toolkits.get("github");--// Extract and print version information-console.log("Toolkit:", toolkit.name);-console.log("Current Version:", toolkit.meta.version);-console.log("Available Versions:", toolkit.meta.availableVersions);-console.log("Latest Version:", toolkit.meta.availableVersions[0]); // First one is usually the latest\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/versioning-per-execution.ts b/fern/snippets/tool-calling/typescript/versioning-per-execution.tsdeleted file mode 100644index ba3eab26e..000000000--- a/fern/snippets/tool-calling/typescript/versioning-per-execution.ts+++ /dev/null@@ -1,14 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "YOUR_API_KEY" });--// Specify version directly in execute call-const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {- userId: "user-k7334",- arguments: {- owner: "ComposioHQ",- repo: "composio"- },- version: "20251027_00" // Override version for this execution-});-console.log(result);\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/versioning-sdk-init.ts b/fern/snippets/tool-calling/typescript/versioning-sdk-init.tsdeleted file mode 100644index f3c5e70ff..000000000--- a/fern/snippets/tool-calling/typescript/versioning-sdk-init.ts+++ /dev/null@@ -1,11 +0,0 @@-import { Composio } from "@composio/core";--// Pin specific versions for each toolkit-const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: {- github: "20251027_00",- slack: "20251027_00",- gmail: "20251027_00"- }-});\ No newline at end of filediff --git a/fern/snippets/tool-router/python/manual-auth.py b/fern/snippets/tool-router/python/manual-auth.pydeleted file mode 100644index 2d51e1fd4..000000000--- a/fern/snippets/tool-router/python/manual-auth.py+++ /dev/null@@ -1,25 +0,0 @@-from composio import Composio--composio = Composio(api_key="your-api-key")--required_toolkits = ["gmail", "github"]--session = composio.create(- user_id="user_123",- manage_connections=False, # Disable in-chat auth prompts-)--toolkits = session.toolkits()--connected = {t.slug for t in toolkits.items if t.connection.is_active}-pending = [slug for slug in required_toolkits if slug not in connected]--print(f"Connected: {connected}")-print(f"Pending: {pending}")--for slug in pending:- connection_request = session.authorize(slug)- print(f"Connect {slug}: {connection_request.redirect_url}")- connection_request.wait_for_connection()--print(f"All toolkits connected! MCP URL: {session.mcp.url}")diff --git a/fern/snippets/tool-router/python/mcp-claude.py b/fern/snippets/tool-router/python/mcp-claude.pydeleted file mode 100644index 88379299a..000000000--- a/fern/snippets/tool-router/python/mcp-claude.py+++ /dev/null@@ -1,69 +0,0 @@-import asyncio-from dotenv import load_dotenv-from claude_agent_sdk.client import ClaudeSDKClient-from claude_agent_sdk.types import (- ClaudeAgentOptions,- AssistantMessage,- TextBlock,- ToolUseBlock,-)-from composio import Composio--load_dotenv()--# Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly)-composio = Composio()--# Unique identifier of the user-user_id = "user_123"-# Create a tool router session for the user-session = composio.create(user_id=user_id)--# Configure Claude with Composio MCP server-options = ClaudeAgentOptions(- system_prompt=(- "You are a helpful assistant with access to external tools. "- "Always use the available tools to complete user requests."- ),- mcp_servers={- "composio": {- "type": "http",- "url": session.mcp.url,- "headers": session.mcp.headers, # Authentication headers for the Composio MCP server- }- },- permission_mode="bypassPermissions", # Auto-approve tools (demo only)-)--async def main():- print("""-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a notion page with the issues'-""")-- async with ClaudeSDKClient(options) as client:- # Multi-turn conversation with agentic tool calling- while True:- user_input = input("\nYou: ").strip()- if user_input.lower() == "exit":- break-- print("\nClaude: ", end="", flush=True)- try:- await client.query(user_input)- async for msg in client.receive_response():- if isinstance(msg, AssistantMessage):- for block in msg.content:- if isinstance(block, ToolUseBlock):- print(f"\n[Using tool: {block.name}]", end="")- elif isinstance(block, TextBlock):- print(block.text, end="", flush=True)- except Exception as e:- print(f"\n[Error]: {e}")--if __name__ == "__main__":- asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/tool-router/python/mcp-openai.py b/fern/snippets/tool-router/python/mcp-openai.pydeleted file mode 100644index fed9c1560..000000000--- a/fern/snippets/tool-router/python/mcp-openai.py+++ /dev/null@@ -1,45 +0,0 @@-from dotenv import load_dotenv-from composio import Composio-from agents import Agent, Runner, HostedMCPTool--load_dotenv()--# Initialize Composio (API key from env var COMPOSIO_API_KEY)-composio = Composio()-# Unique identifier of the user-user_id = "user_123"--# Create a Tool Router session for the user-session = composio.create(user_id=user_id)--# Configure OpenAI agent with Composio MCP server-agent = Agent(- name="Personal Assistant",- instructions="You are a helpful personal assistant. Use Composio tools to take action.",- model="gpt-5.2",- tools=[- HostedMCPTool(- tool_config={- "type": "mcp",- "server_label": "composio",- "server_url": session.mcp.url,- "require_approval": "never",- "headers": session.mcp.headers,- }- )- ],-)--# Execute the task-print("Fetching GitHub issues from the Composio repository @ComposioHQ/composio...\n")-try:- result = Runner.run_sync(- starting_agent=agent,- input="Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",- )- print(result.final_output)-except Exception as e:- print(f"[Error]: {e}")--print("\n\n---")-print("Tip: If prompted to authenticate, complete the auth flow and run again.")\ No newline at end of filediff --git a/fern/snippets/tool-router/python/native-tools-openai.py b/fern/snippets/tool-router/python/native-tools-openai.pydeleted file mode 100644index 5f03b439d..000000000--- a/fern/snippets/tool-router/python/native-tools-openai.py+++ /dev/null@@ -1,54 +0,0 @@-from dotenv import load_dotenv-from composio import Composio-from agents import Agent, Runner, SQLiteSession-from composio_openai_agents import OpenAIAgentsProvider--load_dotenv()--# Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)-composio = Composio(provider=OpenAIAgentsProvider())--# Unique identifier of the user-user_id = "user_123"--# Create a session and get native tools for the user-session = composio.create(user_id=user_id)-tools = session.tools()--# Configure OpenAI agent with Composio tools-agent = Agent(- name="Personal Assistant",- instructions="You are a helpful personal assistant. Use Composio tools to take action.",- model="gpt-5.2",- tools=tools,-)--# Memory for multi-turn conversation-memory = SQLiteSession("conversation")--# Execute an initial task-print("Fetching GitHub issues from the Composio repository...\n")-try:- result = Runner.run_sync(- starting_agent=agent,- input="Fetch all the open GitHub issues on the @ComposioHQ/composio repository and group them by bugs/features/docs.",- session=memory,- )- print(f"{result.final_output}\n")-except Exception as e:- print(f"[Error]: {e}")--# Continue with interactive conversation-print("\nWhat else would you like me to do? (Type 'exit' to exit)")--while True:- user_input = input("You: ").strip()- if user_input.lower() == "exit":- break-- print("Assistant: ", end="", flush=True)- try:- result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)- print(f"{result.final_output}\n")- except Exception as e:- print(f"\n[Error]: {e}")\ No newline at end of filediff --git a/fern/snippets/tool-router/python/quickstart-mcp-claude.py b/fern/snippets/tool-router/python/quickstart-mcp-claude.pydeleted file mode 100644index f0af4e4fd..000000000--- a/fern/snippets/tool-router/python/quickstart-mcp-claude.py+++ /dev/null@@ -1,73 +0,0 @@-import asyncio-from dotenv import load_dotenv-from claude_agent_sdk.client import ClaudeSDKClient-from claude_agent_sdk.types import (- ClaudeAgentOptions,- AssistantMessage,- TextBlock,- ToolUseBlock,-)-from composio import Composio--load_dotenv()--# Initialize Composio (API key from env var COMPOSIO_API_KEY)-composio = Composio()--# Unique identifier of the user-user_id = "user_123"--# Create a tool router session for the user-session = composio.create(user_id=user_id)--# Configure Claude with Composio MCP server-options = ClaudeAgentOptions(- system_prompt=(- "You are a helpful assistant with access to external tools. "- "Always use the available tools to complete user requests."- ),- mcp_servers={- "composio": {- "type": "http",- "url": session.mcp.url,- "headers": session.mcp.headers,- }- },- permission_mode="bypassPermissions",-)---async def main():- print("""-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a notion page with the issues'-""")-- async with ClaudeSDKClient(options) as client:- # Multi-turn conversation with agentic tool calling- while True:- user_input = input("You: ").strip()- if user_input.lower() == "exit":- break-- print("\nClaude: ", end="", flush=True)- try:- await client.query(user_input)- async for msg in client.receive_response():- if isinstance(msg, AssistantMessage):- for block in msg.content:- if isinstance(block, ToolUseBlock):- print(f"\n[Using tool: {block.name}]", end="")- elif isinstance(block, TextBlock):- print(block.text, end="", flush=True)- print()- except Exception as e:- print(f"\n[Error]: {e}")---if __name__ == "__main__":- asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/tool-router/python/quickstart-mcp-openai.py b/fern/snippets/tool-router/python/quickstart-mcp-openai.pydeleted file mode 100644index edd7c095e..000000000--- a/fern/snippets/tool-router/python/quickstart-mcp-openai.py+++ /dev/null@@ -1,56 +0,0 @@-from dotenv import load_dotenv-from composio import Composio-from agents import Agent, Runner, HostedMCPTool, SQLiteSession--load_dotenv()--# Initialize Composio (API key from env var COMPOSIO_API_KEY)-composio = Composio()--# Unique identifier of the user-user_id = "user_123"--# Create a Tool Router session for the user-session = composio.create(user_id=user_id)--# Configure OpenAI agent with Composio MCP server-agent = Agent(- name="Personal Assistant",- instructions="You are a helpful personal assistant. Use Composio tools to take action.",- model="gpt-5.2",- tools=[- HostedMCPTool(- tool_config={- "type": "mcp",- "server_label": "composio",- "server_url": session.mcp.url,- "require_approval": "never",- "headers": session.mcp.headers,- }- )- ],-)--# Memory for multi-turn conversation-memory = SQLiteSession(user_id)--print("""-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository'-""")--while True:- user_input = input("You: ").strip()- if user_input.lower() == "exit":- break-- print("Assistant: ", end="", flush=True)- try:- result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)- print(f"{result.final_output}\n")- except Exception as e:- print(f"\n[Error]: {e}")diff --git a/fern/snippets/tool-router/python/quickstart-native-openai.py b/fern/snippets/tool-router/python/quickstart-native-openai.pydeleted file mode 100644index fc7556219..000000000--- a/fern/snippets/tool-router/python/quickstart-native-openai.py+++ /dev/null@@ -1,48 +0,0 @@-from dotenv import load_dotenv-from composio import Composio-from agents import Agent, Runner, SQLiteSession-from composio_openai_agents import OpenAIAgentsProvider--load_dotenv()--# Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)-composio = Composio(provider=OpenAIAgentsProvider())--# Unique identifier of the user-user_id = "user_123"--# Create a session and get native tools for the user-session = composio.create(user_id=user_id)-tools = session.tools()--# Configure OpenAI agent with Composio tools-agent = Agent(- name="Personal Assistant",- instructions="You are a helpful personal assistant. Use Composio tools to take action.",- model="gpt-5.2",- tools=tools,-)--# Memory for multi-turn conversation-memory = SQLiteSession("conversation")--print("""-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository'-""")--while True:- user_input = input("You: ").strip()- if user_input.lower() == "exit":- break-- print("Assistant: ", end="", flush=True)- try:- result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)- print(f"{result.final_output}\n")- except Exception as e:- print(f"\n[Error]: {e}")\ No newline at end of filediff --git a/fern/snippets/tool-router/python/quickstart.py b/fern/snippets/tool-router/python/quickstart.pydeleted file mode 100644index 36093553b..000000000--- a/fern/snippets/tool-router/python/quickstart.py+++ /dev/null@@ -1,42 +0,0 @@-import asyncio-import os-from composio import Composio-from composio_openai_agents import OpenAIAgentsProvider-from agents import Agent, Runner, HostedMCPTool--async def main() -> None:- # Initialize Composio and create Tool Router session- composio = Composio(- api_key=os.getenv("COMPOSIO_API_KEY"), # Uses env var by default- provider=OpenAIAgentsProvider()- )- session = composio.experimental.tool_router.create_session(- user_id="[email protected]",- toolkits=["gmail", "github"] # Optional: Limit available toolkits- )-- # Set up OpenAI agent with Tool Router MCP endpoint- agent = Agent(- name="Assistant",- instructions="You are a helpful assistant that can access Gmail and GitHub. "- "Help users fetch emails, create issues, manage pull requests, and more.",- tools=[- HostedMCPTool(- tool_config={- "type": "mcp",- "server_label": "tool_router",- "server_url": session['url'],- "require_approval": "never",- }- )- ],- )-- # Execute the agent- result = await Runner.run(- agent,- "Fetch the contributors to composiohq/composio github repository and email the list to [email protected]"- )- print(result.final_output)--asyncio.run(main())\ No newline at end of filediff --git a/fern/snippets/tool-router/typescript/manual-auth.ts b/fern/snippets/tool-router/typescript/manual-auth.tsdeleted file mode 100644index a226dbdf9..000000000--- a/fern/snippets/tool-router/typescript/manual-auth.ts+++ /dev/null@@ -1,28 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "your-api-key" });--const requiredToolkits = ["gmail", "github"];--const session = await composio.create("user_123", {- manageConnections: false, // Disable in-chat auth prompts-});--const toolkits = await session.toolkits();--const connected = toolkits.items- .filter((t) => t.connection.connectedAccount)- .map((t) => t.slug);--const pending = requiredToolkits.filter((slug) => !connected.includes(slug));--console.log("Connected:", connected);-console.log("Pending:", pending);--for (const slug of pending) {- const connectionRequest = await session.authorize(slug);- console.log(`Connect ${slug}: ${connectionRequest.redirectUrl}`);- await connectionRequest.waitForConnection();-}--console.log(`All toolkits connected! MCP URL: ${session.mcp.url}`);diff --git a/fern/snippets/tool-router/typescript/mcp-claude.ts b/fern/snippets/tool-router/typescript/mcp-claude.tsdeleted file mode 100644index 630b5ca96..000000000--- a/fern/snippets/tool-router/typescript/mcp-claude.ts+++ /dev/null@@ -1,73 +0,0 @@-import "dotenv/config";-import { query, type Options } from "@anthropic-ai/claude-agent-sdk";-import { Composio } from "@composio/core";-import { createInterface } from "readline/promises";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const session = await composio.create(userId);--const options: Options = {- systemPrompt: `You are a helpful assistant with access to external tools. ` +- `Always use the available tools to complete user requests.`,- mcpServers: {- composio: {- type: "http",- url: session.mcp.url,- headers: session.mcp.headers // Authentication headers for the Composio MCP server- },- },- permissionMode: "bypassPermissions", // Auto-approve tools (demo only - use "default" in production)-};--// Set up interactive terminal input/output for the conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });--console.log(`-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a notion page with the issues'-`);--let isFirstQuery = true;--// Multi-turn conversation with agentic tool calling-while (true) {- const answer = await readline.question('You: ');- const input = answer.trim();- if (input.toLowerCase() === "exit") break;-- process.stdout.write("Claude: ");-- const queryOptions = isFirstQuery ? options : { ...options, continue: true };- isFirstQuery = false;-- try {- for await (const stream of query({ prompt: input, options: queryOptions })) {- // Only process assistant messages (the SDK also sends result/error messages)- if (stream.type === "assistant") {- const { content } = stream.message;- for (const block of content) {- if (block.type === "tool_use") {- process.stdout.write(`\n[Using tool: ${block.name}]`);- } else if (block.type === "text") {- process.stdout.write(block.text);- }- }- }- }- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }- process.stdout.write("\n");-}--readline.close();diff --git a/fern/snippets/tool-router/typescript/mcp-openai.ts b/fern/snippets/tool-router/typescript/mcp-openai.tsdeleted file mode 100644index 3b656623c..000000000--- a/fern/snippets/tool-router/typescript/mcp-openai.ts+++ /dev/null@@ -1,65 +0,0 @@-import "dotenv/config";-import { Composio } from "@composio/core";-import { Agent, hostedMcpTool, run, MemorySession } from "@openai/agents";-import { createInterface } from "readline/promises";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const session = await composio.create(userId);--const agent = new Agent({- name: "Personal Assistant",- instructions: "You are a helpful personal assistant. Use Composio tools to take action.",- model: "gpt-5.2",- tools: [- hostedMcpTool({- serverLabel: "composio",- serverUrl: session.mcp.url,- headers: session.mcp.headers, // Authentication headers for the Composio MCP server- }),- ],-});--// Create a memory session for persistent multi-turn conversation-const memory = new MemorySession();--// Execute an initial task-console.log("Fetching GitHub issues from the Composio repository...\n");-try {- const initialResult = await run(- agent,- "Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",- { session: memory }- );- console.log(`${initialResult.finalOutput}\n`);-} catch (error) {- console.error("[Error]:", error instanceof Error ? error.message : error);-}--// Continue with interactive conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });--console.log(`-What else would you like me to do?-(Type 'exit' to exit)-`);--while (true) {- const input = (await readline.question("You: ")).trim();- if (input.toLowerCase() === "exit") break;-- console.log("Assistant: ");-- try {- const result = await run(agent, input, { session: memory });- console.log(`${result.finalOutput}\n`);- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }-}-readline.close();diff --git a/fern/snippets/tool-router/typescript/mcp-vercel.ts b/fern/snippets/tool-router/typescript/mcp-vercel.tsdeleted file mode 100644index bce6f2e70..000000000--- a/fern/snippets/tool-router/typescript/mcp-vercel.ts+++ /dev/null@@ -1,46 +0,0 @@-import "dotenv/config";-import { anthropic } from "@ai-sdk/anthropic";-import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";-import { Composio } from "@composio/core";-import { stepCountIs, streamText } from "ai";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const { mcp } = await composio.create(userId);--// Create an MCP client to connect to the Composio tool router-const client = await createMCPClient({- transport: {- type: "http",- url: mcp.url,- headers: mcp.headers, // Authentication headers for the Composio MCP server- },-});-const tools = await client.tools();--console.log("Summarizing your emails from today");--const stream = await streamText({- system: "You are a helpful personal assistant. Use Composio tools to take action.",- model: anthropic("claude-sonnet-4-5"),- prompt: "Summarize my emails from today",- stopWhen: stepCountIs(10),- onStepFinish: (step) => {- for (const toolCall of step.toolCalls) {- console.log(`[Using tool: ${toolCall.toolName}]`);- }- },- tools,-});--for await (const textPart of stream.textStream) {- process.stdout.write(textPart);-}--console.log("\n\n---");-console.log("Tip: If prompted to authenticate, complete the auth flow and run again.")diff --git a/fern/snippets/tool-router/typescript/native-tools-openai.ts b/fern/snippets/tool-router/typescript/native-tools-openai.tsdeleted file mode 100644index 820c682bf..000000000--- a/fern/snippets/tool-router/typescript/native-tools-openai.ts+++ /dev/null@@ -1,62 +0,0 @@-import "dotenv/config";-import { Composio } from "@composio/core";-import { Agent, run, MemorySession } from "@openai/agents";-import { OpenAIAgentsProvider } from "@composio/openai-agents";-import { createInterface } from "readline/promises";--// Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)-const composio = new Composio({ provider: new OpenAIAgentsProvider() });--// Unique identifier of the user-const userId = "user_123";--// Create a session and get native tools for the user-const session = await composio.create(userId);-const tools = await session.tools();--const agent = new Agent({- name: "Personal Assistant",- instructions: "You are a helpful personal assistant. Use Composio tools to take action.",- model: "gpt-5.2",- tools,-});--// Create a memory session for persistent multi-turn conversation-const memory = new MemorySession();--// Execute an initial task-console.log("Fetching GitHub issues from the Composio repository...\n");-try {- const initialResult = await run(- agent,- "Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",- { session: memory }- );- console.log(`${initialResult.finalOutput}\n`);-} catch (error) {- console.error("[Error]:", error instanceof Error ? error.message : error);-}--// Continue with interactive conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });--console.log(`-What else would you like me to do?-(Type 'exit' to exit)-`);---while (true) {- const input = (await readline.question("You: ")).trim();- if (input.toLowerCase() === "exit") break;-- console.log("Assistant: ");-- try {- const result = await run(agent, input, { session: memory });- console.log(`${result.finalOutput}\n`);- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }-}-readline.close();diff --git a/fern/snippets/tool-router/typescript/native-tools-vercel.ts b/fern/snippets/tool-router/typescript/native-tools-vercel.tsdeleted file mode 100644index f14c5f16b..000000000--- a/fern/snippets/tool-router/typescript/native-tools-vercel.ts+++ /dev/null@@ -1,38 +0,0 @@-import "dotenv/config";-import { anthropic } from "@ai-sdk/anthropic";-import { Composio } from "@composio/core";-import { VercelProvider } from "@composio/vercel";-import { stepCountIs, streamText } from "ai";--// Initialize Composio with Vercel provider (API key from env var COMPOSIO_API_KEY)-const composio = new Composio({ provider: new VercelProvider() });--// Unique identifier of the user-const userId = "user_123";--// Create a session and get native tools for the user-const session = await composio.create(userId);-const tools = await session.tools();--console.log("Fetching GitHub issues from the Composio repository...");--// Stream the response with tool calling-const stream = await streamText({- system: "You are a helpful personal assistant. Use Composio tools to take action.",- model: anthropic("claude-sonnet-4-5"),- prompt: "Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",- stopWhen: stepCountIs(10),- onStepFinish: (step) => {- for (const toolCall of step.toolCalls) {- console.log(`[Using tool: ${toolCall.toolName}]`);- }- },- tools,-});--for await (const textPart of stream.textStream) {- process.stdout.write(textPart);-}--console.log("\n\n---");-console.log("Tip: If prompted to authenticate, complete the auth flow and run again.");diff --git a/fern/snippets/tool-router/typescript/quickstart-mcp-claude.ts b/fern/snippets/tool-router/typescript/quickstart-mcp-claude.tsdeleted file mode 100644index 0e5ce279b..000000000--- a/fern/snippets/tool-router/typescript/quickstart-mcp-claude.ts+++ /dev/null@@ -1,74 +0,0 @@-import "dotenv/config";-import { query, type Options } from "@anthropic-ai/claude-agent-sdk";-import { Composio } from "@composio/core";-import { createInterface } from "readline/promises";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const session = await composio.create(userId);--const options: Options = {- systemPrompt: `You are a helpful assistant with access to external tools. ` +- `Always use the available tools to complete user requests.`,- mcpServers: {- composio: {- type: "http",- url: session.mcp.url,- headers: session.mcp.headers // Authentication headers for the Composio MCP server- },- },- permissionMode: "bypassPermissions", // Auto-approve tools (demo only - use "default" in production)-};--// Set up interactive terminal input/output for the conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });--console.log(`-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a Google Sheet with the issues'-`);--let isFirstQuery = true;--// Multi-turn conversation with agentic tool calling-while (true) {- const answer = await readline.question('You: ');- const input = answer.trim();- if (input.toLowerCase() === "exit") break;-- process.stdout.write("Claude: ");-- // Use `continue: true` to maintain conversation context- const queryOptions = isFirstQuery ? options : { ...options, continue: true };- isFirstQuery = false;-- try {- for await (const stream of query({ prompt: input, options: queryOptions })) {- // Only process assistant messages (the SDK also sends result/error messages)- if (stream.type === "assistant") {- const { content } = stream.message;- for (const block of content) {- if (block.type === "tool_use") {- process.stdout.write(`\n[Using tool: ${block.name}]`);- } else if (block.type === "text") {- process.stdout.write(block.text);- }- }- }- }- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }- process.stdout.write("\n");-}--readline.close();diff --git a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts b/fern/snippets/tool-router/typescript/quickstart-mcp-openai.tsdeleted file mode 100644index 25814128d..000000000--- a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts+++ /dev/null@@ -1,58 +0,0 @@-import "dotenv/config";-import { Composio } from "@composio/core";-import { Agent, run, hostedMcpTool, MemorySession } from "@openai/agents";-import { createInterface } from "readline/promises";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const session = await composio.create(userId);--const agent = new Agent({- name: "Personal Assistant",- instructions: "You are a helpful personal assistant. Use Composio tools to take action.",- model: "gpt-5.2",- tools: [- hostedMcpTool({- serverLabel: "composio",- serverUrl: session.mcp.url,- headers: session.mcp.headers // Authentication headers for the Composio MCP server- }),- ],-});--// Create a memory session for persistent multi-turn conversation-const memory = new MemorySession();--// Set up interactive terminal input/output for the conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });--console.log(`-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a Google Sheet with the issues'-`);--// Multi-turn conversation with agentic tool calling-while (true) {- const input = (await readline.question("You: ")).trim();- if (input.toLowerCase() === "exit") break;-- console.log("Assistant: ");-- try {- // Multi-turn agentic loop: GPT calls tools and reasons until task is complete- const result = await run(agent, input, { session: memory });- console.log(`${result.finalOutput}`);- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }-}-readline.close();diff --git a/fern/snippets/tool-router/typescript/quickstart-mcp-vercel.ts b/fern/snippets/tool-router/typescript/quickstart-mcp-vercel.tsdeleted file mode 100644index a5156e949..000000000--- a/fern/snippets/tool-router/typescript/quickstart-mcp-vercel.ts+++ /dev/null@@ -1,46 +0,0 @@-import "dotenv/config";-import { anthropic } from "@ai-sdk/anthropic";-import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";-import { Composio } from "@composio/core";-import { stepCountIs, streamText } from "ai";--// Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly: { apiKey: "your-key" })-const composio = new Composio();--// Unique identifier of the user-const userId = "user_123";--// Create a tool router session for the user-const { mcp } = await composio.create(userId);--// Create an MCP client to connect to the Composio tool router-const client = await createMCPClient({- transport: {- type: "http",- url: mcp.url,- headers: mcp.headers, // Authentication headers for the Composio MCP server- },-});-const tools = await client.tools();--console.log("Summarizing your emails from today");--const stream = await streamText({- system: "You are a helpful personal assistant. Use Composio tools to take action.",- model: anthropic("claude-sonnet-4-5"),- prompt: "Summarize my emails from today",- stopWhen: stepCountIs(10),- onStepFinish: (step) => {- for (const toolCall of step.toolCalls) {- console.log(`[Using tool: ${toolCall.toolName}]`);- }- },- tools,-});--for await (const textPart of stream.textStream) {- process.stdout.write(textPart);-}--console.log("\n\n---");-console.log("Tip: If prompted to authenticate, complete the auth flow and run again.");diff --git a/fern/snippets/tool-router/typescript/quickstart-native-openai.ts b/fern/snippets/tool-router/typescript/quickstart-native-openai.tsdeleted file mode 100644index b3a4a10bb..000000000--- a/fern/snippets/tool-router/typescript/quickstart-native-openai.ts+++ /dev/null@@ -1,52 +0,0 @@-import "dotenv/config";-import { Composio } from "@composio/core";-import { Agent, run, MemorySession } from "@openai/agents";-import { OpenAIAgentsProvider } from "@composio/openai-agents";-import { createInterface } from "readline/promises";--// Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)-const composio = new Composio({ provider: new OpenAIAgentsProvider() });--// Unique identifier of the user-const userId = "user_123";-// Create a tool router session for the user-const session = await composio.create(userId);-const tools = await session.tools();--const agent = new Agent({- name: "Personal Assistant",- instructions: "You are a helpful personal assistant. Use Composio tools to take action.",- model: "gpt-5.2",- tools,-});--// Set up interactive terminal input/output for the conversation-const readline = createInterface({ input: process.stdin, output: process.stdout });-// Create a memory session for persistent multi-turn conversation-const memory = new MemorySession();--console.log(`-What task would you like me to help you with?-I can use tools like Gmail, GitHub, Linear, Notion, and more.-(Type 'exit' to exit)-Example tasks:- • 'Summarize my emails from today'- • 'List all open issues on the composio github repository and create a Google Sheet with the issues'-`);--// Multi-turn conversation with agentic tool calling-while (true) {- const query = await readline.question("You: ");- const input = query.trim();-- if (input.toLowerCase() === "exit") break;- process.stdout.write("Assistant: ");-- try {- const result = await run(agent, input, { session: memory });- process.stdout.write(`${result.finalOutput}`);- } catch (error) {- console.error("\n[Error]:", error instanceof Error ? error.message : error);- }-}-readline.close();diff --git a/fern/snippets/tool-router/typescript/quickstart-native-vercel.ts b/fern/snippets/tool-router/typescript/quickstart-native-vercel.tsdeleted file mode 100644index 9b792aeb9..000000000--- a/fern/snippets/tool-router/typescript/quickstart-native-vercel.ts+++ /dev/null@@ -1,39 +0,0 @@-import "dotenv/config";-import { anthropic } from "@ai-sdk/anthropic";-import { Composio } from "@composio/core";-import { VercelProvider } from "@composio/vercel";-import { stepCountIs, streamText } from "ai";--// Initialize Composio with Vercel provider (API key from env var COMPOSIO_API_KEY)-const composio = new Composio({ provider: new VercelProvider() });--// Unique identifier of the user-const userId = "user_123";--// Create a session and get native tools for the user-const session = await composio.create(userId);-const tools = await session.tools();--process.stdout.write("Summarizing your emails from today");-process.stdout.write("\n");--const stream = await streamText({- system: "You are a helpful personal assistant. Use Composio tools to take action.",- model: anthropic("claude-sonnet-4-5"),- prompt: "Summarize my emails from today",- stopWhen: stepCountIs(10),- onStepFinish: (step) => {- for (const toolCall of step.toolCalls) {- process.stdout.write(`[Using tool: ${toolCall.toolName}]`);- process.stdout.write("\n");- }- },- tools,-});--for await (const textPart of stream.textStream) {- process.stdout.write(textPart);-}--process.stdout.write("\n");-process.stdout.write("Tip: If prompted to authenticate, complete the auth flow and run again.");diff --git a/fern/snippets/tool-router/typescript/quickstart.ts b/fern/snippets/tool-router/typescript/quickstart.tsdeleted file mode 100644index 990ab1f04..000000000--- a/fern/snippets/tool-router/typescript/quickstart.ts+++ /dev/null@@ -1,41 +0,0 @@-import { Composio } from '@composio/core';-import { OpenAIAgentsProvider } from '@composio/openai-agents';-import { Agent, hostedMcpTool, run } from '@openai/agents';--async function main() {- // Initialize Composio with OpenAI Agents Provider- const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY,- provider: new OpenAIAgentsProvider()- });-- // Create a Tool Router session for your user- const session = await composio.experimental.toolRouter.createSession(- '[email protected]',- {- toolkits: ['gmail', 'github'] // Optional: Limit available toolkits- }- );-- // Create an agent with Tool Router MCP endpoint- const agent = new Agent({- name: 'Assistant',- instructions: 'You are a helpful assistant that can access Gmail and GitHub. Help users fetch emails, create issues, manage pull requests, and more.',- tools: [- hostedMcpTool({- serverLabel: 'tool_router',- serverUrl: session.url,- }),- ],- });-- // Execute the agent- const result = await run(- agent,- 'Fetch the contributors to composiohq/composio github repository and email the list to [email protected]'- );-- console.log(result.finalOutput);-}--main();\ No newline at end of filediff --git a/fern/snippets/triggers/python/trigger-subscription.py b/fern/snippets/triggers/python/trigger-subscription.pydeleted file mode 100644index ab9218c10..000000000--- a/fern/snippets/triggers/python/trigger-subscription.py+++ /dev/null@@ -1,17 +0,0 @@-from composio import Composio--# Initialize Composio client-composio = Composio(api_key="your_api_key_here")--# Subscribe to trigger events-subscription = composio.triggers.subscribe()--# Define event handler[email protected](trigger_id="your_trigger_id")-def handle_github_commit(data):- print(f"New commit detected: {data}")- # Add your custom logic here--# listen for events on the trigger-subscription.wait_forever()-# Note: For production use, set up webhooks insteaddiff --git a/fern/snippets/triggers/python/trigger-webhook.py b/fern/snippets/triggers/python/trigger-webhook.pydeleted file mode 100644index 8e87dc265..000000000--- a/fern/snippets/triggers/python/trigger-webhook.py+++ /dev/null@@ -1,48 +0,0 @@-from fastapi import FastAPI, Request, HTTPException-from typing import Dict, Any-import uvicorn-import json-import hmac-import hashlib-import base64-import os--def verify_webhook_signature(request: Request, body: bytes) -> bool:- """Verify Composio webhook signature"""- webhook_signature = request.headers.get("webhook-signature")- webhook_id = request.headers.get("webhook-id")- webhook_timestamp = request.headers.get("webhook-timestamp")- webhook_secret = os.getenv("COMPOSIO_WEBHOOK_SECRET")-- if not all([webhook_signature, webhook_id, webhook_timestamp, webhook_secret]):- raise HTTPException(status_code=400, detail="Missing required webhook headers or secret")-- if not webhook_signature.startswith("v1,"):- raise HTTPException(status_code=401, detail="Invalid signature format")-- received = webhook_signature[3:]- signing_string = f"{webhook_id}.{webhook_timestamp}.{body.decode()}"- expected = base64.b64encode(- hmac.new(webhook_secret.encode(), signing_string.encode(), hashlib.sha256).digest()- ).decode()-- if not hmac.compare_digest(received, expected):- raise HTTPException(status_code=401, detail="Invalid webhook signature")-- return True-[email protected]("/webhook")-async def webhook_handler(request: Request):- payload = await request.json()-- trigger_type = payload.get("type")- event_data = payload.get("data", {})-- if trigger_type == "github_star_added_event":- repo_name = event_data.get("repository_name")- starred_by = event_data.get("starred_by")- print(f"Repository {repo_name} starred by {starred_by}")- # Add your business logic here-- return {"status": "success", "message": "Webhook processed"}-diff --git a/fern/snippets/triggers/python/triggers.py b/fern/snippets/triggers/python/triggers.pydeleted file mode 100644index 1b753e26d..000000000--- a/fern/snippets/triggers/python/triggers.py+++ /dev/null@@ -1,17 +0,0 @@-from composio import Composio--composio = Composio(api_key="your-api-key")-user_id = "user-id-123435"--# Check what configuration is required-trigger_type = composio.triggers.get_type("GITHUB_COMMIT_EVENT")-print(trigger_type.config)-# Returns: {"properties": {...}, "required": ["owner", "repo"], ...}--# Create trigger with the required config-trigger = composio.triggers.create(- slug="GITHUB_COMMIT_EVENT",- user_id=user_id,- trigger_config={"owner": "your-repo-owner", "repo": "your-repo-name"},-)-print(f"Trigger created: {trigger.trigger_id}")diff --git a/fern/snippets/triggers/typescript/trigger-subscription.ts b/fern/snippets/triggers/typescript/trigger-subscription.tsdeleted file mode 100644index 6b3c0dcb2..000000000--- a/fern/snippets/triggers/typescript/trigger-subscription.ts+++ /dev/null@@ -1,20 +0,0 @@-import { Composio } from '@composio/core';--// Initialize Composio client-const composio = new Composio({ apiKey: "your_api_key_here" });--// Subscribe to trigger events-composio.triggers.subscribe(- (data) => {- console.log(`New commit detected:`, data);- // Add your custom logic here- },- { triggerId: 'your_trigger_id'- // userId: '[email protected]',- // toolkits: ['github', 'slack'],- // triggerSlug: ["GITHUB_STAR_ADDED_EVENT"]- // authConfigId: "ac_1234567890" }- }-);--// Note: For production use, set up webhooks instead\ No newline at end of filediff --git a/fern/snippets/triggers/typescript/trigger-types.ts b/fern/snippets/triggers/typescript/trigger-types.tsdeleted file mode 100644index cf1a2e8ed..000000000--- a/fern/snippets/triggers/typescript/trigger-types.ts+++ /dev/null@@ -1,58 +0,0 @@-import { Composio, TriggerEvent } from '@composio/core';--// Define type-safe payload for GitHub Star Added event-export type GitHubStarAddedEventPayload = {- action: "created";- repository_id: number;- repository_name: string;- repository_url: string;- starred_at: string;- starred_by: string;-};--const composio = new Composio();-const userId = '[email protected]';--// Create the trigger-const createResponse = await composio.triggers.create(userId, 'GITHUB_STAR_ADDED_EVENT', {- triggerConfig: {- owner: 'composiohq',- repo: 'composio',- },-});--// Fetch trigger type details-const triggerType = await composio.triggers.getType("GITHUB_STAR_ADDED_EVENT");-console.log(triggerType.config);--// Type-safe trigger event handler-function handleGitHubStarEvent(event: TriggerEvent<GitHubStarAddedEventPayload>) {- console.log(`⭐ ${event.data.repository_name} starred by ${event.data.starred_by}`);-}--// Subscribe to triggers with type-safe handling-await composio.triggers.subscribe(- (triggerData) => {- if (triggerData.triggerSlug === 'GITHUB_STAR_ADDED_EVENT') {- const starEvent: TriggerEvent<GitHubStarAddedEventPayload> = {- type: triggerData.triggerSlug,- timestamp: new Date().toISOString(),- data: {- ...triggerData.payload as GitHubStarAddedEventPayload,- connection_nano_id: triggerData.metadata.connectedAccount.id,- trigger_nano_id: triggerData.id,- user_id: triggerData.userId,- }- };- handleGitHubStarEvent(starEvent);- }- },- {- authConfigId: 'ac_1234567890',- triggerSlug: ['GITHUB_STAR_ADDED_EVENT'],- }-);--await composio.triggers.enable('ti_9q19nLNykmVZ');-await composio.triggers.disable('ti_9q19nLNykmVZ');-diff --git a/fern/snippets/triggers/typescript/trigger-webhook.ts b/fern/snippets/triggers/typescript/trigger-webhook.tsdeleted file mode 100644index fd41c1b9a..000000000--- a/fern/snippets/triggers/typescript/trigger-webhook.ts+++ /dev/null@@ -1,57 +0,0 @@-import type { NextApiRequest, NextApiResponse } from 'next';-import { TriggerEvent } from '@composio/core';-import crypto from 'crypto';--type GitHubStarEventData = {- repository_name: string;- repository_url: string;- starred_by: string;- starred_at: string;-};--function verifyWebhookSignature(- req: NextApiRequest,- body: string-): boolean {- const signature = req.headers['webhook-signature'] as string | undefined;- const msgId = req.headers['webhook-id'] as string | undefined;- const timestamp = req.headers['webhook-timestamp'] as string | undefined;- const secret = process.env.COMPOSIO_WEBHOOK_SECRET;-- if (!signature || !msgId || !timestamp || !secret) {- throw new Error('Missing required webhook headers or secret');- }-- if (!signature.startsWith('v1,')) {- throw new Error('Invalid signature format');- }-- const received = signature.slice(3);- const signingString = `${msgId}.${timestamp}.${body}`;- const expected = crypto- .createHmac('sha256', secret)- .update(signingString)- .digest('base64');-- return crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));-}--export default async function webhookHandler(req: NextApiRequest, res: NextApiResponse) {- const payload = req.body;-- if (payload.type === 'github_star_added_event') {- const event: TriggerEvent<GitHubStarEventData> = {- type: payload.type,- timestamp: payload.timestamp,- data: payload.data- };-- console.log(`Repository ${event.data.repository_name} starred by ${event.data.starred_by}`);- // Add your business logic here- }-- res.status(200).json({- status: 'success',- message: 'Webhook processed'- });-}diff --git a/fern/snippets/triggers/typescript/triggers.ts b/fern/snippets/triggers/typescript/triggers.tsdeleted file mode 100644index bd86575a2..000000000--- a/fern/snippets/triggers/typescript/triggers.ts+++ /dev/null@@ -1,22 +0,0 @@-import { Composio } from '@composio/core';--const composio = new Composio({apiKey: "your-api-key"});-const userId = 'user-id-123435';--// Check what configuration is required-const triggerType = await composio.triggers.getType("GITHUB_COMMIT_EVENT");-console.log(triggerType.config);-// Returns: {"properties": {...}, "required": ["owner", "repo"], ...}--// Create trigger with the required config-const trigger = await composio.triggers.create(- userId,- 'GITHUB_COMMIT_EVENT',- {- triggerConfig: {- owner: 'your-repo-owner',- repo: 'your-repo-name'- }- }-);-console.log(`Trigger created: ${trigger.triggerId}`);\ No newline at end of filediff --git a/fern/tailwind.config.js b/fern/tailwind.config.jsdeleted file mode 100644index 7236aff87..000000000--- a/fern/tailwind.config.js+++ /dev/null@@ -1,14 +0,0 @@-const plugin = require("tailwindcss");--/** @type {import('tailwindcss').Config} */-module.exports = {- darkMode: "class",- content: ["./**/*.{md,mdx,tsx}", "./fern/assets/input.css"],- theme: {- extend: {},- },- plugins: [],- future: {- hoverOnlyWhenSupported: true,- },-};diff --git a/fern/toolkits/src/introduction.mdx b/fern/toolkits/src/introduction.mdxdeleted file mode 100644index 07d4d06c6..000000000--- a/fern/toolkits/src/introduction.mdx+++ /dev/null@@ -1,37 +0,0 @@-----title: Introduction to Tools------Tools are the building blocks of Composio. They are used to interact with external APIs and services.--Composio comes with support for 250+ apps with built in authentication and actions.--<CardGroup>-<Card title="Twitter Tool" href="/toolkits/twitter" icon="fa-brands fa-x-twitter">-View the authentication and actions for the Twitter tool.-</Card>--<Card title="Gmail Tool" href="/toolkits/gmail" icon="fa-light fa-envelope">- View the authentication and actions for the Gmail tool.-</Card>--<Card title="Github Tool" href="/toolkits/github" icon="fa-brands fa-github">- View the authentication and actions for the Github tool.-</Card>--<Card title="Notion Tool" href="/toolkits/notion" icon="fa-light fa-book">- View the authentication and actions for the Notion tool.-</Card>--<Card title="Google Sheets Tool" href="/toolkits/googlesheets" icon="fa-light fa-file-spreadsheet">- View the authentication and actions for the Google Sheets tool.-</Card>--<Card title="Shopify Tool" href="/toolkits/shopify" icon="fa-brands fa-shopify">- View the authentication and actions for the Shopify tool.-</Card>--<Card title="Stripe Tool" href="/toolkits/stripe" icon="fa-brands fa-stripe">-View the authentication and actions for the Stripe tool.-</Card>-</CardGroup>diff --git a/fern/toolkits/src/premium-tools.mdx b/fern/toolkits/src/premium-tools.mdxdeleted file mode 100644index 48e38f7b8..000000000--- a/fern/toolkits/src/premium-tools.mdx+++ /dev/null@@ -1,66 +0,0 @@-----title: Premium Tools-image: "https://og.composio.dev/api/og?title=Premium%20Tools" # image for socials-keywords: 'premium tools, composio premium tools, composio premium tools documentation, pricing'-hide-nav-links: false------This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.---## What are premium tools?--Premium tools are essential tool calls that cost us more to run, normally paying for more premium services or longer running tasks.--Think something like `E2B` or `Firecrawl`, these are not really comparable to a `GMAIL_SEND_EMAIL` call.--These types of tools are separated out so we can pricing both of them competitively.--This is the current list of premium tools, more will be added over time and this list might change in the future.--- [Composio Search](/tools/composio_search)-- [Code Interpreter (E2B)](/tools/codeinterpreter)-- [Firecrawl](/tools/firecrawl)-- [Perplexity](/tools/perplexity)-- [Exa](/tools/exa)-- [SerpAPI](/tools/serpapi)---## 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.---| Plan | Included Standard Tool Calls | Included Premium Tool Calls | Usage Based Standard Tool Calls | Usage Based Premium Tool Calls |-|---------------------|-----------------------------|----------------------------|-------------------------------|------------------------------|-| Totally Free | 20k | 1k | – | – |-| Ridiculously Cheap | 250k | 5k | $0.299/1k | $0.897/1k |-| 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?--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.--| Spending Tier | Standard Tool Calls Rate Limit | Premium Tool Calls Rate Limit |-|---------------------|-------------------------------|------------------------------|-| Free | 1,000/hour | 100/hour |-| Ridiculously Cheap | 100,000/hour | 10,000/hour |-| Serious Business | 100,000/hour | 10,000/hour |-| Enterprise | Flexible | Flexible |-------## 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]).\ No newline at end of filediff --git a/fern/tsconfig.json b/fern/tsconfig.jsondeleted file mode 100644index d64d5bac5..000000000--- a/fern/tsconfig.json+++ /dev/null@@ -1,11 +0,0 @@-{- "$schema": "https://json.schemastore.org/tsconfig",- "extends": "../tsconfig.base.json",- "include": ["pages/**/*", "src/**/*"],- "exclude": ["node_modules", "dist"],- "compilerOptions": {- "module": "esnext",- "target": "es2022",- "moduleResolution": "bundler"- }-}\ No newline at end of filediff --git a/fern/tsconfig.typedoc.json b/fern/tsconfig.typedoc.jsondeleted file mode 100644index 08c16002e..000000000--- a/fern/tsconfig.typedoc.json+++ /dev/null@@ -1,26 +0,0 @@-{- "compilerOptions": {- "target": "ES2022",- "module": "esnext",- "moduleResolution": "bundler",- "skipLibCheck": true,- "strict": false,- "resolveJsonModule": true,- "declaration": true,- "esModuleInterop": true,- "lib": ["ES2022", "DOM"],- "types": ["node"],- "noEmit": true,- "allowJs": true- },- "include": [- "../ts/packages/core/src/**/*.ts"- ],- "exclude": [- "**/*.test.ts",- "**/*.spec.ts",- "**/test/**",- "**/tests/**",- "**/node_modules/**"- ]-}\ No newline at end of filediff --git a/fern/turbo.json b/fern/turbo.jsondeleted file mode 100644index b865db424..000000000--- a/fern/turbo.json+++ /dev/null@@ -1,132 +0,0 @@-{- "$schema": "https://turbo.build/schema.json",- "extends": ["//"],- "tasks": {- "build": {- "dependsOn": ["api:pull", "add-og", "snippets:build", "tools:generate", "sdkdocs"],- "outputs": ["apis/openapi.json", "apis/openapi-mcp.json", "pages/dist/**", "toolkits/**"],- "cache": true- },-- "dev:deps": {- "dependsOn": ["api:pull", "add-og", "sdkdocs", "tools:generate:dev", "snippets:build"],- "cache": false- },-- "dev": {- "dependsOn": ["dev:deps"],- "persistent": true,- "cache": false- },-- "dev:all": {- "dependsOn": ["dev:deps"],- "persistent": true,- "cache": false- },-- "api:pull": {- "outputs": ["apis/openapi.json", "apis/openapi-mcp.json"],- "cache": true- },-- "add-og": {- "inputs": ["scripts/add_og_imgs.py", "pages/**/*.mdx"],- "cache": false- },-- "snippets:build": {- "dependsOn": ["^build"],- "outputs": ["pages/dist/**"],- "inputs": ["scripts/build-snippets.ts", "snippets/**", "docs/**"],- "cache": true- },-- "snippets:dev": {- "persistent": true,- "cache": false- },-- "tools:generate": {- "outputs": ["toolkits/**"],- "inputs": ["generators/tool_doc_generator/**/*.py", "generators/tool_doc_generator/templates/**/*"],- "cache": true,- "env": ["COMPOSIO_API_KEY"]- },- "tools:generate:dev": {- "cache": false,- "inputs": ["generators/tool_doc_generator/**/*.py", "generators/tool_doc_generator/templates/**/*"],- "env": ["COMPOSIO_API_KEY", "LIMIT"]- },-- "sdkdocs": {- "dependsOn": ["^build", "sdkdocs:ts", "sdkdocs:python"],- "outputs": ["pages/dist/sdk/**"],- "cache": true- },-- "sdkdocs:ts": {- "dependsOn": ["^build"],- "outputs": ["pages/dist/sdk/typescript/**"],- "inputs": ["../ts/packages/core/**/*.ts", "../ts/packages/providers/**/*.ts", "typedoc.json"],- "cache": true- },-- "sdkdocs:python": {- "dependsOn": ["^build"],- "outputs": ["pages/dist/sdk/python/**"],- "inputs": ["generators/python-sdk/templates/**/*.md", "generators/python-sdk/**/*.py"],- "cache": true- },-- "llms:build": {- "dependsOn": ["build"],- "outputs": ["llms-txt/public/llms.txt"],- "inputs": ["docs.yml", "pages/**/*.mdx", "pages/**/*.md", "toolkits/**/*.mdx", "scripts/build-llms-txt.ts"],- "cache": true- },-- "llms:dev": {- "persistent": true,- "cache": false- },-- "llms:deploy": {- "dependsOn": ["llms:build"],- "cache": false,- "env": ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]- },-- "check": {- "dependsOn": ["snippets:build"],- "cache": false- },-- "links": {- "dependsOn": ["snippets:build"],- "cache": false- },-- "preview": {- "dependsOn": ["build"],- "cache": false,- "env": ["FERN_TOKEN"]- },-- "publish": {- "dependsOn": ["build", "llms:deploy"],- "cache": false,- "env": ["FERN_TOKEN", "POSTHOG_API_KEY", "CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]- },-- "clean": {- "cache": false- },-- "compile": {- "outputs": ["dist/output.css"],- "inputs": ["assets/input.css", "tailwind.config.js"],- "cache": true- }- }-}diff --git a/fern/typedoc.json b/fern/typedoc.jsondeleted file mode 100644index 59355ac12..000000000--- a/fern/typedoc.json+++ /dev/null@@ -1,40 +0,0 @@-{- "plugin": ["typedoc-plugin-zod", "typedoc-plugin-markdown"],- "out": "./pages/dist/sdk/typescript",- "fileExtension": ".mdx",- "flattenOutputFiles": false,- "useHTMLEncodedBrackets": false,- "sanitizeComments": false,- "readme": "none",- "entryPoints": [- "../ts/packages/core/src/composio.ts",- "../ts/packages/core/src/models/AuthConfigs.ts",- "../ts/packages/core/src/models/ConnectedAccounts.ts",- "../ts/packages/core/src/models/ConnectionRequest.ts",- "../ts/packages/core/src/models/CustomTools.ts",- "../ts/packages/core/src/models/Toolkits.ts",- "../ts/packages/core/src/models/Tools.ts",- "../ts/packages/core/src/models/Triggers.ts",- "../ts/packages/core/src/models/ToolRouter.ts",- "../ts/packages/core/src/provider/BaseProvider.ts",- "../ts/packages/core/src/provider/ComposioProvider.ts",- "../ts/packages/core/src/provider/OpenAIProvider.ts"- ],- "tsconfig": "./tsconfig.typedoc.json",- "skipErrorChecking": true,- "treatWarningsAsErrors": false,- "validation": {- "notExported": false,- "invalidLink": false,- "notDocumented": false- },- "exclude": [- "**/errors/**",- "**/types/**",- "**/utils/**",- "**/services/**",- "**/telemetry/**",- "**/*.test.ts",- "**/*.spec.ts"- ]-}diff --git a/pyproject.toml b/pyproject.tomlindex 286f0009a..b80f27c8e 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -9,8 +9,6 @@ members = ["python/providers/langchain","python/providers/openai","python/providers/openai_agents",- "fern/snippets/migration",- "fern"][tool.uv.sources]@@ -24,8 +22,6 @@ composio-google-adk = { workspace = true }composio-openai = { workspace = true }composio-openai-agents = { workspace = true }-# Fern packages-fern = { workspace = true }composio = { workspace = true }[dependency-groups]