Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Set node to min 22 (#289)

Chirag Jain7f2b20df016e
diff --git a/.github/fern/generators.yml b/.github/fern/generators.yml
index 0732ed9b6..ff0e069f2 100644
--- a/.github/fern/generators.yml
+++ b/.github/fern/generators.yml
@@ -54,6 +54,8 @@ groups:
publishConfig:
access: public
provenance: false
+ engines:
+ node: '>=22'
allowExtraFields: true
allowCustomFetcher: true
enableInlineTypes: false
diff --git a/.nvmrc b/.nvmrc
index fc37597bc..c94711948 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-22.17.0
+22.23.2
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 765cc3a3e..0a4bd5c2a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,7 +15,7 @@ For security vulnerabilities, do **not** open a public issue — see [SECURITY.m
## Prerequisites
-- **Node.js 22.13+** (see [`.nvmrc`](.nvmrc))
+- **Node.js 22.13+** (see [`.nvmrc`](.nvmrc); required by pnpm 11.16)
- **pnpm** (version pinned via `packageManager` in [`package.json`](package.json); `corepack enable` handles it)
- **Docker** — only needed for Postgres/Redis dev infra, the smoke test, and SDK generation
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index 590f81d82..298c2c159 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -10,7 +10,7 @@ TrueForge runs in [two modes](/introduction#two-ways-to-run-it): **local mode**
<Tabs>
<Tab title="Local mode (npx)">
- Requires [Node.js](https://nodejs.org) 22.13 or newer. One command, no other infrastructure — the UI and backend run locally, and data is stored in a local SQLite file:
+ Requires [Node.js](https://nodejs.org) 22 or newer. One command, no other infrastructure — the UI and backend run locally, and data is stored in a local SQLite file:
```bash
npx @truefoundry/trueforge
diff --git a/packages/frontend/package.json b/packages/frontend/package.json
index e6ce7e3c6..ae3a3cfde 100644
--- a/packages/frontend/package.json
+++ b/packages/frontend/package.json
@@ -6,6 +6,9 @@
"license": "MIT",
"private": true,
"type": "module",
+ "engines": {
+ "node": ">=22"
+ },
"scripts": {
"sdk:build": "pnpm --filter @truefoundry/trueforge-sdk build",
"ui:build": "pnpm --filter @truefoundry/trueforge-ui build",
diff --git a/packages/harness/package.json b/packages/harness/package.json
index 4bbb6b66a..3435cd0dc 100644
--- a/packages/harness/package.json
+++ b/packages/harness/package.json
@@ -81,6 +81,9 @@
"files": [
"dist"
],
+ "engines": {
+ "node": ">=22"
+ },
"scripts": {
"build:gen": "node scripts/generate-sandbox-scripts.mjs",
"build:gen:watch": "node --watch-path=src/core/sandbox/scripts scripts/generate-sandbox-scripts.mjs",
diff --git a/packages/local-sandbox/package.json b/packages/local-sandbox/package.json
index df7d426a2..2e683c2a3 100644
--- a/packages/local-sandbox/package.json
+++ b/packages/local-sandbox/package.json
@@ -20,7 +20,7 @@
"fixtures"
],
"engines": {
- "node": ">=22.13.0"
+ "node": ">=22"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 50d7e585e..77b2a70d0 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -257,7 +257,7 @@
},
"packageManager": "[email protected]",
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22"
},
"sideEffects": false,
"license": "MIT",
diff --git a/packages/server/package.json b/packages/server/package.json
index 0a7b4a20a..f095250e6 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -23,6 +23,9 @@
"files": [
"dist"
],
+ "engines": {
+ "node": ">=22"
+ },
"scripts": {
"build:frontend-assets": "node scripts/copy-frontend.mjs",
"build:gen:watch": "node --watch-path=catalog/model-catalog.yaml --watch-path=catalog/mcp-catalog.yaml --watch-path=catalog/skill-catalog.yaml --watch-path=catalog/sandbox-catalog.yaml scripts/generate-catalog.mjs",
diff --git a/packages/trueforge-ui-sdk/example/package.json b/packages/trueforge-ui-sdk/example/package.json
index 689470e35..1bff0b7d8 100644
--- a/packages/trueforge-ui-sdk/example/package.json
+++ b/packages/trueforge-ui-sdk/example/package.json
@@ -4,6 +4,9 @@
"version": "0.0.0",
"type": "module",
"packageManager": "[email protected]",
+ "engines": {
+ "node": ">=22"
+ },
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
diff --git a/packages/trueforge-ui-sdk/package.json b/packages/trueforge-ui-sdk/package.json
index 2e5a5cb06..380df59c2 100644
--- a/packages/trueforge-ui-sdk/package.json
+++ b/packages/trueforge-ui-sdk/package.json
@@ -49,6 +49,9 @@
"NOTICE",
"CHANGELOG.md"
],
+ "engines": {
+ "node": ">=22"
+ },
"sideEffects": [
"dist/styles.css",
"src/icons/registerAgentIcons.ts"