57 lines
3.5 KiB
Markdown
57 lines
3.5 KiB
Markdown
# omp-advisor
|
|
|
|
[oh-my-pi](https://github.com/can1357/oh-my-pi)'s **advisor** for the DeepSeek Harness (DSH). A second model reads every step the main agent takes and adds notes inline: a quiet aside, a concern, or a hard blocker. It runs on its own context and can use its own model, so it catches what the main agent misses while focused on the task.
|
|
|
|
## How it works
|
|
|
|
- **When it reviews:** after each completed step (the agent's message, tool calls and tool results). It gets a compact digest of the conversation: the task at the head, the latest steps at the tail, and long tool output clipped. The digest also lists the advice it already gave, so it doesn't repeat itself.
|
|
- **What it answers:** `{"verdict": "ok" | "note" | "concern" | "blocker", "message": "…"}`. `ok` is the common case, and nothing is shown.
|
|
- **How advice reaches the agent:**
|
|
- **note / concern** is appended to the agent's next request as a system reminder.
|
|
- **blocker** gets the same reminder, marked *stop and address this*. If it arrives as the agent tries to end its turn, the advisor **steers** the agent into one more step to deal with it.
|
|
- **Cost to the main loop:** reviews run in the background and add no latency, unless you set `blocking: true`.
|
|
- **Subagents:** skipped by default (`skipSubagents`).
|
|
|
|
Blockers are for real damage or clear wrong turns: destructive commands, secret leaks, pushing broken code, ignoring explicit instructions, going in circles. Concerns cover likely bugs, wrong assumptions, unverified claims, or a much better approach.
|
|
|
|
## Picking the advisor in the composer
|
|
|
|
The plugin adds an **Advisor** control to the composer bar, next to the model picker:
|
|
- **Off**: no reviews.
|
|
- **Same model as the agent**: the default.
|
|
- **Any model from DSH's model picker**: the same provider-grouped list. **Hover** a model that has reasoning efforts to open a side menu and pick its effort; clicking the model uses its default effort. The keyboard works too (→ opens the effort menu, ← goes back, Esc closes).
|
|
|
|
The trigger shows the current choice, e.g. `Claude Haiku · Low` or `Advisor off`. The choice is saved on the host (`<profile>/omp-advisor.json`, through `GET`/`POST /omp-advisor/settings`). It applies from the advisor's next review, with no restart, and it overrides `enabled`, `provider`, `model` and `reasoningEffort` from the config below. Picking an advisor never changes the agent's own model.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
dsh plugin --profile web add git+https://git.rizzy.dev/DSH-Plugins/omp-advisor.git
|
|
```
|
|
|
|
Or in the Web UI, go to **Settings → Plugins → Install**. For development, use `link:` to a clone. Restart DSH afterwards; new sessions are advised automatically.
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
- id: omp-advisor
|
|
config:
|
|
enabled: true
|
|
provider: '' # advisor model route; empty = same as the agent
|
|
model: '' # e.g. provider: omni, model: claude-haiku-4-5 for a cheap fast reviewer
|
|
reasoningEffort: '' # optional effort for the advisor model
|
|
minLevel: note # lowest verdict delivered: note | concern | blocker
|
|
everyNSteps: 1 # review every Nth step
|
|
blocking: false # true = wait for each review before the next request
|
|
maxDigestChars: 24000
|
|
maxToolResultChars: 1500
|
|
timeoutMs: 60000
|
|
skipSubagents: true
|
|
```
|
|
|
|
To pause it, disable the plugin in **Settings → Plugins → OMP Advisor**.
|
|
|
|
## Tests
|
|
|
|
`npm test`: verdict parsing, injection, ok-silence, blocker steering, minLevel and duplicate suppression (mocked model).
|