agent-web-interface 4.0.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 (395) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +226 -0
  3. package/dist/src/browser/ensure-browser.d.ts +39 -0
  4. package/dist/src/browser/ensure-browser.d.ts.map +1 -0
  5. package/dist/src/browser/ensure-browser.js +65 -0
  6. package/dist/src/browser/ensure-browser.js.map +1 -0
  7. package/dist/src/browser/index.d.ts +8 -0
  8. package/dist/src/browser/index.d.ts.map +1 -0
  9. package/dist/src/browser/index.js +8 -0
  10. package/dist/src/browser/index.js.map +1 -0
  11. package/dist/src/browser/page-network-tracker.d.ts +96 -0
  12. package/dist/src/browser/page-network-tracker.d.ts.map +1 -0
  13. package/dist/src/browser/page-network-tracker.js +235 -0
  14. package/dist/src/browser/page-network-tracker.js.map +1 -0
  15. package/dist/src/browser/page-registry.d.ts +137 -0
  16. package/dist/src/browser/page-registry.d.ts.map +1 -0
  17. package/dist/src/browser/page-registry.js +194 -0
  18. package/dist/src/browser/page-registry.js.map +1 -0
  19. package/dist/src/browser/page-stabilization.d.ts +35 -0
  20. package/dist/src/browser/page-stabilization.d.ts.map +1 -0
  21. package/dist/src/browser/page-stabilization.js +42 -0
  22. package/dist/src/browser/page-stabilization.js.map +1 -0
  23. package/dist/src/browser/session-manager.d.ts +336 -0
  24. package/dist/src/browser/session-manager.d.ts.map +1 -0
  25. package/dist/src/browser/session-manager.js +964 -0
  26. package/dist/src/browser/session-manager.js.map +1 -0
  27. package/dist/src/cdp/cdp-client.interface.d.ts +193 -0
  28. package/dist/src/cdp/cdp-client.interface.d.ts.map +1 -0
  29. package/dist/src/cdp/cdp-client.interface.js +9 -0
  30. package/dist/src/cdp/cdp-client.interface.js.map +1 -0
  31. package/dist/src/cdp/index.d.ts +9 -0
  32. package/dist/src/cdp/index.d.ts.map +1 -0
  33. package/dist/src/cdp/index.js +8 -0
  34. package/dist/src/cdp/index.js.map +1 -0
  35. package/dist/src/cdp/puppeteer-cdp-client.d.ts +97 -0
  36. package/dist/src/cdp/puppeteer-cdp-client.d.ts.map +1 -0
  37. package/dist/src/cdp/puppeteer-cdp-client.js +273 -0
  38. package/dist/src/cdp/puppeteer-cdp-client.js.map +1 -0
  39. package/dist/src/cli/args.d.ts +35 -0
  40. package/dist/src/cli/args.d.ts.map +1 -0
  41. package/dist/src/cli/args.js +76 -0
  42. package/dist/src/cli/args.js.map +1 -0
  43. package/dist/src/delta/dom-stabilizer.d.ts +46 -0
  44. package/dist/src/delta/dom-stabilizer.d.ts.map +1 -0
  45. package/dist/src/delta/dom-stabilizer.js +121 -0
  46. package/dist/src/delta/dom-stabilizer.js.map +1 -0
  47. package/dist/src/delta/index.d.ts +8 -0
  48. package/dist/src/delta/index.d.ts.map +1 -0
  49. package/dist/src/delta/index.js +7 -0
  50. package/dist/src/delta/index.js.map +1 -0
  51. package/dist/src/factpack/action-selector.d.ts +36 -0
  52. package/dist/src/factpack/action-selector.d.ts.map +1 -0
  53. package/dist/src/factpack/action-selector.js +367 -0
  54. package/dist/src/factpack/action-selector.js.map +1 -0
  55. package/dist/src/factpack/dialog-detector.d.ts +19 -0
  56. package/dist/src/factpack/dialog-detector.d.ts.map +1 -0
  57. package/dist/src/factpack/dialog-detector.js +354 -0
  58. package/dist/src/factpack/dialog-detector.js.map +1 -0
  59. package/dist/src/factpack/form-detector.d.ts +28 -0
  60. package/dist/src/factpack/form-detector.d.ts.map +1 -0
  61. package/dist/src/factpack/form-detector.js +555 -0
  62. package/dist/src/factpack/form-detector.js.map +1 -0
  63. package/dist/src/factpack/index.d.ts +32 -0
  64. package/dist/src/factpack/index.d.ts.map +1 -0
  65. package/dist/src/factpack/index.js +73 -0
  66. package/dist/src/factpack/index.js.map +1 -0
  67. package/dist/src/factpack/page-classifier.d.ts +22 -0
  68. package/dist/src/factpack/page-classifier.d.ts.map +1 -0
  69. package/dist/src/factpack/page-classifier.js +526 -0
  70. package/dist/src/factpack/page-classifier.js.map +1 -0
  71. package/dist/src/factpack/types.d.ts +307 -0
  72. package/dist/src/factpack/types.d.ts.map +1 -0
  73. package/dist/src/factpack/types.js +12 -0
  74. package/dist/src/factpack/types.js.map +1 -0
  75. package/dist/src/form/dependency-tracker.d.ts +108 -0
  76. package/dist/src/form/dependency-tracker.d.ts.map +1 -0
  77. package/dist/src/form/dependency-tracker.js +298 -0
  78. package/dist/src/form/dependency-tracker.js.map +1 -0
  79. package/dist/src/form/field-extractor.d.ts +32 -0
  80. package/dist/src/form/field-extractor.d.ts.map +1 -0
  81. package/dist/src/form/field-extractor.js +544 -0
  82. package/dist/src/form/field-extractor.js.map +1 -0
  83. package/dist/src/form/form-detector.d.ts +103 -0
  84. package/dist/src/form/form-detector.d.ts.map +1 -0
  85. package/dist/src/form/form-detector.js +704 -0
  86. package/dist/src/form/form-detector.js.map +1 -0
  87. package/dist/src/form/form-state.d.ts +23 -0
  88. package/dist/src/form/form-state.d.ts.map +1 -0
  89. package/dist/src/form/form-state.js +39 -0
  90. package/dist/src/form/form-state.js.map +1 -0
  91. package/dist/src/form/index.d.ts +23 -0
  92. package/dist/src/form/index.d.ts.map +1 -0
  93. package/dist/src/form/index.js +27 -0
  94. package/dist/src/form/index.js.map +1 -0
  95. package/dist/src/form/runtime-value-reader.d.ts +72 -0
  96. package/dist/src/form/runtime-value-reader.d.ts.map +1 -0
  97. package/dist/src/form/runtime-value-reader.js +232 -0
  98. package/dist/src/form/runtime-value-reader.js.map +1 -0
  99. package/dist/src/form/types.d.ts +384 -0
  100. package/dist/src/form/types.d.ts.map +1 -0
  101. package/dist/src/form/types.js +17 -0
  102. package/dist/src/form/types.js.map +1 -0
  103. package/dist/src/index.d.ts +8 -0
  104. package/dist/src/index.d.ts.map +1 -0
  105. package/dist/src/index.js +212 -0
  106. package/dist/src/index.js.map +1 -0
  107. package/dist/src/lib/constants.d.ts +27 -0
  108. package/dist/src/lib/constants.d.ts.map +1 -0
  109. package/dist/src/lib/constants.js +63 -0
  110. package/dist/src/lib/constants.js.map +1 -0
  111. package/dist/src/lib/index.d.ts +12 -0
  112. package/dist/src/lib/index.d.ts.map +1 -0
  113. package/dist/src/lib/index.js +17 -0
  114. package/dist/src/lib/index.js.map +1 -0
  115. package/dist/src/lib/regions.d.ts +29 -0
  116. package/dist/src/lib/regions.d.ts.map +1 -0
  117. package/dist/src/lib/regions.js +93 -0
  118. package/dist/src/lib/regions.js.map +1 -0
  119. package/dist/src/lib/scoring.d.ts +47 -0
  120. package/dist/src/lib/scoring.d.ts.map +1 -0
  121. package/dist/src/lib/scoring.js +79 -0
  122. package/dist/src/lib/scoring.js.map +1 -0
  123. package/dist/src/lib/selectors.d.ts +42 -0
  124. package/dist/src/lib/selectors.d.ts.map +1 -0
  125. package/dist/src/lib/selectors.js +138 -0
  126. package/dist/src/lib/selectors.js.map +1 -0
  127. package/dist/src/lib/text-utils.d.ts +155 -0
  128. package/dist/src/lib/text-utils.d.ts.map +1 -0
  129. package/dist/src/lib/text-utils.js +391 -0
  130. package/dist/src/lib/text-utils.js.map +1 -0
  131. package/dist/src/observation/eid-linker.d.ts +104 -0
  132. package/dist/src/observation/eid-linker.d.ts.map +1 -0
  133. package/dist/src/observation/eid-linker.js +403 -0
  134. package/dist/src/observation/eid-linker.js.map +1 -0
  135. package/dist/src/observation/index.d.ts +12 -0
  136. package/dist/src/observation/index.d.ts.map +1 -0
  137. package/dist/src/observation/index.js +15 -0
  138. package/dist/src/observation/index.js.map +1 -0
  139. package/dist/src/observation/observation-accumulator.d.ts +58 -0
  140. package/dist/src/observation/observation-accumulator.d.ts.map +1 -0
  141. package/dist/src/observation/observation-accumulator.js +213 -0
  142. package/dist/src/observation/observation-accumulator.js.map +1 -0
  143. package/dist/src/observation/observation.types.d.ts +139 -0
  144. package/dist/src/observation/observation.types.d.ts.map +1 -0
  145. package/dist/src/observation/observation.types.js +59 -0
  146. package/dist/src/observation/observation.types.js.map +1 -0
  147. package/dist/src/observation/observer-script.d.ts +19 -0
  148. package/dist/src/observation/observer-script.d.ts.map +1 -0
  149. package/dist/src/observation/observer-script.js +569 -0
  150. package/dist/src/observation/observer-script.js.map +1 -0
  151. package/dist/src/query/index.d.ts +9 -0
  152. package/dist/src/query/index.d.ts.map +1 -0
  153. package/dist/src/query/index.js +10 -0
  154. package/dist/src/query/index.js.map +1 -0
  155. package/dist/src/query/query-engine.d.ts +111 -0
  156. package/dist/src/query/query-engine.d.ts.map +1 -0
  157. package/dist/src/query/query-engine.js +509 -0
  158. package/dist/src/query/query-engine.js.map +1 -0
  159. package/dist/src/query/types/index.d.ts +5 -0
  160. package/dist/src/query/types/index.d.ts.map +1 -0
  161. package/dist/src/query/types/index.js +5 -0
  162. package/dist/src/query/types/index.js.map +1 -0
  163. package/dist/src/query/types/query.types.d.ts +141 -0
  164. package/dist/src/query/types/query.types.d.ts.map +1 -0
  165. package/dist/src/query/types/query.types.js +19 -0
  166. package/dist/src/query/types/query.types.js.map +1 -0
  167. package/dist/src/renderer/budget-manager.d.ts +46 -0
  168. package/dist/src/renderer/budget-manager.d.ts.map +1 -0
  169. package/dist/src/renderer/budget-manager.js +133 -0
  170. package/dist/src/renderer/budget-manager.js.map +1 -0
  171. package/dist/src/renderer/constants.d.ts +38 -0
  172. package/dist/src/renderer/constants.d.ts.map +1 -0
  173. package/dist/src/renderer/constants.js +29 -0
  174. package/dist/src/renderer/constants.js.map +1 -0
  175. package/dist/src/renderer/index.d.ts +12 -0
  176. package/dist/src/renderer/index.d.ts.map +1 -0
  177. package/dist/src/renderer/index.js +16 -0
  178. package/dist/src/renderer/index.js.map +1 -0
  179. package/dist/src/renderer/section-renderers.d.ts +42 -0
  180. package/dist/src/renderer/section-renderers.d.ts.map +1 -0
  181. package/dist/src/renderer/section-renderers.js +252 -0
  182. package/dist/src/renderer/section-renderers.js.map +1 -0
  183. package/dist/src/renderer/token-counter.d.ts +45 -0
  184. package/dist/src/renderer/token-counter.d.ts.map +1 -0
  185. package/dist/src/renderer/token-counter.js +65 -0
  186. package/dist/src/renderer/token-counter.js.map +1 -0
  187. package/dist/src/renderer/types.d.ts +71 -0
  188. package/dist/src/renderer/types.d.ts.map +1 -0
  189. package/dist/src/renderer/types.js +7 -0
  190. package/dist/src/renderer/types.js.map +1 -0
  191. package/dist/src/renderer/xml-renderer.d.ts +42 -0
  192. package/dist/src/renderer/xml-renderer.d.ts.map +1 -0
  193. package/dist/src/renderer/xml-renderer.js +103 -0
  194. package/dist/src/renderer/xml-renderer.js.map +1 -0
  195. package/dist/src/server/index.d.ts +8 -0
  196. package/dist/src/server/index.d.ts.map +1 -0
  197. package/dist/src/server/index.js +8 -0
  198. package/dist/src/server/index.js.map +1 -0
  199. package/dist/src/server/mcp-server.d.ts +59 -0
  200. package/dist/src/server/mcp-server.d.ts.map +1 -0
  201. package/dist/src/server/mcp-server.js +140 -0
  202. package/dist/src/server/mcp-server.js.map +1 -0
  203. package/dist/src/server/server-config.d.ts +41 -0
  204. package/dist/src/server/server-config.d.ts.map +1 -0
  205. package/dist/src/server/server-config.js +80 -0
  206. package/dist/src/server/server-config.js.map +1 -0
  207. package/dist/src/server/session-store.d.ts +148 -0
  208. package/dist/src/server/session-store.d.ts.map +1 -0
  209. package/dist/src/server/session-store.js +224 -0
  210. package/dist/src/server/session-store.js.map +1 -0
  211. package/dist/src/shared/errors/browser-session.error.d.ts +102 -0
  212. package/dist/src/shared/errors/browser-session.error.d.ts.map +1 -0
  213. package/dist/src/shared/errors/browser-session.error.js +153 -0
  214. package/dist/src/shared/errors/browser-session.error.js.map +1 -0
  215. package/dist/src/shared/errors/index.d.ts +5 -0
  216. package/dist/src/shared/errors/index.d.ts.map +1 -0
  217. package/dist/src/shared/errors/index.js +5 -0
  218. package/dist/src/shared/errors/index.js.map +1 -0
  219. package/dist/src/shared/services/dom-transformer.service.d.ts +71 -0
  220. package/dist/src/shared/services/dom-transformer.service.d.ts.map +1 -0
  221. package/dist/src/shared/services/dom-transformer.service.js +190 -0
  222. package/dist/src/shared/services/dom-transformer.service.js.map +1 -0
  223. package/dist/src/shared/services/index.d.ts +7 -0
  224. package/dist/src/shared/services/index.d.ts.map +1 -0
  225. package/dist/src/shared/services/index.js +7 -0
  226. package/dist/src/shared/services/index.js.map +1 -0
  227. package/dist/src/shared/services/logging.service.d.ts +154 -0
  228. package/dist/src/shared/services/logging.service.d.ts.map +1 -0
  229. package/dist/src/shared/services/logging.service.js +267 -0
  230. package/dist/src/shared/services/logging.service.js.map +1 -0
  231. package/dist/src/shared/services/selector-builder.service.d.ts +53 -0
  232. package/dist/src/shared/services/selector-builder.service.d.ts.map +1 -0
  233. package/dist/src/shared/services/selector-builder.service.js +240 -0
  234. package/dist/src/shared/services/selector-builder.service.js.map +1 -0
  235. package/dist/src/shared/types/base.types.d.ts +45 -0
  236. package/dist/src/shared/types/base.types.d.ts.map +1 -0
  237. package/dist/src/shared/types/base.types.js +8 -0
  238. package/dist/src/shared/types/base.types.js.map +1 -0
  239. package/dist/src/shared/types/index.d.ts +5 -0
  240. package/dist/src/shared/types/index.d.ts.map +1 -0
  241. package/dist/src/shared/types/index.js +5 -0
  242. package/dist/src/shared/types/index.js.map +1 -0
  243. package/dist/src/snapshot/element-resolver.d.ts +102 -0
  244. package/dist/src/snapshot/element-resolver.d.ts.map +1 -0
  245. package/dist/src/snapshot/element-resolver.js +379 -0
  246. package/dist/src/snapshot/element-resolver.js.map +1 -0
  247. package/dist/src/snapshot/extractors/attribute-extractor.d.ts +40 -0
  248. package/dist/src/snapshot/extractors/attribute-extractor.d.ts.map +1 -0
  249. package/dist/src/snapshot/extractors/attribute-extractor.js +237 -0
  250. package/dist/src/snapshot/extractors/attribute-extractor.js.map +1 -0
  251. package/dist/src/snapshot/extractors/ax-extractor.d.ts +36 -0
  252. package/dist/src/snapshot/extractors/ax-extractor.d.ts.map +1 -0
  253. package/dist/src/snapshot/extractors/ax-extractor.js +144 -0
  254. package/dist/src/snapshot/extractors/ax-extractor.js.map +1 -0
  255. package/dist/src/snapshot/extractors/dom-extractor.d.ts +21 -0
  256. package/dist/src/snapshot/extractors/dom-extractor.d.ts.map +1 -0
  257. package/dist/src/snapshot/extractors/dom-extractor.js +137 -0
  258. package/dist/src/snapshot/extractors/dom-extractor.js.map +1 -0
  259. package/dist/src/snapshot/extractors/grouping-resolver.d.ts +39 -0
  260. package/dist/src/snapshot/extractors/grouping-resolver.d.ts.map +1 -0
  261. package/dist/src/snapshot/extractors/grouping-resolver.js +260 -0
  262. package/dist/src/snapshot/extractors/grouping-resolver.js.map +1 -0
  263. package/dist/src/snapshot/extractors/index.d.ts +19 -0
  264. package/dist/src/snapshot/extractors/index.d.ts.map +1 -0
  265. package/dist/src/snapshot/extractors/index.js +27 -0
  266. package/dist/src/snapshot/extractors/index.js.map +1 -0
  267. package/dist/src/snapshot/extractors/label-resolver.d.ts +44 -0
  268. package/dist/src/snapshot/extractors/label-resolver.d.ts.map +1 -0
  269. package/dist/src/snapshot/extractors/label-resolver.js +173 -0
  270. package/dist/src/snapshot/extractors/label-resolver.js.map +1 -0
  271. package/dist/src/snapshot/extractors/layout-extractor.d.ts +52 -0
  272. package/dist/src/snapshot/extractors/layout-extractor.d.ts.map +1 -0
  273. package/dist/src/snapshot/extractors/layout-extractor.js +382 -0
  274. package/dist/src/snapshot/extractors/layout-extractor.js.map +1 -0
  275. package/dist/src/snapshot/extractors/locator-builder.d.ts +27 -0
  276. package/dist/src/snapshot/extractors/locator-builder.d.ts.map +1 -0
  277. package/dist/src/snapshot/extractors/locator-builder.js +223 -0
  278. package/dist/src/snapshot/extractors/locator-builder.js.map +1 -0
  279. package/dist/src/snapshot/extractors/region-resolver.d.ts +31 -0
  280. package/dist/src/snapshot/extractors/region-resolver.d.ts.map +1 -0
  281. package/dist/src/snapshot/extractors/region-resolver.js +168 -0
  282. package/dist/src/snapshot/extractors/region-resolver.js.map +1 -0
  283. package/dist/src/snapshot/extractors/state-extractor.d.ts +30 -0
  284. package/dist/src/snapshot/extractors/state-extractor.d.ts.map +1 -0
  285. package/dist/src/snapshot/extractors/state-extractor.js +181 -0
  286. package/dist/src/snapshot/extractors/state-extractor.js.map +1 -0
  287. package/dist/src/snapshot/extractors/types.d.ts +213 -0
  288. package/dist/src/snapshot/extractors/types.d.ts.map +1 -0
  289. package/dist/src/snapshot/extractors/types.js +145 -0
  290. package/dist/src/snapshot/extractors/types.js.map +1 -0
  291. package/dist/src/snapshot/index.d.ts +14 -0
  292. package/dist/src/snapshot/index.d.ts.map +1 -0
  293. package/dist/src/snapshot/index.js +18 -0
  294. package/dist/src/snapshot/index.js.map +1 -0
  295. package/dist/src/snapshot/snapshot-compiler.d.ts +73 -0
  296. package/dist/src/snapshot/snapshot-compiler.d.ts.map +1 -0
  297. package/dist/src/snapshot/snapshot-compiler.js +763 -0
  298. package/dist/src/snapshot/snapshot-compiler.js.map +1 -0
  299. package/dist/src/snapshot/snapshot-health.d.ts +97 -0
  300. package/dist/src/snapshot/snapshot-health.d.ts.map +1 -0
  301. package/dist/src/snapshot/snapshot-health.js +214 -0
  302. package/dist/src/snapshot/snapshot-health.js.map +1 -0
  303. package/dist/src/snapshot/snapshot-store.d.ts +137 -0
  304. package/dist/src/snapshot/snapshot-store.d.ts.map +1 -0
  305. package/dist/src/snapshot/snapshot-store.js +202 -0
  306. package/dist/src/snapshot/snapshot-store.js.map +1 -0
  307. package/dist/src/snapshot/snapshot.types.d.ts +250 -0
  308. package/dist/src/snapshot/snapshot.types.d.ts.map +1 -0
  309. package/dist/src/snapshot/snapshot.types.js +54 -0
  310. package/dist/src/snapshot/snapshot.types.js.map +1 -0
  311. package/dist/src/state/actionables-filter.d.ts +47 -0
  312. package/dist/src/state/actionables-filter.d.ts.map +1 -0
  313. package/dist/src/state/actionables-filter.js +173 -0
  314. package/dist/src/state/actionables-filter.js.map +1 -0
  315. package/dist/src/state/atoms-extractor.d.ts +23 -0
  316. package/dist/src/state/atoms-extractor.d.ts.map +1 -0
  317. package/dist/src/state/atoms-extractor.js +160 -0
  318. package/dist/src/state/atoms-extractor.js.map +1 -0
  319. package/dist/src/state/constants.d.ts +125 -0
  320. package/dist/src/state/constants.d.ts.map +1 -0
  321. package/dist/src/state/constants.js +131 -0
  322. package/dist/src/state/constants.js.map +1 -0
  323. package/dist/src/state/diff-engine.d.ts +23 -0
  324. package/dist/src/state/diff-engine.d.ts.map +1 -0
  325. package/dist/src/state/diff-engine.js +475 -0
  326. package/dist/src/state/diff-engine.js.map +1 -0
  327. package/dist/src/state/element-identity.d.ts +75 -0
  328. package/dist/src/state/element-identity.d.ts.map +1 -0
  329. package/dist/src/state/element-identity.js +129 -0
  330. package/dist/src/state/element-identity.js.map +1 -0
  331. package/dist/src/state/element-ref.types.d.ts +135 -0
  332. package/dist/src/state/element-ref.types.d.ts.map +1 -0
  333. package/dist/src/state/element-ref.types.js +13 -0
  334. package/dist/src/state/element-ref.types.js.map +1 -0
  335. package/dist/src/state/element-registry.d.ts +118 -0
  336. package/dist/src/state/element-registry.d.ts.map +1 -0
  337. package/dist/src/state/element-registry.js +222 -0
  338. package/dist/src/state/element-registry.js.map +1 -0
  339. package/dist/src/state/health.types.d.ts +93 -0
  340. package/dist/src/state/health.types.d.ts.map +1 -0
  341. package/dist/src/state/health.types.js +56 -0
  342. package/dist/src/state/health.types.js.map +1 -0
  343. package/dist/src/state/layer-detector.d.ts +23 -0
  344. package/dist/src/state/layer-detector.d.ts.map +1 -0
  345. package/dist/src/state/layer-detector.js +368 -0
  346. package/dist/src/state/layer-detector.js.map +1 -0
  347. package/dist/src/state/locator-generator.d.ts +21 -0
  348. package/dist/src/state/locator-generator.d.ts.map +1 -0
  349. package/dist/src/state/locator-generator.js +137 -0
  350. package/dist/src/state/locator-generator.js.map +1 -0
  351. package/dist/src/state/state-manager.d.ts +104 -0
  352. package/dist/src/state/state-manager.d.ts.map +1 -0
  353. package/dist/src/state/state-manager.js +618 -0
  354. package/dist/src/state/state-manager.js.map +1 -0
  355. package/dist/src/state/state-renderer.d.ts +63 -0
  356. package/dist/src/state/state-renderer.d.ts.map +1 -0
  357. package/dist/src/state/state-renderer.js +340 -0
  358. package/dist/src/state/state-renderer.js.map +1 -0
  359. package/dist/src/state/types.d.ts +353 -0
  360. package/dist/src/state/types.d.ts.map +1 -0
  361. package/dist/src/state/types.js +8 -0
  362. package/dist/src/state/types.js.map +1 -0
  363. package/dist/src/tools/browser-tools.d.ts +140 -0
  364. package/dist/src/tools/browser-tools.d.ts.map +1 -0
  365. package/dist/src/tools/browser-tools.js +657 -0
  366. package/dist/src/tools/browser-tools.js.map +1 -0
  367. package/dist/src/tools/errors.d.ts +63 -0
  368. package/dist/src/tools/errors.d.ts.map +1 -0
  369. package/dist/src/tools/errors.js +86 -0
  370. package/dist/src/tools/errors.js.map +1 -0
  371. package/dist/src/tools/execute-action.d.ts +135 -0
  372. package/dist/src/tools/execute-action.d.ts.map +1 -0
  373. package/dist/src/tools/execute-action.js +579 -0
  374. package/dist/src/tools/execute-action.js.map +1 -0
  375. package/dist/src/tools/form-tools.d.ts +109 -0
  376. package/dist/src/tools/form-tools.d.ts.map +1 -0
  377. package/dist/src/tools/form-tools.js +434 -0
  378. package/dist/src/tools/form-tools.js.map +1 -0
  379. package/dist/src/tools/index.d.ts +11 -0
  380. package/dist/src/tools/index.d.ts.map +1 -0
  381. package/dist/src/tools/index.js +49 -0
  382. package/dist/src/tools/index.js.map +1 -0
  383. package/dist/src/tools/response-builder.d.ts +98 -0
  384. package/dist/src/tools/response-builder.d.ts.map +1 -0
  385. package/dist/src/tools/response-builder.js +219 -0
  386. package/dist/src/tools/response-builder.js.map +1 -0
  387. package/dist/src/tools/tool-schemas.d.ts +2482 -0
  388. package/dist/src/tools/tool-schemas.d.ts.map +1 -0
  389. package/dist/src/tools/tool-schemas.js +606 -0
  390. package/dist/src/tools/tool-schemas.js.map +1 -0
  391. package/dist/vitest.config.d.ts +3 -0
  392. package/dist/vitest.config.d.ts.map +1 -0
  393. package/dist/vitest.config.js +16 -0
  394. package/dist/vitest.config.js.map +1 -0
  395. package/package.json +76 -0
@@ -0,0 +1,555 @@
1
+ /**
2
+ * Form Detector
3
+ *
4
+ * Detects forms and extracts field information from a BaseSnapshot.
5
+ *
6
+ * Design: Generic First, Specific Second
7
+ * 1. Detect ALL forms with their fields (always works)
8
+ * 2. Infer field semantics (may return 'unknown')
9
+ * 3. Infer form purpose (may return 'generic')
10
+ */
11
+ import { QueryEngine } from '../query/query-engine.js';
12
+ import { normalizeText } from '../lib/text-utils.js';
13
+ // ============================================================================
14
+ // Field Semantic Type Mappings
15
+ // ============================================================================
16
+ /** Autocomplete attribute to semantic type mapping */
17
+ const AUTOCOMPLETE_TO_SEMANTIC = {
18
+ username: 'username',
19
+ email: 'email',
20
+ 'current-password': 'password',
21
+ 'new-password': 'password',
22
+ password: 'password',
23
+ tel: 'phone',
24
+ 'tel-national': 'phone',
25
+ 'given-name': 'first-name',
26
+ 'family-name': 'last-name',
27
+ name: 'full-name',
28
+ 'street-address': 'address-line1',
29
+ 'address-line1': 'address-line1',
30
+ 'address-line2': 'address-line2',
31
+ 'address-level2': 'city',
32
+ 'address-level1': 'state',
33
+ 'postal-code': 'postal-code',
34
+ country: 'country',
35
+ 'country-name': 'country',
36
+ 'cc-number': 'card-number',
37
+ 'cc-exp': 'card-expiry',
38
+ 'cc-exp-month': 'card-expiry',
39
+ 'cc-exp-year': 'card-expiry',
40
+ 'cc-csc': 'card-cvv',
41
+ search: 'search-query',
42
+ };
43
+ /** Input type to semantic type mapping */
44
+ const INPUT_TYPE_TO_SEMANTIC = {
45
+ email: 'email',
46
+ password: 'password',
47
+ tel: 'phone',
48
+ search: 'search-query',
49
+ url: 'url',
50
+ date: 'date',
51
+ number: 'number',
52
+ };
53
+ /** Patterns for inferring semantic type from name/label */
54
+ const SEMANTIC_PATTERNS = [
55
+ { type: 'email', patterns: [/\bemail/i, /\be-mail/i] },
56
+ {
57
+ type: 'password',
58
+ patterns: [/\bpassword/i, /\bpasswd/i, /\bpwd\b/i, /\bsecret/i],
59
+ },
60
+ {
61
+ type: 'password-confirm',
62
+ patterns: [/\bconfirm.?pass/i, /\bpass.?confirm/i, /\brepeat.?pass/i, /\bretype.?pass/i],
63
+ },
64
+ {
65
+ type: 'username',
66
+ patterns: [/\busername/i, /\buser.?name/i, /\blogin/i, /\buser.?id/i],
67
+ },
68
+ { type: 'phone', patterns: [/\bphone/i, /\btel\b/i, /\bmobile/i, /\bcell/i] },
69
+ {
70
+ type: 'first-name',
71
+ patterns: [/\bfirst.?name/i, /\bgiven.?name/i, /\bfname\b/i],
72
+ },
73
+ {
74
+ type: 'last-name',
75
+ patterns: [/\blast.?name/i, /\bfamily.?name/i, /\bsurname/i, /\blname\b/i],
76
+ },
77
+ { type: 'full-name', patterns: [/\bfull.?name/i, /\bname\b/i] },
78
+ {
79
+ type: 'address-line1',
80
+ patterns: [/\baddress.?1/i, /\bstreet/i, /\baddress\b/i],
81
+ },
82
+ { type: 'address-line2', patterns: [/\baddress.?2/i, /\bapt/i, /\bsuite/i] },
83
+ { type: 'city', patterns: [/\bcity/i, /\btown/i, /\blocality/i] },
84
+ { type: 'state', patterns: [/\bstate/i, /\bprovince/i, /\bregion/i] },
85
+ {
86
+ type: 'postal-code',
87
+ patterns: [/\bzip/i, /\bpostal/i, /\bpost.?code/i],
88
+ },
89
+ { type: 'country', patterns: [/\bcountry/i] },
90
+ {
91
+ type: 'card-number',
92
+ patterns: [/\bcard.?num/i, /\bcredit.?card/i, /\bcc.?num/i],
93
+ },
94
+ {
95
+ type: 'card-expiry',
96
+ patterns: [/\bexpir/i, /\bexp.?date/i, /\bexp.?month/i, /\bexp.?year/i],
97
+ },
98
+ { type: 'card-cvv', patterns: [/\bcvv/i, /\bcvc/i, /\bcsc/i, /\bsecurity.?code/i] },
99
+ { type: 'search-query', patterns: [/\bsearch/i, /\bquery/i, /\bq\b/i] },
100
+ { type: 'message', patterns: [/\bmessage/i, /\bcomment/i, /\bdescription/i] },
101
+ ];
102
+ /** Patterns for submit button labels */
103
+ const SUBMIT_BUTTON_PATTERNS = [
104
+ /\bsubmit/i,
105
+ /\bsend/i,
106
+ /\bsign.?up/i,
107
+ /\bsign.?in/i,
108
+ /\blog.?in/i,
109
+ /\bregister/i,
110
+ /\bcreate/i,
111
+ /\bcontinue/i,
112
+ /\bsave/i,
113
+ /\bsearch/i,
114
+ /\bsubscribe/i,
115
+ /\bjoin/i,
116
+ /\bcheckout/i,
117
+ /\bplace.?order/i,
118
+ /\bpay/i,
119
+ /\bbuy/i,
120
+ /\badd.?to.?cart/i,
121
+ /\bconfirm/i,
122
+ /\bapply/i,
123
+ /\bgo\b/i,
124
+ /\bnext/i,
125
+ /\bdone/i,
126
+ ];
127
+ // ============================================================================
128
+ // Helper Functions
129
+ // ============================================================================
130
+ /**
131
+ * Infer semantic type from field attributes and label.
132
+ * Returns 'unknown' with low confidence if no inference possible.
133
+ */
134
+ function inferFieldSemanticType(node) {
135
+ // Priority 1: autocomplete attribute (highest confidence)
136
+ if (node.attributes?.autocomplete) {
137
+ const autocomplete = node.attributes.autocomplete.toLowerCase();
138
+ // Handle compound values like "shipping address-line1"
139
+ for (const [key, type] of Object.entries(AUTOCOMPLETE_TO_SEMANTIC)) {
140
+ if (autocomplete.includes(key)) {
141
+ return { type, confidence: 0.95 };
142
+ }
143
+ }
144
+ }
145
+ // Priority 2: input type (high confidence)
146
+ const inputType = node.attributes?.input_type?.toLowerCase() ?? '';
147
+ if (inputType && INPUT_TYPE_TO_SEMANTIC[inputType]) {
148
+ return { type: INPUT_TYPE_TO_SEMANTIC[inputType], confidence: 0.85 };
149
+ }
150
+ // Priority 3: name/label patterns
151
+ const textToMatch = [
152
+ node.label,
153
+ node.attributes?.placeholder,
154
+ // Note: We don't have direct access to name attr in ReadableNode,
155
+ // but test_id might contain it
156
+ node.attributes?.test_id,
157
+ ]
158
+ .filter(Boolean)
159
+ .join(' ');
160
+ const normalized = normalizeText(textToMatch);
161
+ for (const { type, patterns } of SEMANTIC_PATTERNS) {
162
+ for (const pattern of patterns) {
163
+ if (pattern.test(normalized)) {
164
+ return { type, confidence: 0.7 };
165
+ }
166
+ }
167
+ }
168
+ // No match - return unknown
169
+ return { type: 'unknown', confidence: 0.2 };
170
+ }
171
+ /**
172
+ * Check if a node looks like a submit button.
173
+ */
174
+ function isSubmitButton(node) {
175
+ // Check kind
176
+ if (node.kind !== 'button') {
177
+ return false;
178
+ }
179
+ // Check label patterns
180
+ const label = normalizeText(node.label);
181
+ if (SUBMIT_BUTTON_PATTERNS.some((p) => p.test(label))) {
182
+ return true;
183
+ }
184
+ // Check input type
185
+ if (node.attributes?.input_type === 'submit') {
186
+ return true;
187
+ }
188
+ return false;
189
+ }
190
+ /**
191
+ * Extract FormField from a ReadableNode.
192
+ */
193
+ function nodeToFormField(node) {
194
+ const semantic = inferFieldSemanticType(node);
195
+ return {
196
+ node_id: node.node_id,
197
+ backend_node_id: node.backend_node_id,
198
+ kind: node.kind,
199
+ label: node.label,
200
+ input_type: node.attributes?.input_type ?? 'text',
201
+ required: node.state?.required ?? false,
202
+ invalid: node.state?.invalid ?? false,
203
+ disabled: !(node.state?.enabled ?? true),
204
+ readonly: node.state?.readonly ?? false,
205
+ has_value: Boolean(node.attributes?.value),
206
+ placeholder: node.attributes?.placeholder,
207
+ autocomplete: node.attributes?.autocomplete,
208
+ semantic_type: semantic.type,
209
+ semantic_confidence: semantic.confidence,
210
+ };
211
+ }
212
+ /**
213
+ * Infer form purpose from field patterns.
214
+ * Returns 'generic' with low confidence if no pattern matches.
215
+ */
216
+ function inferFormPurpose(fields) {
217
+ const signals = [];
218
+ const semanticTypes = new Set(fields.map((f) => f.semantic_type));
219
+ // Check for specific patterns
220
+ // Search form: single search field
221
+ if (fields.length === 1 &&
222
+ (semanticTypes.has('search-query') || fields[0].input_type === 'search')) {
223
+ return { purpose: 'search', confidence: 0.9, signals: ['single-search-field'] };
224
+ }
225
+ // Login: email/username + password, no password-confirm
226
+ if ((semanticTypes.has('email') || semanticTypes.has('username')) &&
227
+ semanticTypes.has('password') &&
228
+ !semanticTypes.has('password-confirm')) {
229
+ return {
230
+ purpose: 'login',
231
+ confidence: 0.85,
232
+ signals: ['email-or-username', 'password', 'no-confirm'],
233
+ };
234
+ }
235
+ // Signup: email + password + password-confirm
236
+ if (semanticTypes.has('email') &&
237
+ semanticTypes.has('password') &&
238
+ semanticTypes.has('password-confirm')) {
239
+ return {
240
+ purpose: 'signup',
241
+ confidence: 0.85,
242
+ signals: ['email', 'password', 'password-confirm'],
243
+ };
244
+ }
245
+ // Signup variant: email + password + name fields
246
+ if (semanticTypes.has('email') &&
247
+ semanticTypes.has('password') &&
248
+ (semanticTypes.has('first-name') ||
249
+ semanticTypes.has('last-name') ||
250
+ semanticTypes.has('full-name'))) {
251
+ return {
252
+ purpose: 'signup',
253
+ confidence: 0.8,
254
+ signals: ['email', 'password', 'name-fields'],
255
+ };
256
+ }
257
+ // Checkout: card fields
258
+ if (semanticTypes.has('card-number') ||
259
+ (semanticTypes.has('card-expiry') && semanticTypes.has('card-cvv'))) {
260
+ return {
261
+ purpose: 'checkout',
262
+ confidence: 0.9,
263
+ signals: ['card-fields'],
264
+ };
265
+ }
266
+ // Shipping/Billing: address fields
267
+ if (semanticTypes.has('address-line1') ||
268
+ (semanticTypes.has('city') && semanticTypes.has('postal-code'))) {
269
+ // Try to distinguish shipping from billing by looking for card fields nearby
270
+ if (semanticTypes.has('card-number')) {
271
+ return { purpose: 'billing', confidence: 0.7, signals: ['address-with-card'] };
272
+ }
273
+ return { purpose: 'shipping', confidence: 0.7, signals: ['address-fields'] };
274
+ }
275
+ // Newsletter: email only (or email with name)
276
+ if (semanticTypes.has('email') && !semanticTypes.has('password') && fields.length <= 3) {
277
+ return { purpose: 'newsletter', confidence: 0.75, signals: ['email-only', 'few-fields'] };
278
+ }
279
+ // Contact: name + email + message
280
+ if (semanticTypes.has('email') &&
281
+ semanticTypes.has('message') &&
282
+ (semanticTypes.has('full-name') ||
283
+ semanticTypes.has('first-name') ||
284
+ semanticTypes.has('last-name'))) {
285
+ return { purpose: 'contact', confidence: 0.75, signals: ['name', 'email', 'message'] };
286
+ }
287
+ // Password reset: password + password-confirm, no email/username
288
+ if (semanticTypes.has('password') &&
289
+ semanticTypes.has('password-confirm') &&
290
+ !semanticTypes.has('email') &&
291
+ !semanticTypes.has('username')) {
292
+ return {
293
+ purpose: 'password-reset',
294
+ confidence: 0.7,
295
+ signals: ['password', 'confirm', 'no-email'],
296
+ };
297
+ }
298
+ // Profile: has name/email/phone but no password
299
+ if (!semanticTypes.has('password') &&
300
+ (semanticTypes.has('email') || semanticTypes.has('phone') || semanticTypes.has('first-name'))) {
301
+ return {
302
+ purpose: 'profile',
303
+ confidence: 0.5,
304
+ signals: ['no-password', 'personal-fields'],
305
+ };
306
+ }
307
+ // Generic fallback
308
+ signals.push('no-pattern-match');
309
+ return { purpose: 'generic', confidence: 0.3, signals };
310
+ }
311
+ /**
312
+ * Calculate form validation state.
313
+ */
314
+ function calculateValidation(fields, submitButton) {
315
+ const errorCount = fields.filter((f) => f.invalid).length;
316
+ const requiredUnfilled = fields.filter((f) => f.required && !f.has_value).length;
317
+ const hasErrors = errorCount > 0;
318
+ const readyToSubmit = !hasErrors &&
319
+ requiredUnfilled === 0 &&
320
+ (submitButton?.enabled ?? true) &&
321
+ (submitButton?.visible ?? true);
322
+ return {
323
+ has_errors: hasErrors,
324
+ error_count: errorCount,
325
+ required_unfilled: requiredUnfilled,
326
+ ready_to_submit: readyToSubmit,
327
+ };
328
+ }
329
+ /**
330
+ * Find form fields belonging to a form.
331
+ * Uses group_id matching or proximity heuristics.
332
+ */
333
+ function findFormFields(formNode, engine, includeDisabled) {
334
+ const inputKinds = ['input', 'textarea', 'select', 'combobox', 'checkbox', 'radio'];
335
+ const fields = [];
336
+ const seenIds = new Set();
337
+ // Method 1: Find by group_id
338
+ if (formNode.where.group_id) {
339
+ for (const kind of inputKinds) {
340
+ const matches = engine.find({
341
+ kind,
342
+ group_id: formNode.where.group_id,
343
+ limit: 50,
344
+ });
345
+ for (const match of matches.matches) {
346
+ if (seenIds.has(match.node.node_id))
347
+ continue;
348
+ if (!includeDisabled && !(match.node.state?.enabled ?? true))
349
+ continue;
350
+ seenIds.add(match.node.node_id);
351
+ fields.push(nodeToFormField(match.node));
352
+ }
353
+ }
354
+ }
355
+ // Method 2: Find by heading_context if few results
356
+ if (fields.length < 2 && formNode.where.heading_context) {
357
+ for (const kind of inputKinds) {
358
+ const matches = engine.find({
359
+ kind,
360
+ heading_context: formNode.where.heading_context,
361
+ limit: 50,
362
+ });
363
+ for (const match of matches.matches) {
364
+ if (seenIds.has(match.node.node_id))
365
+ continue;
366
+ if (!includeDisabled && !(match.node.state?.enabled ?? true))
367
+ continue;
368
+ seenIds.add(match.node.node_id);
369
+ fields.push(nodeToFormField(match.node));
370
+ }
371
+ }
372
+ }
373
+ return fields;
374
+ }
375
+ /**
376
+ * Find submit button for a form.
377
+ */
378
+ function findSubmitButton(formNode, engine) {
379
+ // Look for buttons in the same group
380
+ const buttons = engine.find({
381
+ kind: 'button',
382
+ group_id: formNode.where.group_id,
383
+ state: { visible: true },
384
+ limit: 10,
385
+ });
386
+ for (const match of buttons.matches) {
387
+ if (isSubmitButton(match.node)) {
388
+ return {
389
+ node_id: match.node.node_id,
390
+ backend_node_id: match.node.backend_node_id,
391
+ label: match.node.label,
392
+ enabled: match.node.state?.enabled ?? true,
393
+ visible: match.node.state?.visible ?? true,
394
+ };
395
+ }
396
+ }
397
+ // Fallback: look for any visible button with submit-like label
398
+ const allButtons = engine.find({
399
+ kind: 'button',
400
+ state: { visible: true },
401
+ limit: 20,
402
+ });
403
+ for (const match of allButtons.matches) {
404
+ if (isSubmitButton(match.node)) {
405
+ return {
406
+ node_id: match.node.node_id,
407
+ backend_node_id: match.node.backend_node_id,
408
+ label: match.node.label,
409
+ enabled: match.node.state?.enabled ?? true,
410
+ visible: match.node.state?.visible ?? true,
411
+ };
412
+ }
413
+ }
414
+ return undefined;
415
+ }
416
+ /**
417
+ * Calculate form prominence score for primary form selection.
418
+ */
419
+ function calculateFormProminence(form) {
420
+ let score = 0;
421
+ // More fields = more prominent
422
+ score += Math.min(form.fields.length * 0.1, 0.5);
423
+ // Has submit button
424
+ if (form.submit_button) {
425
+ score += 0.2;
426
+ }
427
+ // Has title/heading
428
+ if (form.title) {
429
+ score += 0.1;
430
+ }
431
+ // Purpose is classified (not generic)
432
+ if (form.purpose !== 'generic') {
433
+ score += 0.2;
434
+ }
435
+ return score;
436
+ }
437
+ /**
438
+ * Detect forms in a BaseSnapshot.
439
+ *
440
+ * @param snapshot - The snapshot to analyze
441
+ * @param options - Detection options
442
+ * @returns Detection result with all forms and metadata
443
+ */
444
+ export function detectForms(snapshot, options = {}) {
445
+ const startTime = performance.now();
446
+ const engine = new QueryEngine(snapshot);
447
+ const includeDisabled = options.include_disabled_fields ?? true;
448
+ // Step 1: Find all form containers (by AX role)
449
+ const formNodes = engine.find({
450
+ kind: 'form',
451
+ limit: 50,
452
+ });
453
+ // Step 2: Extract form information
454
+ const forms = [];
455
+ for (const match of formNodes.matches) {
456
+ const formNode = match.node;
457
+ const title = formNode.where.heading_context ?? formNode.label ?? undefined;
458
+ const fields = findFormFields(formNode, engine, includeDisabled);
459
+ const submitButton = findSubmitButton(formNode, engine);
460
+ const validation = calculateValidation(fields, submitButton);
461
+ const purposeInfo = inferFormPurpose(fields);
462
+ forms.push({
463
+ node_id: formNode.node_id,
464
+ backend_node_id: formNode.backend_node_id,
465
+ title,
466
+ action: formNode.attributes?.action,
467
+ method: formNode.attributes?.method,
468
+ fields,
469
+ submit_button: submitButton,
470
+ validation,
471
+ purpose: purposeInfo.purpose,
472
+ purpose_confidence: purposeInfo.confidence,
473
+ purpose_signals: purposeInfo.signals,
474
+ });
475
+ }
476
+ // Step 2b: Fallback - detect forms by region when no form nodes found
477
+ // Many forms (like GitHub's login) don't have an accessible name,
478
+ // so they don't get the "form" AX role. We can detect them by finding
479
+ // form fields in the "form" region.
480
+ if (forms.length === 0) {
481
+ const regionBasedForm = detectFormByRegion(snapshot, engine, includeDisabled);
482
+ if (regionBasedForm) {
483
+ forms.push(regionBasedForm);
484
+ }
485
+ }
486
+ // Step 3: Select primary form (most prominent)
487
+ let primaryForm;
488
+ if (forms.length > 0) {
489
+ const sortedForms = [...forms].sort((a, b) => calculateFormProminence(b) - calculateFormProminence(a));
490
+ primaryForm = sortedForms[0];
491
+ }
492
+ const detectionTimeMs = performance.now() - startTime;
493
+ return {
494
+ forms,
495
+ primary_form: primaryForm,
496
+ meta: {
497
+ total_detected: forms.length,
498
+ classified_count: forms.filter((f) => f.purpose !== 'generic').length,
499
+ detection_time_ms: detectionTimeMs,
500
+ },
501
+ };
502
+ }
503
+ /**
504
+ * Detect a form by looking for form fields in the "form" region.
505
+ * This is a fallback for forms that don't have an accessible name
506
+ * and thus don't expose the "form" AX role.
507
+ */
508
+ function detectFormByRegion(snapshot, _engine, includeDisabled) {
509
+ // Find all nodes in the "form" region
510
+ const formRegionNodes = snapshot.nodes.filter((n) => n.where.region === 'form');
511
+ if (formRegionNodes.length === 0) {
512
+ return null;
513
+ }
514
+ // Find form fields (inputs, textboxes, checkboxes, etc.)
515
+ const fieldKinds = ['input', 'combobox', 'checkbox', 'switch', 'radio', 'textarea'];
516
+ const fieldNodes = formRegionNodes.filter((n) => fieldKinds.includes(n.kind) && (includeDisabled || n.state?.enabled !== false));
517
+ if (fieldNodes.length === 0) {
518
+ return null;
519
+ }
520
+ // Find submit button in the form region
521
+ const submitNode = formRegionNodes.find((n) => n.kind === 'button' &&
522
+ n.state?.enabled !== false &&
523
+ (n.attributes?.input_type === 'submit' ||
524
+ /^(sign\s*in|log\s*in|submit|send|continue|register|create|save)/i.test(n.label)));
525
+ // Build fields array using the nodeToFormField helper
526
+ const fields = fieldNodes.map((node) => nodeToFormField(node));
527
+ // Build submit button
528
+ const submitButton = submitNode
529
+ ? {
530
+ node_id: submitNode.node_id,
531
+ backend_node_id: submitNode.backend_node_id,
532
+ label: submitNode.label,
533
+ enabled: submitNode.state?.enabled ?? true,
534
+ visible: submitNode.state?.visible ?? true,
535
+ }
536
+ : undefined;
537
+ const validation = calculateValidation(fields, submitButton);
538
+ const purposeInfo = inferFormPurpose(fields);
539
+ // Get heading context from the first field if available
540
+ const title = fieldNodes[0]?.where.heading_context;
541
+ // Use the first field's node_id as the form's node_id (synthetic form)
542
+ const firstField = fieldNodes[0];
543
+ return {
544
+ node_id: `form-region-${firstField.node_id}`,
545
+ backend_node_id: firstField.backend_node_id,
546
+ title,
547
+ fields,
548
+ submit_button: submitButton,
549
+ validation,
550
+ purpose: purposeInfo.purpose,
551
+ purpose_confidence: purposeInfo.confidence,
552
+ purpose_signals: purposeInfo.signals,
553
+ };
554
+ }
555
+ //# sourceMappingURL=form-detector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"form-detector.js","sourceRoot":"","sources":["../../../src/factpack/form-detector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * FactPack Module
3
+ *
4
+ * Extracts higher-level semantic facts from compiled BaseSnapshot.
5
+ *
6
+ * Design: Generic First, Specific Second
7
+ * - All extractors return useful data even when specific patterns aren't matched
8
+ * - 'unknown'/'generic' are valid results, not failures
9
+ * - Confidence scores allow consumers to decide thresholds
10
+ */
11
+ import type { BaseSnapshot } from '../snapshot/snapshot.types.js';
12
+ import type { FactPack, FactPackOptions } from './types.js';
13
+ /**
14
+ * Extract a complete FactPack from a BaseSnapshot.
15
+ *
16
+ * Executes all extractors and combines results:
17
+ * 1. Dialog detection (independent)
18
+ * 2. Form detection (may use dialog context)
19
+ * 3. Page classification (uses form results)
20
+ * 4. Action selection (uses all context)
21
+ *
22
+ * @param snapshot - The compiled snapshot to analyze
23
+ * @param options - Extraction options
24
+ * @returns Complete FactPack with all extracted facts
25
+ */
26
+ export declare function extractFactPack(snapshot: BaseSnapshot, options?: FactPackOptions): FactPack;
27
+ export * from './types.js';
28
+ export { detectDialogs } from './dialog-detector.js';
29
+ export { detectForms, type FormDetectionOptions } from './form-detector.js';
30
+ export { classifyPage } from './page-classifier.js';
31
+ export { selectKeyActions, type ActionSelectionOptions } from './action-selector.js';
32
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/factpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAKlE,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAqC/F;AAOD,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}