hermesdesk-agent 0.1.0-alpha.2 → 0.1.0-alpha.4
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 +21 -7
- package/bin/hermesdesk.js +44 -5
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
- package/src/agent.js +11 -8
- package/src/browser-login.js +251 -0
- package/src/config.js +14 -5
- package/src/generation.js +48 -0
- package/src/transport.js +10 -7
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.4.** 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,11 +18,11 @@ 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.4.tgz`.
|
|
22
22
|
|
|
23
|
-
There is no default server address. `connect` asks for your HTTPS
|
|
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
|
|
|
25
|
-
For
|
|
25
|
+
For optional manual connection-code setup, select **HermesDesk Agent** in the server's **Connect coding tools** settings and create a connection. Run `hermesdesk.cmd connect --code`, then paste its private connection code at the hidden prompt. The code contains both model and Cloudflare Access credentials: treat it like a password. It is never passed as a command-line argument or saved in plain text. The server's normal key expiry and revocation still apply. The package also provides `hermesdesk-agent` as an alias for `hermesdesk`.
|
|
26
26
|
|
|
27
27
|
Manual Access setup is available with `hermesdesk connect --url https://your-worker.example/v1 --cloudflare-access`; all credentials are prompted privately. For session-only authentication, set `HERMESDESK_API_KEY`, `HERMESDESK_ACCESS_CLIENT_ID` and `HERMESDESK_ACCESS_CLIENT_SECRET`. Non-interactive setup on Windows can use `HERMESDESK_CONNECTION_CODE` with `connect --code`. The agent clears these variables before launching coding tools. Saved Access credentials are bound to the endpoint and removed by logout along with the model key.
|
|
28
28
|
|
|
@@ -59,16 +59,30 @@ One-shot operation denies writes unless `--approve-writes` is explicitly provide
|
|
|
59
59
|
|
|
60
60
|
```powershell
|
|
61
61
|
hermesdesk.cmd config
|
|
62
|
+
hermesdesk.cmd config preset extended
|
|
62
63
|
hermesdesk.cmd config set thinking true
|
|
63
|
-
hermesdesk.cmd config set
|
|
64
|
-
hermesdesk.cmd config set
|
|
64
|
+
hermesdesk.cmd config set reasoningEffort xhigh
|
|
65
|
+
hermesdesk.cmd config set thinkingBudget 16384
|
|
66
|
+
hermesdesk.cmd config set context 262144
|
|
67
|
+
hermesdesk.cmd config set maxTokens 131072
|
|
65
68
|
hermesdesk.cmd config set temperature 0.7
|
|
66
69
|
hermesdesk.cmd config set topP 0.95
|
|
67
70
|
hermesdesk.cmd config set topK 20
|
|
68
71
|
hermesdesk.cmd config set maxRequests 64
|
|
69
72
|
```
|
|
70
73
|
|
|
71
|
-
|
|
74
|
+
Profiles: `fast` uses 32K with thinking off; `balanced` uses 64K with xhigh thinking; `extended` uses 131K with xhigh thinking. Thinking profiles use Qwen's recommended sampling (temperature 1, top-p .95, top-k 20). `thinkingBudget 0` is automatic. A positive budget is a ceiling, must be below `maxTokens`, and Strata may reduce it to preserve answer space. `maxTokens` includes **thinking plus the final answer**; the model can stop earlier.
|
|
75
|
+
|
|
76
|
+
For a single launch, without changing saved settings:
|
|
77
|
+
|
|
78
|
+
```powershell
|
|
79
|
+
hermesdesk.cmd chat --profile extended
|
|
80
|
+
hermesdesk.cmd run "Review this repository" --read-only --max-tokens 65536 --thinking on --reasoning-effort medium --thinking-budget 8192
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Fresh installations default to a 131K total cap with thinking off. Existing saved values are retained: use `config preset extended` to switch to the tested thinking profile. The server must support these limits; older gateways capped output at 8K. Pi's compaction reserves space for the configured output budget.
|
|
84
|
+
|
|
85
|
+
Changes apply to the next launch. Context is client metadata, not a request to allocate more server context: keep it at or below the server's configured capacity. The updated gateway allows up to 131072 combined output tokens. Input, thinking and answer share the server context; the full 262K-thinking plus 131K-answer allowance in Qwen documentation assumes an extended 1M context. The default request budget is 64 per message and can be set from 1 to 512. Pi's in-chat settings are session-only in this version. Change the server using `hermesdesk connect --url https://your-server/v1`. HTTP is accepted only on loopback addresses.
|
|
72
86
|
|
|
73
87
|
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.
|
|
74
88
|
|
package/bin/hermesdesk.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import fs from "node:fs";
|
|
3
|
+
import { profile } from "../src/generation.js";
|
|
3
4
|
import path from "node:path";
|
|
4
5
|
import readline from "node:readline/promises";
|
|
5
6
|
import { parseArgs } from "node:util";
|
|
@@ -18,6 +19,7 @@ import {
|
|
|
18
19
|
hiddenInput,
|
|
19
20
|
logout,
|
|
20
21
|
} from "../src/credentials.js";
|
|
22
|
+
import { browserLogin } from "../src/browser-login.js";
|
|
21
23
|
import { parseConnectionCode, validateAccess } from "../src/connection.js";
|
|
22
24
|
const privateValues = new Set();
|
|
23
25
|
const protect = (value) => {
|
|
@@ -36,25 +38,35 @@ const clearAuthEnv = () => {
|
|
|
36
38
|
import { discover } from "../src/transport.js";
|
|
37
39
|
const help = `HermesDesk Agent ${VERSION} (Pi-based, Windows first)
|
|
38
40
|
|
|
39
|
-
hermesdesk connect [--code | --url https://your-server.example/v1] [--cloudflare-access]
|
|
41
|
+
hermesdesk connect [--code | --url https://your-server.example/v1] [--manual | --cloudflare-access]
|
|
40
42
|
hermesdesk doctor
|
|
41
43
|
hermesdesk chat [--cwd PATH] [--continue | --session ID] [--read-only]
|
|
42
44
|
hermesdesk run "REQUEST" [--cwd PATH] [--json] [--read-only]
|
|
43
45
|
hermesdesk sessions [--cwd PATH]
|
|
44
|
-
hermesdesk config [set KEY VALUE]
|
|
46
|
+
hermesdesk config [set KEY VALUE | preset fast|balanced|extended]
|
|
45
47
|
hermesdesk logout
|
|
46
48
|
|
|
47
49
|
Edits and shell commands ask for approval in interactive chat.
|
|
48
50
|
One-shot runs deny changes by default; --approve-writes permits workspace file edits.
|
|
49
51
|
Shell commands always require interactive approval. This is not an OS sandbox.
|
|
50
|
-
Settings: model, context, maxTokens
|
|
52
|
+
Settings: model, context, maxTokens (total thinking + answer), thinking,
|
|
53
|
+
reasoningEffort (low|medium|xhigh), thinkingBudget (0=automatic), temperature, topP, topK, maxRequests.
|
|
54
|
+
Run overrides: --profile fast|balanced|extended --max-tokens N --thinking on|off
|
|
55
|
+
--reasoning-effort low|medium|xhigh --thinking-budget N
|
|
51
56
|
`;
|
|
52
57
|
async function main() {
|
|
53
58
|
const { values: v, positionals: p } = parseArgs({
|
|
54
59
|
allowPositionals: true,
|
|
55
60
|
options: {
|
|
61
|
+
profile: { type: "string" },
|
|
62
|
+
"max-tokens": { type: "string" },
|
|
63
|
+
thinking: { type: "string" },
|
|
64
|
+
"reasoning-effort": { type: "string" },
|
|
65
|
+
"thinking-budget": { type: "string" },
|
|
56
66
|
url: { type: "string" },
|
|
57
67
|
code: { type: "boolean" },
|
|
68
|
+
manual: { type: "boolean" },
|
|
69
|
+
"no-browser": { type: "boolean" },
|
|
58
70
|
"cloudflare-access": { type: "boolean" },
|
|
59
71
|
cwd: { type: "string" },
|
|
60
72
|
session: { type: "string" },
|
|
@@ -121,6 +133,17 @@ async function main() {
|
|
|
121
133
|
throw Error(
|
|
122
134
|
"Enter your server URL, or use hermesdesk connect --url https://your-server.example/v1.",
|
|
123
135
|
);
|
|
136
|
+
if (
|
|
137
|
+
!imported &&
|
|
138
|
+
!v.manual &&
|
|
139
|
+
!v["cloudflare-access"] &&
|
|
140
|
+
!process.env.HERMESDESK_API_KEY &&
|
|
141
|
+
!process.env.HERMESDESK_ACCESS_CLIENT_ID
|
|
142
|
+
) {
|
|
143
|
+
imported = await browserLogin(config.baseUrl, {
|
|
144
|
+
launch: v["no-browser"] ? async () => {} : undefined,
|
|
145
|
+
});
|
|
146
|
+
}
|
|
124
147
|
const token = protect(
|
|
125
148
|
imported?.token ||
|
|
126
149
|
process.env.HERMESDESK_API_KEY ||
|
|
@@ -164,7 +187,9 @@ async function main() {
|
|
|
164
187
|
return;
|
|
165
188
|
}
|
|
166
189
|
if (command === "config") {
|
|
167
|
-
if (p[0] === "
|
|
190
|
+
if (p[0] === "preset") {
|
|
191
|
+
config = saveConfig({ ...config, ...profile(p[1]) }, home);
|
|
192
|
+
} else if (p[0] === "set") {
|
|
168
193
|
const key = p[1];
|
|
169
194
|
if (!Object.hasOwn(config, key) || key === "baseUrl")
|
|
170
195
|
throw Error(
|
|
@@ -173,7 +198,7 @@ async function main() {
|
|
|
173
198
|
const raw = p.slice(2).join(" ");
|
|
174
199
|
if (!raw) throw Error("Provide a setting value.");
|
|
175
200
|
let value = raw;
|
|
176
|
-
if (
|
|
201
|
+
if (!["model", "reasoningEffort"].includes(key)) {
|
|
177
202
|
try {
|
|
178
203
|
value = JSON.parse(raw);
|
|
179
204
|
} catch {
|
|
@@ -237,6 +262,20 @@ async function main() {
|
|
|
237
262
|
if (!models.includes(config.model)) process.exitCode = 1;
|
|
238
263
|
return;
|
|
239
264
|
}
|
|
265
|
+
const overrides = {};
|
|
266
|
+
if (v.profile) Object.assign(overrides, profile(v.profile));
|
|
267
|
+
if (v["max-tokens"] !== undefined)
|
|
268
|
+
overrides.maxTokens = Number(v["max-tokens"]);
|
|
269
|
+
if (v["thinking-budget"] !== undefined)
|
|
270
|
+
overrides.thinkingBudget = Number(v["thinking-budget"]);
|
|
271
|
+
if (v["reasoning-effort"] !== undefined)
|
|
272
|
+
overrides.reasoningEffort = v["reasoning-effort"];
|
|
273
|
+
if (v.thinking !== undefined) {
|
|
274
|
+
if (!["on", "off"].includes(v.thinking))
|
|
275
|
+
throw Error("Use --thinking on or --thinking off.");
|
|
276
|
+
overrides.thinking = v.thinking === "on";
|
|
277
|
+
}
|
|
278
|
+
config = validateConfig({ ...config, ...overrides });
|
|
240
279
|
const cwd = fs.realpathSync.native(v.cwd || process.cwd());
|
|
241
280
|
if (command === "chat" && (!process.stdin.isTTY || !process.stdout.isTTY))
|
|
242
281
|
throw Error(
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hermesdesk-agent",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.4",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "hermesdesk-agent",
|
|
9
|
-
"version": "0.1.0-alpha.
|
|
9
|
+
"version": "0.1.0-alpha.4",
|
|
10
10
|
"license": "MIT",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@earendil-works/pi-coding-agent": "1.5.0"
|
package/package.json
CHANGED
package/src/agent.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import fs from "node:fs";
|
|
2
|
+
import { generationPayload } from "./generation.js";
|
|
2
3
|
import path from "node:path";
|
|
3
4
|
import { projectSessionDir } from "./config.js";
|
|
4
5
|
import { searchTool } from "./search.js";
|
|
@@ -79,12 +80,7 @@ export async function createRuntime({
|
|
|
79
80
|
onPayload: async (payload, m) => {
|
|
80
81
|
const p = (await options?.onPayload?.(payload, m)) ?? payload;
|
|
81
82
|
delete p.store;
|
|
82
|
-
|
|
83
|
-
p.max_tokens = config.maxTokens;
|
|
84
|
-
p.temperature = config.temperature;
|
|
85
|
-
p.top_p = config.topP;
|
|
86
|
-
p.top_k = config.topK;
|
|
87
|
-
p.chat_template_kwargs = { enable_thinking: config.thinking };
|
|
83
|
+
Object.assign(p, generationPayload(config));
|
|
88
84
|
return p;
|
|
89
85
|
},
|
|
90
86
|
});
|
|
@@ -107,7 +103,10 @@ export async function createRuntime({
|
|
|
107
103
|
providerRetry: { maxRetries: 0, timeoutMs: 1800000 },
|
|
108
104
|
compaction: {
|
|
109
105
|
enabled: true,
|
|
110
|
-
reserveTokens: Math.min(
|
|
106
|
+
reserveTokens: Math.min(
|
|
107
|
+
config.context - 1024,
|
|
108
|
+
Math.max(config.maxTokens + 2048, 16384),
|
|
109
|
+
),
|
|
111
110
|
keepRecentTokens: Math.min(12000, Math.floor(config.context / 4)),
|
|
112
111
|
},
|
|
113
112
|
});
|
|
@@ -152,7 +151,11 @@ export async function createRuntime({
|
|
|
152
151
|
sessionManager,
|
|
153
152
|
sessionStartEvent,
|
|
154
153
|
model,
|
|
155
|
-
thinkingLevel: config.thinking
|
|
154
|
+
thinkingLevel: config.thinking
|
|
155
|
+
? config.reasoningEffort === "xhigh"
|
|
156
|
+
? "high"
|
|
157
|
+
: config.reasoningEffort
|
|
158
|
+
: "off",
|
|
156
159
|
customTools: [searchTool(target)],
|
|
157
160
|
tools: readOnly
|
|
158
161
|
? ["read", "ls", "search"]
|
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
import http from "node:http";
|
|
2
|
+
import crypto from "node:crypto";
|
|
3
|
+
import os from "node:os";
|
|
4
|
+
import { spawn } from "node:child_process";
|
|
5
|
+
import { endpoint } from "./config.js";
|
|
6
|
+
import { parseConnectionCode } from "./connection.js";
|
|
7
|
+
import { curlFetch, nativeFetch } from "./transport.js";
|
|
8
|
+
async function json(response) {
|
|
9
|
+
const reader = response.body?.getReader();
|
|
10
|
+
let text = "",
|
|
11
|
+
size = 0;
|
|
12
|
+
if (!reader) throw Error("Sign-in returned no response.");
|
|
13
|
+
for (;;) {
|
|
14
|
+
const { value, done } = await reader.read();
|
|
15
|
+
if (done) break;
|
|
16
|
+
size += value.length;
|
|
17
|
+
if (size > 16384) {
|
|
18
|
+
await reader.cancel();
|
|
19
|
+
throw Error("Invalid sign-in response.");
|
|
20
|
+
}
|
|
21
|
+
text += new TextDecoder().decode(value);
|
|
22
|
+
}
|
|
23
|
+
try {
|
|
24
|
+
return JSON.parse(text);
|
|
25
|
+
} catch {
|
|
26
|
+
throw Error("Invalid sign-in response.");
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
export function browserMetadata(baseUrl, data) {
|
|
30
|
+
const base = new URL(endpoint(baseUrl));
|
|
31
|
+
let auth, token;
|
|
32
|
+
try {
|
|
33
|
+
auth = new URL(data.authorization_url);
|
|
34
|
+
token = new URL(data.token_endpoint);
|
|
35
|
+
} catch {
|
|
36
|
+
throw Error("The server returned invalid browser sign-in settings.");
|
|
37
|
+
}
|
|
38
|
+
const local =
|
|
39
|
+
base.protocol === "http:" &&
|
|
40
|
+
["127.0.0.1", "localhost"].includes(base.hostname);
|
|
41
|
+
if (
|
|
42
|
+
data.version !== 1 ||
|
|
43
|
+
auth.username ||
|
|
44
|
+
auth.password ||
|
|
45
|
+
auth.hash ||
|
|
46
|
+
!(
|
|
47
|
+
auth.protocol === "https:" ||
|
|
48
|
+
(local && auth.protocol === "http:" && auth.hostname === "127.0.0.1")
|
|
49
|
+
) ||
|
|
50
|
+
token.origin !== base.origin ||
|
|
51
|
+
token.pathname !== "/auth/token" ||
|
|
52
|
+
token.search ||
|
|
53
|
+
token.hash ||
|
|
54
|
+
token.username ||
|
|
55
|
+
token.password
|
|
56
|
+
)
|
|
57
|
+
throw Error("The server returned unsafe browser sign-in settings.");
|
|
58
|
+
return { authorization: auth, token };
|
|
59
|
+
}
|
|
60
|
+
export async function openBrowser(url) {
|
|
61
|
+
const [command, args] =
|
|
62
|
+
process.platform === "win32"
|
|
63
|
+
? ["rundll32.exe", ["url.dll,FileProtocolHandler", url]]
|
|
64
|
+
: process.platform === "darwin"
|
|
65
|
+
? ["open", [url]]
|
|
66
|
+
: ["xdg-open", [url]];
|
|
67
|
+
await new Promise((resolve, reject) => {
|
|
68
|
+
const child = spawn(command, args, {
|
|
69
|
+
windowsHide: true,
|
|
70
|
+
stdio: "ignore",
|
|
71
|
+
detached: true,
|
|
72
|
+
});
|
|
73
|
+
child.once("error", reject);
|
|
74
|
+
child.once("spawn", () => {
|
|
75
|
+
child.unref();
|
|
76
|
+
resolve();
|
|
77
|
+
});
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
export async function browserLogin(
|
|
81
|
+
baseUrl,
|
|
82
|
+
{
|
|
83
|
+
launch = openBrowser,
|
|
84
|
+
log = console.log,
|
|
85
|
+
timeoutMs = 300000,
|
|
86
|
+
transport = process.platform === "win32" ? curlFetch : nativeFetch,
|
|
87
|
+
} = {},
|
|
88
|
+
) {
|
|
89
|
+
const base = new URL(endpoint(baseUrl));
|
|
90
|
+
const info = await transport(base.origin + "/auth/info", {
|
|
91
|
+
headers: { "User-Agent": "HermesDesk-CLI/1.0" },
|
|
92
|
+
signal: AbortSignal.timeout(20000),
|
|
93
|
+
});
|
|
94
|
+
if (info.status === 404) {
|
|
95
|
+
await info.body?.cancel();
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
if (info.status !== 200) {
|
|
99
|
+
await info.body?.cancel();
|
|
100
|
+
throw Error(
|
|
101
|
+
"Browser sign-in is unavailable at this endpoint. Check the server address or use connect --code.",
|
|
102
|
+
);
|
|
103
|
+
}
|
|
104
|
+
const metadata = browserMetadata(baseUrl, await json(info));
|
|
105
|
+
const state = crypto.randomBytes(32).toString("base64url"),
|
|
106
|
+
verifier = crypto.randomBytes(32).toString("base64url"),
|
|
107
|
+
challenge = crypto
|
|
108
|
+
.createHash("sha256")
|
|
109
|
+
.update(verifier)
|
|
110
|
+
.digest("base64url");
|
|
111
|
+
let resolveCallback,
|
|
112
|
+
rejectCallback,
|
|
113
|
+
settled = false,
|
|
114
|
+
callbackResponse;
|
|
115
|
+
const callback = new Promise((resolve, reject) => {
|
|
116
|
+
resolveCallback = resolve;
|
|
117
|
+
rejectCallback = reject;
|
|
118
|
+
});
|
|
119
|
+
const server = http.createServer((req, res) => {
|
|
120
|
+
const fail = () => {
|
|
121
|
+
res.writeHead(400, {
|
|
122
|
+
"content-type": "text/plain",
|
|
123
|
+
"cache-control": "no-store",
|
|
124
|
+
connection: "close",
|
|
125
|
+
});
|
|
126
|
+
res.end("Invalid sign-in callback. Return to your terminal.");
|
|
127
|
+
};
|
|
128
|
+
if (
|
|
129
|
+
settled ||
|
|
130
|
+
req.method !== "GET" ||
|
|
131
|
+
!["127.0.0.1", "::ffff:127.0.0.1"].includes(req.socket.remoteAddress) ||
|
|
132
|
+
req.headers.host !== "127.0.0.1:" + server.address().port ||
|
|
133
|
+
req.url.length > 2048
|
|
134
|
+
)
|
|
135
|
+
return fail();
|
|
136
|
+
let u;
|
|
137
|
+
try {
|
|
138
|
+
u = new URL(req.url, "http://127.0.0.1");
|
|
139
|
+
} catch {
|
|
140
|
+
return fail();
|
|
141
|
+
}
|
|
142
|
+
const denied =
|
|
143
|
+
u.searchParams.getAll("error").length === 1 &&
|
|
144
|
+
u.searchParams.get("error") === "access_denied" &&
|
|
145
|
+
!u.searchParams.has("code");
|
|
146
|
+
const validCode =
|
|
147
|
+
!u.searchParams.has("error") &&
|
|
148
|
+
u.searchParams.getAll("code").length === 1 &&
|
|
149
|
+
/^[A-Za-z0-9_-]{43}$/.test(u.searchParams.get("code") || "");
|
|
150
|
+
if (
|
|
151
|
+
u.pathname !== "/hermesdesk/callback" ||
|
|
152
|
+
u.searchParams.getAll("state").length !== 1 ||
|
|
153
|
+
u.searchParams.get("state") !== state ||
|
|
154
|
+
[...u.searchParams.keys()].some(
|
|
155
|
+
(k) => !["state", "code", "error"].includes(k),
|
|
156
|
+
) ||
|
|
157
|
+
(!denied && !validCode)
|
|
158
|
+
)
|
|
159
|
+
return fail();
|
|
160
|
+
settled = true;
|
|
161
|
+
callbackResponse = res;
|
|
162
|
+
if (denied) rejectCallback(Error("Browser sign-in canceled."));
|
|
163
|
+
else resolveCallback(u.searchParams.get("code"));
|
|
164
|
+
});
|
|
165
|
+
server.headersTimeout = 10000;
|
|
166
|
+
server.requestTimeout = 10000;
|
|
167
|
+
await new Promise((resolve, reject) => {
|
|
168
|
+
server.once("error", reject);
|
|
169
|
+
server.listen(0, "127.0.0.1", resolve);
|
|
170
|
+
});
|
|
171
|
+
const redirectUri =
|
|
172
|
+
"http://127.0.0.1:" + server.address().port + "/hermesdesk/callback";
|
|
173
|
+
const authorization = new URL(metadata.authorization);
|
|
174
|
+
for (const [key, value] of Object.entries({
|
|
175
|
+
flow: "browser",
|
|
176
|
+
state,
|
|
177
|
+
challenge,
|
|
178
|
+
redirect_uri: redirectUri,
|
|
179
|
+
computer: os.hostname().slice(0, 80),
|
|
180
|
+
}))
|
|
181
|
+
authorization.searchParams.set(key, value);
|
|
182
|
+
const timer = setTimeout(
|
|
183
|
+
() =>
|
|
184
|
+
rejectCallback(
|
|
185
|
+
Error("Browser sign-in timed out. Run hermesdesk connect again."),
|
|
186
|
+
),
|
|
187
|
+
timeoutMs,
|
|
188
|
+
);
|
|
189
|
+
try {
|
|
190
|
+
log("Sign in and approve this computer in your browser.");
|
|
191
|
+
log(
|
|
192
|
+
"If the browser does not open, open this link on this computer:\n" +
|
|
193
|
+
authorization.href,
|
|
194
|
+
);
|
|
195
|
+
Promise.resolve()
|
|
196
|
+
.then(() => launch(authorization.href))
|
|
197
|
+
.catch(() => {
|
|
198
|
+
log("Automatic browser opening was unavailable; use the link above.");
|
|
199
|
+
});
|
|
200
|
+
const code = await callback;
|
|
201
|
+
const response = await transport(metadata.token.href, {
|
|
202
|
+
method: "POST",
|
|
203
|
+
headers: {
|
|
204
|
+
"content-type": "application/json",
|
|
205
|
+
"User-Agent": "HermesDesk-CLI/1.0",
|
|
206
|
+
},
|
|
207
|
+
body: JSON.stringify({ code, verifier, redirectUri }),
|
|
208
|
+
signal: AbortSignal.timeout(20000),
|
|
209
|
+
});
|
|
210
|
+
if (response.status !== 200) {
|
|
211
|
+
await response.body?.cancel();
|
|
212
|
+
throw Error(
|
|
213
|
+
"Browser sign-in was not accepted or expired. Run connect again.",
|
|
214
|
+
);
|
|
215
|
+
}
|
|
216
|
+
const value = parseConnectionCode((await json(response)).connectionCode);
|
|
217
|
+
if (value.baseUrl !== endpoint(baseUrl))
|
|
218
|
+
throw Error("Sign-in returned credentials for a different endpoint.");
|
|
219
|
+
callbackResponse.writeHead(200, {
|
|
220
|
+
"content-type": "text/html; charset=utf-8",
|
|
221
|
+
"cache-control": "no-store",
|
|
222
|
+
"content-security-policy": "default-src 'none'; frame-ancestors 'none'",
|
|
223
|
+
"referrer-policy": "no-referrer",
|
|
224
|
+
connection: "close",
|
|
225
|
+
});
|
|
226
|
+
callbackResponse.end(
|
|
227
|
+
"<!doctype html><title>HermesDesk connected</title><h1>Computer approved</h1><p>Return to your terminal to finish connecting. You can close this tab.</p>",
|
|
228
|
+
);
|
|
229
|
+
return value;
|
|
230
|
+
} finally {
|
|
231
|
+
clearTimeout(timer);
|
|
232
|
+
if (callbackResponse && !callbackResponse.writableEnded) {
|
|
233
|
+
callbackResponse.writeHead(400, {
|
|
234
|
+
"content-type": "text/plain",
|
|
235
|
+
connection: "close",
|
|
236
|
+
});
|
|
237
|
+
callbackResponse.end("Sign-in could not finish. Check your terminal.");
|
|
238
|
+
}
|
|
239
|
+
if (callbackResponse && !callbackResponse.writableFinished) {
|
|
240
|
+
await new Promise((resolve) => {
|
|
241
|
+
const timer = setTimeout(resolve, 1000);
|
|
242
|
+
callbackResponse.once("finish", () => {
|
|
243
|
+
clearTimeout(timer);
|
|
244
|
+
resolve();
|
|
245
|
+
});
|
|
246
|
+
});
|
|
247
|
+
}
|
|
248
|
+
server.closeAllConnections();
|
|
249
|
+
await new Promise((resolve) => server.close(resolve));
|
|
250
|
+
}
|
|
251
|
+
}
|
package/src/config.js
CHANGED
|
@@ -2,12 +2,14 @@ import fs from "node:fs";
|
|
|
2
2
|
import os from "node:os";
|
|
3
3
|
import path from "node:path";
|
|
4
4
|
import crypto from "node:crypto";
|
|
5
|
-
export const VERSION = "0.1.0-alpha.
|
|
5
|
+
export const VERSION = "0.1.0-alpha.4";
|
|
6
6
|
export const DEFAULTS = {
|
|
7
7
|
baseUrl: null,
|
|
8
8
|
model: null,
|
|
9
9
|
context: 262144,
|
|
10
|
-
maxTokens:
|
|
10
|
+
maxTokens: 131072,
|
|
11
|
+
reasoningEffort: "xhigh",
|
|
12
|
+
thinkingBudget: 0,
|
|
11
13
|
thinking: false,
|
|
12
14
|
temperature: 0.7,
|
|
13
15
|
topP: 0.95,
|
|
@@ -53,14 +55,21 @@ export function validateConfig(input) {
|
|
|
53
55
|
throw Error("Invalid model ID.");
|
|
54
56
|
for (const [k, min, max] of [
|
|
55
57
|
["context", 8192, 1048576],
|
|
56
|
-
["maxTokens", 1,
|
|
58
|
+
["maxTokens", 1, 131072],
|
|
59
|
+
["thinkingBudget", 0, 131071],
|
|
57
60
|
["topK", 0, 1000],
|
|
58
61
|
["maxRequests", 1, 512],
|
|
59
62
|
])
|
|
60
63
|
if (!Number.isInteger(c[k]) || c[k] < min || c[k] > max)
|
|
61
64
|
throw Error(k + " must be an integer from " + min + " to " + max + ".");
|
|
62
|
-
if (
|
|
63
|
-
throw Error("
|
|
65
|
+
if (!["low", "medium", "xhigh"].includes(c.reasoningEffort))
|
|
66
|
+
throw Error("reasoningEffort must be low, medium or xhigh.");
|
|
67
|
+
if (c.thinkingBudget && c.thinkingBudget >= c.maxTokens)
|
|
68
|
+
throw Error("Thinking budget must be below the total output limit.");
|
|
69
|
+
if (c.maxTokens + 1024 >= c.context)
|
|
70
|
+
throw Error(
|
|
71
|
+
"Total output must leave at least 1024 context tokens for input.",
|
|
72
|
+
);
|
|
64
73
|
if (typeof c.thinking !== "boolean")
|
|
65
74
|
throw Error("thinking must be true or false.");
|
|
66
75
|
for (const [k, max] of [
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
export const PROFILES = Object.freeze({
|
|
2
|
+
fast: {
|
|
3
|
+
maxTokens: 32768,
|
|
4
|
+
thinking: false,
|
|
5
|
+
reasoningEffort: "xhigh",
|
|
6
|
+
thinkingBudget: 0,
|
|
7
|
+
temperature: 0.7,
|
|
8
|
+
topP: 0.8,
|
|
9
|
+
topK: 20,
|
|
10
|
+
},
|
|
11
|
+
balanced: {
|
|
12
|
+
maxTokens: 65536,
|
|
13
|
+
thinking: true,
|
|
14
|
+
reasoningEffort: "xhigh",
|
|
15
|
+
thinkingBudget: 0,
|
|
16
|
+
temperature: 1,
|
|
17
|
+
topP: 0.95,
|
|
18
|
+
topK: 20,
|
|
19
|
+
},
|
|
20
|
+
extended: {
|
|
21
|
+
maxTokens: 131072,
|
|
22
|
+
thinking: true,
|
|
23
|
+
reasoningEffort: "xhigh",
|
|
24
|
+
thinkingBudget: 0,
|
|
25
|
+
temperature: 1,
|
|
26
|
+
topP: 0.95,
|
|
27
|
+
topK: 20,
|
|
28
|
+
},
|
|
29
|
+
});
|
|
30
|
+
export function profile(name) {
|
|
31
|
+
if (!Object.hasOwn(PROFILES, name))
|
|
32
|
+
throw Error("Choose profile fast, balanced or extended.");
|
|
33
|
+
return PROFILES[name];
|
|
34
|
+
}
|
|
35
|
+
export function generationPayload(config) {
|
|
36
|
+
return {
|
|
37
|
+
max_tokens: config.maxTokens,
|
|
38
|
+
temperature: config.temperature,
|
|
39
|
+
top_p: config.topP,
|
|
40
|
+
top_k: config.topK,
|
|
41
|
+
reasoning_effort: config.thinking ? config.reasoningEffort : "none",
|
|
42
|
+
reasoning_budget_tokens: config.thinking ? config.thinkingBudget : 0,
|
|
43
|
+
min_p: 0,
|
|
44
|
+
presence_penalty: config.thinking ? 0 : 1.5,
|
|
45
|
+
repetition_penalty: 1,
|
|
46
|
+
chat_template_kwargs: { enable_thinking: config.thinking },
|
|
47
|
+
};
|
|
48
|
+
}
|
package/src/transport.js
CHANGED
|
@@ -97,13 +97,16 @@ export async function discover(config, token, access) {
|
|
|
97
97
|
(r.headers.get("cf-mitigated") === "challenge" ||
|
|
98
98
|
(r.headers.get("content-type") || "").includes("text/html"));
|
|
99
99
|
const error = new Error(
|
|
100
|
-
r.status === 401
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
100
|
+
r.status === 401 &&
|
|
101
|
+
(r.headers.get("content-type") || "").includes("text/html")
|
|
102
|
+
? "Cloudflare sign-in is required. Run hermesdesk connect to sign in in your browser."
|
|
103
|
+
: r.status === 401
|
|
104
|
+
? "API key is invalid, revoked or expired."
|
|
105
|
+
: challenge
|
|
106
|
+
? "Cloudflare blocked this API request with a browser challenge. The server owner needs to adjust protection for the API endpoint."
|
|
107
|
+
: r.status === 403 || r.status === 302
|
|
108
|
+
? "Cloudflare Access denied this connection. Use a new HermesDesk connection code or check the Access credentials."
|
|
109
|
+
: "Model discovery failed (HTTP " + r.status + ").",
|
|
107
110
|
);
|
|
108
111
|
error.code = challenge ? "CLOUDFLARE_CHALLENGE" : "MODEL_DISCOVERY_FAILED";
|
|
109
112
|
error.status = r.status;
|