@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 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/adapters/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,EAAE,WAAW,UAAU,CAAC,IAAI,EAAE;QAClC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM;YACzB,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;gBACxE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjD,CAAC,CAAC;YACH,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,MAAM,GAAG,KAAmC,CAAC;IACnD,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE;gBACjF,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,MAAM,CAAC,OAAO,CAAC,KAAK,gCAAgC,EAAE;aACpG;YACD,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE;SACrH,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QACtF,iBAAiB,EAAE,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SACvE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,6EAA6E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC3G,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}
@@ -0,0 +1,17 @@
1
+ export interface JsonRpcRequest {
2
+ jsonrpc?: string;
3
+ id?: string | number | null;
4
+ method?: string;
5
+ params?: Record<string, unknown>;
6
+ }
7
+ export interface BrowserMcpTool {
8
+ name: string;
9
+ description: string;
10
+ inputSchema: Record<string, unknown>;
11
+ handler(input: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
12
+ }
13
+ export interface BrowserMcpServer {
14
+ tools: BrowserMcpTool[];
15
+ handle(message: JsonRpcRequest): Promise<unknown>;
16
+ start(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream): Promise<() => Promise<void>>;
17
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/adapters/mcp/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import type { ProductActionName } from '../actions.js';
2
+ export declare function resolveBrowserAlias(raw: string, input: Record<string, unknown>): {
3
+ name: ProductActionName;
4
+ input: Record<string, unknown>;
5
+ };
@@ -0,0 +1,14 @@
1
+ const cuaAliases = new Set([
2
+ 'cua_screenshot', 'cua_click', 'cua_double_click', 'cua_move',
3
+ 'cua_scroll', 'cua_type', 'cua_keypress', 'cua_drag',
4
+ ]);
5
+ export function resolveBrowserAlias(raw, input) {
6
+ let name = raw.replace(/^toolbox__browser_/, '').replace(/^browser\./, '');
7
+ if (name.startsWith('browser_'))
8
+ name = name.slice('browser_'.length);
9
+ if (cuaAliases.has(name)) {
10
+ return { name: 'cua', input: { ...input, operation: { ...input, kind: name.slice('cua_'.length) } } };
11
+ }
12
+ return { name: name, input };
13
+ }
14
+ //# sourceMappingURL=aliases.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../../../src/adapters/toolbox/aliases.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,gBAAgB,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU;IAC7D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU;CACrD,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,KAA8B;IAE9B,IAAI,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAyB,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { BrowserProductService } from '../../product-service.js';
2
+ import type { BrowserRuntimeContext } from '../../types.js';
3
+ export interface BrowserToolboxExecutionPolicy {
4
+ canExecute(actionId: string, context: BrowserRuntimeContext): boolean | Promise<boolean>;
5
+ }
6
+ export declare function createBrowserToolboxExecutor(browser: BrowserProductService, policy?: BrowserToolboxExecutionPolicy): (actionId: string, input: Record<string, unknown>, context?: BrowserRuntimeContext) => Promise<unknown>;
@@ -0,0 +1,13 @@
1
+ import { executeProductAction } from '../execute.js';
2
+ import { resolveBrowserAlias } from './aliases.js';
3
+ import { BrowserError } from '../../errors.js';
4
+ export function createBrowserToolboxExecutor(browser, policy) {
5
+ return async (actionId, input, context = {}) => {
6
+ const action = resolveBrowserAlias(actionId, input);
7
+ if (policy && !await policy.canExecute(`browser.${action.name}`, context)) {
8
+ throw new BrowserError('AUTHORIZATION_DENIED', `Browser action browser.${action.name} is disabled.`);
9
+ }
10
+ return executeProductAction(browser, action.name, action.input, context);
11
+ };
12
+ }
13
+ //# sourceMappingURL=executor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../src/adapters/toolbox/executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAM/C,MAAM,UAAU,4BAA4B,CAC1C,OAA8B,EAC9B,MAAsC;IAEtC,OAAO,KAAK,EACV,QAAgB,EAChB,KAA8B,EAC9B,UAAiC,EAAE,EACjB,EAAE;QACpB,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,MAAM,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,0BAA0B,MAAM,CAAC,IAAI,eAAe,CAAC,CAAC;QACvG,CAAC;QACD,OAAO,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ export interface BrowserToolboxManifest {
2
+ id: 'browser';
3
+ name: string;
4
+ description: string;
5
+ actions: Array<{
6
+ id: string;
7
+ name: string;
8
+ capability: 'core' | 'computer-use' | 'recording' | 'auth';
9
+ description: string;
10
+ inputSchema: Record<string, unknown>;
11
+ mcpName: string;
12
+ }>;
13
+ legacyGrants: Record<string, string[]>;
14
+ }
15
+ export declare function browserToolboxManifest(): BrowserToolboxManifest;
@@ -0,0 +1,24 @@
1
+ import { browserActionDescriptors } from '../actions.js';
2
+ export function browserToolboxManifest() {
3
+ const byCapability = (capability) => browserActionDescriptors.filter((action) => action.capability === capability).map((action) => `browser.${action.name}`);
4
+ return {
5
+ id: 'browser',
6
+ name: 'Browser',
7
+ description: 'Browse and operate the web in visible Electron or isolated headless Chromium sessions.',
8
+ actions: browserActionDescriptors.map((action) => ({
9
+ id: `browser.${action.name}`,
10
+ name: action.name,
11
+ capability: action.capability,
12
+ description: action.description,
13
+ inputSchema: action.inputSchema,
14
+ mcpName: `toolbox__browser_${action.name}`,
15
+ })),
16
+ legacyGrants: {
17
+ browser_cua: byCapability('computer-use'),
18
+ browser_recording: byCapability('recording'),
19
+ browser_auth: byCapability('auth'),
20
+ 'amalgm.browser': browserActionDescriptors.map((action) => `browser.${action.name}`),
21
+ },
22
+ };
23
+ }
24
+ //# sourceMappingURL=manifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../../src/adapters/toolbox/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAiBzD,MAAM,UAAU,sBAAsB;IACpC,MAAM,YAAY,GAAG,CAAC,UAAmE,EAAY,EAAE,CACrG,wBAAwB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1H,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wFAAwF;QACrG,OAAO,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,WAAW,MAAM,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,oBAAoB,MAAM,CAAC,IAAI,EAAE;SAC3C,CAAC,CAAC;QACH,YAAY,EAAE;YACZ,WAAW,EAAE,YAAY,CAAC,cAAc,CAAC;YACzC,iBAAiB,EAAE,YAAY,CAAC,WAAW,CAAC;YAC5C,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC;YAClC,gBAAgB,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC;SACrF;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { BrowserArtifact, BrowserRuntimeContext } from './types.js';
2
+ import type { BrowserArtifactStore } from './ports.js';
3
+ export declare class LocalArtifactStore implements BrowserArtifactStore {
4
+ readonly fallbackRoot: string;
5
+ constructor(fallbackRoot: string);
6
+ resolve(input: {
7
+ kind: BrowserArtifact['kind'];
8
+ name: string;
9
+ extension: string;
10
+ context: BrowserRuntimeContext;
11
+ }): Promise<string>;
12
+ inspect(file: string, kind: BrowserArtifact['kind'], mimeType: string): Promise<BrowserArtifact>;
13
+ remove(file: string): Promise<void>;
14
+ }
@@ -0,0 +1,28 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { newId, safeId } from './ids.js';
4
+ export class LocalArtifactStore {
5
+ fallbackRoot;
6
+ constructor(fallbackRoot) {
7
+ this.fallbackRoot = fallbackRoot;
8
+ }
9
+ async resolve(input) {
10
+ const root = input.context.artifactDestination
11
+ ? path.resolve(input.context.artifactDestination)
12
+ : this.fallbackRoot;
13
+ const directory = input.kind === 'recording'
14
+ ? path.join(root, '.amalgm', 'recordings')
15
+ : path.join(root, '.amalgm', 'browser', `${input.kind}s`);
16
+ await fs.promises.mkdir(directory, { recursive: true, mode: 0o700 });
17
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
18
+ return path.join(directory, `${safeId(input.name)}-${stamp}.${safeId(input.extension)}`);
19
+ }
20
+ async inspect(file, kind, mimeType) {
21
+ const stats = await fs.promises.stat(file);
22
+ return { id: newId('artifact'), kind, path: file, mimeType, bytes: stats.size, createdAt: stats.birthtime.toISOString() };
23
+ }
24
+ async remove(file) {
25
+ await fs.promises.rm(file, { force: true });
26
+ }
27
+ }
28
+ //# sourceMappingURL=artifacts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,kBAAkB;IACR;IAArB,YAAqB,YAAoB;QAApB,iBAAY,GAAZ,YAAY,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,OAAO,CAAC,KAKb;QACC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB;YAC5C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACjD,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QACtB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B,EAAE,QAAgB;QACzE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;IAC5H,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF"}
@@ -0,0 +1,3 @@
1
+ export declare function filterAuthState(state: unknown, domains: string[]): unknown;
2
+ export declare function stateStorageKinds(state: unknown): Array<'cookies' | 'localStorage' | 'sessionStorage'>;
3
+ export declare function inferDomains(targetUrl: string, values?: string[]): string[];
@@ -0,0 +1,60 @@
1
+ import { cookieHostIsProtected } from '../cookies/policy.js';
2
+ export function filterAuthState(state, domains) {
3
+ if (!state || typeof state !== 'object')
4
+ return { cookies: [], origins: [] };
5
+ const source = state;
6
+ const allowed = domains.map(normalizeDomain).filter(Boolean);
7
+ const cookies = Array.isArray(source.cookies)
8
+ ? source.cookies.filter((cookie) => cookieAllowed(cookie, allowed))
9
+ : [];
10
+ const origins = Array.isArray(source.origins)
11
+ ? source.origins.filter((origin) => originAllowed(origin, allowed))
12
+ : [];
13
+ return { ...source, cookies, origins };
14
+ }
15
+ export function stateStorageKinds(state) {
16
+ if (!state || typeof state !== 'object')
17
+ return [];
18
+ const source = state;
19
+ const kinds = [];
20
+ if (Array.isArray(source.cookies) && source.cookies.length)
21
+ kinds.push('cookies');
22
+ const origins = Array.isArray(source.origins) ? source.origins : [];
23
+ if (origins.some((origin) => Array.isArray(origin.localStorage) && origin.localStorage.length))
24
+ kinds.push('localStorage');
25
+ if (origins.some((origin) => Array.isArray(origin.sessionStorage) && origin.sessionStorage.length))
26
+ kinds.push('sessionStorage');
27
+ return kinds;
28
+ }
29
+ export function inferDomains(targetUrl, values = []) {
30
+ const domains = values.map(normalizeDomain).filter(Boolean);
31
+ try {
32
+ const inferred = normalizeDomain(new URL(targetUrl).hostname);
33
+ if (inferred)
34
+ domains.push(inferred);
35
+ }
36
+ catch { }
37
+ return [...new Set(domains)];
38
+ }
39
+ function cookieAllowed(value, domains) {
40
+ if (!value || typeof value !== 'object')
41
+ return false;
42
+ const domain = normalizeDomain(String(value.domain || ''));
43
+ return domains.some((allowed) => domain === allowed || domain.endsWith(`.${allowed}`));
44
+ }
45
+ function originAllowed(value, domains) {
46
+ if (!value || typeof value !== 'object')
47
+ return false;
48
+ try {
49
+ const host = new URL(String(value.origin || '')).hostname.toLowerCase();
50
+ return domains.some((allowed) => host === allowed || host.endsWith(`.${allowed}`));
51
+ }
52
+ catch {
53
+ return false;
54
+ }
55
+ }
56
+ function normalizeDomain(value) {
57
+ const domain = value.trim().replace(/^\./, '').toLowerCase();
58
+ return domain && !cookieHostIsProtected(domain) ? domain : '';
59
+ }
60
+ //# sourceMappingURL=filter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/auth/filter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import type { BrowserRegistry } from '../ports.js';
2
+ import type { BrowserService } from '../service.js';
3
+ import type { BrowserActionResult, BrowserLoginSession, BrowserRuntimeContext, CuaOperation } from '../types.js';
4
+ import { EncryptedSecretFile } from '../cookies/secret-file.js';
5
+ import type { BrowserAuthService } from './service.js';
6
+ export declare class BrowserLoginService {
7
+ readonly browser: BrowserService;
8
+ readonly auth: BrowserAuthService;
9
+ readonly registry: BrowserRegistry;
10
+ readonly secrets: EncryptedSecretFile;
11
+ readonly now: () => Date;
12
+ constructor(browser: BrowserService, auth: BrowserAuthService, registry: BrowserRegistry, secrets: EncryptedSecretFile, now?: () => Date);
13
+ list(): BrowserLoginSession[];
14
+ get(id: string): BrowserLoginSession;
15
+ create(input: {
16
+ targetUrl: string;
17
+ profileId?: string;
18
+ domains?: string[];
19
+ ttlMs?: number;
20
+ transport?: string;
21
+ liveUrl?: string;
22
+ context?: BrowserRuntimeContext;
23
+ }): {
24
+ session: BrowserLoginSession;
25
+ token: string;
26
+ url: string;
27
+ };
28
+ activate(id: string, token: string, context?: BrowserRuntimeContext): Promise<BrowserLoginSession>;
29
+ input(id: string, token: string, operation: CuaOperation, context?: BrowserRuntimeContext): Promise<BrowserActionResult>;
30
+ complete(input: {
31
+ id: string;
32
+ token: string;
33
+ bundleName?: string;
34
+ context?: BrowserRuntimeContext;
35
+ }): Promise<BrowserLoginSession>;
36
+ cancel(id: string, token: string): Promise<BrowserLoginSession>;
37
+ private authorized;
38
+ private expire;
39
+ private update;
40
+ private readSecrets;
41
+ }
@@ -0,0 +1,145 @@
1
+ import crypto from 'node:crypto';
2
+ import { BrowserError } from '../errors.js';
3
+ import { newId, safeId } from '../ids.js';
4
+ import { inferDomains } from './filter.js';
5
+ import { resolveLoginTransport } from './transport.js';
6
+ export class BrowserLoginService {
7
+ browser;
8
+ auth;
9
+ registry;
10
+ secrets;
11
+ now;
12
+ constructor(browser, auth, registry, secrets, now = () => new Date()) {
13
+ this.browser = browser;
14
+ this.auth = auth;
15
+ this.registry = registry;
16
+ this.secrets = secrets;
17
+ this.now = now;
18
+ }
19
+ list() {
20
+ return this.registry.snapshot().loginSessions.map((session) => this.expire(session));
21
+ }
22
+ get(id) {
23
+ const session = this.list().find((value) => value.id === safeId(id));
24
+ if (!session)
25
+ throw new BrowserError('NOT_FOUND', `Browser login session ${id} does not exist.`);
26
+ return session;
27
+ }
28
+ create(input) {
29
+ try {
30
+ new URL(input.targetUrl);
31
+ }
32
+ catch {
33
+ throw new BrowserError('INVALID_INPUT', 'Login target must be a valid URL.');
34
+ }
35
+ const id = safeId(newId('login'));
36
+ const token = crypto.randomBytes(32).toString('base64url');
37
+ const timestamp = this.now();
38
+ const ttlMs = Math.min(Math.max(input.ttlMs || 15 * 60_000, 60_000), 60 * 60_000);
39
+ const context = input.context || {};
40
+ const transport = resolveLoginTransport({
41
+ ...(input.transport ? { transport: input.transport } : {}),
42
+ ...(input.liveUrl ? { liveUrl: input.liveUrl } : {}),
43
+ context,
44
+ });
45
+ const domains = inferDomains(input.targetUrl, input.domains);
46
+ if (!domains.length)
47
+ throw new BrowserError('INVALID_INPUT', 'Login target has no permitted authentication domain.');
48
+ const session = {
49
+ id,
50
+ profileId: safeId(input.profileId || id),
51
+ targetUrl: input.targetUrl,
52
+ domains,
53
+ status: 'pending',
54
+ ...transport,
55
+ expiresAt: new Date(timestamp.getTime() + ttlMs).toISOString(),
56
+ createdAt: timestamp.toISOString(),
57
+ updatedAt: timestamp.toISOString(),
58
+ };
59
+ this.registry.putLoginSession(session);
60
+ const data = this.readSecrets();
61
+ data.hashes[id] = tokenHash(token);
62
+ this.secrets.write(data);
63
+ void this.browser.publish({ type: 'login.updated', profileId: session.profileId, loginSessionId: id, status: session.status });
64
+ return { session, token, url: `/browser-auth/${encodeURIComponent(id)}?token=${encodeURIComponent(token)}` };
65
+ }
66
+ async activate(id, token, context = {}) {
67
+ const login = this.authorized(id, token);
68
+ const browserSession = await this.browser.createSession({
69
+ id: `login-${login.id}`,
70
+ profileId: login.profileId,
71
+ profileKind: 'durable',
72
+ context,
73
+ });
74
+ await this.browser.execute(browserSession.id, { type: 'open', url: login.targetUrl }, context);
75
+ return this.update(login, { status: 'active' });
76
+ }
77
+ async input(id, token, operation, context = {}) {
78
+ const login = this.authorized(id, token);
79
+ if (login.status !== 'active')
80
+ throw new BrowserError('CONFLICT', `Login session ${id} is ${login.status}.`);
81
+ return this.browser.execute(`login-${login.id}`, { type: 'cua', operation }, context);
82
+ }
83
+ async complete(input) {
84
+ const login = this.authorized(input.id, input.token);
85
+ if (login.status !== 'active')
86
+ throw new BrowserError('CONFLICT', `Login session ${login.id} is ${login.status}.`);
87
+ const bundle = await this.auth.save({
88
+ sessionId: `login-${login.id}`,
89
+ name: input.bundleName || `Login ${login.id}`,
90
+ domains: login.domains,
91
+ ...(input.context ? { context: input.context } : {}),
92
+ });
93
+ await this.browser.closeSession(`login-${login.id}`, input.context || {}).catch(() => undefined);
94
+ return this.update(login, { status: 'completed', authBundleId: bundle.id });
95
+ }
96
+ async cancel(id, token) {
97
+ const login = this.authorized(id, token);
98
+ if (login.status === 'active') {
99
+ await this.browser.closeSession(`login-${login.id}`).catch(() => undefined);
100
+ }
101
+ return this.update(login, { status: 'cancelled' });
102
+ }
103
+ authorized(id, token) {
104
+ const login = this.get(id);
105
+ if (['cancelled', 'completed', 'expired'].includes(login.status)) {
106
+ throw new BrowserError('CONFLICT', `Login session ${id} is ${login.status}.`);
107
+ }
108
+ const expected = this.readSecrets().hashes[login.id];
109
+ if (!expected || !constantTimeEqual(expected, tokenHash(token))) {
110
+ throw new BrowserError('AUTHORIZATION_DENIED', 'Login session token is invalid.');
111
+ }
112
+ return login;
113
+ }
114
+ expire(session) {
115
+ if (['pending', 'active'].includes(session.status) && Date.parse(session.expiresAt) <= this.now().getTime()) {
116
+ if (session.status === 'active')
117
+ void this.browser.closeSession(`login-${session.id}`).catch(() => undefined);
118
+ return this.update(session, { status: 'expired' });
119
+ }
120
+ return session;
121
+ }
122
+ update(session, patch) {
123
+ const updated = { ...session, ...patch, updatedAt: this.now().toISOString() };
124
+ this.registry.putLoginSession(updated);
125
+ if (['completed', 'cancelled', 'expired'].includes(updated.status)) {
126
+ const data = this.readSecrets();
127
+ delete data.hashes[updated.id];
128
+ this.secrets.write(data);
129
+ }
130
+ void this.browser.publish({
131
+ type: 'login.updated', profileId: updated.profileId, loginSessionId: updated.id, status: updated.status,
132
+ });
133
+ return updated;
134
+ }
135
+ readSecrets() {
136
+ return this.secrets.read() || { schemaVersion: 1, hashes: {} };
137
+ }
138
+ }
139
+ function tokenHash(token) { return crypto.createHash('sha256').update(token).digest('hex'); }
140
+ function constantTimeEqual(left, right) {
141
+ const a = Buffer.from(left);
142
+ const b = Buffer.from(right);
143
+ return a.length === b.length && crypto.timingSafeEqual(a, b);
144
+ }
145
+ //# sourceMappingURL=login.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/auth/login.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { BrowserAuthBundle } from '../types.js';
2
+ export interface PortableAuthResource {
3
+ schemaVersion: 1;
4
+ bundle: BrowserAuthBundle;
5
+ encryption: {
6
+ algorithm: 'aes-256-gcm';
7
+ iv: string;
8
+ tag: string;
9
+ ciphertext: string;
10
+ };
11
+ }
12
+ interface PortablePayload {
13
+ bundle: BrowserAuthBundle;
14
+ state: unknown;
15
+ }
16
+ export declare function encryptPortableAuth(bundle: BrowserAuthBundle, state: unknown, keyValue: Buffer | string): PortableAuthResource;
17
+ export declare function decryptPortableAuth(resource: PortableAuthResource, keyValue: Buffer | string): PortablePayload;
18
+ export {};
@@ -0,0 +1,48 @@
1
+ import crypto from 'node:crypto';
2
+ import { BrowserError } from '../errors.js';
3
+ export function encryptPortableAuth(bundle, state, keyValue) {
4
+ const key = portableKey(keyValue);
5
+ const iv = crypto.randomBytes(12);
6
+ const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
7
+ const ciphertext = Buffer.concat([
8
+ cipher.update(JSON.stringify({ bundle, state })),
9
+ cipher.final(),
10
+ ]);
11
+ return {
12
+ schemaVersion: 1,
13
+ bundle,
14
+ encryption: {
15
+ algorithm: 'aes-256-gcm',
16
+ iv: iv.toString('base64'),
17
+ tag: cipher.getAuthTag().toString('base64'),
18
+ ciphertext: ciphertext.toString('base64'),
19
+ },
20
+ };
21
+ }
22
+ export function decryptPortableAuth(resource, keyValue) {
23
+ try {
24
+ if (resource.schemaVersion !== 1 || resource.encryption.algorithm !== 'aes-256-gcm')
25
+ throw new Error();
26
+ const decipher = crypto.createDecipheriv('aes-256-gcm', portableKey(keyValue), Buffer.from(resource.encryption.iv, 'base64'));
27
+ decipher.setAuthTag(Buffer.from(resource.encryption.tag, 'base64'));
28
+ const payload = JSON.parse(Buffer.concat([
29
+ decipher.update(Buffer.from(resource.encryption.ciphertext, 'base64')),
30
+ decipher.final(),
31
+ ]).toString('utf8'));
32
+ if (JSON.stringify(payload.bundle) !== JSON.stringify(resource.bundle))
33
+ throw new Error();
34
+ return payload;
35
+ }
36
+ catch (error) {
37
+ if (error instanceof BrowserError)
38
+ throw error;
39
+ throw new BrowserError('PROCESS_FAILED', 'Portable Browser auth resource failed integrity verification.');
40
+ }
41
+ }
42
+ function portableKey(value) {
43
+ const key = Buffer.isBuffer(value) ? value : Buffer.from(value, 'base64');
44
+ if (key.length !== 32)
45
+ throw new BrowserError('INVALID_INPUT', 'Portable Browser auth key must be 32 bytes.');
46
+ return key;
47
+ }
48
+ //# sourceMappingURL=portable.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"portable.js","sourceRoot":"","sources":["../../../src/auth/portable.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAgB5C,MAAM,UAAU,mBAAmB,CACjC,MAAyB,EACzB,KAAc,EACd,QAAyB;IAEzB,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAA4B,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,EAAE;KACf,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,MAAM;QACN,UAAU,EAAE;YACV,SAAS,EAAE,aAAa;YACxB,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzB,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3C,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,QAAyB;IAEzB,IAAI,CAAC;QACH,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,KAAK,aAAa;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QACvG,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CACtC,aAAa,EACb,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,CAC9C,CAAC;QACF,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACtE,QAAQ,CAAC,KAAK,EAAE;SACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAoB,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QAC1F,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY;YAAE,MAAM,KAAK,CAAC;QAC/C,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,+DAA+D,CAAC,CAAC;IAC5G,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAsB;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1E,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,6CAA6C,CAAC,CAAC;IAC9G,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,29 @@
1
+ import type { BrowserRegistry } from '../ports.js';
2
+ import type { BrowserService } from '../service.js';
3
+ import type { BrowserAuthBundle, BrowserRuntimeContext } from '../types.js';
4
+ import { BrowserAuthVault } from './vault.js';
5
+ import { type PortableAuthResource } from './portable.js';
6
+ export declare class BrowserAuthService {
7
+ readonly browser: BrowserService;
8
+ readonly registry: BrowserRegistry;
9
+ readonly vault: BrowserAuthVault;
10
+ readonly now: () => Date;
11
+ constructor(browser: BrowserService, registry: BrowserRegistry, vault: BrowserAuthVault, now?: () => Date);
12
+ list(): BrowserAuthBundle[];
13
+ get(id: string): BrowserAuthBundle;
14
+ save(input: {
15
+ sessionId: string;
16
+ id?: string;
17
+ name: string;
18
+ domains?: string[];
19
+ context?: BrowserRuntimeContext;
20
+ }): Promise<BrowserAuthBundle>;
21
+ load(input: {
22
+ sessionId: string;
23
+ bundleId: string;
24
+ context?: BrowserRuntimeContext;
25
+ }): Promise<BrowserAuthBundle>;
26
+ delete(id: string): void;
27
+ exportEncrypted(id: string, key: Buffer | string, context?: BrowserRuntimeContext): Promise<PortableAuthResource>;
28
+ importEncrypted(resource: PortableAuthResource, key: Buffer | string, context?: BrowserRuntimeContext): Promise<BrowserAuthBundle>;
29
+ }