@juicesharp/rpiv-advisor 1.1.4 → 1.2.0
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 +34 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -11,16 +11,16 @@
|
|
|
11
11
|
[](https://www.npmjs.com/package/@juicesharp/rpiv-advisor)
|
|
12
12
|
[](https://opensource.org/licenses/MIT)
|
|
13
13
|
|
|
14
|
-
Let the model ask a stronger model for a second opinion before it acts. `rpiv-advisor` adds the `advisor` tool and `/advisor` slash command to [Pi Agent](https://github.com/badlogic/pi-mono)
|
|
14
|
+
Let the model ask a stronger model for a second opinion before it acts. `rpiv-advisor` adds the `advisor` tool and `/advisor` slash command to [Pi Agent](https://github.com/badlogic/pi-mono) - the working model can hand the full conversation to a reviewer (e.g. Opus) and resume with its plan, correction, or stop signal.
|
|
15
15
|
|
|
16
16
|
|
|
17
17
|
|
|
18
18
|
## Features
|
|
19
19
|
|
|
20
|
-
- **Reviewer model selector**
|
|
21
|
-
- **Persisted across sessions**
|
|
22
|
-
- **Off by default**
|
|
23
|
-
- **Zero-parameter handoff**
|
|
20
|
+
- **Reviewer model selector** - `/advisor` opens a picker over any model in Pi's registry, plus a reasoning-effort picker for reasoning-capable models.
|
|
21
|
+
- **Persisted across sessions** - selection saved at `~/.config/rpiv-advisor/advisor.json` (chmod 0600).
|
|
22
|
+
- **Off by default** - the `advisor` tool is excluded until you pick a model; choose "No advisor" to disable.
|
|
23
|
+
- **Zero-parameter handoff** - calling `advisor` forwards the full serialized conversation branch; no manual prompt needed.
|
|
24
24
|
|
|
25
25
|
## Install
|
|
26
26
|
|
|
@@ -32,7 +32,7 @@ Then restart your Pi session.
|
|
|
32
32
|
|
|
33
33
|
## Usage
|
|
34
34
|
|
|
35
|
-
Configure an advisor model with `/advisor`
|
|
35
|
+
Configure an advisor model with `/advisor` - the command opens a selector for
|
|
36
36
|
any model registered with Pi's model registry, plus a reasoning-effort picker
|
|
37
37
|
for reasoning-capable models. Selection persists across sessions at
|
|
38
38
|
`~/.config/rpiv-advisor/advisor.json` (chmod 0600).
|
|
@@ -41,10 +41,37 @@ The `advisor` tool is registered at load but excluded from active tools by
|
|
|
41
41
|
default; selecting a model via `/advisor` enables it. Choose "No advisor" to
|
|
42
42
|
disable.
|
|
43
43
|
|
|
44
|
-
`advisor` takes zero parameters
|
|
44
|
+
`advisor` takes zero parameters - calling it forwards the full serialized
|
|
45
45
|
conversation branch to the advisor model, which returns guidance (plan,
|
|
46
46
|
correction, or stop signal) that the executor consumes.
|
|
47
47
|
|
|
48
|
+
## Tool
|
|
49
|
+
|
|
50
|
+
- **`advisor`** - escalate the current conversation branch to the configured reviewer model. Inactive until a model is selected via `/advisor`.
|
|
51
|
+
|
|
52
|
+
### Schema
|
|
53
|
+
|
|
54
|
+
```ts
|
|
55
|
+
advisor() // zero parameters
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
The full conversation branch is auto-serialized from `ctx.sessionManager` - the LLM does not (and cannot) pass it explicitly.
|
|
59
|
+
|
|
60
|
+
Returns:
|
|
61
|
+
|
|
62
|
+
```ts
|
|
63
|
+
{
|
|
64
|
+
content: [{ type: "text", text: string }], // reviewer's guidance, or error message
|
|
65
|
+
details: {
|
|
66
|
+
advisorModel?: string, // "<provider>:<modelId>"
|
|
67
|
+
effort?: ThinkingLevel, // reasoning effort, when applicable
|
|
68
|
+
usage?: Usage, // token usage from the side-call
|
|
69
|
+
stopReason?: StopReason, // pi-ai stop reason
|
|
70
|
+
errorMessage?: string, // populated on auth/abort/error/empty paths
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
48
75
|
## License
|
|
49
76
|
|
|
50
77
|
MIT
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@juicesharp/rpiv-advisor",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "Pi extension
|
|
3
|
+
"version": "1.2.0",
|
|
4
|
+
"description": "Pi extension. A second opinion the model can request from a stronger reviewer model before it acts.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
7
7
|
"pi-extension",
|