@herbertgao/sol-pi 0.3.0 → 0.3.1
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 +3 -3
- package/THIRD_PARTY_NOTICES.md +4 -4
- package/agents-install.md +4 -4
- package/docs/compatibility.md +6 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -56,16 +56,16 @@ Read the [SoL-Pi blog](https://nvlabs.github.io/SoL-Pi/) for a deeper look at th
|
|
|
56
56
|
|
|
57
57
|
### Requirements
|
|
58
58
|
|
|
59
|
-
- Node.js
|
|
59
|
+
- Node.js 24 or newer
|
|
60
60
|
- npm
|
|
61
|
-
- `@earendil-works/pi-coding-agent` 0.
|
|
61
|
+
- `@earendil-works/pi-coding-agent` 0.85.1
|
|
62
62
|
|
|
63
63
|
### Install
|
|
64
64
|
|
|
65
65
|
Install the tested Pi release:
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
|
-
npm install --global @earendil-works/pi-coding-agent@0.
|
|
68
|
+
npm install --global @earendil-works/pi-coding-agent@0.85.1
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
Then install SoL-Pi directly from [NVlabs/SoL-Pi](https://github.com/NVlabs/SoL-Pi):
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -8,10 +8,10 @@ The following packages are supplied by the user's Pi installation and retain the
|
|
|
8
8
|
|
|
9
9
|
| Package | Development-tested version | License | Source |
|
|
10
10
|
| --- | ---: | --- | --- |
|
|
11
|
-
| `@earendil-works/pi-agent-core` | 0.
|
|
12
|
-
| `@earendil-works/pi-ai` | 0.
|
|
13
|
-
| `@earendil-works/pi-coding-agent` | 0.
|
|
14
|
-
| `@earendil-works/pi-tui` | 0.
|
|
11
|
+
| `@earendil-works/pi-agent-core` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
|
|
12
|
+
| `@earendil-works/pi-ai` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
|
|
13
|
+
| `@earendil-works/pi-coding-agent` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
|
|
14
|
+
| `@earendil-works/pi-tui` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
|
|
15
15
|
| `typebox` | 1.3.7 | MIT | <https://github.com/sinclairzx81/typebox> |
|
|
16
16
|
|
|
17
17
|
## Development-only dependencies
|
package/agents-install.md
CHANGED
|
@@ -7,7 +7,7 @@ Installation and configuration are complete only when Pi remains unmodified, the
|
|
|
7
7
|
## Rules
|
|
8
8
|
|
|
9
9
|
- Do not modify, patch, fork, or vendor upstream Pi. SoL-Pi must load as a standalone extension through Pi's public package interface.
|
|
10
|
-
- Use Node.js
|
|
10
|
+
- Use Node.js 24 or newer and the tested Pi release `@earendil-works/pi-coding-agent@0.85.1`. Treat a different Pi version as a compatibility change and rerun the full suite before using it.
|
|
11
11
|
- Do not clean, reset, switch, or overwrite unrelated repository changes.
|
|
12
12
|
- Do not print, log, commit, upload, or include any secret in a command line. Check only whether a credential is present.
|
|
13
13
|
- Keep SoL-Pi settings in `sol-pi.json`. The Evidence-Preserving Reducer provider/model route is a SoL-Pi setting; provider URLs, credentials, the main agent model, and shell behavior remain Pi settings.
|
|
@@ -35,7 +35,7 @@ node --version
|
|
|
35
35
|
npm --version
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
Require Node.js
|
|
38
|
+
Require Node.js 24 or newer. Install from the lockfile and run the source checks:
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
41
|
npm ci --ignore-scripts
|
|
@@ -54,11 +54,11 @@ Stop if any command fails. Do not hide a failure with `|| true` or replace `npm
|
|
|
54
54
|
Install the tested Pi release without changing its source:
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
npm install --global --ignore-scripts @earendil-works/pi-coding-agent@0.
|
|
57
|
+
npm install --global --ignore-scripts @earendil-works/pi-coding-agent@0.85.1
|
|
58
58
|
pi --version
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Require `pi --version` to report `0.
|
|
61
|
+
Require `pi --version` to report `0.85.1`.
|
|
62
62
|
|
|
63
63
|
For a project-local registration, run this from `target_project` and substitute the resolved absolute `sol_pi_root`:
|
|
64
64
|
|
package/docs/compatibility.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Pi Compatibility
|
|
2
2
|
|
|
3
|
-
SoL-Pi is developed and tested against `@earendil-works/pi-coding-agent` 0.
|
|
3
|
+
SoL-Pi is developed and tested against `@earendil-works/pi-coding-agent` 0.85.1. Its public API surface is also type-checked and exercised against Pi 0.81.1, the base used by the original Pi fork. The runtime range is deliberately expressed as a peer dependency because Pi owns installation and upgrade of its packages.
|
|
4
4
|
|
|
5
5
|
SoL-Pi imports only public package exports:
|
|
6
6
|
|
|
@@ -31,7 +31,7 @@ ObservationPack changes only the messages projected through the public `context`
|
|
|
31
31
|
|
|
32
32
|
The reducer handles public `tool_result` events and resolves the configured reducer provider/model through Pi's model registry before calling `ExtensionContext.modelRegistry.complete()` when available. For the Pi 0.81.1 fork, which exposes no registry `complete()` method, it resolves authentication for that reducer model through `getApiKeyAndHeaders()` and calls the shared `@earendil-works/pi-ai/compat` completion API. The reducer preserves the original result whenever the configured reducer model is unavailable or eligibility, model-call, schema, source-hash, exact-quote, size, or likely-secret checks fail.
|
|
33
33
|
|
|
34
|
-
All persistent paths use `SessionManager.getSessionDir()` and `getSessionId()`, which are present in both the fork and Pi 0.
|
|
34
|
+
All persistent paths use `SessionManager.getSessionDir()` and `getSessionId()`, which are present in both the fork and Pi 0.85.1. SoL-Pi creates no configurable storage-path surface.
|
|
35
35
|
|
|
36
36
|
The unpublished shared artifact layout is not read or migrated. Each session starts from its own `<sessionDir>/sol-pi/<sessionId>/` directory.
|
|
37
37
|
|
|
@@ -41,13 +41,13 @@ Online Context Compact uses ordinary public `context` and `before_provider_reque
|
|
|
41
41
|
|
|
42
42
|
Before selecting or executing a boundary compaction, it also checks the optional `Symbol.for("pi-subagents:manager")` registry exposed by `pi-subagents`. A running top-level subagent, or an unreadable registry, suppresses that compaction rather than risking a context rewrite during delegated work. When the registry is absent, the check is a no-op.
|
|
43
43
|
|
|
44
|
-
Pi does not expose its active retained-tail compaction setting through the public extension context. The standalone extension therefore uses the documented Pi 0.
|
|
44
|
+
Pi does not expose its active retained-tail compaction setting through the public extension context. The standalone extension therefore uses the documented Pi 0.85.1 default of 20,000 tokens for its economic estimate. Its programmatic factory accepts an explicit matching value for a non-default Pi setting.
|
|
45
45
|
|
|
46
|
-
Pi 0.
|
|
46
|
+
Pi 0.85.1's `ExtensionContext.compact()` aborts the active agent before it summarizes, and `agent_settled` fires only once a whole run has drained every turn, retry, auto-compaction, and queued continuation. A plan boundary that selects compaction therefore saves its plan and progress state, calls `ExtensionContext.abort()` to stop the run, and runs compaction from the `agent_settled` that stop produces. The handler awaits the compaction's own `onComplete`/`onError` callbacks. On success, the extension sends a hidden reminder through public `ExtensionAPI.sendMessage()` with `triggerTurn: true`, so Pi starts a new turn against the compacted context and rebuilds the plan even when the native summary omits that instruction.
|
|
47
47
|
|
|
48
48
|
A settlement barrier keeps the original `agent_settled` dispatch open until the triggered continuation settles. Print- and JSON-mode processes therefore complete the compact-and-continue sequence within the same Pi invocation; an outer driver does not need to resume the session or send `Continue working`. This continuation is armed only by a successful boundary compaction. Cancelling or exiting does not schedule one. A Pi build that never emits `agent_settled` starts no boundary compaction.
|
|
49
49
|
|
|
50
|
-
Pi 0.
|
|
50
|
+
Pi 0.85.1 does not return a promise from `ExtensionAPI.sendMessage()`. The barrier is therefore verified for standalone SoL-Pi and depends on Pi starting the requested turn synchronously. A later-loaded third-party extension that performs long asynchronous work in its own `agent_settled` handler is outside this guarantee and needs an integration test with that extension set.
|
|
51
51
|
|
|
52
52
|
Pi reports the session as idle while an extension-requested manual compaction is running. SoL-Pi cancels `session_before_tree` during that interval to prevent tree navigation from moving the active leaf underneath the compaction. Navigation works normally after the compaction callback settles.
|
|
53
53
|
|
|
@@ -57,7 +57,7 @@ The standalone entry passes `cacheWriteReadRatio` from `sol-pi.json` directly in
|
|
|
57
57
|
|
|
58
58
|
## Interactive TUI
|
|
59
59
|
|
|
60
|
-
The lightning savings treatment uses Pi 0.
|
|
60
|
+
The lightning savings treatment uses Pi 0.85.1's public `renderCall`,
|
|
61
61
|
`renderResult`, `ctx.ui.notify()`, and keyed `ctx.ui.setStatus()` APIs. It checks
|
|
62
62
|
`ctx.mode === "tui"` rather than `ctx.hasUI`, because RPC mode also reports UI
|
|
63
63
|
support. The renderer therefore changes only the interactive terminal display;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@herbertgao/sol-pi",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"description": "Token-efficient context and tool extensions for Pi, maintained from NVlabs/SoL-Pi.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
"vitest": "^4.0.18"
|
|
60
60
|
},
|
|
61
61
|
"engines": {
|
|
62
|
-
"node": ">=
|
|
62
|
+
"node": ">=24"
|
|
63
63
|
},
|
|
64
64
|
"pi": {
|
|
65
65
|
"extensions": [
|