@celljs/ta-host 4.7.0 → 4.9.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 (466) hide show
  1. package/README.en.md +34 -4
  2. package/README.md +33 -3
  3. package/cell.schema.json +4 -0
  4. package/cell.yml +2 -0
  5. package/esm/node/auth-server-impl.d.ts +2 -0
  6. package/esm/node/auth-server-impl.js +7 -0
  7. package/esm/node/client-tool-broker.d.ts +11 -3
  8. package/esm/node/client-tool-broker.js +23 -3
  9. package/esm/node/extension-providers.d.ts +22 -0
  10. package/esm/node/extension-providers.js +52 -0
  11. package/esm/node/host-protocol.d.ts +22 -1
  12. package/esm/node/host-protocol.js +1 -0
  13. package/esm/node/index.d.ts +6 -0
  14. package/esm/node/index.js +6 -0
  15. package/esm/node/live-run.d.ts +22 -0
  16. package/esm/node/live-run.js +58 -0
  17. package/esm/node/message-page.d.ts +17 -0
  18. package/esm/node/message-page.js +71 -0
  19. package/esm/node/package-host-extension.d.ts +4 -2
  20. package/esm/node/package-host-extension.js +4 -3
  21. package/esm/node/package-hosts.d.ts +2 -2
  22. package/esm/node/package-hosts.js +2 -0
  23. package/esm/node/package-server-impl.d.ts +9 -1
  24. package/esm/node/package-server-impl.js +16 -1
  25. package/esm/node/relay-bridge.d.ts +9 -1
  26. package/esm/node/relay-bridge.js +44 -4
  27. package/esm/node/remote-ui-context.d.ts +6 -1
  28. package/esm/node/remote-ui-context.js +31 -3
  29. package/esm/node/session-catalog.d.ts +69 -0
  30. package/esm/node/session-catalog.js +211 -0
  31. package/esm/node/session-files.d.ts +18 -0
  32. package/esm/node/session-files.js +32 -0
  33. package/esm/node/session-info-util.d.ts +4 -1
  34. package/esm/node/session-info-util.js +8 -3
  35. package/esm/node/settings-server-impl.d.ts +1 -0
  36. package/esm/node/settings-server-impl.js +8 -0
  37. package/esm/node/settings-store.d.ts +3 -1
  38. package/esm/node/settings-store.js +25 -3
  39. package/esm/node/sign-in/access-server-impl.d.ts +19 -0
  40. package/esm/node/sign-in/access-server-impl.js +82 -0
  41. package/esm/node/sign-in/access-store.d.ts +65 -0
  42. package/esm/node/sign-in/access-store.js +175 -0
  43. package/esm/node/sign-in/index.d.ts +7 -0
  44. package/esm/node/sign-in/index.js +8 -0
  45. package/esm/node/sign-in/sign-in-flow.d.ts +58 -0
  46. package/esm/node/sign-in/sign-in-flow.js +104 -0
  47. package/esm/node/sign-in/sign-in-middleware.d.ts +10 -0
  48. package/esm/node/sign-in/sign-in-middleware.js +48 -0
  49. package/esm/node/sign-in/sign-in-pages.d.ts +31 -0
  50. package/esm/node/sign-in/sign-in-pages.js +118 -0
  51. package/esm/node/sign-in/sign-in-provider.d.ts +135 -0
  52. package/esm/node/sign-in/sign-in-provider.js +225 -0
  53. package/esm/node/sign-in/ta-sign-in.d.ts +10 -0
  54. package/esm/node/sign-in/ta-sign-in.js +32 -0
  55. package/esm/node/ta-access.d.ts +7 -0
  56. package/esm/node/ta-access.js +30 -1
  57. package/esm/node/ta-server-impl.d.ts +8 -3
  58. package/esm/node/ta-server-impl.js +25 -6
  59. package/esm/node/ta-session-factory.d.ts +4 -1
  60. package/esm/node/ta-session-factory.js +30 -7
  61. package/esm/node/ta-session-registry.d.ts +2 -0
  62. package/esm/node/ta-session-registry.js +23 -3
  63. package/esm/node/ta-session.d.ts +24 -2
  64. package/esm/node/ta-session.js +84 -6
  65. package/esm/node/temporary-packages.d.ts +46 -0
  66. package/esm/node/temporary-packages.js +114 -0
  67. package/esm/node/temporary-purge.d.ts +13 -0
  68. package/esm/node/temporary-purge.js +51 -0
  69. package/esm/node/terminal-service.d.ts +18 -2
  70. package/esm/node/terminal-service.js +45 -9
  71. package/esm/node/terminal-util.d.ts +14 -0
  72. package/esm/node/terminal-util.js +30 -1
  73. package/esm/node/web-extension-catalog.d.ts +28 -1
  74. package/esm/node/web-extension-catalog.js +173 -5
  75. package/esm/node/web-extension-util.d.ts +5 -1
  76. package/esm/node/web-extension-util.js +36 -5
  77. package/esm/node/workspace-protocol.d.ts +2 -0
  78. package/esm/node/workspace-server-impl.d.ts +2 -1
  79. package/esm/node/workspace-server-impl.js +13 -1
  80. package/esm/node/workspace-service.d.ts +1 -0
  81. package/esm/node/workspace-service.js +13 -1
  82. package/lib/node/auth-server-impl.d.ts +2 -0
  83. package/lib/node/auth-server-impl.js +7 -0
  84. package/lib/node/client-tool-broker.d.ts +11 -3
  85. package/lib/node/client-tool-broker.js +23 -3
  86. package/lib/node/extension-providers.d.ts +23 -0
  87. package/lib/node/extension-providers.js +55 -0
  88. package/lib/node/host-protocol.d.ts +22 -1
  89. package/lib/node/host-protocol.js +2 -1
  90. package/lib/node/index.d.ts +6 -0
  91. package/lib/node/index.js +6 -0
  92. package/lib/node/live-run.d.ts +23 -0
  93. package/lib/node/live-run.js +62 -0
  94. package/lib/node/message-page.d.ts +18 -0
  95. package/lib/node/message-page.js +74 -0
  96. package/lib/node/package-host-extension.d.ts +4 -2
  97. package/lib/node/package-host-extension.js +4 -3
  98. package/lib/node/package-hosts.d.ts +2 -2
  99. package/lib/node/package-hosts.js +2 -0
  100. package/lib/node/package-server-impl.d.ts +9 -1
  101. package/lib/node/package-server-impl.js +15 -0
  102. package/lib/node/relay-bridge.d.ts +9 -1
  103. package/lib/node/relay-bridge.js +43 -3
  104. package/lib/node/remote-ui-context.d.ts +6 -1
  105. package/lib/node/remote-ui-context.js +31 -3
  106. package/lib/node/session-catalog.d.ts +70 -0
  107. package/lib/node/session-catalog.js +214 -0
  108. package/lib/node/session-files.d.ts +19 -0
  109. package/lib/node/session-files.js +36 -0
  110. package/lib/node/session-info-util.d.ts +4 -1
  111. package/lib/node/session-info-util.js +7 -2
  112. package/lib/node/settings-server-impl.d.ts +1 -0
  113. package/lib/node/settings-server-impl.js +8 -0
  114. package/lib/node/settings-store.d.ts +3 -1
  115. package/lib/node/settings-store.js +25 -3
  116. package/lib/node/sign-in/access-server-impl.d.ts +20 -0
  117. package/lib/node/sign-in/access-server-impl.js +85 -0
  118. package/lib/node/sign-in/access-store.d.ts +66 -0
  119. package/lib/node/sign-in/access-store.js +179 -0
  120. package/lib/node/sign-in/index.d.ts +8 -0
  121. package/lib/node/sign-in/index.js +24 -0
  122. package/lib/node/sign-in/sign-in-flow.d.ts +59 -0
  123. package/lib/node/sign-in/sign-in-flow.js +108 -0
  124. package/lib/node/sign-in/sign-in-middleware.d.ts +11 -0
  125. package/lib/node/sign-in/sign-in-middleware.js +51 -0
  126. package/lib/node/sign-in/sign-in-pages.d.ts +32 -0
  127. package/lib/node/sign-in/sign-in-pages.js +121 -0
  128. package/lib/node/sign-in/sign-in-provider.d.ts +136 -0
  129. package/lib/node/sign-in/sign-in-provider.js +232 -0
  130. package/lib/node/sign-in/ta-sign-in.d.ts +11 -0
  131. package/lib/node/sign-in/ta-sign-in.js +35 -0
  132. package/lib/node/ta-access.d.ts +7 -0
  133. package/lib/node/ta-access.js +30 -1
  134. package/lib/node/ta-server-impl.d.ts +8 -3
  135. package/lib/node/ta-server-impl.js +24 -5
  136. package/lib/node/ta-session-factory.d.ts +4 -1
  137. package/lib/node/ta-session-factory.js +30 -7
  138. package/lib/node/ta-session-registry.d.ts +2 -0
  139. package/lib/node/ta-session-registry.js +23 -3
  140. package/lib/node/ta-session.d.ts +24 -2
  141. package/lib/node/ta-session.js +84 -6
  142. package/lib/node/temporary-packages.d.ts +47 -0
  143. package/lib/node/temporary-packages.js +118 -0
  144. package/lib/node/temporary-purge.d.ts +14 -0
  145. package/lib/node/temporary-purge.js +54 -0
  146. package/lib/node/terminal-service.d.ts +18 -2
  147. package/lib/node/terminal-service.js +44 -8
  148. package/lib/node/terminal-util.d.ts +14 -0
  149. package/lib/node/terminal-util.js +30 -1
  150. package/lib/node/web-extension-catalog.d.ts +28 -1
  151. package/lib/node/web-extension-catalog.js +172 -4
  152. package/lib/node/web-extension-util.d.ts +5 -1
  153. package/lib/node/web-extension-util.js +36 -5
  154. package/lib/node/workspace-protocol.d.ts +2 -0
  155. package/lib/node/workspace-server-impl.d.ts +2 -1
  156. package/lib/node/workspace-server-impl.js +12 -0
  157. package/lib/node/workspace-service.d.ts +1 -0
  158. package/lib/node/workspace-service.js +13 -1
  159. package/package.json +17 -12
  160. package/esm/node/auth-server-impl.js.map +0 -1
  161. package/esm/node/client-channel.js.map +0 -1
  162. package/esm/node/client-tool-broker.js.map +0 -1
  163. package/esm/node/event-log.js.map +0 -1
  164. package/esm/node/exec-environment-factory.js.map +0 -1
  165. package/esm/node/extension-data-notifier.js.map +0 -1
  166. package/esm/node/extension-data.js.map +0 -1
  167. package/esm/node/host-protocol.js.map +0 -1
  168. package/esm/node/index.js.map +0 -1
  169. package/esm/node/module.js.map +0 -1
  170. package/esm/node/package-host-extension.js.map +0 -1
  171. package/esm/node/package-hosts.js.map +0 -1
  172. package/esm/node/package-server-impl.js.map +0 -1
  173. package/esm/node/package-switch.js.map +0 -1
  174. package/esm/node/receipt-book.js.map +0 -1
  175. package/esm/node/relay-bridge.js.map +0 -1
  176. package/esm/node/remote/index.js.map +0 -1
  177. package/esm/node/remote/pi-directories.js.map +0 -1
  178. package/esm/node/remote/port-forwards.js.map +0 -1
  179. package/esm/node/remote/remote-hosts.js.map +0 -1
  180. package/esm/node/remote/remote-protocol.js.map +0 -1
  181. package/esm/node/remote/remote-server-impl.js.map +0 -1
  182. package/esm/node/remote-ui-context.js.map +0 -1
  183. package/esm/node/session-info-util.js.map +0 -1
  184. package/esm/node/session-storage/file-session-storage.js.map +0 -1
  185. package/esm/node/session-storage/index.js.map +0 -1
  186. package/esm/node/session-storage/session-storage-protocol.js.map +0 -1
  187. package/esm/node/session-storage/stored-session.js.map +0 -1
  188. package/esm/node/settings-server-impl.js.map +0 -1
  189. package/esm/node/settings-store.js.map +0 -1
  190. package/esm/node/ta-access.js.map +0 -1
  191. package/esm/node/ta-errors.js.map +0 -1
  192. package/esm/node/ta-event-util.js.map +0 -1
  193. package/esm/node/ta-server-impl.js.map +0 -1
  194. package/esm/node/ta-session-factory.js.map +0 -1
  195. package/esm/node/ta-session-registry.js.map +0 -1
  196. package/esm/node/ta-session.js.map +0 -1
  197. package/esm/node/terminal-protocol.js.map +0 -1
  198. package/esm/node/terminal-service.js.map +0 -1
  199. package/esm/node/terminal-util.js.map +0 -1
  200. package/esm/node/web-extension-catalog.js.map +0 -1
  201. package/esm/node/web-extension-util.js.map +0 -1
  202. package/esm/node/working-directory.js.map +0 -1
  203. package/esm/node/workspace-files.js.map +0 -1
  204. package/esm/node/workspace-protocol.js.map +0 -1
  205. package/esm/node/workspace-server-impl.js.map +0 -1
  206. package/esm/node/workspace-service.js.map +0 -1
  207. package/esm/node/workspace-util.js.map +0 -1
  208. package/lib/node/auth-server-impl.d.ts.map +0 -1
  209. package/lib/node/auth-server-impl.js.map +0 -1
  210. package/lib/node/auth-server-impl.spec.d.ts +0 -2
  211. package/lib/node/auth-server-impl.spec.d.ts.map +0 -1
  212. package/lib/node/auth-server-impl.spec.js +0 -47
  213. package/lib/node/auth-server-impl.spec.js.map +0 -1
  214. package/lib/node/client-channel.d.ts.map +0 -1
  215. package/lib/node/client-channel.js.map +0 -1
  216. package/lib/node/client-channel.spec.d.ts +0 -2
  217. package/lib/node/client-channel.spec.d.ts.map +0 -1
  218. package/lib/node/client-channel.spec.js +0 -106
  219. package/lib/node/client-channel.spec.js.map +0 -1
  220. package/lib/node/client-tool-broker.d.ts.map +0 -1
  221. package/lib/node/client-tool-broker.js.map +0 -1
  222. package/lib/node/client-tool-broker.spec.d.ts +0 -2
  223. package/lib/node/client-tool-broker.spec.d.ts.map +0 -1
  224. package/lib/node/client-tool-broker.spec.js +0 -49
  225. package/lib/node/client-tool-broker.spec.js.map +0 -1
  226. package/lib/node/event-log.d.ts.map +0 -1
  227. package/lib/node/event-log.js.map +0 -1
  228. package/lib/node/event-log.spec.d.ts +0 -2
  229. package/lib/node/event-log.spec.d.ts.map +0 -1
  230. package/lib/node/event-log.spec.js +0 -48
  231. package/lib/node/event-log.spec.js.map +0 -1
  232. package/lib/node/exec-environment-factory.d.ts.map +0 -1
  233. package/lib/node/exec-environment-factory.js.map +0 -1
  234. package/lib/node/extension-data-notifier.d.ts.map +0 -1
  235. package/lib/node/extension-data-notifier.js.map +0 -1
  236. package/lib/node/extension-data-notifier.spec.d.ts +0 -2
  237. package/lib/node/extension-data-notifier.spec.d.ts.map +0 -1
  238. package/lib/node/extension-data-notifier.spec.js +0 -35
  239. package/lib/node/extension-data-notifier.spec.js.map +0 -1
  240. package/lib/node/extension-data.d.ts.map +0 -1
  241. package/lib/node/extension-data.js.map +0 -1
  242. package/lib/node/extension-data.spec.d.ts +0 -2
  243. package/lib/node/extension-data.spec.d.ts.map +0 -1
  244. package/lib/node/extension-data.spec.js +0 -99
  245. package/lib/node/extension-data.spec.js.map +0 -1
  246. package/lib/node/host-protocol.d.ts.map +0 -1
  247. package/lib/node/host-protocol.js.map +0 -1
  248. package/lib/node/index.d.ts.map +0 -1
  249. package/lib/node/index.js.map +0 -1
  250. package/lib/node/module.d.ts.map +0 -1
  251. package/lib/node/module.js.map +0 -1
  252. package/lib/node/package-host-extension.d.ts.map +0 -1
  253. package/lib/node/package-host-extension.js.map +0 -1
  254. package/lib/node/package-hosts.d.ts.map +0 -1
  255. package/lib/node/package-hosts.js.map +0 -1
  256. package/lib/node/package-hosts.spec.d.ts +0 -2
  257. package/lib/node/package-hosts.spec.d.ts.map +0 -1
  258. package/lib/node/package-hosts.spec.js +0 -53
  259. package/lib/node/package-hosts.spec.js.map +0 -1
  260. package/lib/node/package-server-impl.d.ts.map +0 -1
  261. package/lib/node/package-server-impl.js.map +0 -1
  262. package/lib/node/package-switch.d.ts.map +0 -1
  263. package/lib/node/package-switch.js.map +0 -1
  264. package/lib/node/receipt-book.d.ts.map +0 -1
  265. package/lib/node/receipt-book.js.map +0 -1
  266. package/lib/node/receipt-book.spec.d.ts +0 -2
  267. package/lib/node/receipt-book.spec.d.ts.map +0 -1
  268. package/lib/node/receipt-book.spec.js +0 -39
  269. package/lib/node/receipt-book.spec.js.map +0 -1
  270. package/lib/node/relay-bridge.d.ts.map +0 -1
  271. package/lib/node/relay-bridge.js.map +0 -1
  272. package/lib/node/remote/index.d.ts.map +0 -1
  273. package/lib/node/remote/index.js.map +0 -1
  274. package/lib/node/remote/pi-directories.d.ts.map +0 -1
  275. package/lib/node/remote/pi-directories.js.map +0 -1
  276. package/lib/node/remote/port-forwards.d.ts.map +0 -1
  277. package/lib/node/remote/port-forwards.js.map +0 -1
  278. package/lib/node/remote/remote-hosts.d.ts.map +0 -1
  279. package/lib/node/remote/remote-hosts.js.map +0 -1
  280. package/lib/node/remote/remote-protocol.d.ts.map +0 -1
  281. package/lib/node/remote/remote-protocol.js.map +0 -1
  282. package/lib/node/remote/remote-server-impl.d.ts.map +0 -1
  283. package/lib/node/remote/remote-server-impl.js.map +0 -1
  284. package/lib/node/remote/remote.spec.d.ts +0 -2
  285. package/lib/node/remote/remote.spec.d.ts.map +0 -1
  286. package/lib/node/remote/remote.spec.js +0 -130
  287. package/lib/node/remote/remote.spec.js.map +0 -1
  288. package/lib/node/remote-ui-context.d.ts.map +0 -1
  289. package/lib/node/remote-ui-context.js.map +0 -1
  290. package/lib/node/remote-ui-context.spec.d.ts +0 -2
  291. package/lib/node/remote-ui-context.spec.d.ts.map +0 -1
  292. package/lib/node/remote-ui-context.spec.js +0 -62
  293. package/lib/node/remote-ui-context.spec.js.map +0 -1
  294. package/lib/node/session-info-util.d.ts.map +0 -1
  295. package/lib/node/session-info-util.js.map +0 -1
  296. package/lib/node/session-info-util.spec.d.ts +0 -2
  297. package/lib/node/session-info-util.spec.d.ts.map +0 -1
  298. package/lib/node/session-info-util.spec.js +0 -22
  299. package/lib/node/session-info-util.spec.js.map +0 -1
  300. package/lib/node/session-storage/file-session-storage.d.ts.map +0 -1
  301. package/lib/node/session-storage/file-session-storage.js.map +0 -1
  302. package/lib/node/session-storage/file-session-storage.spec.d.ts +0 -2
  303. package/lib/node/session-storage/file-session-storage.spec.d.ts.map +0 -1
  304. package/lib/node/session-storage/file-session-storage.spec.js +0 -70
  305. package/lib/node/session-storage/file-session-storage.spec.js.map +0 -1
  306. package/lib/node/session-storage/index.d.ts.map +0 -1
  307. package/lib/node/session-storage/index.js.map +0 -1
  308. package/lib/node/session-storage/session-storage-protocol.d.ts.map +0 -1
  309. package/lib/node/session-storage/session-storage-protocol.js.map +0 -1
  310. package/lib/node/session-storage/stored-session.d.ts.map +0 -1
  311. package/lib/node/session-storage/stored-session.js.map +0 -1
  312. package/lib/node/session-storage/stored-session.spec.d.ts +0 -2
  313. package/lib/node/session-storage/stored-session.spec.d.ts.map +0 -1
  314. package/lib/node/session-storage/stored-session.spec.js +0 -73
  315. package/lib/node/session-storage/stored-session.spec.js.map +0 -1
  316. package/lib/node/settings-server-impl.d.ts.map +0 -1
  317. package/lib/node/settings-server-impl.js.map +0 -1
  318. package/lib/node/settings-store.d.ts.map +0 -1
  319. package/lib/node/settings-store.js.map +0 -1
  320. package/lib/node/settings-store.spec.d.ts +0 -2
  321. package/lib/node/settings-store.spec.d.ts.map +0 -1
  322. package/lib/node/settings-store.spec.js +0 -146
  323. package/lib/node/settings-store.spec.js.map +0 -1
  324. package/lib/node/ta-access.d.ts.map +0 -1
  325. package/lib/node/ta-access.js.map +0 -1
  326. package/lib/node/ta-access.spec.d.ts +0 -2
  327. package/lib/node/ta-access.spec.d.ts.map +0 -1
  328. package/lib/node/ta-access.spec.js +0 -33
  329. package/lib/node/ta-access.spec.js.map +0 -1
  330. package/lib/node/ta-errors.d.ts.map +0 -1
  331. package/lib/node/ta-errors.js.map +0 -1
  332. package/lib/node/ta-errors.spec.d.ts +0 -2
  333. package/lib/node/ta-errors.spec.d.ts.map +0 -1
  334. package/lib/node/ta-errors.spec.js +0 -25
  335. package/lib/node/ta-errors.spec.js.map +0 -1
  336. package/lib/node/ta-event-util.d.ts.map +0 -1
  337. package/lib/node/ta-event-util.js.map +0 -1
  338. package/lib/node/ta-event-util.spec.d.ts +0 -2
  339. package/lib/node/ta-event-util.spec.d.ts.map +0 -1
  340. package/lib/node/ta-event-util.spec.js +0 -28
  341. package/lib/node/ta-event-util.spec.js.map +0 -1
  342. package/lib/node/ta-server-impl.d.ts.map +0 -1
  343. package/lib/node/ta-server-impl.js.map +0 -1
  344. package/lib/node/ta-session-factory.d.ts.map +0 -1
  345. package/lib/node/ta-session-factory.js.map +0 -1
  346. package/lib/node/ta-session-registry.d.ts.map +0 -1
  347. package/lib/node/ta-session-registry.js.map +0 -1
  348. package/lib/node/ta-session.d.ts.map +0 -1
  349. package/lib/node/ta-session.js.map +0 -1
  350. package/lib/node/terminal-protocol.d.ts.map +0 -1
  351. package/lib/node/terminal-protocol.js.map +0 -1
  352. package/lib/node/terminal-service.d.ts.map +0 -1
  353. package/lib/node/terminal-service.js.map +0 -1
  354. package/lib/node/terminal-service.spec.d.ts +0 -2
  355. package/lib/node/terminal-service.spec.d.ts.map +0 -1
  356. package/lib/node/terminal-service.spec.js +0 -79
  357. package/lib/node/terminal-service.spec.js.map +0 -1
  358. package/lib/node/terminal-util.d.ts.map +0 -1
  359. package/lib/node/terminal-util.js.map +0 -1
  360. package/lib/node/terminal-util.spec.d.ts +0 -2
  361. package/lib/node/terminal-util.spec.d.ts.map +0 -1
  362. package/lib/node/terminal-util.spec.js +0 -71
  363. package/lib/node/terminal-util.spec.js.map +0 -1
  364. package/lib/node/web-extension-catalog.d.ts.map +0 -1
  365. package/lib/node/web-extension-catalog.js.map +0 -1
  366. package/lib/node/web-extension-catalog.spec.d.ts +0 -2
  367. package/lib/node/web-extension-catalog.spec.d.ts.map +0 -1
  368. package/lib/node/web-extension-catalog.spec.js +0 -157
  369. package/lib/node/web-extension-catalog.spec.js.map +0 -1
  370. package/lib/node/web-extension-util.d.ts.map +0 -1
  371. package/lib/node/web-extension-util.js.map +0 -1
  372. package/lib/node/working-directory.d.ts.map +0 -1
  373. package/lib/node/working-directory.js.map +0 -1
  374. package/lib/node/workspace-files.d.ts.map +0 -1
  375. package/lib/node/workspace-files.js.map +0 -1
  376. package/lib/node/workspace-files.spec.d.ts +0 -2
  377. package/lib/node/workspace-files.spec.d.ts.map +0 -1
  378. package/lib/node/workspace-files.spec.js +0 -133
  379. package/lib/node/workspace-files.spec.js.map +0 -1
  380. package/lib/node/workspace-protocol.d.ts.map +0 -1
  381. package/lib/node/workspace-protocol.js.map +0 -1
  382. package/lib/node/workspace-server-impl.d.ts.map +0 -1
  383. package/lib/node/workspace-server-impl.js.map +0 -1
  384. package/lib/node/workspace-service.d.ts.map +0 -1
  385. package/lib/node/workspace-service.js.map +0 -1
  386. package/lib/node/workspace-service.spec.d.ts +0 -2
  387. package/lib/node/workspace-service.spec.d.ts.map +0 -1
  388. package/lib/node/workspace-service.spec.js +0 -104
  389. package/lib/node/workspace-service.spec.js.map +0 -1
  390. package/lib/node/workspace-util.d.ts.map +0 -1
  391. package/lib/node/workspace-util.js.map +0 -1
  392. package/lib/node/workspace-util.spec.d.ts +0 -2
  393. package/lib/node/workspace-util.spec.d.ts.map +0 -1
  394. package/lib/node/workspace-util.spec.js +0 -44
  395. package/lib/node/workspace-util.spec.js.map +0 -1
  396. package/src/node/auth-server-impl.spec.ts +0 -49
  397. package/src/node/auth-server-impl.ts +0 -252
  398. package/src/node/client-channel.spec.ts +0 -117
  399. package/src/node/client-channel.ts +0 -94
  400. package/src/node/client-tool-broker.spec.ts +0 -53
  401. package/src/node/client-tool-broker.ts +0 -106
  402. package/src/node/event-log.spec.ts +0 -52
  403. package/src/node/event-log.ts +0 -59
  404. package/src/node/exec-environment-factory.ts +0 -66
  405. package/src/node/extension-data-notifier.spec.ts +0 -34
  406. package/src/node/extension-data-notifier.ts +0 -124
  407. package/src/node/extension-data.spec.ts +0 -105
  408. package/src/node/extension-data.ts +0 -180
  409. package/src/node/host-protocol.ts +0 -62
  410. package/src/node/index.ts +0 -37
  411. package/src/node/module.ts +0 -4
  412. package/src/node/package-host-extension.ts +0 -20
  413. package/src/node/package-hosts.spec.ts +0 -54
  414. package/src/node/package-hosts.ts +0 -202
  415. package/src/node/package-server-impl.ts +0 -87
  416. package/src/node/package-switch.ts +0 -80
  417. package/src/node/receipt-book.spec.ts +0 -41
  418. package/src/node/receipt-book.ts +0 -40
  419. package/src/node/relay-bridge.ts +0 -94
  420. package/src/node/remote/index.ts +0 -5
  421. package/src/node/remote/pi-directories.ts +0 -49
  422. package/src/node/remote/port-forwards.ts +0 -148
  423. package/src/node/remote/remote-hosts.ts +0 -170
  424. package/src/node/remote/remote-protocol.ts +0 -57
  425. package/src/node/remote/remote-server-impl.ts +0 -60
  426. package/src/node/remote/remote.spec.ts +0 -142
  427. package/src/node/remote-ui-context.spec.ts +0 -68
  428. package/src/node/remote-ui-context.ts +0 -168
  429. package/src/node/session-info-util.spec.ts +0 -23
  430. package/src/node/session-info-util.ts +0 -55
  431. package/src/node/session-storage/file-session-storage.spec.ts +0 -72
  432. package/src/node/session-storage/file-session-storage.ts +0 -145
  433. package/src/node/session-storage/index.ts +0 -3
  434. package/src/node/session-storage/session-storage-protocol.ts +0 -81
  435. package/src/node/session-storage/stored-session.spec.ts +0 -80
  436. package/src/node/session-storage/stored-session.ts +0 -149
  437. package/src/node/settings-server-impl.ts +0 -33
  438. package/src/node/settings-store.spec.ts +0 -156
  439. package/src/node/settings-store.ts +0 -314
  440. package/src/node/ta-access.spec.ts +0 -36
  441. package/src/node/ta-access.ts +0 -156
  442. package/src/node/ta-errors.spec.ts +0 -25
  443. package/src/node/ta-errors.ts +0 -75
  444. package/src/node/ta-event-util.spec.ts +0 -29
  445. package/src/node/ta-event-util.ts +0 -23
  446. package/src/node/ta-server-impl.ts +0 -341
  447. package/src/node/ta-session-factory.ts +0 -203
  448. package/src/node/ta-session-registry.ts +0 -75
  449. package/src/node/ta-session.ts +0 -240
  450. package/src/node/terminal-protocol.ts +0 -18
  451. package/src/node/terminal-service.spec.ts +0 -84
  452. package/src/node/terminal-service.ts +0 -259
  453. package/src/node/terminal-util.spec.ts +0 -78
  454. package/src/node/terminal-util.ts +0 -166
  455. package/src/node/web-extension-catalog.spec.ts +0 -172
  456. package/src/node/web-extension-catalog.ts +0 -177
  457. package/src/node/web-extension-util.ts +0 -144
  458. package/src/node/working-directory.ts +0 -71
  459. package/src/node/workspace-files.spec.ts +0 -145
  460. package/src/node/workspace-files.ts +0 -256
  461. package/src/node/workspace-protocol.ts +0 -22
  462. package/src/node/workspace-server-impl.ts +0 -90
  463. package/src/node/workspace-service.spec.ts +0 -113
  464. package/src/node/workspace-service.ts +0 -223
  465. package/src/node/workspace-util.spec.ts +0 -47
  466. package/src/node/workspace-util.ts +0 -103
@@ -1,240 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import type { SessionLock } from '@celljs/ta-harness';
3
- import type {
4
- RpcExtensionUIResponse,
5
- TaAttachResult,
6
- TaClientToolResult,
7
- TaEvent,
8
- TaNavigateResult,
9
- TaPromptInput,
10
- TaPromptReceipt,
11
- TaSessionInfo,
12
- } from '@celljs/ta-protocol';
13
- import type { ClientChannel } from './client-channel';
14
- import type { ClientToolBroker } from './client-tool-broker';
15
- import { EventLog } from './event-log';
16
- import type { TaHostOptions } from './host-protocol';
17
- import { ReceiptBook } from './receipt-book';
18
- import { RemoteUiContext } from './remote-ui-context';
19
- import { SessionInfoUtil } from './session-info-util';
20
- import { TaEventUtil } from './ta-event-util';
21
-
22
- type AgentSessionRuntime = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).AgentSessionRuntime;
23
- type AgentSession = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).AgentSession;
24
- type PromptDisposition = 'started' | 'queued' | 'handled';
25
-
26
- export interface TaSessionContext {
27
- runtime: AgentSessionRuntime;
28
- lock: SessionLock;
29
- /** The tools of the session that its clients run. */
30
- clientTools: ClientToolBroker;
31
- options: TaHostOptions;
32
- /** The session should end: it has been idle, or an extension asked. */
33
- requestClose(session: TaSession): void;
34
- /** TaOpenSessionOptions.group. */
35
- group?: string;
36
- /** The location of the directory pi works in (PiDirectories.fromPi); default: that directory. */
37
- locate?(cwd: string): string;
38
- }
39
-
40
- /**
41
- * One open session of `ta serve`: pi's runtime, its event log, and the clients attached to it. Its id
42
- * stays the same while the runtime moves between conversations.
43
- */
44
- export class TaSession {
45
- readonly id = randomUUID();
46
- readonly createdAt = Date.now();
47
- readonly ui: RemoteUiContext;
48
- readonly runtime: AgentSessionRuntime;
49
- protected readonly log: EventLog;
50
- protected readonly receipts = new ReceiptBook();
51
- protected readonly channels = new Set<ClientChannel>();
52
- protected unsubscribe?: () => void;
53
- protected idleTimer?: ReturnType<typeof setTimeout>;
54
- protected started = false;
55
-
56
- constructor(protected readonly context: TaSessionContext) {
57
- this.runtime = context.runtime;
58
- this.log = new EventLog(this.id, context.options.eventBufferBytes);
59
- this.ui = new RemoteUiContext(event => this.publish(event));
60
- context.clientTools.connect(event => this.publish(event));
61
- }
62
-
63
- get pi(): AgentSession {
64
- return this.runtime.session;
65
- }
66
-
67
- /** Where the session works, as clients name it: a path, or an `ssh://` location. */
68
- get cwd(): string {
69
- return this.context.locate ? this.context.locate(this.runtime.cwd) : this.runtime.cwd;
70
- }
71
-
72
- async start(): Promise<void> {
73
- this.runtime.setRebindSession(() => this.bind());
74
- await this.bind();
75
- this.started = true;
76
- this.watchIdle();
77
- }
78
-
79
- info(): TaSessionInfo {
80
- const { pi } = this;
81
- // Without a model pi's agent holds a placeholder that no runtime knows.
82
- const model = pi.model && pi.modelRuntime.getModel(pi.model.provider, pi.model.id);
83
- return {
84
- sessionId: this.id,
85
- piSessionId: pi.sessionId,
86
- cwd: this.cwd,
87
- sessionFile: pi.sessionFile,
88
- sessionName: pi.sessionName,
89
- firstMessage: SessionInfoUtil.firstMessage(pi.messages),
90
- model: model ? `${model.provider}/${model.id}` : undefined,
91
- isStreaming: pi.isStreaming,
92
- messageCount: pi.messages.length,
93
- attached: this.channels.size,
94
- createdAt: this.createdAt,
95
- updatedAt: SessionInfoUtil.updatedAt(pi.messages, this.createdAt),
96
- group: this.context.group,
97
- };
98
- }
99
-
100
- attach(channel: ClientChannel, afterSeq?: number): TaAttachResult {
101
- this.channels.add(channel);
102
- this.watchIdle();
103
- const { events, gap } = afterSeq === undefined ? { events: [], gap: false } : this.log.since(afterSeq);
104
- return {
105
- info: this.info(),
106
- events,
107
- pendingUi: this.ui.pendingRequests,
108
- pendingClientTools: this.context.clientTools.pendingRequests,
109
- lastSeq: this.log.lastSeq,
110
- gap,
111
- };
112
- }
113
-
114
- detach(channel: ClientChannel): void {
115
- if (this.channels.delete(channel)) {
116
- this.watchIdle();
117
- }
118
- }
119
-
120
- respondUi(response: RpcExtensionUIResponse): boolean {
121
- return this.ui.respond(response);
122
- }
123
-
124
- respondClientTool(result: TaClientToolResult): boolean {
125
- return this.context.clientTools.respond(result);
126
- }
127
-
128
- prompt(input: TaPromptInput): Promise<TaPromptReceipt> {
129
- return this.accept(
130
- input,
131
- () =>
132
- new Promise<PromptDisposition>((resolve, reject) => {
133
- this.pi
134
- .prompt(input.message, {
135
- images: input.images,
136
- streamingBehavior: input.streamingBehavior ?? 'followUp',
137
- source: 'rpc',
138
- preflightResult: resolve,
139
- })
140
- // After the preflight, failures of the run reach the clients as events.
141
- .then(() => resolve('handled'), reject);
142
- }),
143
- );
144
- }
145
-
146
- steer(input: TaPromptInput): Promise<TaPromptReceipt> {
147
- return this.accept(input, () => this.pi.steer(input.message, input.images, { source: 'rpc' }));
148
- }
149
-
150
- followUp(input: TaPromptInput): Promise<TaPromptReceipt> {
151
- return this.accept(input, () => this.pi.followUp(input.message, input.images, { source: 'rpc' }));
152
- }
153
-
154
- /** pi's runtime says nothing of a move in the tree: the clients are told to read the conversation again. */
155
- async navigateTree(targetId: string, options?: Parameters<AgentSession['navigateTree']>[1]): Promise<TaNavigateResult> {
156
- const { cancelled, editorText } = await this.pi.navigateTree(targetId, options);
157
- if (!cancelled) {
158
- this.publish({ type: 'session_replaced', info: this.info() });
159
- }
160
- return { cancelled, editorText };
161
- }
162
-
163
- async close(): Promise<void> {
164
- clearTimeout(this.idleTimer);
165
- this.ui.cancelAll();
166
- this.context.clientTools.cancelAll();
167
- this.publish({ type: 'session_closed' });
168
- this.channels.clear();
169
- this.unsubscribe?.();
170
- if (this.pi.isStreaming) {
171
- await this.pi.abort();
172
- }
173
- await this.runtime.dispose();
174
- this.context.lock.releaseAll();
175
- }
176
-
177
- protected async accept(input: TaPromptInput, run: () => Promise<PromptDisposition>): Promise<TaPromptReceipt> {
178
- const duplicate = this.receipts.take(input);
179
- if (duplicate) {
180
- return duplicate;
181
- }
182
- try {
183
- const disposition = await run();
184
- return { clientMessageId: input.clientMessageId, status: disposition === 'queued' ? 'queued' : 'accepted' };
185
- } catch (error) {
186
- this.receipts.forget(input.clientMessageId);
187
- throw error;
188
- }
189
- }
190
-
191
- /** Connects this object to the session the runtime has now: at the start and after each replacement. */
192
- protected async bind(): Promise<void> {
193
- this.unsubscribe?.();
194
- const { pi, runtime } = this;
195
- await pi.bindExtensions({
196
- uiContext: this.ui,
197
- mode: 'rpc',
198
- commandContextActions: {
199
- waitForIdle: () => pi.waitForIdle(),
200
- newSession: options => runtime.newSession(options),
201
- fork: async (entryId, options) => ({ cancelled: (await runtime.fork(entryId, options)).cancelled }),
202
- navigateTree: async (targetId, options) => ({ cancelled: (await this.navigateTree(targetId, options)).cancelled }),
203
- switchSession: (sessionPath, options) => runtime.switchSession(sessionPath, options),
204
- reload: () => pi.reload(),
205
- },
206
- shutdownHandler: () => this.context.requestClose(this),
207
- onError: error => this.publish({ type: 'extension_error', extensionPath: error.extensionPath, event: error.event, error: error.error }),
208
- });
209
- this.unsubscribe = pi.subscribe(event => {
210
- this.publish(TaEventUtil.toWire(event));
211
- if (event.type === 'agent_settled') {
212
- this.watchIdle();
213
- }
214
- });
215
- if (this.started) {
216
- this.publish({ type: 'session_replaced', info: this.info() });
217
- }
218
- }
219
-
220
- protected publish(event: TaEvent): void {
221
- const logged = this.log.append(event);
222
- for (const channel of this.channels) {
223
- channel.send(logged);
224
- }
225
- }
226
-
227
- protected isIdle(): boolean {
228
- return this.channels.size === 0 && !this.pi.isStreaming && this.ui.pendingRequests.length === 0;
229
- }
230
-
231
- /** One timer per session, armed only when nothing is attached: an idle server does no work. */
232
- protected watchIdle(): void {
233
- clearTimeout(this.idleTimer);
234
- this.idleTimer = undefined;
235
- if (this.isIdle()) {
236
- this.idleTimer = setTimeout(() => this.isIdle() && this.context.requestClose(this), this.context.options.idleTimeoutMs);
237
- this.idleTimer.unref();
238
- }
239
- }
240
- }
@@ -1,18 +0,0 @@
1
- import type { RpcConnection } from '@celljs/rpc/lib/node';
2
- import type { TaOpenTerminalOptions, TaTerminalInfo } from '@celljs/ta-protocol';
3
-
4
- export const TaTerminals = Symbol('TaTerminals');
5
-
6
- /**
7
- * The shells of the web client's terminal. Each belongs to the connection that opened it and sends it
8
- * its output (TaClient.onTerminalData). When that connection drops, the shell waits 30 s for another
9
- * to take it (listTerminals, writeTerminal or resizeTerminal) and keeps its output meanwhile; then it ends.
10
- */
11
- export interface TaTerminals {
12
- open(connection: RpcConnection, options: TaOpenTerminalOptions & { cwd: string }): Promise<TaTerminalInfo>;
13
- write(connection: RpcConnection, terminalId: string, data: string): void;
14
- resize(connection: RpcConnection, terminalId: string, cols: number, rows: number): Promise<void>;
15
- close(connection: RpcConnection, terminalId: string): Promise<void>;
16
- list(connection: RpcConnection): TaTerminalInfo[];
17
- closeAll(): Promise<void>;
18
- }
@@ -1,84 +0,0 @@
1
- import { afterEach, describe, expect, it } from 'bun:test';
2
- import { realpathSync } from 'node:fs';
3
- import { tmpdir } from 'node:os';
4
- import type { RpcConnection } from '@celljs/rpc/lib/node';
5
- import { LocalExecEnvironment } from '@celljs/ta-exec';
6
- import { DefaultTaTerminals } from './terminal-service';
7
-
8
- /** A connection that keeps what the shells sent it. */
9
- class FakeConnection {
10
- readonly id = String(Math.random());
11
- closed = false;
12
- output = '';
13
- exitCode?: number;
14
- protected readonly closeListeners: (() => void)[] = [];
15
-
16
- client() {
17
- return {
18
- onTerminalData: async (_terminalId: string, data: string, exitCode?: number) => {
19
- this.output += data;
20
- this.exitCode ??= exitCode;
21
- },
22
- };
23
- }
24
-
25
- onClose(listener: () => void) {
26
- this.closeListeners.push(listener);
27
- return { dispose: () => undefined };
28
- }
29
-
30
- close() {
31
- this.closed = true;
32
- for (const listener of this.closeListeners) {
33
- listener();
34
- }
35
- }
36
- }
37
-
38
- async function until(check: () => boolean, what: string): Promise<void> {
39
- for (let i = 0; i < 500 && !check(); i++) {
40
- await Bun.sleep(10);
41
- }
42
- if (!check()) {
43
- throw new Error(`Timed out waiting until ${what}`);
44
- }
45
- }
46
-
47
- describe('DefaultTaTerminals', () => {
48
- const cwd = realpathSync(tmpdir());
49
- const terminals = new DefaultTaTerminals();
50
- Object.assign(terminals, { environments: { create: (dir: string) => new LocalExecEnvironment(dir), defaultCwd: async () => cwd } });
51
- const as = (connection: FakeConnection) => connection as unknown as RpcConnection;
52
-
53
- afterEach(() => terminals.closeAll());
54
-
55
- it('runs a shell and sends its output to the connection that opened it', async () => {
56
- const connection = new FakeConnection();
57
- const info = await terminals.open(as(connection), { cwd, cols: 80, rows: 24 });
58
- expect(info.cwd).toBe(cwd);
59
- expect(info.terminalId).toBeString();
60
- terminals.write(as(connection), info.terminalId, 'echo ta-$((40+2))\r');
61
- await until(() => connection.output.includes('ta-42'), 'the shell answered');
62
- expect(connection.output).not.toContain('ta-tty=');
63
- expect(terminals.list(as(connection))).toEqual([info]);
64
- await terminals.resize(as(connection), info.terminalId, 100, 30);
65
- terminals.write(as(connection), info.terminalId, 'exit\r');
66
- await until(() => connection.exitCode !== undefined, 'the shell ended');
67
- expect(terminals.list(as(connection))).toEqual([]);
68
- });
69
-
70
- it('keeps a shell for another connection after its own dropped', async () => {
71
- const first = new FakeConnection();
72
- const info = await terminals.open(as(first), { cwd, cols: 80, rows: 24 });
73
- const stranger = new FakeConnection();
74
- expect(terminals.list(as(stranger))).toEqual([]);
75
- expect(() => terminals.write(as(stranger), info.terminalId, 'x')).toThrow('No terminal');
76
- first.close();
77
- const second = new FakeConnection();
78
- expect(terminals.list(as(second))).toEqual([info]);
79
- terminals.write(as(second), info.terminalId, 'echo back-$((1+1))\r');
80
- await until(() => second.output.includes('back-2'), 'the second connection got the output');
81
- await terminals.close(as(second), info.terminalId);
82
- expect(terminals.list(as(second))).toEqual([]);
83
- });
84
- });
@@ -1,259 +0,0 @@
1
- import { type Application, ApplicationLifecycle, Autowired, Component } from '@celljs/core';
2
- import type { RpcConnection } from '@celljs/rpc/lib/node';
3
- import { type ExecEnvironment, ExecEnvironmentFactory, type ExecProcess } from '@celljs/ta-exec';
4
- import { TaClient, type TaOpenTerminalOptions, type TaTerminalInfo } from '@celljs/ta-protocol';
5
- import { TaErrors } from './ta-errors';
6
- import { TaTerminals } from './terminal-protocol';
7
- import { PipeDiscipline, type TerminalPlatform, TerminalUtil, TtyMarker } from './terminal-util';
8
-
9
- /** How long a shell waits for a connection after its own dropped. */
10
- export const TERMINAL_ORPHAN_MS = 30000;
11
- /** Output a shell keeps while no connection takes it; older output goes first. */
12
- const MAX_PENDING_CHARS = 256 * 1024;
13
- /** Output of the same moment leaves in one message. */
14
- const FLUSH_MS = 8;
15
- const DEFAULT_COLS = 80;
16
- const DEFAULT_ROWS = 24;
17
-
18
- class Terminal {
19
- owner?: RpcConnection;
20
- orphanTimer?: ReturnType<typeof setTimeout>;
21
- pending = '';
22
- flushTimer?: ReturnType<typeof setTimeout>;
23
- sending = false;
24
- /** The code the shell ended with, as it said, or as its process did. */
25
- exitCode?: number;
26
- /** Its process ended. */
27
- exited = false;
28
- /** Its client knows it ended: nothing more goes. */
29
- ended = false;
30
- readonly decoder = new TextDecoder();
31
- readonly marker = new TtyMarker();
32
- readonly discipline?: PipeDiscipline;
33
-
34
- constructor(
35
- readonly info: TaTerminalInfo,
36
- readonly env: ExecEnvironment,
37
- readonly platform: TerminalPlatform,
38
- readonly process: ExecProcess,
39
- pty: boolean,
40
- owner: RpcConnection,
41
- ) {
42
- this.owner = owner;
43
- this.discipline = pty ? undefined : new PipeDiscipline();
44
- }
45
- }
46
-
47
- @Component([TaTerminals, ApplicationLifecycle])
48
- export class DefaultTaTerminals implements TaTerminals, ApplicationLifecycle<Application> {
49
- @Autowired(ExecEnvironmentFactory)
50
- protected readonly environments: ExecEnvironmentFactory;
51
-
52
- protected readonly terminals = new Map<string, Terminal>();
53
- protected readonly watched = new WeakSet<RpcConnection>();
54
- protected platform?: Promise<TerminalPlatform>;
55
- protected nextId = 0;
56
-
57
- async open(connection: RpcConnection, options: TaOpenTerminalOptions & { cwd: string }): Promise<TaTerminalInfo> {
58
- const env = this.environments.create(options.cwd);
59
- const stat = await env.stat(env.cwd);
60
- if (!stat?.isDirectory) {
61
- throw TaErrors.invalidArgument(`${options.cwd} is not a directory.`, 'Open the terminal in a directory that exists.');
62
- }
63
- const platform = await this.detect(env);
64
- const launch = TerminalUtil.launch(platform, TerminalUtil.size(options.cols, DEFAULT_COLS), TerminalUtil.size(options.rows, DEFAULT_ROWS));
65
- // `pty`: false when the shell runs on pipes, so that the view can say why some programs behave otherwise.
66
- const info: TaTerminalInfo & { pty: boolean } = { terminalId: `t${++this.nextId}`, cwd: options.cwd, shell: platform.shell, pty: launch.pty };
67
- const terminal = new Terminal(info, env, platform, env.spawn(launch.command, launch.args), launch.pty, connection);
68
- this.terminals.set(info.terminalId, terminal);
69
- this.watch(connection);
70
- const receive = (data: Uint8Array) => this.output(terminal, terminal.decoder.decode(data, { stream: true }));
71
- terminal.process.onStdout(receive);
72
- terminal.process.onStderr(receive);
73
- terminal.process.onExit(code => this.exited(terminal, code));
74
- return info;
75
- }
76
-
77
- write(connection: RpcConnection, terminalId: string, data: string): void {
78
- const terminal = this.require(connection, terminalId);
79
- if (!terminal.discipline) {
80
- terminal.process.write(data);
81
- return;
82
- }
83
- const { echo, send } = terminal.discipline.input(data);
84
- this.queue(terminal, echo);
85
- if (send) {
86
- terminal.process.write(send);
87
- }
88
- }
89
-
90
- async resize(connection: RpcConnection, terminalId: string, cols: number, rows: number): Promise<void> {
91
- const terminal = this.require(connection, terminalId);
92
- if (terminal.marker.tty) {
93
- const command = TerminalUtil.resizeCommand(
94
- terminal.platform,
95
- terminal.marker.tty,
96
- TerminalUtil.size(cols, DEFAULT_COLS),
97
- TerminalUtil.size(rows, DEFAULT_ROWS),
98
- );
99
- await terminal.env.exec(command, { timeout: 5000 });
100
- }
101
- }
102
-
103
- close(connection: RpcConnection, terminalId: string): Promise<void> {
104
- return this.end(this.require(connection, terminalId));
105
- }
106
-
107
- list(connection: RpcConnection): TaTerminalInfo[] {
108
- const own: TaTerminalInfo[] = [];
109
- for (const terminal of this.terminals.values()) {
110
- if (!terminal.owner) {
111
- this.adopt(terminal, connection);
112
- }
113
- if (terminal.owner === connection) {
114
- own.push(terminal.info);
115
- }
116
- }
117
- return own;
118
- }
119
-
120
- onStop(): Promise<void> {
121
- return this.closeAll();
122
- }
123
-
124
- async closeAll(): Promise<void> {
125
- await Promise.all([...this.terminals.values()].map(terminal => this.end(terminal)));
126
- }
127
-
128
- /** The shell of this connection, or one nobody has: it becomes this connection's. */
129
- protected require(connection: RpcConnection, terminalId: string): Terminal {
130
- const terminal = this.terminals.get(terminalId);
131
- if (!terminal || (terminal.owner && terminal.owner !== connection)) {
132
- throw TaErrors.invalidArgument(
133
- `No terminal of this connection has the id ${terminalId}.`,
134
- 'Open one with openTerminal; listTerminals has those still open.',
135
- );
136
- }
137
- if (!terminal.owner) {
138
- this.adopt(terminal, connection);
139
- }
140
- return terminal;
141
- }
142
-
143
- protected adopt(terminal: Terminal, connection: RpcConnection): void {
144
- clearTimeout(terminal.orphanTimer);
145
- terminal.orphanTimer = undefined;
146
- terminal.owner = connection;
147
- this.watch(connection);
148
- this.schedule(terminal);
149
- }
150
-
151
- protected watch(connection: RpcConnection): void {
152
- if (this.watched.has(connection)) {
153
- return;
154
- }
155
- this.watched.add(connection);
156
- connection.onClose(() => {
157
- for (const terminal of this.terminals.values()) {
158
- if (terminal.owner === connection) {
159
- terminal.owner = undefined;
160
- terminal.orphanTimer = setTimeout(() => void this.end(terminal), TERMINAL_ORPHAN_MS);
161
- }
162
- }
163
- });
164
- }
165
-
166
- protected output(terminal: Terminal, text: string): void {
167
- const { text: rest, exitCode } = TerminalUtil.takeExitCode(text);
168
- terminal.exitCode ??= exitCode;
169
- const shown = terminal.marker.feed(rest);
170
- this.queue(terminal, terminal.discipline ? terminal.discipline.output(shown) : shown);
171
- }
172
-
173
- protected queue(terminal: Terminal, text: string): void {
174
- if (!text) {
175
- return;
176
- }
177
- terminal.pending += text;
178
- if (terminal.pending.length > MAX_PENDING_CHARS) {
179
- terminal.pending = terminal.pending.slice(-MAX_PENDING_CHARS);
180
- }
181
- this.schedule(terminal);
182
- }
183
-
184
- protected schedule(terminal: Terminal): void {
185
- const due = terminal.pending || terminal.exited;
186
- if (terminal.flushTimer === undefined && terminal.owner && !terminal.ended && due) {
187
- terminal.flushTimer = setTimeout(() => this.flush(terminal), FLUSH_MS);
188
- }
189
- }
190
-
191
- /** One message at a time: the next leaves when the client has the last. */
192
- protected flush(terminal: Terminal): void {
193
- terminal.flushTimer = undefined;
194
- const owner = terminal.owner;
195
- if (!owner || owner.closed || terminal.sending) {
196
- return;
197
- }
198
- const data = terminal.pending;
199
- const exitCode = terminal.exited ? (terminal.exitCode ?? -1) : undefined;
200
- terminal.pending = '';
201
- terminal.sending = true;
202
- owner
203
- .client<TaClient>(TaClient)
204
- .onTerminalData(terminal.info.terminalId, data, exitCode)
205
- .then(
206
- () => {
207
- if (exitCode !== undefined) {
208
- terminal.ended = true;
209
- this.terminals.delete(terminal.info.terminalId);
210
- }
211
- },
212
- () => {
213
- // Lost on the way: it goes again to whoever takes the shell.
214
- terminal.pending = data + terminal.pending;
215
- },
216
- )
217
- .finally(() => {
218
- terminal.sending = false;
219
- this.schedule(terminal);
220
- });
221
- }
222
-
223
- protected exited(terminal: Terminal, exitCode: number | null): void {
224
- const rest = terminal.decoder.decode() + terminal.marker.flush();
225
- this.queue(terminal, terminal.discipline ? terminal.discipline.output(rest) : rest);
226
- terminal.exitCode ??= exitCode ?? undefined;
227
- terminal.exited = true;
228
- clearTimeout(terminal.orphanTimer);
229
- if (terminal.owner) {
230
- this.schedule(terminal);
231
- } else {
232
- this.terminals.delete(terminal.info.terminalId);
233
- }
234
- }
235
-
236
- /** Hangs up its terminal, which ends what runs there, then the wrapper. */
237
- protected async end(terminal: Terminal): Promise<void> {
238
- clearTimeout(terminal.orphanTimer);
239
- this.terminals.delete(terminal.info.terminalId);
240
- if (terminal.marker.tty) {
241
- await terminal.env.exec(TerminalUtil.hangUpCommand(terminal.marker.tty), { timeout: 5000 }).catch(() => undefined);
242
- }
243
- terminal.process.kill();
244
- }
245
-
246
- protected detect(env: ExecEnvironment): Promise<TerminalPlatform> {
247
- this.platform ??= (async () => {
248
- let output = '';
249
- const decoder = new TextDecoder();
250
- const { exitCode } = await env.exec(`${TerminalUtil.PROBE} 2>/dev/null`, {
251
- timeout: 5000,
252
- onData: data => (output += decoder.decode(data, { stream: true })),
253
- });
254
- const fallback = env.local && process.platform === 'win32' ? (process.env.ComSpec ?? 'cmd.exe') : '/bin/sh';
255
- return exitCode === 0 ? TerminalUtil.parsePlatform(output, fallback) : { system: '', script: false, shell: fallback };
256
- })();
257
- return this.platform;
258
- }
259
- }
@@ -1,78 +0,0 @@
1
- import { describe, expect, it } from 'bun:test';
2
- import { PipeDiscipline, TerminalUtil, TtyMarker } from './terminal-util';
3
-
4
- describe('TerminalUtil', () => {
5
- it('reads the platform', () => {
6
- expect(TerminalUtil.parsePlatform('Darwin\n/usr/bin/script\n/bin/zsh', '/bin/sh')).toEqual({ system: 'Darwin', script: true, shell: '/bin/zsh' });
7
- expect(TerminalUtil.parsePlatform('Linux\n\n', '/bin/sh')).toEqual({ system: 'Linux', script: false, shell: '/bin/sh' });
8
- });
9
-
10
- it('runs the shell on a pseudo-terminal when script is there', () => {
11
- const mac = TerminalUtil.launch({ system: 'Darwin', script: true, shell: '/bin/zsh' }, 100, 30);
12
- expect(mac).toMatchObject({ command: '/bin/sh', pty: true });
13
- expect(mac.args[1]).toStartWith('cat | { script -q /dev/null /bin/sh -c ');
14
- expect(mac.args[1]).toContain('stty cols 100 rows 30');
15
- expect(mac.args[1]).toContain('/bin/zsh');
16
- expect(mac.args[1]).toContain('BASH_SILENCE_DEPRECATION_WARNING=1');
17
- expect(mac.args[1]).toEndWith('kill $$; }');
18
- const linux = TerminalUtil.launch({ system: 'Linux', script: true, shell: '/bin/bash' }, 80, 24);
19
- expect(linux.args[1]).toStartWith('cat | { script -qefc ');
20
- expect(linux.args[1]).toContain(' /dev/null; code=$?');
21
- expect(TerminalUtil.launch({ system: 'Linux', script: false, shell: '/bin/bash' }, 80, 24)).toEqual({ command: '/bin/bash', args: ['-i'], pty: false });
22
- });
23
-
24
- it('resizes with the stty of the system', () => {
25
- expect(TerminalUtil.resizeCommand({ system: 'Linux', script: true, shell: '' }, '/dev/pts/3', 120, 40)).toBe("stty -F '/dev/pts/3' cols 120 rows 40");
26
- expect(TerminalUtil.resizeCommand({ system: 'Darwin', script: true, shell: '' }, '/dev/ttys001', 80, 24)).toBe(
27
- "stty -f '/dev/ttys001' cols 80 rows 24",
28
- );
29
- expect(TerminalUtil.hangUpCommand('/dev/pts/3')).toBe("kill -HUP $(ps -t 'pts/3' -o pid=)");
30
- expect(TerminalUtil.size(0, 80)).toBe(1);
31
- expect(TerminalUtil.size(Number.NaN, 80)).toBe(80);
32
- expect(TerminalUtil.size(99999, 80)).toBe(1000);
33
- });
34
- });
35
-
36
- describe('TerminalUtil.takeExitCode', () => {
37
- it('takes the code the wrapper printed', () => {
38
- expect(TerminalUtil.takeExitCode('bye\x1b]1337;ta-exit=3\x07')).toEqual({ text: 'bye', exitCode: 3 });
39
- expect(TerminalUtil.takeExitCode('plain')).toEqual({ text: 'plain' });
40
- });
41
- });
42
-
43
- describe('TtyMarker', () => {
44
- it('takes the name of the terminal out of the output, in pieces too', () => {
45
- const marker = new TtyMarker();
46
- expect(marker.feed('^D\x1b]1337;ta-')).toBe('');
47
- expect(marker.feed('tty=/dev/ttys004\x07$ ')).toBe('^D$ ');
48
- expect(marker.tty).toBe('/dev/ttys004');
49
- expect(marker.feed('more')).toBe('more');
50
- });
51
-
52
- it('gives up after a while, and gives back what it held', () => {
53
- const marker = new TtyMarker();
54
- expect(marker.feed('x'.repeat(5000))).toHaveLength(5000);
55
- expect(marker.tty).toBeUndefined();
56
- const early = new TtyMarker();
57
- early.feed('bye');
58
- expect(early.flush()).toBe('bye');
59
- });
60
- });
61
-
62
- describe('PipeDiscipline', () => {
63
- it('echoes, edits the line, and sends it on Enter', () => {
64
- const discipline = new PipeDiscipline();
65
- expect(discipline.input('lsx')).toEqual({ echo: 'lsx', send: '' });
66
- expect(discipline.input('\x7f')).toEqual({ echo: '\b \b', send: '' });
67
- expect(discipline.input('\x1b[A -l\r')).toEqual({ echo: ' -l\r\n', send: 'ls -l\n' });
68
- discipline.input('oops');
69
- expect(discipline.input('\x03').echo).toBe('^C\r\n');
70
- expect(discipline.input('\r').send).toBe('\n');
71
- discipline.input('ab');
72
- expect(discipline.input('\x15').echo).toBe('\b \b\b \b');
73
- });
74
-
75
- it('turns line feeds into what a terminal shows', () => {
76
- expect(new PipeDiscipline().output('a\nb\r\n')).toBe('a\r\nb\r\n');
77
- });
78
- });