@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,168 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import type { RpcExtensionUIRequest, RpcExtensionUIResponse, TaEvent } from '@celljs/ta-protocol';
3
-
4
- type ExtensionUIContext = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).ExtensionUIContext;
5
- type DialogOptions = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).ExtensionUIDialogOptions;
6
- type Theme = ExtensionUIContext['theme'];
7
-
8
- interface PendingDialog {
9
- request: RpcExtensionUIRequest;
10
- settle(response: RpcExtensionUIResponse | undefined): void;
11
- }
12
-
13
- type DialogRequest = RpcExtensionUIRequest extends infer R ? (R extends { id: string } ? Omit<R, 'id' | 'type'> : never) : never;
14
-
15
- const TEXT_STYLES = new Set(['fg', 'bg', 'bold', 'italic', 'underline', 'strikethrough', 'inverse']);
16
-
17
- /** Clients draw their own UI: an extension's styled text reaches them without ANSI codes. */
18
- const PLAIN_THEME = new Proxy(
19
- {},
20
- {
21
- get: (_target, name) => (TEXT_STYLES.has(String(name)) ? (...args: string[]) => args[args.length - 1] : () => ''),
22
- },
23
- ) as Theme;
24
-
25
- /**
26
- * pi's extension UI for clients that are not this process. It has the shape of pi's RPC mode, with one
27
- * difference: a dialog goes to every attached client, the first answer counts, and the others are told.
28
- * A dialog nobody answers ends at its timeout, as the extension asked.
29
- */
30
- export class RemoteUiContext implements ExtensionUIContext {
31
- protected readonly pending = new Map<string, PendingDialog>();
32
-
33
- readonly theme = PLAIN_THEME;
34
-
35
- constructor(protected readonly publish: (event: TaEvent) => void) {}
36
-
37
- get pendingRequests(): RpcExtensionUIRequest[] {
38
- return [...this.pending.values()].map(dialog => dialog.request);
39
- }
40
-
41
- /** False when the dialog was answered before or ended. */
42
- respond(response: RpcExtensionUIResponse): boolean {
43
- const dialog = this.pending.get(response.id);
44
- dialog?.settle(response);
45
- return dialog !== undefined;
46
- }
47
-
48
- /** Ends the open dialogs as if they timed out: the extensions go on, with their defaults. */
49
- cancelAll(): void {
50
- for (const dialog of [...this.pending.values()]) {
51
- dialog.settle(undefined);
52
- }
53
- }
54
-
55
- select(title: string, options: string[], opts?: DialogOptions): Promise<string | undefined> {
56
- return this.dialog({ method: 'select', title, options, timeout: opts?.timeout }, opts, undefined, r => ('value' in r ? r.value : undefined));
57
- }
58
-
59
- confirm(title: string, message: string, opts?: DialogOptions): Promise<boolean> {
60
- return this.dialog({ method: 'confirm', title, message, timeout: opts?.timeout }, opts, false, r => ('confirmed' in r ? r.confirmed : false));
61
- }
62
-
63
- input(title: string, placeholder?: string, opts?: DialogOptions): Promise<string | undefined> {
64
- return this.dialog({ method: 'input', title, placeholder, timeout: opts?.timeout }, opts, undefined, r => ('value' in r ? r.value : undefined));
65
- }
66
-
67
- editor(title: string, prefill?: string): Promise<string | undefined> {
68
- return this.dialog({ method: 'editor', title, prefill }, undefined, undefined, r => ('value' in r ? r.value : undefined));
69
- }
70
-
71
- notify(message: string, type?: 'info' | 'warning' | 'error'): void {
72
- this.tell({ method: 'notify', message, notifyType: type });
73
- }
74
-
75
- setStatus(key: string, text: string | undefined): void {
76
- this.tell({ method: 'setStatus', statusKey: key, statusText: text });
77
- }
78
-
79
- setWidget(key: string, content: unknown, options?: { placement?: 'aboveEditor' | 'belowEditor' }): void {
80
- // Clients cannot run a component factory; pi's RPC mode ignores those too.
81
- if (content === undefined || Array.isArray(content)) {
82
- this.tell({ method: 'setWidget', widgetKey: key, widgetLines: content, widgetPlacement: options?.placement });
83
- }
84
- }
85
-
86
- setTitle(title: string): void {
87
- this.tell({ method: 'setTitle', title });
88
- }
89
-
90
- setEditorText(text: string): void {
91
- this.tell({ method: 'set_editor_text', text });
92
- }
93
-
94
- pasteToEditor(text: string): void {
95
- this.setEditorText(text);
96
- }
97
-
98
- getEditorText(): string {
99
- return '';
100
- }
101
-
102
- // What needs a terminal in this process does nothing, as in pi's RPC mode.
103
- onTerminalInput(): () => void {
104
- return () => undefined;
105
- }
106
- setWorkingMessage(): void {}
107
- setWorkingVisible(): void {}
108
- setWorkingIndicator(): void {}
109
- setHiddenThinkingLabel(): void {}
110
- setFooter(): void {}
111
- setHeader(): void {}
112
- addAutocompleteProvider(): void {}
113
- setEditorComponent(): void {}
114
- getEditorComponent(): undefined {
115
- return undefined;
116
- }
117
- async custom(): Promise<never> {
118
- return undefined as never;
119
- }
120
- getAllThemes(): [] {
121
- return [];
122
- }
123
- getTheme(): undefined {
124
- return undefined;
125
- }
126
- setTheme(): { success: boolean; error: string } {
127
- return { success: false, error: 'Clients of ta serve choose their own theme.' };
128
- }
129
- getToolsExpanded(): boolean {
130
- return false;
131
- }
132
- setToolsExpanded(): void {}
133
-
134
- protected tell(request: DialogRequest): void {
135
- this.publish({ type: 'extension_ui_request', id: randomUUID(), ...request } as RpcExtensionUIRequest);
136
- }
137
-
138
- protected dialog<T>(
139
- request: DialogRequest,
140
- options: DialogOptions | undefined,
141
- fallback: T,
142
- parse: (response: Exclude<RpcExtensionUIResponse, { cancelled: true }>) => T,
143
- ): Promise<T> {
144
- if (options?.signal?.aborted) {
145
- return Promise.resolve(fallback);
146
- }
147
- const id = randomUUID();
148
- return new Promise<T>(resolve => {
149
- const settle = (response: RpcExtensionUIResponse | undefined) => {
150
- clearTimeout(timer);
151
- options?.signal?.removeEventListener('abort', onAbort);
152
- this.pending.delete(id);
153
- this.publish({ type: 'ui_request_resolved', id });
154
- resolve(
155
- !response || ('cancelled' in response && response.cancelled)
156
- ? fallback
157
- : parse(response as Exclude<RpcExtensionUIResponse, { cancelled: true }>),
158
- );
159
- };
160
- const onAbort = () => settle(undefined);
161
- const timer = options?.timeout ? setTimeout(onAbort, options.timeout) : undefined;
162
- options?.signal?.addEventListener('abort', onAbort, { once: true });
163
- const full = { type: 'extension_ui_request', id, ...request } as RpcExtensionUIRequest;
164
- this.pending.set(id, { request: full, settle });
165
- this.publish(full);
166
- });
167
- }
168
- }
@@ -1,23 +0,0 @@
1
- import { describe, expect, it } from 'bun:test';
2
- import { SessionInfoUtil } from './session-info-util';
3
-
4
- describe('SessionInfoUtil', () => {
5
- it('takes the first line with text of the first message of the user', () => {
6
- expect(
7
- SessionInfoUtil.firstMessage([
8
- { role: 'custom', content: 'not the user' },
9
- { role: 'user', content: [{ type: 'image' }] },
10
- { role: 'user', content: [{ type: 'image' }, { type: 'text', text: '\n Fix the login page \nand its tests' }] },
11
- { role: 'user', content: 'later' },
12
- ]),
13
- ).toBe('Fix the login page');
14
- expect(SessionInfoUtil.firstMessage([{ role: 'user', content: 'x'.repeat(200) }])).toHaveLength(120);
15
- expect(SessionInfoUtil.firstMessage([{ role: 'assistant', content: 'hi' }])).toBeUndefined();
16
- expect(SessionInfoUtil.firstMessage([{ role: 'user', content: '<context>\n[#web]\n</context>\n@dev hi' }])).toBe('@dev hi');
17
- });
18
-
19
- it('dates a conversation by its last message, or when it was opened', () => {
20
- expect(SessionInfoUtil.updatedAt([{ role: 'user', timestamp: 5 }, { role: 'assistant', timestamp: 9 }, { role: 'custom' }], 7)).toBe(9);
21
- expect(SessionInfoUtil.updatedAt([], 7)).toBe(7);
22
- });
23
- });
@@ -1,55 +0,0 @@
1
- import { TaMessageContext } from '@celljs/ta-protocol';
2
-
3
- /** What these functions read of pi's messages. */
4
- interface MessageLike {
5
- role: string;
6
- content?: unknown;
7
- timestamp?: number;
8
- }
9
-
10
- /** What a list of conversations shows of one: its first message, as pi's session list does, and when it last changed. */
11
- export namespace SessionInfoUtil {
12
- const LENGTH = 120;
13
-
14
- /** The first line of the first message of the user that has text, without its context, cut to a title's length. */
15
- export function firstMessage(messages: readonly MessageLike[]): string | undefined {
16
- for (const message of messages) {
17
- if (message.role !== 'user') {
18
- continue;
19
- }
20
- const line = TaMessageContext.strip(text(message.content))
21
- .split('\n')
22
- .map(part => part.trim())
23
- .find(Boolean);
24
- if (line) {
25
- return line.length > LENGTH ? `${line.slice(0, LENGTH - 1)}…` : line;
26
- }
27
- }
28
- return undefined;
29
- }
30
-
31
- /** The time of the last message that has one, else `fallback`. */
32
- export function updatedAt(messages: readonly MessageLike[], fallback: number): number {
33
- for (let i = messages.length - 1; i >= 0; i--) {
34
- const { timestamp } = messages[i];
35
- if (typeof timestamp === 'number') {
36
- return timestamp;
37
- }
38
- }
39
- return fallback;
40
- }
41
-
42
- /** The text of the content of a message. */
43
- export function text(content: unknown): string {
44
- if (typeof content === 'string') {
45
- return content;
46
- }
47
- if (!Array.isArray(content)) {
48
- return '';
49
- }
50
- return content
51
- .filter((part): part is { type: 'text'; text: string } => part?.type === 'text' && typeof part.text === 'string')
52
- .map(part => part.text)
53
- .join('\n');
54
- }
55
- }
@@ -1,72 +0,0 @@
1
- import { describe, expect, it } from 'bun:test';
2
- import { mkdtempSync } from 'node:fs';
3
- import { tmpdir } from 'node:os';
4
- import { join } from 'node:path';
5
- import { FileSessionStorage } from './file-session-storage';
6
- import { LeaseHeldError, StaleLeaseError } from './session-storage-protocol';
7
-
8
- const storage = () => new FileSessionStorage(mkdtempSync(join(tmpdir(), 'ta-sessions-')));
9
- const entry = (id: string) => ({ type: 'message', id });
10
-
11
- describe('FileSessionStorage', () => {
12
- it('keeps what the holder of the lease writes, in order', async () => {
13
- const store = storage();
14
- expect(await store.read('s1')).toBeUndefined();
15
- const lease = await store.acquire('s1', 'a', 1000);
16
- expect(lease.epoch).toBe(1);
17
- await store.write(lease, [{ type: 'session', id: 's1' }, entry('1')], { replace: true });
18
- await store.write(lease, [entry('2')]);
19
- expect((await store.read('s1'))?.map(e => e.id)).toEqual(['s1', '1', '2']);
20
- await store.write(lease, [entry('x')], { replace: true });
21
- expect((await store.read('s1'))?.map(e => e.id)).toEqual(['x']);
22
- });
23
-
24
- it('does not give a live lease to another holder, unless it takes the session over', async () => {
25
- const store = storage();
26
- const first = await store.acquire('s1', 'a', 60000);
27
- await expect(store.acquire('s1', 'b', 60000)).rejects.toBeInstanceOf(LeaseHeldError);
28
- const second = await store.acquire('s1', 'b', 60000, { takeOver: true });
29
- expect(second.epoch).toBe(first.epoch + 1);
30
- });
31
-
32
- it('lets another holder take an expired or released lease, with a higher epoch', async () => {
33
- const store = storage();
34
- const first = await store.acquire('s1', 'a', 1);
35
- await Bun.sleep(5);
36
- const second = await store.acquire('s1', 'b', 60000);
37
- await store.release(second);
38
- const third = await store.acquire('s1', 'c', 60000);
39
- expect([first.epoch, second.epoch, third.epoch]).toEqual([1, 2, 3]);
40
- });
41
-
42
- it('refuses the writes and renewals of a holder that lost the session, and writes nothing of them', async () => {
43
- const store = storage();
44
- const old = await store.acquire('s1', 'a', 60000);
45
- await store.write(old, [entry('1')]);
46
- const taken = await store.acquire('s1', 'b', 60000, { takeOver: true });
47
- await expect(store.write(old, [entry('late')])).rejects.toBeInstanceOf(StaleLeaseError);
48
- await expect(store.renew(old, 60000)).rejects.toBeInstanceOf(StaleLeaseError);
49
- await store.release(old);
50
- await store.write(taken, [entry('2')]);
51
- expect((await store.read('s1'))?.map(e => e.id)).toEqual(['1', '2']);
52
- });
53
-
54
- it('gives one lease of an epoch when holders race for it', async () => {
55
- const store = storage();
56
- const results = await Promise.allSettled(['a', 'b', 'c', 'd'].map(holder => store.acquire('s1', holder, 60000)));
57
- expect(results.filter(result => result.status === 'fulfilled')).toHaveLength(1);
58
- });
59
-
60
- it('skips a line cut off by a crash', async () => {
61
- const store = storage();
62
- const lease = await store.acquire('s1', 'a', 1000);
63
- await store.write(lease, [entry('1')]);
64
- const { appendFileSync } = await import('node:fs');
65
- appendFileSync(join((store as unknown as { dir: string }).dir, 's1.jsonl'), '{"type":"mess');
66
- expect((await store.read('s1'))?.map(e => e.id)).toEqual(['1']);
67
- });
68
-
69
- it('refuses ids that are not names of a file in its directory', async () => {
70
- await expect(storage().acquire('../x', 'a', 1000)).rejects.toThrow('Not a session id');
71
- });
72
- });
@@ -1,145 +0,0 @@
1
- import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { type SessionLease, SessionLeaseUtil, StaleLeaseError, type StoredEntry, type TaSessionStorage } from './session-storage-protocol';
4
-
5
- const LOCK_WAIT_MS = 5;
6
- const LOCK_TIMEOUT_MS = 5000;
7
- /** A lock older than this was left by a process that died holding it. */
8
- const STALE_LOCK_MS = 10000;
9
- const SESSION_ID = /^[A-Za-z0-9_-]{1,128}$/;
10
-
11
- /**
12
- * Sessions in a directory, which processes of this machine or of a shared file system can share:
13
- * `<id>.jsonl` (pi's format) and `<id>.lease.json`. A lock directory makes each operation atomic; a
14
- * cloud implementation does the same with conditional writes.
15
- */
16
- export class FileSessionStorage implements TaSessionStorage {
17
- constructor(protected readonly dir: string) {
18
- mkdirSync(dir, { recursive: true });
19
- }
20
-
21
- acquire(sessionId: string, holder: string, ttlMs: number, options: { takeOver?: boolean } = {}): Promise<SessionLease> {
22
- return this.locked(sessionId, () => {
23
- const lease = SessionLeaseUtil.next(this.lease(sessionId), sessionId, holder, ttlMs, options.takeOver);
24
- this.writeLease(lease);
25
- return lease;
26
- });
27
- }
28
-
29
- renew(lease: SessionLease, ttlMs: number): Promise<SessionLease> {
30
- return this.locked(lease.sessionId, () => {
31
- this.check(lease);
32
- const renewed = { ...lease, expiresAt: Date.now() + ttlMs };
33
- this.writeLease(renewed);
34
- return renewed;
35
- });
36
- }
37
-
38
- release(lease: SessionLease): Promise<void> {
39
- return this.locked(lease.sessionId, () => {
40
- if (SessionLeaseUtil.isCurrent(lease, this.lease(lease.sessionId))) {
41
- // The epoch stays, so that the next holder's is still higher.
42
- this.writeLease({ ...lease, expiresAt: 0 });
43
- }
44
- });
45
- }
46
-
47
- async read(sessionId: string): Promise<StoredEntry[] | undefined> {
48
- const file = this.file(sessionId, 'jsonl');
49
- if (!existsSync(file)) {
50
- return undefined;
51
- }
52
- // A line cut off by a crash in the middle of an append is left out, as pi does.
53
- return readFileSync(file, 'utf8')
54
- .split('\n')
55
- .filter(line => line.trim())
56
- .flatMap(line => {
57
- try {
58
- return [JSON.parse(line) as StoredEntry];
59
- } catch {
60
- return [];
61
- }
62
- });
63
- }
64
-
65
- write(lease: SessionLease, entries: StoredEntry[], options: { replace?: boolean } = {}): Promise<void> {
66
- return this.locked(lease.sessionId, () => {
67
- this.check(lease);
68
- const text = entries.map(entry => `${JSON.stringify(entry)}\n`).join('');
69
- const file = this.file(lease.sessionId, 'jsonl');
70
- if (options.replace) {
71
- this.replaceFile(file, text);
72
- } else {
73
- appendFileSync(file, text, { mode: 0o600 });
74
- }
75
- });
76
- }
77
-
78
- protected check(lease: SessionLease): void {
79
- if (!SessionLeaseUtil.isCurrent(lease, this.lease(lease.sessionId))) {
80
- throw new StaleLeaseError(lease);
81
- }
82
- }
83
-
84
- protected lease(sessionId: string): SessionLease | undefined {
85
- try {
86
- return JSON.parse(readFileSync(this.file(sessionId, 'lease.json'), 'utf8')) as SessionLease;
87
- } catch {
88
- return undefined;
89
- }
90
- }
91
-
92
- protected writeLease(lease: SessionLease): void {
93
- this.replaceFile(this.file(lease.sessionId, 'lease.json'), JSON.stringify(lease));
94
- }
95
-
96
- protected replaceFile(file: string, text: string): void {
97
- const temporary = `${file}.${process.pid}.tmp`;
98
- writeFileSync(temporary, text, { mode: 0o600 });
99
- renameSync(temporary, file);
100
- }
101
-
102
- protected file(sessionId: string, extension: string): string {
103
- if (!SESSION_ID.test(sessionId)) {
104
- throw new Error(`Not a session id: ${sessionId}`);
105
- }
106
- return join(this.dir, `${sessionId}.${extension}`);
107
- }
108
-
109
- /** Runs `action` holding `<id>.lock`, a directory: creating one is atomic on every file system. */
110
- protected async locked<T>(sessionId: string, action: () => T): Promise<T> {
111
- const lock = this.file(sessionId, 'lock');
112
- const deadline = Date.now() + LOCK_TIMEOUT_MS;
113
- for (;;) {
114
- try {
115
- mkdirSync(lock);
116
- break;
117
- } catch (error) {
118
- if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {
119
- throw error;
120
- }
121
- if (this.isStale(lock)) {
122
- rmSync(lock, { recursive: true, force: true });
123
- continue;
124
- }
125
- if (Date.now() > deadline) {
126
- throw new Error(`The session ${sessionId} stayed locked for ${LOCK_TIMEOUT_MS} ms.`);
127
- }
128
- await new Promise(resolve => setTimeout(resolve, LOCK_WAIT_MS));
129
- }
130
- }
131
- try {
132
- return action();
133
- } finally {
134
- rmSync(lock, { recursive: true, force: true });
135
- }
136
- }
137
-
138
- protected isStale(lock: string): boolean {
139
- try {
140
- return Date.now() - statSync(lock).mtimeMs > STALE_LOCK_MS;
141
- } catch {
142
- return false;
143
- }
144
- }
145
- }
@@ -1,3 +0,0 @@
1
- export * from './file-session-storage';
2
- export * from './session-storage-protocol';
3
- export * from './stored-session';
@@ -1,81 +0,0 @@
1
- /** A line of a pi session file: its header, or an entry. The storage keeps them as they are. */
2
- export type StoredEntry = { type: string } & Record<string, unknown>;
3
-
4
- /**
5
- * The right of one holder (a ta serve) to write a session. The epoch grows by one each time a holder
6
- * takes the session, and every write names it: a holder that lost the session to another can no longer
7
- * write, even if it does not know yet (it was paused, or cut off). The expiry only says when another may
8
- * take the session without being asked to take it over.
9
- */
10
- export interface SessionLease {
11
- sessionId: string;
12
- holder: string;
13
- epoch: number;
14
- /** `Date.now()` time. */
15
- expiresAt: number;
16
- }
17
-
18
- export const TaSessionStorage = Symbol('TaSessionStorage');
19
-
20
- /**
21
- * Where sessions are kept when they are not pi's files on this machine, for example in the cloud, where
22
- * any of several ta serve may take a session over. Implementations make every write conditional on the
23
- * epoch of the lease (a conditional write in a database, a compare-and-swap in a key-value store).
24
- */
25
- export interface TaSessionStorage {
26
- /** A new lease, one epoch after the last. LeaseHeldError while another holder's lease is live, unless `takeOver`. */
27
- acquire(sessionId: string, holder: string, ttlMs: number, options?: { takeOver?: boolean }): Promise<SessionLease>;
28
- /** The same lease for longer. StaleLeaseError if another holder took the session since. */
29
- renew(lease: SessionLease, ttlMs: number): Promise<SessionLease>;
30
- /** Lets another take the session at once. Does nothing if the lease is no longer the current one. */
31
- release(lease: SessionLease): Promise<void>;
32
- /** The entries of the session, or nothing if it has none. */
33
- read(sessionId: string): Promise<StoredEntry[] | undefined>;
34
- /** Adds entries, or replaces them all; StaleLeaseError, and nothing written, if the lease is not the current one. */
35
- write(lease: SessionLease, entries: StoredEntry[], options?: { replace?: boolean }): Promise<void>;
36
- }
37
-
38
- /** Another holder has a live lease on the session. */
39
- export class LeaseHeldError extends Error {
40
- readonly code = 'LEASE_HELD';
41
-
42
- constructor(readonly current: SessionLease) {
43
- super(`The session ${current.sessionId} is held by ${current.holder} until ${new Date(current.expiresAt).toISOString()}.`);
44
- this.name = 'LeaseHeldError';
45
- }
46
- }
47
-
48
- /** The lease was not the current one: another holder took the session. */
49
- export class StaleLeaseError extends Error {
50
- readonly code = 'STALE_LEASE';
51
-
52
- constructor(readonly lease: SessionLease) {
53
- super(`The lease of epoch ${lease.epoch} on the session ${lease.sessionId} is no longer current: another holder took it.`);
54
- this.name = 'StaleLeaseError';
55
- }
56
- }
57
-
58
- export namespace SessionLeaseUtil {
59
- export function isLive(lease: SessionLease | undefined, now = Date.now()): lease is SessionLease {
60
- return lease !== undefined && lease.expiresAt > now;
61
- }
62
-
63
- /** What `acquire` gives after `current`, or why it cannot. */
64
- export function next(
65
- current: SessionLease | undefined,
66
- sessionId: string,
67
- holder: string,
68
- ttlMs: number,
69
- takeOver = false,
70
- now = Date.now(),
71
- ): SessionLease {
72
- if (!takeOver && isLive(current, now) && current.holder !== holder) {
73
- throw new LeaseHeldError(current);
74
- }
75
- return { sessionId, holder, epoch: (current?.epoch ?? 0) + 1, expiresAt: now + ttlMs };
76
- }
77
-
78
- export function isCurrent(lease: SessionLease, current: SessionLease | undefined): boolean {
79
- return current !== undefined && current.epoch === lease.epoch && current.holder === lease.holder;
80
- }
81
- }
@@ -1,80 +0,0 @@
1
- import { describe, expect, it } from 'bun:test';
2
- import { mkdtempSync } from 'node:fs';
3
- import { tmpdir } from 'node:os';
4
- import { join } from 'node:path';
5
- import { PiSdkUtil } from '@celljs/ai-coding-agent/lib/node/pi/pi-sdk-util';
6
- import { FileSessionStorage } from './file-session-storage';
7
- import { LeaseHeldError, StaleLeaseError } from './session-storage-protocol';
8
- import { StoredSession } from './stored-session';
9
-
10
- const user = (text: string) => ({ role: 'user' as const, content: text, timestamp: Date.now() });
11
- /** The text of the messages among entries. */
12
- const texts = (entries: unknown[] | undefined) =>
13
- (entries ?? []).flatMap(entry => {
14
- const { type, message } = entry as { type: string; message?: { content: unknown } };
15
- return type === 'message' ? [message?.content] : [];
16
- });
17
-
18
- async function setup() {
19
- const { SessionManager } = await PiSdkUtil.load();
20
- const storage = new FileSessionStorage(mkdtempSync(join(tmpdir(), 'ta-stored-')));
21
- const open = (holder: string, takeOver = false) =>
22
- StoredSession.open(SessionManager, { storage, sessionId: 'session-1', cwd: '/w', holder, takeOver, leaseMs: 60000 });
23
- return { storage, open };
24
- }
25
-
26
- describe('StoredSession', () => {
27
- it('stores nothing before the first message, then what pi adds, and opens it again elsewhere', async () => {
28
- const { storage, open } = await setup();
29
- const first = await open('host-a');
30
- first.manager.appendModelChange('p', 'm');
31
- await first.flush();
32
- expect(await storage.read('session-1')).toBeUndefined();
33
- first.manager.appendMessage(user('hello'));
34
- first.manager.appendMessage(user('again'));
35
- await first.flush();
36
- const stored = await storage.read('session-1');
37
- expect(stored?.map(entry => entry.type)).toEqual(['session', 'model_change', 'message', 'message']);
38
- expect(first.manager.getSessionId()).toBe('session-1');
39
- await first.close();
40
-
41
- const second = await open('host-b');
42
- expect(second.epoch).toBe(2);
43
- expect(second.manager.getEntries()).toHaveLength(3);
44
- second.manager.appendMessage(user('from b'));
45
- await second.flush();
46
- expect(await storage.read('session-1')).toHaveLength(5);
47
- await second.close();
48
- });
49
-
50
- it('is not opened by another while it is held', async () => {
51
- const { open } = await setup();
52
- const first = await open('host-a');
53
- await expect(open('host-b')).rejects.toBeInstanceOf(LeaseHeldError);
54
- await first.close();
55
- });
56
-
57
- it('stops the holder that lost the session: its writes do not land, and pi gets an error', async () => {
58
- const { storage, open } = await setup();
59
- const old = await open('host-a');
60
- old.manager.appendMessage(user('one'));
61
- await old.flush();
62
- const lost: Error[] = [];
63
- old.onLost(error => lost.push(error));
64
-
65
- const taker = await open('host-b', true);
66
- old.manager.appendMessage(user('late'));
67
- await expect(old.flush()).rejects.toBeInstanceOf(StaleLeaseError);
68
- expect(lost).toHaveLength(1);
69
- expect(() => old.manager.appendMessage(user('later'))).toThrow(StaleLeaseError);
70
- // pi keeps its memory in line with what was written.
71
- expect(texts(old.manager.getEntries())).toEqual(['one', 'late']);
72
-
73
- taker.manager.appendMessage(user('two'));
74
- await taker.flush();
75
- const stored = await storage.read('session-1');
76
- expect(texts(stored)).toEqual(['one', 'two']);
77
- await old.close();
78
- await taker.close();
79
- });
80
- });