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.

fix(ts): declare the supported Node.js engine floor (#4219)

tgolobdb7b5764375c
diff --git a/.changeset/declare-node-engine-floor.md b/.changeset/declare-node-engine-floor.md
new file mode 100644
index 000000000..59dfc2fb0
--- /dev/null
+++ b/.changeset/declare-node-engine-floor.md
@@ -0,0 +1,18 @@
+---
+'@composio/core': patch
+'@composio/slim': patch
+'@composio/experimental': patch
+'@composio/json-schema-to-zod': patch
+'@composio/anthropic': patch
+'@composio/claude-agent-sdk': patch
+'@composio/cloudflare': patch
+'@composio/google': patch
+'@composio/langchain': patch
+'@composio/llamaindex': patch
+'@composio/mastra': patch
+'@composio/openai-agents': patch
+'@composio/openai': patch
+'@composio/vercel': patch
+---
+
+Declare Node.js 22.22.3 as the minimum supported runtime for every published TypeScript package so package managers surface incompatible runtimes before users encounter ESM loading failures.
diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.ts
index 980f948e1..e27fc5268 100644
--- a/test/release-workflow.test.ts
+++ b/test/release-workflow.test.ts
@@ -133,6 +133,34 @@ function readDocumentedSdkVersions(sdkLabel) {
return readSdkVersions(rows);
}
+function readTypeScriptWorkspacePackages() {
+ const workspacePackages = [];
+
+ for (const workspacePattern of packageJson.workspaces ?? []) {
+ if (!workspacePattern.startsWith('ts/packages/')) continue;
+
+ const workspacePaths = workspacePattern.endsWith('/*')
+ ? readdirSync(new URL(`../${workspacePattern.slice(0, -2)}/`, import.meta.url), {
+ withFileTypes: true,
+ })
+ .filter(entry => entry.isDirectory())
+ .map(entry => `${workspacePattern.slice(0, -1)}${entry.name}`)
+ : [workspacePattern];
+
+ for (const workspacePath of workspacePaths) {
+ const manifestUrl = new URL(`../${workspacePath}/package.json`, import.meta.url);
+ if (!existsSync(manifestUrl)) continue;
+
+ workspacePackages.push({
+ manifest: JSON.parse(readFileSync(manifestUrl, 'utf8')),
+ path: `${workspacePath}/package.json`,
+ });
+ }
+ }
+
+ return workspacePackages;
+}
+
function runPythonBuildFixture({ providers, providerFiles = [], failingProvider = '' }) {
const fixtureDir = mkdtempSync(join(tmpdir(), 'composio-python-build-'));
const buildLogPath = join(fixtureDir, 'build.log');
@@ -349,6 +377,28 @@ if (
);
}
+{
+ const MIN_NODE_VERSION = '>=22.22.3';
+ const publicTsReleaseWorkspaces = readTypeScriptWorkspacePackages().filter(
+ ({ manifest }) => manifest.private !== true
+ );
+ const invalidNodeEngines = publicTsReleaseWorkspaces.filter(
+ ({ manifest }) => manifest.engines?.node !== MIN_NODE_VERSION
+ );
+
+ if (publicTsReleaseWorkspaces.length === 0) {
+ throw new Error('Node.js engine validation must discover public TypeScript workspaces');
+ }
+ if (invalidNodeEngines.length > 0) {
+ const details = invalidNodeEngines
+ .map(({ manifest, path }) => `- ${path}: ${manifest.engines?.node ?? '<missing>'}`)
+ .join('\n');
+ throw new Error(
+ `Public TypeScript workspaces must declare engines.node as ${MIN_NODE_VERSION}:\n${details}`
+ );
+ }
+}
+
// --- Python release metadata: package version, runtime version, and docs changelog must agree ---
if (!pythonReleaseWorkflow.includes('run: pnpm test:release-workflow')) {
diff --git a/ts/packages/core/package.json b/ts/packages/core/package.json
index cbaded142..80e309dd2 100644
--- a/ts/packages/core/package.json
+++ b/ts/packages/core/package.json
@@ -1,6 +1,9 @@
{
"name": "@composio/core",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"version": "0.17.0",
"description": "",
"main": "src/index.ts",
diff --git a/ts/packages/experimental/package.json b/ts/packages/experimental/package.json
index 22bf9cb59..6d499547b 100644
--- a/ts/packages/experimental/package.json
+++ b/ts/packages/experimental/package.json
@@ -4,6 +4,9 @@
"description": "Experimental Composio integrations and helpers",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/json-schema-to-zod/package.json b/ts/packages/json-schema-to-zod/package.json
index 2990f514c..7320efba2 100644
--- a/ts/packages/json-schema-to-zod/package.json
+++ b/ts/packages/json-schema-to-zod/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/anthropic/package.json b/ts/packages/providers/anthropic/package.json
index 7add54a32..7e692fbab 100644
--- a/ts/packages/providers/anthropic/package.json
+++ b/ts/packages/providers/anthropic/package.json
@@ -4,6 +4,9 @@
"description": "Non-Agentic Provider for Anthropic in Composio SDK",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/claude-agent-sdk/package.json b/ts/packages/providers/claude-agent-sdk/package.json
index 7bf39e245..fbe226137 100644
--- a/ts/packages/providers/claude-agent-sdk/package.json
+++ b/ts/packages/providers/claude-agent-sdk/package.json
@@ -4,6 +4,9 @@
"description": "Composio provider for Claude Agent SDK",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/cloudflare/package.json b/ts/packages/providers/cloudflare/package.json
index faad7b5c4..4cc0dc405 100644
--- a/ts/packages/providers/cloudflare/package.json
+++ b/ts/packages/providers/cloudflare/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/google/package.json b/ts/packages/providers/google/package.json
index c22821aba..705aed642 100644
--- a/ts/packages/providers/google/package.json
+++ b/ts/packages/providers/google/package.json
@@ -4,6 +4,9 @@
"description": "Google GenAI Provider for Composio SDK",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/langchain/package.json b/ts/packages/providers/langchain/package.json
index 97219cf00..3708e2077 100644
--- a/ts/packages/providers/langchain/package.json
+++ b/ts/packages/providers/langchain/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "dist/index.js",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/llamaindex/package.json b/ts/packages/providers/llamaindex/package.json
index a098891bf..500e5bcfb 100644
--- a/ts/packages/providers/llamaindex/package.json
+++ b/ts/packages/providers/llamaindex/package.json
@@ -4,6 +4,9 @@
"description": "Agentic Provider for llamaindex in Composio SDK",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/mastra/package.json b/ts/packages/providers/mastra/package.json
index 08ff8571a..6eb4c90c1 100644
--- a/ts/packages/providers/mastra/package.json
+++ b/ts/packages/providers/mastra/package.json
@@ -4,6 +4,9 @@
"description": "Agentic Provider for mastra in Composio SDK",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/openai-agents/package.json b/ts/packages/providers/openai-agents/package.json
index e88760c5e..d9ccd7b44 100644
--- a/ts/packages/providers/openai-agents/package.json
+++ b/ts/packages/providers/openai-agents/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/openai/package.json b/ts/packages/providers/openai/package.json
index 75570577e..72954fe97 100644
--- a/ts/packages/providers/openai/package.json
+++ b/ts/packages/providers/openai/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/providers/vercel/package.json b/ts/packages/providers/vercel/package.json
index 1742977da..ef639b34f 100644
--- a/ts/packages/providers/vercel/package.json
+++ b/ts/packages/providers/vercel/package.json
@@ -4,6 +4,9 @@
"description": "",
"main": "src/index.ts",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"repository": {
"type": "git",
"url": "https://github.com/ComposioHQ/composio.git",
diff --git a/ts/packages/slim/package.json b/ts/packages/slim/package.json
index 0dafab04f..bf1753aa7 100644
--- a/ts/packages/slim/package.json
+++ b/ts/packages/slim/package.json
@@ -1,6 +1,9 @@
{
"name": "@composio/slim",
"type": "module",
+ "engines": {
+ "node": ">=22.22.3"
+ },
"version": "0.17.0",
"description": "Slim Composio core package without packaged source or docs",
"main": "dist/index.mjs",