@celljs/ta-host 4.5.1 → 4.6.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 (375) hide show
  1. package/README.md +31 -8
  2. package/cell.schema.json +18 -0
  3. package/cell.yml +4 -0
  4. package/esm/node/auth-server-impl.d.ts +61 -0
  5. package/esm/node/auth-server-impl.js +247 -0
  6. package/esm/node/auth-server-impl.js.map +1 -0
  7. package/esm/node/client-tool-broker.d.ts +35 -0
  8. package/esm/node/client-tool-broker.js +82 -0
  9. package/esm/node/client-tool-broker.js.map +1 -0
  10. package/esm/node/exec-environment-factory.d.ts +17 -0
  11. package/esm/node/exec-environment-factory.js +58 -0
  12. package/esm/node/exec-environment-factory.js.map +1 -0
  13. package/esm/node/extension-data-notifier.d.ts +41 -0
  14. package/esm/node/extension-data-notifier.js +119 -0
  15. package/esm/node/extension-data-notifier.js.map +1 -0
  16. package/esm/node/extension-data.d.ts +45 -0
  17. package/esm/node/extension-data.js +181 -0
  18. package/esm/node/extension-data.js.map +1 -0
  19. package/esm/node/host-protocol.d.ts +29 -1
  20. package/esm/node/host-protocol.js +2 -0
  21. package/esm/node/host-protocol.js.map +1 -1
  22. package/esm/node/index.d.ts +24 -1
  23. package/esm/node/index.js +24 -1
  24. package/esm/node/index.js.map +1 -1
  25. package/esm/node/package-host-extension.d.ts +9 -0
  26. package/esm/node/package-host-extension.js +18 -0
  27. package/esm/node/package-host-extension.js.map +1 -0
  28. package/esm/node/package-hosts.d.ts +44 -0
  29. package/esm/node/package-hosts.js +167 -0
  30. package/esm/node/package-hosts.js.map +1 -0
  31. package/esm/node/package-server-impl.d.ts +25 -0
  32. package/esm/node/package-server-impl.js +94 -0
  33. package/esm/node/package-server-impl.js.map +1 -0
  34. package/esm/node/package-switch.d.ts +29 -0
  35. package/esm/node/package-switch.js +68 -0
  36. package/esm/node/package-switch.js.map +1 -0
  37. package/esm/node/relay-bridge.d.ts +34 -0
  38. package/esm/node/relay-bridge.js +105 -0
  39. package/esm/node/relay-bridge.js.map +1 -0
  40. package/esm/node/session-info-util.d.ts +16 -0
  41. package/esm/node/session-info-util.js +49 -0
  42. package/esm/node/session-info-util.js.map +1 -0
  43. package/esm/node/session-storage/file-session-storage.d.ts +27 -0
  44. package/esm/node/session-storage/file-session-storage.js +139 -0
  45. package/esm/node/session-storage/file-session-storage.js.map +1 -0
  46. package/esm/node/session-storage/index.d.ts +3 -0
  47. package/esm/node/session-storage/index.js +4 -0
  48. package/esm/node/session-storage/index.js.map +1 -0
  49. package/esm/node/session-storage/session-storage-protocol.d.ts +57 -0
  50. package/esm/node/session-storage/session-storage-protocol.js +40 -0
  51. package/esm/node/session-storage/session-storage-protocol.js.map +1 -0
  52. package/esm/node/session-storage/stored-session.d.ts +46 -0
  53. package/esm/node/session-storage/stored-session.js +116 -0
  54. package/esm/node/session-storage/stored-session.js.map +1 -0
  55. package/esm/node/settings-server-impl.d.ts +11 -0
  56. package/esm/node/settings-server-impl.js +45 -0
  57. package/esm/node/settings-server-impl.js.map +1 -0
  58. package/esm/node/settings-store.d.ts +56 -0
  59. package/esm/node/settings-store.js +306 -0
  60. package/esm/node/settings-store.js.map +1 -0
  61. package/esm/node/ta-access.d.ts +19 -2
  62. package/esm/node/ta-access.js +64 -7
  63. package/esm/node/ta-access.js.map +1 -1
  64. package/esm/node/ta-errors.d.ts +3 -1
  65. package/esm/node/ta-errors.js +17 -1
  66. package/esm/node/ta-errors.js.map +1 -1
  67. package/esm/node/ta-server-impl.d.ts +17 -5
  68. package/esm/node/ta-server-impl.js +70 -13
  69. package/esm/node/ta-server-impl.js.map +1 -1
  70. package/esm/node/ta-session-factory.d.ts +2 -0
  71. package/esm/node/ta-session-factory.js +25 -11
  72. package/esm/node/ta-session-factory.js.map +1 -1
  73. package/esm/node/ta-session.d.ts +9 -1
  74. package/esm/node/ta-session.js +26 -2
  75. package/esm/node/ta-session.js.map +1 -1
  76. package/esm/node/terminal-protocol.d.ts +18 -0
  77. package/esm/node/terminal-protocol.js +2 -0
  78. package/esm/node/terminal-protocol.js.map +1 -0
  79. package/esm/node/terminal-service.d.ts +59 -0
  80. package/esm/node/terminal-service.js +240 -0
  81. package/esm/node/terminal-service.js.map +1 -0
  82. package/esm/node/terminal-util.d.ts +62 -0
  83. package/esm/node/terminal-util.js +153 -0
  84. package/esm/node/terminal-util.js.map +1 -0
  85. package/esm/node/web-extension-catalog.d.ts +38 -0
  86. package/esm/node/web-extension-catalog.js +160 -0
  87. package/esm/node/web-extension-catalog.js.map +1 -0
  88. package/esm/node/web-extension-util.d.ts +21 -0
  89. package/esm/node/web-extension-util.js +123 -0
  90. package/esm/node/web-extension-util.js.map +1 -0
  91. package/esm/node/working-directory.d.ts +13 -0
  92. package/esm/node/working-directory.js +40 -0
  93. package/esm/node/working-directory.js.map +1 -0
  94. package/esm/node/workspace-files.d.ts +47 -0
  95. package/esm/node/workspace-files.js +265 -0
  96. package/esm/node/workspace-files.js.map +1 -0
  97. package/esm/node/workspace-protocol.d.ts +20 -0
  98. package/esm/node/workspace-protocol.js +3 -0
  99. package/esm/node/workspace-protocol.js.map +1 -0
  100. package/esm/node/workspace-server-impl.d.ts +27 -0
  101. package/esm/node/workspace-server-impl.js +88 -0
  102. package/esm/node/workspace-server-impl.js.map +1 -0
  103. package/esm/node/workspace-service.d.ts +31 -0
  104. package/esm/node/workspace-service.js +209 -0
  105. package/esm/node/workspace-service.js.map +1 -0
  106. package/esm/node/workspace-util.d.ts +29 -0
  107. package/esm/node/workspace-util.js +104 -0
  108. package/esm/node/workspace-util.js.map +1 -0
  109. package/lib/node/auth-server-impl.d.ts +62 -0
  110. package/lib/node/auth-server-impl.d.ts.map +1 -0
  111. package/lib/node/auth-server-impl.js +250 -0
  112. package/lib/node/auth-server-impl.js.map +1 -0
  113. package/lib/node/auth-server-impl.spec.d.ts +2 -0
  114. package/lib/node/auth-server-impl.spec.d.ts.map +1 -0
  115. package/lib/node/auth-server-impl.spec.js +47 -0
  116. package/lib/node/auth-server-impl.spec.js.map +1 -0
  117. package/lib/node/client-tool-broker.d.ts +36 -0
  118. package/lib/node/client-tool-broker.d.ts.map +1 -0
  119. package/lib/node/client-tool-broker.js +86 -0
  120. package/lib/node/client-tool-broker.js.map +1 -0
  121. package/lib/node/client-tool-broker.spec.d.ts +2 -0
  122. package/lib/node/client-tool-broker.spec.d.ts.map +1 -0
  123. package/lib/node/client-tool-broker.spec.js +49 -0
  124. package/lib/node/client-tool-broker.spec.js.map +1 -0
  125. package/lib/node/exec-environment-factory.d.ts +18 -0
  126. package/lib/node/exec-environment-factory.d.ts.map +1 -0
  127. package/lib/node/exec-environment-factory.js +61 -0
  128. package/lib/node/exec-environment-factory.js.map +1 -0
  129. package/lib/node/extension-data-notifier.d.ts +42 -0
  130. package/lib/node/extension-data-notifier.d.ts.map +1 -0
  131. package/lib/node/extension-data-notifier.js +123 -0
  132. package/lib/node/extension-data-notifier.js.map +1 -0
  133. package/lib/node/extension-data-notifier.spec.d.ts +2 -0
  134. package/lib/node/extension-data-notifier.spec.d.ts.map +1 -0
  135. package/lib/node/extension-data-notifier.spec.js +35 -0
  136. package/lib/node/extension-data-notifier.spec.js.map +1 -0
  137. package/lib/node/extension-data.d.ts +46 -0
  138. package/lib/node/extension-data.d.ts.map +1 -0
  139. package/lib/node/extension-data.js +184 -0
  140. package/lib/node/extension-data.js.map +1 -0
  141. package/lib/node/extension-data.spec.d.ts +2 -0
  142. package/lib/node/extension-data.spec.d.ts.map +1 -0
  143. package/lib/node/extension-data.spec.js +99 -0
  144. package/lib/node/extension-data.spec.js.map +1 -0
  145. package/lib/node/host-protocol.d.ts +29 -1
  146. package/lib/node/host-protocol.d.ts.map +1 -1
  147. package/lib/node/host-protocol.js +3 -1
  148. package/lib/node/host-protocol.js.map +1 -1
  149. package/lib/node/index.d.ts +24 -1
  150. package/lib/node/index.d.ts.map +1 -1
  151. package/lib/node/index.js +24 -1
  152. package/lib/node/index.js.map +1 -1
  153. package/lib/node/package-host-extension.d.ts +10 -0
  154. package/lib/node/package-host-extension.d.ts.map +1 -0
  155. package/lib/node/package-host-extension.js +22 -0
  156. package/lib/node/package-host-extension.js.map +1 -0
  157. package/lib/node/package-hosts.d.ts +45 -0
  158. package/lib/node/package-hosts.d.ts.map +1 -0
  159. package/lib/node/package-hosts.js +170 -0
  160. package/lib/node/package-hosts.js.map +1 -0
  161. package/lib/node/package-hosts.spec.d.ts +2 -0
  162. package/lib/node/package-hosts.spec.d.ts.map +1 -0
  163. package/lib/node/package-hosts.spec.js +53 -0
  164. package/lib/node/package-hosts.spec.js.map +1 -0
  165. package/lib/node/package-server-impl.d.ts +26 -0
  166. package/lib/node/package-server-impl.d.ts.map +1 -0
  167. package/lib/node/package-server-impl.js +97 -0
  168. package/lib/node/package-server-impl.js.map +1 -0
  169. package/lib/node/package-switch.d.ts +30 -0
  170. package/lib/node/package-switch.d.ts.map +1 -0
  171. package/lib/node/package-switch.js +71 -0
  172. package/lib/node/package-switch.js.map +1 -0
  173. package/lib/node/relay-bridge.d.ts +35 -0
  174. package/lib/node/relay-bridge.d.ts.map +1 -0
  175. package/lib/node/relay-bridge.js +108 -0
  176. package/lib/node/relay-bridge.js.map +1 -0
  177. package/lib/node/session-info-util.d.ts +17 -0
  178. package/lib/node/session-info-util.d.ts.map +1 -0
  179. package/lib/node/session-info-util.js +52 -0
  180. package/lib/node/session-info-util.js.map +1 -0
  181. package/lib/node/session-info-util.spec.d.ts +2 -0
  182. package/lib/node/session-info-util.spec.d.ts.map +1 -0
  183. package/lib/node/session-info-util.spec.js +22 -0
  184. package/lib/node/session-info-util.spec.js.map +1 -0
  185. package/lib/node/session-storage/file-session-storage.d.ts +28 -0
  186. package/lib/node/session-storage/file-session-storage.d.ts.map +1 -0
  187. package/lib/node/session-storage/file-session-storage.js +143 -0
  188. package/lib/node/session-storage/file-session-storage.js.map +1 -0
  189. package/lib/node/session-storage/file-session-storage.spec.d.ts +2 -0
  190. package/lib/node/session-storage/file-session-storage.spec.d.ts.map +1 -0
  191. package/lib/node/session-storage/file-session-storage.spec.js +70 -0
  192. package/lib/node/session-storage/file-session-storage.spec.js.map +1 -0
  193. package/lib/node/session-storage/index.d.ts +4 -0
  194. package/lib/node/session-storage/index.d.ts.map +1 -0
  195. package/lib/node/session-storage/index.js +20 -0
  196. package/lib/node/session-storage/index.js.map +1 -0
  197. package/lib/node/session-storage/session-storage-protocol.d.ts +58 -0
  198. package/lib/node/session-storage/session-storage-protocol.d.ts.map +1 -0
  199. package/lib/node/session-storage/session-storage-protocol.js +45 -0
  200. package/lib/node/session-storage/session-storage-protocol.js.map +1 -0
  201. package/lib/node/session-storage/stored-session.d.ts +47 -0
  202. package/lib/node/session-storage/stored-session.d.ts.map +1 -0
  203. package/lib/node/session-storage/stored-session.js +120 -0
  204. package/lib/node/session-storage/stored-session.js.map +1 -0
  205. package/lib/node/session-storage/stored-session.spec.d.ts +2 -0
  206. package/lib/node/session-storage/stored-session.spec.d.ts.map +1 -0
  207. package/lib/node/session-storage/stored-session.spec.js +73 -0
  208. package/lib/node/session-storage/stored-session.spec.js.map +1 -0
  209. package/lib/node/settings-server-impl.d.ts +12 -0
  210. package/lib/node/settings-server-impl.d.ts.map +1 -0
  211. package/lib/node/settings-server-impl.js +48 -0
  212. package/lib/node/settings-server-impl.js.map +1 -0
  213. package/lib/node/settings-store.d.ts +57 -0
  214. package/lib/node/settings-store.d.ts.map +1 -0
  215. package/lib/node/settings-store.js +309 -0
  216. package/lib/node/settings-store.js.map +1 -0
  217. package/lib/node/settings-store.spec.d.ts +2 -0
  218. package/lib/node/settings-store.spec.d.ts.map +1 -0
  219. package/lib/node/settings-store.spec.js +145 -0
  220. package/lib/node/settings-store.spec.js.map +1 -0
  221. package/lib/node/ta-access.d.ts +19 -2
  222. package/lib/node/ta-access.d.ts.map +1 -1
  223. package/lib/node/ta-access.js +66 -9
  224. package/lib/node/ta-access.js.map +1 -1
  225. package/lib/node/ta-access.spec.js +8 -0
  226. package/lib/node/ta-access.spec.js.map +1 -1
  227. package/lib/node/ta-errors.d.ts +3 -1
  228. package/lib/node/ta-errors.d.ts.map +1 -1
  229. package/lib/node/ta-errors.js +17 -1
  230. package/lib/node/ta-errors.js.map +1 -1
  231. package/lib/node/ta-errors.spec.d.ts +2 -0
  232. package/lib/node/ta-errors.spec.d.ts.map +1 -0
  233. package/lib/node/ta-errors.spec.js +25 -0
  234. package/lib/node/ta-errors.spec.js.map +1 -0
  235. package/lib/node/ta-server-impl.d.ts +17 -5
  236. package/lib/node/ta-server-impl.d.ts.map +1 -1
  237. package/lib/node/ta-server-impl.js +70 -13
  238. package/lib/node/ta-server-impl.js.map +1 -1
  239. package/lib/node/ta-session-factory.d.ts +2 -0
  240. package/lib/node/ta-session-factory.d.ts.map +1 -1
  241. package/lib/node/ta-session-factory.js +24 -10
  242. package/lib/node/ta-session-factory.js.map +1 -1
  243. package/lib/node/ta-session.d.ts +9 -1
  244. package/lib/node/ta-session.d.ts.map +1 -1
  245. package/lib/node/ta-session.js +26 -2
  246. package/lib/node/ta-session.js.map +1 -1
  247. package/lib/node/terminal-protocol.d.ts +19 -0
  248. package/lib/node/terminal-protocol.d.ts.map +1 -0
  249. package/lib/node/terminal-protocol.js +5 -0
  250. package/lib/node/terminal-protocol.js.map +1 -0
  251. package/lib/node/terminal-service.d.ts +60 -0
  252. package/lib/node/terminal-service.d.ts.map +1 -0
  253. package/lib/node/terminal-service.js +241 -0
  254. package/lib/node/terminal-service.js.map +1 -0
  255. package/lib/node/terminal-service.spec.d.ts +2 -0
  256. package/lib/node/terminal-service.spec.d.ts.map +1 -0
  257. package/lib/node/terminal-service.spec.js +79 -0
  258. package/lib/node/terminal-service.spec.js.map +1 -0
  259. package/lib/node/terminal-util.d.ts +63 -0
  260. package/lib/node/terminal-util.d.ts.map +1 -0
  261. package/lib/node/terminal-util.js +158 -0
  262. package/lib/node/terminal-util.js.map +1 -0
  263. package/lib/node/terminal-util.spec.d.ts +2 -0
  264. package/lib/node/terminal-util.spec.d.ts.map +1 -0
  265. package/lib/node/terminal-util.spec.js +71 -0
  266. package/lib/node/terminal-util.spec.js.map +1 -0
  267. package/lib/node/web-extension-catalog.d.ts +39 -0
  268. package/lib/node/web-extension-catalog.d.ts.map +1 -0
  269. package/lib/node/web-extension-catalog.js +163 -0
  270. package/lib/node/web-extension-catalog.js.map +1 -0
  271. package/lib/node/web-extension-catalog.spec.d.ts +2 -0
  272. package/lib/node/web-extension-catalog.spec.d.ts.map +1 -0
  273. package/lib/node/web-extension-catalog.spec.js +157 -0
  274. package/lib/node/web-extension-catalog.spec.js.map +1 -0
  275. package/lib/node/web-extension-util.d.ts +22 -0
  276. package/lib/node/web-extension-util.d.ts.map +1 -0
  277. package/lib/node/web-extension-util.js +126 -0
  278. package/lib/node/web-extension-util.js.map +1 -0
  279. package/lib/node/working-directory.d.ts +14 -0
  280. package/lib/node/working-directory.d.ts.map +1 -0
  281. package/lib/node/working-directory.js +43 -0
  282. package/lib/node/working-directory.js.map +1 -0
  283. package/lib/node/workspace-files.d.ts +48 -0
  284. package/lib/node/workspace-files.d.ts.map +1 -0
  285. package/lib/node/workspace-files.js +268 -0
  286. package/lib/node/workspace-files.js.map +1 -0
  287. package/lib/node/workspace-files.spec.d.ts +2 -0
  288. package/lib/node/workspace-files.spec.d.ts.map +1 -0
  289. package/lib/node/workspace-files.spec.js +133 -0
  290. package/lib/node/workspace-files.spec.js.map +1 -0
  291. package/lib/node/workspace-protocol.d.ts +21 -0
  292. package/lib/node/workspace-protocol.d.ts.map +1 -0
  293. package/lib/node/workspace-protocol.js +6 -0
  294. package/lib/node/workspace-protocol.js.map +1 -0
  295. package/lib/node/workspace-server-impl.d.ts +28 -0
  296. package/lib/node/workspace-server-impl.d.ts.map +1 -0
  297. package/lib/node/workspace-server-impl.js +91 -0
  298. package/lib/node/workspace-server-impl.js.map +1 -0
  299. package/lib/node/workspace-service.d.ts +32 -0
  300. package/lib/node/workspace-service.d.ts.map +1 -0
  301. package/lib/node/workspace-service.js +212 -0
  302. package/lib/node/workspace-service.js.map +1 -0
  303. package/lib/node/workspace-service.spec.d.ts +2 -0
  304. package/lib/node/workspace-service.spec.d.ts.map +1 -0
  305. package/lib/node/workspace-service.spec.js +104 -0
  306. package/lib/node/workspace-service.spec.js.map +1 -0
  307. package/lib/node/workspace-util.d.ts +30 -0
  308. package/lib/node/workspace-util.d.ts.map +1 -0
  309. package/lib/node/workspace-util.js +107 -0
  310. package/lib/node/workspace-util.js.map +1 -0
  311. package/lib/node/workspace-util.spec.d.ts +2 -0
  312. package/lib/node/workspace-util.spec.d.ts.map +1 -0
  313. package/lib/node/workspace-util.spec.js +44 -0
  314. package/lib/node/workspace-util.spec.js.map +1 -0
  315. package/package.json +14 -9
  316. package/src/node/auth-server-impl.spec.ts +49 -0
  317. package/src/node/auth-server-impl.ts +252 -0
  318. package/src/node/client-tool-broker.spec.ts +53 -0
  319. package/src/node/client-tool-broker.ts +106 -0
  320. package/src/node/exec-environment-factory.ts +46 -0
  321. package/src/node/extension-data-notifier.spec.ts +34 -0
  322. package/src/node/extension-data-notifier.ts +124 -0
  323. package/src/node/extension-data.spec.ts +105 -0
  324. package/src/node/extension-data.ts +180 -0
  325. package/src/node/host-protocol.ts +31 -1
  326. package/src/node/index.ts +24 -1
  327. package/src/node/package-host-extension.ts +20 -0
  328. package/src/node/package-hosts.spec.ts +54 -0
  329. package/src/node/package-hosts.ts +174 -0
  330. package/src/node/package-server-impl.ts +87 -0
  331. package/src/node/package-switch.ts +80 -0
  332. package/src/node/relay-bridge.ts +94 -0
  333. package/src/node/session-info-util.spec.ts +23 -0
  334. package/src/node/session-info-util.ts +55 -0
  335. package/src/node/session-storage/file-session-storage.spec.ts +72 -0
  336. package/src/node/session-storage/file-session-storage.ts +145 -0
  337. package/src/node/session-storage/index.ts +3 -0
  338. package/src/node/session-storage/session-storage-protocol.ts +81 -0
  339. package/src/node/session-storage/stored-session.spec.ts +80 -0
  340. package/src/node/session-storage/stored-session.ts +149 -0
  341. package/src/node/settings-server-impl.ts +33 -0
  342. package/src/node/settings-store.spec.ts +155 -0
  343. package/src/node/settings-store.ts +308 -0
  344. package/src/node/ta-access.spec.ts +9 -0
  345. package/src/node/ta-access.ts +65 -7
  346. package/src/node/ta-errors.spec.ts +25 -0
  347. package/src/node/ta-errors.ts +21 -1
  348. package/src/node/ta-server-impl.ts +75 -12
  349. package/src/node/ta-session-factory.ts +21 -7
  350. package/src/node/ta-session.ts +43 -3
  351. package/src/node/terminal-protocol.ts +18 -0
  352. package/src/node/terminal-service.spec.ts +84 -0
  353. package/src/node/terminal-service.ts +259 -0
  354. package/src/node/terminal-util.spec.ts +78 -0
  355. package/src/node/terminal-util.ts +166 -0
  356. package/src/node/web-extension-catalog.spec.ts +172 -0
  357. package/src/node/web-extension-catalog.ts +172 -0
  358. package/src/node/web-extension-util.ts +144 -0
  359. package/src/node/working-directory.ts +38 -0
  360. package/src/node/workspace-files.spec.ts +145 -0
  361. package/src/node/workspace-files.ts +256 -0
  362. package/src/node/workspace-protocol.ts +22 -0
  363. package/src/node/workspace-server-impl.ts +90 -0
  364. package/src/node/workspace-service.spec.ts +113 -0
  365. package/src/node/workspace-service.ts +223 -0
  366. package/src/node/workspace-util.spec.ts +47 -0
  367. package/src/node/workspace-util.ts +103 -0
  368. package/esm/node/local-exec-environment-factory.d.ts +0 -4
  369. package/esm/node/local-exec-environment-factory.js +0 -18
  370. package/esm/node/local-exec-environment-factory.js.map +0 -1
  371. package/lib/node/local-exec-environment-factory.d.ts +0 -5
  372. package/lib/node/local-exec-environment-factory.d.ts.map +0 -1
  373. package/lib/node/local-exec-environment-factory.js +0 -21
  374. package/lib/node/local-exec-environment-factory.js.map +0 -1
  375. package/src/node/local-exec-environment-factory.ts +0 -9
@@ -19,9 +19,13 @@ import {
19
19
  SessionLock,
20
20
  SessionLockExtension,
21
21
  TaExtensionUtil,
22
+ TaPackages,
22
23
  } from '@celljs/ta-harness';
23
24
  import type { TaOpenSessionOptions } from '@celljs/ta-protocol';
25
+ import { ClientToolBroker } from './client-tool-broker';
24
26
  import { TA_HOST_OPTIONS, type TaHostOptions, TaSessionFactory } from './host-protocol';
27
+ import { PackageHostExtension } from './package-host-extension';
28
+ import { PackageHosts } from './package-hosts';
25
29
  import { TaErrors } from './ta-errors';
26
30
  import { TaSession } from './ta-session';
27
31
 
@@ -52,10 +56,11 @@ export class DefaultTaSessionFactory implements TaSessionFactory {
52
56
  @Optional()
53
57
  protected readonly tools: AgentTool[] = [];
54
58
 
59
+ @Autowired(PackageHosts)
60
+ protected readonly packageHosts: PackageHosts;
61
+
55
62
  async create(options: TaOpenSessionOptions, requestClose: (session: TaSession) => void): Promise<TaSession> {
56
- if (options.clientTools?.length) {
57
- throw TaErrors.invalidArgument('This version of ta serve does not run client tools yet.', 'Open the session without clientTools.');
58
- }
63
+ const clientTools = new ClientToolBroker(options.clientTools);
59
64
  const sdk = await PiSdkUtil.load();
60
65
  const agentDir = this.codingAgentOptions?.agentDir ?? sdk.getAgentDir();
61
66
  const modelRuntime = await this.modelRuntimeProvider.provide();
@@ -75,7 +80,11 @@ export class DefaultTaSessionFactory implements TaSessionFactory {
75
80
  agentDir: dir,
76
81
  settingsManager,
77
82
  modelRuntime,
78
- resourceLoaderOptions: { extensionFactories: this.extensionFactories(sdk, cwd, lock) },
83
+ resourceLoaderOptions: {
84
+ ...TaPackages.loaderOptions(dir),
85
+ extensionFactories: this.extensionFactories(sdk, cwd, lock),
86
+ appendSystemPrompt: options.appendSystemPrompt ? [options.appendSystemPrompt] : undefined,
87
+ },
79
88
  });
80
89
  const created = await sdk.createAgentSessionFromServices({
81
90
  services,
@@ -83,13 +92,13 @@ export class DefaultTaSessionFactory implements TaSessionFactory {
83
92
  sessionStartEvent,
84
93
  model,
85
94
  thinkingLevel: options.thinkingLevel,
86
- customTools: (this.tools ?? []).map(AgentToolUtil.toToolDefinition),
95
+ customTools: [...(this.tools ?? []).map(AgentToolUtil.toToolDefinition), ...clientTools.tools()],
87
96
  });
88
97
  return { ...created, services, diagnostics: services.diagnostics };
89
98
  },
90
99
  { cwd: options.cwd, agentDir, sessionManager },
91
100
  );
92
- const session = new TaSession({ runtime, lock, options: this.options, requestClose });
101
+ const session = new TaSession({ runtime, lock, clientTools, options: this.options, requestClose, group: options.group });
93
102
  await session.start();
94
103
  return session;
95
104
  } catch (error) {
@@ -114,7 +123,12 @@ export class DefaultTaSessionFactory implements TaSessionFactory {
114
123
 
115
124
  protected extensionFactories(sdk: PiSdk, cwd: string, lock: SessionLock): InlineExtension[] {
116
125
  const environment = this.environments.create(cwd);
117
- const builtIn = [new SessionLockExtension(lock), new BrandExtension(sdk), ...(environment.local ? [] : [new ExecExtension(environment, sdk)])];
126
+ const builtIn = [
127
+ new SessionLockExtension(lock),
128
+ new PackageHostExtension(this.packageHosts),
129
+ new BrandExtension(sdk),
130
+ ...(environment.local ? [] : [new ExecExtension(environment, sdk)]),
131
+ ];
118
132
  return [
119
133
  ...this.piExtensions(sdk, environment),
120
134
  TaExtensionUtil.bundle(builtIn),
@@ -1,11 +1,22 @@
1
1
  import { randomUUID } from 'node:crypto';
2
2
  import type { SessionLock } from '@celljs/ta-harness';
3
- import type { RpcExtensionUIResponse, TaAttachResult, TaEvent, TaPromptInput, TaPromptReceipt, TaSessionInfo } from '@celljs/ta-protocol';
3
+ import type {
4
+ RpcExtensionUIResponse,
5
+ TaAttachResult,
6
+ TaClientToolResult,
7
+ TaEvent,
8
+ TaNavigateResult,
9
+ TaPromptInput,
10
+ TaPromptReceipt,
11
+ TaSessionInfo,
12
+ } from '@celljs/ta-protocol';
4
13
  import type { ClientChannel } from './client-channel';
14
+ import type { ClientToolBroker } from './client-tool-broker';
5
15
  import { EventLog } from './event-log';
6
16
  import type { TaHostOptions } from './host-protocol';
7
17
  import { ReceiptBook } from './receipt-book';
8
18
  import { RemoteUiContext } from './remote-ui-context';
19
+ import { SessionInfoUtil } from './session-info-util';
9
20
  import { TaEventUtil } from './ta-event-util';
10
21
 
11
22
  type AgentSessionRuntime = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).AgentSessionRuntime;
@@ -15,9 +26,13 @@ type PromptDisposition = 'started' | 'queued' | 'handled';
15
26
  export interface TaSessionContext {
16
27
  runtime: AgentSessionRuntime;
17
28
  lock: SessionLock;
29
+ /** The tools of the session that its clients run. */
30
+ clientTools: ClientToolBroker;
18
31
  options: TaHostOptions;
19
32
  /** The session should end: it has been idle, or an extension asked. */
20
33
  requestClose(session: TaSession): void;
34
+ /** TaOpenSessionOptions.group. */
35
+ group?: string;
21
36
  }
22
37
 
23
38
  /**
@@ -40,6 +55,7 @@ export class TaSession {
40
55
  this.runtime = context.runtime;
41
56
  this.log = new EventLog(this.id, context.options.eventBufferBytes);
42
57
  this.ui = new RemoteUiContext(event => this.publish(event));
58
+ context.clientTools.connect(event => this.publish(event));
43
59
  }
44
60
 
45
61
  get pi(): AgentSession {
@@ -63,11 +79,14 @@ export class TaSession {
63
79
  cwd: this.runtime.cwd,
64
80
  sessionFile: pi.sessionFile,
65
81
  sessionName: pi.sessionName,
82
+ firstMessage: SessionInfoUtil.firstMessage(pi.messages),
66
83
  model: model ? `${model.provider}/${model.id}` : undefined,
67
84
  isStreaming: pi.isStreaming,
68
85
  messageCount: pi.messages.length,
69
86
  attached: this.channels.size,
70
87
  createdAt: this.createdAt,
88
+ updatedAt: SessionInfoUtil.updatedAt(pi.messages, this.createdAt),
89
+ group: this.context.group,
71
90
  };
72
91
  }
73
92
 
@@ -75,7 +94,14 @@ export class TaSession {
75
94
  this.channels.add(channel);
76
95
  this.watchIdle();
77
96
  const { events, gap } = afterSeq === undefined ? { events: [], gap: false } : this.log.since(afterSeq);
78
- return { info: this.info(), events, pendingUi: this.ui.pendingRequests, lastSeq: this.log.lastSeq, gap };
97
+ return {
98
+ info: this.info(),
99
+ events,
100
+ pendingUi: this.ui.pendingRequests,
101
+ pendingClientTools: this.context.clientTools.pendingRequests,
102
+ lastSeq: this.log.lastSeq,
103
+ gap,
104
+ };
79
105
  }
80
106
 
81
107
  detach(channel: ClientChannel): void {
@@ -88,6 +114,10 @@ export class TaSession {
88
114
  return this.ui.respond(response);
89
115
  }
90
116
 
117
+ respondClientTool(result: TaClientToolResult): boolean {
118
+ return this.context.clientTools.respond(result);
119
+ }
120
+
91
121
  prompt(input: TaPromptInput): Promise<TaPromptReceipt> {
92
122
  return this.accept(
93
123
  input,
@@ -114,9 +144,19 @@ export class TaSession {
114
144
  return this.accept(input, () => this.pi.followUp(input.message, input.images, { source: 'rpc' }));
115
145
  }
116
146
 
147
+ /** pi's runtime says nothing of a move in the tree: the clients are told to read the conversation again. */
148
+ async navigateTree(targetId: string, options?: Parameters<AgentSession['navigateTree']>[1]): Promise<TaNavigateResult> {
149
+ const { cancelled, editorText } = await this.pi.navigateTree(targetId, options);
150
+ if (!cancelled) {
151
+ this.publish({ type: 'session_replaced', info: this.info() });
152
+ }
153
+ return { cancelled, editorText };
154
+ }
155
+
117
156
  async close(): Promise<void> {
118
157
  clearTimeout(this.idleTimer);
119
158
  this.ui.cancelAll();
159
+ this.context.clientTools.cancelAll();
120
160
  this.publish({ type: 'session_closed' });
121
161
  this.channels.clear();
122
162
  this.unsubscribe?.();
@@ -152,7 +192,7 @@ export class TaSession {
152
192
  waitForIdle: () => pi.waitForIdle(),
153
193
  newSession: options => runtime.newSession(options),
154
194
  fork: async (entryId, options) => ({ cancelled: (await runtime.fork(entryId, options)).cancelled }),
155
- navigateTree: async (targetId, options) => ({ cancelled: (await pi.navigateTree(targetId, options)).cancelled }),
195
+ navigateTree: async (targetId, options) => ({ cancelled: (await this.navigateTree(targetId, options)).cancelled }),
156
196
  switchSession: (sessionPath, options) => runtime.switchSession(sessionPath, options),
157
197
  reload: () => pi.reload(),
158
198
  },
@@ -0,0 +1,18 @@
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
+ }
@@ -0,0 +1,84 @@
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
+ });
@@ -0,0 +1,259 @@
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(options.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
+ }
@@ -0,0 +1,78 @@
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
+ });