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.
- package/LICENSE +21 -0
- package/README.md +226 -0
- package/dist/src/browser/ensure-browser.d.ts +39 -0
- package/dist/src/browser/ensure-browser.d.ts.map +1 -0
- package/dist/src/browser/ensure-browser.js +65 -0
- package/dist/src/browser/ensure-browser.js.map +1 -0
- package/dist/src/browser/index.d.ts +8 -0
- package/dist/src/browser/index.d.ts.map +1 -0
- package/dist/src/browser/index.js +8 -0
- package/dist/src/browser/index.js.map +1 -0
- package/dist/src/browser/page-network-tracker.d.ts +96 -0
- package/dist/src/browser/page-network-tracker.d.ts.map +1 -0
- package/dist/src/browser/page-network-tracker.js +235 -0
- package/dist/src/browser/page-network-tracker.js.map +1 -0
- package/dist/src/browser/page-registry.d.ts +137 -0
- package/dist/src/browser/page-registry.d.ts.map +1 -0
- package/dist/src/browser/page-registry.js +194 -0
- package/dist/src/browser/page-registry.js.map +1 -0
- package/dist/src/browser/page-stabilization.d.ts +35 -0
- package/dist/src/browser/page-stabilization.d.ts.map +1 -0
- package/dist/src/browser/page-stabilization.js +42 -0
- package/dist/src/browser/page-stabilization.js.map +1 -0
- package/dist/src/browser/session-manager.d.ts +336 -0
- package/dist/src/browser/session-manager.d.ts.map +1 -0
- package/dist/src/browser/session-manager.js +964 -0
- package/dist/src/browser/session-manager.js.map +1 -0
- package/dist/src/cdp/cdp-client.interface.d.ts +193 -0
- package/dist/src/cdp/cdp-client.interface.d.ts.map +1 -0
- package/dist/src/cdp/cdp-client.interface.js +9 -0
- package/dist/src/cdp/cdp-client.interface.js.map +1 -0
- package/dist/src/cdp/index.d.ts +9 -0
- package/dist/src/cdp/index.d.ts.map +1 -0
- package/dist/src/cdp/index.js +8 -0
- package/dist/src/cdp/index.js.map +1 -0
- package/dist/src/cdp/puppeteer-cdp-client.d.ts +97 -0
- package/dist/src/cdp/puppeteer-cdp-client.d.ts.map +1 -0
- package/dist/src/cdp/puppeteer-cdp-client.js +273 -0
- package/dist/src/cdp/puppeteer-cdp-client.js.map +1 -0
- package/dist/src/cli/args.d.ts +35 -0
- package/dist/src/cli/args.d.ts.map +1 -0
- package/dist/src/cli/args.js +76 -0
- package/dist/src/cli/args.js.map +1 -0
- package/dist/src/delta/dom-stabilizer.d.ts +46 -0
- package/dist/src/delta/dom-stabilizer.d.ts.map +1 -0
- package/dist/src/delta/dom-stabilizer.js +121 -0
- package/dist/src/delta/dom-stabilizer.js.map +1 -0
- package/dist/src/delta/index.d.ts +8 -0
- package/dist/src/delta/index.d.ts.map +1 -0
- package/dist/src/delta/index.js +7 -0
- package/dist/src/delta/index.js.map +1 -0
- package/dist/src/factpack/action-selector.d.ts +36 -0
- package/dist/src/factpack/action-selector.d.ts.map +1 -0
- package/dist/src/factpack/action-selector.js +367 -0
- package/dist/src/factpack/action-selector.js.map +1 -0
- package/dist/src/factpack/dialog-detector.d.ts +19 -0
- package/dist/src/factpack/dialog-detector.d.ts.map +1 -0
- package/dist/src/factpack/dialog-detector.js +354 -0
- package/dist/src/factpack/dialog-detector.js.map +1 -0
- package/dist/src/factpack/form-detector.d.ts +28 -0
- package/dist/src/factpack/form-detector.d.ts.map +1 -0
- package/dist/src/factpack/form-detector.js +555 -0
- package/dist/src/factpack/form-detector.js.map +1 -0
- package/dist/src/factpack/index.d.ts +32 -0
- package/dist/src/factpack/index.d.ts.map +1 -0
- package/dist/src/factpack/index.js +73 -0
- package/dist/src/factpack/index.js.map +1 -0
- package/dist/src/factpack/page-classifier.d.ts +22 -0
- package/dist/src/factpack/page-classifier.d.ts.map +1 -0
- package/dist/src/factpack/page-classifier.js +526 -0
- package/dist/src/factpack/page-classifier.js.map +1 -0
- package/dist/src/factpack/types.d.ts +307 -0
- package/dist/src/factpack/types.d.ts.map +1 -0
- package/dist/src/factpack/types.js +12 -0
- package/dist/src/factpack/types.js.map +1 -0
- package/dist/src/form/dependency-tracker.d.ts +108 -0
- package/dist/src/form/dependency-tracker.d.ts.map +1 -0
- package/dist/src/form/dependency-tracker.js +298 -0
- package/dist/src/form/dependency-tracker.js.map +1 -0
- package/dist/src/form/field-extractor.d.ts +32 -0
- package/dist/src/form/field-extractor.d.ts.map +1 -0
- package/dist/src/form/field-extractor.js +544 -0
- package/dist/src/form/field-extractor.js.map +1 -0
- package/dist/src/form/form-detector.d.ts +103 -0
- package/dist/src/form/form-detector.d.ts.map +1 -0
- package/dist/src/form/form-detector.js +704 -0
- package/dist/src/form/form-detector.js.map +1 -0
- package/dist/src/form/form-state.d.ts +23 -0
- package/dist/src/form/form-state.d.ts.map +1 -0
- package/dist/src/form/form-state.js +39 -0
- package/dist/src/form/form-state.js.map +1 -0
- package/dist/src/form/index.d.ts +23 -0
- package/dist/src/form/index.d.ts.map +1 -0
- package/dist/src/form/index.js +27 -0
- package/dist/src/form/index.js.map +1 -0
- package/dist/src/form/runtime-value-reader.d.ts +72 -0
- package/dist/src/form/runtime-value-reader.d.ts.map +1 -0
- package/dist/src/form/runtime-value-reader.js +232 -0
- package/dist/src/form/runtime-value-reader.js.map +1 -0
- package/dist/src/form/types.d.ts +384 -0
- package/dist/src/form/types.d.ts.map +1 -0
- package/dist/src/form/types.js +17 -0
- package/dist/src/form/types.js.map +1 -0
- package/dist/src/index.d.ts +8 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +212 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/lib/constants.d.ts +27 -0
- package/dist/src/lib/constants.d.ts.map +1 -0
- package/dist/src/lib/constants.js +63 -0
- package/dist/src/lib/constants.js.map +1 -0
- package/dist/src/lib/index.d.ts +12 -0
- package/dist/src/lib/index.d.ts.map +1 -0
- package/dist/src/lib/index.js +17 -0
- package/dist/src/lib/index.js.map +1 -0
- package/dist/src/lib/regions.d.ts +29 -0
- package/dist/src/lib/regions.d.ts.map +1 -0
- package/dist/src/lib/regions.js +93 -0
- package/dist/src/lib/regions.js.map +1 -0
- package/dist/src/lib/scoring.d.ts +47 -0
- package/dist/src/lib/scoring.d.ts.map +1 -0
- package/dist/src/lib/scoring.js +79 -0
- package/dist/src/lib/scoring.js.map +1 -0
- package/dist/src/lib/selectors.d.ts +42 -0
- package/dist/src/lib/selectors.d.ts.map +1 -0
- package/dist/src/lib/selectors.js +138 -0
- package/dist/src/lib/selectors.js.map +1 -0
- package/dist/src/lib/text-utils.d.ts +155 -0
- package/dist/src/lib/text-utils.d.ts.map +1 -0
- package/dist/src/lib/text-utils.js +391 -0
- package/dist/src/lib/text-utils.js.map +1 -0
- package/dist/src/observation/eid-linker.d.ts +104 -0
- package/dist/src/observation/eid-linker.d.ts.map +1 -0
- package/dist/src/observation/eid-linker.js +403 -0
- package/dist/src/observation/eid-linker.js.map +1 -0
- package/dist/src/observation/index.d.ts +12 -0
- package/dist/src/observation/index.d.ts.map +1 -0
- package/dist/src/observation/index.js +15 -0
- package/dist/src/observation/index.js.map +1 -0
- package/dist/src/observation/observation-accumulator.d.ts +58 -0
- package/dist/src/observation/observation-accumulator.d.ts.map +1 -0
- package/dist/src/observation/observation-accumulator.js +213 -0
- package/dist/src/observation/observation-accumulator.js.map +1 -0
- package/dist/src/observation/observation.types.d.ts +139 -0
- package/dist/src/observation/observation.types.d.ts.map +1 -0
- package/dist/src/observation/observation.types.js +59 -0
- package/dist/src/observation/observation.types.js.map +1 -0
- package/dist/src/observation/observer-script.d.ts +19 -0
- package/dist/src/observation/observer-script.d.ts.map +1 -0
- package/dist/src/observation/observer-script.js +569 -0
- package/dist/src/observation/observer-script.js.map +1 -0
- package/dist/src/query/index.d.ts +9 -0
- package/dist/src/query/index.d.ts.map +1 -0
- package/dist/src/query/index.js +10 -0
- package/dist/src/query/index.js.map +1 -0
- package/dist/src/query/query-engine.d.ts +111 -0
- package/dist/src/query/query-engine.d.ts.map +1 -0
- package/dist/src/query/query-engine.js +509 -0
- package/dist/src/query/query-engine.js.map +1 -0
- package/dist/src/query/types/index.d.ts +5 -0
- package/dist/src/query/types/index.d.ts.map +1 -0
- package/dist/src/query/types/index.js +5 -0
- package/dist/src/query/types/index.js.map +1 -0
- package/dist/src/query/types/query.types.d.ts +141 -0
- package/dist/src/query/types/query.types.d.ts.map +1 -0
- package/dist/src/query/types/query.types.js +19 -0
- package/dist/src/query/types/query.types.js.map +1 -0
- package/dist/src/renderer/budget-manager.d.ts +46 -0
- package/dist/src/renderer/budget-manager.d.ts.map +1 -0
- package/dist/src/renderer/budget-manager.js +133 -0
- package/dist/src/renderer/budget-manager.js.map +1 -0
- package/dist/src/renderer/constants.d.ts +38 -0
- package/dist/src/renderer/constants.d.ts.map +1 -0
- package/dist/src/renderer/constants.js +29 -0
- package/dist/src/renderer/constants.js.map +1 -0
- package/dist/src/renderer/index.d.ts +12 -0
- package/dist/src/renderer/index.d.ts.map +1 -0
- package/dist/src/renderer/index.js +16 -0
- package/dist/src/renderer/index.js.map +1 -0
- package/dist/src/renderer/section-renderers.d.ts +42 -0
- package/dist/src/renderer/section-renderers.d.ts.map +1 -0
- package/dist/src/renderer/section-renderers.js +252 -0
- package/dist/src/renderer/section-renderers.js.map +1 -0
- package/dist/src/renderer/token-counter.d.ts +45 -0
- package/dist/src/renderer/token-counter.d.ts.map +1 -0
- package/dist/src/renderer/token-counter.js +65 -0
- package/dist/src/renderer/token-counter.js.map +1 -0
- package/dist/src/renderer/types.d.ts +71 -0
- package/dist/src/renderer/types.d.ts.map +1 -0
- package/dist/src/renderer/types.js +7 -0
- package/dist/src/renderer/types.js.map +1 -0
- package/dist/src/renderer/xml-renderer.d.ts +42 -0
- package/dist/src/renderer/xml-renderer.d.ts.map +1 -0
- package/dist/src/renderer/xml-renderer.js +103 -0
- package/dist/src/renderer/xml-renderer.js.map +1 -0
- package/dist/src/server/index.d.ts +8 -0
- package/dist/src/server/index.d.ts.map +1 -0
- package/dist/src/server/index.js +8 -0
- package/dist/src/server/index.js.map +1 -0
- package/dist/src/server/mcp-server.d.ts +59 -0
- package/dist/src/server/mcp-server.d.ts.map +1 -0
- package/dist/src/server/mcp-server.js +140 -0
- package/dist/src/server/mcp-server.js.map +1 -0
- package/dist/src/server/server-config.d.ts +41 -0
- package/dist/src/server/server-config.d.ts.map +1 -0
- package/dist/src/server/server-config.js +80 -0
- package/dist/src/server/server-config.js.map +1 -0
- package/dist/src/server/session-store.d.ts +148 -0
- package/dist/src/server/session-store.d.ts.map +1 -0
- package/dist/src/server/session-store.js +224 -0
- package/dist/src/server/session-store.js.map +1 -0
- package/dist/src/shared/errors/browser-session.error.d.ts +102 -0
- package/dist/src/shared/errors/browser-session.error.d.ts.map +1 -0
- package/dist/src/shared/errors/browser-session.error.js +153 -0
- package/dist/src/shared/errors/browser-session.error.js.map +1 -0
- package/dist/src/shared/errors/index.d.ts +5 -0
- package/dist/src/shared/errors/index.d.ts.map +1 -0
- package/dist/src/shared/errors/index.js +5 -0
- package/dist/src/shared/errors/index.js.map +1 -0
- package/dist/src/shared/services/dom-transformer.service.d.ts +71 -0
- package/dist/src/shared/services/dom-transformer.service.d.ts.map +1 -0
- package/dist/src/shared/services/dom-transformer.service.js +190 -0
- package/dist/src/shared/services/dom-transformer.service.js.map +1 -0
- package/dist/src/shared/services/index.d.ts +7 -0
- package/dist/src/shared/services/index.d.ts.map +1 -0
- package/dist/src/shared/services/index.js +7 -0
- package/dist/src/shared/services/index.js.map +1 -0
- package/dist/src/shared/services/logging.service.d.ts +154 -0
- package/dist/src/shared/services/logging.service.d.ts.map +1 -0
- package/dist/src/shared/services/logging.service.js +267 -0
- package/dist/src/shared/services/logging.service.js.map +1 -0
- package/dist/src/shared/services/selector-builder.service.d.ts +53 -0
- package/dist/src/shared/services/selector-builder.service.d.ts.map +1 -0
- package/dist/src/shared/services/selector-builder.service.js +240 -0
- package/dist/src/shared/services/selector-builder.service.js.map +1 -0
- package/dist/src/shared/types/base.types.d.ts +45 -0
- package/dist/src/shared/types/base.types.d.ts.map +1 -0
- package/dist/src/shared/types/base.types.js +8 -0
- package/dist/src/shared/types/base.types.js.map +1 -0
- package/dist/src/shared/types/index.d.ts +5 -0
- package/dist/src/shared/types/index.d.ts.map +1 -0
- package/dist/src/shared/types/index.js +5 -0
- package/dist/src/shared/types/index.js.map +1 -0
- package/dist/src/snapshot/element-resolver.d.ts +102 -0
- package/dist/src/snapshot/element-resolver.d.ts.map +1 -0
- package/dist/src/snapshot/element-resolver.js +379 -0
- package/dist/src/snapshot/element-resolver.js.map +1 -0
- package/dist/src/snapshot/extractors/attribute-extractor.d.ts +40 -0
- package/dist/src/snapshot/extractors/attribute-extractor.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/attribute-extractor.js +237 -0
- package/dist/src/snapshot/extractors/attribute-extractor.js.map +1 -0
- package/dist/src/snapshot/extractors/ax-extractor.d.ts +36 -0
- package/dist/src/snapshot/extractors/ax-extractor.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/ax-extractor.js +144 -0
- package/dist/src/snapshot/extractors/ax-extractor.js.map +1 -0
- package/dist/src/snapshot/extractors/dom-extractor.d.ts +21 -0
- package/dist/src/snapshot/extractors/dom-extractor.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/dom-extractor.js +137 -0
- package/dist/src/snapshot/extractors/dom-extractor.js.map +1 -0
- package/dist/src/snapshot/extractors/grouping-resolver.d.ts +39 -0
- package/dist/src/snapshot/extractors/grouping-resolver.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/grouping-resolver.js +260 -0
- package/dist/src/snapshot/extractors/grouping-resolver.js.map +1 -0
- package/dist/src/snapshot/extractors/index.d.ts +19 -0
- package/dist/src/snapshot/extractors/index.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/index.js +27 -0
- package/dist/src/snapshot/extractors/index.js.map +1 -0
- package/dist/src/snapshot/extractors/label-resolver.d.ts +44 -0
- package/dist/src/snapshot/extractors/label-resolver.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/label-resolver.js +173 -0
- package/dist/src/snapshot/extractors/label-resolver.js.map +1 -0
- package/dist/src/snapshot/extractors/layout-extractor.d.ts +52 -0
- package/dist/src/snapshot/extractors/layout-extractor.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/layout-extractor.js +382 -0
- package/dist/src/snapshot/extractors/layout-extractor.js.map +1 -0
- package/dist/src/snapshot/extractors/locator-builder.d.ts +27 -0
- package/dist/src/snapshot/extractors/locator-builder.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/locator-builder.js +223 -0
- package/dist/src/snapshot/extractors/locator-builder.js.map +1 -0
- package/dist/src/snapshot/extractors/region-resolver.d.ts +31 -0
- package/dist/src/snapshot/extractors/region-resolver.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/region-resolver.js +168 -0
- package/dist/src/snapshot/extractors/region-resolver.js.map +1 -0
- package/dist/src/snapshot/extractors/state-extractor.d.ts +30 -0
- package/dist/src/snapshot/extractors/state-extractor.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/state-extractor.js +181 -0
- package/dist/src/snapshot/extractors/state-extractor.js.map +1 -0
- package/dist/src/snapshot/extractors/types.d.ts +213 -0
- package/dist/src/snapshot/extractors/types.d.ts.map +1 -0
- package/dist/src/snapshot/extractors/types.js +145 -0
- package/dist/src/snapshot/extractors/types.js.map +1 -0
- package/dist/src/snapshot/index.d.ts +14 -0
- package/dist/src/snapshot/index.d.ts.map +1 -0
- package/dist/src/snapshot/index.js +18 -0
- package/dist/src/snapshot/index.js.map +1 -0
- package/dist/src/snapshot/snapshot-compiler.d.ts +73 -0
- package/dist/src/snapshot/snapshot-compiler.d.ts.map +1 -0
- package/dist/src/snapshot/snapshot-compiler.js +763 -0
- package/dist/src/snapshot/snapshot-compiler.js.map +1 -0
- package/dist/src/snapshot/snapshot-health.d.ts +97 -0
- package/dist/src/snapshot/snapshot-health.d.ts.map +1 -0
- package/dist/src/snapshot/snapshot-health.js +214 -0
- package/dist/src/snapshot/snapshot-health.js.map +1 -0
- package/dist/src/snapshot/snapshot-store.d.ts +137 -0
- package/dist/src/snapshot/snapshot-store.d.ts.map +1 -0
- package/dist/src/snapshot/snapshot-store.js +202 -0
- package/dist/src/snapshot/snapshot-store.js.map +1 -0
- package/dist/src/snapshot/snapshot.types.d.ts +250 -0
- package/dist/src/snapshot/snapshot.types.d.ts.map +1 -0
- package/dist/src/snapshot/snapshot.types.js +54 -0
- package/dist/src/snapshot/snapshot.types.js.map +1 -0
- package/dist/src/state/actionables-filter.d.ts +47 -0
- package/dist/src/state/actionables-filter.d.ts.map +1 -0
- package/dist/src/state/actionables-filter.js +173 -0
- package/dist/src/state/actionables-filter.js.map +1 -0
- package/dist/src/state/atoms-extractor.d.ts +23 -0
- package/dist/src/state/atoms-extractor.d.ts.map +1 -0
- package/dist/src/state/atoms-extractor.js +160 -0
- package/dist/src/state/atoms-extractor.js.map +1 -0
- package/dist/src/state/constants.d.ts +125 -0
- package/dist/src/state/constants.d.ts.map +1 -0
- package/dist/src/state/constants.js +131 -0
- package/dist/src/state/constants.js.map +1 -0
- package/dist/src/state/diff-engine.d.ts +23 -0
- package/dist/src/state/diff-engine.d.ts.map +1 -0
- package/dist/src/state/diff-engine.js +475 -0
- package/dist/src/state/diff-engine.js.map +1 -0
- package/dist/src/state/element-identity.d.ts +75 -0
- package/dist/src/state/element-identity.d.ts.map +1 -0
- package/dist/src/state/element-identity.js +129 -0
- package/dist/src/state/element-identity.js.map +1 -0
- package/dist/src/state/element-ref.types.d.ts +135 -0
- package/dist/src/state/element-ref.types.d.ts.map +1 -0
- package/dist/src/state/element-ref.types.js +13 -0
- package/dist/src/state/element-ref.types.js.map +1 -0
- package/dist/src/state/element-registry.d.ts +118 -0
- package/dist/src/state/element-registry.d.ts.map +1 -0
- package/dist/src/state/element-registry.js +222 -0
- package/dist/src/state/element-registry.js.map +1 -0
- package/dist/src/state/health.types.d.ts +93 -0
- package/dist/src/state/health.types.d.ts.map +1 -0
- package/dist/src/state/health.types.js +56 -0
- package/dist/src/state/health.types.js.map +1 -0
- package/dist/src/state/layer-detector.d.ts +23 -0
- package/dist/src/state/layer-detector.d.ts.map +1 -0
- package/dist/src/state/layer-detector.js +368 -0
- package/dist/src/state/layer-detector.js.map +1 -0
- package/dist/src/state/locator-generator.d.ts +21 -0
- package/dist/src/state/locator-generator.d.ts.map +1 -0
- package/dist/src/state/locator-generator.js +137 -0
- package/dist/src/state/locator-generator.js.map +1 -0
- package/dist/src/state/state-manager.d.ts +104 -0
- package/dist/src/state/state-manager.d.ts.map +1 -0
- package/dist/src/state/state-manager.js +618 -0
- package/dist/src/state/state-manager.js.map +1 -0
- package/dist/src/state/state-renderer.d.ts +63 -0
- package/dist/src/state/state-renderer.d.ts.map +1 -0
- package/dist/src/state/state-renderer.js +340 -0
- package/dist/src/state/state-renderer.js.map +1 -0
- package/dist/src/state/types.d.ts +353 -0
- package/dist/src/state/types.d.ts.map +1 -0
- package/dist/src/state/types.js +8 -0
- package/dist/src/state/types.js.map +1 -0
- package/dist/src/tools/browser-tools.d.ts +140 -0
- package/dist/src/tools/browser-tools.d.ts.map +1 -0
- package/dist/src/tools/browser-tools.js +657 -0
- package/dist/src/tools/browser-tools.js.map +1 -0
- package/dist/src/tools/errors.d.ts +63 -0
- package/dist/src/tools/errors.d.ts.map +1 -0
- package/dist/src/tools/errors.js +86 -0
- package/dist/src/tools/errors.js.map +1 -0
- package/dist/src/tools/execute-action.d.ts +135 -0
- package/dist/src/tools/execute-action.d.ts.map +1 -0
- package/dist/src/tools/execute-action.js +579 -0
- package/dist/src/tools/execute-action.js.map +1 -0
- package/dist/src/tools/form-tools.d.ts +109 -0
- package/dist/src/tools/form-tools.d.ts.map +1 -0
- package/dist/src/tools/form-tools.js +434 -0
- package/dist/src/tools/form-tools.js.map +1 -0
- package/dist/src/tools/index.d.ts +11 -0
- package/dist/src/tools/index.d.ts.map +1 -0
- package/dist/src/tools/index.js +49 -0
- package/dist/src/tools/index.js.map +1 -0
- package/dist/src/tools/response-builder.d.ts +98 -0
- package/dist/src/tools/response-builder.d.ts.map +1 -0
- package/dist/src/tools/response-builder.js +219 -0
- package/dist/src/tools/response-builder.js.map +1 -0
- package/dist/src/tools/tool-schemas.d.ts +2482 -0
- package/dist/src/tools/tool-schemas.d.ts.map +1 -0
- package/dist/src/tools/tool-schemas.js +606 -0
- package/dist/src/tools/tool-schemas.js.map +1 -0
- package/dist/vitest.config.d.ts +3 -0
- package/dist/vitest.config.d.ts.map +1 -0
- package/dist/vitest.config.js +16 -0
- package/dist/vitest.config.js.map +1 -0
- 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"}
|