hermesdesk-agent 0.1.0-alpha.5 → 0.1.0-alpha.8
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 +15 -4
- package/bin/hermesdesk.js +3 -4
- package/npm-shrinkwrap.json +1574 -1573
- package/package.json +49 -48
- package/src/agent.js +31 -13
- package/src/commands.js +87 -31
- package/src/config.js +1 -1
- package/src/policy.js +24 -33
- package/src/ui/activity.js +153 -0
- package/src/ui/approval.js +222 -0
- package/src/ui/chrome.js +193 -0
- package/src/ui/extension.js +212 -0
- package/src/ui/format.js +172 -0
- package/src/ui/interactive.js +14 -0
- package/src/ui/interrupt.js +12 -0
- package/src/ui/layout.js +73 -0
- package/src/ui/menu.js +56 -0
- package/src/ui/pi.js +5 -0
- package/src/ui/status.js +75 -0
- package/src/ui/themes/hermesdesk-dark.json +81 -0
- package/src/ui/themes/hermesdesk-light.json +81 -0
- package/src/ui/tools.js +159 -0
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/NKocur/hermesdesk-agent/actions/workflows/ci.yml)
|
|
4
4
|
|
|
5
|
-
**Windows alpha: 0.1.0-alpha.
|
|
5
|
+
**Windows alpha: 0.1.0-alpha.8.** Community client built on Pi; not affiliated with or endorsed by Earendil Works or Nous Research.
|
|
6
6
|
|
|
7
7
|
A running HermesDesk inference gateway is required. This client does not include a hosted model service, server access, or API keys.
|
|
8
8
|
|
|
@@ -18,7 +18,7 @@ hermesdesk.cmd connect
|
|
|
18
18
|
hermesdesk.cmd doctor
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
Alternatively, download and extract a Windows alpha bundle from [Releases](https://github.com/NKocur/hermesdesk-agent/releases) and run `Install Agent.cmd`. A tarball can also be installed directly with `npm.cmd install -g --ignore-scripts ./hermesdesk-agent-0.1.0-alpha.
|
|
21
|
+
Alternatively, download and extract a Windows alpha bundle from [Releases](https://github.com/NKocur/hermesdesk-agent/releases) and run `Install Agent.cmd`. A tarball can also be installed directly with `npm.cmd install -g --ignore-scripts ./hermesdesk-agent-0.1.0-alpha.8.tgz`.
|
|
22
22
|
|
|
23
23
|
There is no default server address. `connect` asks for your HTTPS model endpoint ending in `/v1`. When the server supports browser sign-in, it opens your browser: sign in to HermesDesk and approve the computer. The CLI receives a short-lived, single-use authorization code on a loopback listener and redeems it with PKCE over HTTPS, then discovers the model and saves the credentials encrypted. You do not copy passwords, API keys, or connection codes. The browser and CLI must be on the same computer. Use `--no-browser` to open the printed browser link yourself. On legacy servers without browser sign-in, the API-key setup remains available; `--manual` explicitly selects it. No server credentials are included in this package.
|
|
24
24
|
|
|
@@ -39,7 +39,15 @@ hermesdesk.cmd chat --session SESSION_ID
|
|
|
39
39
|
hermesdesk.cmd chat --read-only
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
The interactive terminal uses Pi's UI, streaming, diffs, tool displays, session history and compaction
|
|
42
|
+
The interactive terminal uses Pi's UI, streaming, diffs, tool displays, session history and compaction, with a HermesDesk presentation layer (`src/ui/`). A compact header shows the connected model and server, the safety mode and key commands; a two-line footer shows the workspace and git branch, model, thinking effort, output limit, approval mode, token totals, the last reply's speed and a context-fill bar. Tool calls appear as one line with a status mark (`●` running, `✓` done, `✗` failed or declined) and their output sits behind a quiet gutter; `ctrl+o` expands long output. Edits, writes and commands open an approval panel with a diff, file preview or highlighted command: `y` allows once, `n` or Escape denies.
|
|
43
|
+
|
|
44
|
+
Because the model runs on your own hardware, the working line says what it is waiting for: `Waiting for model · 24s · processing the prompt` before the first token (a wait of a minute or more adds that the model may still be loading), then `Thinking`, `Writing` or `Preparing edit` with an estimated tokens-per-second rate, and a note when output stalls. `/status` checks that the server answers and the model is listed (without loading it), and reports context fill, the last reply's speed and time to first token, and the session average. When a reply stops at the output limit, a notice says whether thinking used the whole allowance and which setting to change. The terminal title shows `●` while the agent works; set `HERMESDESK_BELL=on` to also ring the terminal bell when a run of 30 seconds or more finishes.
|
|
45
|
+
|
|
46
|
+
If the model issues the same tool call three times in a row, the third and later calls are refused without an approval prompt and the model is told to take a different step. The count resets with each message you send.
|
|
47
|
+
|
|
48
|
+
Colors follow the terminal background automatically, using the HermesDesk light or dark palette. Body text keeps the terminal's own foreground color, and fonts and sizes always come from the terminal. Set `HERMESDESK_THEME` to `light` or `dark` to force a palette (for terminals that do not report their background), or `terminal` to use Pi's palette derived from your terminal colors.
|
|
49
|
+
|
|
50
|
+
Escape interrupts work. `/quit` exits; `/new` starts a new conversation and `/resume` opens Pi's session selector. The first interactive startup may download Pi's `fd` helper to this client's own Pi cache. Windows Terminal is recommended. Pi's inherited help and exit hints may still mention `pi`; resume this client with `hermesdesk chat --continue` or `--session ID`.
|
|
43
51
|
|
|
44
52
|
File tools are restricted to the chosen project and reject outside links and protected paths such as `.env`, `.git`, credential files and agent configurations. Each edit and shell command asks for approval. Shell commands execute as your user and are **not OS-sandboxed**; after approval they can access anything your account can access. Direct `!` shell shortcuts are disabled so commands use the managed approval path. Project JavaScript extensions, MCP servers and packages are not automatically loaded.
|
|
45
53
|
|
|
@@ -68,9 +76,10 @@ Use these inside interactive chat. Commands run locally, consume no model tokens
|
|
|
68
76
|
/thinking-budget auto
|
|
69
77
|
/limits show
|
|
70
78
|
/limits save
|
|
79
|
+
/status
|
|
71
80
|
```
|
|
72
81
|
|
|
73
|
-
`/limits` opens a
|
|
82
|
+
`/limits` opens a settings menu for the same controls, showing each current value; `/profile` and `/think` without a value open menus that mark the active choice. Profiles are `fast` (32K, thinking off), `balanced` (64K, xhigh), and `extended` (131K, xhigh). Output counts include thinking and answer. The model can stop before the allowance is used, and Strata can reduce the thinking cap to preserve answer room. Individual controls keep your other sampler settings; profiles apply the recommended sampler values.
|
|
74
83
|
|
|
75
84
|
Changes last for the current CLI session. `/limits save` keeps generation defaults for future launches; `/limits reset` restores saved defaults. Escape cancels a menu without applying changes. Changes are blocked while the agent is working. Pi's existing `/thinking off|low|medium|high` and keyboard thinking controls now also reach Strata (`high` maps to `xhigh`). Credentials, file permissions and command approvals are unaffected.
|
|
76
85
|
|
|
@@ -105,6 +114,8 @@ Changes apply to the next launch. Context is client metadata, not a request to a
|
|
|
105
114
|
|
|
106
115
|
Windows uses its built-in `curl.exe` for model HTTP requests because the retained Cloudflare bot filter challenged Node fetch and a native Node follow-up request during testing. TLS verification stays enabled, redirects are not followed, credentials are sent through stdin rather than command-line arguments, and disconnects cancel the request. `doctor` checks the connection without loading the model. A browser challenge from zone-wide Bot Fight Mode cannot be solved by an API client; the server owner must configure API-compatible protection. Transport compatibility alone does not guarantee that every computer will be accepted. Cold Strata startup can still take minutes; the client cannot remove server warm-up costs. A Cloudflare 403 is a connection failure, not a model error.
|
|
107
116
|
|
|
117
|
+
Press **Ctrl+C** during a run to cancel generation or a running tool and return to the prompt. Pending file/command approvals are dismissed without granting permission. Cancellation does not undo completed actions. Escape also interrupts from the chat editor. When idle, Ctrl+C clears the input; pressing it twice quickly exits. Ctrl+D exits with an empty input.
|
|
118
|
+
|
|
108
119
|
## Optional private Worker gateway
|
|
109
120
|
|
|
110
121
|
The generic Worker source and deployment notes are in [worker/](worker/README.md). It requires Cloudflare Access authentication for its configured application and proxies only model discovery and chat completions to a single private VPC Service. It exposes no desktop tools, file APIs, application sessions, or arbitrary destinations. Website Bot Fight Mode can remain enabled when the agent uses a separate `workers.dev` endpoint. Workers VPC is beta; check Cloudflare's current availability, pricing and limits before adopting it.
|
package/bin/hermesdesk.js
CHANGED
|
@@ -303,11 +303,10 @@ async function main() {
|
|
|
303
303
|
if (command === "run") {
|
|
304
304
|
await runPrompt(runtime, p.join(" "), { json: !!v.json });
|
|
305
305
|
} else {
|
|
306
|
-
const {
|
|
307
|
-
"
|
|
306
|
+
const { createInteractiveMode } = await import(
|
|
307
|
+
"../src/ui/interactive.js"
|
|
308
308
|
);
|
|
309
|
-
const ui =
|
|
310
|
-
verbose: false,
|
|
309
|
+
const ui = await createInteractiveMode(runtime, {
|
|
311
310
|
initialMessage: p.length ? p.join(" ") : undefined,
|
|
312
311
|
});
|
|
313
312
|
await ui.run();
|