@whalent/agent 0.3.82 → 0.3.87
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 +39 -4
- package/dist/core.cjs +7 -7
- package/dist/index.cjs +1 -1
- package/package.json +6 -4
- package/scripts/preinstall-check.cjs +3 -3
package/README.md
CHANGED
|
@@ -12,15 +12,50 @@ Protocol reference:
|
|
|
12
12
|
npm install -g @whalent/agent
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
Requires Node.js 20
|
|
16
|
-
native `node-pty` / `better-sqlite3` builds that need newer C++ compilers:
|
|
15
|
+
Requires Node.js 20 or newer:
|
|
17
16
|
|
|
18
17
|
```bash
|
|
19
|
-
nvm install 20
|
|
20
|
-
nvm use 20
|
|
21
18
|
npm install -g @whalent/agent --prefer-online --registry=https://registry.npmjs.org
|
|
22
19
|
```
|
|
23
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` fallback builds that need newer C++
|
|
23
|
+
compilers when prebuilt binaries are unavailable.
|
|
24
|
+
|
|
25
|
+
`better-sqlite3` is optional. When its prebuilt binary is unavailable and local
|
|
26
|
+
compilation fails, npm may print warnings, but the agent can still install and
|
|
27
|
+
falls back to Codex `history.jsonl` where available.
|
|
28
|
+
|
|
29
|
+
Codex SQLite history reads can use the Whalent sqlite helper when installed.
|
|
30
|
+
The helper is a small Go binary cached under `~/.whalent-agent/helpers/sqlite`;
|
|
31
|
+
if it is missing or cannot run, the agent falls back to optional
|
|
32
|
+
`better-sqlite3`, then to `history.jsonl`. Set
|
|
33
|
+
`WHALENT_SQLITE_HELPER_BASE_URL` to a release/CDN directory containing
|
|
34
|
+
`sqlite-helper-0.1.1-manifest.json`, or set `WHALENT_SQLITE_HELPER_MANIFEST_URL`
|
|
35
|
+
directly.
|
|
36
|
+
|
|
37
|
+
By default the daemon asks Platform's release API whether `sqlite-helper` has a
|
|
38
|
+
newer published version, then downloads the returned manifest. Helper releases
|
|
39
|
+
are independent from daemon/npm releases and are tagged as
|
|
40
|
+
`sqlite-helper-vX.Y.Z`.
|
|
41
|
+
|
|
42
|
+
### Pin `better-sqlite3` to v11
|
|
43
|
+
|
|
44
|
+
`@whalent/agent` uses optional `better-sqlite3@12` by default so Node.js
|
|
45
|
+
20/22/24 are all in the supported range. If a specific host needs the older v11
|
|
46
|
+
native package, you can replace it after the global install:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
ROOT="$(npm root -g)"
|
|
50
|
+
for pkg in "$ROOT/@whalent/agent" "$ROOT/@whalent/agent-core"; do
|
|
51
|
+
[ -d "$pkg" ] && (cd "$pkg" && npm install better-sqlite3@11 --save-exact --registry=https://registry.npmjs.org)
|
|
52
|
+
done
|
|
53
|
+
whalent --version
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Reapply this after upgrading `@whalent/agent`, because npm upgrades recreate the
|
|
57
|
+
installed package directories.
|
|
58
|
+
|
|
24
59
|
## Start Daemon
|
|
25
60
|
|
|
26
61
|
```bash
|