@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,149 +0,0 @@
1
- import { type SessionLease, StaleLeaseError, type StoredEntry, type TaSessionStorage } from './session-storage-protocol';
2
-
3
- type SessionManager = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).SessionManager;
4
- type SessionManagerClass = typeof import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' }}).SessionManager;
5
-
6
- /** What pi's SessionManager calls for each entry it adds; public in its build, though not in its documentation. */
7
- interface Persisting {
8
- _persist(entry: StoredEntry): void;
9
- }
10
-
11
- export interface StoredSessionOptions {
12
- storage: TaSessionStorage;
13
- sessionId: string;
14
- cwd: string;
15
- /** This ta serve, as the storage knows it. */
16
- holder: string;
17
- /** How long a lease lasts without being renewed; it is renewed at a third of that. Default 30000. */
18
- leaseMs?: number;
19
- /** Takes the session even while another holder's lease is live. */
20
- takeOver?: boolean;
21
- }
22
-
23
- const DEFAULT_LEASE_MS = 30000;
24
-
25
- /**
26
- * A pi session kept in a TaSessionStorage rather than in a file: pi's SessionManager in memory, with
27
- * what it would append to its file written to the storage under a lease. Writes go out in order, after
28
- * pi added the entry; once the lease is lost, the next entry pi adds fails, as a failed write to its
29
- * file does, and {@link onLost} tells the host to stop the session.
30
- */
31
- export class StoredSession {
32
- protected flushed: boolean;
33
- protected writing: Promise<void> = Promise.resolve();
34
- protected lost?: Error;
35
- protected closed = false;
36
- protected readonly renewTimer: ReturnType<typeof setInterval>;
37
- protected readonly lostListeners = new Set<(error: Error) => void>();
38
-
39
- protected constructor(
40
- readonly manager: SessionManager,
41
- protected lease: SessionLease,
42
- protected readonly options: StoredSessionOptions,
43
- stored: boolean,
44
- ) {
45
- // pi writes nothing until the session has a message of the user or the model; neither does this.
46
- this.flushed = stored;
47
- const leaseMs = options.leaseMs ?? DEFAULT_LEASE_MS;
48
- this.renewTimer = setInterval(() => void this.renew(leaseMs), leaseMs / 3);
49
- this.renewTimer.unref?.();
50
- (manager as unknown as Persisting)._persist = entry => this.persist(entry);
51
- }
52
-
53
- /** Takes the lease, and opens the session from what the storage has, or a new one with that id. */
54
- static async open(sessionManager: SessionManagerClass, options: StoredSessionOptions): Promise<StoredSession> {
55
- const { storage, sessionId, holder, takeOver } = options;
56
- const lease = await storage.acquire(sessionId, holder, options.leaseMs ?? DEFAULT_LEASE_MS, { takeOver });
57
- try {
58
- const entries = await storage.read(sessionId);
59
- const manager = sessionManager.inMemory(options.cwd, { id: sessionId }, entries as Parameters<SessionManagerClass['inMemory']>[2]);
60
- return new StoredSession(manager, lease, options, entries !== undefined && entries.length > 0);
61
- } catch (error) {
62
- await storage.release(lease);
63
- throw error;
64
- }
65
- }
66
-
67
- get epoch(): number {
68
- return this.lease.epoch;
69
- }
70
-
71
- /** Runs once, when another holder took the session. */
72
- onLost(listener: (error: Error) => void): () => void {
73
- this.lostListeners.add(listener);
74
- return () => this.lostListeners.delete(listener);
75
- }
76
-
77
- /** Resolves when what pi added so far is stored; rejects if it could not be. */
78
- async flush(): Promise<void> {
79
- await this.writing;
80
- if (this.lost) {
81
- throw this.lost;
82
- }
83
- }
84
-
85
- /** Stores what is left and lets another holder take the session at once. */
86
- async close(): Promise<void> {
87
- if (this.closed) {
88
- return;
89
- }
90
- this.closed = true;
91
- clearInterval(this.renewTimer);
92
- await this.writing.catch(() => undefined);
93
- if (!this.lost) {
94
- await this.options.storage.release(this.lease);
95
- }
96
- }
97
-
98
- protected persist(entry: StoredEntry): void {
99
- if (this.lost) {
100
- throw this.lost;
101
- }
102
- if (this.closed) {
103
- throw new Error(`The session ${this.options.sessionId} is closed.`);
104
- }
105
- if (!this.flushed) {
106
- const entries = this.manager.getEntries();
107
- if (!entries.some(candidate => candidate.type === 'message' && (candidate.message.role === 'user' || candidate.message.role === 'assistant'))) {
108
- return;
109
- }
110
- this.flushed = true;
111
- const header = this.manager.getHeader();
112
- this.enqueue([...(header ? [header] : []), ...entries] as unknown as StoredEntry[], true);
113
- return;
114
- }
115
- this.enqueue([entry], false);
116
- }
117
-
118
- protected enqueue(entries: StoredEntry[], replace: boolean): void {
119
- const lease = this.lease;
120
- this.writing = this.writing.then(() =>
121
- this.lost ? undefined : this.options.storage.write(lease, entries, { replace }).catch(error => this.fail(error)),
122
- );
123
- }
124
-
125
- protected async renew(leaseMs: number): Promise<void> {
126
- if (this.lost || this.closed) {
127
- return;
128
- }
129
- try {
130
- this.lease = await this.options.storage.renew(this.lease, leaseMs);
131
- } catch (error) {
132
- if (error instanceof StaleLeaseError) {
133
- this.fail(error);
134
- }
135
- // Other failures (the storage is unreachable) are tried again; the epoch guards the writes meanwhile.
136
- }
137
- }
138
-
139
- protected fail(error: unknown): void {
140
- if (this.lost) {
141
- return;
142
- }
143
- this.lost = error instanceof Error ? error : new Error(String(error));
144
- clearInterval(this.renewTimer);
145
- for (const listener of this.lostListeners) {
146
- listener(this.lost);
147
- }
148
- }
149
- }
@@ -1,33 +0,0 @@
1
- import { Autowired } from '@celljs/core';
2
- import { Rpc } from '@celljs/rpc';
3
- import { ExecEnvironmentFactory } from '@celljs/ta-exec';
4
- import { type TaSettingsScope, TaSettingsServer, type TaSettingsSnapshot } from '@celljs/ta-protocol';
5
- import { TaSettingsStore } from './settings-store';
6
- import { TaErrors } from './ta-errors';
7
-
8
- /** The settings of ta in pi's files; `cwd` defaults to the server's directory. */
9
- @Rpc(TaSettingsServer)
10
- export class TaSettingsServerImpl implements TaSettingsServer {
11
- @Autowired(ExecEnvironmentFactory)
12
- protected readonly environments: ExecEnvironmentFactory;
13
-
14
- @Autowired(TaSettingsStore)
15
- protected readonly settings: TaSettingsStore;
16
-
17
- getSettings(cwd?: string): Promise<TaSettingsSnapshot> {
18
- return TaErrors.guard(async () => this.settings.get(await this.cwd(cwd)));
19
- }
20
-
21
- updateSettings(scope: TaSettingsScope, changes: Record<string, unknown>, cwd?: string): Promise<TaSettingsSnapshot> {
22
- return TaErrors.guard(async () => {
23
- if (scope !== 'user' && scope !== 'project') {
24
- throw TaErrors.invalidArgument(`${String(scope)} is not where settings are kept.`, 'Pass user or project.');
25
- }
26
- return this.settings.update(scope, changes, await this.cwd(cwd));
27
- });
28
- }
29
-
30
- protected async cwd(cwd?: string): Promise<string> {
31
- return cwd || (await this.environments.defaultCwd());
32
- }
33
- }
@@ -1,156 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
2
- import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, utimesSync, writeFileSync } from 'node:fs';
3
- import { tmpdir } from 'node:os';
4
- import { join } from 'node:path';
5
- import { PiSdkUtil } from '@celljs/ai-coding-agent';
6
- import { SettingsLockUtil, TaSettingsStoreImpl, TaSettingsUtil } from './settings-store';
7
-
8
- describe('TaSettingsUtil', () => {
9
- it('reads the settings ta changes, the model from its two keys, and leaves out values pi would not take', () => {
10
- const file = {
11
- defaultProvider: 'anthropic',
12
- defaultModel: 'claude/x',
13
- compaction: { enabled: false, reserveTokens: -1 },
14
- transport: 'pigeon',
15
- theme: 'dark',
16
- };
17
- expect(TaSettingsUtil.read(file)).toEqual({ model: 'anthropic/claude/x', 'compaction.enabled': false });
18
- });
19
-
20
- it('changes keys and keeps the others; null removes a key and the objects it leaves empty', () => {
21
- const file = { theme: 'dark', compaction: { enabled: false }, defaultProvider: 'a', defaultModel: 'b' };
22
- const next = TaSettingsUtil.apply(file, { 'compaction.enabled': null, 'retry.maxRetries': 5, model: 'openai/gpt-5' });
23
- expect(next).toEqual({ theme: 'dark', retry: { maxRetries: 5 }, defaultProvider: 'openai', defaultModel: 'gpt-5' });
24
- expect(file.compaction.enabled).toBe(false);
25
- expect(TaSettingsUtil.apply(next, { model: null })).toEqual({ theme: 'dark', retry: { maxRetries: 5 } });
26
- });
27
-
28
- it('refuses keys it does not know and values that are not of the setting', () => {
29
- expect(() => TaSettingsUtil.apply({}, { theme: 'dark' })).toThrow('not a setting clients change');
30
- expect(() => TaSettingsUtil.apply({}, { transport: 'pigeon' })).toThrow('not a value of transport');
31
- expect(() => TaSettingsUtil.apply({}, { 'retry.maxRetries': 1.5 })).toThrow('not a value of retry.maxRetries');
32
- expect(() => TaSettingsUtil.apply({}, { model: 'no-provider' })).toThrow('not a value of model');
33
- expect(TaSettingsUtil.apply({ shellPath: '/bin/zsh' }, { shellPath: ' ' })).toEqual({});
34
- });
35
-
36
- it('does not overwrite a file it cannot read', () => {
37
- expect(TaSettingsUtil.parse('', 'f')).toEqual({});
38
- expect(() => TaSettingsUtil.parse('{', 'f')).toThrow('not valid JSON');
39
- expect(() => TaSettingsUtil.parse('[]', 'f')).toThrow('JSON object');
40
- });
41
- });
42
-
43
- describe('TaSettingsStoreImpl', () => {
44
- let root: string;
45
- let agentDir: string;
46
- let cwd: string;
47
- let store: TaSettingsStoreImpl;
48
- /** `.ta` under ta, pi's own name in tests. */
49
- let configDir: string;
50
- const reloaded: string[] = [];
51
-
52
- function session(dir: string) {
53
- let trusted = false;
54
- return {
55
- cwd: dir,
56
- pi: {
57
- settingsManager: {
58
- isProjectTrusted: () => trusted,
59
- setProjectTrusted: (value: boolean) => {
60
- trusted = value;
61
- },
62
- reload: async () => {
63
- reloaded.push(`${dir}:${trusted}`);
64
- },
65
- },
66
- },
67
- };
68
- }
69
-
70
- beforeEach(async () => {
71
- configDir = (await PiSdkUtil.load()).CONFIG_DIR_NAME;
72
- root = mkdtempSync(join(tmpdir(), 'ta-settings-'));
73
- agentDir = join(root, 'agent');
74
- cwd = join(root, 'project');
75
- mkdirSync(agentDir);
76
- mkdirSync(cwd);
77
- reloaded.length = 0;
78
- store = new TaSettingsStoreImpl();
79
- Object.assign(store, {
80
- codingAgentOptions: { agentDir },
81
- modelRuntimeProvider: { provide: async () => ({ getAvailable: async () => [{ provider: 'fake', id: 'fake-1' }] }) },
82
- sessions: { list: () => [session(cwd), session(join(root, 'other'))] },
83
- directories: { toPi: (location: string) => location, fromPi: (dir: string) => dir },
84
- });
85
- });
86
- afterEach(() => rmSync(root, { recursive: true, force: true }));
87
-
88
- it('writes the settings of the user next to what the file had, and has every session read them again', async () => {
89
- writeFileSync(join(agentDir, 'settings.json'), JSON.stringify({ theme: 'dark', packages: ['npm:x'] }));
90
- const snapshot = await store.update('user', { 'compaction.enabled': false, model: 'fake/fake-1' }, cwd);
91
- expect(snapshot.user).toEqual({ model: 'fake/fake-1', 'compaction.enabled': false });
92
- expect(snapshot.models).toEqual(['fake/fake-1']);
93
- expect(JSON.parse(readFileSync(join(agentDir, 'settings.json'), 'utf8'))).toEqual({
94
- theme: 'dark',
95
- packages: ['npm:x'],
96
- compaction: { enabled: false },
97
- defaultProvider: 'fake',
98
- defaultModel: 'fake-1',
99
- });
100
- expect(reloaded).toHaveLength(2);
101
- });
102
-
103
- it('writes the settings of a project in its directory, trusts the project, and reloads only its sessions', async () => {
104
- const first = await store.get(cwd);
105
- expect(first.projectTrusted).toBe(true);
106
- expect(first.projectFile).toBe(join(cwd, configDir, 'settings.json'));
107
- const snapshot = await store.update('project', { 'retry.enabled': false }, cwd);
108
- expect(snapshot.project).toEqual({ 'retry.enabled': false });
109
- expect(snapshot.projectTrusted).toBe(true);
110
- expect(reloaded).toEqual([`${cwd}:true`]);
111
- expect(Object.values(JSON.parse(readFileSync(join(agentDir, 'trust.json'), 'utf8')))).toEqual([true]);
112
- });
113
-
114
- it('does not write the settings of a project the user has not trusted yet', async () => {
115
- mkdirSync(join(cwd, configDir, 'extensions'), { recursive: true });
116
- expect((await store.get(cwd)).projectTrusted).toBe(false);
117
- await expect(store.update('project', { 'retry.enabled': false }, cwd)).rejects.toThrow('does not trust');
118
- expect(existsSync(join(cwd, configDir, 'settings.json'))).toBe(false);
119
- });
120
-
121
- it('keeps both of two changes made at once', async () => {
122
- await Promise.all([store.update('user', { 'retry.enabled': false }, cwd), store.update('user', { 'retry.maxRetries': 7 }, cwd)]);
123
- expect((await store.get(cwd)).user).toEqual({ 'retry.enabled': false, 'retry.maxRetries': 7 });
124
- });
125
- });
126
- describe('SettingsLockUtil', () => {
127
- let dir: string;
128
- beforeEach(() => {
129
- dir = mkdtempSync(join(tmpdir(), 'ta-settings-lock-'));
130
- });
131
- afterEach(() => rmSync(dir, { recursive: true, force: true }));
132
-
133
- it('holds the lock pi takes while it works, and lets it go after, also when the work fails', async () => {
134
- const file = join(dir, 'agent/settings.json');
135
- expect(await SettingsLockUtil.run(file, async () => existsSync(`${file}.lock`))).toBe(true);
136
- expect(existsSync(`${file}.lock`)).toBe(false);
137
- await expect(SettingsLockUtil.run(file, () => Promise.reject(new Error('broken')))).rejects.toThrow('broken');
138
- expect(existsSync(`${file}.lock`)).toBe(false);
139
- });
140
-
141
- it('waits for a lock another process holds, and takes over one that is stale', async () => {
142
- const file = join(dir, 'settings.json');
143
- mkdirSync(`${file}.lock`);
144
- const order: string[] = [];
145
- const waiting = SettingsLockUtil.run(file, async () => void order.push('ta'));
146
- await new Promise(resolve => setTimeout(resolve, 60));
147
- order.push('other');
148
- rmSync(`${file}.lock`, { recursive: true });
149
- await waiting;
150
- expect(order).toEqual(['other', 'ta']);
151
- mkdirSync(`${file}.lock`);
152
- const old = (Date.now() - SettingsLockUtil.STALE_MS - 1000) / 1000;
153
- utimesSync(`${file}.lock`, old, old);
154
- expect(await SettingsLockUtil.run(file, async () => 'taken')).toBe('taken');
155
- });
156
- });
@@ -1,314 +0,0 @@
1
- import { mkdir, readFile, rename, rmdir, stat, writeFile } from 'node:fs/promises';
2
- import { dirname, join } from 'node:path';
3
- import { CODING_AGENT_OPTIONS, type CodingAgentOptions, ModelRuntimeProvider, PiSdkUtil } from '@celljs/ai-coding-agent';
4
- import { Autowired, Component, Value } from '@celljs/core';
5
- import { TA_SETTINGS, type TaSettingSpec, type TaSettingsScope, type TaSettingsSnapshot } from '@celljs/ta-protocol';
6
- import { TaSessionRegistry } from './host-protocol';
7
- import { PiDirectories } from './remote/remote-protocol';
8
- import { TaErrors } from './ta-errors';
9
-
10
- export const TaSettingsStore = Symbol('TaSettingsStore');
11
-
12
- /** The settings of ta (TA_SETTINGS) in pi's `settings.json` of the user and of a project. */
13
- export interface TaSettingsStore {
14
- get(cwd: string): Promise<TaSettingsSnapshot>;
15
- update(scope: TaSettingsScope, changes: Record<string, unknown>, cwd: string): Promise<TaSettingsSnapshot>;
16
- }
17
-
18
- type Json = Record<string, unknown>;
19
-
20
- export namespace TaSettingsUtil {
21
- const MODEL = 'model';
22
-
23
- /** The settings of TA_SETTINGS that a file sets, by key. */
24
- export function read(data: Json, specs: readonly TaSettingSpec[] = TA_SETTINGS): Json {
25
- const values: Json = {};
26
- for (const spec of specs) {
27
- if (spec.key === MODEL) {
28
- if (typeof data.defaultProvider === 'string' && typeof data.defaultModel === 'string') {
29
- values[MODEL] = `${data.defaultProvider}/${data.defaultModel}`;
30
- }
31
- continue;
32
- }
33
- const value = at(data, spec.key);
34
- if (value !== undefined && check(spec, value) !== undefined) {
35
- values[spec.key] = value;
36
- }
37
- }
38
- return values;
39
- }
40
-
41
- /** The file with the changes; the other keys stay. Throws for a key or a value ta does not take. */
42
- export function apply(data: Json, changes: Json, specs: readonly TaSettingSpec[] = TA_SETTINGS): Json {
43
- const next = structuredClone(data);
44
- for (const [key, raw] of Object.entries(changes)) {
45
- const spec = specs.find(candidate => candidate.key === key);
46
- if (!spec) {
47
- throw TaErrors.invalidArgument(
48
- `${key} is not a setting clients change.`,
49
- `Use one of ${specs.map(other => other.key).join(', ')}; edit settings.json for the others.`,
50
- );
51
- }
52
- // Blank text removes the key, as a cleared field means.
53
- const removes = raw === null || raw === undefined || (typeof raw === 'string' && !raw.trim());
54
- const value = removes ? undefined : check(spec, raw);
55
- if (!removes && value === undefined) {
56
- throw TaErrors.invalidArgument(`${JSON.stringify(raw)} is not a value of ${key}.`, describe(spec));
57
- }
58
- if (key === MODEL) {
59
- const [provider, ...id] = typeof value === 'string' ? value.split('/') : [];
60
- put(next, 'defaultProvider', provider);
61
- put(next, 'defaultModel', provider ? id.join('/') : undefined);
62
- } else {
63
- put(next, key, value);
64
- }
65
- }
66
- return next;
67
- }
68
-
69
- /** The value as the setting keeps it, or undefined when it is not one. An empty string is no value. */
70
- export function check(spec: TaSettingSpec, value: unknown): unknown {
71
- switch (spec.type) {
72
- case 'boolean':
73
- return typeof value === 'boolean' ? value : undefined;
74
- case 'number':
75
- return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : undefined;
76
- case 'enum':
77
- return typeof value === 'string' && spec.values?.includes(value) ? value : undefined;
78
- case 'model':
79
- return typeof value === 'string' && /^[^/\s]+\/\S+$/.test(value.trim()) ? value.trim() : undefined;
80
- default:
81
- return typeof value === 'string' && value.trim() ? value.trim() : undefined;
82
- }
83
- }
84
-
85
- function describe(spec: TaSettingSpec): string {
86
- switch (spec.type) {
87
- case 'boolean':
88
- return 'Pass true or false, or null to remove it.';
89
- case 'number':
90
- return 'Pass a whole number of 0 or more, or null to remove it.';
91
- case 'enum':
92
- return `Pass one of ${spec.values?.join(', ')}, or null to remove it.`;
93
- case 'model':
94
- return 'Pass <provider>/<model id>, or null to remove it.';
95
- default:
96
- return 'Pass text, or null to remove it.';
97
- }
98
- }
99
-
100
- function at(data: Json, key: string): unknown {
101
- let value: unknown = data;
102
- for (const part of key.split('.')) {
103
- value = value && typeof value === 'object' && !Array.isArray(value) ? (value as Json)[part] : undefined;
104
- }
105
- return value;
106
- }
107
-
108
- /** Sets a dotted key; undefined removes it, and the objects it leaves empty. */
109
- function put(data: Json, key: string, value: unknown): void {
110
- const parts = key.split('.');
111
- const last = parts.pop() as string;
112
- const parents: Json[] = [data];
113
- let target = data;
114
- for (const part of parts) {
115
- const child = target[part];
116
- if (!child || typeof child !== 'object' || Array.isArray(child)) {
117
- if (value === undefined) {
118
- return;
119
- }
120
- target[part] = {};
121
- }
122
- target = target[part] as Json;
123
- parents.push(target);
124
- }
125
- if (value === undefined) {
126
- delete target[last];
127
- for (let index = parts.length - 1; index >= 0; index--) {
128
- if (Object.keys(parents[index + 1]).length === 0) {
129
- delete parents[index][parts[index]];
130
- }
131
- }
132
- } else {
133
- target[last] = value;
134
- }
135
- }
136
-
137
- export function parse(text: string | undefined, file: string): Json {
138
- if (!text?.trim()) {
139
- return {};
140
- }
141
- let data: unknown;
142
- try {
143
- data = JSON.parse(text);
144
- } catch (error) {
145
- throw TaErrors.invalidArgument(
146
- `${file} is not valid JSON: ${(error as Error).message}`,
147
- 'Fix the file by hand first; ta does not overwrite what it cannot read.',
148
- );
149
- }
150
- if (!data || typeof data !== 'object' || Array.isArray(data)) {
151
- throw TaErrors.invalidArgument(`${file} does not hold a JSON object.`, 'Fix the file by hand first; ta does not overwrite what it cannot read.');
152
- }
153
- return data as Json;
154
- }
155
- }
156
-
157
- /**
158
- * The lock pi takes on a settings file while it writes it (proper-lockfile: a directory `<file>.lock`, taken
159
- * over when older than 10 s), so that a write of ta serve and one of `ta` in a terminal do not lose each
160
- * other's changes: pi reads the file again under the lock and writes back only what it changed.
161
- */
162
- export namespace SettingsLockUtil {
163
- export const STALE_MS = 10_000;
164
- const RETRY_MS = 20;
165
- const ATTEMPTS = 250;
166
-
167
- export async function run<T>(file: string, work: () => Promise<T>): Promise<T> {
168
- const lock = `${file}.lock`;
169
- await mkdir(dirname(file), { recursive: true });
170
- for (let attempt = 0; ; attempt++) {
171
- try {
172
- await mkdir(lock);
173
- break;
174
- } catch (error) {
175
- if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {
176
- throw error;
177
- }
178
- const since = await stat(lock).then(
179
- info => Date.now() - info.mtimeMs,
180
- () => 0,
181
- );
182
- if (since > STALE_MS) {
183
- await rmdir(lock).catch(() => undefined);
184
- } else if (attempt >= ATTEMPTS) {
185
- throw TaErrors.invalidArgument(`${file} stays locked by another process.`, `Try again; if no Ta is running, delete ${lock}.`);
186
- } else {
187
- await new Promise(resolve => setTimeout(resolve, RETRY_MS));
188
- }
189
- }
190
- }
191
- try {
192
- return await work();
193
- } finally {
194
- await rmdir(lock).catch(() => undefined);
195
- }
196
- }
197
- }
198
-
199
- /**
200
- * Reads and writes the settings of ta where pi keeps them, under pi's lock of the file (SettingsLockUtil), and has the open sessions read them again. A
201
- * file is written whole, through a temporary file, with its other keys as they were.
202
- */
203
- @Component(TaSettingsStore)
204
- export class TaSettingsStoreImpl implements TaSettingsStore {
205
- @Value(CODING_AGENT_OPTIONS)
206
- protected readonly codingAgentOptions?: CodingAgentOptions;
207
-
208
- @Autowired(ModelRuntimeProvider)
209
- protected readonly modelRuntimeProvider: ModelRuntimeProvider;
210
-
211
- @Autowired(TaSessionRegistry)
212
- protected readonly sessions: TaSessionRegistry;
213
-
214
- @Autowired(PiDirectories)
215
- protected readonly directories: PiDirectories;
216
-
217
- /** One write at a time, so that two changes of one file both stay. */
218
- protected writing: Promise<unknown> = Promise.resolve();
219
-
220
- async get(cwd: string): Promise<TaSettingsSnapshot> {
221
- const { userFile, projectFile, trusted } = await this.files(cwd);
222
- const [user, project, models] = await Promise.all([this.read(userFile), this.read(projectFile), this.models()]);
223
- return {
224
- user: TaSettingsUtil.read(user),
225
- project: TaSettingsUtil.read(project),
226
- cwd,
227
- userFile,
228
- projectFile,
229
- projectTrusted: trusted !== false,
230
- models,
231
- };
232
- }
233
-
234
- update(scope: TaSettingsScope, changes: Record<string, unknown>, cwd: string): Promise<TaSettingsSnapshot> {
235
- const next = this.writing.then(() => this.write(scope, changes, cwd));
236
- this.writing = next.catch(() => undefined);
237
- return next;
238
- }
239
-
240
- protected async write(scope: TaSettingsScope, changes: Record<string, unknown>, cwd: string): Promise<TaSettingsSnapshot> {
241
- if (!changes || typeof changes !== 'object' || Array.isArray(changes)) {
242
- throw TaErrors.invalidArgument('The changes are an object of settings.', 'Pass { key: value }, with null to remove a key.');
243
- }
244
- const { userFile, projectFile, trusted, trust } = await this.files(cwd);
245
- if (scope === 'project' && trusted === false) {
246
- throw TaErrors.invalidArgument(
247
- `ta does not trust ${cwd}, so it does not read the settings of the project.`,
248
- 'Run ta in that directory and trust the project, or change the settings of the user.',
249
- );
250
- }
251
- const file = scope === 'user' ? userFile : projectFile;
252
- await SettingsLockUtil.run(file, async () => {
253
- const data = TaSettingsUtil.apply(await this.read(file), changes);
254
- await writeFile(`${file}.tmp`, `${JSON.stringify(data, null, 2)}\n`);
255
- await rename(`${file}.tmp`, file);
256
- });
257
- // A project with nothing pi asks about: the user writing its settings is trusting it, else pi would ignore them.
258
- if (scope === 'project' && trusted === undefined) {
259
- trust();
260
- }
261
- await this.reloadSessions(scope, cwd);
262
- return this.get(cwd);
263
- }
264
-
265
- /**
266
- * `trusted`: pi's decision for the project, or false when it has resources pi asks about first;
267
- * undefined when nobody decided and there is nothing to ask about, as pi trusts it then.
268
- */
269
- protected async files(location: string): Promise<{ userFile: string; projectFile: string; trusted?: boolean; trust(): void }> {
270
- // The project of a directory of another machine is the directory here that pi works in for it.
271
- const cwd = this.directories.toPi(location);
272
- const sdk = await PiSdkUtil.load();
273
- const agentDir = this.codingAgentOptions?.agentDir ?? sdk.getAgentDir();
274
- const store = new sdk.ProjectTrustStore(agentDir);
275
- const decision = store.get(cwd);
276
- return {
277
- userFile: join(agentDir, 'settings.json'),
278
- projectFile: join(cwd, sdk.CONFIG_DIR_NAME, 'settings.json'),
279
- trusted: decision ?? (sdk.hasTrustRequiringProjectResources(cwd) ? false : undefined),
280
- trust: () => store.set(cwd, true),
281
- };
282
- }
283
-
284
- protected async read(file: string): Promise<Record<string, unknown>> {
285
- const text = await readFile(file, 'utf8').catch((error: NodeJS.ErrnoException) => {
286
- if (error.code === 'ENOENT') {
287
- return undefined;
288
- }
289
- throw error;
290
- });
291
- return TaSettingsUtil.parse(text, file);
292
- }
293
-
294
- protected async models(): Promise<string[]> {
295
- try {
296
- const runtime = await this.modelRuntimeProvider.provide();
297
- return (await runtime.getAvailable()).map(model => `${model.provider}/${model.id}`);
298
- } catch {
299
- return [];
300
- }
301
- }
302
-
303
- protected async reloadSessions(scope: TaSettingsScope, cwd: string): Promise<void> {
304
- for (const session of this.sessions.list()) {
305
- if (scope === 'user' || session.cwd === cwd) {
306
- const manager = session.pi.settingsManager;
307
- if (scope === 'project' && !manager.isProjectTrusted()) {
308
- manager.setProjectTrusted(true);
309
- }
310
- await manager.reload().catch(() => undefined);
311
- }
312
- }
313
- }
314
- }