Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
feat(toolchain): introduce mise.toml as single source of truth (#3492)
Alberto Schiabel07160d14fa04
diff --git a/.gitignore b/.gitignoreindex 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.tomldiff --git a/AGENTS.md b/AGENTS.mdindex 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#packageManagerpnpm install # Install dependenciespnpm check:peer-deps # Check peer dependenciespnpm 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.mdindex 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#packageManagerpnpm install # First-time setup. Use BYPASS_BUN_VERSION_CHECK=1 if .bun-version mismatchpnpm 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 Alsodiff --git a/mise.toml b/mise.tomlnew file mode 100644index 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.jsonindex 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.mdindex 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