@hjd-hitsz/claudex-web 0.0.0-stage → 4.1.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 (340) hide show
  1. package/.env.example +27 -0
  2. package/CHANGELOG.md +495 -0
  3. package/LICENSE +674 -0
  4. package/README.md +106 -2
  5. package/bin/claudex-web.mjs +129 -0
  6. package/build-info.json +8 -0
  7. package/client/dist/_baseMerge.js +1 -0
  8. package/client/dist/abnfDiagram-WEYOIA3C.js +1 -0
  9. package/client/dist/apl.js +1 -0
  10. package/client/dist/app.js +392 -0
  11. package/client/dist/apple-touch-icon.png +0 -0
  12. package/client/dist/arc.js +1 -0
  13. package/client/dist/architectureDiagram-ZHVYKT53.js +36 -0
  14. package/client/dist/asciiarmor.js +1 -0
  15. package/client/dist/asn1.js +1 -0
  16. package/client/dist/asterisk.js +1 -0
  17. package/client/dist/blockDiagram-RJAE7QA3.js +140 -0
  18. package/client/dist/brainfuck.js +1 -0
  19. package/client/dist/c4Diagram-XDPPPE54.js +38 -0
  20. package/client/dist/channel.js +1 -0
  21. package/client/dist/chunk-2E7WHVMD.js +88 -0
  22. package/client/dist/chunk-2Q5K7J3B.js +1 -0
  23. package/client/dist/chunk-4EMNKR2T.js +1 -0
  24. package/client/dist/chunk-55XCU76K.js +1 -0
  25. package/client/dist/chunk-5VM5RSS4.js +15 -0
  26. package/client/dist/chunk-JWPE2WC7.js +1 -0
  27. package/client/dist/chunk-VQ5W62QI.js +1 -0
  28. package/client/dist/chunk-XXDRQBXY.js +1 -0
  29. package/client/dist/chunk-ZCHMQSOR.js +2 -0
  30. package/client/dist/classDiagram-v2-4MYWR3UA.js +217 -0
  31. package/client/dist/clike.js +1 -0
  32. package/client/dist/clojure.js +1 -0
  33. package/client/dist/cmake.js +1 -0
  34. package/client/dist/cobol.js +1 -0
  35. package/client/dist/code-highlight-style.js +13 -0
  36. package/client/dist/coffeescript.js +1 -0
  37. package/client/dist/commonlisp.js +1 -0
  38. package/client/dist/cose-bilkent-JH36ORCC.js +1 -0
  39. package/client/dist/crystal.js +1 -0
  40. package/client/dist/css.js +1 -0
  41. package/client/dist/cynefin-EF2NZ3EQ.js +141 -0
  42. package/client/dist/cynefinDiagram-WF24UDRP.js +62 -0
  43. package/client/dist/cypher.js +1 -0
  44. package/client/dist/cytoscape.esm.js +321 -0
  45. package/client/dist/d.js +1 -0
  46. package/client/dist/dagre-NK4GIZVX.js +4 -0
  47. package/client/dist/defaultLocale.js +1 -0
  48. package/client/dist/diagram-CBK3MWTC.js +24 -0
  49. package/client/dist/diagram-I5XIIV2D.js +24 -0
  50. package/client/dist/diagram-ODIL2UCW.js +30 -0
  51. package/client/dist/diagram-PFBEJUXE.js +3 -0
  52. package/client/dist/diagram-RJA3I4VV.js +41 -0
  53. package/client/dist/diagram-TYUNFSNR.js +200 -0
  54. package/client/dist/diff.js +1 -0
  55. package/client/dist/dockerfile.js +1 -0
  56. package/client/dist/document-editor.js +1040 -0
  57. package/client/dist/dtd.js +1 -0
  58. package/client/dist/dylan.js +1 -0
  59. package/client/dist/ebnf.js +1 -0
  60. package/client/dist/ebnfDiagram-V4P3TTPT.js +1 -0
  61. package/client/dist/ecl.js +1 -0
  62. package/client/dist/eiffel.js +1 -0
  63. package/client/dist/elk-QONTBCTQ.js +27 -0
  64. package/client/dist/elm.js +1 -0
  65. package/client/dist/erDiagram-KYQIGQAA.js +99 -0
  66. package/client/dist/erlang.js +1 -0
  67. package/client/dist/factor.js +1 -0
  68. package/client/dist/favicon.ico +0 -0
  69. package/client/dist/favicon.png +0 -0
  70. package/client/dist/fcl.js +1 -0
  71. package/client/dist/file-panel.js +1 -0
  72. package/client/dist/flowDiagram-IUGLLWBU.js +213 -0
  73. package/client/dist/forth.js +1 -0
  74. package/client/dist/fortran.js +1 -0
  75. package/client/dist/ganttDiagram-R7GPNTJY.js +292 -0
  76. package/client/dist/gas.js +1 -0
  77. package/client/dist/gherkin.js +1 -0
  78. package/client/dist/gitGraphDiagram-PDYL7XHY.js +106 -0
  79. package/client/dist/graph.js +1 -0
  80. package/client/dist/groovy.js +1 -0
  81. package/client/dist/haskell.js +1 -0
  82. package/client/dist/haxe.js +1 -0
  83. package/client/dist/http.js +1 -0
  84. package/client/dist/idl.js +1 -0
  85. package/client/dist/index.html +25 -0
  86. package/client/dist/index.js +2 -0
  87. package/client/dist/index10.js +1 -0
  88. package/client/dist/index11.js +1 -0
  89. package/client/dist/index12.js +1 -0
  90. package/client/dist/index13.js +7 -0
  91. package/client/dist/index14.js +1 -0
  92. package/client/dist/index15.js +1 -0
  93. package/client/dist/index16.js +6 -0
  94. package/client/dist/index17.js +1 -0
  95. package/client/dist/index18.js +3 -0
  96. package/client/dist/index19.js +1 -0
  97. package/client/dist/index2.js +1 -0
  98. package/client/dist/index20.js +1 -0
  99. package/client/dist/index21.js +1 -0
  100. package/client/dist/index22.js +1 -0
  101. package/client/dist/index3.js +1 -0
  102. package/client/dist/index4.js +1 -0
  103. package/client/dist/index5.js +1 -0
  104. package/client/dist/index6.js +13 -0
  105. package/client/dist/index7.js +1 -0
  106. package/client/dist/index8.js +1 -0
  107. package/client/dist/index9.js +1 -0
  108. package/client/dist/infoDiagram-MVDRKAX5.js +2 -0
  109. package/client/dist/init.js +1 -0
  110. package/client/dist/isArrayLikeObject.js +1 -0
  111. package/client/dist/ishikawaDiagram-HPEHV2GE.js +70 -0
  112. package/client/dist/javascript.js +1 -0
  113. package/client/dist/journeyDiagram-BOSHW7O7.js +139 -0
  114. package/client/dist/julia.js +1 -0
  115. package/client/dist/kanban-definition-FNSA4HC5.js +89 -0
  116. package/client/dist/katex.js +257 -0
  117. package/client/dist/linear.js +1 -0
  118. package/client/dist/livescript.js +1 -0
  119. package/client/dist/lua.js +1 -0
  120. package/client/dist/mathematica.js +1 -0
  121. package/client/dist/mbox.js +1 -0
  122. package/client/dist/mermaid.core.js +310 -0
  123. package/client/dist/mindmap-definition-6OY57UG3.js +98 -0
  124. package/client/dist/mirc.js +1 -0
  125. package/client/dist/mllike.js +1 -0
  126. package/client/dist/modelica.js +1 -0
  127. package/client/dist/mscgen.js +1 -0
  128. package/client/dist/mumps.js +1 -0
  129. package/client/dist/nginx.js +1 -0
  130. package/client/dist/notification-worker.js +45 -0
  131. package/client/dist/nsis.js +1 -0
  132. package/client/dist/ntriples.js +1 -0
  133. package/client/dist/octave.js +1 -0
  134. package/client/dist/ordinal.js +1 -0
  135. package/client/dist/oz.js +1 -0
  136. package/client/dist/pascal.js +1 -0
  137. package/client/dist/pegDiagram-ECIUJNBX.js +1 -0
  138. package/client/dist/perl.js +1 -0
  139. package/client/dist/pieDiagram-GNMPY74T.js +39 -0
  140. package/client/dist/pig.js +1 -0
  141. package/client/dist/powershell.js +1 -0
  142. package/client/dist/properties.js +1 -0
  143. package/client/dist/protobuf.js +1 -0
  144. package/client/dist/pug.js +1 -0
  145. package/client/dist/puppet.js +1 -0
  146. package/client/dist/purify.es.js +3 -0
  147. package/client/dist/python.js +1 -0
  148. package/client/dist/q.js +1 -0
  149. package/client/dist/quadrantDiagram-D57K4MC3.js +7 -0
  150. package/client/dist/r.js +1 -0
  151. package/client/dist/railroadDiagram-Y72NRBL7.js +1 -0
  152. package/client/dist/requirementDiagram-EQYSW5RA.js +84 -0
  153. package/client/dist/rpm.js +1 -0
  154. package/client/dist/ruby.js +1 -0
  155. package/client/dist/sankeyDiagram-SY24JHO5.js +40 -0
  156. package/client/dist/sas.js +1 -0
  157. package/client/dist/scheme.js +1 -0
  158. package/client/dist/sequenceDiagram-BLEHNHQU.js +169 -0
  159. package/client/dist/shell.js +1 -0
  160. package/client/dist/sieve.js +1 -0
  161. package/client/dist/simple-mode.js +1 -0
  162. package/client/dist/sizeCapture-INFHLROL.js +1 -0
  163. package/client/dist/smalltalk.js +1 -0
  164. package/client/dist/solr.js +1 -0
  165. package/client/dist/sparql.js +1 -0
  166. package/client/dist/spreadsheet.js +1 -0
  167. package/client/dist/sql.js +1 -0
  168. package/client/dist/stateDiagram-v2-A6IESKWZ.js +291 -0
  169. package/client/dist/stex.js +1 -0
  170. package/client/dist/style.css +1 -0
  171. package/client/dist/stylus.js +1 -0
  172. package/client/dist/swift.js +1 -0
  173. package/client/dist/swimlanes-B3ENRKFQ.js +1 -0
  174. package/client/dist/swimlanesDiagram-AYQRV4AK.js +8 -0
  175. package/client/dist/tcl.js +1 -0
  176. package/client/dist/terminal-panel.js +18 -0
  177. package/client/dist/textile.js +1 -0
  178. package/client/dist/tiddlywiki.js +1 -0
  179. package/client/dist/tiki.js +1 -0
  180. package/client/dist/timeline-definition-JXYKGLGB.js +120 -0
  181. package/client/dist/toml.js +1 -0
  182. package/client/dist/troff.js +1 -0
  183. package/client/dist/ttcn-cfg.js +1 -0
  184. package/client/dist/ttcn.js +1 -0
  185. package/client/dist/turtle.js +1 -0
  186. package/client/dist/usecaseDiagram-WPOLBNNX.js +370 -0
  187. package/client/dist/vb.js +1 -0
  188. package/client/dist/vbscript.js +1 -0
  189. package/client/dist/velocity.js +1 -0
  190. package/client/dist/vennDiagram-Q3Y3IDCW.js +34 -0
  191. package/client/dist/verilog.js +1 -0
  192. package/client/dist/vhdl.js +1 -0
  193. package/client/dist/wardleyDiagram-IVAIDKWA.js +78 -0
  194. package/client/dist/webidl.js +1 -0
  195. package/client/dist/xquery.js +1 -0
  196. package/client/dist/xychartDiagram-4URNHDU4.js +7 -0
  197. package/client/dist/yacas.js +1 -0
  198. package/client/dist/z80.js +1 -0
  199. package/docs/architecture/backend-regressions.md +53 -0
  200. package/docs/architecture/backends.md +115 -0
  201. package/docs/architecture/behavior.md +228 -0
  202. package/docs/architecture.md +335 -0
  203. package/docs/background-tasks.md +39 -0
  204. package/docs/cli-command-coverage.md +60 -0
  205. package/docs/deployment.md +289 -0
  206. package/docs/development.md +396 -0
  207. package/docs/images/desktop-dark.png +0 -0
  208. package/docs/images/desktop-light.png +0 -0
  209. package/docs/images/mobile-sidebar.png +0 -0
  210. package/docs/images/mobile.png +0 -0
  211. package/docs/releases/v2.0.0.md +5 -0
  212. package/docs/releases/v2.1.0.md +6 -0
  213. package/docs/releases/v2.1.1.md +6 -0
  214. package/docs/releases/v2.1.2.md +8 -0
  215. package/docs/releases/v2.2.0.md +11 -0
  216. package/docs/releases/v2.3.0.md +12 -0
  217. package/docs/releases/v2.3.1.md +8 -0
  218. package/docs/releases/v2.4.0.md +8 -0
  219. package/docs/releases/v2.4.1.md +8 -0
  220. package/docs/releases/v2.4.2.md +8 -0
  221. package/docs/releases/v3.0.0.md +9 -0
  222. package/docs/releases/v3.1.0.md +10 -0
  223. package/docs/releases/v3.1.1.md +7 -0
  224. package/docs/releases/v4.0.0-beta.1.md +10 -0
  225. package/docs/releases/v4.0.0.md +20 -0
  226. package/docs/releases/v4.0.1.md +10 -0
  227. package/docs/releases/v4.1.0.md +21 -0
  228. package/docs/versioning.md +129 -0
  229. package/package.json +87 -4
  230. package/packages/translation-engine/LICENSE +674 -0
  231. package/packages/translation-engine/README.md +69 -0
  232. package/packages/translation-engine/bin/tokenizer-linux-x64 +0 -0
  233. package/packages/translation-engine/bin/translate.mjs +29 -0
  234. package/packages/translation-engine/native/build.mjs +15 -0
  235. package/packages/translation-engine/native/tokenizer.c +73 -0
  236. package/packages/translation-engine/package.json +29 -0
  237. package/packages/translation-engine/src/catalog.mjs +103 -0
  238. package/packages/translation-engine/src/cpu-runtime.mjs +90 -0
  239. package/packages/translation-engine/src/download.mjs +94 -0
  240. package/packages/translation-engine/src/index.mjs +70 -0
  241. package/packages/translation-engine/src/inference.mjs +177 -0
  242. package/packages/translation-engine/src/model-store.mjs +197 -0
  243. package/packages/translation-engine/src/tokenizer.mjs +77 -0
  244. package/packages/translation-engine/src/worker.mjs +83 -0
  245. package/scripts/install-services.mjs +135 -0
  246. package/scripts/restart-when-idle.mjs +125 -0
  247. package/scripts/start-backend.mjs +29 -0
  248. package/server/src/agent-messages.mjs +124 -0
  249. package/server/src/application.mjs +168 -0
  250. package/server/src/auth.mjs +328 -0
  251. package/server/src/backends/claude/account.mjs +171 -0
  252. package/server/src/backends/claude/adapter.mjs +366 -0
  253. package/server/src/backends/claude/agent-history.mjs +70 -0
  254. package/server/src/backends/claude/background-tasks.mjs +168 -0
  255. package/server/src/backends/claude/catalogue.mjs +268 -0
  256. package/server/src/backends/claude/execution-errors.mjs +44 -0
  257. package/server/src/backends/claude/execution-session.mjs +396 -0
  258. package/server/src/backends/claude/git-tool-changes.mjs +77 -0
  259. package/server/src/backends/claude/goals.mjs +319 -0
  260. package/server/src/backends/claude/history-actions.mjs +170 -0
  261. package/server/src/backends/claude/history.mjs +65 -0
  262. package/server/src/backends/claude/hooks.mjs +232 -0
  263. package/server/src/backends/claude/input-stream.mjs +24 -0
  264. package/server/src/backends/claude/messages-request.mjs +34 -0
  265. package/server/src/backends/claude/messages.mjs +301 -0
  266. package/server/src/backends/claude/model-options.mjs +18 -0
  267. package/server/src/backends/claude/native-commands.mjs +48 -0
  268. package/server/src/backends/claude/native-records.mjs +76 -0
  269. package/server/src/backends/claude/process-ownership.mjs +82 -0
  270. package/server/src/backends/claude/project-instructions.mjs +40 -0
  271. package/server/src/backends/claude/provider-balance.mjs +40 -0
  272. package/server/src/backends/claude/provider-environment.mjs +95 -0
  273. package/server/src/backends/claude/provider-transport.mjs +70 -0
  274. package/server/src/backends/claude/recovery.mjs +54 -0
  275. package/server/src/backends/claude/runtime.mjs +463 -0
  276. package/server/src/backends/claude/session-worker.mjs +32 -0
  277. package/server/src/backends/claude/sessions.mjs +348 -0
  278. package/server/src/backends/claude/token-usage.mjs +98 -0
  279. package/server/src/backends/claude/worker-client.mjs +351 -0
  280. package/server/src/backends/claude/worker-launcher.mjs +119 -0
  281. package/server/src/backends/claude/worker-location.mjs +43 -0
  282. package/server/src/backends/claude/worker-revision.mjs +45 -0
  283. package/server/src/backends/claude/worker-server.mjs +290 -0
  284. package/server/src/backends/cli-installation.mjs +140 -0
  285. package/server/src/backends/codex/adapter.mjs +155 -0
  286. package/server/src/backends/codex/compaction-recovery.mjs +78 -0
  287. package/server/src/backends/codex/events.mjs +125 -0
  288. package/server/src/backends/codex/methods.mjs +17 -0
  289. package/server/src/backends/codex/reference-mcp.mjs +97 -0
  290. package/server/src/backends/codex/reference-tools.mjs +71 -0
  291. package/server/src/backends/codex/requests.mjs +170 -0
  292. package/server/src/backends/codex/subscriptions.mjs +91 -0
  293. package/server/src/backends/codex/token-usage.mjs +140 -0
  294. package/server/src/backends/codex/upstream.mjs +148 -0
  295. package/server/src/backends/configuration.mjs +122 -0
  296. package/server/src/backends/identity-mapping.mjs +87 -0
  297. package/server/src/backends/manager.mjs +478 -0
  298. package/server/src/backends/network-proxy.mjs +55 -0
  299. package/server/src/backends/provider-presets.mjs +45 -0
  300. package/server/src/backends/providers.mjs +135 -0
  301. package/server/src/backends/storage.mjs +39 -0
  302. package/server/src/bridge/conversation-policy.mjs +29 -0
  303. package/server/src/bridge/file-operations.mjs +47 -0
  304. package/server/src/bridge/product-methods.mjs +66 -0
  305. package/server/src/compaction.mjs +82 -0
  306. package/server/src/config.mjs +64 -0
  307. package/server/src/file-content.mjs +99 -0
  308. package/server/src/file-undo.mjs +142 -0
  309. package/server/src/http/maintenance.mjs +28 -0
  310. package/server/src/http/router.mjs +98 -0
  311. package/server/src/http/static.mjs +62 -0
  312. package/server/src/product-config.mjs +80 -0
  313. package/server/src/project-models.mjs +59 -0
  314. package/server/src/rpc-transport.mjs +21 -0
  315. package/server/src/server.mjs +29 -0
  316. package/server/src/service-maintenance-worker.mjs +124 -0
  317. package/server/src/service-maintenance.mjs +222 -0
  318. package/server/src/summary-translation.mjs +71 -0
  319. package/server/src/system-auth.mjs +45 -0
  320. package/server/src/thread-folders.mjs +76 -0
  321. package/server/src/thread-names.mjs +264 -0
  322. package/server/src/thread-projects.mjs +36 -0
  323. package/server/src/tls.mjs +87 -0
  324. package/server/src/token-usage-reconciliation.mjs +105 -0
  325. package/server/src/token-usage.mjs +208 -0
  326. package/server/src/translation-service.mjs +133 -0
  327. package/server/src/version.mjs +55 -0
  328. package/server/src/web-config-migration.mjs +48 -0
  329. package/server/src/workspace/commands.mjs +33 -0
  330. package/server/src/workspace/files.mjs +44 -0
  331. package/server/src/workspace/service.mjs +27 -0
  332. package/server/src/workspace/terminals.mjs +122 -0
  333. package/shared/backend-activity.mjs +13 -0
  334. package/shared/backend-capabilities.mjs +33 -0
  335. package/shared/backend-identity.mjs +17 -0
  336. package/shared/compaction-state.mjs +49 -0
  337. package/shared/file-types.mjs +82 -0
  338. package/shared/product-contract.mjs +26 -0
  339. package/shared/rpc-limits.mjs +2 -0
  340. package/shared/terminal-workspace.mjs +26 -0
@@ -0,0 +1,351 @@
1
+ import { findCli } from "../cli-installation.mjs";
2
+ import net from "node:net";
3
+ import { isDeepStrictEqual } from "node:util";
4
+ import { randomUUID } from "node:crypto";
5
+ import { setTimeout as delay } from "node:timers/promises";
6
+ import { claudeCapabilities } from "../../../../shared/backend-capabilities.mjs";
7
+ import { hasBackendWork } from "../../../../shared/backend-activity.mjs";
8
+ import { launchWorker, workerLocation } from "./worker-launcher.mjs";
9
+ import { workerRevision } from "./worker-revision.mjs";
10
+ import { networkProxyEnvironment } from "../network-proxy.mjs";
11
+ import {
12
+ captureNativeProcesses,
13
+ nativeProcessesAlive,
14
+ } from "./process-ownership.mjs";
15
+ import {
16
+ prepareWorkerDirectory,
17
+ verifyWorkerSocket,
18
+ workerConnectionError,
19
+ } from "./worker-location.mjs";
20
+
21
+ export function createClaudeWorkerAdapter({
22
+ backend,
23
+ config,
24
+ send,
25
+ broadcast,
26
+ }) {
27
+ const location = workerLocation(backend);
28
+ const options = {
29
+ generation: Date.now(),
30
+ backend,
31
+ runtimeEnv: {
32
+ ...Object.fromEntries(
33
+ [
34
+ "ANTHROPIC_AUTH_TOKEN",
35
+ "ANTHROPIC_API_KEY",
36
+ "ANTHROPIC_BASE_URL",
37
+ "ANTHROPIC_MODEL",
38
+ "CLAUDE_CODE_EFFORT_LEVEL",
39
+ "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS",
40
+ "HTTP_PROXY",
41
+ "HTTPS_PROXY",
42
+ "ALL_PROXY",
43
+ "NO_PROXY",
44
+ "http_proxy",
45
+ "https_proxy",
46
+ "all_proxy",
47
+ "no_proxy",
48
+ "SSL_CERT_FILE",
49
+ "SSL_CERT_DIR",
50
+ "NODE_EXTRA_CA_CERTS",
51
+ "NODE_USE_ENV_PROXY",
52
+ "LANG",
53
+ "LC_ALL",
54
+ ]
55
+ .filter((key) => process.env[key] !== undefined)
56
+ .map((key) => [key, process.env[key]]),
57
+ ),
58
+ ...networkProxyEnvironment(backend.proxy),
59
+ },
60
+ config: Object.fromEntries(
61
+ [
62
+ "codexHome",
63
+ "claudeHome",
64
+ "configDir",
65
+ "backendsFile",
66
+ "defaultCwd",
67
+ "projectlessRoot",
68
+ ].map((key) => [key, config[key]]),
69
+ ),
70
+ };
71
+ const pending = new Map();
72
+ let socket,
73
+ reconnect,
74
+ connecting,
75
+ closed = false,
76
+ workerPid,
77
+ workerIdentity,
78
+ stopping = false,
79
+ outdated = false,
80
+ upgrading = false,
81
+ mayUpgrade = true;
82
+ let snapshot = {
83
+ method: "lan/state",
84
+ params: {
85
+ ready: false,
86
+ error: null,
87
+ activeTurns: {},
88
+ questions: [],
89
+ compactions: {},
90
+ terminals: {},
91
+ undoneFiles: [],
92
+ backgroundTasks: {},
93
+ },
94
+ };
95
+ function publish() {
96
+ if (outdated && mayUpgrade)
97
+ snapshot = {
98
+ ...snapshot,
99
+ params: { ...snapshot.params, pendingUpdate: true },
100
+ };
101
+ broadcast(snapshot);
102
+ }
103
+ function busy() {
104
+ return hasBackendWork(snapshot.params);
105
+ }
106
+ function upgradeWhenIdle() {
107
+ if (!outdated || !mayUpgrade || upgrading || busy() || closed) return;
108
+ upgrading = true;
109
+ shutdownWorker(options)
110
+ .then(async () => {
111
+ if (connecting) await connecting.catch(() => {});
112
+ await connect();
113
+ })
114
+ .catch(() => {})
115
+ .finally(() => {
116
+ upgrading = false;
117
+ });
118
+ }
119
+ function accept(packet) {
120
+ if (packet.kind === "state") {
121
+ snapshot = packet.message;
122
+ publish();
123
+ upgradeWhenIdle();
124
+ }
125
+ if (packet.kind === "event") broadcast(packet.message);
126
+ if (packet.kind === "response") {
127
+ const request = pending.get(packet.id);
128
+ if (!request) return;
129
+ pending.delete(packet.id);
130
+ clearTimeout(request.timer);
131
+ if (packet.error) request.reject(new Error(packet.error));
132
+ else request.resolve(packet.result);
133
+ }
134
+ }
135
+ function request(kind, value = {}) {
136
+ if (!socket || socket.destroyed)
137
+ return Promise.reject(new Error("Claude 后端连接已断开"));
138
+ const id = randomUUID();
139
+ return new Promise((resolve, reject) => {
140
+ const timer = setTimeout(() => {
141
+ pending.delete(id);
142
+ reject(new Error("Claude 后端请求超时,请核对实际任务状态。"));
143
+ }, 120000);
144
+ pending.set(id, { resolve, reject, timer });
145
+ socket.write(JSON.stringify({ kind, id, ...value }) + "\n");
146
+ });
147
+ }
148
+ async function open() {
149
+ stopping = false;
150
+ await prepareWorkerDirectory(location.directory);
151
+ let connection;
152
+ try {
153
+ await verifyWorkerSocket(location.socket);
154
+ connection = net.connect(location.socket);
155
+ await new Promise((resolve, reject) => {
156
+ connection.once("connect", resolve);
157
+ connection.once("error", reject);
158
+ });
159
+ } catch (error) {
160
+ throw workerConnectionError(error);
161
+ }
162
+ socket = connection;
163
+ let input = "";
164
+ connection.setEncoding("utf8");
165
+ connection.on("data", (chunk) => {
166
+ input += chunk;
167
+ if (Buffer.byteLength(input) > 128 * 1024 * 1024)
168
+ return connection.destroy(new Error("Claude IPC 响应超过限制"));
169
+ let index;
170
+ while ((index = input.indexOf("\n")) >= 0) {
171
+ const line = input.slice(0, index);
172
+ input = input.slice(index + 1);
173
+ try {
174
+ accept(JSON.parse(line));
175
+ } catch (error) {
176
+ connection.destroy(error);
177
+ }
178
+ }
179
+ });
180
+ connection.on("error", () => {});
181
+ connection.on("close", () => {
182
+ if (socket !== connection) return;
183
+ socket = null;
184
+ for (const item of pending.values()) {
185
+ clearTimeout(item.timer);
186
+ item.reject(new Error("Claude 后端连接中断,请核对实际任务状态。"));
187
+ }
188
+ pending.clear();
189
+ snapshot = {
190
+ ...snapshot,
191
+ params: {
192
+ ...snapshot.params,
193
+ ready: false,
194
+ error: "正在重新连接 Claude 后端…",
195
+ },
196
+ };
197
+ if (!closed && !stopping) {
198
+ publish();
199
+ reconnect = setTimeout(() => connect().catch(() => {}), 1000);
200
+ }
201
+ });
202
+ options.revision = await workerRevision();
203
+ let initialized;
204
+ try {
205
+ initialized = await request("initialize", { options });
206
+ } catch (error) {
207
+ connection.destroy();
208
+ throw error;
209
+ }
210
+ workerPid = initialized.pid;
211
+ workerIdentity = (await captureNativeProcesses(workerPid)).owner;
212
+ snapshot = initialized.state;
213
+ outdated =
214
+ initialized.revision?.entry !== options.revision.entry ||
215
+ initialized.revision?.hash !== options.revision.hash ||
216
+ (initialized.configuration &&
217
+ !isDeepStrictEqual(initialized.configuration, {
218
+ backend: options.backend,
219
+ config: options.config,
220
+ runtimeEnv: options.runtimeEnv,
221
+ }));
222
+ mayUpgrade =
223
+ !initialized.generation || options.generation > initialized.generation;
224
+ publish();
225
+ if (outdated && mayUpgrade && !initialized.busy) {
226
+ await shutdownWorker(options);
227
+ const error = new Error("Claude 后端代码更新,正在重新启动。");
228
+ error.code = "EWORKERUPDATE";
229
+ throw error;
230
+ }
231
+ }
232
+ async function connect() {
233
+ options.backend = {
234
+ ...backend,
235
+ executable:
236
+ backend.executable === "claude"
237
+ ? await findCli("claude")
238
+ : backend.executable,
239
+ };
240
+ if (closed) return;
241
+ if (connecting) return connecting;
242
+ if (socket && !socket.destroyed) return;
243
+ connecting = (async () => {
244
+ try {
245
+ await open();
246
+ return;
247
+ } catch (error) {
248
+ if (
249
+ !["ENOENT", "ECONNREFUSED", "ECONNRESET", "EWORKERUPDATE"].includes(
250
+ error.code,
251
+ )
252
+ )
253
+ throw error;
254
+ }
255
+ await launchWorker(backend, options);
256
+ let lastError;
257
+ for (let attempt = 0; attempt < 100; attempt++) {
258
+ if (closed) return;
259
+ try {
260
+ await open();
261
+ return;
262
+ } catch (error) {
263
+ lastError = error;
264
+ if (error.code === "EWORKERUPDATE")
265
+ await launchWorker(backend, options);
266
+ }
267
+ await delay(100);
268
+ }
269
+ throw lastError;
270
+ })();
271
+ try {
272
+ await connecting;
273
+ } catch (error) {
274
+ if (error.cause) console.error("Claude 后台服务连接失败:", error.cause);
275
+ snapshot = {
276
+ ...snapshot,
277
+ params: { ...snapshot.params, ready: false, error: error.message },
278
+ };
279
+ publish();
280
+ if (!closed)
281
+ reconnect = setTimeout(() => connect().catch(() => {}), 1000);
282
+ throw error;
283
+ } finally {
284
+ connecting = null;
285
+ }
286
+ }
287
+ async function shutdownWorker(replacement) {
288
+ if (!socket || socket.destroyed) return;
289
+ const connection = socket;
290
+ let onClose;
291
+ const ended = new Promise((resolve) => {
292
+ onClose = resolve;
293
+ connection.once("close", onClose);
294
+ });
295
+ stopping = true;
296
+ try {
297
+ await request("shutdown", replacement ? { replacement } : {});
298
+ await ended;
299
+ for (let attempt = 0; attempt < 250; attempt++) {
300
+ if (
301
+ !workerIdentity ||
302
+ !(await nativeProcessesAlive({ nativeProcess: workerIdentity }))
303
+ )
304
+ return;
305
+ await delay(20);
306
+ }
307
+ throw new Error("Claude 后端停止超时,请核对后端服务状态。");
308
+ } catch (error) {
309
+ connection.removeListener("close", onClose);
310
+ stopping = false;
311
+ if (!closed && (!socket || socket.destroyed))
312
+ reconnect = setTimeout(() => connect().catch(() => {}), 1000);
313
+ throw error;
314
+ }
315
+ }
316
+ return {
317
+ capabilities: claudeCapabilities,
318
+ workspaceOwner: "bridge",
319
+ releaseClient() {},
320
+ state: () => snapshot,
321
+ get ready() {
322
+ return Boolean(socket && !socket.destroyed && snapshot.params.ready);
323
+ },
324
+ get workerPid() {
325
+ return workerPid;
326
+ },
327
+ connect,
328
+ async receive(client, message) {
329
+ try {
330
+ const response = await request("rpc", { message });
331
+ if (response) send(client, response);
332
+ } catch (error) {
333
+ if (message.method)
334
+ send(client, {
335
+ id: message.id,
336
+ error: { code: -32000, message: error.message },
337
+ });
338
+ }
339
+ },
340
+ releaseUnusedThreads() {
341
+ if (socket && !socket.destroyed)
342
+ socket.write(JSON.stringify({ kind: "release" }) + "\n");
343
+ },
344
+ shutdown: shutdownWorker,
345
+ close() {
346
+ closed = true;
347
+ clearTimeout(reconnect);
348
+ socket?.destroy();
349
+ },
350
+ };
351
+ }
@@ -0,0 +1,119 @@
1
+ import { execFile, spawn } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ import { setTimeout as delay } from "node:timers/promises";
4
+ import { join } from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+ import { randomUUID } from "node:crypto";
7
+ import { mkdir, open, readFile, writeFile, unlink } from "node:fs/promises";
8
+
9
+ import { workerLocation, prepareWorkerDirectory } from "./worker-location.mjs";
10
+ export { workerLocation } from "./worker-location.mjs";
11
+ const execute = promisify(execFile);
12
+ export async function launchWorker(backend, desired) {
13
+ const { socket, unit, directory } = workerLocation(backend);
14
+ await prepareWorkerDirectory(directory);
15
+ await mkdir(backend.stateDir, { recursive: true, mode: 0o700 });
16
+ let entry = fileURLToPath(new URL("./worker-server.mjs", import.meta.url));
17
+ let runtimeEnv = desired?.runtimeEnv || {};
18
+ try {
19
+ const saved = JSON.parse(
20
+ await readFile(join(backend.stateDir, "worker-options.json"), "utf8"),
21
+ );
22
+ if (
23
+ saved.preferredEntry &&
24
+ (!desired || saved.generation >= desired.generation)
25
+ ) {
26
+ entry = saved.preferredEntry;
27
+ runtimeEnv = saved.runtimeEnv || {};
28
+ }
29
+ } catch (error) {
30
+ if (error.code !== "ENOENT") throw error;
31
+ }
32
+ const envPath = join(backend.stateDir, `worker-environment-${randomUUID()}`);
33
+ const args = [entry, socket, backend.stateDir, envPath];
34
+ const quote = (value) =>
35
+ '"' + String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"';
36
+ const environment = { ...runtimeEnv, PATH: process.env.PATH };
37
+ await writeFile(
38
+ envPath,
39
+ Object.entries(environment)
40
+ .map(([key, value]) => `${key}=${quote(value)}`)
41
+ .join("\n") + "\n",
42
+ { mode: 0o600, flag: "wx" },
43
+ );
44
+ let userManager = false;
45
+ try {
46
+ await execute("systemctl", ["--user", "show-environment"], {
47
+ timeout: 5000,
48
+ });
49
+ userManager = true;
50
+ } catch (error) {
51
+ if (process.env.INVOCATION_ID) {
52
+ await unlink(envPath);
53
+ throw new Error(`无法启动独立 Claude 后端服务:${error.message}`);
54
+ }
55
+ }
56
+ if (userManager) {
57
+ for (let attempt = 0; attempt < 50; attempt++) {
58
+ try {
59
+ await execute(
60
+ "systemd-run",
61
+ [
62
+ "--user",
63
+ "--quiet",
64
+ `--unit=${unit}`,
65
+ "--collect",
66
+ "--property=Type=exec",
67
+ "--property=Restart=on-failure",
68
+ "--property=RestartSec=2",
69
+ `--property=EnvironmentFile=${envPath.replace(/%/g, "%%")}`,
70
+ process.execPath,
71
+ ...args,
72
+ ],
73
+ { timeout: 10000 },
74
+ );
75
+ return;
76
+ } catch (error) {
77
+ const { stdout } = await execute(
78
+ "systemctl",
79
+ ["--user", "show", unit, "--property=ActiveState", "--value"],
80
+ { timeout: 5000 },
81
+ );
82
+ if (["active", "activating"].includes(stdout.trim())) {
83
+ const current = await execute(
84
+ "systemctl",
85
+ ["--user", "show", unit, "--property=EnvironmentFiles", "--value"],
86
+ { timeout: 5000 },
87
+ );
88
+ if (!current.stdout.includes(envPath)) await unlink(envPath);
89
+ return;
90
+ }
91
+ if (
92
+ !["deactivating", "inactive", "failed", ""].includes(stdout.trim()) ||
93
+ attempt === 49
94
+ ) {
95
+ await unlink(envPath);
96
+ throw error;
97
+ }
98
+ await delay(100);
99
+ }
100
+ }
101
+ return;
102
+ }
103
+ await mkdir(backend.stateDir, { recursive: true, mode: 0o700 });
104
+ const log = await open(join(backend.stateDir, "worker.log"), "a", 0o600);
105
+ try {
106
+ const child = spawn(process.execPath, args, {
107
+ detached: true,
108
+ stdio: ["ignore", log.fd, log.fd],
109
+ env: { ...process.env, ...runtimeEnv },
110
+ });
111
+ await new Promise((resolve, reject) => {
112
+ child.once("spawn", resolve);
113
+ child.once("error", reject);
114
+ });
115
+ child.unref();
116
+ } finally {
117
+ await log.close();
118
+ }
119
+ }
@@ -0,0 +1,43 @@
1
+ import { createHash } from "node:crypto";
2
+ import { tmpdir } from "node:os";
3
+ import { join, resolve } from "node:path";
4
+ import { mkdir, lstat } from "node:fs/promises";
5
+
6
+ export function workerLocation(backend) {
7
+ const key = createHash("sha256")
8
+ .update(resolve(backend.stateDir))
9
+ .digest("hex")
10
+ .slice(0, 20);
11
+ const directory = join(
12
+ process.env.XDG_RUNTIME_DIR || tmpdir(),
13
+ `claudex-web-claude-${process.getuid()}`,
14
+ );
15
+ return {
16
+ directory,
17
+ socket: join(directory, `${key}.sock`),
18
+ unit: `claudex-web-claude-${key}`,
19
+ };
20
+ }
21
+ export async function prepareWorkerDirectory(directory) {
22
+ await mkdir(directory, { recursive: true, mode: 0o700 });
23
+ const info = await lstat(directory);
24
+ if (!info.isDirectory() || info.uid !== process.getuid() || info.mode & 0o077)
25
+ throw new Error("Claude IPC 目录必须由当前用户持有并使用0700权限。");
26
+ }
27
+ export async function verifyWorkerSocket(path) {
28
+ const info = await lstat(path);
29
+ if (!info.isSocket() || info.uid !== process.getuid() || info.mode & 0o077)
30
+ throw new Error("Claude IPC socket 必须由当前用户持有并使用0600权限。");
31
+ }
32
+
33
+ export function workerConnectionError(error) {
34
+ if (!["ENOENT", "ECONNREFUSED", "ECONNRESET", "EACCES"].includes(error.code))
35
+ return error;
36
+ const message =
37
+ error.code === "EACCES"
38
+ ? "Claude 后台访问被拒绝,请检查服务权限。"
39
+ : "Claude 后台连接失败,正在重试";
40
+ const result = new Error(message, { cause: error });
41
+ result.code = error.code;
42
+ return result;
43
+ }
@@ -0,0 +1,45 @@
1
+ import { createHash } from "node:crypto";
2
+ import { readdir, readFile } from "node:fs/promises";
3
+ import { fileURLToPath } from "node:url";
4
+ import { join, relative } from "node:path";
5
+
6
+ const root = fileURLToPath(new URL("../../../../", import.meta.url));
7
+ const loadedAt = Date.now();
8
+ async function files(directory) {
9
+ const entries = await readdir(directory, { withFileTypes: true });
10
+ const nested = await Promise.all(
11
+ entries
12
+ .filter((entry) => !entry.name.startsWith("."))
13
+ .map((entry) => {
14
+ const path = join(directory, entry.name);
15
+ return entry.isDirectory()
16
+ ? files(path)
17
+ : entry.name.endsWith(".mjs")
18
+ ? [path]
19
+ : [];
20
+ }),
21
+ );
22
+ return nested.flat();
23
+ }
24
+ async function revision() {
25
+ const paths = [
26
+ ...(await files(join(root, "server", "src"))),
27
+ ...(await files(join(root, "shared"))),
28
+ join(root, "package.json"),
29
+ ].sort();
30
+ const content = await Promise.all(paths.map((path) => readFile(path)));
31
+ const hash = createHash("sha256");
32
+ paths.forEach((path, index) => {
33
+ hash.update(relative(root, path));
34
+ hash.update(content[index]);
35
+ });
36
+ return {
37
+ loadedAt,
38
+ entry: fileURLToPath(new URL("./worker-server.mjs", import.meta.url)),
39
+ hash: hash.digest("hex"),
40
+ version: JSON.parse(await readFile(join(root, "package.json"), "utf8"))
41
+ .version,
42
+ };
43
+ }
44
+ const current = revision();
45
+ export const workerRevision = () => current;