@celljs/ta-host 4.5.0 → 4.6.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 (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
@@ -0,0 +1,143 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FileSessionStorage = void 0;
4
+ const node_fs_1 = require("node:fs");
5
+ const node_path_1 = require("node:path");
6
+ const session_storage_protocol_1 = require("./session-storage-protocol");
7
+ const LOCK_WAIT_MS = 5;
8
+ const LOCK_TIMEOUT_MS = 5000;
9
+ /** A lock older than this was left by a process that died holding it. */
10
+ const STALE_LOCK_MS = 10000;
11
+ const SESSION_ID = /^[A-Za-z0-9_-]{1,128}$/;
12
+ /**
13
+ * Sessions in a directory, which processes of this machine or of a shared file system can share:
14
+ * `<id>.jsonl` (pi's format) and `<id>.lease.json`. A lock directory makes each operation atomic; a
15
+ * cloud implementation does the same with conditional writes.
16
+ */
17
+ class FileSessionStorage {
18
+ constructor(dir) {
19
+ this.dir = dir;
20
+ (0, node_fs_1.mkdirSync)(dir, { recursive: true });
21
+ }
22
+ acquire(sessionId, holder, ttlMs, options = {}) {
23
+ return this.locked(sessionId, () => {
24
+ const lease = session_storage_protocol_1.SessionLeaseUtil.next(this.lease(sessionId), sessionId, holder, ttlMs, options.takeOver);
25
+ this.writeLease(lease);
26
+ return lease;
27
+ });
28
+ }
29
+ renew(lease, ttlMs) {
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
+ release(lease) {
38
+ return this.locked(lease.sessionId, () => {
39
+ if (session_storage_protocol_1.SessionLeaseUtil.isCurrent(lease, this.lease(lease.sessionId))) {
40
+ // The epoch stays, so that the next holder's is still higher.
41
+ this.writeLease({ ...lease, expiresAt: 0 });
42
+ }
43
+ });
44
+ }
45
+ async read(sessionId) {
46
+ const file = this.file(sessionId, 'jsonl');
47
+ if (!(0, node_fs_1.existsSync)(file)) {
48
+ return undefined;
49
+ }
50
+ // A line cut off by a crash in the middle of an append is left out, as pi does.
51
+ return (0, node_fs_1.readFileSync)(file, 'utf8')
52
+ .split('\n')
53
+ .filter(line => line.trim())
54
+ .flatMap(line => {
55
+ try {
56
+ return [JSON.parse(line)];
57
+ }
58
+ catch (_a) {
59
+ return [];
60
+ }
61
+ });
62
+ }
63
+ write(lease, entries, options = {}) {
64
+ return this.locked(lease.sessionId, () => {
65
+ this.check(lease);
66
+ const text = entries.map(entry => `${JSON.stringify(entry)}\n`).join('');
67
+ const file = this.file(lease.sessionId, 'jsonl');
68
+ if (options.replace) {
69
+ this.replaceFile(file, text);
70
+ }
71
+ else {
72
+ (0, node_fs_1.appendFileSync)(file, text, { mode: 0o600 });
73
+ }
74
+ });
75
+ }
76
+ check(lease) {
77
+ if (!session_storage_protocol_1.SessionLeaseUtil.isCurrent(lease, this.lease(lease.sessionId))) {
78
+ throw new session_storage_protocol_1.StaleLeaseError(lease);
79
+ }
80
+ }
81
+ lease(sessionId) {
82
+ try {
83
+ return JSON.parse((0, node_fs_1.readFileSync)(this.file(sessionId, 'lease.json'), 'utf8'));
84
+ }
85
+ catch (_a) {
86
+ return undefined;
87
+ }
88
+ }
89
+ writeLease(lease) {
90
+ this.replaceFile(this.file(lease.sessionId, 'lease.json'), JSON.stringify(lease));
91
+ }
92
+ replaceFile(file, text) {
93
+ const temporary = `${file}.${process.pid}.tmp`;
94
+ (0, node_fs_1.writeFileSync)(temporary, text, { mode: 0o600 });
95
+ (0, node_fs_1.renameSync)(temporary, file);
96
+ }
97
+ file(sessionId, extension) {
98
+ if (!SESSION_ID.test(sessionId)) {
99
+ throw new Error(`Not a session id: ${sessionId}`);
100
+ }
101
+ return (0, node_path_1.join)(this.dir, `${sessionId}.${extension}`);
102
+ }
103
+ /** Runs `action` holding `<id>.lock`, a directory: creating one is atomic on every file system. */
104
+ async locked(sessionId, action) {
105
+ const lock = this.file(sessionId, 'lock');
106
+ const deadline = Date.now() + LOCK_TIMEOUT_MS;
107
+ for (;;) {
108
+ try {
109
+ (0, node_fs_1.mkdirSync)(lock);
110
+ break;
111
+ }
112
+ catch (error) {
113
+ if (error.code !== 'EEXIST') {
114
+ throw error;
115
+ }
116
+ if (this.isStale(lock)) {
117
+ (0, node_fs_1.rmSync)(lock, { recursive: true, force: true });
118
+ continue;
119
+ }
120
+ if (Date.now() > deadline) {
121
+ throw new Error(`The session ${sessionId} stayed locked for ${LOCK_TIMEOUT_MS} ms.`);
122
+ }
123
+ await new Promise(resolve => setTimeout(resolve, LOCK_WAIT_MS));
124
+ }
125
+ }
126
+ try {
127
+ return action();
128
+ }
129
+ finally {
130
+ (0, node_fs_1.rmSync)(lock, { recursive: true, force: true });
131
+ }
132
+ }
133
+ isStale(lock) {
134
+ try {
135
+ return Date.now() - (0, node_fs_1.statSync)(lock).mtimeMs > STALE_LOCK_MS;
136
+ }
137
+ catch (_a) {
138
+ return false;
139
+ }
140
+ }
141
+ }
142
+ exports.FileSessionStorage = FileSessionStorage;
143
+ //# sourceMappingURL=file-session-storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-session-storage.js","sourceRoot":"","sources":["../../../src/node/session-storage/file-session-storage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=file-session-storage.spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-session-storage.spec.d.ts","sourceRoot":"","sources":["../../../src/node/session-storage/file-session-storage.spec.ts"],"names":[],"mappings":""}
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const bun_test_1 = require("bun:test");
4
+ const node_fs_1 = require("node:fs");
5
+ const node_os_1 = require("node:os");
6
+ const node_path_1 = require("node:path");
7
+ const file_session_storage_1 = require("./file-session-storage");
8
+ const session_storage_protocol_1 = require("./session-storage-protocol");
9
+ const storage = () => new file_session_storage_1.FileSessionStorage((0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'ta-sessions-')));
10
+ const entry = (id) => ({ type: 'message', id });
11
+ (0, bun_test_1.describe)('FileSessionStorage', () => {
12
+ (0, bun_test_1.it)('keeps what the holder of the lease writes, in order', async () => {
13
+ var _a, _b;
14
+ const store = storage();
15
+ (0, bun_test_1.expect)(await store.read('s1')).toBeUndefined();
16
+ const lease = await store.acquire('s1', 'a', 1000);
17
+ (0, bun_test_1.expect)(lease.epoch).toBe(1);
18
+ await store.write(lease, [{ type: 'session', id: 's1' }, entry('1')], { replace: true });
19
+ await store.write(lease, [entry('2')]);
20
+ (0, bun_test_1.expect)((_a = (await store.read('s1'))) === null || _a === void 0 ? void 0 : _a.map(e => e.id)).toEqual(['s1', '1', '2']);
21
+ await store.write(lease, [entry('x')], { replace: true });
22
+ (0, bun_test_1.expect)((_b = (await store.read('s1'))) === null || _b === void 0 ? void 0 : _b.map(e => e.id)).toEqual(['x']);
23
+ });
24
+ (0, bun_test_1.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 (0, bun_test_1.expect)(store.acquire('s1', 'b', 60000)).rejects.toBeInstanceOf(session_storage_protocol_1.LeaseHeldError);
28
+ const second = await store.acquire('s1', 'b', 60000, { takeOver: true });
29
+ (0, bun_test_1.expect)(second.epoch).toBe(first.epoch + 1);
30
+ });
31
+ (0, bun_test_1.it)('lets another holder take an expired or released lease, with a higher epoch', async () => {
32
+ const store = storage();
33
+ const first = await store.acquire('s1', 'a', 1);
34
+ await Bun.sleep(5);
35
+ const second = await store.acquire('s1', 'b', 60000);
36
+ await store.release(second);
37
+ const third = await store.acquire('s1', 'c', 60000);
38
+ (0, bun_test_1.expect)([first.epoch, second.epoch, third.epoch]).toEqual([1, 2, 3]);
39
+ });
40
+ (0, bun_test_1.it)('refuses the writes and renewals of a holder that lost the session, and writes nothing of them', async () => {
41
+ var _a;
42
+ const store = storage();
43
+ const old = await store.acquire('s1', 'a', 60000);
44
+ await store.write(old, [entry('1')]);
45
+ const taken = await store.acquire('s1', 'b', 60000, { takeOver: true });
46
+ await (0, bun_test_1.expect)(store.write(old, [entry('late')])).rejects.toBeInstanceOf(session_storage_protocol_1.StaleLeaseError);
47
+ await (0, bun_test_1.expect)(store.renew(old, 60000)).rejects.toBeInstanceOf(session_storage_protocol_1.StaleLeaseError);
48
+ await store.release(old);
49
+ await store.write(taken, [entry('2')]);
50
+ (0, bun_test_1.expect)((_a = (await store.read('s1'))) === null || _a === void 0 ? void 0 : _a.map(e => e.id)).toEqual(['1', '2']);
51
+ });
52
+ (0, bun_test_1.it)('gives one lease of an epoch when holders race for it', async () => {
53
+ const store = storage();
54
+ const results = await Promise.allSettled(['a', 'b', 'c', 'd'].map(holder => store.acquire('s1', holder, 60000)));
55
+ (0, bun_test_1.expect)(results.filter(result => result.status === 'fulfilled')).toHaveLength(1);
56
+ });
57
+ (0, bun_test_1.it)('skips a line cut off by a crash', async () => {
58
+ var _a;
59
+ const store = storage();
60
+ const lease = await store.acquire('s1', 'a', 1000);
61
+ await store.write(lease, [entry('1')]);
62
+ const { appendFileSync } = await import('node:fs');
63
+ appendFileSync((0, node_path_1.join)(store.dir, 's1.jsonl'), '{"type":"mess');
64
+ (0, bun_test_1.expect)((_a = (await store.read('s1'))) === null || _a === void 0 ? void 0 : _a.map(e => e.id)).toEqual(['1']);
65
+ });
66
+ (0, bun_test_1.it)('refuses ids that are not names of a file in its directory', async () => {
67
+ await (0, bun_test_1.expect)(storage().acquire('../x', 'a', 1000)).rejects.toThrow('Not a session id');
68
+ });
69
+ });
70
+ //# sourceMappingURL=file-session-storage.spec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-session-storage.spec.js","sourceRoot":"","sources":["../../../src/node/session-storage/file-session-storage.spec.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export * from './file-session-storage';
2
+ export * from './session-storage-protocol';
3
+ export * from './stored-session';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/session-storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./file-session-storage"), exports);
18
+ __exportStar(require("./session-storage-protocol"), exports);
19
+ __exportStar(require("./stored-session"), exports);
20
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/session-storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,6DAA2C;AAC3C,mDAAiC"}
@@ -0,0 +1,58 @@
1
+ /** A line of a pi session file: its header, or an entry. The storage keeps them as they are. */
2
+ export type StoredEntry = {
3
+ type: string;
4
+ } & Record<string, unknown>;
5
+ /**
6
+ * The right of one holder (a ta serve) to write a session. The epoch grows by one each time a holder
7
+ * takes the session, and every write names it: a holder that lost the session to another can no longer
8
+ * write, even if it does not know yet (it was paused, or cut off). The expiry only says when another may
9
+ * take the session without being asked to take it over.
10
+ */
11
+ export interface SessionLease {
12
+ sessionId: string;
13
+ holder: string;
14
+ epoch: number;
15
+ /** `Date.now()` time. */
16
+ expiresAt: number;
17
+ }
18
+ export declare const TaSessionStorage: unique symbol;
19
+ /**
20
+ * Where sessions are kept when they are not pi's files on this machine, for example in the cloud, where
21
+ * any of several ta serve may take a session over. Implementations make every write conditional on the
22
+ * epoch of the lease (a conditional write in a database, a compare-and-swap in a key-value store).
23
+ */
24
+ export interface TaSessionStorage {
25
+ /** A new lease, one epoch after the last. LeaseHeldError while another holder's lease is live, unless `takeOver`. */
26
+ acquire(sessionId: string, holder: string, ttlMs: number, options?: {
27
+ takeOver?: boolean;
28
+ }): Promise<SessionLease>;
29
+ /** The same lease for longer. StaleLeaseError if another holder took the session since. */
30
+ renew(lease: SessionLease, ttlMs: number): Promise<SessionLease>;
31
+ /** Lets another take the session at once. Does nothing if the lease is no longer the current one. */
32
+ release(lease: SessionLease): Promise<void>;
33
+ /** The entries of the session, or nothing if it has none. */
34
+ read(sessionId: string): Promise<StoredEntry[] | undefined>;
35
+ /** Adds entries, or replaces them all; StaleLeaseError, and nothing written, if the lease is not the current one. */
36
+ write(lease: SessionLease, entries: StoredEntry[], options?: {
37
+ replace?: boolean;
38
+ }): Promise<void>;
39
+ }
40
+ /** Another holder has a live lease on the session. */
41
+ export declare class LeaseHeldError extends Error {
42
+ readonly current: SessionLease;
43
+ readonly code = "LEASE_HELD";
44
+ constructor(current: SessionLease);
45
+ }
46
+ /** The lease was not the current one: another holder took the session. */
47
+ export declare class StaleLeaseError extends Error {
48
+ readonly lease: SessionLease;
49
+ readonly code = "STALE_LEASE";
50
+ constructor(lease: SessionLease);
51
+ }
52
+ export declare namespace SessionLeaseUtil {
53
+ function isLive(lease: SessionLease | undefined, now?: number): lease is SessionLease;
54
+ /** What `acquire` gives after `current`, or why it cannot. */
55
+ function next(current: SessionLease | undefined, sessionId: string, holder: string, ttlMs: number, takeOver?: boolean, now?: number): SessionLease;
56
+ function isCurrent(lease: SessionLease, current: SessionLease | undefined): boolean;
57
+ }
58
+ //# sourceMappingURL=session-storage-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-storage-protocol.d.ts","sourceRoot":"","sources":["../../../src/node/session-storage/session-storage-protocol.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qHAAqH;IACrH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnH,2FAA2F;IAC3F,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,qGAAqG;IACrG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6DAA6D;IAC7D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5D,qHAAqH;IACrH,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtG;AAED,sDAAsD;AACtD,qBAAa,cAAe,SAAQ,KAAK;IAGzB,QAAQ,CAAC,OAAO,EAAE,YAAY;IAF1C,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,YAAqB,OAAO,EAAE,YAAY,EAGzC;CACJ;AAED,0EAA0E;AAC1E,qBAAa,eAAgB,SAAQ,KAAK;IAG1B,QAAQ,CAAC,KAAK,EAAE,YAAY;IAFxC,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,YAAqB,KAAK,EAAE,YAAY,EAGvC;CACJ;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,SAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,KAAK,IAAI,YAAY,CAE/F;IAED,8DAA8D;IAC9D,SAAgB,IAAI,CAChB,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,UAAQ,EAChB,GAAG,SAAa,GACjB,YAAY,CAKd;IAED,SAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAEzF;CACJ"}
@@ -0,0 +1,45 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SessionLeaseUtil = exports.StaleLeaseError = exports.LeaseHeldError = exports.TaSessionStorage = void 0;
4
+ exports.TaSessionStorage = Symbol('TaSessionStorage');
5
+ /** Another holder has a live lease on the session. */
6
+ class LeaseHeldError extends Error {
7
+ constructor(current) {
8
+ super(`The session ${current.sessionId} is held by ${current.holder} until ${new Date(current.expiresAt).toISOString()}.`);
9
+ this.current = current;
10
+ this.code = 'LEASE_HELD';
11
+ this.name = 'LeaseHeldError';
12
+ }
13
+ }
14
+ exports.LeaseHeldError = LeaseHeldError;
15
+ /** The lease was not the current one: another holder took the session. */
16
+ class StaleLeaseError extends Error {
17
+ constructor(lease) {
18
+ super(`The lease of epoch ${lease.epoch} on the session ${lease.sessionId} is no longer current: another holder took it.`);
19
+ this.lease = lease;
20
+ this.code = 'STALE_LEASE';
21
+ this.name = 'StaleLeaseError';
22
+ }
23
+ }
24
+ exports.StaleLeaseError = StaleLeaseError;
25
+ var SessionLeaseUtil;
26
+ (function (SessionLeaseUtil) {
27
+ function isLive(lease, now = Date.now()) {
28
+ return lease !== undefined && lease.expiresAt > now;
29
+ }
30
+ SessionLeaseUtil.isLive = isLive;
31
+ /** What `acquire` gives after `current`, or why it cannot. */
32
+ function next(current, sessionId, holder, ttlMs, takeOver = false, now = Date.now()) {
33
+ var _a;
34
+ if (!takeOver && isLive(current, now) && current.holder !== holder) {
35
+ throw new LeaseHeldError(current);
36
+ }
37
+ return { sessionId, holder, epoch: ((_a = current === null || current === void 0 ? void 0 : current.epoch) !== null && _a !== void 0 ? _a : 0) + 1, expiresAt: now + ttlMs };
38
+ }
39
+ SessionLeaseUtil.next = next;
40
+ function isCurrent(lease, current) {
41
+ return current !== undefined && current.epoch === lease.epoch && current.holder === lease.holder;
42
+ }
43
+ SessionLeaseUtil.isCurrent = isCurrent;
44
+ })(SessionLeaseUtil || (exports.SessionLeaseUtil = SessionLeaseUtil = {}));
45
+ //# sourceMappingURL=session-storage-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-storage-protocol.js","sourceRoot":"","sources":["../../../src/node/session-storage/session-storage-protocol.ts"],"names":[],"mappings":";;;AAiBa,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAoB3D,sDAAsD;AACtD,oBAA4B,SAAQ,KAAK;IAGrC,YAAqB,OAAqB;QACtC,KAAK,CAAC,eAAe,OAAO,CAAC,SAAS,eAAe,OAAO,CAAC,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAD1G,YAAO,GAAP,OAAO,CAAc;QAFjC,SAAI,GAAG,YAAY,CAAC;QAIzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ;;AAED,0EAA0E;AAC1E,qBAA6B,SAAQ,KAAK;IAGtC,YAAqB,KAAmB;QACpC,KAAK,CAAC,sBAAsB,KAAK,CAAC,KAAK,mBAAmB,KAAK,CAAC,SAAS,gDAAgD,CAAC,CAAC;QAD1G,UAAK,GAAL,KAAK,CAAc;QAF/B,SAAI,GAAG,aAAa,CAAC;QAI1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;;AAED,IAAiB,gBAAgB,CAuBhC;AAvBD,WAAiB,gBAAgB;IAC7B,SAAgB,MAAM,CAAC,KAA+B,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACpE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;IACxD,CAAC;IAFe,iBAAA,MAAM,SAErB,CAAA;IAED,8DAA8D;IAC9D,SAAgB,IAAI,CAChB,OAAiC,EACjC,SAAiB,EACjB,MAAc,EACd,KAAa,EACb,QAAQ,GAAG,KAAK,EAChB,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;;QAEhB,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACjE,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC;IAC3F,CAAC;IAZe,iBAAA,IAAI,OAYnB,CAAA;IAED,SAAgB,SAAS,CAAC,KAAmB,EAAE,OAAiC;QAC5E,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;IACrG,CAAC;IAFe,iBAAA,SAAS,YAExB,CAAA;AACL,CAAC,EAvBgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAuBhC"}
@@ -0,0 +1,47 @@
1
+ import { type SessionLease, type StoredEntry, type TaSessionStorage } from './session-storage-protocol';
2
+ type SessionManager = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).SessionManager;
3
+ type SessionManagerClass = typeof import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).SessionManager;
4
+ export interface StoredSessionOptions {
5
+ storage: TaSessionStorage;
6
+ sessionId: string;
7
+ cwd: string;
8
+ /** This ta serve, as the storage knows it. */
9
+ holder: string;
10
+ /** How long a lease lasts without being renewed; it is renewed at a third of that. Default 30000. */
11
+ leaseMs?: number;
12
+ /** Takes the session even while another holder's lease is live. */
13
+ takeOver?: boolean;
14
+ }
15
+ /**
16
+ * A pi session kept in a TaSessionStorage rather than in a file: pi's SessionManager in memory, with
17
+ * what it would append to its file written to the storage under a lease. Writes go out in order, after
18
+ * pi added the entry; once the lease is lost, the next entry pi adds fails, as a failed write to its
19
+ * file does, and {@link onLost} tells the host to stop the session.
20
+ */
21
+ export declare class StoredSession {
22
+ readonly manager: SessionManager;
23
+ protected lease: SessionLease;
24
+ protected readonly options: StoredSessionOptions;
25
+ protected flushed: boolean;
26
+ protected writing: Promise<void>;
27
+ protected lost?: Error;
28
+ protected closed: boolean;
29
+ protected readonly renewTimer: ReturnType<typeof setInterval>;
30
+ protected readonly lostListeners: Set<(error: Error) => void>;
31
+ protected constructor(manager: SessionManager, lease: SessionLease, options: StoredSessionOptions, stored: boolean);
32
+ /** Takes the lease, and opens the session from what the storage has, or a new one with that id. */
33
+ static open(sessionManager: SessionManagerClass, options: StoredSessionOptions): Promise<StoredSession>;
34
+ get epoch(): number;
35
+ /** Runs once, when another holder took the session. */
36
+ onLost(listener: (error: Error) => void): () => void;
37
+ /** Resolves when what pi added so far is stored; rejects if it could not be. */
38
+ flush(): Promise<void>;
39
+ /** Stores what is left and lets another holder take the session at once. */
40
+ close(): Promise<void>;
41
+ protected persist(entry: StoredEntry): void;
42
+ protected enqueue(entries: StoredEntry[], replace: boolean): void;
43
+ protected renew(leaseMs: number): Promise<void>;
44
+ protected fail(error: unknown): void;
45
+ }
46
+ export {};
47
+ //# sourceMappingURL=stored-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stored-session.d.ts","sourceRoot":"","sources":["../../../src/node/session-storage/stored-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAmB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEzH,KAAK,cAAc,GAAG,OAAO,iCAAiC,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,cAAc,CAAC;AACzH,KAAK,mBAAmB,GAAG,cAAc,iCAAiC,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,cAAc,CAAC;AAOrI,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAID;;;;;GAKG;AACH,qBAAa,aAAa;IASlB,QAAQ,CAAC,OAAO,EAAE,cAAc;IAChC,SAAS,CAAC,KAAK,EAAE,YAAY;IAC7B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB;IAVpD,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAqB;IACrD,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACvB,SAAS,CAAC,MAAM,UAAS;IACzB,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,aAAa,cAAmB,KAAK,KAAK,IAAI,EAAI;IAErE,SAAS,aACI,OAAO,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACV,OAAO,EAAE,oBAAoB,EAChD,MAAM,EAAE,OAAO,EAQlB;IAED,mGAAmG;IACnG,OAAa,IAAI,CAAC,cAAc,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAW5G;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,uDAAuD;IACvD,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAGnD;IAED,gFAAgF;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3B;IAED,4EAA4E;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAED,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAkB1C;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAKhE;IAED,UAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpD;IAED,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CASnC;CACJ"}
@@ -0,0 +1,120 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StoredSession = void 0;
4
+ const session_storage_protocol_1 = require("./session-storage-protocol");
5
+ const DEFAULT_LEASE_MS = 30000;
6
+ /**
7
+ * A pi session kept in a TaSessionStorage rather than in a file: pi's SessionManager in memory, with
8
+ * what it would append to its file written to the storage under a lease. Writes go out in order, after
9
+ * pi added the entry; once the lease is lost, the next entry pi adds fails, as a failed write to its
10
+ * file does, and {@link onLost} tells the host to stop the session.
11
+ */
12
+ class StoredSession {
13
+ constructor(manager, lease, options, stored) {
14
+ var _a, _b;
15
+ var _c;
16
+ this.manager = manager;
17
+ this.lease = lease;
18
+ this.options = options;
19
+ this.writing = Promise.resolve();
20
+ this.closed = false;
21
+ this.lostListeners = new Set();
22
+ // pi writes nothing until the session has a message of the user or the model; neither does this.
23
+ this.flushed = stored;
24
+ const leaseMs = (_c = options.leaseMs) !== null && _c !== void 0 ? _c : DEFAULT_LEASE_MS;
25
+ this.renewTimer = setInterval(() => void this.renew(leaseMs), leaseMs / 3);
26
+ (_b = (_a = this.renewTimer).unref) === null || _b === void 0 ? void 0 : _b.call(_a);
27
+ manager._persist = entry => this.persist(entry);
28
+ }
29
+ /** Takes the lease, and opens the session from what the storage has, or a new one with that id. */
30
+ static async open(sessionManager, options) {
31
+ var _a;
32
+ const { storage, sessionId, holder, takeOver } = options;
33
+ const lease = await storage.acquire(sessionId, holder, (_a = options.leaseMs) !== null && _a !== void 0 ? _a : DEFAULT_LEASE_MS, { takeOver });
34
+ try {
35
+ const entries = await storage.read(sessionId);
36
+ const manager = sessionManager.inMemory(options.cwd, { id: sessionId }, entries);
37
+ return new StoredSession(manager, lease, options, entries !== undefined && entries.length > 0);
38
+ }
39
+ catch (error) {
40
+ await storage.release(lease);
41
+ throw error;
42
+ }
43
+ }
44
+ get epoch() {
45
+ return this.lease.epoch;
46
+ }
47
+ /** Runs once, when another holder took the session. */
48
+ onLost(listener) {
49
+ this.lostListeners.add(listener);
50
+ return () => this.lostListeners.delete(listener);
51
+ }
52
+ /** Resolves when what pi added so far is stored; rejects if it could not be. */
53
+ async flush() {
54
+ await this.writing;
55
+ if (this.lost) {
56
+ throw this.lost;
57
+ }
58
+ }
59
+ /** Stores what is left and lets another holder take the session at once. */
60
+ async close() {
61
+ if (this.closed) {
62
+ return;
63
+ }
64
+ this.closed = true;
65
+ clearInterval(this.renewTimer);
66
+ await this.writing.catch(() => undefined);
67
+ if (!this.lost) {
68
+ await this.options.storage.release(this.lease);
69
+ }
70
+ }
71
+ persist(entry) {
72
+ if (this.lost) {
73
+ throw this.lost;
74
+ }
75
+ if (this.closed) {
76
+ throw new Error(`The session ${this.options.sessionId} is closed.`);
77
+ }
78
+ if (!this.flushed) {
79
+ const entries = this.manager.getEntries();
80
+ if (!entries.some(candidate => candidate.type === 'message' && (candidate.message.role === 'user' || candidate.message.role === 'assistant'))) {
81
+ return;
82
+ }
83
+ this.flushed = true;
84
+ const header = this.manager.getHeader();
85
+ this.enqueue([...(header ? [header] : []), ...entries], true);
86
+ return;
87
+ }
88
+ this.enqueue([entry], false);
89
+ }
90
+ enqueue(entries, replace) {
91
+ const lease = this.lease;
92
+ this.writing = this.writing.then(() => this.lost ? undefined : this.options.storage.write(lease, entries, { replace }).catch(error => this.fail(error)));
93
+ }
94
+ async renew(leaseMs) {
95
+ if (this.lost || this.closed) {
96
+ return;
97
+ }
98
+ try {
99
+ this.lease = await this.options.storage.renew(this.lease, leaseMs);
100
+ }
101
+ catch (error) {
102
+ if (error instanceof session_storage_protocol_1.StaleLeaseError) {
103
+ this.fail(error);
104
+ }
105
+ // Other failures (the storage is unreachable) are tried again; the epoch guards the writes meanwhile.
106
+ }
107
+ }
108
+ fail(error) {
109
+ if (this.lost) {
110
+ return;
111
+ }
112
+ this.lost = error instanceof Error ? error : new Error(String(error));
113
+ clearInterval(this.renewTimer);
114
+ for (const listener of this.lostListeners) {
115
+ listener(this.lost);
116
+ }
117
+ }
118
+ }
119
+ exports.StoredSession = StoredSession;
120
+ //# sourceMappingURL=stored-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stored-session.js","sourceRoot":"","sources":["../../../src/node/session-storage/stored-session.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=stored-session.spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stored-session.spec.d.ts","sourceRoot":"","sources":["../../../src/node/session-storage/stored-session.spec.ts"],"names":[],"mappings":""}