Skip to content

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

chore(toolchain): finish mise migration (#3493)

Alberto Schiabel4fe776898a38
diff --git a/.bun-version b/.bun-version
deleted file mode 100644
index 0c00f6108..000000000
--- a/.bun-version
+++ /dev/null
@@ -1 +0,0 @@
-1.3.10
diff --git a/.dvmrc b/.dvmrc
deleted file mode 100644
index e261122d5..000000000
--- a/.dvmrc
+++ /dev/null
@@ -1 +0,0 @@
-2.6.7
diff --git a/.github/actions/setup-node-pnpm-bun/action.yml b/.github/actions/setup-node-pnpm-bun/action.yml
index 3d6fa30f5..ca44976fd 100644
--- a/.github/actions/setup-node-pnpm-bun/action.yml
+++ b/.github/actions/setup-node-pnpm-bun/action.yml
@@ -1,43 +1,95 @@
-name: 'Setup Node.js, pnpm, Bun'
-description: 'Sets up Node.js and pnpm with caching (using .nvmrc for version), and Bun (using .bun-version for version)'
+name: 'Setup Node.js, pnpm, Bun via mise'
+description: 'Sets up Node.js, pnpm, and Bun from mise.toml unless explicit matrix overrides are provided'
inputs:
node-version:
- description: 'Node.js version to use. Defaults to .nvmrc file'
+ description: 'Node.js version to use. Defaults to mise.toml'
required: false
default: ''
- node-version-file:
- description: 'Path to .nvmrc or similar file'
- required: false
- default: '.nvmrc'
bun-version:
- description: 'Bun version to use. Defaults to .bun-version file'
+ description: 'Bun version to use. Defaults to mise.toml'
required: false
default: ''
- bun-version-file:
- description: 'Path to .bun-version or similar file'
- required: false
- default: '.bun-version'
enable-caching:
- description: 'Enable pnpm caching'
+ description: 'Enable pnpm/tool cache'
required: false
default: 'true'
+outputs:
+ node-version:
+ description: 'The installed Node.js version'
+ value: ${{ steps.versions.outputs.node }}
+ bun-version:
+ description: 'The installed Bun version'
+ value: ${{ steps.versions.outputs.bun }}
+ pnpm-version:
+ description: 'The installed pnpm version'
+ value: ${{ steps.versions.outputs.pnpm }}
+
runs:
using: 'composite'
steps:
- - name: Setup pnpm
- uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
+ - name: Setup mise
+ uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
+ with:
+ version: 2026.5.18
+ install: false
+ cache: ${{ inputs.enable-caching }}
- - name: Setup Node.js
+ - name: Install mise-managed Node.js and Bun
+ shell: bash
+ env:
+ NODE_VERSION: ${{ inputs.node-version }}
+ BUN_VERSION: ${{ inputs.bun-version }}
+ run: |
+ tools=()
+ if [ -z "$NODE_VERSION" ]; then
+ tools+=(node)
+ fi
+ if [ -z "$BUN_VERSION" ]; then
+ tools+=(bun)
+ fi
+ if [ "${#tools[@]}" -gt 0 ]; then
+ mise install "${tools[@]}"
+ fi
+
+ - name: Setup Node.js override
+ if: inputs.node-version != ''
uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
with:
node-version: ${{ inputs.node-version }}
- node-version-file: ${{ inputs.node-version == '' && inputs.node-version-file || '' }}
- cache: ${{ inputs.enable-caching == 'true' && 'pnpm' || '' }}
- - name: Setup Bun
+ - name: Setup Bun override
+ if: inputs.bun-version != ''
uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
with:
bun-version: ${{ inputs.bun-version }}
- bun-version-file: ${{ inputs.bun-version == '' && inputs.bun-version-file || '' }}
+
+ - name: Install mise-managed pnpm
+ shell: bash
+ run: mise install npm:pnpm
+
+ - name: Resolve pnpm store path and Node version
+ if: inputs.enable-caching == 'true'
+ id: pnpm-store
+ shell: bash
+ run: |
+ echo "STORE_PATH=$(pnpm store path --silent)" >> "$GITHUB_OUTPUT"
+ echo "NODE_VERSION=$(node --version | sed 's/^v//')" >> "$GITHUB_OUTPUT"
+
+ - name: Cache pnpm store
+ if: inputs.enable-caching == 'true'
+ uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
+ with:
+ path: ${{ steps.pnpm-store.outputs.STORE_PATH }}
+ key: ${{ runner.os }}-node${{ steps.pnpm-store.outputs.NODE_VERSION }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+ restore-keys: |
+ ${{ runner.os }}-node${{ steps.pnpm-store.outputs.NODE_VERSION }}-pnpm-store-
+
+ - name: Report versions
+ id: versions
+ shell: bash
+ run: |
+ echo "node=$(node --version | sed 's/^v//')" >> "$GITHUB_OUTPUT"
+ echo "bun=$(bun --version)" >> "$GITHUB_OUTPUT"
+ echo "pnpm=$(pnpm --version)" >> "$GITHUB_OUTPUT"
diff --git a/.github/actions/setup-python-uv/action.yml b/.github/actions/setup-python-uv/action.yml
index a7710ba75..e67f6d828 100644
--- a/.github/actions/setup-python-uv/action.yml
+++ b/.github/actions/setup-python-uv/action.yml
@@ -1,41 +1,66 @@
-name: 'Setup Python with UV'
-description: 'Sets up Python and UV package manager, using .python-version for version'
+name: 'Setup Python with uv via mise'
+description: 'Sets up Python and uv from mise.toml unless explicit matrix overrides are provided'
inputs:
python-version:
- description: 'Python version to use. Defaults to .python-version file'
+ description: 'Python version to use. Defaults to mise.toml'
required: false
default: ''
- python-version-file:
- description: 'Path to .python-version or similar file'
- required: false
- default: '.python-version'
uv-version:
- description: 'UV version to install'
+ description: 'uv version to install. Defaults to mise.toml'
required: false
- default: 'latest'
+ default: ''
enable-caching:
- description: 'Enable UV caching'
+ description: 'Enable uv/tool cache'
required: false
default: 'true'
outputs:
python-version:
description: 'The installed Python version (e.g., 3.12.0)'
- value: ${{ steps.setup-python.outputs.python-version }}
+ value: ${{ steps.versions.outputs.python }}
runs:
using: 'composite'
steps:
- - name: Setup Python
- id: setup-python
+ - name: Setup mise
+ uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
+ with:
+ version: 2026.5.18
+ install: false
+ cache: ${{ inputs.enable-caching }}
+
+ - name: Install mise-managed Python and uv
+ shell: bash
+ env:
+ PYTHON_VERSION: ${{ inputs.python-version }}
+ UV_VERSION: ${{ inputs.uv-version }}
+ run: |
+ tools=()
+ if [ -z "$PYTHON_VERSION" ]; then
+ tools+=(python)
+ fi
+ if [ -z "$UV_VERSION" ]; then
+ tools+=(uv)
+ fi
+ if [ "${#tools[@]}" -gt 0 ]; then
+ mise install "${tools[@]}"
+ fi
+
+ - name: Setup Python override
+ if: inputs.python-version != ''
uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
with:
python-version: ${{ inputs.python-version }}
- python-version-file: ${{ inputs.python-version == '' && inputs.python-version-file || '' }}
- - name: Install UV
+ - name: Setup uv override
+ if: inputs.uv-version != ''
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
with:
version: ${{ inputs.uv-version }}
enable-cache: ${{ inputs.enable-caching }}
+
+ - name: Report versions
+ id: versions
+ shell: bash
+ run: echo "python=$(python --version | awk '{print $2}')" >> "$GITHUB_OUTPUT"
diff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.yml
index eba59e046..6119fc12a 100644
--- a/.github/workflows/build-cli-binaries.yml
+++ b/.github/workflows/build-cli-binaries.yml
@@ -6,6 +6,10 @@ on:
paths:
- 'ts/packages/cli/**'
- 'ts/packages/cli-local-tools/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/build-cli-binaries.yml'
+ - 'mise.toml'
+ - 'mise.lock'
workflow_dispatch:
inputs:
action:
diff --git a/.github/workflows/cli.test-installation.yml b/.github/workflows/cli.test-installation.yml
index 5ff4d74ac..c4a0c5e86 100644
--- a/.github/workflows/cli.test-installation.yml
+++ b/.github/workflows/cli.test-installation.yml
@@ -20,6 +20,19 @@ on:
type: string
jobs:
+ toolchain-versions:
+ name: Read toolchain test matrix
+ runs-on: ubuntu-latest
+ outputs:
+ node_install_compat: ${{ steps.versions.outputs.node_install_compat }}
+ steps:
+ - name: Checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+ - name: Read versions
+ id: versions
+ run: echo "node_install_compat=$(jq -c '.node_install_compat' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
+
install-script-unit-tests:
name: Install Script Unit Tests
runs-on: ubuntu-latest
@@ -419,12 +432,13 @@ jobs:
test-npm-fallback:
name: Test npm Installation Fallback
+ needs: toolchain-versions
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-15]
- node-version: [18, 20, 22]
+ node-version: ${{ fromJSON(needs.toolchain-versions.outputs.node_install_compat) }}
steps:
- name: Checkout
@@ -558,7 +572,14 @@ jobs:
summary:
name: Installation Test Summary
- needs: [install-script-unit-tests, test-install-script, test-npm-fallback, test-architecture-detection, test-prerequisites]
+ needs:
+ [
+ install-script-unit-tests,
+ test-install-script,
+ test-npm-fallback,
+ test-architecture-detection,
+ test-prerequisites,
+ ]
runs-on: ubuntu-latest
if: always()
diff --git a/.github/workflows/docs-check-links.yml b/.github/workflows/docs-check-links.yml
index bf4cef573..1b700a7f8 100644
--- a/.github/workflows/docs-check-links.yml
+++ b/.github/workflows/docs-check-links.yml
@@ -4,6 +4,10 @@ on:
pull_request:
paths:
- 'docs/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/docs-check-links.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
check-links:
@@ -16,10 +20,8 @@ jobs:
- name: Checkout repository
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
- - name: Setup Bun
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
- with:
- bun-version-file: '.bun-version'
+ - name: Setup Node.js, pnpm, Bun
+ uses: ./.github/actions/setup-node-pnpm-bun
- name: Install dependencies
run: bun install
diff --git a/.github/workflows/docs-search-sync.yml b/.github/workflows/docs-search-sync.yml
index 9de6c2e8f..0dfa6c636 100644
--- a/.github/workflows/docs-search-sync.yml
+++ b/.github/workflows/docs-search-sync.yml
@@ -6,6 +6,10 @@ on:
- next
paths:
- 'docs/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/docs-search-sync.yml'
+ - 'mise.toml'
+ - 'mise.lock'
workflow_dispatch:
permissions:
@@ -26,10 +30,8 @@ jobs:
- name: Checkout repository
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
- - name: Setup Bun
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
- with:
- bun-version-file: '.bun-version'
+ - name: Setup Node.js, pnpm, Bun
+ uses: ./.github/actions/setup-node-pnpm-bun
- name: Install dependencies
run: bun install
diff --git a/.github/workflows/docs-tests.yml b/.github/workflows/docs-tests.yml
index 80b709d41..7354b4c47 100644
--- a/.github/workflows/docs-tests.yml
+++ b/.github/workflows/docs-tests.yml
@@ -4,6 +4,10 @@ on:
pull_request:
paths:
- 'docs/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/docs-tests.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
test:
@@ -16,10 +20,8 @@ jobs:
- name: Checkout repository
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
- - name: Setup Bun
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
- with:
- bun-version-file: '.bun-version'
+ - name: Setup Node.js, pnpm, Bun
+ uses: ./.github/actions/setup-node-pnpm-bun
- name: Install dependencies
run: bun install
diff --git a/.github/workflows/docs-typescript-check.yml b/.github/workflows/docs-typescript-check.yml
index 851e6482e..acd130af2 100644
--- a/.github/workflows/docs-typescript-check.yml
+++ b/.github/workflows/docs-typescript-check.yml
@@ -4,6 +4,10 @@ on:
pull_request:
paths:
- 'docs/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/docs-typescript-check.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
typescript-check:
@@ -16,10 +20,8 @@ jobs:
- name: Checkout repository
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
- - name: Setup Bun
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
- with:
- bun-version-file: '.bun-version'
+ - name: Setup Node.js, pnpm, Bun
+ uses: ./.github/actions/setup-node-pnpm-bun
- name: Install dependencies
run: bun install
diff --git a/.github/workflows/docs-update-data.yml b/.github/workflows/docs-update-data.yml
index a182edf67..ec6b2e68a 100644
--- a/.github/workflows/docs-update-data.yml
+++ b/.github/workflows/docs-update-data.yml
@@ -36,10 +36,8 @@ jobs:
echo "Timestamp: $DEPLOY_TIMESTAMP"
fi
- - name: Setup Bun
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
- with:
- bun-version-file: '.bun-version'
+ - name: Setup Node.js, pnpm, Bun
+ uses: ./.github/actions/setup-node-pnpm-bun
- name: Install dependencies
run: bun install
diff --git a/.github/workflows/generate-sdk-docs.yml b/.github/workflows/generate-sdk-docs.yml
index 73fb85fe0..4fb5c929a 100644
--- a/.github/workflows/generate-sdk-docs.yml
+++ b/.github/workflows/generate-sdk-docs.yml
@@ -6,6 +6,11 @@ on:
paths:
- 'ts/packages/core/src/**'
- 'python/composio/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/actions/setup-python-uv/action.yml'
+ - '.github/workflows/generate-sdk-docs.yml'
+ - 'mise.toml'
+ - 'mise.lock'
workflow_dispatch:
jobs:
diff --git a/.github/workflows/py.check.yaml b/.github/workflows/py.check.yaml
index 54409ccfc..4d25435e4 100644
--- a/.github/workflows/py.check.yaml
+++ b/.github/workflows/py.check.yaml
@@ -4,13 +4,19 @@ on:
branches:
- master
paths:
- - "python/**/*.py"
- - ".github/workflows/py.check.yaml"
+ - 'python/**/*.py'
+ - '.github/actions/setup-python-uv/action.yml'
+ - '.github/workflows/py.check.yaml'
+ - 'mise.toml'
+ - 'mise.lock'
pull_request:
types: [opened, synchronize]
paths:
- - "python/**/*.py"
- - ".github/workflows/py.check.yaml"
+ - 'python/**/*.py'
+ - '.github/actions/setup-python-uv/action.yml'
+ - '.github/workflows/py.check.yaml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
common-checks:
diff --git a/.github/workflows/py.test.yml b/.github/workflows/py.test.yml
index 12b91b693..ba8458a2b 100644
--- a/.github/workflows/py.test.yml
+++ b/.github/workflows/py.test.yml
@@ -4,25 +4,47 @@ on:
push:
branches: [master, next]
paths:
- - "python/**/*.py"
- - ".github/workflows/py.test.yml"
- - "python/pyproject.toml"
- - "python/requirements*.txt"
+ - 'python/**/*.py'
+ - '.github/workflows/py.test.yml'
+ - '.github/actions/setup-python-uv/action.yml'
+ - 'mise.toml'
+ - 'mise.lock'
+ - 'toolchain-versions.json'
+ - 'python/pyproject.toml'
+ - 'python/requirements*.txt'
pull_request:
branches: [master, next]
paths:
- - "python/**/*.py"
- - ".github/workflows/py.test.yml"
- - "python/pyproject.toml"
- - "python/requirements*.txt"
+ - 'python/**/*.py'
+ - '.github/workflows/py.test.yml'
+ - '.github/actions/setup-python-uv/action.yml'
+ - 'mise.toml'
+ - 'mise.lock'
+ - 'toolchain-versions.json'
+ - 'python/pyproject.toml'
+ - 'python/requirements*.txt'
jobs:
+ toolchain-versions:
+ name: Read toolchain test matrix
+ runs-on: ubuntu-latest
+ outputs:
+ python: ${{ steps.versions.outputs.python }}
+ steps:
+ - name: Checkout Code
+ uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+
+ - name: Read versions
+ id: versions
+ run: echo "python=$(jq -c '.python' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
+
test:
name: Test Python SDK
+ needs: toolchain-versions
runs-on: ubuntu-latest
strategy:
matrix:
- python-version: ["3.10", "3.11", "3.12"]
+ python-version: ${{ fromJSON(needs.toolchain-versions.outputs.python) }}
steps:
- name: Checkout Code
@@ -42,7 +64,9 @@ jobs:
pip-${{ matrix.python-version }}-
- name: Install UV
- run: pip install uv
+ run: |
+ UV_VERSION="$(sed -n 's/^uv[[:space:]]*=[[:space:]]*"\([^"]*\)"/\1/p' mise.toml)"
+ pip install "uv==${UV_VERSION}"
- name: Install Dependencies
run: |
@@ -104,30 +128,30 @@ jobs:
python -c "
# Test various import combinations that previously caused circular imports
import sys
-
+
# Test 1: Basic imports
from composio import Composio
print('✓ Basic Composio import')
-
+
# Test 2: Import toolkit version types
from composio import ToolkitVersionParam
from composio.core.types import ToolkitVersion
print('✓ Toolkit version types import')
-
+
# Test 3: Import from types module
from composio.types import Modifiers
print('✓ Types module import')
-
+
# Test 4: Import core models
from composio.core.models.tools import Tools
print('✓ Core models import')
-
+
# Test 5: Cross-module imports that caused the original circular import
from composio.core.models.tools import Modifiers as CoreModifiers
from composio.types import Modifiers as TypesModifiers
assert CoreModifiers is TypesModifiers
print('✓ Cross-module import consistency')
-
+
print('✓ All circular import prevention tests passed!')
"
@@ -164,27 +188,27 @@ jobs:
integration-tests:
name: Integration Tests
- runs-on: ubuntu-22.04 # Use Ubuntu 22.04 for stability
+ runs-on: ubuntu-22.04 # Use Ubuntu 22.04 for stability
permissions: read-all
env:
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
steps:
- name: Checkout repository
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
- name: Install UV
- uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
- with:
- version: '0.8.19'
+ id: setup-python
+ uses: ./.github/actions/setup-python-uv
- name: Cache UV dependencies
uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
with:
path: ~/.cache/uv
- key: uv-0.8.19-py3.12-${{ hashFiles('python/pyproject.toml') }}
+ key: uv-${{ hashFiles('mise.lock') }}-py${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('python/pyproject.toml') }}
restore-keys: |
- uv-0.8.19-py3.12-
+ uv-${{ hashFiles('mise.lock') }}-py${{ steps.setup-python.outputs.python-version }}-
- name: Install Python Dependencies
working-directory: ./python
@@ -201,7 +225,6 @@ jobs:
echo "✅ COMPOSIO_API_KEY is configured"
- name: Run Integration Tests
- continue-on-error: true
working-directory: ./python
run: |
echo "🧪 Running Integration Tests..."
diff --git a/.github/workflows/ts.audit.yml b/.github/workflows/ts.audit.yml
index 794413f1e..404896944 100644
--- a/.github/workflows/ts.audit.yml
+++ b/.github/workflows/ts.audit.yml
@@ -4,11 +4,19 @@ on:
push:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.audit.yml'
+ - 'mise.toml'
+ - 'mise.lock'
pull_request:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.audit.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
audit:
@@ -26,6 +34,11 @@ jobs:
with:
enable-caching: 'false'
+ - name: Verify mise.lock is fresh
+ run: |
+ mise lock --platform linux-x64,linux-arm64,macos-arm64,macos-x64
+ git diff --exit-code mise.lock
+
- name: Run pnpm audit (production dependencies only)
id: audit
continue-on-error: true
diff --git a/.github/workflows/ts.build.yml b/.github/workflows/ts.build.yml
index ef8403aa5..1e085610e 100644
--- a/.github/workflows/ts.build.yml
+++ b/.github/workflows/ts.build.yml
@@ -4,10 +4,18 @@ on:
push:
branches: [master]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.build.yml'
+ - 'mise.toml'
+ - 'mise.lock'
pull_request:
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.build.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
build:
diff --git a/.github/workflows/ts.test-e2e.yml b/.github/workflows/ts.test-e2e.yml
index eda02e7c1..3597edc45 100644
--- a/.github/workflows/ts.test-e2e.yml
+++ b/.github/workflows/ts.test-e2e.yml
@@ -5,26 +5,55 @@ on:
branches: [master, next]
paths:
- 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.test-e2e.yml'
+ - 'mise.toml'
+ - 'mise.lock'
+ - 'toolchain-versions.json'
pull_request:
paths:
- 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.test-e2e.yml'
+ - 'mise.toml'
+ - 'mise.lock'
+ - 'toolchain-versions.json'
workflow_dispatch:
jobs:
+ toolchain-versions:
+ name: Read toolchain test matrix
+ runs-on: ubuntu-24.04
+ permissions: read-all
+ outputs:
+ node: ${{ steps.versions.outputs.node }}
+ deno: ${{ steps.versions.outputs.deno }}
+ steps:
+ - name: Checkout Code
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+ - name: Read versions
+ id: versions
+ run: |
+ echo "node=$(jq -c '.node' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
+ echo "deno=$(jq -c '.deno' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
+
# Node.js E2E tests, running in Docker to isolate environment
# Each test suite defines its own nodeVersions in e2e.test.ts
# Tests that don't support the matrix version are automatically skipped
test-e2e-node-docker:
name: E2E Test Node.js ${{ matrix.node-version }}
+ needs: toolchain-versions
runs-on: ubuntu-24.04
permissions: read-all
strategy:
fail-fast: false
matrix:
- node-version: ['20.18.0', '20.19.0', '22.12.0']
+ node-version: ${{ fromJSON(needs.toolchain-versions.outputs.node) }}
env:
CI: 1
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
COMPOSIO_USER_API_KEY: ${{ secrets.COMPOSIO_USER_API_KEY }}
COMPOSIO_E2E_NODE_VERSION: ${{ matrix.node-version }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
@@ -37,8 +66,10 @@ jobs:
run: |
echo "COMPOSIO_USER_API_KEY=${COMPOSIO_USER_API_KEY}" >> "$GITHUB_ENV"
echo "COMPOSIO_API_KEY=${COMPOSIO_API_KEY}" >> "$GITHUB_ENV"
+ echo "COMPOSIO_BASE_URL=${COMPOSIO_BASE_URL}" >> "$GITHUB_ENV"
- name: Setup Node.js, pnpm, Bun
+ id: setup-toolchain
uses: ./.github/actions/setup-node-pnpm-bun
- name: Install Dependencies
@@ -51,6 +82,7 @@ jobs:
run: |
docker build -f ts/e2e-tests/_utils/Dockerfile.node \
--build-arg NODE_VERSION=${{ matrix.node-version }} \
+ --build-arg BUN_VERSION=${{ steps.setup-toolchain.outputs.bun-version }} \
--label composio.e2e=true \
--label composio.runtime=node \
--label "composio.node_version=${{ matrix.node-version }}" \
@@ -65,15 +97,17 @@ jobs:
# Tests that don't support the matrix version are automatically skipped
test-e2e-deno-docker:
name: E2E Test Deno ${{ matrix.deno-version }}
+ needs: toolchain-versions
runs-on: ubuntu-24.04
permissions: read-all
strategy:
fail-fast: false
matrix:
- deno-version: ['2.6.7']
+ deno-version: ${{ fromJSON(needs.toolchain-versions.outputs.deno) }}
env:
CI: 1
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
COMPOSIO_USER_API_KEY: ${{ secrets.COMPOSIO_USER_API_KEY }}
COMPOSIO_E2E_DENO_VERSION: ${{ matrix.deno-version }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
@@ -86,6 +120,7 @@ jobs:
run: |
echo "COMPOSIO_USER_API_KEY=${COMPOSIO_USER_API_KEY}" >> "$GITHUB_ENV"
echo "COMPOSIO_API_KEY=${COMPOSIO_API_KEY}" >> "$GITHUB_ENV"
+ echo "COMPOSIO_BASE_URL=${COMPOSIO_BASE_URL}" >> "$GITHUB_ENV"
- name: Setup Deno
uses: denoland/setup-deno@667a34cdef165d8d2b2e98dde39547c9daac7282 # v2.0.4
@@ -93,6 +128,7 @@ jobs:
deno-version: ${{ matrix.deno-version }}
- name: Setup Node.js, pnpm, Bun
+ id: setup-toolchain
uses: ./.github/actions/setup-node-pnpm-bun
- name: Install Dependencies
@@ -113,6 +149,7 @@ jobs:
CI: 1
COMPOSIO_USER_API_KEY: ${{ secrets.COMPOSIO_USER_API_KEY }}
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
steps:
@@ -123,8 +160,10 @@ jobs:
run: |
echo "COMPOSIO_USER_API_KEY=${COMPOSIO_USER_API_KEY}" >> "$GITHUB_ENV"
echo "COMPOSIO_API_KEY=${COMPOSIO_API_KEY}" >> "$GITHUB_ENV"
+ echo "COMPOSIO_BASE_URL=${COMPOSIO_BASE_URL}" >> "$GITHUB_ENV"
- name: Setup Node.js, pnpm, Bun
+ id: setup-toolchain
uses: ./.github/actions/setup-node-pnpm-bun
- name: Install Dependencies
@@ -139,6 +178,8 @@ jobs:
echo "COMPOSIO_E2E_CLI_VERSION=${CLI_VERSION}" >> "$GITHUB_ENV"
docker build -f ts/e2e-tests/_utils/Dockerfile.cli \
--build-arg CLI_VERSION="${CLI_VERSION}" \
+ --build-arg NODE_VERSION="${{ steps.setup-toolchain.outputs.node-version }}" \
+ --build-arg BUN_VERSION="${{ steps.setup-toolchain.outputs.bun-version }}" \
--label composio.e2e=true \
--label composio.runtime=cli \
--label "composio.cli_version=${CLI_VERSION}" \
@@ -155,6 +196,7 @@ jobs:
permissions: read-all
env:
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
COMPOSIO_USER_API_KEY: ${{ secrets.COMPOSIO_USER_API_KEY }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
@@ -166,11 +208,12 @@ jobs:
run: |
echo "COMPOSIO_USER_API_KEY=${COMPOSIO_USER_API_KEY}" >> "$GITHUB_ENV"
echo "COMPOSIO_API_KEY=${COMPOSIO_API_KEY}" >> "$GITHUB_ENV"
+ echo "COMPOSIO_BASE_URL=${COMPOSIO_BASE_URL}" >> "$GITHUB_ENV"
- name: Setup Node.js, pnpm, Bun
uses: ./.github/actions/setup-node-pnpm-bun
with:
- node-version: '22.12.0'
+ node-version: '22.22.3'
- name: Install Dependencies
run: pnpm install --frozen-lockfile
@@ -196,4 +239,5 @@ jobs:
env:
COMPOSIO_USER_API_KEY: ${{ secrets.COMPOSIO_USER_API_KEY }}
COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+ COMPOSIO_BASE_URL: ${{ secrets.COMPOSIO_BASE_URL_STAGING }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
diff --git a/.github/workflows/ts.test.yml b/.github/workflows/ts.test.yml
index 7ee40e79b..cd50cd6ac 100644
--- a/.github/workflows/ts.test.yml
+++ b/.github/workflows/ts.test.yml
@@ -4,11 +4,19 @@ on:
push:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.test.yml'
+ - 'mise.toml'
+ - 'mise.lock'
pull_request:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.test.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
test:
diff --git a/.github/workflows/ts.typecheck.yml b/.github/workflows/ts.typecheck.yml
index 2931c6279..f6fbc4a3d 100644
--- a/.github/workflows/ts.typecheck.yml
+++ b/.github/workflows/ts.typecheck.yml
@@ -4,11 +4,19 @@ on:
push:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.typecheck.yml'
+ - 'mise.toml'
+ - 'mise.lock'
pull_request:
branches: [master, next]
paths:
- - "ts/**"
+ - 'ts/**'
+ - '.github/actions/setup-node-pnpm-bun/action.yml'
+ - '.github/workflows/ts.typecheck.yml'
+ - 'mise.toml'
+ - 'mise.lock'
jobs:
typecheck:
diff --git a/.gitignore b/.gitignore
index a92667e4e..08bf433b9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,7 @@ report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
# dotenv environment variable files
.env
+.envrc
.env.development.local
.env.test.local
.env.production.local
diff --git a/.nvmrc b/.nvmrc
deleted file mode 100644
index ccc4c6c7f..000000000
--- a/.nvmrc
+++ /dev/null
@@ -1 +0,0 @@
-20.20.2
diff --git a/.python-version b/.python-version
deleted file mode 100644
index e4fba2183..000000000
--- a/.python-version
+++ /dev/null
@@ -1 +0,0 @@
-3.12
diff --git a/AGENTS.md b/AGENTS.md
index c0ea63750..de0dd37dd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,7 @@ This is the Composio SDK v3 repository containing both TypeScript and Python SDK
## Common Development Commands
### Build and Development
+
```bash
pnpm build # Build all packages
pnpm build:packages # Build only TypeScript packages
@@ -25,6 +26,7 @@ pnpm test # Run tests
```
### Package Management
+
```bash
mise install # Install Node, Bun, Deno, Python, uv (one-time; needs mise — https://mise.jdx.dev/installing-mise.html)
corepack enable # Activate pnpm from package.json#packageManager
@@ -34,12 +36,14 @@ pnpm update:peer-deps # Update peer dependencies
```
### Creating New Components
+
```bash
pnpm create:provider <provider-name> [--agentic]
pnpm create:example <example-name>
```
### Release Management
+
```bash
pnpm changeset # Create changeset for releases
pnpm changeset:version # Version packages
@@ -49,6 +53,7 @@ pnpm changeset:release # Publish packages
## Project Architecture
### Repository Structure
+
```
composio/
├── ts/ # TypeScript SDK (main development)
@@ -68,6 +73,7 @@ composio/
### Core Packages
**@composio/core** — Main SDK functionality:
+
- `src/composio.ts` — Main Composio class
- `src/models/` — Core models (Tools, Toolkits, ConnectedAccounts, etc.)
- `src/provider/` — Base provider implementations
@@ -76,6 +82,7 @@ composio/
- `src/utils/` — Utility functions and helpers
**Provider Packages** — AI integrations:
+
- `@composio/openai`, `@composio/anthropic`, `@composio/google`
- `@composio/langchain`, `@composio/vercel`, `@composio/mastra`
@@ -92,17 +99,20 @@ composio/
## Development Workflow
### Testing
+
- Unit tests use **Vitest** — run with `pnpm test`
- Tests are in `test/` directories within each package
- Mock implementations in `test/utils/mocks/`
### Code Quality
+
- **ESLint** — config in `eslint.config.mjs`
- **Prettier** — for code formatting
- **TypeScript** — strict mode enabled
- **Husky** — pre-commit hooks for quality checks
### TypeScript E2E Tests
+
```bash
pnpm test:e2e # All (Node.js + Deno + Cloudflare)
pnpm test:e2e:node # Node.js CJS/ESM compatibility (Docker)
@@ -131,15 +141,19 @@ COMPOSIO_DISABLE_TELEMETRY # Optional: Set to "true" to disable telemetry
## Common Patterns
### Tool Execution
+
```typescript
const composio = new Composio({ apiKey: 'your-key' });
const result = await composio.tools.execute('TOOL_NAME', {
userId: 'user-id',
- arguments: { /* tool args */ }
+ arguments: {
+ /* tool args */
+ },
});
```
### Provider Integration
+
```typescript
import { OpenAIProvider } from '@composio/openai';
const provider = new OpenAIProvider({ apiKey: 'openai-key' });
@@ -148,6 +162,7 @@ const wrappedTools = provider.wrapTools(tools);
```
### Custom Tool Creation
+
```typescript
import { Composio, experimental_createTool } from '@composio/core';
import { z } from 'zod';
@@ -161,11 +176,11 @@ const myTool = experimental_createTool('MY_TOOL', {
name: 'My Tool',
description: 'Tool description',
inputParams: z.object({
- param: z.string().describe('Parameter description')
+ param: z.string().describe('Parameter description'),
}),
execute: async input => {
return { result: input.param };
- }
+ },
});
const session = await composio.create('user-id', {
@@ -176,6 +191,7 @@ const session = await composio.create('user-id', {
## Python SDK Development
### Setup
+
```bash
cd python
make env # Create virtual env with all dependencies
@@ -183,6 +199,7 @@ source .venv/bin/activate
```
### Commands
+
```bash
make fmt # Format code (ruff)
make chk # Check linting and type issues
@@ -192,6 +209,7 @@ make build # Build packages
```
### Code Quality
+
- **Formatter**: Ruff (Black-compatible, 88 char line length)
- **Linter**: Ruff
- **Type Checker**: mypy with strict optional typing
@@ -211,6 +229,12 @@ Toolchain versions are coalesced in `mise.toml`. To check the current values:
- **uv**: `mise current uv`
- **pnpm**: `node -p "require('./package.json').packageManager"`
-To bump, edit `mise.toml` (or `package.json#packageManager` for pnpm). The "Prerequisites" section in `ts/docs/internal/release.md` references `mise.toml` so it stays current automatically.
+To bump, edit `mise.toml` (or `package.json#packageManager` for pnpm), then run:
+
+```bash
+mise lock --platform linux-x64,linux-arm64,macos-arm64,macos-x64
+```
+
+Commit `mise.lock` with the version bump. The "Prerequisites" section in `ts/docs/internal/release.md` references `mise.toml` so it stays current automatically.
This monorepo uses pnpm workspaces and Turbo for efficient builds and development.
diff --git a/CLAUDE.md b/CLAUDE.md
index b8ccb6631..91bfe21d2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -31,7 +31,7 @@ composio/
```bash
mise install # Installs Node, Bun, Deno, Python, uv from mise.toml (one-time per machine)
corepack enable # Activates pnpm pinned in package.json#packageManager
-pnpm install # First-time setup. Use BYPASS_BUN_VERSION_CHECK=1 if .bun-version mismatch
+pnpm install # First-time setup
pnpm build # Build all packages (Turbo)
pnpm build:packages # TS packages only
pnpm lint / lint:fix
@@ -47,7 +47,7 @@ pnpm create:provider <name> [--agentic]
pnpm create:example <name>
```
-Toolchain versions are pinned in `mise.toml` (Node, Bun, Deno, Python, uv) and `package.json#packageManager` (pnpm via corepack). Install mise once with `brew install mise` (macOS), `winget install jdx.mise` (Windows), or `curl https://mise.run | sh` (any), then activate it in your shell — see https://mise.jdx.dev/installing-mise.html. Legacy `.nvmrc` / `.bun-version` / `.python-version` are still read during the transition. CI sets `BYPASS_BUN_VERSION_CHECK=1`; local sandboxes often need it too.
+Toolchain versions are pinned in `mise.toml` (Node, Bun, Deno, Python, uv) and `package.json#packageManager` (pnpm via corepack). Install mise once with `brew install mise` (macOS), `winget install jdx.mise` (Windows), or `curl https://mise.run | sh` (any), then activate it in your shell — see https://mise.jdx.dev/installing-mise.html. CI can set `BYPASS_TOOLCHAIN_CHECK=1` only when using prebuilt toolchain images.
## Python Commands
@@ -77,7 +77,7 @@ COMPOSIO_DISABLE_TELEMETRY # "true" to disable
- **Default branch is `next`**, not `main`/`master`. Branch from `next` and target `next` for PRs.
- **Docs PRs also target `next`** (see `docs/CLAUDE.md` rule).
-- `pnpm install` hard-fails on Bun version mismatch — use `BYPASS_BUN_VERSION_CHECK=1`.
+- `pnpm install` checks Bun against `mise.toml`; run `mise install` when it fails.
- `ts/vendor/effect/` and `ts/vendor/clack/` are **read-only reference submodules** — npm provides the actual deps.
- The CLI is **Effect.ts + Bun**, not plain Node — see `ts/packages/cli/AGENTS.md` (CLI's `CLAUDE.md` is a symlink to it).
- E2E tests run in **Docker** and require Docker daemon access; skip them in restricted sandboxes.
@@ -89,7 +89,7 @@ COMPOSIO_DISABLE_TELEMETRY # "true" to disable
- Core Composio class: `ts/packages/core/src/composio.ts`
- Types: `ts/packages/core/src/types/`, errors: `ts/packages/core/src/errors/`
- Build configs: `turbo.jsonc`, `tsconfig.base.json`, `tsdown.config.base.ts`
-- Toolchain pins: `mise.toml` (Node, Bun, Deno, Python, uv), `package.json#packageManager` (pnpm), `.dvmrc` (Deno; mirrors mise.toml for `denoland/setup-deno` and `_utils/src/config.ts`)
+- Toolchain pins: `mise.toml` (Node, Bun, Deno, Python, uv), `mise.lock`, `toolchain-versions.json` (test matrices), `package.json#packageManager` (pnpm)
- CI release docs to update when bumping toolchain: `ts/docs/internal/release.md`
- Python config: `python/Makefile`, `python/noxfile.py`, `python/config/{pytest.ini,ruff.toml}`
diff --git a/mise.lock b/mise.lock
new file mode 100644
index 000000000..70f36d889
--- /dev/null
+++ b/mise.lock
@@ -0,0 +1,129 @@
+# @generated - this file is auto-generated by `mise lock` https://mise.en.dev/dev-tools/mise-lock.html
+
+[[tools.bun]]
+version = "1.3.10"
+backend = "core:bun"
+
+[tools.bun."platforms.linux-arm64"]
+checksum = "sha256:fa5ecb25cafa8e8f5c87a0f833719d46dd0af0a86c7837d806531212d55636d3"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-aarch64.zip"
+
+[tools.bun."platforms.linux-arm64-musl"]
+checksum = "sha256:d2c81365a2e529b78a42330d3a0056e8dbd7896b4a6782c8e392b6532141e34d"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-aarch64-musl.zip"
+
+[tools.bun."platforms.linux-x64"]
+checksum = "sha256:f57bc0187e39623de716ba3a389fda5486b2d7be7131a980ba54dc7b733d2e08"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-x64.zip"
+
+[tools.bun."platforms.linux-x64-baseline"]
+checksum = "sha256:41201a8c5ee74a9dcbb1ce25a1104f1f929838b57a845aa78d98379b0ce7cde2"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-x64-baseline.zip"
+
+[tools.bun."platforms.linux-x64-musl"]
+checksum = "sha256:48a6c32277d343db0148ce066336472ffd380358a4d26bb1329714742492d824"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-x64-musl.zip"
+
+[tools.bun."platforms.linux-x64-musl-baseline"]
+checksum = "sha256:a7bc4cdea1ef255a83adbf39c7aafcd30e09f2b8f74deec4b10ee318bc024d1f"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-x64-musl-baseline.zip"
+
+[tools.bun."platforms.macos-arm64"]
+checksum = "sha256:82034e87c9d9b4398ea619aee2eed5d2a68c8157e9a6ae2d1052d84d533ccd8d"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-darwin-aarch64.zip"
+
+[tools.bun."platforms.macos-x64"]
+checksum = "sha256:c1d90bf6140f20e572c473065dc6b37a4b036349b5e9e4133779cc642ad94323"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-darwin-x64.zip"
+
+[tools.bun."platforms.macos-x64-baseline"]
+checksum = "sha256:f9686c4e4e760db4cde77a0f1fad05e552648b9c9cbfa4f7fc9a7ec26b9f3267"
+url = "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-darwin-x64-baseline.zip"
+
+[[tools.deno]]
+version = "2.6.7"
+backend = "core:deno"
+
+[tools.deno."platforms.linux-arm64"]
+checksum = "sha256:d2aedfa8c73e258cce78dc80e8d0e764a69d4a09d946d32f0c29eef46592b82f"
+url = "https://dl.deno.land/release/v2.6.7/deno-aarch64-unknown-linux-gnu.zip"
+
+[tools.deno."platforms.linux-x64"]
+checksum = "sha256:c5626c9ee10e87201706fc5e64ed5a44b31527d98c130f164e149e1477c0a87d"
+url = "https://dl.deno.land/release/v2.6.7/deno-x86_64-unknown-linux-gnu.zip"
+
+[tools.deno."platforms.macos-arm64"]
+checksum = "sha256:71aaec50a92e06b2f5fed982b332c07a35e11798ca9a359db7603ae5f19c2d8b"
+url = "https://dl.deno.land/release/v2.6.7/deno-aarch64-apple-darwin.zip"
+
+[tools.deno."platforms.macos-x64"]
+checksum = "sha256:fae025e69cada67fb57affdda26abbe72991b02b515c3221e92c58aa8a642cec"
+url = "https://dl.deno.land/release/v2.6.7/deno-x86_64-apple-darwin.zip"
+
+[[tools.node]]
+version = "20.20.2"
+backend = "core:node"
+
+[tools.node."platforms.linux-arm64"]
+checksum = "sha256:47ef73d543ecf6eb19435f6c03a0ac4809b3bf0dd6b26c7c571efc2a6572a74d"
+url = "https://nodejs.org/dist/v20.20.2/node-v20.20.2-linux-arm64.tar.gz"
+
+[tools.node."platforms.linux-x64"]
+checksum = "sha256:19e56f0825510207dd904f087fe52faa0a4eb6b2aab5f0ea7a33830d04888b8b"
+url = "https://nodejs.org/dist/v20.20.2/node-v20.20.2-linux-x64.tar.gz"
+
+[tools.node."platforms.macos-arm64"]
+checksum = "sha256:466e05f3477c20dfb723054dfebffe55bc74660ee77f612166fca121dacb65b6"
+url = "https://nodejs.org/dist/v20.20.2/node-v20.20.2-darwin-arm64.tar.gz"
+
+[tools.node."platforms.macos-x64"]
+checksum = "sha256:8be6f5e4bb128c82774f8a0b8d7a1cc1365a7977d9657cece0ca647b3fe04e61"
+url = "https://nodejs.org/dist/v20.20.2/node-v20.20.2-darwin-x64.tar.gz"
+
+[[tools."npm:pnpm"]]
+version = "10.28.2"
+backend = "npm:pnpm"
+
+[[tools.python]]
+version = "3.12.13"
+backend = "core:python"
+
+[tools.python."platforms.linux-arm64"]
+checksum = "sha256:eb85c6903552b1cb40b183a119681a9326fa97e31cf0e4b8c78bf26735ff1552"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260610/cpython-3.12.13+20260610-aarch64-unknown-linux-gnu-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.linux-x64"]
+checksum = "sha256:6682afef6b510037a0ad84e61150e5121af2e2785c9ca27b047e029270a840fe"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260610/cpython-3.12.13+20260610-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.macos-arm64"]
+checksum = "sha256:f0a7fa7decc75df2b1a789329a44f657c4a15c0a683f197ce46a5cb621bc6ef4"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260610/cpython-3.12.13+20260610-aarch64-apple-darwin-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.macos-x64"]
+checksum = "sha256:c56c2dfe3fb5569430f4eabcff1fc1334c66db708bf17c103eef3dd237f3e3ab"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260610/cpython-3.12.13+20260610-x86_64-apple-darwin-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[[tools.uv]]
+version = "0.8.19"
+backend = "aqua:astral-sh/uv"
+
+[tools.uv."platforms.linux-arm64"]
+checksum = "sha256:87925376fa1e59de23582e1cbd81d6aabd16611e871ad085e09be2c2fa12689d"
+url = "https://github.com/astral-sh/uv/releases/download/0.8.19/uv-aarch64-unknown-linux-musl.tar.gz"
+
+[tools.uv."platforms.linux-x64"]
+checksum = "sha256:6a37f712ae90c7b8cf364fe751144d7acc2479d6b336378111e74cc7fb14fa7b"
+url = "https://github.com/astral-sh/uv/releases/download/0.8.19/uv-x86_64-unknown-linux-musl.tar.gz"
+
+[tools.uv."platforms.macos-arm64"]
+checksum = "sha256:bb63d43c40a301d889a985223ee8ce540be199e98b3f27ed8477823869a0a605"
+url = "https://github.com/astral-sh/uv/releases/download/0.8.19/uv-aarch64-apple-darwin.tar.gz"
+
+[tools.uv."platforms.macos-x64"]
+checksum = "sha256:b5f91770e55761b32c9618757ef23ded6671bb9ca0ddf5737eea60dddd493fe9"
+url = "https://github.com/astral-sh/uv/releases/download/0.8.19/uv-x86_64-apple-darwin.tar.gz"
diff --git a/mise.toml b/mise.toml
index 17d85ae22..fc4cc85bf 100644
--- a/mise.toml
+++ b/mise.toml
@@ -1,11 +1,10 @@
-# Single source of truth for Node, Bun, Deno, Python, and uv versions.
+# Single source of truth for Node, Bun, Deno, Python, uv, and pnpm versions.
#
# Local dev: `mise install` (after `brew install mise` / `winget install jdx.mise` / `curl https://mise.run | sh`)
-# CI: driven by `jdx/mise-action@v4` in the composite actions under `.github/actions/`
+# CI: driven by `jdx/mise-action` in the composite actions under `.github/actions/`
#
-# pnpm is intentionally NOT pinned here. Pattern A (corepack-driven) is in effect:
-# the version comes from `packageManager` in `package.json` and corepack shims it.
-# See https://github.com/jdx/mise/discussions/7622 for why pinning pnpm in [tools] can shadow corepack.
+# pnpm is pinned through mise's npm backend so mise owns the full local and CI
+# toolchain. CI cannot assume Corepack has created a pnpm shim before caching.
min_version = "2026.1.0"
@@ -15,16 +14,11 @@ bun = "1.3.10"
deno = "2.6.7"
python = "3.12"
uv = "0.8.19"
+"npm:pnpm" = "10.28.2"
[env]
_.path = ["{{config_root}}/node_modules/.bin"]
[settings]
-# Read .nvmrc / .python-version / .bun-version during the transition window.
-# Removed in Phase 3 once the legacy files are deleted.
-idiomatic_version_file_enable_tools = ["node", "python", "bun"]
-
-# uv integration: mise installs Python, uv owns the venv.
-# "source" activates an existing .venv when entering the repo;
-# use "create|source" if you want mise to also create the venv automatically.
-python.uv_venv_auto = "source"
+lockfile = true
+locked = true
diff --git a/python/.python-version b/python/.python-version
deleted file mode 100644
index e4fba2183..000000000
--- a/python/.python-version
+++ /dev/null
@@ -1 +0,0 @@
-3.12
diff --git a/python/Makefile b/python/Makefile
index ea7c82b14..683d0932b 100644
--- a/python/Makefile
+++ b/python/Makefile
@@ -31,7 +31,7 @@ env:
@echo "* creating new environment"
@if [ -z "$$VIRTUAL_ENV" ];\
then\
- uv venv --seed --prompt composio --python 3.11;\
+ uv venv --seed --prompt composio --python 3.12;\
uv sync;\
uv sync --dev;\
make provider;\
diff --git a/python/composio/sdk.py b/python/composio/sdk.py
index a5dd0d50b..013a46824 100644
--- a/python/composio/sdk.py
+++ b/python/composio/sdk.py
@@ -146,7 +146,7 @@ class Composio(t.Generic[TTool, TToolCollection], WithLogger):
environment=kwargs.get("environment", "production"),
provider=actual_provider.name,
api_key=api_key,
- base_url=kwargs.get("base_url"),
+ base_url=kwargs.get("base_url") or os.environ.get("COMPOSIO_BASE_URL"),
timeout=kwargs.get("timeout"),
max_retries=kwargs.get("max_retries", DEFAULT_MAX_RETRIES),
)
diff --git a/toolchain-versions.json b/toolchain-versions.json
new file mode 100644
index 000000000..64c6e24da
--- /dev/null
+++ b/toolchain-versions.json
@@ -0,0 +1,6 @@
+{
+ "node": ["22.22.3", "24.16.0", "25.9.0"],
+ "node_install_compat": ["22.22.3", "24.16.0", "25.9.0"],
+ "deno": ["2.6.7"],
+ "python": ["3.10", "3.11", "3.12"]
+}
diff --git a/ts/docs/internal/release.md b/ts/docs/internal/release.md
index 14ee7a494..6cd5000d7 100644
--- a/ts/docs/internal/release.md
+++ b/ts/docs/internal/release.md
@@ -60,7 +60,6 @@ The automated release process is triggered when code is merged into the `main` b
### Using Automated Release
1. **For Regular Releases (via main branch)**
-
- Make sure your changeset is added to the PR you are merging to main. Run `pnpm changeset` on your branch before submiting the PR
- Get your PR merged to main
- The workflow will automatically:
@@ -79,9 +78,8 @@ The manual release process is available for cases where direct control over the
### Prerequisites
-- Node.js (version: `20.20.2`)
-- Bun (version: `1.3.10`)
-- pnpm (version: `10.28.2`)
+- Node.js, Bun, Python, Deno, and uv from `mise.toml`
+- pnpm from `package.json#packageManager` via corepack
- Access to npm registry
- Write access to the repository
@@ -95,6 +93,8 @@ The manual release process is available for cases where direct control over the
git pull origin main
# Install dependencies
+ mise install
+ corepack enable
pnpm install
# Run quality checks
@@ -142,13 +142,11 @@ The manual release process is available for cases where direct control over the
### Troubleshooting
1. **Authentication Issues**
-
- Ensure you're logged in to npm (`npm login`)
- Check npm token validity
- Verify registry settings in `.npmrc`
2. **Build Failures**
-
- Clear node_modules: `pnpm clean`
- Reinstall dependencies: `pnpm install`
- Check for peer dependency issues
@@ -161,13 +159,11 @@ The manual release process is available for cases where direct control over the
## Best Practices
1. **Changesets**
-
- Write clear, descriptive changeset messages
- Include breaking changes prominently
- Reference relevant issues/PRs
2. **Version Management**
-
- Follow semver strictly
- Document breaking changes
- Update peer dependencies appropriately
@@ -180,13 +176,11 @@ The manual release process is available for cases where direct control over the
## Post-Release
1. **Verification**
-
- Check npm registry for new versions
- Verify package installations
- Test example projects
2. **Documentation**
-
- Update changelog if needed
- Update version numbers in docs
- Announce breaking changes
diff --git a/ts/e2e-tests/README.md b/ts/e2e-tests/README.md
index f3e2a40ae..059cf7837 100644
--- a/ts/e2e-tests/README.md
+++ b/ts/e2e-tests/README.md
@@ -66,12 +66,12 @@ pnpm test:e2e
pnpm test:e2e:node
```
-Runs Node.js tests in Docker using `bun test`. The default Node.js version is determined by `.nvmrc`.
+Runs Node.js tests in Docker using `bun test`. The default Node.js version is determined by `mise.toml`.
To run with a specific Node.js version:
```bash
-COMPOSIO_E2E_NODE_VERSION=22.12.0 pnpm test:e2e:node
+COMPOSIO_E2E_NODE_VERSION=22.22.3 pnpm test:e2e:node
```
### Deno Tests Only
@@ -80,7 +80,7 @@ COMPOSIO_E2E_NODE_VERSION=22.12.0 pnpm test:e2e:node
pnpm test:e2e:deno
```
-Runs Deno tests in Docker using `bun test`. The default Deno version is determined by `.dvmrc`.
+Runs Deno tests in Docker using `bun test`. The default Deno version is determined by `mise.toml`.
To run with a specific Deno version:
@@ -122,9 +122,9 @@ import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
versions: {
- node: ['20.18.0', '22.12.0'], // Optional: defaults to .nvmrc version
+ node: ['22.22.3', '24.16.0', '25.9.0'], // Optional: defaults to the current version in mise.toml
},
- env: { MY_VAR: process.env.MY_VAR }, // Optional: env vars (validated at startup)
+ env: { MY_VAR: process.env.MY_VAR }, // Optional: env vars (validated at startup)
defineTests: ({ runtime, runFixture }) => {
let result: E2ETestResult;
@@ -161,7 +161,7 @@ import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
versions: {
- deno: ['2.6.7'], // Optional: defaults to .dvmrc version
+ deno: ['2.6.7'], // Optional: defaults to the current version in mise.toml
},
usesFixtures: true,
defineTests: ({ runtime, runFixture }) => {
@@ -196,8 +196,8 @@ import { TIMEOUTS } from '@e2e-tests/utils/const';
import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
- nodeVersions: ['20.19.0', '22.12.0'],
- usesFixtures: true, // Sets cwd to fixtures/ directory
+ nodeVersions: ['22.22.3', '24.16.0', '25.9.0'],
+ usesFixtures: true, // Sets cwd to fixtures/ directory
env: { MY_API_KEY: process.env.MY_API_KEY },
defineTests: ({ runFixture }) => {
let result: E2ETestResultWithSetup;
@@ -205,7 +205,7 @@ e2e(import.meta.url, {
beforeAll(async () => {
result = await runFixture({
filename: 'index.mjs',
- setup: 'npm install --legacy-peer-deps', // Runs before fixture
+ setup: 'npm install --legacy-peer-deps', // Runs before fixture
});
}, TIMEOUTS.FIXTURE);
@@ -276,16 +276,16 @@ Each test suite generates an ephemereal `DEBUG.log` file in its directory with s
E2E Test: my-test
Started: 2026-01-30T12:18:42.000Z
Test file: ts/e2e-tests/runtimes/node/my-test/e2e.test.ts
-Node versions: 20.19.0, 22.12.0
+Runtime versions: Node.js 22.22.3, Node.js 24.16.0, Node.js 25.9.0
================================================================================
################################################################################
-### Node.js 20.19.0
+### Node.js 22.22.3
################################################################################
-Image: composio-e2e-node:20.19.0
+Image: composio-e2e-node:22.22.3
--- Phase 1/2: setup ---
-Container: e2e-my-test-20-19-0-1769775520382-setup
+Container: e2e-my-test-22-22-3-1769775520382-setup
Command: npm install
Duration: 2.55s
Exit Code: 0 (success)
@@ -297,7 +297,7 @@ added 3 packages in 2s
(empty)
--- Phase 2/2: fixture ---
-Container: e2e-my-test-20-19-0-1769775520382-fixture
+Container: e2e-my-test-22-22-3-1769775520382-fixture
Command: node index.mjs
Duration: 0.56s
Exit Code: 0 (success)
@@ -311,8 +311,9 @@ Test passed!
================================================================================
Summary
================================================================================
-Node.js 20.19.0: PASS (2 phases, 3.11s total)
-Node.js 22.12.0: SKIPPED
+Node.js 22.22.3: PASS (2 phases, 3.11s total)
+Node.js 24.16.0: PASS (2 phases, 3.09s total)
+Node.js 25.9.0: PASS (2 phases, 3.08s total)
Finished: 2026-01-30T12:18:46.500Z
Total duration: 4.50s
diff --git a/ts/e2e-tests/_utils/Dockerfile.cli b/ts/e2e-tests/_utils/Dockerfile.cli
index 4f007bf7b..daf70340d 100644
--- a/ts/e2e-tests/_utils/Dockerfile.cli
+++ b/ts/e2e-tests/_utils/Dockerfile.cli
@@ -1,8 +1,8 @@
# Reusable Dockerfile for CLI e2e tests (debian runtime)
-# Usage: docker build -f Dockerfile.cli --build-arg CLI_VERSION=0.1.24 -t test-name .
+# Usage: docker build -f Dockerfile.cli --build-arg CLI_VERSION=0.1.24 --build-arg NODE_VERSION=22.22.3 --build-arg BUN_VERSION=1.3.10 -t test-name .
-ARG NODE_VERSION=20.19.0
-ARG BUN_VERSION=1.3.10
+ARG NODE_VERSION
+ARG BUN_VERSION
ARG CLI_VERSION=0.0.0
FROM oven/bun:${BUN_VERSION} AS bun
@@ -29,7 +29,7 @@ COPY package.json \
.pnpmfile.cjs \
tsconfig.base.json \
tsdown.config.base.ts \
- .bun-version \
+ toolchain-versions.json \
./
# Copy pre-install scripts (rarely change)
@@ -42,7 +42,7 @@ COPY ts/packages/ ./ts/packages/
# Install dependencies using pnpm
# Note: We intentionally don't use --mount=type=cache for the pnpm store here
# because it causes native binding issues across builds
-RUN pnpm install --frozen-lockfile
+RUN BYPASS_TOOLCHAIN_CHECK=1 pnpm install --frozen-lockfile
# Build composio CLI binary
WORKDIR /app/ts/packages/cli
diff --git a/ts/e2e-tests/_utils/Dockerfile.deno b/ts/e2e-tests/_utils/Dockerfile.deno
index 5afa77f04..266aa1ee8 100644
--- a/ts/e2e-tests/_utils/Dockerfile.deno
+++ b/ts/e2e-tests/_utils/Dockerfile.deno
@@ -1,12 +1,14 @@
# Reusable Dockerfile for Deno e2e tests
-# Usage: docker build -f Dockerfile.deno --build-arg DENO_VERSION=2.6.7 -t test-name .
+# Usage: docker build -f Dockerfile.deno --build-arg DENO_VERSION=2.6.7 --build-arg NODE_MAJOR=20 --build-arg BUN_VERSION=1.3.10 -t test-name .
#
# Uses official denoland/deno images. For multi-version testing, run the build/run
# multiple times with different DENO_VERSION values from the shell script.
-ARG DENO_VERSION=2.6.7
+ARG DENO_VERSION
FROM denoland/deno:${DENO_VERSION}
+ARG NODE_MAJOR
+ARG BUN_VERSION
ENV PNPM_HOME="/pnpm"
ENV BUN_INSTALL="/usr/local"
@@ -23,7 +25,7 @@ RUN apt-get update && \
rm -rf /var/lib/apt/lists/*
# Install Node.js (needed for pnpm and building packages)
-RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
+RUN curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash - && \
apt-get install -y nodejs && \
rm -rf /var/lib/apt/lists/*
@@ -31,9 +33,8 @@ RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
RUN npm i -g corepack@latest && \
corepack enable
-# Install bun (version from .bun-version)
-COPY .bun-version ./
-RUN curl -fsSL https://bun.sh/install | BUN_INSTALL=/usr/local bash -s "bun-v$(cat .bun-version)" && \
+# Install Bun
+RUN curl -fsSL https://bun.sh/install | BUN_INSTALL=/usr/local bash -s "bun-v${BUN_VERSION}" && \
bun --version
# Copy lockfile first for optimal layer caching
@@ -45,6 +46,7 @@ COPY package.json \
.pnpmfile.cjs \
tsconfig.base.json \
tsdown.config.base.ts \
+ toolchain-versions.json \
./
# Copy pre-install scripts (rarely change)
@@ -57,7 +59,7 @@ COPY ts/packages/ ./ts/packages/
# Install dependencies using pnpm
# Note: We intentionally don't use --mount=type=cache for the pnpm store here
# because it causes native binding issues (e.g., rolldown-binding) across builds
-RUN pnpm install --frozen-lockfile
+RUN BYPASS_TOOLCHAIN_CHECK=1 pnpm install --frozen-lockfile
# Copy e2e tests last (changes frequently)
COPY ts/e2e-tests/ ./ts/e2e-tests/
diff --git a/ts/e2e-tests/_utils/Dockerfile.node b/ts/e2e-tests/_utils/Dockerfile.node
index 3efac09cf..facce5cb0 100644
--- a/ts/e2e-tests/_utils/Dockerfile.node
+++ b/ts/e2e-tests/_utils/Dockerfile.node
@@ -1,12 +1,13 @@
# Reusable Dockerfile for Node.js e2e tests
-# Usage: docker build -f Dockerfile.node --build-arg NODE_VERSION=20.19.0 -t test-name .
+# Usage: docker build -f Dockerfile.node --build-arg NODE_VERSION=22.22.3 --build-arg BUN_VERSION=1.3.10 -t test-name .
#
# Uses official node:slim images. For multi-version testing, run the build/run
# multiple times with different NODE_VERSION values from the shell script.
-ARG NODE_VERSION=20.19.0
+ARG NODE_VERSION
FROM node:${NODE_VERSION}-slim
+ARG BUN_VERSION
ENV PNPM_HOME="/pnpm"
ENV BUN_INSTALL="/usr/local"
@@ -20,12 +21,11 @@ RUN apt-get update && \
rm -rf /var/lib/apt/lists/*
# Install corepack (for pnpm)
-RUN npm i -g corepack@latest && \
+RUN npm i -g corepack@latest --force && \
corepack enable
-# Install bun (version from .bun-version)
-COPY .bun-version ./
-RUN curl -fsSL https://bun.sh/install | BUN_INSTALL=/usr/local bash -s "bun-v$(cat .bun-version)" && \
+# Install Bun
+RUN curl -fsSL https://bun.sh/install | BUN_INSTALL=/usr/local bash -s "bun-v${BUN_VERSION}" && \
bun --version
# Copy lockfile first for optimal layer caching
@@ -37,6 +37,7 @@ COPY package.json \
.pnpmfile.cjs \
tsconfig.base.json \
tsdown.config.base.ts \
+ toolchain-versions.json \
./
# Copy pre-install scripts (rarely change)
@@ -49,7 +50,7 @@ COPY ts/packages/ ./ts/packages/
# Install dependencies using pnpm
# Note: We intentionally don't use --mount=type=cache for the pnpm store here
# because it causes native binding issues (e.g., rolldown-binding) across builds
-RUN pnpm install --frozen-lockfile
+RUN BYPASS_TOOLCHAIN_CHECK=1 pnpm install --frozen-lockfile
# Build and install composio CLI binary
# This is a simplified version of ts/packages/cli/scripts/build-binary.ts + install-binary.ts
diff --git a/ts/e2e-tests/_utils/README.md b/ts/e2e-tests/_utils/README.md
index 22cf0e424..1c05b1046 100644
--- a/ts/e2e-tests/_utils/README.md
+++ b/ts/e2e-tests/_utils/README.md
@@ -4,13 +4,13 @@ Shared infrastructure for running `@composio/core` and CLI end-to-end tests in i
## What's Here
-| File/Directory | Purpose |
-| ----------------- | ------------------------------------------------------ |
-| `src/` | TypeScript utilities (e2e runner, config, types) |
-| `scripts/` | Docker build and cleanup scripts |
-| `Dockerfile.node` | Multi-stage Dockerfile for Node.js test environments |
-| `Dockerfile.deno` | Dockerfile for Deno test environments |
-| `Dockerfile.cli` | Scratch Dockerfile for CLI test environments |
+| File/Directory | Purpose |
+| ----------------- | ---------------------------------------------------- |
+| `src/` | TypeScript utilities (e2e runner, config, types) |
+| `scripts/` | Docker build and cleanup scripts |
+| `Dockerfile.node` | Multi-stage Dockerfile for Node.js test environments |
+| `Dockerfile.deno` | Dockerfile for Deno test environments |
+| `Dockerfile.cli` | Scratch Dockerfile for CLI test environments |
## API
@@ -25,11 +25,11 @@ import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
versions: {
- node: ['20.18.0', '20.19.0', '22.12.0'], // optional, defaults to .nvmrc
- deno: ['2.6.7'], // optional, defaults to .dvmrc
- cli: ['current'], // optional, defaults to CLI package.json version
+ node: ['22.22.3', '24.16.0', '25.9.0'], // optional, defaults to mise.toml
+ deno: ['2.6.7'], // optional, defaults to mise.toml
+ cli: ['current'], // optional, defaults to CLI package.json version
},
- env: { MY_VAR: 'value' }, // optional env vars
+ env: { MY_VAR: 'value' }, // optional env vars
defineTests: ({ runtime, runCmd, runFixture }) => {
let result: E2ETestResult;
@@ -50,39 +50,39 @@ e2e(import.meta.url, {
Configuration object passed to `e2e()`:
-| Property | Type | Description |
-| -------------- | ------------------------------------- | ---------------------------------------------------------------- |
-| `versions` | `RuntimeVersions` | Runtime versions to test. See RuntimeVersions below |
-| `env` | `Record<string, string \| undefined>` | Environment variables for Docker. Validated at startup |
-| `usesFixtures` | `boolean` | When true, sets cwd to `{testDir}/fixtures`. Default: `false` |
-| `defineTests` | `(ctx: DefineTestsContext) => void` | Callback to define tests using bun:test primitives |
+| Property | Type | Description |
+| -------------- | ------------------------------------- | ------------------------------------------------------------- |
+| `versions` | `RuntimeVersions` | Runtime versions to test. See RuntimeVersions below |
+| `env` | `Record<string, string \| undefined>` | Environment variables for Docker. Validated at startup |
+| `usesFixtures` | `boolean` | When true, sets cwd to `{testDir}/fixtures`. Default: `false` |
+| `defineTests` | `(ctx: DefineTestsContext) => void` | Callback to define tests using bun:test primitives |
### `RuntimeVersions`
-| Property | Type | Description |
-| -------- | -------------------------------- | ------------------------------------------------ |
-| `node` | `readonly NodeVersionFromUser[]` | Node.js versions. Defaults to `.nvmrc` |
-| `deno` | `readonly DenoVersionFromUser[]` | Deno versions. Defaults to `.dvmrc` |
-| `cli` | `readonly CliVersionFromUser[]` | CLI versions. Defaults to CLI package.json |
+| Property | Type | Description |
+| -------- | -------------------------------- | ------------------------------------------ |
+| `node` | `readonly NodeVersionFromUser[]` | Node.js versions. Defaults to `mise.toml` |
+| `deno` | `readonly DenoVersionFromUser[]` | Deno versions. Defaults to `mise.toml` |
+| `cli` | `readonly CliVersionFromUser[]` | CLI versions. Defaults to CLI package.json |
### `DefineTestsContext`
The context passed to the `defineTests` callback:
-| Property | Type/Signature | Description |
-| ------------ | ---------------------------------------------------------------- | ---------------------------------------------- |
-| `runtime` | `'node' \| 'deno' \| 'cli'` | Current runtime being tested |
-| `runCmd` | `(command: string) => Promise<E2ETestResult>` | Run arbitrary command in Docker container |
-| `runFixture` | `(options: RunFixtureOptions) => Promise<E2ETestResult \| E2ETestResultWithSetup>` | Run fixture with optional setup phase |
+| Property | Type/Signature | Description |
+| ------------ | ---------------------------------------------------------------------------------- | ----------------------------------------- |
+| `runtime` | `'node' \| 'deno' \| 'cli'` | Current runtime being tested |
+| `runCmd` | `(command: string) => Promise<E2ETestResult>` | Run arbitrary command in Docker container |
+| `runFixture` | `(options: RunFixtureOptions) => Promise<E2ETestResult \| E2ETestResultWithSetup>` | Run fixture with optional setup phase |
### `RunFixtureOptions`
Options for `runFixture()`:
-| Property | Type | Description |
-| ---------- | -------- | --------------------------------------------------------------------- |
-| `filename` | `string` | Fixture file path relative to cwd (e.g., `'index.mjs'`) |
-| `setup` | `string` | Optional setup command (e.g., `'npm install'`). Enables volume mode |
+| Property | Type | Description |
+| ---------- | -------- | ------------------------------------------------------------------- |
+| `filename` | `string` | Fixture file path relative to cwd (e.g., `'index.mjs'`) |
+| `setup` | `string` | Optional setup command (e.g., `'npm install'`). Enables volume mode |
**Behavior:**
@@ -98,8 +98,8 @@ const result = await runFixture({
filename: 'index.mjs',
setup: 'npm install --legacy-peer-deps',
});
-expect(result.setup.exitCode).toBe(0); // Check setup phase
-expect(result.exitCode).toBe(0); // Check fixture phase
+expect(result.setup.exitCode).toBe(0); // Check setup phase
+expect(result.exitCode).toBe(0); // Check fixture phase
```
### `E2ETestResult`
@@ -108,9 +108,9 @@ Result returned by `runCmd` and `runFixture`:
```typescript
interface E2ETestResult {
- exitCode: number; // Exit code from the command (0 = success)
- stdout: string; // Captured stdout
- stderr: string; // Captured stderr
+ exitCode: number; // Exit code from the command (0 = success)
+ stdout: string; // Captured stdout
+ stderr: string; // Captured stderr
}
```
@@ -162,9 +162,13 @@ Predefined timeout constants for tests (in milliseconds):
```typescript
import { TIMEOUTS } from '@e2e-tests/utils/const';
-it('calls LLM', async () => {
- // test code
-}, { timeout: TIMEOUTS.LLM_SHORT });
+it(
+ 'calls LLM',
+ async () => {
+ // test code
+ },
+ { timeout: TIMEOUTS.LLM_SHORT }
+);
```
| Constant | Value | Use Case |
@@ -182,16 +186,16 @@ Node.js versions to test are resolved in this order:
1. **`COMPOSIO_E2E_NODE_VERSION` env var** (highest priority): Use `[env_value]`
2. **`config.versions.node`**: Use the provided array
-3. **Default**: Use version from `.nvmrc` file
+3. **Default**: Use version from `mise.toml` file
### Well-Known Node Versions
The following versions are pre-defined in `const.ts`:
-- `20.18.0`
-- `20.19.0`
-- `22.12.0`
-- `current` (resolves to `.nvmrc` version)
+- `22.22.3`
+- `24.16.0`
+- `25.9.0`
+- `current` (resolves to `mise.toml` version)
### Deno Version Resolution
@@ -199,14 +203,14 @@ Deno versions to test are resolved in this order:
1. **`COMPOSIO_E2E_DENO_VERSION` env var** (highest priority): Use `[env_value]`
2. **`config.versions.deno`**: Use the provided array
-3. **Default**: Use version from `.dvmrc` file
+3. **Default**: Use version from `mise.toml` file
### Well-Known Deno Versions
The following versions are pre-defined in `const.ts`:
- `2.6.7`
-- `current` (resolves to `.dvmrc` version)
+- `current` (resolves to `mise.toml` version)
### CLI Version Resolution
@@ -250,8 +254,8 @@ e2e(import.meta.url, {
beforeAll(async () => {
// Both commands run in fixtures/ directory
result = await runFixture({
- filename: 'index.mjs', // Resolves to fixtures/index.mjs
- setup: 'npm install', // Runs in fixtures/
+ filename: 'index.mjs', // Resolves to fixtures/index.mjs
+ setup: 'npm install', // Runs in fixtures/
});
}, TIMEOUTS.FIXTURE);
},
@@ -277,16 +281,16 @@ Each test suite generates a `DEBUG.log` file with structured output grouped by r
E2E Test: openai-zod4-compat
Started: 2026-01-30T12:18:42.000Z
Test file: ts/e2e-tests/runtimes/node/openai-zod4-compat/e2e.test.ts
-Node versions: 20.19.0, 22.12.0
+Runtime versions: Node.js 22.22.3, Node.js 24.16.0, Node.js 25.9.0
================================================================================
################################################################################
-### Node.js 20.19.0
+### Node.js 22.22.3
################################################################################
-Image: composio-e2e-node:20.19.0
+Image: composio-e2e-node:22.22.3
--- Phase 1/2: setup ---
-Container: e2e-openai-zod4-compat-20-19-0-1769775520382-setup
+Container: e2e-openai-zod4-compat-22-22-3-1769775520382-setup
Command: npm install --legacy-peer-deps
Duration: 2.55s
Exit Code: 0 (success)
@@ -298,7 +302,7 @@ added 3 packages, and audited 5 packages in 2s
(empty)
--- Phase 2/2: fixture ---
-Container: e2e-openai-zod4-compat-20-19-0-1769775520382-fixture
+Container: e2e-openai-zod4-compat-22-22-3-1769775520382-fixture
Command: node index.mjs
Duration: 0.56s
Exit Code: 0 (success)
@@ -311,16 +315,12 @@ All packages work together!
[stderr]
(empty)
-################################################################################
-### Node.js 22.12.0 (SKIPPED)
-################################################################################
-Reason: Not selected via COMPOSIO_E2E_NODE_VERSION
-
================================================================================
Summary
================================================================================
-Node.js 20.19.0: PASS (2 phases, 3.11s total)
-Node.js 22.12.0: SKIPPED
+Node.js 22.22.3: PASS (2 phases, 3.11s total)
+Node.js 24.16.0: PASS (2 phases, 3.09s total)
+Node.js 25.9.0: PASS (2 phases, 3.08s total)
Finished: 2026-01-30T12:18:46.500Z
Total duration: 4.50s
diff --git a/ts/e2e-tests/_utils/scripts/docker-build.ts b/ts/e2e-tests/_utils/scripts/docker-build.ts
index 4816f7a1c..b883cd238 100644
--- a/ts/e2e-tests/_utils/scripts/docker-build.ts
+++ b/ts/e2e-tests/_utils/scripts/docker-build.ts
@@ -13,29 +13,41 @@ import { $ } from 'bun';
import { resolve, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
import { readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
import { WELL_KNOWN_NODE_VERSIONS, WELL_KNOWN_DENO_VERSIONS } from '../src/const';
const __dirname = dirname(fileURLToPath(import.meta.url));
+type DockerToolchain = {
+ nodeVersion: string;
+ nodeMajorVersion: string;
+ bunVersion: string;
+};
+
function getRepoRoot(): string {
// From scripts/ to repo root: scripts -> _utils -> e2e-tests -> ts -> composio
return resolve(__dirname, '../../../..');
}
-function getNvmrcVersion(repoRoot: string): string {
+function getMiseVersion(repoRoot: string, tool: 'node' | 'bun' | 'deno'): string {
try {
- return readFileSync(resolve(repoRoot, '.nvmrc'), 'utf-8').trim();
- } catch {
- return process.versions.node;
+ return execFileSync('mise', ['current', tool], { cwd: repoRoot, encoding: 'utf-8' }).trim();
+ } catch (err) {
+ throw new Error(`Failed to resolve ${tool} version from mise.toml: ${(err as Error).message}`);
}
}
-function getDvmrcVersion(repoRoot: string): string {
- try {
- return readFileSync(resolve(repoRoot, '.dvmrc'), 'utf-8').trim();
- } catch {
- return '2.6.7'; // fallback default
- }
+function getMajorVersion(version: string): string {
+ return version.split('.')[0] ?? version;
+}
+
+function getDockerToolchain(repoRoot: string): DockerToolchain {
+ const nodeVersion = getMiseVersion(repoRoot, 'node');
+ return {
+ nodeVersion,
+ nodeMajorVersion: getMajorVersion(nodeVersion),
+ bunVersion: getMiseVersion(repoRoot, 'bun'),
+ };
}
function getCliPackageVersion(repoRoot: string): string {
@@ -63,7 +75,11 @@ function defaultNodeLabels(nodeVersion: string): Record<string, string> {
};
}
-async function buildNodeImage(nodeVersion: string, repoRoot: string): Promise<boolean> {
+async function buildNodeImage(
+ nodeVersion: string,
+ toolchain: DockerToolchain,
+ repoRoot: string
+): Promise<boolean> {
const dockerfilePath = resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.node');
const imageTag = imageTagForNodeVersion(nodeVersion);
const labels = defaultNodeLabels(nodeVersion);
@@ -73,9 +89,10 @@ async function buildNodeImage(nodeVersion: string, repoRoot: string): Promise<bo
console.log(`\nBuilding image for Node.js ${nodeVersion}...`);
- const result = await $`docker build -f ${dockerfilePath} --build-arg NODE_VERSION=${nodeVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
- .cwd(repoRoot)
- .nothrow();
+ const result =
+ await $`docker build -f ${dockerfilePath} --build-arg NODE_VERSION=${nodeVersion} --build-arg BUN_VERSION=${toolchain.bunVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
+ .cwd(repoRoot)
+ .nothrow();
if (result.exitCode !== 0) {
console.error(` Failed to build ${imageTag}:`);
@@ -103,7 +120,11 @@ function defaultDenoLabels(denoVersion: string): Record<string, string> {
};
}
-async function buildDenoImage(denoVersion: string, repoRoot: string): Promise<boolean> {
+async function buildDenoImage(
+ denoVersion: string,
+ toolchain: DockerToolchain,
+ repoRoot: string
+): Promise<boolean> {
const dockerfilePath = resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.deno');
const imageTag = imageTagForDenoVersion(denoVersion);
const labels = defaultDenoLabels(denoVersion);
@@ -113,9 +134,10 @@ async function buildDenoImage(denoVersion: string, repoRoot: string): Promise<bo
console.log(`\nBuilding image for Deno ${denoVersion}...`);
- const result = await $`docker build -f ${dockerfilePath} --build-arg DENO_VERSION=${denoVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
- .cwd(repoRoot)
- .nothrow();
+ const result =
+ await $`docker build -f ${dockerfilePath} --build-arg DENO_VERSION=${denoVersion} --build-arg NODE_MAJOR=${toolchain.nodeMajorVersion} --build-arg BUN_VERSION=${toolchain.bunVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
+ .cwd(repoRoot)
+ .nothrow();
if (result.exitCode !== 0) {
console.error(` Failed to build ${imageTag}:`);
@@ -143,7 +165,11 @@ function defaultCliLabels(cliVersion: string): Record<string, string> {
};
}
-async function buildCliImage(cliVersion: string, repoRoot: string): Promise<boolean> {
+async function buildCliImage(
+ cliVersion: string,
+ toolchain: DockerToolchain,
+ repoRoot: string
+): Promise<boolean> {
const dockerfilePath = resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.cli');
const imageTag = imageTagForCliVersion(cliVersion);
const labels = defaultCliLabels(cliVersion);
@@ -153,9 +179,10 @@ async function buildCliImage(cliVersion: string, repoRoot: string): Promise<bool
console.log(`\nBuilding image for CLI ${cliVersion}...`);
- const result = await $`docker build -f ${dockerfilePath} --build-arg CLI_VERSION=${cliVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
- .cwd(repoRoot)
- .nothrow();
+ const result =
+ await $`docker build -f ${dockerfilePath} --build-arg CLI_VERSION=${cliVersion} --build-arg NODE_VERSION=${toolchain.nodeVersion} --build-arg BUN_VERSION=${toolchain.bunVersion} ${{ raw: labelArgs }} -t ${imageTag} ${repoRoot}`
+ .cwd(repoRoot)
+ .nothrow();
if (result.exitCode !== 0) {
console.error(` Failed to build ${imageTag}:`);
@@ -173,8 +200,9 @@ async function buildCliImage(cliVersion: string, repoRoot: string): Promise<bool
async function main() {
const repoRoot = getRepoRoot();
- const currentNodeVersion = getNvmrcVersion(repoRoot);
- const currentDenoVersion = getDvmrcVersion(repoRoot);
+ const dockerToolchain = getDockerToolchain(repoRoot);
+ const currentNodeVersion = dockerToolchain.nodeVersion;
+ const currentDenoVersion = getMiseVersion(repoRoot, 'deno');
const currentCliVersion = getCliPackageVersion(repoRoot);
const envNodeVersion = Bun.env.COMPOSIO_E2E_NODE_VERSION;
const envDenoVersion = Bun.env.COMPOSIO_E2E_DENO_VERSION;
@@ -243,7 +271,7 @@ async function main() {
// Build Node.js images
for (const version of nodeVersions) {
total++;
- const success = await buildNodeImage(version, repoRoot);
+ const success = await buildNodeImage(version, dockerToolchain, repoRoot);
if (!success) {
failed++;
}
@@ -252,7 +280,7 @@ async function main() {
// Build Deno images
for (const version of denoVersions) {
total++;
- const success = await buildDenoImage(version, repoRoot);
+ const success = await buildDenoImage(version, dockerToolchain, repoRoot);
if (!success) {
failed++;
}
@@ -261,7 +289,7 @@ async function main() {
// Build CLI images
for (const version of cliVersions) {
total++;
- const success = await buildCliImage(version, repoRoot);
+ const success = await buildCliImage(version, dockerToolchain, repoRoot);
if (!success) {
failed++;
}
@@ -275,7 +303,7 @@ async function main() {
}
}
-main().catch((err) => {
+main().catch(err => {
console.error('Error:', err);
process.exit(1);
});
diff --git a/ts/e2e-tests/_utils/src/config.ts b/ts/e2e-tests/_utils/src/config.ts
index 6a0f605ae..2d7b48ca9 100644
--- a/ts/e2e-tests/_utils/src/config.ts
+++ b/ts/e2e-tests/_utils/src/config.ts
@@ -1,7 +1,7 @@
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { readFileSync } from 'node:fs';
-import process from 'node:process';
+import { execFileSync } from 'node:child_process';
import type {
NodeVersionMeta,
NodeVersionFromUser,
@@ -42,7 +42,7 @@ export function getRepoRoot(): string {
/**
* Resolve the Node.js versions to test against, with CI skip state.
*
- * The `'current'` version always resolves to the value in `.nvmrc`.
+ * The `'current'` version always resolves to the value in mise.toml.
*
* In CI mode (CI env var set + COMPOSIO_E2E_NODE_VERSION set):
* - Versions not matching COMPOSIO_E2E_NODE_VERSION are marked to skip
@@ -55,21 +55,27 @@ export function resolveNodeVersionMetaList(
configNodeVersions?: readonly NodeVersionFromUser[]
): NonEmptyArray<NodeVersionMeta> {
const envVersion = Bun.env.COMPOSIO_E2E_NODE_VERSION;
- const nvmrcVersion = getNvmrcVersion();
// Local mode with env override: single version, no skip
if (!isCI() && envVersion) {
return [{ kind: 'overridden', value: envVersion, skip: { value: false } }];
}
- // No config provided: use .nvmrc version
+ // Only read mise.toml after env override check.
+ const miseNodeVersion = getMiseVersion('node');
+
+ // No config provided: use mise.toml version
if (configNodeVersions === undefined || configNodeVersions.length === 0) {
- return [{ kind: 'current', value: nvmrcVersion, skip: { value: false } }];
+ return [{ kind: 'current', value: miseNodeVersion, skip: { value: false } }];
}
const resolvedVersions = configNodeVersions.map((v): NodeVersionMeta => {
if (v === 'current') {
- return { kind: 'current', value: nvmrcVersion, skip: computeSkipForVersion(envVersion, nvmrcVersion) };
+ return {
+ kind: 'current',
+ value: miseNodeVersion,
+ skip: computeSkipForVersion(envVersion, miseNodeVersion),
+ };
}
return { kind: 'static', value: v, skip: computeSkipForVersion(envVersion, v) };
});
@@ -80,10 +86,7 @@ export function resolveNodeVersionMetaList(
/**
* Compute skip state for a single version in CI mode.
*/
-function computeSkipForVersion(
- envVersion: string | undefined,
- versionValue: string
-): SkipInCI {
+function computeSkipForVersion(envVersion: string | undefined, versionValue: string): SkipInCI {
if (!isCI() || !envVersion) {
return { value: false };
}
@@ -99,37 +102,17 @@ function computeSkipForVersion(
}
/**
- * Read the Node.js version from .nvmrc file.
+ * Read a tool version from mise.toml.
* Used to determine the version for 'current' tests.
*/
-export function getNvmrcVersion(): string {
+export function getMiseVersion(tool: 'node' | 'deno'): string {
try {
- const nvmrc = readFileSync(resolve(getRepoRoot(), '.nvmrc'), 'utf-8');
- return nvmrc.trim();
- } catch {
- console.warn(
- 'Failed to read .nvmrc, falling back to current Node.js version (as read by Bun, so its value is unpredictable)',
- process.versions.node
- );
- return process.versions.node;
- }
-}
-
-/**
- * Read the Deno version from .dvmrc file.
- * Used to determine the version for 'current' tests.
- *
- * @throws Error if .dvmrc file does not exist
- */
-export function getDvmrcVersion(): string {
- try {
- const dvmrc = readFileSync(resolve(getRepoRoot(), '.dvmrc'), 'utf-8');
- return dvmrc.trim();
- } catch {
- throw new Error(
- 'Failed to read .dvmrc for Deno version resolution. ' +
- 'Create a .dvmrc file at the repo root with the desired Deno version (e.g., "2.6.7").'
- );
+ return execFileSync('mise', ['current', tool], {
+ cwd: getRepoRoot(),
+ encoding: 'utf-8',
+ }).trim();
+ } catch (err) {
+ throw new Error(`Failed to resolve ${tool} version from mise.toml: ${(err as Error).message}`);
}
}
@@ -146,17 +129,16 @@ export function getCliPackageVersion(): string {
}
return String(parsed.version).trim();
} catch (err) {
- throw new Error(`Failed to read CLI version from ts/packages/cli/package.json: ${(err as Error).message}`);
+ throw new Error(
+ `Failed to read CLI version from ts/packages/cli/package.json: ${(err as Error).message}`
+ );
}
}
/**
* Compute skip state for a Deno version in CI mode.
*/
-function computeSkipForDenoVersion(
- envVersion: string | undefined,
- versionValue: string
-): SkipInCI {
+function computeSkipForDenoVersion(envVersion: string | undefined, versionValue: string): SkipInCI {
if (!isCI() || !envVersion) {
return { value: false };
}
@@ -174,10 +156,7 @@ function computeSkipForDenoVersion(
/**
* Compute skip state for a CLI version in CI mode.
*/
-function computeSkipForCliVersion(
- envVersion: string | undefined,
- versionValue: string
-): SkipInCI {
+function computeSkipForCliVersion(envVersion: string | undefined, versionValue: string): SkipInCI {
if (!isCI() || !envVersion) {
return { value: false };
}
@@ -195,7 +174,7 @@ function computeSkipForCliVersion(
/**
* Resolve the Deno versions to test against, with CI skip state.
*
- * The `'current'` version always resolves to the value in `.dvmrc`.
+ * The `'current'` version always resolves to the value in mise.toml.
*
* In CI mode (CI env var set + COMPOSIO_E2E_DENO_VERSION set):
* - Versions not matching COMPOSIO_E2E_DENO_VERSION are marked to skip
@@ -210,22 +189,26 @@ export function resolveDenoVersionMetaList(
const envVersion = Bun.env.COMPOSIO_E2E_DENO_VERSION;
// Local mode with env override: single version, no skip
- // Check this BEFORE calling getDvmrcVersion() so env override works without .dvmrc
+ // Check this BEFORE calling mise so env override works without the local toolchain installed.
if (!isCI() && envVersion) {
return [{ kind: 'overridden', value: envVersion, skip: { value: false } }];
}
- // Only read .dvmrc after env override check (getDvmrcVersion throws if file missing)
- const dvmrcVersion = getDvmrcVersion();
+ // Only read mise.toml after env override check.
+ const miseDenoVersion = getMiseVersion('deno');
- // No config provided: use .dvmrc version
+ // No config provided: use mise.toml version
if (configDenoVersions === undefined || configDenoVersions.length === 0) {
- return [{ kind: 'current', value: dvmrcVersion, skip: { value: false } }];
+ return [{ kind: 'current', value: miseDenoVersion, skip: { value: false } }];
}
const resolvedVersions = configDenoVersions.map((v): DenoVersionMeta => {
if (v === 'current') {
- return { kind: 'current', value: dvmrcVersion, skip: computeSkipForDenoVersion(envVersion, dvmrcVersion) };
+ return {
+ kind: 'current',
+ value: miseDenoVersion,
+ skip: computeSkipForDenoVersion(envVersion, miseDenoVersion),
+ };
}
return { kind: 'static', value: v, skip: computeSkipForDenoVersion(envVersion, v) };
});
@@ -263,7 +246,11 @@ export function resolveCliVersionMetaList(
const resolvedVersions = configCliVersions.map((v): CliVersionMeta => {
if (v === 'current') {
- return { kind: 'current', value: currentVersion, skip: computeSkipForCliVersion(envVersion, currentVersion) };
+ return {
+ kind: 'current',
+ value: currentVersion,
+ skip: computeSkipForCliVersion(envVersion, currentVersion),
+ };
}
return { kind: 'static', value: v, skip: computeSkipForCliVersion(envVersion, v) };
});
diff --git a/ts/e2e-tests/_utils/src/const.ts b/ts/e2e-tests/_utils/src/const.ts
index f435c6165..9574836e6 100644
--- a/ts/e2e-tests/_utils/src/const.ts
+++ b/ts/e2e-tests/_utils/src/const.ts
@@ -1,19 +1,25 @@
+import toolchainVersions from '../../../../toolchain-versions.json' with { type: 'json' };
+
/**
* Environment variables to automatically pass through to Docker containers.
*/
-export const WELL_KNOWN_ENV_VARS = ['COMPOSIO_API_KEY', 'COMPOSIO_BASE_URL', 'OPENAI_API_KEY'] as const;
+export const WELL_KNOWN_ENV_VARS = [
+ 'COMPOSIO_API_KEY',
+ 'COMPOSIO_BASE_URL',
+ 'OPENAI_API_KEY',
+] as const;
/**
* Node.js versions that are well-known to the CI matrix strategy.
- * `current` refers to the Node.js version specified in `.nvmrc`.
+ * `current` refers to the Node.js version specified in mise.toml.
*/
-export const WELL_KNOWN_NODE_VERSIONS = ['20.18.0', '20.19.0', '22.12.0', 'current'] as const;
+export const WELL_KNOWN_NODE_VERSIONS = [...toolchainVersions.node, 'current'] as const;
/**
* Deno versions that are well-known to the CI matrix strategy.
- * `current` refers to the Deno version specified in `.dvmrc`.
+ * `current` refers to the Deno version specified in mise.toml.
*/
-export const WELL_KNOWN_DENO_VERSIONS = ['2.6.7', 'current'] as const;
+export const WELL_KNOWN_DENO_VERSIONS = [...toolchainVersions.deno, 'current'] as const;
/**
* CLI versions that are well-known to the CI strategy.
diff --git a/ts/e2e-tests/_utils/src/e2e.ts b/ts/e2e-tests/_utils/src/e2e.ts
index 48ed982c8..cbbc12a1c 100644
--- a/ts/e2e-tests/_utils/src/e2e.ts
+++ b/ts/e2e-tests/_utils/src/e2e.ts
@@ -52,7 +52,7 @@ function inferCwd(importMetaUrl: string, repoRoot: string): string {
* import type { E2ETestResult } from '@e2e-tests/utils';
*
* e2e(import.meta.url, {
- * versions: { node: ['20.19.0', '22.12.0'] },
+ * versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
* env: { COMPOSIO_API_KEY: process.env.COMPOSIO_API_KEY },
* defineTests: ({ describe, it, expect, beforeAll, runFixture }) => {
* let result: E2ETestResult;
diff --git a/ts/e2e-tests/_utils/src/image-lifecycle.ts b/ts/e2e-tests/_utils/src/image-lifecycle.ts
index dee051728..bc52e8fe5 100644
--- a/ts/e2e-tests/_utils/src/image-lifecycle.ts
+++ b/ts/e2e-tests/_utils/src/image-lifecycle.ts
@@ -158,9 +158,7 @@ async function exec(cmd: string, args: string[], options: ExecOptions = {}): Pro
const { cwd, env } = options;
const escapedArgs = args.map(escapeShellArg).join(' ');
- let shell = $`${{ raw: cmd }} ${{ raw: escapedArgs }}`
- .nothrow()
- .quiet();
+ let shell = $`${{ raw: cmd }} ${{ raw: escapedArgs }}`.nothrow().quiet();
if (cwd) {
shell = shell.cwd(cwd);
@@ -187,6 +185,21 @@ export async function checkDocker(options: CheckDockerOptions = {}): Promise<Exe
return exec('docker', ['info'], { cwd: repoRoot });
}
+async function getMiseVersion(tool: 'node' | 'bun' | 'deno', repoRoot: string): Promise<string> {
+ const result = await exec('mise', ['current', tool], { cwd: repoRoot });
+ const version = result.stdout.trim();
+ if (result.exitCode !== 0 || !version) {
+ throw new Error(
+ `Failed to resolve ${tool} version from mise.toml: ${result.stderr || result.stdout}`
+ );
+ }
+ return version;
+}
+
+function getMajorVersion(version: string): string {
+ return version.split('.')[0] ?? version;
+}
+
/**
* Creates image tag for a given Node version.
*/
@@ -214,8 +227,10 @@ export async function ensureNodeImage(
}
const repoRoot = options.repoRoot ?? getRepoRoot();
- const dockerfilePath = options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.node');
+ const dockerfilePath =
+ options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.node');
const imageTag = imageTagForNodeVersion(nodeVersion);
+ const bunVersion = await getMiseVersion('bun', repoRoot);
const inspect = await exec('docker', ['image', 'inspect', imageTag], { cwd: repoRoot });
if (inspect.exitCode === 0) {
@@ -228,6 +243,8 @@ export async function ensureNodeImage(
dockerfilePath,
'--build-arg',
`NODE_VERSION=${nodeVersion}`,
+ '--build-arg',
+ `BUN_VERSION=${bunVersion}`,
...labelsToArgs(defaultNodeLabels(nodeVersion)),
'-t',
imageTag,
@@ -329,7 +346,7 @@ export async function runNodeContainer(options: RunNodeContainerOptions): Promis
// Handle cmd as array for direct execution without shell interpretation.
if (Array.isArray(cmd)) {
dockerArgs.push(...cmd.map(String));
- // Handle cmd as string by wrapping in login shell for proper environment setup.
+ // Handle cmd as string by wrapping in login shell for proper environment setup.
} else if (typeof cmd === 'string' && cmd.length > 0) {
dockerArgs.push('sh', '-lc', cmd);
} else {
@@ -395,8 +412,11 @@ export async function ensureDenoImage(
}
const repoRoot = options.repoRoot ?? getRepoRoot();
- const dockerfilePath = options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.deno');
+ const dockerfilePath =
+ options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.deno');
const imageTag = imageTagForDenoVersion(denoVersion);
+ const nodeVersion = await getMiseVersion('node', repoRoot);
+ const bunVersion = await getMiseVersion('bun', repoRoot);
const inspect = await exec('docker', ['image', 'inspect', imageTag], { cwd: repoRoot });
if (inspect.exitCode === 0) {
@@ -409,6 +429,10 @@ export async function ensureDenoImage(
dockerfilePath,
'--build-arg',
`DENO_VERSION=${denoVersion}`,
+ '--build-arg',
+ `NODE_MAJOR=${getMajorVersion(nodeVersion)}`,
+ '--build-arg',
+ `BUN_VERSION=${bunVersion}`,
...labelsToArgs(defaultDenoLabels(denoVersion)),
'-t',
imageTag,
@@ -510,8 +534,8 @@ export async function runDenoContainer(options: RunDenoContainerOptions): Promis
// Handle cmd as array for direct execution without shell interpretation.
if (Array.isArray(cmd)) {
dockerArgs.push(...cmd.map(String));
- // Handle cmd as string by wrapping in login shell for proper environment setup.
- // Callers must explicitly use 'deno run --allow-all <file>' when running Deno scripts.
+ // Handle cmd as string by wrapping in login shell for proper environment setup.
+ // Callers must explicitly use 'deno run --allow-all <file>' when running Deno scripts.
} else if (typeof cmd === 'string' && cmd.length > 0) {
dockerArgs.push('sh', '-lc', cmd);
} else {
@@ -577,8 +601,11 @@ export async function ensureCliImage(
}
const repoRoot = options.repoRoot ?? getRepoRoot();
- const dockerfilePath = options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.cli');
+ const dockerfilePath =
+ options.dockerfilePath ?? resolve(repoRoot, 'ts/e2e-tests/_utils/Dockerfile.cli');
const imageTag = imageTagForCliVersion(cliVersion);
+ const nodeVersion = await getMiseVersion('node', repoRoot);
+ const bunVersion = await getMiseVersion('bun', repoRoot);
const inspect = await exec('docker', ['image', 'inspect', imageTag], { cwd: repoRoot });
if (inspect.exitCode === 0) {
@@ -591,6 +618,10 @@ export async function ensureCliImage(
dockerfilePath,
'--build-arg',
`CLI_VERSION=${cliVersion}`,
+ '--build-arg',
+ `NODE_VERSION=${nodeVersion}`,
+ '--build-arg',
+ `BUN_VERSION=${bunVersion}`,
...labelsToArgs(defaultCliLabels(cliVersion)),
'-t',
imageTag,
diff --git a/ts/e2e-tests/_utils/src/types.ts b/ts/e2e-tests/_utils/src/types.ts
index eb01ba1f4..e9eb0242a 100644
--- a/ts/e2e-tests/_utils/src/types.ts
+++ b/ts/e2e-tests/_utils/src/types.ts
@@ -173,7 +173,7 @@ export interface E2EConfig {
* @example
* ```typescript
* versions: {
- * node: ['20.19.0', '22.12.0'],
+ * node: ['22.22.3', '24.16.0', '25.9.0'],
* deno: ['2.6.7'],
* }
* ```
diff --git a/ts/e2e-tests/_utils/tsconfig.json b/ts/e2e-tests/_utils/tsconfig.json
index 9d8a50861..bf7ac3620 100644
--- a/ts/e2e-tests/_utils/tsconfig.json
+++ b/ts/e2e-tests/_utils/tsconfig.json
@@ -4,6 +4,7 @@
"target": "es2022",
"module": "esnext",
"moduleResolution": "bundler",
+ "resolveJsonModule": true,
"strict": true,
"skipLibCheck": true,
"noEmit": true,
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/src/index.ts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/src/index.ts
index c6b0f9086..ebb4845cb 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/src/index.ts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/src/index.ts
@@ -8,6 +8,7 @@ import { Hono } from 'hono';
type Bindings = {
COMPOSIO_API_KEY: string;
+ COMPOSIO_BASE_URL: string;
};
const app = new Hono<{ Bindings: Bindings }>();
@@ -59,6 +60,7 @@ app.get('/test/files/upload', async c => {
try {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
// Attempt to call files.upload - should throw an error
@@ -98,6 +100,7 @@ app.get('/test/files/download', async c => {
try {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
// Attempt to call files.download - should throw an error
@@ -138,6 +141,7 @@ app.get('/test/hackernews', async c => {
try {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
const userDetails = await composio.tools.execute('HACKERNEWS_GET_USER', {
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/vitest.config.mts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/vitest.config.mts
index d108889ef..fc84dc856 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/vitest.config.mts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-basic/vitest.config.mts
@@ -11,6 +11,7 @@ export default defineWorkersConfig({
miniflare: {
bindings: {
COMPOSIO_API_KEY: process.env.COMPOSIO_API_KEY!,
+ COMPOSIO_BASE_URL: process.env.COMPOSIO_BASE_URL!,
},
},
},
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/src/index.ts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/src/index.ts
index ccbc85b0e..3174ec656 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/src/index.ts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/src/index.ts
@@ -8,6 +8,7 @@ import { Hono } from 'hono';
type Bindings = {
COMPOSIO_API_KEY: string;
+ COMPOSIO_BASE_URL: string;
};
const app = new Hono<{ Bindings: Bindings }>();
@@ -35,6 +36,7 @@ app.get('/test/files/upload', async c => {
try {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
// Attempt to call files.upload - should throw an error
@@ -67,6 +69,7 @@ app.get('/test/files/download', async c => {
try {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
// Attempt to call files.download - should throw an error
@@ -103,6 +106,7 @@ app.get('/test/auto-upload-disabled', async c => {
// Explicitly keep automatic file handling off (default everywhere)
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
dangerouslyAllowAutoUploadDownloadFiles: false,
});
@@ -141,6 +145,7 @@ app.get('/test/default-config', async c => {
// Should use the workerd default (false)
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
});
return c.json({
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/vitest.config.mts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/vitest.config.mts
index 454d4062d..86d1c8e5a 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/vitest.config.mts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-files/vitest.config.mts
@@ -11,6 +11,7 @@ export default defineWorkersConfig({
miniflare: {
bindings: {
COMPOSIO_API_KEY: process.env.COMPOSIO_API_KEY ?? 'test-key',
+ COMPOSIO_BASE_URL: process.env.COMPOSIO_BASE_URL ?? 'https://backend.composio.dev',
},
},
},
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/src/index.ts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/src/index.ts
index 2467cf439..d1b2c57fa 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/src/index.ts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/src/index.ts
@@ -13,6 +13,7 @@ import { z } from 'zod/v4';
type Bindings = {
COMPOSIO_API_KEY: string;
+ COMPOSIO_BASE_URL: string;
OPENAI_API_KEY: string;
};
@@ -38,6 +39,7 @@ app.get('/', c => {
app.get('/test/mcp-client', async c => {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
provider: new VercelProvider(),
});
@@ -78,6 +80,7 @@ app.get('/test/mcp-client', async c => {
app.get('/test/agent', async c => {
const composio = new Composio({
apiKey: c.env.COMPOSIO_API_KEY,
+ baseURL: c.env.COMPOSIO_BASE_URL,
provider: new VercelProvider(),
});
diff --git a/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/vitest.config.mts b/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/vitest.config.mts
index f118d0900..fee393964 100644
--- a/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/vitest.config.mts
+++ b/ts/e2e-tests/runtimes/cloudflare/cf-workers-tool-router-ai/vitest.config.mts
@@ -11,6 +11,7 @@ export default defineWorkersConfig({
miniflare: {
bindings: {
COMPOSIO_API_KEY: process.env.COMPOSIO_API_KEY!,
+ COMPOSIO_BASE_URL: process.env.COMPOSIO_BASE_URL!,
OPENAI_API_KEY: process.env.OPENAI_API_KEY!,
},
},
diff --git a/ts/e2e-tests/runtimes/node/cjs-basic/README.md b/ts/e2e-tests/runtimes/node/cjs-basic/README.md
index d83fb6ecf..8d46d565a 100644
--- a/ts/e2e-tests/runtimes/node/cjs-basic/README.md
+++ b/ts/e2e-tests/runtimes/node/cjs-basic/README.md
@@ -40,7 +40,7 @@ The fixture is a standalone `.cjs` file that:
## Isolation Tool
-**Docker** with Node.js versions: 20.18.0, 20.19.0, 22.12.0.
+**Docker** with Node.js versions: 22.22.3, 24.16.0, 25.9.0.
## Running
diff --git a/ts/e2e-tests/runtimes/node/cjs-basic/e2e.test.ts b/ts/e2e-tests/runtimes/node/cjs-basic/e2e.test.ts
index 1a473b3ba..5c87785a0 100644
--- a/ts/e2e-tests/runtimes/node/cjs-basic/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/cjs-basic/e2e.test.ts
@@ -10,13 +10,7 @@ import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
versions: {
- node: [
- // may throw ERR_REQUIRE_ESM
- '20.18.0',
- // supports ESM by default
- '20.19.0',
- '22.12.0',
- ],
+ node: ['22.22.3', '24.16.0', '25.9.0'],
},
usesFixtures: true,
defineTests: ({ runFixture }) => {
diff --git a/ts/e2e-tests/runtimes/node/custom-tools/e2e.test.ts b/ts/e2e-tests/runtimes/node/custom-tools/e2e.test.ts
index a58493634..fc2d8b0b3 100644
--- a/ts/e2e-tests/runtimes/node/custom-tools/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/custom-tools/e2e.test.ts
@@ -17,7 +17,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['20.19.0', '22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
usesFixtures: true,
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/esm-basic/README.md b/ts/e2e-tests/runtimes/node/esm-basic/README.md
index 5a9be9445..d92147092 100644
--- a/ts/e2e-tests/runtimes/node/esm-basic/README.md
+++ b/ts/e2e-tests/runtimes/node/esm-basic/README.md
@@ -42,7 +42,7 @@ The fixture is a standalone `.mjs` file that:
## Isolation Tool
-**Docker** with Node.js versions: 20.18.0, 20.19.0, 22.12.0.
+**Docker** with Node.js versions: 22.22.3, 24.16.0, 25.9.0.
## Running
diff --git a/ts/e2e-tests/runtimes/node/esm-basic/e2e.test.ts b/ts/e2e-tests/runtimes/node/esm-basic/e2e.test.ts
index c8a128914..bd9125ce0 100644
--- a/ts/e2e-tests/runtimes/node/esm-basic/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/esm-basic/e2e.test.ts
@@ -10,13 +10,7 @@ import { describe, it, expect, beforeAll } from 'bun:test';
e2e(import.meta.url, {
versions: {
- node: [
- // may throw ERR_REQUIRE_ESM
- '20.18.0',
- // supports ESM by default
- '20.19.0',
- '22.12.0',
- ],
+ node: ['22.22.3', '24.16.0', '25.9.0'],
},
usesFixtures: true,
defineTests: ({ runFixture }) => {
diff --git a/ts/e2e-tests/runtimes/node/file-roundtrip/README.md b/ts/e2e-tests/runtimes/node/file-roundtrip/README.md
index 41fd10df7..d5709b90b 100644
--- a/ts/e2e-tests/runtimes/node/file-roundtrip/README.md
+++ b/ts/e2e-tests/runtimes/node/file-roundtrip/README.md
@@ -14,11 +14,11 @@ It performs a real round-trip:
## What It Tests
-| Test | Description |
-| ---- | ----------- |
-| Upload | Uploads a deterministic binary payload via `composio.files.upload()` |
-| Download | Downloads the uploaded object back from storage |
-| Integrity | Compares byte length and SHA-256 checksum |
+| Test | Description |
+| --------- | -------------------------------------------------------------------- |
+| Upload | Uploads a deterministic binary payload via `composio.files.upload()` |
+| Download | Downloads the uploaded object back from storage |
+| Integrity | Compares byte length and SHA-256 checksum |
## Requirements
@@ -31,7 +31,7 @@ If `COMPOSIO_API_KEY` is not set, the suite is skipped.
## Isolation Tool
-**Docker** with Node.js versions: current (as specified in `.nvmrc`).
+**Docker** with Node.js versions: current (as specified in `mise.toml`).
This ensures the behavior is tested against specific Node.js versions independent of the developer's local setup.
diff --git a/ts/e2e-tests/runtimes/node/json-schema-to-zod-v3/README.md b/ts/e2e-tests/runtimes/node/json-schema-to-zod-v3/README.md
index 05fd87c1f..86750d877 100644
--- a/ts/e2e-tests/runtimes/node/json-schema-to-zod-v3/README.md
+++ b/ts/e2e-tests/runtimes/node/json-schema-to-zod-v3/README.md
@@ -13,14 +13,14 @@ The `@composio/json-schema-to-zod` package must support both Zod v3 and v4. This
## What It Tests
-| Test | Description |
-| --------------------- | ---------------------------------------------------------------- |
-| Basic string schema | Converts `{ type: 'string' }` and validates |
-| Object schema | Required fields, nested properties, validation constraints |
-| Array schema | Typed array items with validation |
-| Email format | Format validation for email strings |
-| Nested schemas | Complex nested objects and arrays |
-| anyOf schemas | Union type conversion |
+| Test | Description |
+| --------------------- | ------------------------------------------------------------------ |
+| Basic string schema | Converts `{ type: 'string' }` and validates |
+| Object schema | Required fields, nested properties, validation constraints |
+| Array schema | Typed array items with validation |
+| Email format | Format validation for email strings |
+| Nested schemas | Complex nested objects and arrays |
+| anyOf schemas | Union type conversion |
| Round-trip conversion | JSON Schema -> Zod -> JSON Schema preserves `additionalProperties` |
## Test Setup
@@ -36,7 +36,7 @@ Tests use `bun:test` assertions to verify schema conversion and round-trip behav
## Isolation Tool
-**Docker** with Node.js versions: current (as specified in `.nvmrc`).
+**Docker** with Node.js versions: current (as specified in `mise.toml`).
## Running
diff --git a/ts/e2e-tests/runtimes/node/json-schema-to-zod-v4/README.md b/ts/e2e-tests/runtimes/node/json-schema-to-zod-v4/README.md
index 9196d13f9..fa400737a 100644
--- a/ts/e2e-tests/runtimes/node/json-schema-to-zod-v4/README.md
+++ b/ts/e2e-tests/runtimes/node/json-schema-to-zod-v4/README.md
@@ -37,7 +37,7 @@ Tests use `bun:test` assertions to verify schema conversion and parsing behavior
## Isolation Tool
-**Docker** with Node.js versions: current (as specified in `.nvmrc`).
+**Docker** with Node.js versions: current (as specified in `mise.toml`).
## Running
diff --git a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/README.md b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/README.md
index da970ad11..14887b020 100644
--- a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/README.md
+++ b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/README.md
@@ -37,7 +37,7 @@ import { z } from 'zod';
## Isolation Tool
-**Docker** with Node.js versions: 22.12.0.
+**Docker** with Node.js versions: 22.22.3, 24.16.0, 25.9.0.
## Running
diff --git a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/e2e.test.ts b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/e2e.test.ts
index eaefb738f..3fabea90f 100644
--- a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v3/e2e.test.ts
@@ -25,7 +25,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
OPENAI_API_KEY: Bun.env.OPENAI_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/README.md b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/README.md
index 404a89a98..597d58e1a 100644
--- a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/README.md
+++ b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/README.md
@@ -37,7 +37,7 @@ import { z } from 'zod';
## Isolation Tool
-**Docker** with Node.js versions: 22.12.0.
+**Docker** with Node.js versions: 22.22.3, 24.16.0, 25.9.0.
## Running
diff --git a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/e2e.test.ts b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/e2e.test.ts
index c3e89ab77..9ae3489a2 100644
--- a/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/mastra-tool-router-zod-v4/e2e.test.ts
@@ -25,7 +25,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
OPENAI_API_KEY: Bun.env.OPENAI_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/openai-zod4-compat/README.md b/ts/e2e-tests/runtimes/node/openai-zod4-compat/README.md
index 9c85022b4..3090cfe6a 100644
--- a/ts/e2e-tests/runtimes/node/openai-zod4-compat/README.md
+++ b/ts/e2e-tests/runtimes/node/openai-zod4-compat/README.md
@@ -34,7 +34,7 @@ The `setup` phase runs `npm install --legacy-peer-deps` in a Docker volume, then
## Isolation Tool
-**Docker** with Node.js versions: 20.19.0, 22.12.0.
+**Docker** with Node.js versions: 22.22.3, 24.16.0, 25.9.0.
## Running
diff --git a/ts/e2e-tests/runtimes/node/openai-zod4-compat/e2e.test.ts b/ts/e2e-tests/runtimes/node/openai-zod4-compat/e2e.test.ts
index 76da162e6..600fcefd2 100644
--- a/ts/e2e-tests/runtimes/node/openai-zod4-compat/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/openai-zod4-compat/e2e.test.ts
@@ -15,7 +15,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['20.19.0', '22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
usesFixtures: true,
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/tool-router-files/e2e.test.ts b/ts/e2e-tests/runtimes/node/tool-router-files/e2e.test.ts
index db9f7f8f5..dfd8ded28 100644
--- a/ts/e2e-tests/runtimes/node/tool-router-files/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/tool-router-files/e2e.test.ts
@@ -15,7 +15,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['20.19.0', '22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
usesFixtures: true,
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/tool-router-pagination/e2e.test.ts b/ts/e2e-tests/runtimes/node/tool-router-pagination/e2e.test.ts
index 2c7eed538..997421e0b 100644
--- a/ts/e2e-tests/runtimes/node/tool-router-pagination/e2e.test.ts
+++ b/ts/e2e-tests/runtimes/node/tool-router-pagination/e2e.test.ts
@@ -22,7 +22,7 @@ declare module 'bun' {
}
e2e(import.meta.url, {
- versions: { node: ['20.19.0', '22.12.0'] },
+ versions: { node: ['22.22.3', '24.16.0', '25.9.0'] },
usesFixtures: true,
env: {
COMPOSIO_API_KEY: Bun.env.COMPOSIO_API_KEY,
diff --git a/ts/e2e-tests/runtimes/node/typescript-mjs-import-nodenext/README.md b/ts/e2e-tests/runtimes/node/typescript-mjs-import-nodenext/README.md
index 6dddd700e..0d446e30e 100644
--- a/ts/e2e-tests/runtimes/node/typescript-mjs-import-nodenext/README.md
+++ b/ts/e2e-tests/runtimes/node/typescript-mjs-import-nodenext/README.md
@@ -16,11 +16,11 @@ This causes `TS2307: Cannot find module './foo.mjs'` errors.
## What It Tests
-| Test | Description |
-| ---------------------- | -------------------------------------------------------------- |
+| Test | Description |
+| ---------------------- | ------------------------------------------------------------ |
| composio generate ts | Runs CLI to generate TypeScript files for hackernews toolkit |
-| File existence | Verifies generated .ts files exist |
-| TypeScript compilation | Runs `tsc --noEmit` to check import resolution |
+| File existence | Verifies generated .ts files exist |
+| TypeScript compilation | Runs `tsc --noEmit` to check import resolution |
## Fixture
@@ -55,7 +55,7 @@ The fixture script:
## Isolation Tool
-**Docker** with Node.js versions: current (as specified in `.nvmrc`).
+**Docker** with Node.js versions: current (as specified in `mise.toml`).
## Running
diff --git a/ts/scripts/pre-install.sh b/ts/scripts/pre-install.sh
index bcddb88e3..cbfe2091c 100755
--- a/ts/scripts/pre-install.sh
+++ b/ts/scripts/pre-install.sh
@@ -2,9 +2,9 @@
set -eo pipefail
-# Allow bypassing the entire Bun check (useful for CI workflows using pre-built images)
-if [ -n "$BYPASS_BUN_VERSION_CHECK" ]; then
- echo "Bypassing Bun version check (BYPASS_BUN_VERSION_CHECK is set)"
+# Allow bypassing the local toolchain check (useful for CI workflows using prebuilt images)
+if [ -n "$BYPASS_TOOLCHAIN_CHECK" ]; then
+ echo "Bypassing toolchain check (BYPASS_TOOLCHAIN_CHECK is set)"
exit 0
fi
@@ -17,5 +17,5 @@ if ! command -v bun &> /dev/null; then
fi
echo "Bun is installed."
-echo "Checking if Bun version matches .bun-version file..."
-bun run "$SCRIPT_DIR/pre-install/check-bun-version.ts"
+echo "Checking if Bun version matches mise.toml..."
+bun run "$SCRIPT_DIR/pre-install/check-toolchain.ts"
diff --git a/ts/scripts/pre-install/check-bun-version.ts b/ts/scripts/pre-install/check-bun-version.ts
deleted file mode 100644
index fdec58a6b..000000000
--- a/ts/scripts/pre-install/check-bun-version.ts
+++ /dev/null
@@ -1,43 +0,0 @@
-#!/usr/bin/env bun
-
-declare module "bun" {
- interface Env {
- /**
- * If set, bypasses the Bun version check.
- * Useful for those CI workflows relying on prebuild environments (e.g., ghcr.io/composiohq/dev-base).
- */
- BYPASS_BUN_VERSION_CHECK: string;
- }
-}
-
-/**
- * Check if the installed Bun version matches the required version in .bun-version.
- * Useful for CI workflows relying on the @oven-sh/setup-bun action.
- *
- * This check is needed because Bun doesn't enforce `.bun-version`, and is ignored by corepack.
- */
-async function main() {
- if (Bun.env.BYPASS_BUN_VERSION_CHECK) {
- return;
- }
-
- const requiredBunVersion = (
- await Bun.file('.bun-version').text()
- ).trim();
- const actualBunVersion = Bun.version.trim();
-
- if (actualBunVersion != requiredBunVersion) {
- console.error(
- `Bun version mismatch: expected ${requiredBunVersion}, got ${actualBunVersion}.
-You can install the required version by running
-
-\`curl -fsSl https://bun.sh/install | bash -s "bun-v${requiredBunVersion}"\`
-`,
- );
- process.exit(1);
- }
-}
-
-if (import.meta.path === Bun.main) {
- main();
-}
diff --git a/ts/scripts/pre-install/check-toolchain.ts b/ts/scripts/pre-install/check-toolchain.ts
new file mode 100644
index 000000000..7c5c566e0
--- /dev/null
+++ b/ts/scripts/pre-install/check-toolchain.ts
@@ -0,0 +1,53 @@
+#!/usr/bin/env bun
+
+import { execFileSync } from 'node:child_process';
+
+declare module 'bun' {
+ interface Env {
+ /**
+ * If set, bypasses the local toolchain check.
+ * Useful for CI workflows relying on prebuilt environments.
+ */
+ BYPASS_TOOLCHAIN_CHECK: string;
+ }
+}
+
+function getRequiredBunVersion(): string {
+ try {
+ return execFileSync('mise', ['current', 'bun'], { encoding: 'utf-8' }).trim();
+ } catch (err) {
+ console.error(
+ `Failed to resolve Bun version from mise.toml.
+Install mise and run:
+
+\`mise install\`
+
+Original error: ${(err as Error).message}`
+ );
+ process.exit(1);
+ }
+}
+
+function main() {
+ if (Bun.env.BYPASS_TOOLCHAIN_CHECK) {
+ return;
+ }
+
+ const requiredBunVersion = getRequiredBunVersion();
+ const actualBunVersion = Bun.version.trim();
+
+ if (actualBunVersion !== requiredBunVersion) {
+ console.error(
+ `Bun version mismatch: expected ${requiredBunVersion}, got ${actualBunVersion}.
+Install the repository toolchain by running:
+
+\`mise install\`
+`
+ );
+ process.exit(1);
+ }
+}
+
+if (import.meta.path === Bun.main) {
+ main();
+}
diff --git a/turbo.jsonc b/turbo.jsonc
index e0dc4cf5a..84cd33217 100644
--- a/turbo.jsonc
+++ b/turbo.jsonc
@@ -19,27 +19,27 @@
},
"test:e2e": {
"dependsOn": ["^build"],
- "env": ["COMPOSIO_API_KEY", "COMPOSIO_USER_API_KEY", "OPENAI_API_KEY"],
+ "env": ["COMPOSIO_API_KEY", "COMPOSIO_BASE_URL", "COMPOSIO_USER_API_KEY", "OPENAI_API_KEY"],
"cache": false
},
"test:e2e:node": {
"dependsOn": ["^build"],
- "env": ["COMPOSIO_API_KEY", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_NODE_VERSION", "OPENAI_API_KEY"],
+ "env": ["COMPOSIO_API_KEY", "COMPOSIO_BASE_URL", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_NODE_VERSION", "OPENAI_API_KEY"],
"cache": false
},
"test:e2e:deno": {
"dependsOn": ["^build"],
- "env": ["COMPOSIO_API_KEY", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_DENO_VERSION", "OPENAI_API_KEY"],
+ "env": ["COMPOSIO_API_KEY", "COMPOSIO_BASE_URL", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_DENO_VERSION", "OPENAI_API_KEY"],
"cache": false
},
"test:e2e:cli": {
"dependsOn": ["^build"],
- "env": ["COMPOSIO_API_KEY", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_CLI_VERSION", "OPENAI_API_KEY"],
+ "env": ["COMPOSIO_API_KEY", "COMPOSIO_BASE_URL", "COMPOSIO_USER_API_KEY", "COMPOSIO_E2E_CLI_VERSION", "OPENAI_API_KEY"],
"cache": false
},
"test:e2e:cloudflare": {
"dependsOn": ["^build"],
- "env": ["COMPOSIO_API_KEY", "COMPOSIO_USER_API_KEY", "OPENAI_API_KEY"],
+ "env": ["COMPOSIO_API_KEY", "COMPOSIO_BASE_URL", "COMPOSIO_USER_API_KEY", "OPENAI_API_KEY"],
"cache": false
},
"install:binary": {