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,2482 @@
1
+ /**
2
+ * MCP Tool Schemas
3
+ *
4
+ * Zod schemas for tool inputs and outputs.
5
+ * Used for validation and type inference.
6
+ */
7
+ import { z } from 'zod';
8
+ /**
9
+ * Snapshot health codes - specific reasons for snapshot failures.
10
+ */
11
+ export declare const SnapshotHealthCodeSchema: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
12
+ /**
13
+ * CDP session health status.
14
+ */
15
+ export declare const CdpHealthSchema: z.ZodObject<{
16
+ /** Whether CDP session is operational */
17
+ ok: z.ZodBoolean;
18
+ /** Whether recovery was attempted and succeeded */
19
+ recovered: z.ZodOptional<z.ZodBoolean>;
20
+ /** Recovery method used if recovery occurred */
21
+ recovery_method: z.ZodOptional<z.ZodLiteral<"rebind">>;
22
+ /** Error message if not ok */
23
+ error: z.ZodOptional<z.ZodString>;
24
+ }, "strip", z.ZodTypeAny, {
25
+ ok: boolean;
26
+ error?: string | undefined;
27
+ recovered?: boolean | undefined;
28
+ recovery_method?: "rebind" | undefined;
29
+ }, {
30
+ ok: boolean;
31
+ error?: string | undefined;
32
+ recovered?: boolean | undefined;
33
+ recovery_method?: "rebind" | undefined;
34
+ }>;
35
+ /**
36
+ * Snapshot capture health status.
37
+ */
38
+ export declare const SnapshotCaptureHealthSchema: z.ZodObject<{
39
+ /** Whether snapshot is usable */
40
+ ok: z.ZodBoolean;
41
+ /** Whether recovery was attempted */
42
+ recovered: z.ZodOptional<z.ZodBoolean>;
43
+ /** Health code explaining status */
44
+ code: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
45
+ /** Number of capture attempts */
46
+ attempts: z.ZodOptional<z.ZodNumber>;
47
+ /** Human-readable message */
48
+ message: z.ZodOptional<z.ZodString>;
49
+ }, "strip", z.ZodTypeAny, {
50
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
51
+ ok: boolean;
52
+ message?: string | undefined;
53
+ recovered?: boolean | undefined;
54
+ attempts?: number | undefined;
55
+ }, {
56
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
57
+ ok: boolean;
58
+ message?: string | undefined;
59
+ recovered?: boolean | undefined;
60
+ attempts?: number | undefined;
61
+ }>;
62
+ /**
63
+ * Runtime health info included in tool responses.
64
+ * Enables LLM to understand CDP/snapshot recovery status.
65
+ */
66
+ export declare const RuntimeHealthSchema: z.ZodObject<{
67
+ /** CDP session health */
68
+ cdp: z.ZodObject<{
69
+ /** Whether CDP session is operational */
70
+ ok: z.ZodBoolean;
71
+ /** Whether recovery was attempted and succeeded */
72
+ recovered: z.ZodOptional<z.ZodBoolean>;
73
+ /** Recovery method used if recovery occurred */
74
+ recovery_method: z.ZodOptional<z.ZodLiteral<"rebind">>;
75
+ /** Error message if not ok */
76
+ error: z.ZodOptional<z.ZodString>;
77
+ }, "strip", z.ZodTypeAny, {
78
+ ok: boolean;
79
+ error?: string | undefined;
80
+ recovered?: boolean | undefined;
81
+ recovery_method?: "rebind" | undefined;
82
+ }, {
83
+ ok: boolean;
84
+ error?: string | undefined;
85
+ recovered?: boolean | undefined;
86
+ recovery_method?: "rebind" | undefined;
87
+ }>;
88
+ /** Snapshot capture health */
89
+ snapshot: z.ZodObject<{
90
+ /** Whether snapshot is usable */
91
+ ok: z.ZodBoolean;
92
+ /** Whether recovery was attempted */
93
+ recovered: z.ZodOptional<z.ZodBoolean>;
94
+ /** Health code explaining status */
95
+ code: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
96
+ /** Number of capture attempts */
97
+ attempts: z.ZodOptional<z.ZodNumber>;
98
+ /** Human-readable message */
99
+ message: z.ZodOptional<z.ZodString>;
100
+ }, "strip", z.ZodTypeAny, {
101
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
102
+ ok: boolean;
103
+ message?: string | undefined;
104
+ recovered?: boolean | undefined;
105
+ attempts?: number | undefined;
106
+ }, {
107
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
108
+ ok: boolean;
109
+ message?: string | undefined;
110
+ recovered?: boolean | undefined;
111
+ attempts?: number | undefined;
112
+ }>;
113
+ }, "strip", z.ZodTypeAny, {
114
+ cdp: {
115
+ ok: boolean;
116
+ error?: string | undefined;
117
+ recovered?: boolean | undefined;
118
+ recovery_method?: "rebind" | undefined;
119
+ };
120
+ snapshot: {
121
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
122
+ ok: boolean;
123
+ message?: string | undefined;
124
+ recovered?: boolean | undefined;
125
+ attempts?: number | undefined;
126
+ };
127
+ }, {
128
+ cdp: {
129
+ ok: boolean;
130
+ error?: string | undefined;
131
+ recovered?: boolean | undefined;
132
+ recovery_method?: "rebind" | undefined;
133
+ };
134
+ snapshot: {
135
+ code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
136
+ ok: boolean;
137
+ message?: string | undefined;
138
+ recovered?: boolean | undefined;
139
+ attempts?: number | undefined;
140
+ };
141
+ }>;
142
+ export type RuntimeHealth = z.infer<typeof RuntimeHealthSchema>;
143
+ /** Full node details including location, layout, state, and attributes */
144
+ export declare const NodeDetailsSchema: z.ZodObject<{
145
+ /** Stable element ID for use with action tools */
146
+ eid: z.ZodString;
147
+ /** Semantic node type */
148
+ kind: z.ZodString;
149
+ /** Human-readable label */
150
+ label: z.ZodString;
151
+ /** Location information */
152
+ where: z.ZodObject<{
153
+ region: z.ZodString;
154
+ group_id: z.ZodOptional<z.ZodString>;
155
+ group_path: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
156
+ heading_context: z.ZodOptional<z.ZodString>;
157
+ }, "strip", z.ZodTypeAny, {
158
+ region: string;
159
+ group_id?: string | undefined;
160
+ group_path?: string[] | undefined;
161
+ heading_context?: string | undefined;
162
+ }, {
163
+ region: string;
164
+ group_id?: string | undefined;
165
+ group_path?: string[] | undefined;
166
+ heading_context?: string | undefined;
167
+ }>;
168
+ /** Layout information */
169
+ layout: z.ZodObject<{
170
+ bbox: z.ZodObject<{
171
+ x: z.ZodNumber;
172
+ y: z.ZodNumber;
173
+ w: z.ZodNumber;
174
+ h: z.ZodNumber;
175
+ }, "strip", z.ZodTypeAny, {
176
+ x: number;
177
+ y: number;
178
+ w: number;
179
+ h: number;
180
+ }, {
181
+ x: number;
182
+ y: number;
183
+ w: number;
184
+ h: number;
185
+ }>;
186
+ display: z.ZodOptional<z.ZodString>;
187
+ screen_zone: z.ZodOptional<z.ZodString>;
188
+ }, "strip", z.ZodTypeAny, {
189
+ bbox: {
190
+ x: number;
191
+ y: number;
192
+ w: number;
193
+ h: number;
194
+ };
195
+ display?: string | undefined;
196
+ screen_zone?: string | undefined;
197
+ }, {
198
+ bbox: {
199
+ x: number;
200
+ y: number;
201
+ w: number;
202
+ h: number;
203
+ };
204
+ display?: string | undefined;
205
+ screen_zone?: string | undefined;
206
+ }>;
207
+ /** Element state */
208
+ state: z.ZodOptional<z.ZodObject<{
209
+ visible: z.ZodOptional<z.ZodBoolean>;
210
+ enabled: z.ZodOptional<z.ZodBoolean>;
211
+ checked: z.ZodOptional<z.ZodBoolean>;
212
+ expanded: z.ZodOptional<z.ZodBoolean>;
213
+ selected: z.ZodOptional<z.ZodBoolean>;
214
+ focused: z.ZodOptional<z.ZodBoolean>;
215
+ required: z.ZodOptional<z.ZodBoolean>;
216
+ invalid: z.ZodOptional<z.ZodBoolean>;
217
+ readonly: z.ZodOptional<z.ZodBoolean>;
218
+ }, "strip", z.ZodTypeAny, {
219
+ readonly?: boolean | undefined;
220
+ required?: boolean | undefined;
221
+ visible?: boolean | undefined;
222
+ enabled?: boolean | undefined;
223
+ checked?: boolean | undefined;
224
+ expanded?: boolean | undefined;
225
+ selected?: boolean | undefined;
226
+ focused?: boolean | undefined;
227
+ invalid?: boolean | undefined;
228
+ }, {
229
+ readonly?: boolean | undefined;
230
+ required?: boolean | undefined;
231
+ visible?: boolean | undefined;
232
+ enabled?: boolean | undefined;
233
+ checked?: boolean | undefined;
234
+ expanded?: boolean | undefined;
235
+ selected?: boolean | undefined;
236
+ focused?: boolean | undefined;
237
+ invalid?: boolean | undefined;
238
+ }>>;
239
+ /** Locator strategies */
240
+ find: z.ZodOptional<z.ZodObject<{
241
+ primary: z.ZodString;
242
+ alternates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
243
+ }, "strip", z.ZodTypeAny, {
244
+ primary: string;
245
+ alternates?: string[] | undefined;
246
+ }, {
247
+ primary: string;
248
+ alternates?: string[] | undefined;
249
+ }>>;
250
+ /** Additional attributes */
251
+ attributes: z.ZodOptional<z.ZodObject<{
252
+ input_type: z.ZodOptional<z.ZodString>;
253
+ placeholder: z.ZodOptional<z.ZodString>;
254
+ value: z.ZodOptional<z.ZodString>;
255
+ href: z.ZodOptional<z.ZodString>;
256
+ alt: z.ZodOptional<z.ZodString>;
257
+ src: z.ZodOptional<z.ZodString>;
258
+ heading_level: z.ZodOptional<z.ZodNumber>;
259
+ action: z.ZodOptional<z.ZodString>;
260
+ method: z.ZodOptional<z.ZodString>;
261
+ autocomplete: z.ZodOptional<z.ZodString>;
262
+ role: z.ZodOptional<z.ZodString>;
263
+ test_id: z.ZodOptional<z.ZodString>;
264
+ }, "strip", z.ZodTypeAny, {
265
+ src?: string | undefined;
266
+ method?: string | undefined;
267
+ value?: string | undefined;
268
+ role?: string | undefined;
269
+ placeholder?: string | undefined;
270
+ alt?: string | undefined;
271
+ href?: string | undefined;
272
+ action?: string | undefined;
273
+ autocomplete?: string | undefined;
274
+ input_type?: string | undefined;
275
+ heading_level?: number | undefined;
276
+ test_id?: string | undefined;
277
+ }, {
278
+ src?: string | undefined;
279
+ method?: string | undefined;
280
+ value?: string | undefined;
281
+ role?: string | undefined;
282
+ placeholder?: string | undefined;
283
+ alt?: string | undefined;
284
+ href?: string | undefined;
285
+ action?: string | undefined;
286
+ autocomplete?: string | undefined;
287
+ input_type?: string | undefined;
288
+ heading_level?: number | undefined;
289
+ test_id?: string | undefined;
290
+ }>>;
291
+ }, "strip", z.ZodTypeAny, {
292
+ layout: {
293
+ bbox: {
294
+ x: number;
295
+ y: number;
296
+ w: number;
297
+ h: number;
298
+ };
299
+ display?: string | undefined;
300
+ screen_zone?: string | undefined;
301
+ };
302
+ eid: string;
303
+ kind: string;
304
+ label: string;
305
+ where: {
306
+ region: string;
307
+ group_id?: string | undefined;
308
+ group_path?: string[] | undefined;
309
+ heading_context?: string | undefined;
310
+ };
311
+ find?: {
312
+ primary: string;
313
+ alternates?: string[] | undefined;
314
+ } | undefined;
315
+ attributes?: {
316
+ src?: string | undefined;
317
+ method?: string | undefined;
318
+ value?: string | undefined;
319
+ role?: string | undefined;
320
+ placeholder?: string | undefined;
321
+ alt?: string | undefined;
322
+ href?: string | undefined;
323
+ action?: string | undefined;
324
+ autocomplete?: string | undefined;
325
+ input_type?: string | undefined;
326
+ heading_level?: number | undefined;
327
+ test_id?: string | undefined;
328
+ } | undefined;
329
+ state?: {
330
+ readonly?: boolean | undefined;
331
+ required?: boolean | undefined;
332
+ visible?: boolean | undefined;
333
+ enabled?: boolean | undefined;
334
+ checked?: boolean | undefined;
335
+ expanded?: boolean | undefined;
336
+ selected?: boolean | undefined;
337
+ focused?: boolean | undefined;
338
+ invalid?: boolean | undefined;
339
+ } | undefined;
340
+ }, {
341
+ layout: {
342
+ bbox: {
343
+ x: number;
344
+ y: number;
345
+ w: number;
346
+ h: number;
347
+ };
348
+ display?: string | undefined;
349
+ screen_zone?: string | undefined;
350
+ };
351
+ eid: string;
352
+ kind: string;
353
+ label: string;
354
+ where: {
355
+ region: string;
356
+ group_id?: string | undefined;
357
+ group_path?: string[] | undefined;
358
+ heading_context?: string | undefined;
359
+ };
360
+ find?: {
361
+ primary: string;
362
+ alternates?: string[] | undefined;
363
+ } | undefined;
364
+ attributes?: {
365
+ src?: string | undefined;
366
+ method?: string | undefined;
367
+ value?: string | undefined;
368
+ role?: string | undefined;
369
+ placeholder?: string | undefined;
370
+ alt?: string | undefined;
371
+ href?: string | undefined;
372
+ action?: string | undefined;
373
+ autocomplete?: string | undefined;
374
+ input_type?: string | undefined;
375
+ heading_level?: number | undefined;
376
+ test_id?: string | undefined;
377
+ } | undefined;
378
+ state?: {
379
+ readonly?: boolean | undefined;
380
+ required?: boolean | undefined;
381
+ visible?: boolean | undefined;
382
+ enabled?: boolean | undefined;
383
+ checked?: boolean | undefined;
384
+ expanded?: boolean | undefined;
385
+ selected?: boolean | undefined;
386
+ focused?: boolean | undefined;
387
+ invalid?: boolean | undefined;
388
+ } | undefined;
389
+ }>;
390
+ export type NodeDetails = z.infer<typeof NodeDetailsSchema>;
391
+ /**
392
+ * Locator information for element targeting.
393
+ */
394
+ export declare const LocatorInfoSchema: z.ZodObject<{
395
+ preferred: z.ZodObject<{
396
+ ax: z.ZodString;
397
+ }, "strip", z.ZodTypeAny, {
398
+ ax: string;
399
+ }, {
400
+ ax: string;
401
+ }>;
402
+ fallback: z.ZodOptional<z.ZodObject<{
403
+ css: z.ZodString;
404
+ }, "strip", z.ZodTypeAny, {
405
+ css: string;
406
+ }, {
407
+ css: string;
408
+ }>>;
409
+ }, "strip", z.ZodTypeAny, {
410
+ preferred: {
411
+ ax: string;
412
+ };
413
+ fallback?: {
414
+ css: string;
415
+ } | undefined;
416
+ }, {
417
+ preferred: {
418
+ ax: string;
419
+ };
420
+ fallback?: {
421
+ css: string;
422
+ } | undefined;
423
+ }>;
424
+ /**
425
+ * Element target reference - for direct targeting via backend_node_id.
426
+ * Included in actionables to enable direct element interaction.
427
+ */
428
+ export declare const ElementTargetRefSchema: z.ZodObject<{
429
+ /** Snapshot that produced this ref */
430
+ snapshot_id: z.ZodString;
431
+ /** CDP backend node ID - primary targeting method */
432
+ backend_node_id: z.ZodNumber;
433
+ /** CDP frame ID - for cross-frame targeting */
434
+ frame_id: z.ZodOptional<z.ZodString>;
435
+ /** CDP loader ID - changes on navigation */
436
+ loader_id: z.ZodOptional<z.ZodString>;
437
+ }, "strip", z.ZodTypeAny, {
438
+ snapshot_id: string;
439
+ backend_node_id: number;
440
+ frame_id?: string | undefined;
441
+ loader_id?: string | undefined;
442
+ }, {
443
+ snapshot_id: string;
444
+ backend_node_id: number;
445
+ frame_id?: string | undefined;
446
+ loader_id?: string | undefined;
447
+ }>;
448
+ /**
449
+ * Actionable element information.
450
+ * Returned as a capped list of interactive elements in the active layer.
451
+ *
452
+ * NEW: Includes `ref` for direct element targeting. Use `eid` for stable
453
+ * identity across snapshots, and `ref.backend_node_id` for immediate actions.
454
+ */
455
+ export declare const ActionableInfoSchema: z.ZodObject<{
456
+ eid: z.ZodString;
457
+ kind: z.ZodString;
458
+ name: z.ZodString;
459
+ role: z.ZodString;
460
+ vis: z.ZodBoolean;
461
+ ena: z.ZodBoolean;
462
+ /** Element target reference for direct interaction */
463
+ ref: z.ZodObject<{
464
+ /** Snapshot that produced this ref */
465
+ snapshot_id: z.ZodString;
466
+ /** CDP backend node ID - primary targeting method */
467
+ backend_node_id: z.ZodNumber;
468
+ /** CDP frame ID - for cross-frame targeting */
469
+ frame_id: z.ZodOptional<z.ZodString>;
470
+ /** CDP loader ID - changes on navigation */
471
+ loader_id: z.ZodOptional<z.ZodString>;
472
+ }, "strip", z.ZodTypeAny, {
473
+ snapshot_id: string;
474
+ backend_node_id: number;
475
+ frame_id?: string | undefined;
476
+ loader_id?: string | undefined;
477
+ }, {
478
+ snapshot_id: string;
479
+ backend_node_id: number;
480
+ frame_id?: string | undefined;
481
+ loader_id?: string | undefined;
482
+ }>;
483
+ loc: z.ZodObject<{
484
+ preferred: z.ZodObject<{
485
+ ax: z.ZodString;
486
+ }, "strip", z.ZodTypeAny, {
487
+ ax: string;
488
+ }, {
489
+ ax: string;
490
+ }>;
491
+ fallback: z.ZodOptional<z.ZodObject<{
492
+ css: z.ZodString;
493
+ }, "strip", z.ZodTypeAny, {
494
+ css: string;
495
+ }, {
496
+ css: string;
497
+ }>>;
498
+ }, "strip", z.ZodTypeAny, {
499
+ preferred: {
500
+ ax: string;
501
+ };
502
+ fallback?: {
503
+ css: string;
504
+ } | undefined;
505
+ }, {
506
+ preferred: {
507
+ ax: string;
508
+ };
509
+ fallback?: {
510
+ css: string;
511
+ } | undefined;
512
+ }>;
513
+ ctx: z.ZodObject<{
514
+ layer: z.ZodString;
515
+ group: z.ZodOptional<z.ZodString>;
516
+ }, "strip", z.ZodTypeAny, {
517
+ layer: string;
518
+ group?: string | undefined;
519
+ }, {
520
+ layer: string;
521
+ group?: string | undefined;
522
+ }>;
523
+ chk: z.ZodOptional<z.ZodBoolean>;
524
+ sel: z.ZodOptional<z.ZodBoolean>;
525
+ exp: z.ZodOptional<z.ZodBoolean>;
526
+ foc: z.ZodOptional<z.ZodBoolean>;
527
+ req: z.ZodOptional<z.ZodBoolean>;
528
+ inv: z.ZodOptional<z.ZodBoolean>;
529
+ rdo: z.ZodOptional<z.ZodBoolean>;
530
+ val_hint: z.ZodOptional<z.ZodString>;
531
+ placeholder: z.ZodOptional<z.ZodString>;
532
+ href: z.ZodOptional<z.ZodString>;
533
+ type: z.ZodOptional<z.ZodString>;
534
+ }, "strip", z.ZodTypeAny, {
535
+ name: string;
536
+ role: string;
537
+ eid: string;
538
+ kind: string;
539
+ vis: boolean;
540
+ ena: boolean;
541
+ ref: {
542
+ snapshot_id: string;
543
+ backend_node_id: number;
544
+ frame_id?: string | undefined;
545
+ loader_id?: string | undefined;
546
+ };
547
+ loc: {
548
+ preferred: {
549
+ ax: string;
550
+ };
551
+ fallback?: {
552
+ css: string;
553
+ } | undefined;
554
+ };
555
+ ctx: {
556
+ layer: string;
557
+ group?: string | undefined;
558
+ };
559
+ type?: string | undefined;
560
+ placeholder?: string | undefined;
561
+ href?: string | undefined;
562
+ chk?: boolean | undefined;
563
+ sel?: boolean | undefined;
564
+ exp?: boolean | undefined;
565
+ foc?: boolean | undefined;
566
+ req?: boolean | undefined;
567
+ inv?: boolean | undefined;
568
+ rdo?: boolean | undefined;
569
+ val_hint?: string | undefined;
570
+ }, {
571
+ name: string;
572
+ role: string;
573
+ eid: string;
574
+ kind: string;
575
+ vis: boolean;
576
+ ena: boolean;
577
+ ref: {
578
+ snapshot_id: string;
579
+ backend_node_id: number;
580
+ frame_id?: string | undefined;
581
+ loader_id?: string | undefined;
582
+ };
583
+ loc: {
584
+ preferred: {
585
+ ax: string;
586
+ };
587
+ fallback?: {
588
+ css: string;
589
+ } | undefined;
590
+ };
591
+ ctx: {
592
+ layer: string;
593
+ group?: string | undefined;
594
+ };
595
+ type?: string | undefined;
596
+ placeholder?: string | undefined;
597
+ href?: string | undefined;
598
+ chk?: boolean | undefined;
599
+ sel?: boolean | undefined;
600
+ exp?: boolean | undefined;
601
+ foc?: boolean | undefined;
602
+ req?: boolean | undefined;
603
+ inv?: boolean | undefined;
604
+ rdo?: boolean | undefined;
605
+ val_hint?: string | undefined;
606
+ }>;
607
+ /**
608
+ * State handle - core state metadata.
609
+ */
610
+ export declare const StateHandleSchema: z.ZodObject<{
611
+ sid: z.ZodString;
612
+ step: z.ZodNumber;
613
+ doc: z.ZodObject<{
614
+ url: z.ZodString;
615
+ origin: z.ZodString;
616
+ title: z.ZodString;
617
+ doc_id: z.ZodString;
618
+ nav_type: z.ZodEnum<["soft", "hard"]>;
619
+ history_idx: z.ZodNumber;
620
+ }, "strip", z.ZodTypeAny, {
621
+ url: string;
622
+ title: string;
623
+ origin: string;
624
+ doc_id: string;
625
+ nav_type: "soft" | "hard";
626
+ history_idx: number;
627
+ }, {
628
+ url: string;
629
+ title: string;
630
+ origin: string;
631
+ doc_id: string;
632
+ nav_type: "soft" | "hard";
633
+ history_idx: number;
634
+ }>;
635
+ layer: z.ZodObject<{
636
+ active: z.ZodEnum<["main", "modal", "drawer", "popover"]>;
637
+ stack: z.ZodArray<z.ZodString, "many">;
638
+ focus_eid: z.ZodOptional<z.ZodString>;
639
+ pointer_lock: z.ZodBoolean;
640
+ }, "strip", z.ZodTypeAny, {
641
+ stack: string[];
642
+ active: "main" | "modal" | "drawer" | "popover";
643
+ pointer_lock: boolean;
644
+ focus_eid?: string | undefined;
645
+ }, {
646
+ stack: string[];
647
+ active: "main" | "modal" | "drawer" | "popover";
648
+ pointer_lock: boolean;
649
+ focus_eid?: string | undefined;
650
+ }>;
651
+ timing: z.ZodObject<{
652
+ ts: z.ZodString;
653
+ dom_ready: z.ZodBoolean;
654
+ network_busy: z.ZodBoolean;
655
+ }, "strip", z.ZodTypeAny, {
656
+ ts: string;
657
+ dom_ready: boolean;
658
+ network_busy: boolean;
659
+ }, {
660
+ ts: string;
661
+ dom_ready: boolean;
662
+ network_busy: boolean;
663
+ }>;
664
+ hash: z.ZodObject<{
665
+ ui: z.ZodString;
666
+ layer: z.ZodString;
667
+ }, "strip", z.ZodTypeAny, {
668
+ layer: string;
669
+ ui: string;
670
+ }, {
671
+ layer: string;
672
+ ui: string;
673
+ }>;
674
+ }, "strip", z.ZodTypeAny, {
675
+ layer: {
676
+ stack: string[];
677
+ active: "main" | "modal" | "drawer" | "popover";
678
+ pointer_lock: boolean;
679
+ focus_eid?: string | undefined;
680
+ };
681
+ sid: string;
682
+ step: number;
683
+ doc: {
684
+ url: string;
685
+ title: string;
686
+ origin: string;
687
+ doc_id: string;
688
+ nav_type: "soft" | "hard";
689
+ history_idx: number;
690
+ };
691
+ timing: {
692
+ ts: string;
693
+ dom_ready: boolean;
694
+ network_busy: boolean;
695
+ };
696
+ hash: {
697
+ layer: string;
698
+ ui: string;
699
+ };
700
+ }, {
701
+ layer: {
702
+ stack: string[];
703
+ active: "main" | "modal" | "drawer" | "popover";
704
+ pointer_lock: boolean;
705
+ focus_eid?: string | undefined;
706
+ };
707
+ sid: string;
708
+ step: number;
709
+ doc: {
710
+ url: string;
711
+ title: string;
712
+ origin: string;
713
+ doc_id: string;
714
+ nav_type: "soft" | "hard";
715
+ history_idx: number;
716
+ };
717
+ timing: {
718
+ ts: string;
719
+ dom_ready: boolean;
720
+ network_busy: boolean;
721
+ };
722
+ hash: {
723
+ layer: string;
724
+ ui: string;
725
+ };
726
+ }>;
727
+ /**
728
+ * Baseline response (full state, no diff).
729
+ *
730
+ * Baselines are only sent when the LLM truly needs full context:
731
+ * - first: No previous snapshot (LLM has no prior context)
732
+ * - navigation: URL changed (old elements no longer exist)
733
+ * - error: State corrupted, need to resync
734
+ */
735
+ export declare const BaselineResponseSchema: z.ZodObject<{
736
+ mode: z.ZodLiteral<"baseline">;
737
+ reason: z.ZodEnum<["first", "navigation", "error"]>;
738
+ error: z.ZodOptional<z.ZodString>;
739
+ }, "strip", z.ZodTypeAny, {
740
+ reason: "error" | "navigation" | "first";
741
+ mode: "baseline";
742
+ error?: string | undefined;
743
+ }, {
744
+ reason: "error" | "navigation" | "first";
745
+ mode: "baseline";
746
+ error?: string | undefined;
747
+ }>;
748
+ /**
749
+ * Diff change for actionables.
750
+ */
751
+ export declare const DiffChangeSchema: z.ZodObject<{
752
+ eid: z.ZodString;
753
+ k: z.ZodString;
754
+ from: z.ZodUnknown;
755
+ to: z.ZodUnknown;
756
+ }, "strip", z.ZodTypeAny, {
757
+ eid: string;
758
+ k: string;
759
+ from?: unknown;
760
+ to?: unknown;
761
+ }, {
762
+ eid: string;
763
+ k: string;
764
+ from?: unknown;
765
+ to?: unknown;
766
+ }>;
767
+ /**
768
+ * Atom change.
769
+ */
770
+ export declare const AtomChangeSchema: z.ZodObject<{
771
+ k: z.ZodString;
772
+ from: z.ZodUnknown;
773
+ to: z.ZodUnknown;
774
+ }, "strip", z.ZodTypeAny, {
775
+ k: string;
776
+ from?: unknown;
777
+ to?: unknown;
778
+ }, {
779
+ k: string;
780
+ from?: unknown;
781
+ to?: unknown;
782
+ }>;
783
+ /**
784
+ * Diff response (incremental changes).
785
+ */
786
+ export declare const DiffResponseSchema: z.ZodObject<{
787
+ mode: z.ZodLiteral<"diff">;
788
+ diff: z.ZodObject<{
789
+ doc: z.ZodOptional<z.ZodObject<{
790
+ from: z.ZodObject<{
791
+ url: z.ZodString;
792
+ title: z.ZodString;
793
+ }, "strip", z.ZodTypeAny, {
794
+ url: string;
795
+ title: string;
796
+ }, {
797
+ url: string;
798
+ title: string;
799
+ }>;
800
+ to: z.ZodObject<{
801
+ url: z.ZodString;
802
+ title: z.ZodString;
803
+ }, "strip", z.ZodTypeAny, {
804
+ url: string;
805
+ title: string;
806
+ }, {
807
+ url: string;
808
+ title: string;
809
+ }>;
810
+ nav_type: z.ZodEnum<["soft", "hard"]>;
811
+ }, "strip", z.ZodTypeAny, {
812
+ nav_type: "soft" | "hard";
813
+ from: {
814
+ url: string;
815
+ title: string;
816
+ };
817
+ to: {
818
+ url: string;
819
+ title: string;
820
+ };
821
+ }, {
822
+ nav_type: "soft" | "hard";
823
+ from: {
824
+ url: string;
825
+ title: string;
826
+ };
827
+ to: {
828
+ url: string;
829
+ title: string;
830
+ };
831
+ }>>;
832
+ layer: z.ZodOptional<z.ZodObject<{
833
+ stack_from: z.ZodArray<z.ZodString, "many">;
834
+ stack_to: z.ZodArray<z.ZodString, "many">;
835
+ }, "strip", z.ZodTypeAny, {
836
+ stack_from: string[];
837
+ stack_to: string[];
838
+ }, {
839
+ stack_from: string[];
840
+ stack_to: string[];
841
+ }>>;
842
+ actionables: z.ZodObject<{
843
+ added: z.ZodArray<z.ZodString, "many">;
844
+ removed: z.ZodArray<z.ZodString, "many">;
845
+ changed: z.ZodArray<z.ZodObject<{
846
+ eid: z.ZodString;
847
+ k: z.ZodString;
848
+ from: z.ZodUnknown;
849
+ to: z.ZodUnknown;
850
+ }, "strip", z.ZodTypeAny, {
851
+ eid: string;
852
+ k: string;
853
+ from?: unknown;
854
+ to?: unknown;
855
+ }, {
856
+ eid: string;
857
+ k: string;
858
+ from?: unknown;
859
+ to?: unknown;
860
+ }>, "many">;
861
+ }, "strip", z.ZodTypeAny, {
862
+ added: string[];
863
+ removed: string[];
864
+ changed: {
865
+ eid: string;
866
+ k: string;
867
+ from?: unknown;
868
+ to?: unknown;
869
+ }[];
870
+ }, {
871
+ added: string[];
872
+ removed: string[];
873
+ changed: {
874
+ eid: string;
875
+ k: string;
876
+ from?: unknown;
877
+ to?: unknown;
878
+ }[];
879
+ }>;
880
+ atoms: z.ZodArray<z.ZodObject<{
881
+ k: z.ZodString;
882
+ from: z.ZodUnknown;
883
+ to: z.ZodUnknown;
884
+ }, "strip", z.ZodTypeAny, {
885
+ k: string;
886
+ from?: unknown;
887
+ to?: unknown;
888
+ }, {
889
+ k: string;
890
+ from?: unknown;
891
+ to?: unknown;
892
+ }>, "many">;
893
+ }, "strip", z.ZodTypeAny, {
894
+ actionables: {
895
+ added: string[];
896
+ removed: string[];
897
+ changed: {
898
+ eid: string;
899
+ k: string;
900
+ from?: unknown;
901
+ to?: unknown;
902
+ }[];
903
+ };
904
+ atoms: {
905
+ k: string;
906
+ from?: unknown;
907
+ to?: unknown;
908
+ }[];
909
+ layer?: {
910
+ stack_from: string[];
911
+ stack_to: string[];
912
+ } | undefined;
913
+ doc?: {
914
+ nav_type: "soft" | "hard";
915
+ from: {
916
+ url: string;
917
+ title: string;
918
+ };
919
+ to: {
920
+ url: string;
921
+ title: string;
922
+ };
923
+ } | undefined;
924
+ }, {
925
+ actionables: {
926
+ added: string[];
927
+ removed: string[];
928
+ changed: {
929
+ eid: string;
930
+ k: string;
931
+ from?: unknown;
932
+ to?: unknown;
933
+ }[];
934
+ };
935
+ atoms: {
936
+ k: string;
937
+ from?: unknown;
938
+ to?: unknown;
939
+ }[];
940
+ layer?: {
941
+ stack_from: string[];
942
+ stack_to: string[];
943
+ } | undefined;
944
+ doc?: {
945
+ nav_type: "soft" | "hard";
946
+ from: {
947
+ url: string;
948
+ title: string;
949
+ };
950
+ to: {
951
+ url: string;
952
+ title: string;
953
+ };
954
+ } | undefined;
955
+ }>;
956
+ }, "strip", z.ZodTypeAny, {
957
+ diff: {
958
+ actionables: {
959
+ added: string[];
960
+ removed: string[];
961
+ changed: {
962
+ eid: string;
963
+ k: string;
964
+ from?: unknown;
965
+ to?: unknown;
966
+ }[];
967
+ };
968
+ atoms: {
969
+ k: string;
970
+ from?: unknown;
971
+ to?: unknown;
972
+ }[];
973
+ layer?: {
974
+ stack_from: string[];
975
+ stack_to: string[];
976
+ } | undefined;
977
+ doc?: {
978
+ nav_type: "soft" | "hard";
979
+ from: {
980
+ url: string;
981
+ title: string;
982
+ };
983
+ to: {
984
+ url: string;
985
+ title: string;
986
+ };
987
+ } | undefined;
988
+ };
989
+ mode: "diff";
990
+ }, {
991
+ diff: {
992
+ actionables: {
993
+ added: string[];
994
+ removed: string[];
995
+ changed: {
996
+ eid: string;
997
+ k: string;
998
+ from?: unknown;
999
+ to?: unknown;
1000
+ }[];
1001
+ };
1002
+ atoms: {
1003
+ k: string;
1004
+ from?: unknown;
1005
+ to?: unknown;
1006
+ }[];
1007
+ layer?: {
1008
+ stack_from: string[];
1009
+ stack_to: string[];
1010
+ } | undefined;
1011
+ doc?: {
1012
+ nav_type: "soft" | "hard";
1013
+ from: {
1014
+ url: string;
1015
+ title: string;
1016
+ };
1017
+ to: {
1018
+ url: string;
1019
+ title: string;
1020
+ };
1021
+ } | undefined;
1022
+ };
1023
+ mode: "diff";
1024
+ }>;
1025
+ /**
1026
+ * Universal UI state atoms.
1027
+ */
1028
+ export declare const AtomsSchema: z.ZodObject<{
1029
+ viewport: z.ZodObject<{
1030
+ w: z.ZodNumber;
1031
+ h: z.ZodNumber;
1032
+ dpr: z.ZodNumber;
1033
+ }, "strip", z.ZodTypeAny, {
1034
+ w: number;
1035
+ h: number;
1036
+ dpr: number;
1037
+ }, {
1038
+ w: number;
1039
+ h: number;
1040
+ dpr: number;
1041
+ }>;
1042
+ scroll: z.ZodObject<{
1043
+ x: z.ZodNumber;
1044
+ y: z.ZodNumber;
1045
+ }, "strip", z.ZodTypeAny, {
1046
+ x: number;
1047
+ y: number;
1048
+ }, {
1049
+ x: number;
1050
+ y: number;
1051
+ }>;
1052
+ loading: z.ZodOptional<z.ZodObject<{
1053
+ network_busy: z.ZodBoolean;
1054
+ spinners: z.ZodNumber;
1055
+ progress: z.ZodOptional<z.ZodNumber>;
1056
+ }, "strip", z.ZodTypeAny, {
1057
+ network_busy: boolean;
1058
+ spinners: number;
1059
+ progress?: number | undefined;
1060
+ }, {
1061
+ network_busy: boolean;
1062
+ spinners: number;
1063
+ progress?: number | undefined;
1064
+ }>>;
1065
+ forms: z.ZodOptional<z.ZodObject<{
1066
+ dirty: z.ZodBoolean;
1067
+ focused_field: z.ZodOptional<z.ZodString>;
1068
+ validation_errors: z.ZodNumber;
1069
+ }, "strip", z.ZodTypeAny, {
1070
+ dirty: boolean;
1071
+ validation_errors: number;
1072
+ focused_field?: string | undefined;
1073
+ }, {
1074
+ dirty: boolean;
1075
+ validation_errors: number;
1076
+ focused_field?: string | undefined;
1077
+ }>>;
1078
+ notifications: z.ZodOptional<z.ZodObject<{
1079
+ toasts: z.ZodNumber;
1080
+ banners: z.ZodNumber;
1081
+ }, "strip", z.ZodTypeAny, {
1082
+ toasts: number;
1083
+ banners: number;
1084
+ }, {
1085
+ toasts: number;
1086
+ banners: number;
1087
+ }>>;
1088
+ }, "strip", z.ZodTypeAny, {
1089
+ viewport: {
1090
+ w: number;
1091
+ h: number;
1092
+ dpr: number;
1093
+ };
1094
+ scroll: {
1095
+ x: number;
1096
+ y: number;
1097
+ };
1098
+ notifications?: {
1099
+ toasts: number;
1100
+ banners: number;
1101
+ } | undefined;
1102
+ loading?: {
1103
+ network_busy: boolean;
1104
+ spinners: number;
1105
+ progress?: number | undefined;
1106
+ } | undefined;
1107
+ forms?: {
1108
+ dirty: boolean;
1109
+ validation_errors: number;
1110
+ focused_field?: string | undefined;
1111
+ } | undefined;
1112
+ }, {
1113
+ viewport: {
1114
+ w: number;
1115
+ h: number;
1116
+ dpr: number;
1117
+ };
1118
+ scroll: {
1119
+ x: number;
1120
+ y: number;
1121
+ };
1122
+ notifications?: {
1123
+ toasts: number;
1124
+ banners: number;
1125
+ } | undefined;
1126
+ loading?: {
1127
+ network_busy: boolean;
1128
+ spinners: number;
1129
+ progress?: number | undefined;
1130
+ } | undefined;
1131
+ forms?: {
1132
+ dirty: boolean;
1133
+ validation_errors: number;
1134
+ focused_field?: string | undefined;
1135
+ } | undefined;
1136
+ }>;
1137
+ /**
1138
+ * Internal state response object structure (for reference/documentation).
1139
+ * The actual StateResponse is an XML string for LLM context efficiency.
1140
+ */
1141
+ export declare const StateResponseObjectSchema: z.ZodObject<{
1142
+ state: z.ZodObject<{
1143
+ sid: z.ZodString;
1144
+ step: z.ZodNumber;
1145
+ doc: z.ZodObject<{
1146
+ url: z.ZodString;
1147
+ origin: z.ZodString;
1148
+ title: z.ZodString;
1149
+ doc_id: z.ZodString;
1150
+ nav_type: z.ZodEnum<["soft", "hard"]>;
1151
+ history_idx: z.ZodNumber;
1152
+ }, "strip", z.ZodTypeAny, {
1153
+ url: string;
1154
+ title: string;
1155
+ origin: string;
1156
+ doc_id: string;
1157
+ nav_type: "soft" | "hard";
1158
+ history_idx: number;
1159
+ }, {
1160
+ url: string;
1161
+ title: string;
1162
+ origin: string;
1163
+ doc_id: string;
1164
+ nav_type: "soft" | "hard";
1165
+ history_idx: number;
1166
+ }>;
1167
+ layer: z.ZodObject<{
1168
+ active: z.ZodEnum<["main", "modal", "drawer", "popover"]>;
1169
+ stack: z.ZodArray<z.ZodString, "many">;
1170
+ focus_eid: z.ZodOptional<z.ZodString>;
1171
+ pointer_lock: z.ZodBoolean;
1172
+ }, "strip", z.ZodTypeAny, {
1173
+ stack: string[];
1174
+ active: "main" | "modal" | "drawer" | "popover";
1175
+ pointer_lock: boolean;
1176
+ focus_eid?: string | undefined;
1177
+ }, {
1178
+ stack: string[];
1179
+ active: "main" | "modal" | "drawer" | "popover";
1180
+ pointer_lock: boolean;
1181
+ focus_eid?: string | undefined;
1182
+ }>;
1183
+ timing: z.ZodObject<{
1184
+ ts: z.ZodString;
1185
+ dom_ready: z.ZodBoolean;
1186
+ network_busy: z.ZodBoolean;
1187
+ }, "strip", z.ZodTypeAny, {
1188
+ ts: string;
1189
+ dom_ready: boolean;
1190
+ network_busy: boolean;
1191
+ }, {
1192
+ ts: string;
1193
+ dom_ready: boolean;
1194
+ network_busy: boolean;
1195
+ }>;
1196
+ hash: z.ZodObject<{
1197
+ ui: z.ZodString;
1198
+ layer: z.ZodString;
1199
+ }, "strip", z.ZodTypeAny, {
1200
+ layer: string;
1201
+ ui: string;
1202
+ }, {
1203
+ layer: string;
1204
+ ui: string;
1205
+ }>;
1206
+ }, "strip", z.ZodTypeAny, {
1207
+ layer: {
1208
+ stack: string[];
1209
+ active: "main" | "modal" | "drawer" | "popover";
1210
+ pointer_lock: boolean;
1211
+ focus_eid?: string | undefined;
1212
+ };
1213
+ sid: string;
1214
+ step: number;
1215
+ doc: {
1216
+ url: string;
1217
+ title: string;
1218
+ origin: string;
1219
+ doc_id: string;
1220
+ nav_type: "soft" | "hard";
1221
+ history_idx: number;
1222
+ };
1223
+ timing: {
1224
+ ts: string;
1225
+ dom_ready: boolean;
1226
+ network_busy: boolean;
1227
+ };
1228
+ hash: {
1229
+ layer: string;
1230
+ ui: string;
1231
+ };
1232
+ }, {
1233
+ layer: {
1234
+ stack: string[];
1235
+ active: "main" | "modal" | "drawer" | "popover";
1236
+ pointer_lock: boolean;
1237
+ focus_eid?: string | undefined;
1238
+ };
1239
+ sid: string;
1240
+ step: number;
1241
+ doc: {
1242
+ url: string;
1243
+ title: string;
1244
+ origin: string;
1245
+ doc_id: string;
1246
+ nav_type: "soft" | "hard";
1247
+ history_idx: number;
1248
+ };
1249
+ timing: {
1250
+ ts: string;
1251
+ dom_ready: boolean;
1252
+ network_busy: boolean;
1253
+ };
1254
+ hash: {
1255
+ layer: string;
1256
+ ui: string;
1257
+ };
1258
+ }>;
1259
+ diff: z.ZodUnion<[z.ZodObject<{
1260
+ mode: z.ZodLiteral<"baseline">;
1261
+ reason: z.ZodEnum<["first", "navigation", "error"]>;
1262
+ error: z.ZodOptional<z.ZodString>;
1263
+ }, "strip", z.ZodTypeAny, {
1264
+ reason: "error" | "navigation" | "first";
1265
+ mode: "baseline";
1266
+ error?: string | undefined;
1267
+ }, {
1268
+ reason: "error" | "navigation" | "first";
1269
+ mode: "baseline";
1270
+ error?: string | undefined;
1271
+ }>, z.ZodObject<{
1272
+ mode: z.ZodLiteral<"diff">;
1273
+ diff: z.ZodObject<{
1274
+ doc: z.ZodOptional<z.ZodObject<{
1275
+ from: z.ZodObject<{
1276
+ url: z.ZodString;
1277
+ title: z.ZodString;
1278
+ }, "strip", z.ZodTypeAny, {
1279
+ url: string;
1280
+ title: string;
1281
+ }, {
1282
+ url: string;
1283
+ title: string;
1284
+ }>;
1285
+ to: z.ZodObject<{
1286
+ url: z.ZodString;
1287
+ title: z.ZodString;
1288
+ }, "strip", z.ZodTypeAny, {
1289
+ url: string;
1290
+ title: string;
1291
+ }, {
1292
+ url: string;
1293
+ title: string;
1294
+ }>;
1295
+ nav_type: z.ZodEnum<["soft", "hard"]>;
1296
+ }, "strip", z.ZodTypeAny, {
1297
+ nav_type: "soft" | "hard";
1298
+ from: {
1299
+ url: string;
1300
+ title: string;
1301
+ };
1302
+ to: {
1303
+ url: string;
1304
+ title: string;
1305
+ };
1306
+ }, {
1307
+ nav_type: "soft" | "hard";
1308
+ from: {
1309
+ url: string;
1310
+ title: string;
1311
+ };
1312
+ to: {
1313
+ url: string;
1314
+ title: string;
1315
+ };
1316
+ }>>;
1317
+ layer: z.ZodOptional<z.ZodObject<{
1318
+ stack_from: z.ZodArray<z.ZodString, "many">;
1319
+ stack_to: z.ZodArray<z.ZodString, "many">;
1320
+ }, "strip", z.ZodTypeAny, {
1321
+ stack_from: string[];
1322
+ stack_to: string[];
1323
+ }, {
1324
+ stack_from: string[];
1325
+ stack_to: string[];
1326
+ }>>;
1327
+ actionables: z.ZodObject<{
1328
+ added: z.ZodArray<z.ZodString, "many">;
1329
+ removed: z.ZodArray<z.ZodString, "many">;
1330
+ changed: z.ZodArray<z.ZodObject<{
1331
+ eid: z.ZodString;
1332
+ k: z.ZodString;
1333
+ from: z.ZodUnknown;
1334
+ to: z.ZodUnknown;
1335
+ }, "strip", z.ZodTypeAny, {
1336
+ eid: string;
1337
+ k: string;
1338
+ from?: unknown;
1339
+ to?: unknown;
1340
+ }, {
1341
+ eid: string;
1342
+ k: string;
1343
+ from?: unknown;
1344
+ to?: unknown;
1345
+ }>, "many">;
1346
+ }, "strip", z.ZodTypeAny, {
1347
+ added: string[];
1348
+ removed: string[];
1349
+ changed: {
1350
+ eid: string;
1351
+ k: string;
1352
+ from?: unknown;
1353
+ to?: unknown;
1354
+ }[];
1355
+ }, {
1356
+ added: string[];
1357
+ removed: string[];
1358
+ changed: {
1359
+ eid: string;
1360
+ k: string;
1361
+ from?: unknown;
1362
+ to?: unknown;
1363
+ }[];
1364
+ }>;
1365
+ atoms: z.ZodArray<z.ZodObject<{
1366
+ k: z.ZodString;
1367
+ from: z.ZodUnknown;
1368
+ to: z.ZodUnknown;
1369
+ }, "strip", z.ZodTypeAny, {
1370
+ k: string;
1371
+ from?: unknown;
1372
+ to?: unknown;
1373
+ }, {
1374
+ k: string;
1375
+ from?: unknown;
1376
+ to?: unknown;
1377
+ }>, "many">;
1378
+ }, "strip", z.ZodTypeAny, {
1379
+ actionables: {
1380
+ added: string[];
1381
+ removed: string[];
1382
+ changed: {
1383
+ eid: string;
1384
+ k: string;
1385
+ from?: unknown;
1386
+ to?: unknown;
1387
+ }[];
1388
+ };
1389
+ atoms: {
1390
+ k: string;
1391
+ from?: unknown;
1392
+ to?: unknown;
1393
+ }[];
1394
+ layer?: {
1395
+ stack_from: string[];
1396
+ stack_to: string[];
1397
+ } | undefined;
1398
+ doc?: {
1399
+ nav_type: "soft" | "hard";
1400
+ from: {
1401
+ url: string;
1402
+ title: string;
1403
+ };
1404
+ to: {
1405
+ url: string;
1406
+ title: string;
1407
+ };
1408
+ } | undefined;
1409
+ }, {
1410
+ actionables: {
1411
+ added: string[];
1412
+ removed: string[];
1413
+ changed: {
1414
+ eid: string;
1415
+ k: string;
1416
+ from?: unknown;
1417
+ to?: unknown;
1418
+ }[];
1419
+ };
1420
+ atoms: {
1421
+ k: string;
1422
+ from?: unknown;
1423
+ to?: unknown;
1424
+ }[];
1425
+ layer?: {
1426
+ stack_from: string[];
1427
+ stack_to: string[];
1428
+ } | undefined;
1429
+ doc?: {
1430
+ nav_type: "soft" | "hard";
1431
+ from: {
1432
+ url: string;
1433
+ title: string;
1434
+ };
1435
+ to: {
1436
+ url: string;
1437
+ title: string;
1438
+ };
1439
+ } | undefined;
1440
+ }>;
1441
+ }, "strip", z.ZodTypeAny, {
1442
+ diff: {
1443
+ actionables: {
1444
+ added: string[];
1445
+ removed: string[];
1446
+ changed: {
1447
+ eid: string;
1448
+ k: string;
1449
+ from?: unknown;
1450
+ to?: unknown;
1451
+ }[];
1452
+ };
1453
+ atoms: {
1454
+ k: string;
1455
+ from?: unknown;
1456
+ to?: unknown;
1457
+ }[];
1458
+ layer?: {
1459
+ stack_from: string[];
1460
+ stack_to: string[];
1461
+ } | undefined;
1462
+ doc?: {
1463
+ nav_type: "soft" | "hard";
1464
+ from: {
1465
+ url: string;
1466
+ title: string;
1467
+ };
1468
+ to: {
1469
+ url: string;
1470
+ title: string;
1471
+ };
1472
+ } | undefined;
1473
+ };
1474
+ mode: "diff";
1475
+ }, {
1476
+ diff: {
1477
+ actionables: {
1478
+ added: string[];
1479
+ removed: string[];
1480
+ changed: {
1481
+ eid: string;
1482
+ k: string;
1483
+ from?: unknown;
1484
+ to?: unknown;
1485
+ }[];
1486
+ };
1487
+ atoms: {
1488
+ k: string;
1489
+ from?: unknown;
1490
+ to?: unknown;
1491
+ }[];
1492
+ layer?: {
1493
+ stack_from: string[];
1494
+ stack_to: string[];
1495
+ } | undefined;
1496
+ doc?: {
1497
+ nav_type: "soft" | "hard";
1498
+ from: {
1499
+ url: string;
1500
+ title: string;
1501
+ };
1502
+ to: {
1503
+ url: string;
1504
+ title: string;
1505
+ };
1506
+ } | undefined;
1507
+ };
1508
+ mode: "diff";
1509
+ }>]>;
1510
+ actionables: z.ZodArray<z.ZodObject<{
1511
+ eid: z.ZodString;
1512
+ kind: z.ZodString;
1513
+ name: z.ZodString;
1514
+ role: z.ZodString;
1515
+ vis: z.ZodBoolean;
1516
+ ena: z.ZodBoolean;
1517
+ /** Element target reference for direct interaction */
1518
+ ref: z.ZodObject<{
1519
+ /** Snapshot that produced this ref */
1520
+ snapshot_id: z.ZodString;
1521
+ /** CDP backend node ID - primary targeting method */
1522
+ backend_node_id: z.ZodNumber;
1523
+ /** CDP frame ID - for cross-frame targeting */
1524
+ frame_id: z.ZodOptional<z.ZodString>;
1525
+ /** CDP loader ID - changes on navigation */
1526
+ loader_id: z.ZodOptional<z.ZodString>;
1527
+ }, "strip", z.ZodTypeAny, {
1528
+ snapshot_id: string;
1529
+ backend_node_id: number;
1530
+ frame_id?: string | undefined;
1531
+ loader_id?: string | undefined;
1532
+ }, {
1533
+ snapshot_id: string;
1534
+ backend_node_id: number;
1535
+ frame_id?: string | undefined;
1536
+ loader_id?: string | undefined;
1537
+ }>;
1538
+ loc: z.ZodObject<{
1539
+ preferred: z.ZodObject<{
1540
+ ax: z.ZodString;
1541
+ }, "strip", z.ZodTypeAny, {
1542
+ ax: string;
1543
+ }, {
1544
+ ax: string;
1545
+ }>;
1546
+ fallback: z.ZodOptional<z.ZodObject<{
1547
+ css: z.ZodString;
1548
+ }, "strip", z.ZodTypeAny, {
1549
+ css: string;
1550
+ }, {
1551
+ css: string;
1552
+ }>>;
1553
+ }, "strip", z.ZodTypeAny, {
1554
+ preferred: {
1555
+ ax: string;
1556
+ };
1557
+ fallback?: {
1558
+ css: string;
1559
+ } | undefined;
1560
+ }, {
1561
+ preferred: {
1562
+ ax: string;
1563
+ };
1564
+ fallback?: {
1565
+ css: string;
1566
+ } | undefined;
1567
+ }>;
1568
+ ctx: z.ZodObject<{
1569
+ layer: z.ZodString;
1570
+ group: z.ZodOptional<z.ZodString>;
1571
+ }, "strip", z.ZodTypeAny, {
1572
+ layer: string;
1573
+ group?: string | undefined;
1574
+ }, {
1575
+ layer: string;
1576
+ group?: string | undefined;
1577
+ }>;
1578
+ chk: z.ZodOptional<z.ZodBoolean>;
1579
+ sel: z.ZodOptional<z.ZodBoolean>;
1580
+ exp: z.ZodOptional<z.ZodBoolean>;
1581
+ foc: z.ZodOptional<z.ZodBoolean>;
1582
+ req: z.ZodOptional<z.ZodBoolean>;
1583
+ inv: z.ZodOptional<z.ZodBoolean>;
1584
+ rdo: z.ZodOptional<z.ZodBoolean>;
1585
+ val_hint: z.ZodOptional<z.ZodString>;
1586
+ placeholder: z.ZodOptional<z.ZodString>;
1587
+ href: z.ZodOptional<z.ZodString>;
1588
+ type: z.ZodOptional<z.ZodString>;
1589
+ }, "strip", z.ZodTypeAny, {
1590
+ name: string;
1591
+ role: string;
1592
+ eid: string;
1593
+ kind: string;
1594
+ vis: boolean;
1595
+ ena: boolean;
1596
+ ref: {
1597
+ snapshot_id: string;
1598
+ backend_node_id: number;
1599
+ frame_id?: string | undefined;
1600
+ loader_id?: string | undefined;
1601
+ };
1602
+ loc: {
1603
+ preferred: {
1604
+ ax: string;
1605
+ };
1606
+ fallback?: {
1607
+ css: string;
1608
+ } | undefined;
1609
+ };
1610
+ ctx: {
1611
+ layer: string;
1612
+ group?: string | undefined;
1613
+ };
1614
+ type?: string | undefined;
1615
+ placeholder?: string | undefined;
1616
+ href?: string | undefined;
1617
+ chk?: boolean | undefined;
1618
+ sel?: boolean | undefined;
1619
+ exp?: boolean | undefined;
1620
+ foc?: boolean | undefined;
1621
+ req?: boolean | undefined;
1622
+ inv?: boolean | undefined;
1623
+ rdo?: boolean | undefined;
1624
+ val_hint?: string | undefined;
1625
+ }, {
1626
+ name: string;
1627
+ role: string;
1628
+ eid: string;
1629
+ kind: string;
1630
+ vis: boolean;
1631
+ ena: boolean;
1632
+ ref: {
1633
+ snapshot_id: string;
1634
+ backend_node_id: number;
1635
+ frame_id?: string | undefined;
1636
+ loader_id?: string | undefined;
1637
+ };
1638
+ loc: {
1639
+ preferred: {
1640
+ ax: string;
1641
+ };
1642
+ fallback?: {
1643
+ css: string;
1644
+ } | undefined;
1645
+ };
1646
+ ctx: {
1647
+ layer: string;
1648
+ group?: string | undefined;
1649
+ };
1650
+ type?: string | undefined;
1651
+ placeholder?: string | undefined;
1652
+ href?: string | undefined;
1653
+ chk?: boolean | undefined;
1654
+ sel?: boolean | undefined;
1655
+ exp?: boolean | undefined;
1656
+ foc?: boolean | undefined;
1657
+ req?: boolean | undefined;
1658
+ inv?: boolean | undefined;
1659
+ rdo?: boolean | undefined;
1660
+ val_hint?: string | undefined;
1661
+ }>, "many">;
1662
+ counts: z.ZodObject<{
1663
+ shown: z.ZodNumber;
1664
+ total_in_layer: z.ZodNumber;
1665
+ }, "strip", z.ZodTypeAny, {
1666
+ shown: number;
1667
+ total_in_layer: number;
1668
+ }, {
1669
+ shown: number;
1670
+ total_in_layer: number;
1671
+ }>;
1672
+ limits: z.ZodObject<{
1673
+ max_actionables: z.ZodNumber;
1674
+ actionables_capped: z.ZodBoolean;
1675
+ }, "strip", z.ZodTypeAny, {
1676
+ max_actionables: number;
1677
+ actionables_capped: boolean;
1678
+ }, {
1679
+ max_actionables: number;
1680
+ actionables_capped: boolean;
1681
+ }>;
1682
+ atoms: z.ZodObject<{
1683
+ viewport: z.ZodObject<{
1684
+ w: z.ZodNumber;
1685
+ h: z.ZodNumber;
1686
+ dpr: z.ZodNumber;
1687
+ }, "strip", z.ZodTypeAny, {
1688
+ w: number;
1689
+ h: number;
1690
+ dpr: number;
1691
+ }, {
1692
+ w: number;
1693
+ h: number;
1694
+ dpr: number;
1695
+ }>;
1696
+ scroll: z.ZodObject<{
1697
+ x: z.ZodNumber;
1698
+ y: z.ZodNumber;
1699
+ }, "strip", z.ZodTypeAny, {
1700
+ x: number;
1701
+ y: number;
1702
+ }, {
1703
+ x: number;
1704
+ y: number;
1705
+ }>;
1706
+ loading: z.ZodOptional<z.ZodObject<{
1707
+ network_busy: z.ZodBoolean;
1708
+ spinners: z.ZodNumber;
1709
+ progress: z.ZodOptional<z.ZodNumber>;
1710
+ }, "strip", z.ZodTypeAny, {
1711
+ network_busy: boolean;
1712
+ spinners: number;
1713
+ progress?: number | undefined;
1714
+ }, {
1715
+ network_busy: boolean;
1716
+ spinners: number;
1717
+ progress?: number | undefined;
1718
+ }>>;
1719
+ forms: z.ZodOptional<z.ZodObject<{
1720
+ dirty: z.ZodBoolean;
1721
+ focused_field: z.ZodOptional<z.ZodString>;
1722
+ validation_errors: z.ZodNumber;
1723
+ }, "strip", z.ZodTypeAny, {
1724
+ dirty: boolean;
1725
+ validation_errors: number;
1726
+ focused_field?: string | undefined;
1727
+ }, {
1728
+ dirty: boolean;
1729
+ validation_errors: number;
1730
+ focused_field?: string | undefined;
1731
+ }>>;
1732
+ notifications: z.ZodOptional<z.ZodObject<{
1733
+ toasts: z.ZodNumber;
1734
+ banners: z.ZodNumber;
1735
+ }, "strip", z.ZodTypeAny, {
1736
+ toasts: number;
1737
+ banners: number;
1738
+ }, {
1739
+ toasts: number;
1740
+ banners: number;
1741
+ }>>;
1742
+ }, "strip", z.ZodTypeAny, {
1743
+ viewport: {
1744
+ w: number;
1745
+ h: number;
1746
+ dpr: number;
1747
+ };
1748
+ scroll: {
1749
+ x: number;
1750
+ y: number;
1751
+ };
1752
+ notifications?: {
1753
+ toasts: number;
1754
+ banners: number;
1755
+ } | undefined;
1756
+ loading?: {
1757
+ network_busy: boolean;
1758
+ spinners: number;
1759
+ progress?: number | undefined;
1760
+ } | undefined;
1761
+ forms?: {
1762
+ dirty: boolean;
1763
+ validation_errors: number;
1764
+ focused_field?: string | undefined;
1765
+ } | undefined;
1766
+ }, {
1767
+ viewport: {
1768
+ w: number;
1769
+ h: number;
1770
+ dpr: number;
1771
+ };
1772
+ scroll: {
1773
+ x: number;
1774
+ y: number;
1775
+ };
1776
+ notifications?: {
1777
+ toasts: number;
1778
+ banners: number;
1779
+ } | undefined;
1780
+ loading?: {
1781
+ network_busy: boolean;
1782
+ spinners: number;
1783
+ progress?: number | undefined;
1784
+ } | undefined;
1785
+ forms?: {
1786
+ dirty: boolean;
1787
+ validation_errors: number;
1788
+ focused_field?: string | undefined;
1789
+ } | undefined;
1790
+ }>;
1791
+ tokens: z.ZodNumber;
1792
+ }, "strip", z.ZodTypeAny, {
1793
+ diff: {
1794
+ reason: "error" | "navigation" | "first";
1795
+ mode: "baseline";
1796
+ error?: string | undefined;
1797
+ } | {
1798
+ diff: {
1799
+ actionables: {
1800
+ added: string[];
1801
+ removed: string[];
1802
+ changed: {
1803
+ eid: string;
1804
+ k: string;
1805
+ from?: unknown;
1806
+ to?: unknown;
1807
+ }[];
1808
+ };
1809
+ atoms: {
1810
+ k: string;
1811
+ from?: unknown;
1812
+ to?: unknown;
1813
+ }[];
1814
+ layer?: {
1815
+ stack_from: string[];
1816
+ stack_to: string[];
1817
+ } | undefined;
1818
+ doc?: {
1819
+ nav_type: "soft" | "hard";
1820
+ from: {
1821
+ url: string;
1822
+ title: string;
1823
+ };
1824
+ to: {
1825
+ url: string;
1826
+ title: string;
1827
+ };
1828
+ } | undefined;
1829
+ };
1830
+ mode: "diff";
1831
+ };
1832
+ state: {
1833
+ layer: {
1834
+ stack: string[];
1835
+ active: "main" | "modal" | "drawer" | "popover";
1836
+ pointer_lock: boolean;
1837
+ focus_eid?: string | undefined;
1838
+ };
1839
+ sid: string;
1840
+ step: number;
1841
+ doc: {
1842
+ url: string;
1843
+ title: string;
1844
+ origin: string;
1845
+ doc_id: string;
1846
+ nav_type: "soft" | "hard";
1847
+ history_idx: number;
1848
+ };
1849
+ timing: {
1850
+ ts: string;
1851
+ dom_ready: boolean;
1852
+ network_busy: boolean;
1853
+ };
1854
+ hash: {
1855
+ layer: string;
1856
+ ui: string;
1857
+ };
1858
+ };
1859
+ actionables: {
1860
+ name: string;
1861
+ role: string;
1862
+ eid: string;
1863
+ kind: string;
1864
+ vis: boolean;
1865
+ ena: boolean;
1866
+ ref: {
1867
+ snapshot_id: string;
1868
+ backend_node_id: number;
1869
+ frame_id?: string | undefined;
1870
+ loader_id?: string | undefined;
1871
+ };
1872
+ loc: {
1873
+ preferred: {
1874
+ ax: string;
1875
+ };
1876
+ fallback?: {
1877
+ css: string;
1878
+ } | undefined;
1879
+ };
1880
+ ctx: {
1881
+ layer: string;
1882
+ group?: string | undefined;
1883
+ };
1884
+ type?: string | undefined;
1885
+ placeholder?: string | undefined;
1886
+ href?: string | undefined;
1887
+ chk?: boolean | undefined;
1888
+ sel?: boolean | undefined;
1889
+ exp?: boolean | undefined;
1890
+ foc?: boolean | undefined;
1891
+ req?: boolean | undefined;
1892
+ inv?: boolean | undefined;
1893
+ rdo?: boolean | undefined;
1894
+ val_hint?: string | undefined;
1895
+ }[];
1896
+ atoms: {
1897
+ viewport: {
1898
+ w: number;
1899
+ h: number;
1900
+ dpr: number;
1901
+ };
1902
+ scroll: {
1903
+ x: number;
1904
+ y: number;
1905
+ };
1906
+ notifications?: {
1907
+ toasts: number;
1908
+ banners: number;
1909
+ } | undefined;
1910
+ loading?: {
1911
+ network_busy: boolean;
1912
+ spinners: number;
1913
+ progress?: number | undefined;
1914
+ } | undefined;
1915
+ forms?: {
1916
+ dirty: boolean;
1917
+ validation_errors: number;
1918
+ focused_field?: string | undefined;
1919
+ } | undefined;
1920
+ };
1921
+ counts: {
1922
+ shown: number;
1923
+ total_in_layer: number;
1924
+ };
1925
+ limits: {
1926
+ max_actionables: number;
1927
+ actionables_capped: boolean;
1928
+ };
1929
+ tokens: number;
1930
+ }, {
1931
+ diff: {
1932
+ reason: "error" | "navigation" | "first";
1933
+ mode: "baseline";
1934
+ error?: string | undefined;
1935
+ } | {
1936
+ diff: {
1937
+ actionables: {
1938
+ added: string[];
1939
+ removed: string[];
1940
+ changed: {
1941
+ eid: string;
1942
+ k: string;
1943
+ from?: unknown;
1944
+ to?: unknown;
1945
+ }[];
1946
+ };
1947
+ atoms: {
1948
+ k: string;
1949
+ from?: unknown;
1950
+ to?: unknown;
1951
+ }[];
1952
+ layer?: {
1953
+ stack_from: string[];
1954
+ stack_to: string[];
1955
+ } | undefined;
1956
+ doc?: {
1957
+ nav_type: "soft" | "hard";
1958
+ from: {
1959
+ url: string;
1960
+ title: string;
1961
+ };
1962
+ to: {
1963
+ url: string;
1964
+ title: string;
1965
+ };
1966
+ } | undefined;
1967
+ };
1968
+ mode: "diff";
1969
+ };
1970
+ state: {
1971
+ layer: {
1972
+ stack: string[];
1973
+ active: "main" | "modal" | "drawer" | "popover";
1974
+ pointer_lock: boolean;
1975
+ focus_eid?: string | undefined;
1976
+ };
1977
+ sid: string;
1978
+ step: number;
1979
+ doc: {
1980
+ url: string;
1981
+ title: string;
1982
+ origin: string;
1983
+ doc_id: string;
1984
+ nav_type: "soft" | "hard";
1985
+ history_idx: number;
1986
+ };
1987
+ timing: {
1988
+ ts: string;
1989
+ dom_ready: boolean;
1990
+ network_busy: boolean;
1991
+ };
1992
+ hash: {
1993
+ layer: string;
1994
+ ui: string;
1995
+ };
1996
+ };
1997
+ actionables: {
1998
+ name: string;
1999
+ role: string;
2000
+ eid: string;
2001
+ kind: string;
2002
+ vis: boolean;
2003
+ ena: boolean;
2004
+ ref: {
2005
+ snapshot_id: string;
2006
+ backend_node_id: number;
2007
+ frame_id?: string | undefined;
2008
+ loader_id?: string | undefined;
2009
+ };
2010
+ loc: {
2011
+ preferred: {
2012
+ ax: string;
2013
+ };
2014
+ fallback?: {
2015
+ css: string;
2016
+ } | undefined;
2017
+ };
2018
+ ctx: {
2019
+ layer: string;
2020
+ group?: string | undefined;
2021
+ };
2022
+ type?: string | undefined;
2023
+ placeholder?: string | undefined;
2024
+ href?: string | undefined;
2025
+ chk?: boolean | undefined;
2026
+ sel?: boolean | undefined;
2027
+ exp?: boolean | undefined;
2028
+ foc?: boolean | undefined;
2029
+ req?: boolean | undefined;
2030
+ inv?: boolean | undefined;
2031
+ rdo?: boolean | undefined;
2032
+ val_hint?: string | undefined;
2033
+ }[];
2034
+ atoms: {
2035
+ viewport: {
2036
+ w: number;
2037
+ h: number;
2038
+ dpr: number;
2039
+ };
2040
+ scroll: {
2041
+ x: number;
2042
+ y: number;
2043
+ };
2044
+ notifications?: {
2045
+ toasts: number;
2046
+ banners: number;
2047
+ } | undefined;
2048
+ loading?: {
2049
+ network_busy: boolean;
2050
+ spinners: number;
2051
+ progress?: number | undefined;
2052
+ } | undefined;
2053
+ forms?: {
2054
+ dirty: boolean;
2055
+ validation_errors: number;
2056
+ focused_field?: string | undefined;
2057
+ } | undefined;
2058
+ };
2059
+ counts: {
2060
+ shown: number;
2061
+ total_in_layer: number;
2062
+ };
2063
+ limits: {
2064
+ max_actionables: number;
2065
+ actionables_capped: boolean;
2066
+ };
2067
+ tokens: number;
2068
+ }>;
2069
+ export type StateResponseObject = z.infer<typeof StateResponseObjectSchema>;
2070
+ /**
2071
+ * State response - returned after every action as a dense XML string.
2072
+ *
2073
+ * This is the NEW response format that replaces page_summary.
2074
+ * It's rendered as XML for maximum LLM context efficiency.
2075
+ * Contains:
2076
+ * - StateHandle: Current state metadata
2077
+ * - Diff: Incremental changes since last action (or baseline)
2078
+ * - Actionables: Capped list of interactive elements from active layer
2079
+ * - Atoms: Universal UI state facts
2080
+ */
2081
+ export declare const StateResponseSchema: z.ZodString;
2082
+ export type StateResponse = z.infer<typeof StateResponseSchema>;
2083
+ /**
2084
+ * Click outcome - result of a click action with navigation awareness.
2085
+ * Differentiates between "element gone due to navigation" vs "element stale due to DOM mutation".
2086
+ */
2087
+ export declare const ClickOutcomeSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
2088
+ status: z.ZodLiteral<"success">;
2089
+ /** Whether the click triggered a page navigation */
2090
+ navigated: z.ZodBoolean;
2091
+ }, "strip", z.ZodTypeAny, {
2092
+ status: "success";
2093
+ navigated: boolean;
2094
+ }, {
2095
+ status: "success";
2096
+ navigated: boolean;
2097
+ }>, z.ZodObject<{
2098
+ status: z.ZodLiteral<"stale_element">;
2099
+ /** Why the element became stale */
2100
+ reason: z.ZodEnum<["dom_mutation", "navigation"]>;
2101
+ /** Whether retry was attempted */
2102
+ retried: z.ZodBoolean;
2103
+ }, "strip", z.ZodTypeAny, {
2104
+ status: "stale_element";
2105
+ reason: "navigation" | "dom_mutation";
2106
+ retried: boolean;
2107
+ }, {
2108
+ status: "stale_element";
2109
+ reason: "navigation" | "dom_mutation";
2110
+ retried: boolean;
2111
+ }>, z.ZodObject<{
2112
+ status: z.ZodLiteral<"element_not_found">;
2113
+ /** The eid that wasn't found */
2114
+ eid: z.ZodString;
2115
+ /** Last known label for debugging */
2116
+ last_known_label: z.ZodOptional<z.ZodString>;
2117
+ }, "strip", z.ZodTypeAny, {
2118
+ status: "element_not_found";
2119
+ eid: string;
2120
+ last_known_label?: string | undefined;
2121
+ }, {
2122
+ status: "element_not_found";
2123
+ eid: string;
2124
+ last_known_label?: string | undefined;
2125
+ }>, z.ZodObject<{
2126
+ status: z.ZodLiteral<"error">;
2127
+ /** Error message */
2128
+ message: z.ZodString;
2129
+ }, "strip", z.ZodTypeAny, {
2130
+ message: string;
2131
+ status: "error";
2132
+ }, {
2133
+ message: string;
2134
+ status: "error";
2135
+ }>]>;
2136
+ export type ClickOutcome = z.infer<typeof ClickOutcomeSchema>;
2137
+ export declare const ListPagesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
2138
+ /** Returns XML result string */
2139
+ export declare const ListPagesOutputSchema: z.ZodString;
2140
+ export type ListPagesInput = z.infer<typeof ListPagesInputSchema>;
2141
+ export type ListPagesOutput = z.infer<typeof ListPagesOutputSchema>;
2142
+ export declare const ClosePageInputSchema: z.ZodObject<{
2143
+ /** Page ID to close */
2144
+ page_id: z.ZodString;
2145
+ }, "strip", z.ZodTypeAny, {
2146
+ page_id: string;
2147
+ }, {
2148
+ page_id: string;
2149
+ }>;
2150
+ /** Returns XML result string */
2151
+ export declare const ClosePageOutputSchema: z.ZodString;
2152
+ export type ClosePageInput = z.infer<typeof ClosePageInputSchema>;
2153
+ export type ClosePageOutput = z.infer<typeof ClosePageOutputSchema>;
2154
+ export declare const CloseSessionInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
2155
+ /** Returns XML result string */
2156
+ export declare const CloseSessionOutputSchema: z.ZodString;
2157
+ export type CloseSessionInput = z.infer<typeof CloseSessionInputSchema>;
2158
+ export type CloseSessionOutput = z.infer<typeof CloseSessionOutputSchema>;
2159
+ export declare const NavigateInputSchema: z.ZodObject<{
2160
+ /** URL to navigate to */
2161
+ url: z.ZodString;
2162
+ /** Page ID. If omitted, operates on the most recently used page */
2163
+ page_id: z.ZodOptional<z.ZodString>;
2164
+ }, "strip", z.ZodTypeAny, {
2165
+ url: string;
2166
+ page_id?: string | undefined;
2167
+ }, {
2168
+ url: string;
2169
+ page_id?: string | undefined;
2170
+ }>;
2171
+ /** Returns XML state response string directly */
2172
+ export declare const NavigateOutputSchema: z.ZodString;
2173
+ export type NavigateInput = z.infer<typeof NavigateInputSchema>;
2174
+ export type NavigateOutput = z.infer<typeof NavigateOutputSchema>;
2175
+ export declare const GoBackInputSchema: z.ZodObject<{
2176
+ /** Page ID. If omitted, operates on the most recently used page */
2177
+ page_id: z.ZodOptional<z.ZodString>;
2178
+ }, "strip", z.ZodTypeAny, {
2179
+ page_id?: string | undefined;
2180
+ }, {
2181
+ page_id?: string | undefined;
2182
+ }>;
2183
+ /** Returns XML state response string directly */
2184
+ export declare const GoBackOutputSchema: z.ZodString;
2185
+ export type GoBackInput = z.infer<typeof GoBackInputSchema>;
2186
+ export type GoBackOutput = z.infer<typeof GoBackOutputSchema>;
2187
+ export declare const GoForwardInputSchema: z.ZodObject<{
2188
+ /** Page ID. If omitted, operates on the most recently used page */
2189
+ page_id: z.ZodOptional<z.ZodString>;
2190
+ }, "strip", z.ZodTypeAny, {
2191
+ page_id?: string | undefined;
2192
+ }, {
2193
+ page_id?: string | undefined;
2194
+ }>;
2195
+ /** Returns XML state response string directly */
2196
+ export declare const GoForwardOutputSchema: z.ZodString;
2197
+ export type GoForwardInput = z.infer<typeof GoForwardInputSchema>;
2198
+ export type GoForwardOutput = z.infer<typeof GoForwardOutputSchema>;
2199
+ export declare const ReloadInputSchema: z.ZodObject<{
2200
+ /** Page ID. If omitted, operates on the most recently used page */
2201
+ page_id: z.ZodOptional<z.ZodString>;
2202
+ }, "strip", z.ZodTypeAny, {
2203
+ page_id?: string | undefined;
2204
+ }, {
2205
+ page_id?: string | undefined;
2206
+ }>;
2207
+ /** Returns XML state response string directly */
2208
+ export declare const ReloadOutputSchema: z.ZodString;
2209
+ export type ReloadInput = z.infer<typeof ReloadInputSchema>;
2210
+ export type ReloadOutput = z.infer<typeof ReloadOutputSchema>;
2211
+ export declare const CaptureSnapshotInputSchema: z.ZodObject<{
2212
+ /** Page ID. If omitted, operates on the most recently used page */
2213
+ page_id: z.ZodOptional<z.ZodString>;
2214
+ }, "strip", z.ZodTypeAny, {
2215
+ page_id?: string | undefined;
2216
+ }, {
2217
+ page_id?: string | undefined;
2218
+ }>;
2219
+ /** Returns XML state response string directly */
2220
+ export declare const CaptureSnapshotOutputSchema: z.ZodString;
2221
+ export type CaptureSnapshotInput = z.infer<typeof CaptureSnapshotInputSchema>;
2222
+ export type CaptureSnapshotOutput = z.infer<typeof CaptureSnapshotOutputSchema>;
2223
+ export declare const FindElementsInputSchema: z.ZodObject<{
2224
+ /** Page ID. If omitted, operates on the most recently used page */
2225
+ page_id: z.ZodOptional<z.ZodString>;
2226
+ /** Filter by element type. */
2227
+ kind: z.ZodOptional<z.ZodEnum<["button", "link", "radio", "checkbox", "textbox", "combobox", "image", "heading"]>>;
2228
+ /** Search text to match against element labels. */
2229
+ label: z.ZodOptional<z.ZodString>;
2230
+ /** Restrict search to a specific area. */
2231
+ region: z.ZodOptional<z.ZodEnum<["main", "nav", "header", "footer"]>>;
2232
+ /** Maximum number of results (default: 10) */
2233
+ limit: z.ZodDefault<z.ZodNumber>;
2234
+ /** Include readable content with semantic IDs in results. */
2235
+ include_readable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
2236
+ }, "strip", z.ZodTypeAny, {
2237
+ limit: number;
2238
+ page_id?: string | undefined;
2239
+ region?: "header" | "nav" | "main" | "footer" | undefined;
2240
+ kind?: "image" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "textbox" | undefined;
2241
+ label?: string | undefined;
2242
+ include_readable?: boolean | undefined;
2243
+ }, {
2244
+ page_id?: string | undefined;
2245
+ region?: "header" | "nav" | "main" | "footer" | undefined;
2246
+ kind?: "image" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "textbox" | undefined;
2247
+ label?: string | undefined;
2248
+ limit?: number | undefined;
2249
+ include_readable?: boolean | undefined;
2250
+ }>;
2251
+ /** Returns XML result string */
2252
+ export declare const FindElementsOutputSchema: z.ZodString;
2253
+ export type FindElementsInput = z.infer<typeof FindElementsInputSchema>;
2254
+ export type FindElementsOutput = z.infer<typeof FindElementsOutputSchema>;
2255
+ export declare const GetNodeDetailsInputSchema: z.ZodObject<{
2256
+ /** Stable element ID (eid) to get details for */
2257
+ eid: z.ZodString;
2258
+ /** Page ID. If omitted, operates on the most recently used page */
2259
+ page_id: z.ZodOptional<z.ZodString>;
2260
+ }, "strip", z.ZodTypeAny, {
2261
+ eid: string;
2262
+ page_id?: string | undefined;
2263
+ }, {
2264
+ eid: string;
2265
+ page_id?: string | undefined;
2266
+ }>;
2267
+ /** Returns XML result string */
2268
+ export declare const GetNodeDetailsOutputSchema: z.ZodString;
2269
+ export type GetNodeDetailsInput = z.infer<typeof GetNodeDetailsInputSchema>;
2270
+ export type GetNodeDetailsOutput = z.infer<typeof GetNodeDetailsOutputSchema>;
2271
+ declare const ScrollElementIntoViewInputSchemaBase: z.ZodObject<{
2272
+ /** Stable element ID from find_elements or snapshot */
2273
+ eid: z.ZodString;
2274
+ /** Page ID. If omitted, operates on the most recently used page */
2275
+ page_id: z.ZodOptional<z.ZodString>;
2276
+ }, "strip", z.ZodTypeAny, {
2277
+ eid: string;
2278
+ page_id?: string | undefined;
2279
+ }, {
2280
+ eid: string;
2281
+ page_id?: string | undefined;
2282
+ }>;
2283
+ export declare const ScrollElementIntoViewInputSchema: z.ZodObject<{
2284
+ /** Stable element ID from find_elements or snapshot */
2285
+ eid: z.ZodString;
2286
+ /** Page ID. If omitted, operates on the most recently used page */
2287
+ page_id: z.ZodOptional<z.ZodString>;
2288
+ }, "strip", z.ZodTypeAny, {
2289
+ eid: string;
2290
+ page_id?: string | undefined;
2291
+ }, {
2292
+ eid: string;
2293
+ page_id?: string | undefined;
2294
+ }>;
2295
+ export { ScrollElementIntoViewInputSchemaBase };
2296
+ /** Returns XML state response string directly */
2297
+ export declare const ScrollElementIntoViewOutputSchema: z.ZodString;
2298
+ export type ScrollElementIntoViewInput = z.infer<typeof ScrollElementIntoViewInputSchema>;
2299
+ export type ScrollElementIntoViewOutput = z.infer<typeof ScrollElementIntoViewOutputSchema>;
2300
+ export declare const ScrollPageInputSchema: z.ZodObject<{
2301
+ /** Scroll direction */
2302
+ direction: z.ZodEnum<["up", "down"]>;
2303
+ /** Scroll amount in pixels (default: 500) */
2304
+ amount: z.ZodDefault<z.ZodNumber>;
2305
+ /** Page ID. If omitted, operates on the most recently used page */
2306
+ page_id: z.ZodOptional<z.ZodString>;
2307
+ }, "strip", z.ZodTypeAny, {
2308
+ direction: "up" | "down";
2309
+ amount: number;
2310
+ page_id?: string | undefined;
2311
+ }, {
2312
+ direction: "up" | "down";
2313
+ page_id?: string | undefined;
2314
+ amount?: number | undefined;
2315
+ }>;
2316
+ /** Returns XML state response string directly */
2317
+ export declare const ScrollPageOutputSchema: z.ZodString;
2318
+ export type ScrollPageInput = z.infer<typeof ScrollPageInputSchema>;
2319
+ export type ScrollPageOutput = z.infer<typeof ScrollPageOutputSchema>;
2320
+ /** Supported keyboard keys */
2321
+ export declare const SupportedKeys: readonly ["Enter", "Tab", "Escape", "Backspace", "Delete", "Space", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"];
2322
+ declare const ClickInputSchemaBase: z.ZodObject<{
2323
+ /** Page ID. If omitted, operates on the most recently used page */
2324
+ page_id: z.ZodOptional<z.ZodString>;
2325
+ /** Stable element ID from find_elements or snapshot */
2326
+ eid: z.ZodString;
2327
+ }, "strip", z.ZodTypeAny, {
2328
+ eid: string;
2329
+ page_id?: string | undefined;
2330
+ }, {
2331
+ eid: string;
2332
+ page_id?: string | undefined;
2333
+ }>;
2334
+ export declare const ClickInputSchema: z.ZodObject<{
2335
+ /** Page ID. If omitted, operates on the most recently used page */
2336
+ page_id: z.ZodOptional<z.ZodString>;
2337
+ /** Stable element ID from find_elements or snapshot */
2338
+ eid: z.ZodString;
2339
+ }, "strip", z.ZodTypeAny, {
2340
+ eid: string;
2341
+ page_id?: string | undefined;
2342
+ }, {
2343
+ eid: string;
2344
+ page_id?: string | undefined;
2345
+ }>;
2346
+ export { ClickInputSchemaBase };
2347
+ /** Returns XML state response string directly */
2348
+ export declare const ClickOutputSchema: z.ZodString;
2349
+ export type ClickInput = z.infer<typeof ClickInputSchema>;
2350
+ export type ClickOutput = z.infer<typeof ClickOutputSchema>;
2351
+ declare const TypeInputSchemaBase: z.ZodObject<{
2352
+ /** Text to type */
2353
+ text: z.ZodString;
2354
+ /** Stable element ID from find_elements or snapshot */
2355
+ eid: z.ZodString;
2356
+ /** Clear existing text before typing (default: false) */
2357
+ clear: z.ZodDefault<z.ZodBoolean>;
2358
+ /** Page ID. If omitted, operates on the most recently used page */
2359
+ page_id: z.ZodOptional<z.ZodString>;
2360
+ }, "strip", z.ZodTypeAny, {
2361
+ text: string;
2362
+ eid: string;
2363
+ clear: boolean;
2364
+ page_id?: string | undefined;
2365
+ }, {
2366
+ text: string;
2367
+ eid: string;
2368
+ page_id?: string | undefined;
2369
+ clear?: boolean | undefined;
2370
+ }>;
2371
+ export declare const TypeInputSchema: z.ZodObject<{
2372
+ /** Text to type */
2373
+ text: z.ZodString;
2374
+ /** Stable element ID from find_elements or snapshot */
2375
+ eid: z.ZodString;
2376
+ /** Clear existing text before typing (default: false) */
2377
+ clear: z.ZodDefault<z.ZodBoolean>;
2378
+ /** Page ID. If omitted, operates on the most recently used page */
2379
+ page_id: z.ZodOptional<z.ZodString>;
2380
+ }, "strip", z.ZodTypeAny, {
2381
+ text: string;
2382
+ eid: string;
2383
+ clear: boolean;
2384
+ page_id?: string | undefined;
2385
+ }, {
2386
+ text: string;
2387
+ eid: string;
2388
+ page_id?: string | undefined;
2389
+ clear?: boolean | undefined;
2390
+ }>;
2391
+ export { TypeInputSchemaBase };
2392
+ /** Returns XML state response string directly */
2393
+ export declare const TypeOutputSchema: z.ZodString;
2394
+ export type TypeInput = z.infer<typeof TypeInputSchema>;
2395
+ export type TypeOutput = z.infer<typeof TypeOutputSchema>;
2396
+ export declare const PressInputSchema: z.ZodObject<{
2397
+ /** Key to press */
2398
+ key: z.ZodEnum<["Enter", "Tab", "Escape", "Backspace", "Delete", "Space", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"]>;
2399
+ /** Modifier keys to hold (Control, Shift, Alt, Meta) */
2400
+ modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<["Control", "Shift", "Alt", "Meta"]>, "many">>;
2401
+ /** Page ID. If omitted, operates on the most recently used page */
2402
+ page_id: z.ZodOptional<z.ZodString>;
2403
+ }, "strip", z.ZodTypeAny, {
2404
+ key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "Space" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown";
2405
+ page_id?: string | undefined;
2406
+ modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
2407
+ }, {
2408
+ key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "Space" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown";
2409
+ page_id?: string | undefined;
2410
+ modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
2411
+ }>;
2412
+ /** Returns XML state response string directly */
2413
+ export declare const PressOutputSchema: z.ZodString;
2414
+ export type PressInput = z.infer<typeof PressInputSchema>;
2415
+ export type PressOutput = z.infer<typeof PressOutputSchema>;
2416
+ declare const SelectInputSchemaBase: z.ZodObject<{
2417
+ /** Stable element ID from find_elements or snapshot */
2418
+ eid: z.ZodString;
2419
+ /** Option value or visible text to select */
2420
+ value: z.ZodString;
2421
+ /** Page ID. If omitted, operates on the most recently used page */
2422
+ page_id: z.ZodOptional<z.ZodString>;
2423
+ }, "strip", z.ZodTypeAny, {
2424
+ value: string;
2425
+ eid: string;
2426
+ page_id?: string | undefined;
2427
+ }, {
2428
+ value: string;
2429
+ eid: string;
2430
+ page_id?: string | undefined;
2431
+ }>;
2432
+ export declare const SelectInputSchema: z.ZodObject<{
2433
+ /** Stable element ID from find_elements or snapshot */
2434
+ eid: z.ZodString;
2435
+ /** Option value or visible text to select */
2436
+ value: z.ZodString;
2437
+ /** Page ID. If omitted, operates on the most recently used page */
2438
+ page_id: z.ZodOptional<z.ZodString>;
2439
+ }, "strip", z.ZodTypeAny, {
2440
+ value: string;
2441
+ eid: string;
2442
+ page_id?: string | undefined;
2443
+ }, {
2444
+ value: string;
2445
+ eid: string;
2446
+ page_id?: string | undefined;
2447
+ }>;
2448
+ export { SelectInputSchemaBase };
2449
+ /** Returns XML state response string directly */
2450
+ export declare const SelectOutputSchema: z.ZodString;
2451
+ export type SelectInput = z.infer<typeof SelectInputSchema>;
2452
+ export type SelectOutput = z.infer<typeof SelectOutputSchema>;
2453
+ declare const HoverInputSchemaBase: z.ZodObject<{
2454
+ /** Stable element ID from find_elements or snapshot */
2455
+ eid: z.ZodString;
2456
+ /** Page ID. If omitted, operates on the most recently used page */
2457
+ page_id: z.ZodOptional<z.ZodString>;
2458
+ }, "strip", z.ZodTypeAny, {
2459
+ eid: string;
2460
+ page_id?: string | undefined;
2461
+ }, {
2462
+ eid: string;
2463
+ page_id?: string | undefined;
2464
+ }>;
2465
+ export declare const HoverInputSchema: z.ZodObject<{
2466
+ /** Stable element ID from find_elements or snapshot */
2467
+ eid: z.ZodString;
2468
+ /** Page ID. If omitted, operates on the most recently used page */
2469
+ page_id: z.ZodOptional<z.ZodString>;
2470
+ }, "strip", z.ZodTypeAny, {
2471
+ eid: string;
2472
+ page_id?: string | undefined;
2473
+ }, {
2474
+ eid: string;
2475
+ page_id?: string | undefined;
2476
+ }>;
2477
+ export { HoverInputSchemaBase };
2478
+ /** Returns XML state response string directly */
2479
+ export declare const HoverOutputSchema: z.ZodString;
2480
+ export type HoverInput = z.infer<typeof HoverInputSchema>;
2481
+ export type HoverOutput = z.infer<typeof HoverOutputSchema>;
2482
+ //# sourceMappingURL=tool-schemas.d.ts.map