dsh-jev-advisor

dsh plugin --profile web add dsh-jev-advisor

dsh-jev-advisor

English | [中文](docs/README.zh.md)

A Jev second opinion for you, not the agent.

dsh-jev-advisor adds a floating advice card to DeepSeek Harness.

It helps you answer multiple-choice questions, approve or reject tool execution, and review plans.

Advice comes from TypeSafe Jev; nothing is submitted to DSH until you click Adopt.

Quick start

dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor

1. Open Settings → Jev, enter your TypeSafe API key, and save.

2. When a supported interaction appears, click Ask Jev.

3. Review the advice, then adopt it or answer through DSH's original controls.

Advice is on demand by default, including upgrades without an explicit automatic-mode setting.

To enable automatic requests, turn on Settings → Jev → Automatically get Jev advice and save.

If Require confirmation before sending is enabled, either mode first shows a local preview;

only Confirm and send calls Jev.

Features

Interaction · Advice and actions

Single-choice questions · Recommendation, option probabilities, confidence, and close-call warnings. Copy the suggested answer or adopt it.

Multi-select questions · Evaluate each option separately; options with probability ≥ 0.5 form the suggested selection.

Tool approvals · Suggest Allow once or Reject, with a risk score: 0 low, 1 moderate, 2 high. Adoption applies only to that invocation.

Plan review · Evaluate the available options and show plan readiness: 0 needs revision, 1 has minor gaps, 2 ready to execute. For a single plan-review question, “none of the above” can be adopted as Request changes when DSH provides that action.

• Trade-off perspectives (optional): compare 1–5 perspectives alongside the main recommendation

in one Jev request. Defaults use the interaction type and keyword matching: for example,

security/task progress for approvals, or completeness/minimal changes/speed for plans.

Add, remove, or enter custom perspectives on the card; set persistent defaults in Settings.

Perspective comparisons apply to single-choice questions, not multi-select options.

• Temporary preference: add a requirement such as “prioritize stability” for the current interaction.

Saving it before the first request makes no call. After evaluation starts, applying a change requests

a new evaluation, or a new local preview in confirmation mode.

• Timed questions: when supported by DSH, starting an evaluation requests a countdown pause,

and focusing the card holds the question. A Pause timer button is also available while the

host reports an active countdown. This is best-effort, not a guarantee against expiry.

• Inspect and arrange: view request/response JSON, dock left or right, collapse, or dismiss.

Docking and collapse state are saved per DSH profile.

• Local diagnostics: check versions and effective settings, then copy sanitized diagnostic facts

without calling Jev.

The card does not replace DSH's interaction UI, change the agent prompt, or enforce tool permissions.

Scores and probabilities are model judgments, not safety guarantees. You make the final decision.

Install, update and remove

Choose one installation source. Mounting the same package twice can cause duplicate loader entries

and routes.

From GitHub

dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor

The repository includes built lib/ files; no local build is needed for installation.

From npm

dsh plugin --profile <your-profile> add dsh-jev-advisor
# Pin a published release:
dsh plugin --profile <your-profile> add dsh-jev-advisor@<published-version>

npm installs a published release, which may differ from this checkout. The package version alone

does not identify a Git revision.

From a local checkout

node scripts/build.mjs
dsh plugin --profile <your-profile> add /absolute/path/to/dsh-jev-advisor

Rebuild after editing src/; local links do not build automatically.

Update or uninstall

dsh plugin --profile <your-profile> remove dsh-jev-advisor
# To reinstall/update, add it again from your chosen source:
dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor

Follow DSH's reload/restart instructions, then refresh the client. If the host bridge is outdated,

restart the host and refresh the page. After rebuilding a local bundle, use a hard reload

(Ctrl+Shift+R): the browser may retain an immutable cached bundle.

Settings

Open Settings → Jev. Save changes to apply them; leaving the key input blank preserves a stored key.

Setting · Default · Meaning

API key · Empty · TypeSafe key from <https://console.typesafe.ai/keys>. Stored in the profile's Cordis patch in plain text; never returned in settings reads.

Endpoint · https://api.typesafe.ai/v1/systemone · Evaluation endpoint.

Model · jev-latest · Jev model or alias.

Enable Jev advice · On · Master switch.

Automatically get Jev advice · Off · autoAdvise=false. Turn on to start advice automatically for supported interactions. Confirmation still applies; sending may incur API usage.

Send the recent conversation as the state · On · Include the transcript tail as context.

Require confirmation before sending · Off · Preview the outbound request locally before sending.

Mask common credentials before sending · On · Best-effort masking of common credential patterns in outbound text.

Compare trade-off perspectives by default · Off · Enable perspective comparisons; the card can override this for the current interaction.

Default trade-off perspectives · Empty · Enter 1–5 lab

…(truncated)