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.

feat(toolchain): introduce mise.toml as single source of truth (#3492)

Alberto Schiabel07160d14fa04
diff --git a/.gitignore b/.gitignore
index ae784519b..a92667e4e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -62,3 +62,6 @@ test/e2e/*/node_modules
# Agent memory
.agent_cache
+
+# mise (per-dev overrides)
+.mise.local.toml
diff --git a/AGENTS.md b/AGENTS.md
index 109188e51..4b95658a5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,6 +26,8 @@ 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
pnpm install # Install dependencies
pnpm check:peer-deps # Check peer dependencies
pnpm update:peer-deps # Update peer dependencies
@@ -195,10 +197,15 @@ make build # Build packages
### When Updating GitHub Actions
-Update the "Prerequisites" section in `ts/docs/internal/release.md` with current tool versions:
+Toolchain versions are coalesced in `mise.toml`. To check the current values:
-- **Node.js**: `cat .nvmrc`
-- **Bun**: `cat .bun-version`
-- **pnpm**: `cat package.json | jq -r .packageManager | cut -d'@' -f2`
+- **Node.js**: `mise current node`
+- **Bun**: `mise current bun`
+- **Deno**: `mise current deno`
+- **Python**: `mise current python`
+- **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.
This monorepo uses pnpm workspaces and Turbo for efficient builds and development.
diff --git a/CLAUDE.md b/CLAUDE.md
index cd9ef06a2..b8ccb6631 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -29,6 +29,8 @@ composio/
## TypeScript Commands
```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 build # Build all packages (Turbo)
pnpm build:packages # TS packages only
@@ -45,7 +47,7 @@ pnpm create:provider <name> [--agentic]
pnpm create:example <name>
```
-Pinned tool versions: Node `.nvmrc` (20.20.2), Bun `.bun-version` (1.3.10), pnpm via `packageManager` in `package.json`. 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. 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.
## Python Commands
@@ -87,7 +89,8 @@ 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`
-- CI release docs to update when bumping toolchain: `ts/docs/internal/release.md` (Node/Bun/pnpm versions)
+- 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`)
+- 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}`
## See Also
diff --git a/mise.toml b/mise.toml
new file mode 100644
index 000000000..17d85ae22
--- /dev/null
+++ b/mise.toml
@@ -0,0 +1,30 @@
+# Single source of truth for Node, Bun, Deno, Python, and uv 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/`
+#
+# 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.
+
+min_version = "2026.1.0"
+
+[tools]
+node = "20.20.2"
+bun = "1.3.10"
+deno = "2.6.7"
+python = "3.12"
+uv = "0.8.19"
+
+[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"
diff --git a/package.json b/package.json
index 0b16da443..89b613d83 100644
--- a/package.json
+++ b/package.json
@@ -52,6 +52,18 @@
"clean:workspace": "pnpm turbo clean"
},
"packageManager": "[email protected]",
+ "devEngines": {
+ "runtime": {
+ "name": "node",
+ "version": "20.20.2",
+ "onFail": "warn"
+ },
+ "packageManager": {
+ "name": "pnpm",
+ "version": "10.28.2",
+ "onFail": "warn"
+ }
+ },
"devDependencies": {
"@arethetypeswrong/cli": "catalog:",
"@changesets/cli": "^2.29.8",
diff --git a/ts/docs/internal/release.md b/ts/docs/internal/release.md
index 79c14ba27..14ee7a494 100644
--- a/ts/docs/internal/release.md
+++ b/ts/docs/internal/release.md
@@ -79,9 +79,9 @@ The manual release process is available for cases where direct control over the
### Prerequisites
-- Node.js (version: `20.19.0`)
-- Bun (version: `1.3.6`)
-- pnpm (version: `10.28.0`)
+- Node.js (version: `20.20.2`)
+- Bun (version: `1.3.10`)
+- pnpm (version: `10.28.2`)
- Access to npm registry
- Write access to the repository