@amalgm/browser 0.1.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 (384) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/LICENSE +5 -0
  3. package/PURPOSE.md +117 -0
  4. package/README.md +120 -0
  5. package/SECURITY.md +49 -0
  6. package/dist/bin/amalgm-browser-mcp.d.ts +2 -0
  7. package/dist/bin/amalgm-browser-mcp.js +5 -0
  8. package/dist/bin/amalgm-browser-mcp.js.map +1 -0
  9. package/dist/bin/amalgm-browser-rest.d.ts +2 -0
  10. package/dist/bin/amalgm-browser-rest.js +20 -0
  11. package/dist/bin/amalgm-browser-rest.js.map +1 -0
  12. package/dist/bin/amalgm-browser.d.ts +2 -0
  13. package/dist/bin/amalgm-browser.js +4 -0
  14. package/dist/bin/amalgm-browser.js.map +1 -0
  15. package/dist/src/action.d.ts +5 -0
  16. package/dist/src/action.js +42 -0
  17. package/dist/src/action.js.map +1 -0
  18. package/dist/src/adapters/actions.d.ts +10 -0
  19. package/dist/src/adapters/actions.js +41 -0
  20. package/dist/src/adapters/actions.js.map +1 -0
  21. package/dist/src/adapters/cli/actions.d.ts +7 -0
  22. package/dist/src/adapters/cli/actions.js +63 -0
  23. package/dist/src/adapters/cli/actions.js.map +1 -0
  24. package/dist/src/adapters/cli/args.d.ts +8 -0
  25. package/dist/src/adapters/cli/args.js +41 -0
  26. package/dist/src/adapters/cli/args.js.map +1 -0
  27. package/dist/src/adapters/cli/help.d.ts +1 -0
  28. package/dist/src/adapters/cli/help.js +29 -0
  29. package/dist/src/adapters/cli/help.js.map +1 -0
  30. package/dist/src/adapters/cli/resources.d.ts +4 -0
  31. package/dist/src/adapters/cli/resources.js +116 -0
  32. package/dist/src/adapters/cli/resources.js.map +1 -0
  33. package/dist/src/adapters/cli/run.d.ts +7 -0
  34. package/dist/src/adapters/cli/run.js +108 -0
  35. package/dist/src/adapters/cli/run.js.map +1 -0
  36. package/dist/src/adapters/execute.d.ts +4 -0
  37. package/dist/src/adapters/execute.js +91 -0
  38. package/dist/src/adapters/execute.js.map +1 -0
  39. package/dist/src/adapters/http/auth-routes.d.ts +2 -0
  40. package/dist/src/adapters/http/auth-routes.js +93 -0
  41. package/dist/src/adapters/http/auth-routes.js.map +1 -0
  42. package/dist/src/adapters/http/events.d.ts +3 -0
  43. package/dist/src/adapters/http/events.js +20 -0
  44. package/dist/src/adapters/http/events.js.map +1 -0
  45. package/dist/src/adapters/http/internal-routes.d.ts +2 -0
  46. package/dist/src/adapters/http/internal-routes.js +35 -0
  47. package/dist/src/adapters/http/internal-routes.js.map +1 -0
  48. package/dist/src/adapters/http/openapi.d.ts +1 -0
  49. package/dist/src/adapters/http/openapi.js +78 -0
  50. package/dist/src/adapters/http/openapi.js.map +1 -0
  51. package/dist/src/adapters/http/profile-routes.d.ts +2 -0
  52. package/dist/src/adapters/http/profile-routes.js +42 -0
  53. package/dist/src/adapters/http/profile-routes.js.map +1 -0
  54. package/dist/src/adapters/http/recording-routes.d.ts +2 -0
  55. package/dist/src/adapters/http/recording-routes.js +41 -0
  56. package/dist/src/adapters/http/recording-routes.js.map +1 -0
  57. package/dist/src/adapters/http/request.d.ts +4 -0
  58. package/dist/src/adapters/http/request.js +44 -0
  59. package/dist/src/adapters/http/request.js.map +1 -0
  60. package/dist/src/adapters/http/server.d.ts +2 -0
  61. package/dist/src/adapters/http/server.js +114 -0
  62. package/dist/src/adapters/http/server.js.map +1 -0
  63. package/dist/src/adapters/http/session-routes.d.ts +2 -0
  64. package/dist/src/adapters/http/session-routes.js +54 -0
  65. package/dist/src/adapters/http/session-routes.js.map +1 -0
  66. package/dist/src/adapters/http/types.d.ts +29 -0
  67. package/dist/src/adapters/http/types.js +2 -0
  68. package/dist/src/adapters/http/types.js.map +1 -0
  69. package/dist/src/adapters/mcp/server.d.ts +3 -0
  70. package/dist/src/adapters/mcp/server.js +74 -0
  71. package/dist/src/adapters/mcp/server.js.map +1 -0
  72. package/dist/src/adapters/mcp/tools.d.ts +3 -0
  73. package/dist/src/adapters/mcp/tools.js +45 -0
  74. package/dist/src/adapters/mcp/tools.js.map +1 -0
  75. package/dist/src/adapters/mcp/types.d.ts +17 -0
  76. package/dist/src/adapters/mcp/types.js +2 -0
  77. package/dist/src/adapters/mcp/types.js.map +1 -0
  78. package/dist/src/adapters/toolbox/aliases.d.ts +5 -0
  79. package/dist/src/adapters/toolbox/aliases.js +14 -0
  80. package/dist/src/adapters/toolbox/aliases.js.map +1 -0
  81. package/dist/src/adapters/toolbox/executor.d.ts +6 -0
  82. package/dist/src/adapters/toolbox/executor.js +13 -0
  83. package/dist/src/adapters/toolbox/executor.js.map +1 -0
  84. package/dist/src/adapters/toolbox/manifest.d.ts +15 -0
  85. package/dist/src/adapters/toolbox/manifest.js +24 -0
  86. package/dist/src/adapters/toolbox/manifest.js.map +1 -0
  87. package/dist/src/artifacts.d.ts +14 -0
  88. package/dist/src/artifacts.js +28 -0
  89. package/dist/src/artifacts.js.map +1 -0
  90. package/dist/src/auth/filter.d.ts +3 -0
  91. package/dist/src/auth/filter.js +60 -0
  92. package/dist/src/auth/filter.js.map +1 -0
  93. package/dist/src/auth/login.d.ts +41 -0
  94. package/dist/src/auth/login.js +145 -0
  95. package/dist/src/auth/login.js.map +1 -0
  96. package/dist/src/auth/portable.d.ts +18 -0
  97. package/dist/src/auth/portable.js +48 -0
  98. package/dist/src/auth/portable.js.map +1 -0
  99. package/dist/src/auth/service.d.ts +29 -0
  100. package/dist/src/auth/service.js +104 -0
  101. package/dist/src/auth/service.js.map +1 -0
  102. package/dist/src/auth/transport.d.ts +8 -0
  103. package/dist/src/auth/transport.js +45 -0
  104. package/dist/src/auth/transport.js.map +1 -0
  105. package/dist/src/auth/vault.d.ts +10 -0
  106. package/dist/src/auth/vault.js +27 -0
  107. package/dist/src/auth/vault.js.map +1 -0
  108. package/dist/src/cli.d.ts +2 -0
  109. package/dist/src/cli.js +3 -0
  110. package/dist/src/cli.js.map +1 -0
  111. package/dist/src/cookies/coordinator.d.ts +17 -0
  112. package/dist/src/cookies/coordinator.js +93 -0
  113. package/dist/src/cookies/coordinator.js.map +1 -0
  114. package/dist/src/cookies/jar.d.ts +21 -0
  115. package/dist/src/cookies/jar.js +146 -0
  116. package/dist/src/cookies/jar.js.map +1 -0
  117. package/dist/src/cookies/policy.d.ts +6 -0
  118. package/dist/src/cookies/policy.js +58 -0
  119. package/dist/src/cookies/policy.js.map +1 -0
  120. package/dist/src/cookies/secret-file.d.ts +10 -0
  121. package/dist/src/cookies/secret-file.js +80 -0
  122. package/dist/src/cookies/secret-file.js.map +1 -0
  123. package/dist/src/cookies/types.d.ts +64 -0
  124. package/dist/src/cookies/types.js +2 -0
  125. package/dist/src/cookies/types.js.map +1 -0
  126. package/dist/src/cookies.d.ts +5 -0
  127. package/dist/src/cookies.js +5 -0
  128. package/dist/src/cookies.js.map +1 -0
  129. package/dist/src/defaults.d.ts +24 -0
  130. package/dist/src/defaults.js +107 -0
  131. package/dist/src/defaults.js.map +1 -0
  132. package/dist/src/drivers/cdp/capture.d.ts +5 -0
  133. package/dist/src/drivers/cdp/capture.js +39 -0
  134. package/dist/src/drivers/cdp/capture.js.map +1 -0
  135. package/dist/src/drivers/cdp/client.d.ts +8 -0
  136. package/dist/src/drivers/cdp/client.js +88 -0
  137. package/dist/src/drivers/cdp/client.js.map +1 -0
  138. package/dist/src/drivers/cdp/input.d.ts +2 -0
  139. package/dist/src/drivers/cdp/input.js +15 -0
  140. package/dist/src/drivers/cdp/input.js.map +1 -0
  141. package/dist/src/drivers/cdp/screencast.d.ts +2 -0
  142. package/dist/src/drivers/cdp/screencast.js +39 -0
  143. package/dist/src/drivers/cdp/screencast.js.map +1 -0
  144. package/dist/src/drivers/cdp/target.d.ts +4 -0
  145. package/dist/src/drivers/cdp/target.js +34 -0
  146. package/dist/src/drivers/cdp/target.js.map +1 -0
  147. package/dist/src/drivers/electron/advertisement.d.ts +12 -0
  148. package/dist/src/drivers/electron/advertisement.js +57 -0
  149. package/dist/src/drivers/electron/advertisement.js.map +1 -0
  150. package/dist/src/drivers/electron/contracts.d.ts +45 -0
  151. package/dist/src/drivers/electron/contracts.js +10 -0
  152. package/dist/src/drivers/electron/contracts.js.map +1 -0
  153. package/dist/src/drivers/electron/cookie-adapter.d.ts +17 -0
  154. package/dist/src/drivers/electron/cookie-adapter.js +69 -0
  155. package/dist/src/drivers/electron/cookie-adapter.js.map +1 -0
  156. package/dist/src/drivers/electron/driver.d.ts +19 -0
  157. package/dist/src/drivers/electron/driver.js +115 -0
  158. package/dist/src/drivers/electron/driver.js.map +1 -0
  159. package/dist/src/drivers/electron/native/adblock/cache.d.ts +4 -0
  160. package/dist/src/drivers/electron/native/adblock/cache.js +54 -0
  161. package/dist/src/drivers/electron/native/adblock/cache.js.map +1 -0
  162. package/dist/src/drivers/electron/native/adblock/cosmetics.d.ts +11 -0
  163. package/dist/src/drivers/electron/native/adblock/cosmetics.js +45 -0
  164. package/dist/src/drivers/electron/native/adblock/cosmetics.js.map +1 -0
  165. package/dist/src/drivers/electron/native/adblock/index.d.ts +44 -0
  166. package/dist/src/drivers/electron/native/adblock/index.js +153 -0
  167. package/dist/src/drivers/electron/native/adblock/index.js.map +1 -0
  168. package/dist/src/drivers/electron/native/adblock/policy.d.ts +2 -0
  169. package/dist/src/drivers/electron/native/adblock/policy.js +12 -0
  170. package/dist/src/drivers/electron/native/adblock/policy.js.map +1 -0
  171. package/dist/src/drivers/electron/native/adblock/preload.d.ts +1 -0
  172. package/dist/src/drivers/electron/native/adblock/preload.js +131 -0
  173. package/dist/src/drivers/electron/native/adblock/preload.js.map +1 -0
  174. package/dist/src/drivers/electron/native/adblock/settings.d.ts +9 -0
  175. package/dist/src/drivers/electron/native/adblock/settings.js +37 -0
  176. package/dist/src/drivers/electron/native/adblock/settings.js.map +1 -0
  177. package/dist/src/drivers/electron/native/config.d.ts +4 -0
  178. package/dist/src/drivers/electron/native/config.js +9 -0
  179. package/dist/src/drivers/electron/native/config.js.map +1 -0
  180. package/dist/src/drivers/electron/native/contracts.d.ts +174 -0
  181. package/dist/src/drivers/electron/native/contracts.js +20 -0
  182. package/dist/src/drivers/electron/native/contracts.js.map +1 -0
  183. package/dist/src/drivers/electron/native/policy.d.ts +7 -0
  184. package/dist/src/drivers/electron/native/policy.js +43 -0
  185. package/dist/src/drivers/electron/native/policy.js.map +1 -0
  186. package/dist/src/drivers/electron/native/session.d.ts +4 -0
  187. package/dist/src/drivers/electron/native/session.js +11 -0
  188. package/dist/src/drivers/electron/native/session.js.map +1 -0
  189. package/dist/src/drivers/electron/native/shell/adblock-ipc.d.ts +10 -0
  190. package/dist/src/drivers/electron/native/shell/adblock-ipc.js +44 -0
  191. package/dist/src/drivers/electron/native/shell/adblock-ipc.js.map +1 -0
  192. package/dist/src/drivers/electron/native/shell/context-menu.d.ts +11 -0
  193. package/dist/src/drivers/electron/native/shell/context-menu.js +129 -0
  194. package/dist/src/drivers/electron/native/shell/context-menu.js.map +1 -0
  195. package/dist/src/drivers/electron/native/shell/downloads.d.ts +11 -0
  196. package/dist/src/drivers/electron/native/shell/downloads.js +90 -0
  197. package/dist/src/drivers/electron/native/shell/downloads.js.map +1 -0
  198. package/dist/src/drivers/electron/native/shell/helpers.d.ts +5 -0
  199. package/dist/src/drivers/electron/native/shell/helpers.js +53 -0
  200. package/dist/src/drivers/electron/native/shell/helpers.js.map +1 -0
  201. package/dist/src/drivers/electron/native/shell/permissions.d.ts +16 -0
  202. package/dist/src/drivers/electron/native/shell/permissions.js +107 -0
  203. package/dist/src/drivers/electron/native/shell/permissions.js.map +1 -0
  204. package/dist/src/drivers/electron/native/shell/sites.d.ts +24 -0
  205. package/dist/src/drivers/electron/native/shell/sites.js +119 -0
  206. package/dist/src/drivers/electron/native/shell/sites.js.map +1 -0
  207. package/dist/src/drivers/electron/native/shell/types.d.ts +13 -0
  208. package/dist/src/drivers/electron/native/shell/types.js +2 -0
  209. package/dist/src/drivers/electron/native/shell/types.js.map +1 -0
  210. package/dist/src/drivers/electron/native/shell.d.ts +14 -0
  211. package/dist/src/drivers/electron/native/shell.js +115 -0
  212. package/dist/src/drivers/electron/native/shell.js.map +1 -0
  213. package/dist/src/drivers/electron/native/surface/commands.d.ts +4 -0
  214. package/dist/src/drivers/electron/native/surface/commands.js +49 -0
  215. package/dist/src/drivers/electron/native/surface/commands.js.map +1 -0
  216. package/dist/src/drivers/electron/native/surface/create.d.ts +4 -0
  217. package/dist/src/drivers/electron/native/surface/create.js +46 -0
  218. package/dist/src/drivers/electron/native/surface/create.js.map +1 -0
  219. package/dist/src/drivers/electron/native/surface/events.d.ts +3 -0
  220. package/dist/src/drivers/electron/native/surface/events.js +55 -0
  221. package/dist/src/drivers/electron/native/surface/events.js.map +1 -0
  222. package/dist/src/drivers/electron/native/surface/presentation.d.ts +15 -0
  223. package/dist/src/drivers/electron/native/surface/presentation.js +87 -0
  224. package/dist/src/drivers/electron/native/surface/presentation.js.map +1 -0
  225. package/dist/src/drivers/electron/native/surface/state.d.ts +7 -0
  226. package/dist/src/drivers/electron/native/surface/state.js +45 -0
  227. package/dist/src/drivers/electron/native/surface/state.js.map +1 -0
  228. package/dist/src/drivers/electron/native/surface/types.d.ts +39 -0
  229. package/dist/src/drivers/electron/native/surface/types.js +2 -0
  230. package/dist/src/drivers/electron/native/surface/types.js.map +1 -0
  231. package/dist/src/drivers/electron/native/surface-controller.d.ts +6 -0
  232. package/dist/src/drivers/electron/native/surface-controller.js +138 -0
  233. package/dist/src/drivers/electron/native/surface-controller.js.map +1 -0
  234. package/dist/src/drivers/electron/policy.d.ts +4 -0
  235. package/dist/src/drivers/electron/policy.js +39 -0
  236. package/dist/src/drivers/electron/policy.js.map +1 -0
  237. package/dist/src/drivers/electron/session.d.ts +4 -0
  238. package/dist/src/drivers/electron/session.js +5 -0
  239. package/dist/src/drivers/electron/session.js.map +1 -0
  240. package/dist/src/drivers/headless/command.d.ts +25 -0
  241. package/dist/src/drivers/headless/command.js +114 -0
  242. package/dist/src/drivers/headless/command.js.map +1 -0
  243. package/dist/src/drivers/headless/cookie-adapter.d.ts +16 -0
  244. package/dist/src/drivers/headless/cookie-adapter.js +59 -0
  245. package/dist/src/drivers/headless/cookie-adapter.js.map +1 -0
  246. package/dist/src/drivers/headless/driver.d.ts +31 -0
  247. package/dist/src/drivers/headless/driver.js +238 -0
  248. package/dist/src/drivers/headless/driver.js.map +1 -0
  249. package/dist/src/drivers/headless/executable.d.ts +8 -0
  250. package/dist/src/drivers/headless/executable.js +56 -0
  251. package/dist/src/drivers/headless/executable.js.map +1 -0
  252. package/dist/src/drivers/headless/screencast.d.ts +3 -0
  253. package/dist/src/drivers/headless/screencast.js +21 -0
  254. package/dist/src/drivers/headless/screencast.js.map +1 -0
  255. package/dist/src/electron.d.ts +14 -0
  256. package/dist/src/electron.js +15 -0
  257. package/dist/src/electron.js.map +1 -0
  258. package/dist/src/errors.d.ts +9 -0
  259. package/dist/src/errors.js +25 -0
  260. package/dist/src/errors.js.map +1 -0
  261. package/dist/src/events.d.ts +13 -0
  262. package/dist/src/events.js +32 -0
  263. package/dist/src/events.js.map +1 -0
  264. package/dist/src/headless.d.ts +3 -0
  265. package/dist/src/headless.js +4 -0
  266. package/dist/src/headless.js.map +1 -0
  267. package/dist/src/http.d.ts +3 -0
  268. package/dist/src/http.js +3 -0
  269. package/dist/src/http.js.map +1 -0
  270. package/dist/src/ids.d.ts +2 -0
  271. package/dist/src/ids.js +9 -0
  272. package/dist/src/ids.js.map +1 -0
  273. package/dist/src/index.d.ts +14 -0
  274. package/dist/src/index.js +11 -0
  275. package/dist/src/index.js.map +1 -0
  276. package/dist/src/interaction/delta.d.ts +25 -0
  277. package/dist/src/interaction/delta.js +102 -0
  278. package/dist/src/interaction/delta.js.map +1 -0
  279. package/dist/src/interaction/typing.d.ts +39 -0
  280. package/dist/src/interaction/typing.js +189 -0
  281. package/dist/src/interaction/typing.js.map +1 -0
  282. package/dist/src/mcp.d.ts +3 -0
  283. package/dist/src/mcp.js +3 -0
  284. package/dist/src/mcp.js.map +1 -0
  285. package/dist/src/migration/legacy-cookies.d.ts +2 -0
  286. package/dist/src/migration/legacy-cookies.js +60 -0
  287. package/dist/src/migration/legacy-cookies.js.map +1 -0
  288. package/dist/src/migration/legacy-crypto.d.ts +1 -0
  289. package/dist/src/migration/legacy-crypto.js +35 -0
  290. package/dist/src/migration/legacy-crypto.js.map +1 -0
  291. package/dist/src/migration/legacy-migration.d.ts +20 -0
  292. package/dist/src/migration/legacy-migration.js +81 -0
  293. package/dist/src/migration/legacy-migration.js.map +1 -0
  294. package/dist/src/migration/legacy-rows.d.ts +5 -0
  295. package/dist/src/migration/legacy-rows.js +72 -0
  296. package/dist/src/migration/legacy-rows.js.map +1 -0
  297. package/dist/src/persistence/sqlite-registry.d.ts +32 -0
  298. package/dist/src/persistence/sqlite-registry.js +136 -0
  299. package/dist/src/persistence/sqlite-registry.js.map +1 -0
  300. package/dist/src/ports.d.ts +93 -0
  301. package/dist/src/ports.js +4 -0
  302. package/dist/src/ports.js.map +1 -0
  303. package/dist/src/process.d.ts +4 -0
  304. package/dist/src/process.js +63 -0
  305. package/dist/src/process.js.map +1 -0
  306. package/dist/src/product-service.d.ts +30 -0
  307. package/dist/src/product-service.js +38 -0
  308. package/dist/src/product-service.js.map +1 -0
  309. package/dist/src/profiles/directories.d.ts +9 -0
  310. package/dist/src/profiles/directories.js +57 -0
  311. package/dist/src/profiles/directories.js.map +1 -0
  312. package/dist/src/profiles/service.d.ts +30 -0
  313. package/dist/src/profiles/service.js +89 -0
  314. package/dist/src/profiles/service.js.map +1 -0
  315. package/dist/src/recording/encoder.d.ts +22 -0
  316. package/dist/src/recording/encoder.js +89 -0
  317. package/dist/src/recording/encoder.js.map +1 -0
  318. package/dist/src/recording/sampler.d.ts +18 -0
  319. package/dist/src/recording/sampler.js +33 -0
  320. package/dist/src/recording/sampler.js.map +1 -0
  321. package/dist/src/recording/service.d.ts +27 -0
  322. package/dist/src/recording/service.js +180 -0
  323. package/dist/src/recording/service.js.map +1 -0
  324. package/dist/src/recording/source.d.ts +1 -0
  325. package/dist/src/recording/source.js +21 -0
  326. package/dist/src/recording/source.js.map +1 -0
  327. package/dist/src/recording.d.ts +3 -0
  328. package/dist/src/recording.js +4 -0
  329. package/dist/src/recording.js.map +1 -0
  330. package/dist/src/registry.d.ts +15 -0
  331. package/dist/src/registry.js +46 -0
  332. package/dist/src/registry.js.map +1 -0
  333. package/dist/src/runtime-selector.d.ts +12 -0
  334. package/dist/src/runtime-selector.js +78 -0
  335. package/dist/src/runtime-selector.js.map +1 -0
  336. package/dist/src/service-options.d.ts +19 -0
  337. package/dist/src/service-options.js +2 -0
  338. package/dist/src/service-options.js.map +1 -0
  339. package/dist/src/service.d.ts +39 -0
  340. package/dist/src/service.js +204 -0
  341. package/dist/src/service.js.map +1 -0
  342. package/dist/src/sessions/leases.d.ts +10 -0
  343. package/dist/src/sessions/leases.js +41 -0
  344. package/dist/src/sessions/leases.js.map +1 -0
  345. package/dist/src/sessions/prune.d.ts +2 -0
  346. package/dist/src/sessions/prune.js +8 -0
  347. package/dist/src/sessions/prune.js.map +1 -0
  348. package/dist/src/testing.d.ts +18 -0
  349. package/dist/src/testing.js +21 -0
  350. package/dist/src/testing.js.map +1 -0
  351. package/dist/src/toolbox.d.ts +3 -0
  352. package/dist/src/toolbox.js +4 -0
  353. package/dist/src/toolbox.js.map +1 -0
  354. package/dist/src/types.d.ts +273 -0
  355. package/dist/src/types.js +2 -0
  356. package/dist/src/types.js.map +1 -0
  357. package/docs/ACTIONS.md +27 -0
  358. package/docs/ARCHITECTURE.md +71 -0
  359. package/docs/AUTHENTICATION.md +56 -0
  360. package/docs/AXIOMS.md +20 -0
  361. package/docs/CLI.md +61 -0
  362. package/docs/COMPATIBILITY.md +45 -0
  363. package/docs/COOKIES.md +61 -0
  364. package/docs/ELECTRON_INTEGRATION.md +87 -0
  365. package/docs/ENGINE_INTEGRATION.md +73 -0
  366. package/docs/EVENTS.md +30 -0
  367. package/docs/HEADLESS_RUNTIME.md +58 -0
  368. package/docs/MCP.md +36 -0
  369. package/docs/MIGRATION.md +64 -0
  370. package/docs/OPERATIONS.md +69 -0
  371. package/docs/README.md +21 -0
  372. package/docs/REALTIME_BOUNDARY.md +33 -0
  373. package/docs/RECORDING.md +55 -0
  374. package/docs/REST.md +69 -0
  375. package/docs/SDK.md +101 -0
  376. package/docs/TESTING.md +57 -0
  377. package/docs/TOOLBOX_INTEGRATION.md +34 -0
  378. package/docs/TROUBLESHOOTING.md +67 -0
  379. package/examples/basic.ts +7 -0
  380. package/examples/custom-driver.ts +45 -0
  381. package/package.json +78 -0
  382. package/skills/use-amalgm-browser/SKILL.md +42 -0
  383. package/skills/use-amalgm-browser/agents/openai.yaml +4 -0
  384. package/skills/use-amalgm-browser/references/actions.md +40 -0
@@ -0,0 +1,72 @@
1
+ export function legacyProfile(row) {
2
+ const parsed = parse(row.profile_json);
3
+ const id = String(row.id);
4
+ const createdAt = text(row.created_at, parsed.createdAt, new Date(0).toISOString());
5
+ const updatedAt = text(row.updated_at, parsed.updatedAt, createdAt);
6
+ const lastUsedAt = text(row.last_used_at, parsed.lastUsedAt, updatedAt);
7
+ const source = text(row.source, parsed.source, 'amalgm');
8
+ return {
9
+ id,
10
+ name: text(row.name, parsed.name, id),
11
+ kind: ['agent-browser', 'agent-browser-ephemeral'].includes(source) ? 'ephemeral' : 'durable',
12
+ createdAt, updatedAt, lastUsedAt,
13
+ };
14
+ }
15
+ export function legacyAuthBundle(row) {
16
+ const parsed = parse(row.bundle_json);
17
+ const createdAt = text(row.created_at, parsed.createdAt, new Date(0).toISOString());
18
+ return {
19
+ id: String(row.id),
20
+ name: text(row.name, parsed.name, String(row.id)),
21
+ profileId: text(row.profile_id, parsed.profileId, 'default'),
22
+ domains: list(row.domains_json, parsed.domains),
23
+ storageKinds: list(row.storage_kinds_json, parsed.storageKinds)
24
+ .filter((value) => ['cookies', 'localStorage', 'sessionStorage'].includes(value)),
25
+ createdAt,
26
+ updatedAt: text(row.updated_at, parsed.updatedAt, createdAt),
27
+ };
28
+ }
29
+ export function legacyLogin(row) {
30
+ const parsed = parse(row.session_json);
31
+ const status = text(row.status, parsed.status, 'expired');
32
+ const transport = text(row.transport, parsed.transport, 'amalgm-live');
33
+ const createdAt = text(row.created_at, parsed.createdAt, new Date(0).toISOString());
34
+ return {
35
+ id: String(row.id),
36
+ profileId: text(row.profile_id, parsed.profileId, String(row.id)),
37
+ targetUrl: text(row.target_url, parsed.targetUrl, 'about:blank'),
38
+ domains: list(row.domains_json, parsed.domains),
39
+ status: status === 'canceled' ? 'cancelled' : allowedStatus(status),
40
+ transport: transport === 'novnc' ? 'novnc' : transport === 'electron-splitview' ? 'electron-surface' : 'external',
41
+ ...(text(row.live_url, parsed.liveUrl) ? { liveUrl: text(row.live_url, parsed.liveUrl) } : {}),
42
+ expiresAt: text(row.expires_at, parsed.expiresAt, createdAt),
43
+ createdAt,
44
+ updatedAt: text(row.updated_at, parsed.updatedAt, createdAt),
45
+ ...(text(row.auth_bundle_id, parsed.authBundleId) ? { authBundleId: text(row.auth_bundle_id, parsed.authBundleId) } : {}),
46
+ };
47
+ }
48
+ function parse(value) {
49
+ try {
50
+ return typeof value === 'string' ? JSON.parse(value) : {};
51
+ }
52
+ catch {
53
+ return {};
54
+ }
55
+ }
56
+ function text(...values) {
57
+ return String(values.find((value) => typeof value === 'string' && value) || '');
58
+ }
59
+ function list(raw, fallback) {
60
+ try {
61
+ const value = typeof raw === 'string' ? JSON.parse(raw) : fallback;
62
+ return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
63
+ }
64
+ catch {
65
+ return [];
66
+ }
67
+ }
68
+ function allowedStatus(value) {
69
+ return ['pending', 'active', 'completed', 'cancelled', 'expired'].includes(value)
70
+ ? value : 'expired';
71
+ }
72
+ //# sourceMappingURL=legacy-rows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-rows.js","sourceRoot":"","sources":["../../../src/migration/legacy-rows.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import Database from 'better-sqlite3';
2
+ import type { BrowserRegistry, BrowserRegistrySnapshot } from '../ports.js';
3
+ import type { BrowserAuthBundle, BrowserLoginSession, BrowserProfile, BrowserRecording, BrowserSession } from '../types.js';
4
+ export interface SqliteBrowserRegistryOptions {
5
+ legacyJsonFile?: string;
6
+ }
7
+ export declare class SqliteBrowserRegistry implements BrowserRegistry {
8
+ readonly file: string;
9
+ readonly database: Database.Database;
10
+ constructor(file: string, options?: SqliteBrowserRegistryOptions);
11
+ snapshot(): BrowserRegistrySnapshot;
12
+ putProfile(value: BrowserProfile): void;
13
+ deleteProfile(id: string): void;
14
+ putSession(value: BrowserSession): void;
15
+ deleteSession(id: string): void;
16
+ putRecording(value: BrowserRecording): void;
17
+ putAuthBundle(value: BrowserAuthBundle): void;
18
+ deleteAuthBundle(id: string): void;
19
+ putLoginSession(value: BrowserLoginSession): void;
20
+ close(): void;
21
+ transaction<T>(operation: () => T): T;
22
+ getMeta(key: string): string | undefined;
23
+ setMeta(key: string, value: string): void;
24
+ acquireSessionLease(sessionId: string, ownerId: string, expiresAt: string): boolean;
25
+ releaseSessionLease(sessionId: string, ownerId: string): void;
26
+ private migrate;
27
+ private put;
28
+ private delete;
29
+ private importJson;
30
+ private meta;
31
+ private protectFiles;
32
+ }
@@ -0,0 +1,136 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import Database from 'better-sqlite3';
4
+ const EMPTY = {
5
+ schemaVersion: 1, profiles: [], sessions: [], recordings: [], authBundles: [], loginSessions: [],
6
+ };
7
+ export class SqliteBrowserRegistry {
8
+ file;
9
+ database;
10
+ constructor(file, options = {}) {
11
+ this.file = file;
12
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
13
+ this.database = new Database(file);
14
+ this.database.pragma('journal_mode = WAL');
15
+ this.database.pragma('synchronous = NORMAL');
16
+ this.database.pragma('foreign_keys = ON');
17
+ this.database.pragma('busy_timeout = 5000');
18
+ this.migrate();
19
+ if (options.legacyJsonFile)
20
+ this.importJson(options.legacyJsonFile);
21
+ this.protectFiles();
22
+ }
23
+ snapshot() {
24
+ const result = structuredClone(EMPTY);
25
+ for (const row of this.database.prepare('SELECT kind, json FROM browser_entities ORDER BY id').all()) {
26
+ const value = JSON.parse(row.json);
27
+ if (row.kind === 'profile')
28
+ result.profiles.push(value);
29
+ if (row.kind === 'session')
30
+ result.sessions.push(value);
31
+ if (row.kind === 'recording')
32
+ result.recordings.push(value);
33
+ if (row.kind === 'auth-bundle')
34
+ result.authBundles.push(value);
35
+ if (row.kind === 'login-session')
36
+ result.loginSessions.push(value);
37
+ }
38
+ return result;
39
+ }
40
+ putProfile(value) { this.put('profile', value); }
41
+ deleteProfile(id) { this.delete('profile', id); }
42
+ putSession(value) { this.put('session', value); }
43
+ deleteSession(id) { this.delete('session', id); }
44
+ putRecording(value) { this.put('recording', value); }
45
+ putAuthBundle(value) { this.put('auth-bundle', value); }
46
+ deleteAuthBundle(id) { this.delete('auth-bundle', id); }
47
+ putLoginSession(value) { this.put('login-session', value); }
48
+ close() { this.database.close(); }
49
+ transaction(operation) { return this.database.transaction(operation)(); }
50
+ getMeta(key) { return this.meta(key); }
51
+ setMeta(key, value) {
52
+ this.database.prepare(`INSERT INTO browser_meta(key, value) VALUES(?, ?)
53
+ ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(key, value);
54
+ }
55
+ acquireSessionLease(sessionId, ownerId, expiresAt) {
56
+ return this.transaction(() => {
57
+ this.database.prepare('DELETE FROM browser_session_leases WHERE expires_at <= ?').run(new Date().toISOString());
58
+ const existing = this.database.prepare('SELECT owner_id FROM browser_session_leases WHERE session_id = ?')
59
+ .get(sessionId);
60
+ if (existing && existing.owner_id !== ownerId)
61
+ return false;
62
+ this.database.prepare(`INSERT INTO browser_session_leases(session_id, owner_id, expires_at) VALUES (?, ?, ?)
63
+ ON CONFLICT(session_id) DO UPDATE SET owner_id = excluded.owner_id, expires_at = excluded.expires_at`).run(sessionId, ownerId, expiresAt);
64
+ return true;
65
+ });
66
+ }
67
+ releaseSessionLease(sessionId, ownerId) {
68
+ this.database.prepare('DELETE FROM browser_session_leases WHERE session_id = ? AND owner_id = ?').run(sessionId, ownerId);
69
+ }
70
+ migrate() {
71
+ this.database.exec(`
72
+ CREATE TABLE IF NOT EXISTS browser_meta (
73
+ key TEXT PRIMARY KEY,
74
+ value TEXT NOT NULL
75
+ );
76
+ CREATE TABLE IF NOT EXISTS browser_entities (
77
+ kind TEXT NOT NULL,
78
+ id TEXT NOT NULL,
79
+ json TEXT NOT NULL,
80
+ updated_at TEXT NOT NULL,
81
+ PRIMARY KEY (kind, id)
82
+ );
83
+ CREATE INDEX IF NOT EXISTS browser_entities_updated_idx
84
+ ON browser_entities(kind, updated_at DESC);
85
+ CREATE TABLE IF NOT EXISTS browser_session_leases (
86
+ session_id TEXT PRIMARY KEY,
87
+ owner_id TEXT NOT NULL,
88
+ expires_at TEXT NOT NULL
89
+ );
90
+ `);
91
+ this.database.prepare(`INSERT INTO browser_meta(key, value) VALUES('schema-version', '1')
92
+ ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run();
93
+ }
94
+ put(kind, value) {
95
+ const updatedAt = 'updatedAt' in value ? value.updatedAt : value.createdAt;
96
+ this.database.prepare(`INSERT INTO browser_entities(kind, id, json, updated_at)
97
+ VALUES (?, ?, ?, ?) ON CONFLICT(kind, id) DO UPDATE SET
98
+ json = excluded.json, updated_at = excluded.updated_at`).run(kind, value.id, JSON.stringify(value), updatedAt);
99
+ }
100
+ delete(kind, id) {
101
+ this.database.prepare('DELETE FROM browser_entities WHERE kind = ? AND id = ?').run(kind, id);
102
+ }
103
+ importJson(file) {
104
+ if (!fs.existsSync(file) || this.meta('json-import') === file)
105
+ return;
106
+ const value = JSON.parse(fs.readFileSync(file, 'utf8'));
107
+ if (value.schemaVersion !== 1)
108
+ throw new Error('Unsupported Browser JSON registry schema.');
109
+ this.transaction(() => {
110
+ for (const entity of value.profiles)
111
+ this.put('profile', entity);
112
+ for (const entity of value.sessions)
113
+ this.put('session', entity);
114
+ for (const entity of value.recordings)
115
+ this.put('recording', entity);
116
+ for (const entity of value.authBundles)
117
+ this.put('auth-bundle', entity);
118
+ for (const entity of value.loginSessions)
119
+ this.put('login-session', entity);
120
+ this.database.prepare(`INSERT INTO browser_meta(key, value) VALUES('json-import', ?)
121
+ ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(file);
122
+ });
123
+ }
124
+ meta(key) {
125
+ return this.database.prepare('SELECT value FROM browser_meta WHERE key = ?').get(key)?.value;
126
+ }
127
+ protectFiles() {
128
+ for (const candidate of [this.file, `${this.file}-wal`, `${this.file}-shm`]) {
129
+ try {
130
+ fs.chmodSync(candidate, 0o600);
131
+ }
132
+ catch { }
133
+ }
134
+ }
135
+ }
136
+ //# sourceMappingURL=sqlite-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlite-registry.js","sourceRoot":"","sources":["../../../src/persistence/sqlite-registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,93 @@
1
+ import type { BrowserAction, BrowserActionResult, BrowserArtifact, BrowserAuthBundle, BrowserBackendKind, BrowserCapability, BrowserEvent, BrowserLoginSession, BrowserProfile, BrowserRecording, BrowserRuntimeContext, BrowserSession } from './types.js';
2
+ export interface BrowserDriverSession {
3
+ session: BrowserSession;
4
+ context: BrowserRuntimeContext;
5
+ }
6
+ export interface BrowserDriver {
7
+ readonly kind: BrowserBackendKind;
8
+ readonly capabilities: readonly BrowserCapability[];
9
+ open(input: BrowserDriverSession): Promise<void>;
10
+ execute(input: BrowserDriverSession, action: BrowserAction): Promise<BrowserActionResult>;
11
+ close(input: BrowserDriverSession): Promise<void>;
12
+ saveState?(input: BrowserDriverSession): Promise<unknown>;
13
+ loadState?(input: BrowserDriverSession, state: unknown): Promise<void>;
14
+ startScreencast?(input: BrowserDriverSession, onFrame: (png: Buffer) => void): Promise<() => Promise<void>>;
15
+ }
16
+ export interface BrowserRegistrySnapshot {
17
+ schemaVersion: 1;
18
+ profiles: BrowserProfile[];
19
+ sessions: BrowserSession[];
20
+ recordings: BrowserRecording[];
21
+ authBundles: BrowserAuthBundle[];
22
+ loginSessions: BrowserLoginSession[];
23
+ }
24
+ export interface BrowserRegistry {
25
+ snapshot(): BrowserRegistrySnapshot;
26
+ putProfile(profile: BrowserProfile): void;
27
+ deleteProfile(id: string): void;
28
+ putSession(session: BrowserSession): void;
29
+ deleteSession(id: string): void;
30
+ putRecording(recording: BrowserRecording): void;
31
+ putAuthBundle(bundle: BrowserAuthBundle): void;
32
+ deleteAuthBundle(id: string): void;
33
+ putLoginSession(session: BrowserLoginSession): void;
34
+ }
35
+ export interface BrowserLeaseRegistry {
36
+ acquireSessionLease(sessionId: string, ownerId: string, expiresAt: string): boolean;
37
+ releaseSessionLease(sessionId: string, ownerId: string): void;
38
+ }
39
+ export declare function supportsBrowserLeases(value: BrowserRegistry): value is BrowserRegistry & BrowserLeaseRegistry;
40
+ export interface BrowserArtifactStore {
41
+ resolve(input: {
42
+ kind: BrowserArtifact['kind'];
43
+ name: string;
44
+ extension: string;
45
+ context: BrowserRuntimeContext;
46
+ }): Promise<string>;
47
+ inspect(path: string, kind: BrowserArtifact['kind'], mimeType: string): Promise<BrowserArtifact>;
48
+ remove(path: string): Promise<void>;
49
+ }
50
+ export interface BrowserEventSink {
51
+ publish(event: BrowserEvent): void | Promise<void>;
52
+ }
53
+ export interface BrowserLogger {
54
+ debug(message: string, fields?: Record<string, unknown>): void;
55
+ warn(message: string, fields?: Record<string, unknown>): void;
56
+ error(message: string, fields?: Record<string, unknown>): void;
57
+ }
58
+ export interface BrowserClock {
59
+ now(): Date;
60
+ }
61
+ export interface BrowserProfileDirectories {
62
+ pathFor(id: string): string;
63
+ lastTouchedAt(id: string): number;
64
+ isLocked(id: string): boolean;
65
+ remove(id: string): void;
66
+ }
67
+ export interface BrowserRuntimeSelector {
68
+ select(context: BrowserRuntimeContext): BrowserBackendKind;
69
+ }
70
+ export interface BrowserAuthorization {
71
+ authorize(input: {
72
+ operation: string;
73
+ resourceId?: string;
74
+ context: BrowserRuntimeContext;
75
+ }): void | Promise<void>;
76
+ }
77
+ export interface ProcessResult {
78
+ code: number;
79
+ stdout: string;
80
+ stderr: string;
81
+ }
82
+ export interface ProcessLauncher {
83
+ run(input: {
84
+ command: string;
85
+ args: string[];
86
+ cwd: string;
87
+ env?: NodeJS.ProcessEnv;
88
+ stdin?: string;
89
+ signal?: AbortSignal;
90
+ timeoutMs: number;
91
+ outputLimit: number;
92
+ }): Promise<ProcessResult>;
93
+ }
@@ -0,0 +1,4 @@
1
+ export function supportsBrowserLeases(value) {
2
+ return 'acquireSessionLease' in value && 'releaseSessionLease' in value;
3
+ }
4
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/ports.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,OAAO,qBAAqB,IAAI,KAAK,IAAI,qBAAqB,IAAI,KAAK,CAAC;AAC1E,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { ProcessLauncher, ProcessResult } from './ports.js';
2
+ export declare class NodeProcessLauncher implements ProcessLauncher {
3
+ run(input: Parameters<ProcessLauncher['run']>[0]): Promise<ProcessResult>;
4
+ }
@@ -0,0 +1,63 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { BrowserError } from './errors.js';
3
+ export class NodeProcessLauncher {
4
+ async run(input) {
5
+ if (input.signal?.aborted)
6
+ throw new BrowserError('ABORTED', 'Browser operation was cancelled.');
7
+ return new Promise((resolve, reject) => {
8
+ const child = spawn(input.command, input.args, {
9
+ cwd: input.cwd,
10
+ env: input.env,
11
+ shell: false,
12
+ stdio: [input.stdin === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'],
13
+ });
14
+ let stdout = '';
15
+ let stderr = '';
16
+ let settled = false;
17
+ let timedOut = false;
18
+ let forceTimer;
19
+ const append = (current, chunk) => (current + chunk.toString()).slice(-input.outputLimit);
20
+ child.stdout.on('data', (chunk) => { stdout = append(stdout, chunk); });
21
+ child.stderr.on('data', (chunk) => { stderr = append(stderr, chunk); });
22
+ if (input.stdin !== undefined)
23
+ child.stdin.end(input.stdin);
24
+ const terminate = () => {
25
+ child.kill('SIGTERM');
26
+ forceTimer = setTimeout(() => child.kill('SIGKILL'), 2_000);
27
+ forceTimer.unref();
28
+ };
29
+ const timeout = setTimeout(() => { timedOut = true; terminate(); }, input.timeoutMs);
30
+ const abort = () => terminate();
31
+ input.signal?.addEventListener('abort', abort, { once: true });
32
+ const finish = (error, result) => {
33
+ if (settled)
34
+ return;
35
+ settled = true;
36
+ clearTimeout(timeout);
37
+ if (forceTimer)
38
+ clearTimeout(forceTimer);
39
+ input.signal?.removeEventListener('abort', abort);
40
+ if (error)
41
+ reject(error);
42
+ else
43
+ resolve(result);
44
+ };
45
+ child.on('error', (error) => finish(error));
46
+ child.on('close', (code, signal) => {
47
+ if (input.signal?.aborted) {
48
+ finish(new BrowserError('ABORTED', 'Browser operation was cancelled.'));
49
+ }
50
+ else if (timedOut) {
51
+ finish(new BrowserError('TIMEOUT', `Browser process exceeded ${input.timeoutMs}ms.`));
52
+ }
53
+ else if (signal || code === null) {
54
+ finish(new BrowserError('PROCESS_FAILED', `Browser process terminated by ${signal || 'an unknown signal'}.`));
55
+ }
56
+ else {
57
+ finish(undefined, { code, stdout, stderr });
58
+ }
59
+ });
60
+ });
61
+ }
62
+ }
63
+ //# sourceMappingURL=process.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/process.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import { BrowserAuthService } from './auth/service.js';
2
+ import { BrowserLoginService } from './auth/login.js';
3
+ import { BrowserAuthVault } from './auth/vault.js';
4
+ import { EncryptedSecretFile } from './cookies/secret-file.js';
5
+ import type { BrowserCookieJar } from './cookies/jar.js';
6
+ import type { BrowserCookieCoordinator } from './cookies/coordinator.js';
7
+ import type { BrowserArtifactStore, ProcessLauncher } from './ports.js';
8
+ import { BrowserRecordingService } from './recording/service.js';
9
+ import { BrowserService as CoreBrowserService, type BrowserServiceOptions } from './service.js';
10
+ import type { BrowserRuntimeContext } from './types.js';
11
+ export interface BrowserProductServiceOptions extends BrowserServiceOptions {
12
+ authVault: BrowserAuthVault;
13
+ loginSecrets: EncryptedSecretFile;
14
+ artifactStore: BrowserArtifactStore;
15
+ processLauncher: ProcessLauncher;
16
+ ffmpegBinary?: string;
17
+ cookieJar: BrowserCookieJar;
18
+ cookieCoordinator: BrowserCookieCoordinator;
19
+ }
20
+ export declare class BrowserProductService extends CoreBrowserService {
21
+ readonly productOptions: BrowserProductServiceOptions;
22
+ readonly auth: BrowserAuthService;
23
+ readonly login: BrowserLoginService;
24
+ readonly recordings: BrowserRecordingService;
25
+ readonly cookies: BrowserCookieJar;
26
+ readonly cookieAdapters: BrowserCookieCoordinator;
27
+ constructor(productOptions: BrowserProductServiceOptions);
28
+ closeSession(sessionId: string, context?: BrowserRuntimeContext): Promise<void>;
29
+ protected referencedProfileIds(): Set<string>;
30
+ }
@@ -0,0 +1,38 @@
1
+ import { BrowserAuthService } from './auth/service.js';
2
+ import { BrowserLoginService } from './auth/login.js';
3
+ import { BrowserRecordingService } from './recording/service.js';
4
+ import { BrowserService as CoreBrowserService } from './service.js';
5
+ export class BrowserProductService extends CoreBrowserService {
6
+ productOptions;
7
+ auth;
8
+ login;
9
+ recordings;
10
+ cookies;
11
+ cookieAdapters;
12
+ constructor(productOptions) {
13
+ super(productOptions);
14
+ this.productOptions = productOptions;
15
+ this.cookies = productOptions.cookieJar;
16
+ this.cookieAdapters = productOptions.cookieCoordinator;
17
+ const now = () => productOptions.clock.now();
18
+ this.auth = new BrowserAuthService(this, productOptions.registry, productOptions.authVault, now);
19
+ this.login = new BrowserLoginService(this, this.auth, productOptions.registry, productOptions.loginSecrets, now);
20
+ this.recordings = new BrowserRecordingService(this, productOptions.registry, productOptions.artifactStore, productOptions.processLauncher, productOptions.ffmpegBinary, now);
21
+ }
22
+ async closeSession(sessionId, context = {}) {
23
+ if (this.recordings.isActive(sessionId)) {
24
+ await this.recordings.stop(sessionId).catch(() => this.recordings.forceStop(sessionId));
25
+ }
26
+ await super.closeSession(sessionId, context);
27
+ }
28
+ referencedProfileIds() {
29
+ const ids = super.referencedProfileIds();
30
+ for (const bundle of this.auth.list())
31
+ ids.add(bundle.profileId);
32
+ for (const login of this.login.list())
33
+ if (['pending', 'active'].includes(login.status))
34
+ ids.add(login.profileId);
35
+ return ids;
36
+ }
37
+ }
38
+ //# sourceMappingURL=product-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product-service.js","sourceRoot":"","sources":["../../src/product-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAMtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAA8B,MAAM,cAAc,CAAC;AAahG,MAAM,OAAO,qBAAsB,SAAQ,kBAAkB;IAOtC;IANZ,IAAI,CAAqB;IACzB,KAAK,CAAsB;IAC3B,UAAU,CAA0B;IACpC,OAAO,CAAmB;IAC1B,cAAc,CAA2B;IAElD,YAAqB,cAA4C;QAC/D,KAAK,CAAC,cAAc,CAAC,CAAC;QADH,mBAAc,GAAd,cAAc,CAA8B;QAE/D,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC,iBAAiB,CAAC;QACvD,MAAM,GAAG,GAAG,GAAS,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACjG,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACjH,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,CAC3C,IAAI,EACJ,cAAc,CAAC,QAAQ,EACvB,cAAc,CAAC,aAAa,EAC5B,cAAc,CAAC,eAAe,EAC9B,cAAc,CAAC,YAAY,EAC3B,GAAG,CACJ,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,UAAiC,EAAE;QAChF,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAEkB,oBAAoB;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClH,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}
@@ -0,0 +1,9 @@
1
+ import type { BrowserProfileDirectories } from '../ports.js';
2
+ export declare class LocalBrowserProfileDirectories implements BrowserProfileDirectories {
3
+ readonly root: string;
4
+ constructor(root: string);
5
+ pathFor(id: string): string;
6
+ lastTouchedAt(id: string): number;
7
+ isLocked(id: string): boolean;
8
+ remove(id: string): void;
9
+ }
@@ -0,0 +1,57 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { BrowserError } from '../errors.js';
4
+ import { safeId } from '../ids.js';
5
+ export class LocalBrowserProfileDirectories {
6
+ root;
7
+ constructor(root) {
8
+ this.root = root;
9
+ fs.mkdirSync(path.resolve(root), { recursive: true, mode: 0o700 });
10
+ }
11
+ pathFor(id) { return path.join(path.resolve(this.root), safeId(id)); }
12
+ lastTouchedAt(id) {
13
+ const profile = this.pathFor(id);
14
+ return [profile, 'Local State', 'Default', 'Default/Cookies', 'Default/Network/Cookies', 'Default/History']
15
+ .map((entry) => entry === profile ? entry : path.join(profile, entry))
16
+ .reduce((latest, candidate) => {
17
+ try {
18
+ return Math.max(latest, fs.statSync(candidate).mtimeMs);
19
+ }
20
+ catch {
21
+ return latest;
22
+ }
23
+ }, 0);
24
+ }
25
+ isLocked(id) {
26
+ const lock = path.join(this.pathFor(id), 'SingletonLock');
27
+ try {
28
+ const stat = fs.lstatSync(lock);
29
+ const value = stat.isSymbolicLink()
30
+ ? fs.readlinkSync(lock)
31
+ : fs.readFileSync(lock, 'utf8').slice(0, 256);
32
+ const pid = Number(value.match(/(?:^|[-\s])(\d+)(?:$|\s)/)?.[1] || 0);
33
+ if (pid) {
34
+ try {
35
+ process.kill(pid, 0);
36
+ return true;
37
+ }
38
+ catch (error) {
39
+ if (error.code === 'EPERM')
40
+ return true;
41
+ }
42
+ }
43
+ return !stat.isSymbolicLink() && Date.now() - stat.mtimeMs < 5 * 60_000;
44
+ }
45
+ catch {
46
+ return false;
47
+ }
48
+ }
49
+ remove(id) {
50
+ const target = this.pathFor(id);
51
+ if (path.dirname(target) !== path.resolve(this.root)) {
52
+ throw new BrowserError('INVALID_INPUT', `Unsafe Browser profile path: ${target}`);
53
+ }
54
+ fs.rmSync(target, { recursive: true, force: true });
55
+ }
56
+ }
57
+ //# sourceMappingURL=directories.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"directories.js","sourceRoot":"","sources":["../../../src/profiles/directories.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import type { BrowserProfileDirectories, BrowserRegistry } from '../ports.js';
2
+ import type { BrowserProfile, BrowserProfileStatus, BrowserSession } from '../types.js';
3
+ export interface BrowserProfileStoreOptions {
4
+ registry: BrowserRegistry;
5
+ directories?: BrowserProfileDirectories;
6
+ now(): string;
7
+ generate(): string;
8
+ publish(profileId: string): void;
9
+ }
10
+ export declare class BrowserProfileStore {
11
+ private readonly options;
12
+ constructor(options: BrowserProfileStoreOptions);
13
+ create(input: {
14
+ id?: string;
15
+ name: string;
16
+ kind?: BrowserProfile['kind'];
17
+ }): BrowserProfile;
18
+ list(): BrowserProfile[];
19
+ get(id: string): BrowserProfile;
20
+ update(id: string, patch: {
21
+ name?: string;
22
+ kind?: BrowserProfile['kind'];
23
+ }): BrowserProfile;
24
+ inspect(id: string, sessions: BrowserSession[], referenced: ReadonlySet<string>): BrowserProfileStatus;
25
+ delete(id: string, sessions: BrowserSession[]): void;
26
+ prune(maxAgeMs: number, referenced: ReadonlySet<string>, sessions: BrowserSession[]): string[];
27
+ ensure(idValue: string, kind: BrowserProfile['kind'], name?: string): BrowserProfile;
28
+ touch(id: string): void;
29
+ private find;
30
+ }