@hjd-hitsz/claudex-web 4.1.4 → 4.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.
Files changed (83) hide show
  1. package/.env.example +2 -0
  2. package/CHANGELOG.md +47 -0
  3. package/README.md +13 -1
  4. package/bin/auth.mjs +86 -0
  5. package/bin/claudex-web.mjs +20 -0
  6. package/bin/p2p.mjs +134 -0
  7. package/build-info.json +4 -4
  8. package/client/dist/app.js +104 -104
  9. package/client/dist/code-highlight-style.js +1 -1
  10. package/client/dist/document-editor.js +55 -54
  11. package/client/dist/file-panel.js +5 -5
  12. package/client/dist/notification-worker.js +2 -1
  13. package/client/dist/p2p-sw.js +162 -0
  14. package/client/dist/style.css +1 -1
  15. package/client/dist/terminal-panel.js +11 -11
  16. package/docs/architecture/backends.md +9 -2
  17. package/docs/architecture/behavior.md +167 -53
  18. package/docs/architecture.md +36 -337
  19. package/docs/background-tasks.md +30 -26
  20. package/docs/deployment.md +47 -6
  21. package/docs/development.md +111 -153
  22. package/docs/images/desktop-dark.png +0 -0
  23. package/docs/images/desktop-light.png +0 -0
  24. package/docs/images/mobile-sidebar.png +0 -0
  25. package/docs/images/mobile.png +0 -0
  26. package/docs/releases/v4.1.5.md +6 -0
  27. package/docs/releases/v4.2.0.md +13 -0
  28. package/docs/versioning.md +13 -3
  29. package/package.json +14 -5
  30. package/packages/background-terminal/LICENSE +674 -0
  31. package/packages/background-terminal/README.md +17 -0
  32. package/packages/background-terminal/background-jobs.mjs +457 -0
  33. package/packages/background-terminal/background-mcp.mjs +79 -0
  34. package/packages/background-terminal/background-protocol.mjs +80 -0
  35. package/packages/background-terminal/cli.mjs +14 -0
  36. package/packages/background-terminal/client.mjs +61 -0
  37. package/packages/background-terminal/codex.mjs +88 -0
  38. package/packages/background-terminal/delivery.mjs +192 -0
  39. package/packages/background-terminal/log.mjs +25 -0
  40. package/packages/background-terminal/native-watches.mjs +160 -0
  41. package/packages/background-terminal/package.json +15 -0
  42. package/packages/background-terminal/service.mjs +126 -0
  43. package/packages/translation-engine/package.json +1 -1
  44. package/server/src/application.mjs +82 -10
  45. package/server/src/auth-http.mjs +187 -0
  46. package/server/src/auth-login.mjs +144 -0
  47. package/server/src/auth-totp.mjs +233 -0
  48. package/server/src/auth.mjs +169 -220
  49. package/server/src/backends/claude/background-tasks.mjs +88 -35
  50. package/server/src/backends/claude/messages.mjs +1 -1
  51. package/server/src/backends/claude/worker-client.mjs +47 -35
  52. package/server/src/backends/claude/worker-lines.mjs +17 -0
  53. package/server/src/backends/claude/worker-server.mjs +49 -69
  54. package/server/src/backends/codex/adapter.mjs +46 -5
  55. package/server/src/backends/codex/background-service.mjs +85 -0
  56. package/server/src/backends/codex/background-task-views.mjs +87 -0
  57. package/server/src/backends/codex/background-terminals.mjs +91 -0
  58. package/server/src/backends/codex/events.mjs +11 -0
  59. package/server/src/backends/codex/methods.mjs +1 -0
  60. package/server/src/backends/codex/native-background-handoff.mjs +72 -0
  61. package/server/src/backends/codex/requests.mjs +51 -38
  62. package/server/src/backends/codex/subscriptions.mjs +34 -4
  63. package/server/src/backends/configuration.mjs +8 -0
  64. package/server/src/backends/manager.mjs +35 -33
  65. package/server/src/backends/storage.mjs +3 -14
  66. package/server/src/config.mjs +13 -0
  67. package/server/src/http/business.mjs +21 -0
  68. package/server/src/http/router.mjs +12 -25
  69. package/server/src/p2p/http.mjs +136 -0
  70. package/server/src/p2p/peers.mjs +132 -0
  71. package/server/src/p2p/service.mjs +229 -0
  72. package/server/src/p2p/storage.mjs +45 -0
  73. package/server/src/p2p/tunnel.mjs +95 -0
  74. package/server/src/p2p-http.mjs +149 -0
  75. package/server/src/p2p-peer.mjs +135 -0
  76. package/server/src/private-file.mjs +14 -0
  77. package/server/src/summary-translation.mjs +1 -1
  78. package/server/src/thread-folders.mjs +3 -13
  79. package/server/src/translation-service.mjs +3 -8
  80. package/server/src/workspace/file-search.mjs +244 -0
  81. package/server/src/workspace/service.mjs +17 -3
  82. package/shared/codex-preferences.mjs +9 -0
  83. package/shared/p2p-wire.mjs +157 -0
@@ -4,9 +4,22 @@ import { createTranslationService } from "./translation-service.mjs";
4
4
  import https from "node:https";
5
5
  import { WebSocketServer } from "ws";
6
6
  import { createHttpHandler } from "./http/router.mjs";
7
+ import { createBusinessHttpHandler } from "./http/business.mjs";
7
8
  import { createBackendManager } from "./backends/manager.mjs";
8
9
  import { sendRpcText } from "./rpc-transport.mjs";
9
- export function createWebApplication({ config, tls, authentication, version }) {
10
+ import {
11
+ createP2pService,
12
+ createP2pManagementHandler,
13
+ } from "./p2p/service.mjs";
14
+ import { createPeerClient } from "./p2p-peer.mjs";
15
+
16
+ export function createWebApplication({
17
+ config,
18
+ tls,
19
+ authentication,
20
+ version,
21
+ runP2pTunnel,
22
+ }) {
10
23
  let requestsInFlight = 0;
11
24
  const maintenance = createServiceMaintenance({
12
25
  config,
@@ -19,13 +32,24 @@ export function createWebApplication({ config, tls, authentication, version }) {
19
32
  const translation = createTranslationService(config);
20
33
  const clients = new WebSocketServer({ noServer: true });
21
34
  const monitors = new WebSocketServer({ noServer: true });
35
+ const peers = new Set();
22
36
  function send(client, message) {
23
- if (client.authSessionId && !authentication.valid(client.authSessionId))
37
+ if (
38
+ (client.authLinkId || client.authSessionId) &&
39
+ !authentication.valid(
40
+ client.authSessionId,
41
+ client.authLinkId,
42
+ client.authLocal,
43
+ )
44
+ )
24
45
  return;
25
- sendRpcText(client, JSON.stringify(message));
46
+ const text = JSON.stringify(message);
47
+ if (client.authLinkId) client.send(text);
48
+ else sendRpcText(client, text);
26
49
  }
27
50
  function broadcast(message) {
28
51
  for (const client of clients.clients) send(client, message);
52
+ for (const peer of peers) send(peer, message);
29
53
  if (
30
54
  [
31
55
  "lan/state",
@@ -39,12 +63,40 @@ export function createWebApplication({ config, tls, authentication, version }) {
39
63
  }
40
64
  const bridge = createBackendManager({ config, version, send, broadcast });
41
65
  const { state, maintenanceState, releaseUnusedThreads } = bridge;
66
+ const handleBusiness = createBusinessHttpHandler({
67
+ translation,
68
+ maintenance,
69
+ });
70
+ const p2p = createP2pService({
71
+ configDirectory: config.configDir,
72
+ assetsDirectory: config.staticDir,
73
+ runTunnel: runP2pTunnel,
74
+ revokeLink: authentication.revokeLink,
75
+ connectPeer(channel, linkId) {
76
+ const peer = createPeerClient(channel, handleBusiness, {
77
+ authentication,
78
+ linkId,
79
+ onAuthenticated(client) {
80
+ peers.add(client);
81
+ send(client, state());
82
+ },
83
+ onLogout(client) {
84
+ peers.delete(client);
85
+ bridge.releaseClient(client);
86
+ releaseUnusedThreads();
87
+ },
88
+ });
89
+ peer.once("close", () => peers.delete(peer));
90
+ connectClient(peer);
91
+ return peer.detach;
92
+ },
93
+ });
42
94
  const server = https.createServer(
43
95
  tls,
44
96
  createHttpHandler({
45
97
  config,
46
- translation,
47
- maintenance,
98
+ handleBusiness,
99
+ handleP2p: createP2pManagementHandler(p2p),
48
100
  tls,
49
101
  authentication,
50
102
  version,
@@ -66,12 +118,16 @@ export function createWebApplication({ config, tls, authentication, version }) {
66
118
  return;
67
119
  }
68
120
  const id = authentication.sessionId(request);
69
- if (!authentication.sameOrigin(request) || !authentication.valid(id)) {
121
+ const local = authentication.isDirectLocalRequest(request);
122
+ if (
123
+ !authentication.sameOrigin(request) ||
124
+ !authentication.valid(id, undefined, local)
125
+ ) {
70
126
  socket.end("HTTP/1.1 401 Unauthorized\r\nConnection: close\r\n\r\n");
71
127
  return;
72
128
  }
73
129
  clients.handleUpgrade(request, socket, head, (client) => {
74
- authentication.attach(client, id);
130
+ authentication.attach(client, id, undefined, local);
75
131
  clients.emit("connection", client);
76
132
  });
77
133
  });
@@ -84,20 +140,33 @@ export function createWebApplication({ config, tls, authentication, version }) {
84
140
  client.on("error", (error) =>
85
141
  console.error("Browser connection:", error.message),
86
142
  );
143
+ connectClient(client);
144
+ });
145
+
146
+ function connectClient(client) {
87
147
  client.on("close", () => {
88
148
  bridge.releaseClient(client);
89
149
  releaseUnusedThreads();
90
150
  });
91
- send(client, state());
151
+ if (!client.authLinkId) send(client, state());
92
152
 
93
153
  client.on("message", (bytes) => {
94
- if (!authentication.valid(client.authSessionId)) return;
154
+ if (
155
+ !authentication.valid(
156
+ client.authSessionId,
157
+ client.authLinkId,
158
+ client.authLocal,
159
+ )
160
+ )
161
+ return;
95
162
  let message;
96
163
  try {
97
164
  message = JSON.parse(bytes.toString());
98
165
  } catch {
99
166
  return;
100
167
  }
168
+ if (!message || typeof message !== "object" || Array.isArray(message))
169
+ return;
101
170
  if (maintenance.switching) {
102
171
  send(client, {
103
172
  id: message.id,
@@ -121,7 +190,7 @@ export function createWebApplication({ config, tls, authentication, version }) {
121
190
  }),
122
191
  );
123
192
  });
124
- });
193
+ }
125
194
  const heartbeat = setInterval(() => {
126
195
  for (const client of clients.clients) {
127
196
  if (!client.alive) client.terminate();
@@ -141,6 +210,7 @@ export function createWebApplication({ config, tls, authentication, version }) {
141
210
  async start() {
142
211
  maintenance.initialize();
143
212
  await translation.initialize();
213
+ await p2p.start();
144
214
  await new Promise((resolve, reject) => {
145
215
  server.once("error", reject);
146
216
  server.listen(config.port, config.host, () => {
@@ -153,6 +223,7 @@ export function createWebApplication({ config, tls, authentication, version }) {
153
223
  async close() {
154
224
  clearInterval(heartbeat);
155
225
  maintenance.close();
226
+ await p2p.close();
156
227
  await translation.close();
157
228
  await bridge.close();
158
229
  for (const client of [...clients.clients, ...monitors.clients])
@@ -163,6 +234,7 @@ export function createWebApplication({ config, tls, authentication, version }) {
163
234
  await new Promise((resolve, reject) =>
164
235
  server.close((error) => (error ? reject(error) : resolve())),
165
236
  );
237
+ authentication.close();
166
238
  },
167
239
  };
168
240
  }
@@ -0,0 +1,187 @@
1
+ import { isIP } from "node:net";
2
+
3
+ export const sessionCookieName = "__Host-claudex-web-session";
4
+ const pendingCookieName = "__Host-claudex-web-login";
5
+ const cookie = (name, value, seconds) =>
6
+ `${name}=${value}; Path=/; HttpOnly; Secure; SameSite=Strict; Max-Age=${seconds}`;
7
+
8
+ function ipAddress(value) {
9
+ const address = value
10
+ ?.replace(/^\[|\]$/g, "")
11
+ .replace(/^::ffff:(?=\d+\.)/i, "");
12
+ if (isIP(address) === 4) return address;
13
+ if (isIP(address) === 6 && !address.includes("%"))
14
+ return new URL(`https://[${address}]`).hostname.slice(1, -1);
15
+ }
16
+
17
+ export function isDirectLocalRequest({ socket, headers }) {
18
+ const source = ipAddress(socket.remoteAddress);
19
+ if (!socket.encrypted || !source || source !== ipAddress(socket.localAddress))
20
+ return false;
21
+ if (
22
+ Object.keys(headers).some(
23
+ (name) =>
24
+ name === "forwarded" ||
25
+ name === "via" ||
26
+ name === "x-real-ip" ||
27
+ name === "cf-connecting-ip" ||
28
+ name === "true-client-ip" ||
29
+ name.startsWith("x-forwarded-"),
30
+ )
31
+ )
32
+ return false;
33
+ const authority = /^(\[[\da-f:.]+\]|[\w.-]+)(?::(\d+))?$/i.exec(
34
+ headers.host || "",
35
+ );
36
+ if (!authority || Number(authority[2] || 443) !== socket.localPort)
37
+ return false;
38
+ const host = authority[1].toLowerCase();
39
+ if (socket.servername && socket.servername.toLowerCase() !== host)
40
+ return false;
41
+ return host === "localhost"
42
+ ? source === "127.0.0.1" || source === "::1"
43
+ : ipAddress(host) === source;
44
+ }
45
+
46
+ export function requestToken(request, name, fallback = name) {
47
+ const entries = (request.headers.cookie || "")
48
+ .split(";")
49
+ .map((value) => value.trim());
50
+ const key = entries.some((entry) => entry.startsWith(name + "="))
51
+ ? name
52
+ : fallback;
53
+ const matches = entries.filter((entry) => entry.startsWith(key + "="));
54
+ if (matches.length === 1) return matches[0].slice(key.length + 1);
55
+ }
56
+
57
+ export function json(response, status, body, headers = {}) {
58
+ response.writeHead(status, {
59
+ "Content-Type": "application/json",
60
+ "Cache-Control": "no-store",
61
+ ...headers,
62
+ });
63
+ response.end(JSON.stringify(body));
64
+ }
65
+ async function credentials(request) {
66
+ if (!/^application\/json(?:;|$)/i.test(request.headers["content-type"] || ""))
67
+ throw new Error("请使用 JSON 提交登录信息。", { cause: 415 });
68
+ let size = 0;
69
+ const chunks = [];
70
+ for await (const chunk of request.iterator({ destroyOnReturn: false })) {
71
+ size += chunk.length;
72
+ if (size > 8192) throw new Error("登录信息过长。", { cause: 413 });
73
+ chunks.push(chunk);
74
+ }
75
+ try {
76
+ return JSON.parse(Buffer.concat(chunks).toString("utf8"));
77
+ } catch {
78
+ throw new Error("登录信息格式错误。", { cause: 400 });
79
+ }
80
+ }
81
+ export function createAuthHttpHandler({
82
+ loginFlow,
83
+ sessionId,
84
+ sameOrigin,
85
+ valid,
86
+ describe,
87
+ logout,
88
+ sessionDays,
89
+ }) {
90
+ return async function handle(request, response, route) {
91
+ if (!route.startsWith("/api/auth/")) return false;
92
+ const pendingToken = requestToken(request, pendingCookieName);
93
+ const clearPending = cookie(pendingCookieName, "", 0);
94
+ try {
95
+ const id = sessionId(request);
96
+ const local = isDirectLocalRequest(request);
97
+ if (route === "/api/auth/session" && request.method === "GET") {
98
+ const session = valid(id, undefined, local);
99
+ json(
100
+ response,
101
+ 200,
102
+ session
103
+ ? describe(session)
104
+ : (loginFlow.pending(pendingToken) ?? {
105
+ authenticated: false,
106
+ }),
107
+ );
108
+ return true;
109
+ }
110
+ if (
111
+ !["/api/auth/login", "/api/auth/totp", "/api/auth/logout"].includes(
112
+ route,
113
+ ) ||
114
+ request.method !== "POST"
115
+ ) {
116
+ json(response, 405, { error: "不支持此登录操作。" });
117
+ return true;
118
+ }
119
+ if (
120
+ !sameOrigin(request) ||
121
+ request.headers["x-claudex-web-request"] !== "1"
122
+ ) {
123
+ json(response, 403, { error: "请求来源不匹配,请重新打开本站。" });
124
+ return true;
125
+ }
126
+ if (route === "/api/auth/logout") {
127
+ loginFlow.cancel(pendingToken);
128
+ await logout(id, undefined, local);
129
+ json(
130
+ response,
131
+ 200,
132
+ { authenticated: false },
133
+ {
134
+ "Set-Cookie": [cookie(sessionCookieName, "", 0), clearPending],
135
+ },
136
+ );
137
+ return true;
138
+ }
139
+ const options = {
140
+ previousId: id,
141
+ pendingToken,
142
+ local: local && request.headers["sec-fetch-site"] === "same-origin",
143
+ };
144
+ const address = request.socket.remoteAddress;
145
+ const result =
146
+ route === "/api/auth/login"
147
+ ? await loginFlow.login(() => credentials(request), address, options)
148
+ : await loginFlow.verify(
149
+ await credentials(request),
150
+ address,
151
+ options,
152
+ );
153
+ json(response, 200, result.session, {
154
+ "Set-Cookie": result.pendingToken
155
+ ? cookie(
156
+ pendingCookieName,
157
+ result.pendingToken,
158
+ loginFlow.challengeSeconds,
159
+ )
160
+ : [
161
+ cookie(sessionCookieName, result.token, sessionDays * 86400),
162
+ clearPending,
163
+ ],
164
+ });
165
+ } catch (error) {
166
+ request.resume();
167
+ if (!response.headersSent && !response.destroyed) {
168
+ const status = typeof error.cause === "number" ? error.cause : 503;
169
+ json(
170
+ response,
171
+ status,
172
+ {
173
+ error:
174
+ typeof error.cause === "number"
175
+ ? error.message
176
+ : "登录暂不可用,请稍后重试或联系管理员。",
177
+ },
178
+ {
179
+ ...(status === 429 && { "Retry-After": "900" }),
180
+ ...(status === 410 && { "Set-Cookie": clearPending }),
181
+ },
182
+ );
183
+ }
184
+ }
185
+ return true;
186
+ };
187
+ }
@@ -0,0 +1,144 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { authenticateSystemUser } from "./system-auth.mjs";
3
+
4
+ const challengeSeconds = 600;
5
+ const expiredMessage = "本次验证已结束,请重新输入系统密码。";
6
+ export const localSessionBinding = "local";
7
+
8
+ export function createLoginFlow({ config, username, totp, issueSession }) {
9
+ const challenges = new Map();
10
+ const attempts = new Map();
11
+ let active = 0;
12
+ let globalAttempts = [];
13
+
14
+ function limit(address) {
15
+ const now = Date.now();
16
+ for (const [ip, record] of attempts)
17
+ if (record.until <= now) attempts.delete(ip);
18
+ globalAttempts = globalAttempts.filter((time) => time > now - 60000);
19
+ const record = attempts.get(address) || {
20
+ count: 0,
21
+ until: now + 15 * 60000,
22
+ };
23
+ if (
24
+ active >= 2 ||
25
+ record.count >= 10 ||
26
+ globalAttempts.length >= 30 ||
27
+ attempts.size >= 1024
28
+ )
29
+ throw new Error("登录尝试过于频繁,请稍后重试。", { cause: 429 });
30
+ record.count++;
31
+ attempts.set(address, record);
32
+ globalAttempts.push(now);
33
+ }
34
+
35
+ function find(token, scope) {
36
+ const challenge = challenges.get(token);
37
+ if (challenge?.expiresAt <= Date.now()) challenges.delete(token);
38
+ else if (challenge?.scope === scope) return challenge;
39
+ }
40
+
41
+ function cancel(token, scope) {
42
+ if (find(token, scope)) challenges.delete(token);
43
+ }
44
+
45
+ function describe(challenge) {
46
+ const { status, totpName } = totp.state();
47
+ return {
48
+ authenticated: false,
49
+ requiresTotp: true,
50
+ expiresAt: challenge.expiresAt,
51
+ totpStatus: status,
52
+ ...(totpName && { totpName }),
53
+ };
54
+ }
55
+
56
+ function start(scope) {
57
+ const now = Date.now();
58
+ for (const [token, challenge] of challenges)
59
+ if (challenge.expiresAt <= now) challenges.delete(token);
60
+ if (challenges.size >= 128)
61
+ throw new Error("待验证的登录过多,请稍后重试。", { cause: 429 });
62
+ const token = randomBytes(32).toString("base64url");
63
+ const challenge = {
64
+ scope,
65
+ expiresAt: now + challengeSeconds * 1000,
66
+ failures: 0,
67
+ };
68
+ challenges.set(token, challenge);
69
+ return { pendingToken: token, session: describe(challenge) };
70
+ }
71
+
72
+ return {
73
+ challengeSeconds,
74
+ cancel,
75
+ pending(token, scope) {
76
+ const challenge = find(token, scope);
77
+ if (!challenge || totp.state().status === "disabled") return;
78
+ return describe(challenge);
79
+ },
80
+ async login(
81
+ readInput,
82
+ attemptKey,
83
+ { scope, pendingToken, ...options } = {},
84
+ ) {
85
+ limit(attemptKey);
86
+ cancel(pendingToken, scope);
87
+ active++;
88
+ try {
89
+ const { username: submitted, password } = (await readInput()) || {};
90
+ if (
91
+ typeof submitted !== "string" ||
92
+ typeof password !== "string" ||
93
+ !submitted ||
94
+ !password ||
95
+ submitted.length > 256 ||
96
+ password.length > 1024 ||
97
+ /\0/.test(submitted + password)
98
+ )
99
+ throw new Error("请输入有效的系统用户名和密码。", { cause: 400 });
100
+ if (
101
+ submitted !== username ||
102
+ !(await authenticateSystemUser(submitted, password, config))
103
+ )
104
+ throw new Error(
105
+ "用户名或密码错误,或系统账户不可用。请使用运行服务的系统账户。",
106
+ { cause: 401 },
107
+ );
108
+ options.signal?.throwIfAborted();
109
+ if (options.local)
110
+ return await issueSession({
111
+ ...options,
112
+ binding: localSessionBinding,
113
+ });
114
+ const mode = totp.state();
115
+ if (mode.status !== "disabled") return start(scope);
116
+ return await issueSession({ ...options, binding: mode.binding });
117
+ } finally {
118
+ active--;
119
+ }
120
+ },
121
+ async verify(input, attemptKey, { scope, pendingToken, ...options }) {
122
+ const challenge = find(pendingToken, scope);
123
+ if (!challenge) throw new Error(expiredMessage, { cause: 410 });
124
+ if (typeof input?.code !== "string" || !/^\d{6}$/.test(input.code))
125
+ throw new Error("请输入验证器中的 6 位动态码。", { cause: 400 });
126
+ limit(`totp:${attemptKey}`);
127
+ options.signal?.throwIfAborted();
128
+ const { status: result, binding } = totp.verify(input.code, input.name);
129
+ if (result === "unconfigured")
130
+ throw new Error("请先按下方步骤绑定验证器。", { cause: 409 });
131
+ if (result === "invalid" && ++challenge.failures < 5)
132
+ throw new Error(
133
+ totp.state().totpName
134
+ ? "验证器名称或动态码有误,请核对名称并输入当前动态码。"
135
+ : "动态码错误、已使用或已过期,请输入验证器中的新码。",
136
+ { cause: 401 },
137
+ );
138
+ challenges.delete(pendingToken);
139
+ if (result !== "verified")
140
+ throw new Error(expiredMessage, { cause: 410 });
141
+ return issueSession({ ...options, binding });
142
+ },
143
+ };
144
+ }