@hjd-hitsz/claudex-web 0.0.0-stage → 4.0.1

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 (317) hide show
  1. package/.env.example +27 -0
  2. package/CHANGELOG.md +449 -0
  3. package/LICENSE +674 -0
  4. package/README.md +128 -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 +393 -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 +113 -0
  201. package/docs/architecture/behavior.md +206 -0
  202. package/docs/architecture.md +306 -0
  203. package/docs/background-tasks.md +39 -0
  204. package/docs/cli-command-coverage.md +60 -0
  205. package/docs/deployment.md +269 -0
  206. package/docs/development.md +385 -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/versioning.md +119 -0
  228. package/package.json +70 -4
  229. package/scripts/install-services.mjs +134 -0
  230. package/scripts/restart-when-idle.mjs +125 -0
  231. package/scripts/start-backend.mjs +29 -0
  232. package/server/src/agent-messages.mjs +124 -0
  233. package/server/src/application.mjs +133 -0
  234. package/server/src/auth.mjs +328 -0
  235. package/server/src/backends/claude/account.mjs +171 -0
  236. package/server/src/backends/claude/adapter.mjs +366 -0
  237. package/server/src/backends/claude/agent-history.mjs +70 -0
  238. package/server/src/backends/claude/background-tasks.mjs +168 -0
  239. package/server/src/backends/claude/catalogue.mjs +266 -0
  240. package/server/src/backends/claude/execution-errors.mjs +44 -0
  241. package/server/src/backends/claude/execution-session.mjs +390 -0
  242. package/server/src/backends/claude/git-tool-changes.mjs +77 -0
  243. package/server/src/backends/claude/goals.mjs +319 -0
  244. package/server/src/backends/claude/history-actions.mjs +170 -0
  245. package/server/src/backends/claude/history.mjs +65 -0
  246. package/server/src/backends/claude/hooks.mjs +232 -0
  247. package/server/src/backends/claude/input-stream.mjs +24 -0
  248. package/server/src/backends/claude/messages-request.mjs +34 -0
  249. package/server/src/backends/claude/messages.mjs +300 -0
  250. package/server/src/backends/claude/model-options.mjs +18 -0
  251. package/server/src/backends/claude/native-commands.mjs +48 -0
  252. package/server/src/backends/claude/native-records.mjs +76 -0
  253. package/server/src/backends/claude/process-ownership.mjs +82 -0
  254. package/server/src/backends/claude/project-instructions.mjs +40 -0
  255. package/server/src/backends/claude/provider-balance.mjs +40 -0
  256. package/server/src/backends/claude/provider-environment.mjs +93 -0
  257. package/server/src/backends/claude/provider-transport.mjs +70 -0
  258. package/server/src/backends/claude/recovery.mjs +54 -0
  259. package/server/src/backends/claude/runtime.mjs +463 -0
  260. package/server/src/backends/claude/session-worker.mjs +32 -0
  261. package/server/src/backends/claude/sessions.mjs +347 -0
  262. package/server/src/backends/claude/token-usage.mjs +98 -0
  263. package/server/src/backends/claude/worker-client.mjs +344 -0
  264. package/server/src/backends/claude/worker-launcher.mjs +119 -0
  265. package/server/src/backends/claude/worker-location.mjs +31 -0
  266. package/server/src/backends/claude/worker-revision.mjs +45 -0
  267. package/server/src/backends/claude/worker-server.mjs +290 -0
  268. package/server/src/backends/cli-installation.mjs +140 -0
  269. package/server/src/backends/codex/adapter.mjs +153 -0
  270. package/server/src/backends/codex/compaction-recovery.mjs +78 -0
  271. package/server/src/backends/codex/events.mjs +125 -0
  272. package/server/src/backends/codex/methods.mjs +17 -0
  273. package/server/src/backends/codex/reference-mcp.mjs +97 -0
  274. package/server/src/backends/codex/reference-tools.mjs +71 -0
  275. package/server/src/backends/codex/requests.mjs +170 -0
  276. package/server/src/backends/codex/subscriptions.mjs +91 -0
  277. package/server/src/backends/codex/upstream.mjs +148 -0
  278. package/server/src/backends/configuration.mjs +122 -0
  279. package/server/src/backends/identity-mapping.mjs +87 -0
  280. package/server/src/backends/manager.mjs +412 -0
  281. package/server/src/backends/network-proxy.mjs +55 -0
  282. package/server/src/backends/provider-presets.mjs +45 -0
  283. package/server/src/backends/providers.mjs +132 -0
  284. package/server/src/backends/storage.mjs +35 -0
  285. package/server/src/bridge/conversation-policy.mjs +29 -0
  286. package/server/src/bridge/file-operations.mjs +47 -0
  287. package/server/src/bridge/product-methods.mjs +66 -0
  288. package/server/src/compaction.mjs +82 -0
  289. package/server/src/config.mjs +57 -0
  290. package/server/src/file-content.mjs +99 -0
  291. package/server/src/file-undo.mjs +142 -0
  292. package/server/src/http/router.mjs +80 -0
  293. package/server/src/http/static.mjs +62 -0
  294. package/server/src/product-config.mjs +80 -0
  295. package/server/src/project-models.mjs +59 -0
  296. package/server/src/rpc-transport.mjs +21 -0
  297. package/server/src/server.mjs +20 -0
  298. package/server/src/summary-translation.mjs +82 -0
  299. package/server/src/system-auth.mjs +45 -0
  300. package/server/src/thread-folders.mjs +76 -0
  301. package/server/src/thread-names.mjs +264 -0
  302. package/server/src/thread-projects.mjs +36 -0
  303. package/server/src/tls.mjs +87 -0
  304. package/server/src/version.mjs +55 -0
  305. package/server/src/web-config-migration.mjs +48 -0
  306. package/server/src/workspace/commands.mjs +33 -0
  307. package/server/src/workspace/files.mjs +44 -0
  308. package/server/src/workspace/service.mjs +27 -0
  309. package/server/src/workspace/terminals.mjs +122 -0
  310. package/shared/backend-activity.mjs +13 -0
  311. package/shared/backend-capabilities.mjs +33 -0
  312. package/shared/backend-identity.mjs +17 -0
  313. package/shared/compaction-state.mjs +49 -0
  314. package/shared/file-types.mjs +82 -0
  315. package/shared/product-contract.mjs +26 -0
  316. package/shared/rpc-limits.mjs +2 -0
  317. package/shared/terminal-workspace.mjs +26 -0
@@ -0,0 +1,290 @@
1
+ import net from "node:net";
2
+ import {
3
+ mkdir,
4
+ readFile,
5
+ writeFile,
6
+ rename,
7
+ chmod,
8
+ lstat,
9
+ unlink,
10
+ } from "node:fs/promises";
11
+ import { join, resolve, dirname } from "node:path";
12
+ import { createClaudeAdapter } from "./adapter.mjs";
13
+ import { createBackendConfiguration } from "../configuration.mjs";
14
+ import { createProviders } from "../providers.mjs";
15
+ import { workerRevision } from "./worker-revision.mjs";
16
+ import { hasBackendWork } from "../../../../shared/backend-activity.mjs";
17
+ import {
18
+ prepareWorkerDirectory,
19
+ verifyWorkerSocket,
20
+ } from "./worker-location.mjs";
21
+
22
+ const [socketPath, dataDir, environmentPath] = process.argv.slice(2);
23
+ if (!socketPath || !dataDir)
24
+ throw new Error("Claude worker requires a socket and data directory");
25
+ process.umask(0o077);
26
+ await mkdir(dataDir, { recursive: true, mode: 0o700 });
27
+ await prepareWorkerDirectory(dirname(socketPath));
28
+ const optionsPath = join(dataDir, "worker-options.json");
29
+ const clients = new Set();
30
+ const revision = await workerRevision();
31
+ let adapter;
32
+ let options;
33
+ let initializing;
34
+ let closing = false;
35
+ let inflight = 0;
36
+ let stopping = false;
37
+ async function currentState() {
38
+ let sessions = {};
39
+ try {
40
+ sessions = JSON.parse(
41
+ await readFile(join(dataDir, "claudex-web-index.json"), "utf8"),
42
+ ).sessions;
43
+ } catch (error) {
44
+ if (error.code !== "ENOENT") throw error;
45
+ }
46
+ const state = adapter.state();
47
+ return {
48
+ ...state,
49
+ params: {
50
+ ...state.params,
51
+ backgroundTasks: Object.fromEntries(
52
+ Object.entries(sessions)
53
+ .map(([id, session]) => [
54
+ id,
55
+ Object.values(session.backgroundTasks || {}).filter((task) =>
56
+ ["running", "pending", "unknown"].includes(task.status),
57
+ ),
58
+ ])
59
+ .filter(([, tasks]) => tasks.length),
60
+ ),
61
+ queuedInputs: Object.fromEntries(
62
+ Object.entries(sessions)
63
+ .filter(([, session]) => session.queue?.length)
64
+ .map(([id, session]) => [id, session.queue.length]),
65
+ ),
66
+ },
67
+ };
68
+ }
69
+ async function isBusy() {
70
+ const { params } = await currentState();
71
+ return Boolean(inflight || hasBackendWork(params));
72
+ }
73
+ function send(socket, value) {
74
+ if (!socket.destroyed) socket.write(JSON.stringify(value) + "\n");
75
+ }
76
+ function broadcast(message) {
77
+ if (message.method !== "lan/state")
78
+ for (const socket of clients)
79
+ if (socket.initialized) send(socket, { kind: "event", message });
80
+ if (message.method === "lan/state" || !/delta$/i.test(message.method))
81
+ queueMicrotask(() => {
82
+ if (adapter)
83
+ for (const socket of clients)
84
+ if (socket.initialized)
85
+ currentState()
86
+ .then((message) => send(socket, { kind: "state", message }))
87
+ .catch((error) =>
88
+ send(socket, { kind: "error", error: error.message }),
89
+ );
90
+ });
91
+ }
92
+ async function initialize(value) {
93
+ if (initializing) {
94
+ await initializing;
95
+ }
96
+ if (adapter) {
97
+ if (
98
+ resolve(value.backend.stateDir) !== resolve(dataDir) ||
99
+ value.backend.id !== "claude"
100
+ )
101
+ throw new Error("Claude 后端目录或标识不匹配");
102
+ return;
103
+ }
104
+ initializing = (async () => {
105
+ if (
106
+ resolve(value.backend.stateDir) !== resolve(dataDir) ||
107
+ value.backend.id !== "claude"
108
+ )
109
+ throw new Error("Claude 后端目录或标识不匹配");
110
+ options = { ...value, revision, preferredEntry: revision.entry };
111
+ Object.assign(process.env, value.runtimeEnv || {});
112
+ const temporary = `${optionsPath}.${process.pid}.tmp`;
113
+ await writeFile(temporary, JSON.stringify(options), { mode: 0o600 });
114
+ await rename(temporary, optionsPath);
115
+ const providers = createProviders(createBackendConfiguration(value.config));
116
+ adapter = createClaudeAdapter({
117
+ ...value,
118
+ providers,
119
+ send: (client, message) => client.deliver(message),
120
+ broadcast,
121
+ workspace: { handles: () => false, snapshot: () => ({}) },
122
+ });
123
+ await adapter.connect();
124
+ })();
125
+ try {
126
+ await initializing;
127
+ } finally {
128
+ initializing = null;
129
+ }
130
+ }
131
+ const server = net.createServer((socket) => {
132
+ clients.add(socket);
133
+ let input = "";
134
+ socket.setEncoding("utf8");
135
+ socket.on("data", (chunk) => {
136
+ input += chunk;
137
+ if (Buffer.byteLength(input) > 128 * 1024 * 1024)
138
+ return socket.destroy(new Error("Claude IPC 请求超过限制"));
139
+ let index;
140
+ while ((index = input.indexOf("\n")) >= 0) {
141
+ const line = input.slice(0, index);
142
+ input = input.slice(index + 1);
143
+ handle(socket, line).catch((error) =>
144
+ send(socket, { kind: "error", error: error.message }),
145
+ );
146
+ }
147
+ });
148
+ socket.on("error", () => {});
149
+ socket.on("close", () => clients.delete(socket));
150
+ });
151
+ async function handle(socket, line) {
152
+ let request;
153
+ try {
154
+ request = JSON.parse(line);
155
+ if (request.kind === "initialize") {
156
+ await initialize(request.options);
157
+ socket.initialized = true;
158
+ send(socket, {
159
+ kind: "response",
160
+ id: request.id,
161
+ result: {
162
+ pid: process.pid,
163
+ state: await currentState(),
164
+ revision,
165
+ busy: await isBusy(),
166
+ configuration: {
167
+ backend: options.backend,
168
+ config: options.config,
169
+ runtimeEnv: options.runtimeEnv || {},
170
+ },
171
+ generation: options.generation,
172
+ },
173
+ });
174
+ return;
175
+ }
176
+ if (!socket.initialized) throw new Error("Claude IPC 尚未初始化");
177
+ if (request.kind === "state")
178
+ return send(socket, {
179
+ kind: "response",
180
+ id: request.id,
181
+ result: await currentState(),
182
+ });
183
+ if (request.kind === "release") {
184
+ adapter.releaseUnusedThreads();
185
+ return;
186
+ }
187
+ if (request.kind === "shutdown") {
188
+ if (stopping) throw new Error("Claude 后端正在停止。");
189
+ stopping = true;
190
+ if (await isBusy()) {
191
+ stopping = false;
192
+ throw new Error(
193
+ "Claude 后端仍有运行任务、排队输入或待答提问,请结束后再停止。",
194
+ );
195
+ }
196
+ if (request.replacement) {
197
+ if (
198
+ resolve(request.replacement.backend.stateDir) !== resolve(dataDir)
199
+ ) {
200
+ stopping = false;
201
+ throw new Error("Claude 更新目录不匹配");
202
+ }
203
+ const temporary = `${optionsPath}.${process.pid}.tmp`;
204
+ await writeFile(
205
+ temporary,
206
+ JSON.stringify({
207
+ ...request.replacement,
208
+ preferredEntry: request.replacement.revision.entry,
209
+ }),
210
+ { mode: 0o600 },
211
+ );
212
+ await rename(temporary, optionsPath);
213
+ }
214
+ send(socket, { kind: "response", id: request.id, result: {} });
215
+ return shutdown();
216
+ }
217
+ if (request.kind !== "rpc") throw new Error("未知 Claude IPC 操作");
218
+ if (stopping) throw new Error("Claude 后端正在停止,请稍后重试。");
219
+ let replied = false;
220
+ inflight++;
221
+ try {
222
+ await adapter.receive(
223
+ {
224
+ deliver(message) {
225
+ replied = true;
226
+ send(socket, { kind: "response", id: request.id, result: message });
227
+ },
228
+ },
229
+ request.message,
230
+ );
231
+ } finally {
232
+ inflight--;
233
+ }
234
+ if (!replied)
235
+ send(socket, { kind: "response", id: request.id, result: null });
236
+ } catch (error) {
237
+ send(socket, { kind: "response", id: request?.id, error: error.message });
238
+ }
239
+ }
240
+ async function listen() {
241
+ await new Promise((resolve, reject) => {
242
+ server.once("error", reject);
243
+ server.listen(socketPath, resolve);
244
+ });
245
+ await chmod(socketPath, 0o600);
246
+ }
247
+ try {
248
+ await listen();
249
+ } catch (error) {
250
+ if (error.code !== "EADDRINUSE") throw error;
251
+ await verifyWorkerSocket(socketPath);
252
+ const active = await new Promise((resolve) => {
253
+ const socket = net.connect(socketPath);
254
+ socket.once("connect", () => {
255
+ socket.destroy();
256
+ resolve(true);
257
+ });
258
+ socket.once("error", () => resolve(false));
259
+ });
260
+ if (active) process.exit(0);
261
+ const info = await lstat(socketPath);
262
+ if (!info.isSocket() || info.uid !== process.getuid())
263
+ throw new Error("Claude IPC socket 归属异常");
264
+ await unlink(socketPath);
265
+ await listen();
266
+ }
267
+ try {
268
+ await initialize(JSON.parse(await readFile(optionsPath, "utf8")));
269
+ } catch (error) {
270
+ if (error.code !== "ENOENT") console.error("Claude 后端恢复失败", error);
271
+ }
272
+ const housekeeping = setInterval(() => adapter?.releaseUnusedThreads(), 30000);
273
+ async function shutdown() {
274
+ if (closing) return;
275
+ closing = true;
276
+ clearInterval(housekeeping);
277
+ adapter?.close();
278
+ for (const socket of clients) socket.end();
279
+ server.close();
280
+ await unlink(socketPath).catch((error) => {
281
+ if (error.code !== "ENOENT") throw error;
282
+ });
283
+ if (environmentPath)
284
+ await unlink(environmentPath).catch((error) => {
285
+ if (error.code !== "ENOENT") throw error;
286
+ });
287
+ process.exit(0);
288
+ }
289
+ process.once("SIGTERM", shutdown);
290
+ process.once("SIGINT", shutdown);
@@ -0,0 +1,140 @@
1
+ import { execFile } from "node:child_process";
2
+ import { access, realpath } from "node:fs/promises";
3
+ import { constants } from "node:fs";
4
+ import { dirname, delimiter, join } from "node:path";
5
+ import { homedir } from "node:os";
6
+ import { promisify } from "node:util";
7
+
8
+ const execute = promisify(execFile);
9
+ const packages = {
10
+ codex: "@openai/codex",
11
+ claude: "@anthropic-ai/claude-code",
12
+ };
13
+ export async function findCli(id) {
14
+ if (!packages[id]) throw new Error("未知后端");
15
+ const directories = [
16
+ dirname(process.execPath),
17
+ ...(process.env.PATH || "").split(delimiter),
18
+ join(homedir(), ".local", "bin"),
19
+ ];
20
+ for (const directory of new Set(directories.filter(Boolean))) {
21
+ const path = join(directory, id);
22
+ try {
23
+ await access(path, constants.X_OK);
24
+ return await realpath(path);
25
+ } catch (error) {
26
+ if (!["ENOENT", "EACCES", "ENOTDIR"].includes(error.code)) throw error;
27
+ }
28
+ }
29
+ throw new Error(
30
+ `未找到 ${id},请点击一键安装,或执行 npm install -g ${packages[id]}`,
31
+ );
32
+ }
33
+
34
+ export function createCliInstallation({
35
+ run = execute,
36
+ locate = findCli,
37
+ fetchVersion = latestVersion,
38
+ changed = () => {},
39
+ } = {}) {
40
+ let timer;
41
+ const states = new Map();
42
+ const pending = new Map();
43
+ function state(id) {
44
+ return (
45
+ states.get(id) || {
46
+ checking: true,
47
+ installed: null,
48
+ currentVersion: "",
49
+ latestVersion: "",
50
+ }
51
+ );
52
+ }
53
+ function patch(id, values) {
54
+ states.set(id, { ...state(id), ...values });
55
+ changed();
56
+ }
57
+ function refresh(id) {
58
+ if (!packages[id]) throw new Error("未知后端");
59
+ if (pending.has(id)) return pending.get(id);
60
+ const operation = (async () => {
61
+ patch(id, { checking: true, error: "", latestError: "" });
62
+ const [local, latest] = await Promise.allSettled([
63
+ (async () => {
64
+ const executable = await locate(id);
65
+ const { stdout } = await run(executable, ["--version"], {
66
+ timeout: 10000,
67
+ });
68
+ const version = stdout.match(/\b\d+\.\d+\.\d+(?:-[\w.-]+)?\b/)?.[0];
69
+ if (!version) throw new Error("无法识别 CLI 版本:" + stdout.trim());
70
+ return { executable, currentVersion: version };
71
+ })(),
72
+ fetchVersion(packages[id]),
73
+ ]);
74
+ patch(id, {
75
+ checking: false,
76
+ installed: local.status === "fulfilled",
77
+ ...(local.status === "fulfilled"
78
+ ? local.value
79
+ : { currentVersion: "", error: local.reason.message }),
80
+ ...(latest.status === "fulfilled"
81
+ ? { latestVersion: latest.value }
82
+ : { latestError: latest.reason.message }),
83
+ });
84
+ return state(id);
85
+ })().finally(() => pending.delete(id));
86
+ pending.set(id, operation);
87
+ return operation;
88
+ }
89
+ async function install(id) {
90
+ if (!packages[id]) throw new Error("未知后端");
91
+ patch(id, { installing: true, installError: "" });
92
+ try {
93
+ const npm = join(dirname(process.execPath), "npm");
94
+ await run(npm, ["install", "--global", `${packages[id]}@latest`], {
95
+ timeout: 300000,
96
+ maxBuffer: 4 * 1024 * 1024,
97
+ env: {
98
+ ...process.env,
99
+ PATH: `${dirname(process.execPath)}${delimiter}${process.env.PATH || ""}`,
100
+ },
101
+ });
102
+ if (pending.has(id)) await pending.get(id);
103
+ await refresh(id);
104
+ if (!state(id).installed) throw new Error(state(id).error);
105
+ } catch (error) {
106
+ patch(id, {
107
+ installError: `npm 安装失败:${error.stderr?.trim() || error.message}`,
108
+ });
109
+ throw error;
110
+ } finally {
111
+ patch(id, { installing: false });
112
+ }
113
+ }
114
+ function start() {
115
+ if (timer) return;
116
+ const check = () => {
117
+ for (const id of Object.keys(packages)) refresh(id).catch(() => {});
118
+ };
119
+ timer = setInterval(check, 60 * 60 * 1000);
120
+ timer.unref();
121
+ check();
122
+ }
123
+ function close() {
124
+ clearInterval(timer);
125
+ timer = undefined;
126
+ }
127
+ return { state, refresh, install, start, close };
128
+ }
129
+
130
+ async function latestVersion(packageName) {
131
+ const response = await fetch(
132
+ `https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`,
133
+ { signal: AbortSignal.timeout(15000) },
134
+ );
135
+ if (!response.ok)
136
+ throw new Error(`最新版本查询失败(HTTP ${response.status})`);
137
+ const data = await response.json();
138
+ if (typeof data.version !== "string") throw new Error("npm 版本响应格式无效");
139
+ return data.version;
140
+ }
@@ -0,0 +1,153 @@
1
+ import { referenceToolParams } from "./reference-tools.mjs";
2
+ import { join } from "node:path";
3
+ import { codexCapabilities } from "../../../../shared/backend-capabilities.mjs";
4
+ import { readAgentMessages } from "../../agent-messages.mjs";
5
+ import { createCompactions } from "../../compaction.mjs";
6
+ import { createThreadNaming, generateThreadName } from "../../thread-names.mjs";
7
+ import { createUpstream } from "./upstream.mjs";
8
+ import { createSubscriptions } from "./subscriptions.mjs";
9
+ import { createCompactionRecovery } from "./compaction-recovery.mjs";
10
+ import { createBridgeEvents } from "./events.mjs";
11
+ import { createRequestHandler } from "./requests.mjs";
12
+ import { createProductMethods } from "../../bridge/product-methods.mjs";
13
+
14
+ export function createCodexAdapter({
15
+ backend,
16
+ config,
17
+ version,
18
+ send,
19
+ broadcast,
20
+ }) {
21
+ config = { ...config, upstreamUrl: backend.url, codexHome: backend.dataDir };
22
+ const questions = new Map();
23
+ const activeTurns = new Map();
24
+ const activeThreads = new Set();
25
+ const terminals = new Map();
26
+ const compactions = createCompactions(broadcast);
27
+ const transport = createUpstream({
28
+ config,
29
+ version,
30
+ send,
31
+ onReady() {
32
+ broadcast(state());
33
+ for (const [threadId, entry] of compactions.entries)
34
+ if (entry.status === "reconnecting")
35
+ checkCompaction(threadId).catch(() => {});
36
+ },
37
+ onEvent: (message) => events.onEvent(message),
38
+ onResponse: (request, message) => events.onResponse(request, message),
39
+ onSettled: () => subscriptions.releaseUnusedThreads(),
40
+ onDisconnect() {
41
+ compactions.disconnected();
42
+ threadNaming.clear();
43
+ questions.clear();
44
+ activeTurns.clear();
45
+ activeThreads.clear();
46
+ subscriptions.reset();
47
+ for (const terminal of terminals.values()) terminal.running = false;
48
+ broadcast(state());
49
+ },
50
+ });
51
+ const nativeCall = transport.call;
52
+ transport.call = (method, params, options) =>
53
+ nativeCall(method, referenceToolParams(method, params, config), options);
54
+ const threadNaming = createThreadNaming({
55
+ call: transport.call,
56
+ generate: (params) =>
57
+ generateThreadName({
58
+ ...params,
59
+ url: config.upstreamUrl,
60
+ version: version.displayVersion,
61
+ }),
62
+ onError: (error) => console.error("Thread title:", error.message),
63
+ });
64
+ const subscriptions = createSubscriptions({
65
+ transport,
66
+ compactions,
67
+ activeTurns,
68
+ activeThreads,
69
+ });
70
+ const checkCompaction = createCompactionRecovery({
71
+ transport,
72
+ compactions,
73
+ ...subscriptions,
74
+ });
75
+ const methods = createProductMethods({
76
+ config,
77
+ projectModelsDirectory: config.configDir,
78
+ legacyProjectModelsDirectory: join(config.codexHome, "codex-web"),
79
+ call: transport.call,
80
+ activeTurns,
81
+ activeThreads,
82
+ checkCompaction,
83
+ readAgentMessages: (threadId) =>
84
+ readAgentMessages(transport.call, threadId),
85
+ broadcast,
86
+ });
87
+ const { files } = methods;
88
+ const events = createBridgeEvents({
89
+ questions,
90
+ activeTurns,
91
+ activeThreads,
92
+ terminals,
93
+ ...subscriptions,
94
+ compactions,
95
+ threadNaming,
96
+ send,
97
+ broadcast,
98
+ state,
99
+ });
100
+ const receive = createRequestHandler({
101
+ transport,
102
+ compactions,
103
+ threadNaming,
104
+ activeTurns,
105
+ activeThreads,
106
+ terminals,
107
+ questions,
108
+ undoing: files.undoing,
109
+ ...subscriptions,
110
+ ...methods,
111
+ send,
112
+ broadcast,
113
+ });
114
+
115
+ function state() {
116
+ return {
117
+ method: "lan/state",
118
+ params: {
119
+ ready: transport.ready,
120
+ questions: [...questions.values()],
121
+ activeTurns: Object.fromEntries(activeTurns),
122
+ compactions: Object.fromEntries(compactions.entries),
123
+ terminals: Object.fromEntries(terminals),
124
+ undoneFiles: [...files.undoneFiles.values()],
125
+ },
126
+ };
127
+ }
128
+ return {
129
+ capabilities: codexCapabilities,
130
+ workspaceOwner: "backend",
131
+ state,
132
+ receive(client, message) {
133
+ if (!message.method) return receive(client, message);
134
+ const { providerId, ...params } = message.params || {};
135
+ if (providerId) throw new Error("Codex 使用现有账户与模型配置");
136
+ return receive(client, {
137
+ ...message,
138
+ params: referenceToolParams(message.method, params, config),
139
+ });
140
+ },
141
+ connect: transport.connect,
142
+ releaseUnusedThreads: subscriptions.releaseUnusedThreads,
143
+ releaseClient: subscriptions.releaseClient,
144
+ close() {
145
+ threadNaming.clear();
146
+ transport.close();
147
+ subscriptions.reset();
148
+ },
149
+ get ready() {
150
+ return transport.ready;
151
+ },
152
+ };
153
+ }
@@ -0,0 +1,78 @@
1
+ import {
2
+ findCompactionTurn,
3
+ recoverCompaction,
4
+ } from "../../../../shared/compaction-state.mjs";
5
+ export function createCompactionRecovery({
6
+ transport,
7
+ compactions,
8
+ resumeForWrite,
9
+ releaseUnusedThreads,
10
+ }) {
11
+ const checkingCompactions = new Map();
12
+ function checkCompaction(threadId) {
13
+ if (checkingCompactions.has(threadId))
14
+ return checkingCompactions.get(threadId);
15
+ const entry = compactions.entries.get(threadId);
16
+ if (!compactions.busy(threadId)) return Promise.resolve(entry);
17
+ if (
18
+ [...transport.pending.values()].some(
19
+ (request) =>
20
+ request.threadId === threadId &&
21
+ request.method === "thread/compact/start",
22
+ )
23
+ )
24
+ return Promise.resolve(entry);
25
+ const current = () =>
26
+ compactions.entries.get(threadId)?.id === entry.id &&
27
+ compactions.busy(threadId);
28
+ const checking = (async () => {
29
+ try {
30
+ const { thread } = await transport.call("thread/read", {
31
+ threadId,
32
+ includeTurns: false,
33
+ });
34
+ let cursor;
35
+ const turns = [];
36
+ do {
37
+ const page = await transport.call("thread/turns/list", {
38
+ threadId,
39
+ limit: 100,
40
+ itemsView: "full",
41
+ ...(cursor ? { cursor } : {}),
42
+ });
43
+ if (!current()) return compactions.entries.get(threadId);
44
+ turns.push(...page.data);
45
+ cursor = page.nextCursor;
46
+ } while (
47
+ !findCompactionTurn(compactions.entries.get(threadId), turns) &&
48
+ cursor
49
+ );
50
+ if (!current()) return compactions.entries.get(threadId);
51
+ const recovered = recoverCompaction(
52
+ compactions.entries.get(threadId),
53
+ thread,
54
+ turns,
55
+ );
56
+ if (recovered.status === "running") {
57
+ await resumeForWrite(threadId);
58
+ }
59
+ if (current()) compactions.update(threadId, recovered);
60
+ return compactions.entries.get(threadId);
61
+ } catch (error) {
62
+ if (current())
63
+ compactions.update(threadId, {
64
+ ...compactions.entries.get(threadId),
65
+ status: "reconnecting",
66
+ error: error.message,
67
+ });
68
+ throw error;
69
+ } finally {
70
+ checkingCompactions.delete(threadId);
71
+ releaseUnusedThreads();
72
+ }
73
+ })();
74
+ checkingCompactions.set(threadId, checking);
75
+ return checking;
76
+ }
77
+ return checkCompaction;
78
+ }