@whalent/agent 0.3.76 → 0.3.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,7 +12,32 @@ Protocol reference:
12
12
  npm install -g @whalent/agent
13
13
  ```
14
14
 
15
- Requires Node.js >= 18 and C++ build tools for `node-pty` (`build-essential` on Linux).
15
+ Requires Node.js 20 or newer:
16
+
17
+ ```bash
18
+ npm install -g @whalent/agent --prefer-online --registry=https://registry.npmjs.org
19
+ ```
20
+
21
+ Node.js 20 LTS is still the safest choice on older Linux hosts. Newer Node.js
22
+ releases can force native `node-pty` / `better-sqlite3` fallback builds that need
23
+ newer C++ compilers when prebuilt binaries are unavailable.
24
+
25
+ ### Pin `better-sqlite3` to v11
26
+
27
+ `@whalent/agent` uses `better-sqlite3@12` by default so Node.js 20/22/24 are all
28
+ in the supported range. If a specific host needs the older v11 native package,
29
+ you can replace it after the global install:
30
+
31
+ ```bash
32
+ ROOT="$(npm root -g)"
33
+ for pkg in "$ROOT/@whalent/agent" "$ROOT/@whalent/agent-core"; do
34
+ [ -d "$pkg" ] && (cd "$pkg" && npm install better-sqlite3@11 --save-exact --registry=https://registry.npmjs.org)
35
+ done
36
+ whalent --version
37
+ ```
38
+
39
+ Reapply this after upgrading `@whalent/agent`, because npm upgrades recreate the
40
+ installed package directories.
16
41
 
17
42
  ## Start Daemon
18
43