taphound 0.2.0-dev.1 → 0.2.0-dev.11

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 (447) hide show
  1. package/README.md +49 -149
  2. package/README.zh-CN.md +47 -147
  3. package/assets/skills/taphound-case-suite/SKILL.md +363 -0
  4. package/assets/skills/taphound-case-suite/schemas/base-flow-record.schema.json +22 -0
  5. package/assets/skills/taphound-case-suite/schemas/case-catalog.schema.json +26 -0
  6. package/assets/skills/taphound-case-suite/schemas/case-ledger.schema.json +158 -0
  7. package/assets/skills/taphound-case-suite/schemas/suite-input.schema.json +41 -0
  8. package/assets/skills/taphound-case-suite/schemas/transition.schema.json +61 -0
  9. package/assets/skills/taphound-case-suite/scripts/ledger.mjs +1207 -0
  10. package/assets/skills/taphound-case-suite/templates/base-flow-record.example.json +20 -0
  11. package/assets/skills/taphound-case-suite/templates/suite-input.example.json +27 -0
  12. package/assets/skills/taphound-case-suite/templates/transition.example.json +8 -0
  13. package/assets/skills/taphound-flash/SKILL.md +115 -0
  14. package/assets/skills/taphound-flash/scripts/flash.mjs +585 -0
  15. package/assets/skills/taphound-flash/templates/flash-plan.example.json +15 -0
  16. package/assets/skills/taphound-journey-brief-author/CONTEXT-GUIDE.md +471 -0
  17. package/assets/skills/taphound-journey-brief-author/SKILL.md +494 -0
  18. package/assets/skills/taphound-journey-brief-author/prompts/brief-author-role.md +96 -0
  19. package/assets/skills/taphound-journey-brief-author/prompts/brief-author-role.zh-CN.md +80 -0
  20. package/assets/skills/taphound-journey-brief-author/prompts/context-analyze-project.md +309 -0
  21. package/assets/skills/taphound-journey-brief-author/schemas/context-refresh-result.json +123 -0
  22. package/assets/skills/taphound-journey-brief-author/schemas/project-context-module.json +192 -0
  23. package/assets/skills/taphound-journey-brief-author/schemas/project-context.json +152 -0
  24. package/assets/skills/taphound-journey-brief-author/templates/project-context-module.example.json +58 -0
  25. package/assets/skills/taphound-journey-brief-author/templates/project-context.example.json +51 -0
  26. package/assets/skills/taphound-journey-brief-author/templates/taphound-journey-brief.template.md +63 -0
  27. package/assets/skills/taphound-journey-generator/SKILL.md +500 -0
  28. package/assets/skills/{taphound-ai-journey → taphound-journey-generator}/prompts/check-completion.md +3 -0
  29. package/assets/skills/taphound-journey-generator/prompts/consume-journey-brief.md +52 -0
  30. package/assets/skills/taphound-journey-generator/prompts/generate-step.md +211 -0
  31. package/assets/skills/taphound-journey-generator/prompts/select-flow.md +91 -0
  32. package/assets/skills/taphound-journey-generator/references/bridge.md +35 -0
  33. package/assets/skills/taphound-journey-generator/references/mid-session.md +44 -0
  34. package/assets/skills/taphound-journey-generator/schemas/external-flow.json +37 -0
  35. package/assets/skills/taphound-journey-generator/schemas/flow.json +28 -0
  36. package/assets/skills/taphound-journey-generator/schemas/journey-source.json +25 -0
  37. package/assets/skills/{taphound-ai-journey → taphound-journey-generator}/schemas/observe-output.json +13 -4
  38. package/assets/skills/{taphound-ai-journey → taphound-journey-generator}/schemas/proposed-step-envelope.json +127 -5
  39. package/assets/skills/taphound-journey-generator/scripts/envelope.mjs +561 -0
  40. package/assets/skills/taphound-journey-generator/templates/external-flow.example.json +22 -0
  41. package/assets/skills/taphound-journey-generator/templates/flow.example.json +22 -0
  42. package/assets/skills/taphound-journey-generator/templates/journey-source.example.json +17 -0
  43. package/assets/skills/taphound-journey-generator/templates/taphound-journey-brief.example.md +70 -0
  44. package/assets/skills/taphound-verify-change/SKILL.md +91 -0
  45. package/assets/skills/taphound-verify-change/references/accept.md +38 -0
  46. package/assets/skills/taphound-verify-change/references/preserve.md +349 -0
  47. package/assets/skills/taphound-verify-change/schemas/workflow-manifest.schema.json +295 -0
  48. package/assets/skills/taphound-verify-change/scripts/handoff.mjs +482 -0
  49. package/assets/skills/taphound-verify-change/scripts/ui-refactor.mjs +505 -0
  50. package/dist/adapters/adb/adb-adapter.d.ts +16 -2
  51. package/dist/adapters/adb/adb-adapter.js +199 -0
  52. package/dist/adapters/adb/system-uiautomator-snapshot-provider.d.ts +13 -0
  53. package/dist/adapters/adb/system-uiautomator-snapshot-provider.js +122 -0
  54. package/dist/adapters/adb/ui-automator-parser.d.ts +3 -0
  55. package/dist/adapters/adb/ui-automator-parser.js +160 -0
  56. package/dist/adapters/adb/window-topology-parser.d.ts +2 -0
  57. package/dist/adapters/adb/window-topology-parser.js +101 -0
  58. package/dist/adapters/android-cli/android-cli-adapter.d.ts +16 -8
  59. package/dist/adapters/android-cli/android-cli-adapter.js +137 -15
  60. package/dist/adapters/android-cli/android-cli-snapshot-provider.d.ts +9 -0
  61. package/dist/adapters/android-cli/android-cli-snapshot-provider.js +99 -0
  62. package/dist/adapters/android-cli/layout-parser.js +12 -8
  63. package/dist/adapters/appium/appium-doctor.d.ts +7 -0
  64. package/dist/adapters/appium/appium-doctor.js +128 -0
  65. package/dist/adapters/appium/appium-ui-snapshot-provider.d.ts +34 -0
  66. package/dist/adapters/appium/appium-ui-snapshot-provider.js +240 -0
  67. package/dist/adapters/camera/camera-probe-adapter.d.ts +18 -0
  68. package/dist/adapters/camera/camera-probe-adapter.js +286 -0
  69. package/dist/adapters/filesystem/artifact-store.js +40 -1
  70. package/dist/adapters/filesystem/context-document-writer.d.ts +15 -0
  71. package/dist/adapters/filesystem/context-document-writer.js +112 -0
  72. package/dist/adapters/filesystem/external-flow-registry.d.ts +17 -0
  73. package/dist/adapters/filesystem/external-flow-registry.js +325 -0
  74. package/dist/adapters/filesystem/generation-session-store.d.ts +17 -11
  75. package/dist/adapters/filesystem/generation-session-store.js +281 -855
  76. package/dist/adapters/filesystem/generation-store/session-lock.d.ts +29 -0
  77. package/dist/adapters/filesystem/generation-store/session-lock.js +202 -0
  78. package/dist/adapters/filesystem/generation-store/session-transitions.d.ts +24 -0
  79. package/dist/adapters/filesystem/generation-store/session-transitions.js +340 -0
  80. package/dist/adapters/filesystem/generation-store/store-files.d.ts +50 -0
  81. package/dist/adapters/filesystem/generation-store/store-files.js +363 -0
  82. package/dist/adapters/filesystem/journey-composition-store.d.ts +23 -0
  83. package/dist/adapters/filesystem/journey-composition-store.js +151 -0
  84. package/dist/adapters/filesystem/knowledge-registry.d.ts +12 -0
  85. package/dist/adapters/filesystem/knowledge-registry.js +223 -0
  86. package/dist/adapters/filesystem/project-bound-file.js +3 -5
  87. package/dist/adapters/filesystem/project-file-inspector.d.ts +2 -0
  88. package/dist/adapters/filesystem/project-file-inspector.js +57 -28
  89. package/dist/adapters/filesystem/project-identity-inspector.d.ts +7 -0
  90. package/dist/adapters/filesystem/project-identity-inspector.js +215 -0
  91. package/dist/adapters/filesystem/project-inventory-inspector.d.ts +8 -0
  92. package/dist/adapters/filesystem/project-inventory-inspector.js +93 -0
  93. package/dist/adapters/filesystem/project-module-discoverer.d.ts +6 -0
  94. package/dist/adapters/filesystem/project-module-discoverer.js +158 -0
  95. package/dist/adapters/filesystem/skill-installer.d.ts +7 -2
  96. package/dist/adapters/filesystem/skill-installer.js +40 -11
  97. package/dist/adapters/filesystem/workspace-layout.d.ts +7 -0
  98. package/dist/adapters/filesystem/workspace-layout.js +57 -0
  99. package/dist/adapters/git/node-git-diff.d.ts +17 -0
  100. package/dist/adapters/git/node-git-diff.js +114 -0
  101. package/dist/adapters/process/node-detached-process-launcher.d.ts +6 -0
  102. package/dist/adapters/process/node-detached-process-launcher.js +96 -0
  103. package/dist/adapters/process/node-process-runner.js +11 -2
  104. package/dist/adapters/prompt/inquirer-align-prompt.d.ts +27 -0
  105. package/dist/adapters/prompt/inquirer-align-prompt.js +65 -0
  106. package/dist/adapters/prompt/inquirer-generation-prompt.js +3 -0
  107. package/dist/adapters/prompt/inquirer-recorder-prompt.d.ts +9 -1
  108. package/dist/adapters/prompt/inquirer-recorder-prompt.js +63 -0
  109. package/dist/adapters/runtime/adb-runtime-backend.d.ts +67 -0
  110. package/dist/adapters/runtime/adb-runtime-backend.js +206 -0
  111. package/dist/adapters/runtime/fake-runtime-backend.d.ts +87 -0
  112. package/dist/adapters/runtime/fake-runtime-backend.js +240 -0
  113. package/dist/adapters/runtime/mobile-mcp/mcp-tool-client.d.ts +45 -0
  114. package/dist/adapters/runtime/mobile-mcp/mcp-tool-client.js +153 -0
  115. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-errors.d.ts +23 -0
  116. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-errors.js +39 -0
  117. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-responses.d.ts +20 -0
  118. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-responses.js +180 -0
  119. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-runtime-backend.d.ts +78 -0
  120. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-runtime-backend.js +379 -0
  121. package/dist/adapters/runtime/mobile-mcp/mobile-mcp-tools.d.ts +46 -0
  122. package/dist/adapters/runtime/session-adb-view.d.ts +53 -0
  123. package/dist/adapters/runtime/session-adb-view.js +193 -0
  124. package/dist/adapters/runtime/session-backed-ports.d.ts +21 -0
  125. package/dist/adapters/runtime/session-backed-ports.js +43 -0
  126. package/dist/adapters/runtime/shared-session-runtime-backend.d.ts +12 -0
  127. package/dist/adapters/runtime/shared-session-runtime-backend.js +64 -0
  128. package/dist/adapters/ui/auto-ui-snapshot-provider.d.ts +8 -0
  129. package/dist/adapters/ui/auto-ui-snapshot-provider.js +48 -0
  130. package/dist/adapters/ui/device-layout-temp.d.ts +6 -0
  131. package/dist/adapters/ui/device-layout-temp.js +18 -0
  132. package/dist/adapters/ui/device-ui-environment.d.ts +13 -0
  133. package/dist/adapters/ui/device-ui-environment.js +81 -0
  134. package/dist/adapters/ui/layout-normalization.d.ts +9 -0
  135. package/dist/adapters/ui/layout-normalization.js +44 -0
  136. package/dist/adapters/ui/ui-snapshot-error.d.ts +11 -0
  137. package/dist/adapters/ui/ui-snapshot-error.js +12 -0
  138. package/dist/adapters/ui/ui-snapshot-support.d.ts +15 -0
  139. package/dist/adapters/ui/ui-snapshot-support.js +12 -0
  140. package/dist/application/align/align-service.d.ts +42 -0
  141. package/dist/application/align/align-service.js +106 -0
  142. package/dist/application/assertion/expectation-evaluator.d.ts +18 -5
  143. package/dist/application/assertion/expectation-evaluator.js +156 -18
  144. package/dist/application/assertion/guarded-expectation.d.ts +45 -0
  145. package/dist/application/assertion/guarded-expectation.js +74 -0
  146. package/dist/application/checkpoint/baseline-capturer.d.ts +26 -0
  147. package/dist/application/checkpoint/baseline-capturer.js +163 -0
  148. package/dist/application/checkpoint/baseline-error.d.ts +5 -0
  149. package/dist/application/checkpoint/baseline-error.js +8 -0
  150. package/dist/application/checkpoint/baseline-service.d.ts +31 -0
  151. package/dist/application/checkpoint/baseline-service.js +147 -0
  152. package/dist/application/checkpoint/checkpoint-evaluator.d.ts +35 -0
  153. package/dist/application/checkpoint/checkpoint-evaluator.js +415 -0
  154. package/dist/application/checkpoint/regression-comparator.d.ts +18 -0
  155. package/dist/application/checkpoint/regression-comparator.js +192 -0
  156. package/dist/application/collector/logcat-collector.d.ts +22 -1
  157. package/dist/application/collector/logcat-collector.js +103 -15
  158. package/dist/application/collector/logcat-event.d.ts +8 -0
  159. package/dist/application/collector/logcat-event.js +79 -0
  160. package/dist/application/collector/logcat-stop.d.ts +2 -0
  161. package/dist/application/collector/logcat-stop.js +11 -0
  162. package/dist/application/context/context-generator.d.ts +45 -0
  163. package/dist/application/context/context-generator.js +228 -0
  164. package/dist/application/context/context-loader.d.ts +40 -0
  165. package/dist/application/context/context-loader.js +223 -0
  166. package/dist/application/context/context-refresher.d.ts +59 -0
  167. package/dist/application/context/context-refresher.js +349 -0
  168. package/dist/application/context/context-rehasher.d.ts +36 -0
  169. package/dist/application/context/context-rehasher.js +110 -0
  170. package/dist/application/context/context-validator.d.ts +23 -1
  171. package/dist/application/context/context-validator.js +116 -9
  172. package/dist/application/context/evidence-hash.d.ts +1 -0
  173. package/dist/application/context/evidence-hash.js +125 -0
  174. package/dist/application/context/evidence-match.d.ts +9 -0
  175. package/dist/application/context/evidence-match.js +8 -0
  176. package/dist/application/context/shard-identity.d.ts +2 -0
  177. package/dist/application/context/shard-identity.js +7 -0
  178. package/dist/application/contract/contract-loader.d.ts +25 -0
  179. package/dist/application/contract/contract-loader.js +68 -0
  180. package/dist/application/contract/contract-review.d.ts +25 -0
  181. package/dist/application/contract/contract-review.js +51 -0
  182. package/dist/application/contract/contract-verifier.d.ts +53 -0
  183. package/dist/application/contract/contract-verifier.js +645 -0
  184. package/dist/application/devices/resolve-device-assignments.d.ts +21 -0
  185. package/dist/application/devices/resolve-device-assignments.js +60 -0
  186. package/dist/application/diagnosis/failure-classifier.d.ts +23 -0
  187. package/dist/application/diagnosis/failure-classifier.js +179 -0
  188. package/dist/application/doctor/doctor-service.d.ts +36 -3
  189. package/dist/application/doctor/doctor-service.js +255 -25
  190. package/dist/application/generation/generation-app-preparer.d.ts +20 -0
  191. package/dist/application/generation/generation-app-preparer.js +28 -0
  192. package/dist/application/generation/generation-config-service.d.ts +21 -0
  193. package/dist/application/generation/generation-config-service.js +53 -0
  194. package/dist/application/generation/generation-confirmation-service.d.ts +14 -3
  195. package/dist/application/generation/generation-confirmation-service.js +109 -24
  196. package/dist/application/generation/generation-context-snapshot.d.ts +6 -0
  197. package/dist/application/generation/generation-context-snapshot.js +29 -0
  198. package/dist/application/generation/generation-finalizer.d.ts +15 -9
  199. package/dist/application/generation/generation-finalizer.js +167 -70
  200. package/dist/application/generation/generation-publisher.js +12 -8
  201. package/dist/application/generation/generation-recovery-service.d.ts +35 -0
  202. package/dist/application/generation/generation-recovery-service.js +144 -0
  203. package/dist/application/generation/generation-reopen-service.d.ts +15 -0
  204. package/dist/application/generation/generation-reopen-service.js +37 -0
  205. package/dist/application/generation/generation-replace-service.d.ts +32 -0
  206. package/dist/application/generation/generation-replace-service.js +116 -0
  207. package/dist/application/generation/generation-starter.d.ts +44 -4
  208. package/dist/application/generation/generation-starter.js +175 -8
  209. package/dist/application/generation/generation-step-executor.d.ts +67 -5
  210. package/dist/application/generation/generation-step-executor.js +471 -108
  211. package/dist/application/generation/proposed-step-validator.js +96 -30
  212. package/dist/application/generation/replay-policy-loader.d.ts +16 -0
  213. package/dist/application/generation/replay-policy-loader.js +29 -0
  214. package/dist/application/generation/risk-evaluator.d.ts +4 -1
  215. package/dist/application/generation/risk-evaluator.js +118 -3
  216. package/dist/application/generation/runtime-observer.d.ts +39 -7
  217. package/dist/application/generation/runtime-observer.js +193 -24
  218. package/dist/application/impact/impact-resolver.d.ts +32 -0
  219. package/dist/application/impact/impact-resolver.js +160 -0
  220. package/dist/application/init/init-service.js +26 -13
  221. package/dist/application/interaction/action-executor.d.ts +3 -2
  222. package/dist/application/interaction/action-executor.js +11 -1
  223. package/dist/application/interaction/action-target.d.ts +17 -0
  224. package/dist/application/interaction/action-target.js +40 -0
  225. package/dist/application/interaction/external-step-runner.d.ts +153 -0
  226. package/dist/application/interaction/external-step-runner.js +332 -0
  227. package/dist/application/interaction/fallback-resolver.d.ts +6 -3
  228. package/dist/application/interaction/fallback-resolver.js +7 -5
  229. package/dist/application/interaction/scroll-to-executor.d.ts +17 -3
  230. package/dist/application/interaction/scroll-to-executor.js +118 -36
  231. package/dist/application/journey/external-flow-resolver.d.ts +25 -0
  232. package/dist/application/journey/external-flow-resolver.js +22 -0
  233. package/dist/application/journey/journey-check-service.d.ts +54 -0
  234. package/dist/application/journey/journey-check-service.js +207 -0
  235. package/dist/application/journey/journey-promoter.d.ts +26 -0
  236. package/dist/application/journey/journey-promoter.js +123 -0
  237. package/dist/application/journey/journey-resolver.d.ts +42 -0
  238. package/dist/application/journey/journey-resolver.js +239 -0
  239. package/dist/application/journey/journey-retirer.d.ts +25 -0
  240. package/dist/application/journey/journey-retirer.js +87 -0
  241. package/dist/application/knowledge/anchor-resolver.d.ts +36 -0
  242. package/dist/application/knowledge/anchor-resolver.js +110 -0
  243. package/dist/application/knowledge/knowledge-loader.d.ts +16 -0
  244. package/dist/application/knowledge/knowledge-loader.js +36 -0
  245. package/dist/application/locator/layout-failure-summary.d.ts +2 -0
  246. package/dist/application/locator/layout-failure-summary.js +67 -0
  247. package/dist/application/locator/layout-traversal.d.ts +11 -0
  248. package/dist/application/locator/layout-traversal.js +18 -0
  249. package/dist/application/locator/locator-resolver.d.ts +13 -1
  250. package/dist/application/locator/locator-resolver.js +182 -18
  251. package/dist/application/observe/observe-service.d.ts +20 -0
  252. package/dist/application/observe/observe-service.js +91 -0
  253. package/dist/application/project/project-describer.d.ts +14 -6
  254. package/dist/application/project/project-describer.js +38 -5
  255. package/dist/application/recognition/screen-detector.d.ts +28 -0
  256. package/dist/application/recognition/screen-detector.js +111 -0
  257. package/dist/application/recorder/locator-selector.js +151 -17
  258. package/dist/application/recorder/recorder-service.d.ts +16 -4
  259. package/dist/application/recorder/recorder-service.js +420 -128
  260. package/dist/application/report/report-writer.js +1 -1
  261. package/dist/application/runtime/cold-launch.d.ts +28 -0
  262. package/dist/application/runtime/cold-launch.js +59 -0
  263. package/dist/application/runtime/step-runner.d.ts +49 -4
  264. package/dist/application/runtime/step-runner.js +721 -130
  265. package/dist/application/runtime/verify-runtime.d.ts +57 -7
  266. package/dist/application/runtime/verify-runtime.js +554 -174
  267. package/dist/application/ui/cached-ui-snapshot-provider.d.ts +45 -0
  268. package/dist/application/ui/cached-ui-snapshot-provider.js +111 -0
  269. package/dist/application/ui/ui-snapshot-lifecycle.d.ts +2 -0
  270. package/dist/application/ui/ui-snapshot-lifecycle.js +8 -0
  271. package/dist/application/ui/ui-stability-probe.d.ts +3 -0
  272. package/dist/application/ui/ui-stability-probe.js +8 -0
  273. package/dist/application/wait/idle-advice.d.ts +6 -0
  274. package/dist/application/wait/idle-advice.js +27 -0
  275. package/dist/application/wait/idle-profiles.d.ts +15 -0
  276. package/dist/application/wait/idle-profiles.js +75 -0
  277. package/dist/application/wait/idle-waiter.d.ts +28 -4
  278. package/dist/application/wait/idle-waiter.js +186 -15
  279. package/dist/cli/commands/align.d.ts +3 -0
  280. package/dist/cli/commands/align.js +124 -0
  281. package/dist/cli/commands/baseline.d.ts +3 -0
  282. package/dist/cli/commands/baseline.js +130 -0
  283. package/dist/cli/commands/context.js +300 -27
  284. package/dist/cli/commands/contract.d.ts +3 -0
  285. package/dist/cli/commands/contract.js +120 -0
  286. package/dist/cli/commands/doctor.js +16 -9
  287. package/dist/cli/commands/failure.d.ts +3 -0
  288. package/dist/cli/commands/failure.js +63 -0
  289. package/dist/cli/commands/generation/lifecycle-commands.d.ts +5 -0
  290. package/dist/cli/commands/generation/lifecycle-commands.js +211 -0
  291. package/dist/cli/commands/generation/session-commands.d.ts +11 -0
  292. package/dist/cli/commands/generation/session-commands.js +472 -0
  293. package/dist/cli/commands/generation/shared.d.ts +1414 -0
  294. package/dist/cli/commands/generation/shared.js +291 -0
  295. package/dist/cli/commands/generation/step-commands.d.ts +8 -0
  296. package/dist/cli/commands/generation/step-commands.js +315 -0
  297. package/dist/cli/commands/generation.js +10 -507
  298. package/dist/cli/commands/impact.d.ts +3 -0
  299. package/dist/cli/commands/impact.js +87 -0
  300. package/dist/cli/commands/init.js +13 -6
  301. package/dist/cli/commands/journey.d.ts +3 -0
  302. package/dist/cli/commands/journey.js +382 -0
  303. package/dist/cli/commands/knowledge.d.ts +3 -0
  304. package/dist/cli/commands/knowledge.js +93 -0
  305. package/dist/cli/commands/observe.d.ts +3 -0
  306. package/dist/cli/commands/observe.js +127 -0
  307. package/dist/cli/commands/project.js +2 -1
  308. package/dist/cli/commands/record.js +18 -5
  309. package/dist/cli/commands/verify.js +273 -63
  310. package/dist/cli/dependencies.d.ts +125 -1
  311. package/dist/cli/dependencies.js +450 -51
  312. package/dist/cli/diff-verification.d.ts +41 -0
  313. package/dist/cli/diff-verification.js +192 -0
  314. package/dist/cli/main.js +49 -1
  315. package/dist/cli/output.d.ts +5 -3
  316. package/dist/cli/output.js +12 -0
  317. package/dist/cli/program.js +19 -1
  318. package/dist/cli/project-root.d.ts +1 -0
  319. package/dist/cli/project-root.js +6 -0
  320. package/dist/cli/runtime-selection.d.ts +22 -0
  321. package/dist/cli/runtime-selection.js +92 -0
  322. package/dist/cli/version.d.ts +1 -0
  323. package/dist/cli/version.js +14 -0
  324. package/dist/cli/workspace-guard.d.ts +2 -0
  325. package/dist/cli/workspace-guard.js +3 -0
  326. package/dist/domain/binding-reference.d.ts +4 -0
  327. package/dist/domain/binding-reference.js +23 -0
  328. package/dist/domain/checkpoint.d.ts +404 -0
  329. package/dist/domain/checkpoint.js +297 -0
  330. package/dist/domain/config.d.ts +107 -1
  331. package/dist/domain/config.js +52 -6
  332. package/dist/domain/contract.d.ts +413 -0
  333. package/dist/domain/contract.js +196 -0
  334. package/dist/domain/external-flow.d.ts +493 -0
  335. package/dist/domain/external-flow.js +15 -0
  336. package/dist/domain/failure-classification.d.ts +176 -0
  337. package/dist/domain/failure-classification.js +169 -0
  338. package/dist/domain/failure.d.ts +2 -1
  339. package/dist/domain/failure.js +123 -0
  340. package/dist/domain/generation.d.ts +1671 -132
  341. package/dist/domain/generation.js +202 -13
  342. package/dist/domain/geometry.d.ts +13 -0
  343. package/dist/domain/geometry.js +16 -0
  344. package/dist/domain/impact.d.ts +71 -0
  345. package/dist/domain/impact.js +76 -0
  346. package/dist/domain/init.d.ts +12 -4
  347. package/dist/domain/init.js +24 -18
  348. package/dist/domain/journey-composition.d.ts +2285 -0
  349. package/dist/domain/journey-composition.js +85 -0
  350. package/dist/domain/journey-lifecycle.d.ts +10 -0
  351. package/dist/domain/journey-lifecycle.js +9 -0
  352. package/dist/domain/journey.d.ts +2419 -212
  353. package/dist/domain/journey.js +384 -14
  354. package/dist/domain/knowledge.d.ts +165 -0
  355. package/dist/domain/knowledge.js +188 -0
  356. package/dist/domain/layout.d.ts +34 -5
  357. package/dist/domain/layout.js +64 -6
  358. package/dist/domain/locator-evidence.d.ts +3 -0
  359. package/dist/domain/locator-evidence.js +36 -0
  360. package/dist/domain/logcat-event.d.ts +54 -0
  361. package/dist/domain/logcat-event.js +40 -0
  362. package/dist/domain/observation.d.ts +33 -0
  363. package/dist/domain/observation.js +18 -0
  364. package/dist/domain/project-context.d.ts +219 -1
  365. package/dist/domain/project-context.js +209 -6
  366. package/dist/domain/proposed-step.d.ts +340 -60
  367. package/dist/domain/proposed-step.js +23 -3
  368. package/dist/domain/report.d.ts +1455 -28
  369. package/dist/domain/report.js +211 -14
  370. package/dist/domain/runtime-snapshot.d.ts +58 -1
  371. package/dist/domain/runtime-snapshot.js +14 -3
  372. package/dist/domain/runtime.d.ts +50 -0
  373. package/dist/domain/runtime.js +36 -0
  374. package/dist/domain/system-app-profiles.d.ts +6 -0
  375. package/dist/domain/system-app-profiles.js +43 -0
  376. package/dist/domain/ui-backend.d.ts +28 -0
  377. package/dist/domain/ui-backend.js +33 -0
  378. package/dist/domain/ui-cache.d.ts +11 -0
  379. package/dist/domain/ui-cache.js +10 -0
  380. package/dist/domain/window-hierarchy.d.ts +84 -0
  381. package/dist/domain/window-hierarchy.js +172 -0
  382. package/dist/domain/workflow-manifest.d.ts +77 -0
  383. package/dist/domain/workflow-manifest.js +136 -0
  384. package/dist/domain/workspace.d.ts +28 -0
  385. package/dist/domain/workspace.js +72 -0
  386. package/dist/ports/adb.d.ts +34 -1
  387. package/dist/ports/align-prompt.d.ts +11 -0
  388. package/dist/ports/align-prompt.js +6 -0
  389. package/dist/ports/anchor-resolver.d.ts +30 -0
  390. package/dist/ports/anchor-resolver.js +1 -0
  391. package/dist/ports/annotated-screen-resolver.d.ts +4 -0
  392. package/dist/ports/annotated-screen-resolver.js +1 -0
  393. package/dist/ports/camera-probe.d.ts +23 -0
  394. package/dist/ports/camera-probe.js +8 -0
  395. package/dist/ports/context-document-writer.d.ts +24 -0
  396. package/dist/ports/context-document-writer.js +1 -0
  397. package/dist/ports/detached-process-launcher.d.ts +12 -0
  398. package/dist/ports/detached-process-launcher.js +1 -0
  399. package/dist/ports/external-flow-registry.d.ts +37 -0
  400. package/dist/ports/external-flow-registry.js +1 -0
  401. package/dist/ports/generation-prompt.d.ts +2 -1
  402. package/dist/ports/generation-session-store.d.ts +12 -2
  403. package/dist/ports/git-diff.d.ts +9 -0
  404. package/dist/ports/git-diff.js +1 -0
  405. package/dist/ports/journey-composition-store.d.ts +17 -0
  406. package/dist/ports/journey-composition-store.js +1 -0
  407. package/dist/ports/knowledge-registry.d.ts +20 -0
  408. package/dist/ports/knowledge-registry.js +1 -0
  409. package/dist/ports/process-runner.d.ts +7 -0
  410. package/dist/ports/project-file-inspector.d.ts +1 -0
  411. package/dist/ports/project-identity-inspector.d.ts +24 -0
  412. package/dist/ports/project-identity-inspector.js +1 -0
  413. package/dist/ports/project-inventory-inspector.d.ts +21 -0
  414. package/dist/ports/project-inventory-inspector.js +1 -0
  415. package/dist/ports/project-module-discoverer.d.ts +26 -0
  416. package/dist/ports/project-module-discoverer.js +1 -0
  417. package/dist/ports/recorder-prompt.d.ts +10 -1
  418. package/dist/ports/runtime-backend.d.ts +89 -0
  419. package/dist/ports/runtime-backend.js +13 -0
  420. package/dist/ports/runtime-capability.d.ts +12 -0
  421. package/dist/ports/runtime-capability.js +20 -0
  422. package/dist/ports/runtime-session-ports.d.ts +25 -0
  423. package/dist/ports/runtime-session-ports.js +1 -0
  424. package/dist/ports/screenshot.d.ts +11 -0
  425. package/dist/ports/screenshot.js +1 -0
  426. package/dist/ports/skill-installer.d.ts +2 -2
  427. package/dist/ports/ui-snapshot.d.ts +35 -0
  428. package/dist/ports/ui-snapshot.js +1 -0
  429. package/dist/ports/ui-stability.d.ts +19 -0
  430. package/dist/ports/ui-stability.js +1 -0
  431. package/dist/ports/workspace-layout.d.ts +4 -0
  432. package/dist/ports/workspace-layout.js +1 -0
  433. package/dist/shared/errors.d.ts +2 -0
  434. package/dist/shared/errors.js +22 -0
  435. package/dist/shared/paths.d.ts +2 -0
  436. package/dist/shared/paths.js +24 -0
  437. package/dist/shared/strings.d.ts +2 -0
  438. package/dist/shared/strings.js +16 -0
  439. package/package.json +6 -1
  440. package/assets/skills/taphound-ai-journey/GUIDE.md +0 -862
  441. package/assets/skills/taphound-ai-journey/SKILL.md +0 -377
  442. package/assets/skills/taphound-ai-journey/prompts/analyze-project.md +0 -526
  443. package/assets/skills/taphound-ai-journey/prompts/generate-step.md +0 -109
  444. package/assets/skills/taphound-ai-journey/schemas/project-context.json +0 -81
  445. package/assets/skills/taphound-ai-journey/templates/project-context.example.json +0 -49
  446. package/dist/ports/android-cli.d.ts +0 -21
  447. /package/dist/{ports/android-cli.js → adapters/runtime/mobile-mcp/mobile-mcp-tools.js} +0 -0
@@ -16,14 +16,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
16
16
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
17
17
  type: z.ZodLiteral<"activity">;
18
18
  value: z.ZodString;
19
+ packageName: z.ZodOptional<z.ZodString>;
19
20
  timeoutMs: z.ZodNumber;
20
21
  }, z.core.$strict>, z.ZodObject<{
21
22
  type: z.ZodLiteral<"element">;
22
- locator: z.ZodObject<{
23
- resourceId: z.ZodOptional<z.ZodString>;
24
- text: z.ZodOptional<z.ZodString>;
25
- contentDescription: z.ZodOptional<z.ZodString>;
26
- }, z.core.$strict>;
23
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
24
+ enabled: z.ZodOptional<z.ZodBoolean>;
25
+ clickable: z.ZodOptional<z.ZodBoolean>;
26
+ absent: z.ZodOptional<z.ZodBoolean>;
27
+ packageName: z.ZodOptional<z.ZodString>;
27
28
  timeoutMs: z.ZodNumber;
28
29
  }, z.core.$strict>, z.ZodObject<{
29
30
  type: z.ZodLiteral<"logcat">;
@@ -42,14 +43,40 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
42
43
  literal: "literal";
43
44
  regex: "regex";
44
45
  }>>;
46
+ packageName: z.ZodOptional<z.ZodString>;
47
+ timeoutMs: z.ZodNumber;
48
+ }, z.core.$strict>, z.ZodObject<{
49
+ type: z.ZodLiteral<"logcatEvent">;
50
+ tag: z.ZodString;
51
+ event: z.ZodString;
52
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
53
+ correlation: z.ZodOptional<z.ZodObject<{
54
+ key: z.ZodString;
55
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
56
+ }, z.core.$strict>>;
57
+ capture: z.ZodOptional<z.ZodObject<{
58
+ name: z.ZodString;
59
+ field: z.ZodOptional<z.ZodString>;
60
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
61
+ valueType: z.ZodEnum<{
62
+ string: "string";
63
+ integer: "integer";
64
+ identifier: "identifier";
65
+ }>;
66
+ }, z.core.$strict>>;
67
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
68
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
69
+ from: z.ZodLiteral<"stepStart">;
70
+ }, z.core.$strict>, z.ZodObject<{
71
+ from: z.ZodLiteral<"runStart">;
72
+ }, z.core.$strict>, z.ZodObject<{
73
+ from: z.ZodLiteral<"marker">;
74
+ markerId: z.ZodString;
75
+ }, z.core.$strict>], "from">>;
45
76
  timeoutMs: z.ZodNumber;
46
77
  }, z.core.$strict>], "type">>;
47
78
  action: z.ZodLiteral<"click">;
48
- locator: z.ZodObject<{
49
- resourceId: z.ZodOptional<z.ZodString>;
50
- text: z.ZodOptional<z.ZodString>;
51
- contentDescription: z.ZodOptional<z.ZodString>;
52
- }, z.core.$strict>;
79
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
53
80
  }, z.core.$strict>, z.ZodObject<{
54
81
  binding: z.ZodObject<{
55
82
  generationId: z.ZodString;
@@ -62,14 +89,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
62
89
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
63
90
  type: z.ZodLiteral<"activity">;
64
91
  value: z.ZodString;
92
+ packageName: z.ZodOptional<z.ZodString>;
65
93
  timeoutMs: z.ZodNumber;
66
94
  }, z.core.$strict>, z.ZodObject<{
67
95
  type: z.ZodLiteral<"element">;
68
- locator: z.ZodObject<{
69
- resourceId: z.ZodOptional<z.ZodString>;
70
- text: z.ZodOptional<z.ZodString>;
71
- contentDescription: z.ZodOptional<z.ZodString>;
72
- }, z.core.$strict>;
96
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
97
+ enabled: z.ZodOptional<z.ZodBoolean>;
98
+ clickable: z.ZodOptional<z.ZodBoolean>;
99
+ absent: z.ZodOptional<z.ZodBoolean>;
100
+ packageName: z.ZodOptional<z.ZodString>;
73
101
  timeoutMs: z.ZodNumber;
74
102
  }, z.core.$strict>, z.ZodObject<{
75
103
  type: z.ZodLiteral<"logcat">;
@@ -88,14 +116,40 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
88
116
  literal: "literal";
89
117
  regex: "regex";
90
118
  }>>;
119
+ packageName: z.ZodOptional<z.ZodString>;
120
+ timeoutMs: z.ZodNumber;
121
+ }, z.core.$strict>, z.ZodObject<{
122
+ type: z.ZodLiteral<"logcatEvent">;
123
+ tag: z.ZodString;
124
+ event: z.ZodString;
125
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
126
+ correlation: z.ZodOptional<z.ZodObject<{
127
+ key: z.ZodString;
128
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
129
+ }, z.core.$strict>>;
130
+ capture: z.ZodOptional<z.ZodObject<{
131
+ name: z.ZodString;
132
+ field: z.ZodOptional<z.ZodString>;
133
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
134
+ valueType: z.ZodEnum<{
135
+ string: "string";
136
+ integer: "integer";
137
+ identifier: "identifier";
138
+ }>;
139
+ }, z.core.$strict>>;
140
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
141
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
142
+ from: z.ZodLiteral<"stepStart">;
143
+ }, z.core.$strict>, z.ZodObject<{
144
+ from: z.ZodLiteral<"runStart">;
145
+ }, z.core.$strict>, z.ZodObject<{
146
+ from: z.ZodLiteral<"marker">;
147
+ markerId: z.ZodString;
148
+ }, z.core.$strict>], "from">>;
91
149
  timeoutMs: z.ZodNumber;
92
150
  }, z.core.$strict>], "type">>;
93
151
  action: z.ZodLiteral<"longClick">;
94
- locator: z.ZodObject<{
95
- resourceId: z.ZodOptional<z.ZodString>;
96
- text: z.ZodOptional<z.ZodString>;
97
- contentDescription: z.ZodOptional<z.ZodString>;
98
- }, z.core.$strict>;
152
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
99
153
  durationMs: z.ZodDefault<z.ZodNumber>;
100
154
  }, z.core.$strict>, z.ZodObject<{
101
155
  binding: z.ZodObject<{
@@ -109,14 +163,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
109
163
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
110
164
  type: z.ZodLiteral<"activity">;
111
165
  value: z.ZodString;
166
+ packageName: z.ZodOptional<z.ZodString>;
112
167
  timeoutMs: z.ZodNumber;
113
168
  }, z.core.$strict>, z.ZodObject<{
114
169
  type: z.ZodLiteral<"element">;
115
- locator: z.ZodObject<{
116
- resourceId: z.ZodOptional<z.ZodString>;
117
- text: z.ZodOptional<z.ZodString>;
118
- contentDescription: z.ZodOptional<z.ZodString>;
119
- }, z.core.$strict>;
170
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
171
+ enabled: z.ZodOptional<z.ZodBoolean>;
172
+ clickable: z.ZodOptional<z.ZodBoolean>;
173
+ absent: z.ZodOptional<z.ZodBoolean>;
174
+ packageName: z.ZodOptional<z.ZodString>;
120
175
  timeoutMs: z.ZodNumber;
121
176
  }, z.core.$strict>, z.ZodObject<{
122
177
  type: z.ZodLiteral<"logcat">;
@@ -135,6 +190,36 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
135
190
  literal: "literal";
136
191
  regex: "regex";
137
192
  }>>;
193
+ packageName: z.ZodOptional<z.ZodString>;
194
+ timeoutMs: z.ZodNumber;
195
+ }, z.core.$strict>, z.ZodObject<{
196
+ type: z.ZodLiteral<"logcatEvent">;
197
+ tag: z.ZodString;
198
+ event: z.ZodString;
199
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
200
+ correlation: z.ZodOptional<z.ZodObject<{
201
+ key: z.ZodString;
202
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
203
+ }, z.core.$strict>>;
204
+ capture: z.ZodOptional<z.ZodObject<{
205
+ name: z.ZodString;
206
+ field: z.ZodOptional<z.ZodString>;
207
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
208
+ valueType: z.ZodEnum<{
209
+ string: "string";
210
+ integer: "integer";
211
+ identifier: "identifier";
212
+ }>;
213
+ }, z.core.$strict>>;
214
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
215
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
216
+ from: z.ZodLiteral<"stepStart">;
217
+ }, z.core.$strict>, z.ZodObject<{
218
+ from: z.ZodLiteral<"runStart">;
219
+ }, z.core.$strict>, z.ZodObject<{
220
+ from: z.ZodLiteral<"marker">;
221
+ markerId: z.ZodString;
222
+ }, z.core.$strict>], "from">>;
138
223
  timeoutMs: z.ZodNumber;
139
224
  }, z.core.$strict>], "type">>;
140
225
  action: z.ZodLiteral<"inputText">;
@@ -151,14 +236,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
151
236
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
152
237
  type: z.ZodLiteral<"activity">;
153
238
  value: z.ZodString;
239
+ packageName: z.ZodOptional<z.ZodString>;
154
240
  timeoutMs: z.ZodNumber;
155
241
  }, z.core.$strict>, z.ZodObject<{
156
242
  type: z.ZodLiteral<"element">;
157
- locator: z.ZodObject<{
158
- resourceId: z.ZodOptional<z.ZodString>;
159
- text: z.ZodOptional<z.ZodString>;
160
- contentDescription: z.ZodOptional<z.ZodString>;
161
- }, z.core.$strict>;
243
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
244
+ enabled: z.ZodOptional<z.ZodBoolean>;
245
+ clickable: z.ZodOptional<z.ZodBoolean>;
246
+ absent: z.ZodOptional<z.ZodBoolean>;
247
+ packageName: z.ZodOptional<z.ZodString>;
162
248
  timeoutMs: z.ZodNumber;
163
249
  }, z.core.$strict>, z.ZodObject<{
164
250
  type: z.ZodLiteral<"logcat">;
@@ -177,14 +263,40 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
177
263
  literal: "literal";
178
264
  regex: "regex";
179
265
  }>>;
266
+ packageName: z.ZodOptional<z.ZodString>;
267
+ timeoutMs: z.ZodNumber;
268
+ }, z.core.$strict>, z.ZodObject<{
269
+ type: z.ZodLiteral<"logcatEvent">;
270
+ tag: z.ZodString;
271
+ event: z.ZodString;
272
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
273
+ correlation: z.ZodOptional<z.ZodObject<{
274
+ key: z.ZodString;
275
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
276
+ }, z.core.$strict>>;
277
+ capture: z.ZodOptional<z.ZodObject<{
278
+ name: z.ZodString;
279
+ field: z.ZodOptional<z.ZodString>;
280
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
281
+ valueType: z.ZodEnum<{
282
+ string: "string";
283
+ integer: "integer";
284
+ identifier: "identifier";
285
+ }>;
286
+ }, z.core.$strict>>;
287
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
288
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
289
+ from: z.ZodLiteral<"stepStart">;
290
+ }, z.core.$strict>, z.ZodObject<{
291
+ from: z.ZodLiteral<"runStart">;
292
+ }, z.core.$strict>, z.ZodObject<{
293
+ from: z.ZodLiteral<"marker">;
294
+ markerId: z.ZodString;
295
+ }, z.core.$strict>], "from">>;
180
296
  timeoutMs: z.ZodNumber;
181
297
  }, z.core.$strict>], "type">>;
182
298
  action: z.ZodLiteral<"swipe">;
183
- locator: z.ZodObject<{
184
- resourceId: z.ZodOptional<z.ZodString>;
185
- text: z.ZodOptional<z.ZodString>;
186
- contentDescription: z.ZodOptional<z.ZodString>;
187
- }, z.core.$strict>;
299
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
188
300
  direction: z.ZodEnum<{
189
301
  left: "left";
190
302
  right: "right";
@@ -205,14 +317,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
205
317
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
206
318
  type: z.ZodLiteral<"activity">;
207
319
  value: z.ZodString;
320
+ packageName: z.ZodOptional<z.ZodString>;
208
321
  timeoutMs: z.ZodNumber;
209
322
  }, z.core.$strict>, z.ZodObject<{
210
323
  type: z.ZodLiteral<"element">;
211
- locator: z.ZodObject<{
212
- resourceId: z.ZodOptional<z.ZodString>;
213
- text: z.ZodOptional<z.ZodString>;
214
- contentDescription: z.ZodOptional<z.ZodString>;
215
- }, z.core.$strict>;
324
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
325
+ enabled: z.ZodOptional<z.ZodBoolean>;
326
+ clickable: z.ZodOptional<z.ZodBoolean>;
327
+ absent: z.ZodOptional<z.ZodBoolean>;
328
+ packageName: z.ZodOptional<z.ZodString>;
216
329
  timeoutMs: z.ZodNumber;
217
330
  }, z.core.$strict>, z.ZodObject<{
218
331
  type: z.ZodLiteral<"logcat">;
@@ -231,19 +344,41 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
231
344
  literal: "literal";
232
345
  regex: "regex";
233
346
  }>>;
347
+ packageName: z.ZodOptional<z.ZodString>;
348
+ timeoutMs: z.ZodNumber;
349
+ }, z.core.$strict>, z.ZodObject<{
350
+ type: z.ZodLiteral<"logcatEvent">;
351
+ tag: z.ZodString;
352
+ event: z.ZodString;
353
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
354
+ correlation: z.ZodOptional<z.ZodObject<{
355
+ key: z.ZodString;
356
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
357
+ }, z.core.$strict>>;
358
+ capture: z.ZodOptional<z.ZodObject<{
359
+ name: z.ZodString;
360
+ field: z.ZodOptional<z.ZodString>;
361
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
362
+ valueType: z.ZodEnum<{
363
+ string: "string";
364
+ integer: "integer";
365
+ identifier: "identifier";
366
+ }>;
367
+ }, z.core.$strict>>;
368
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
369
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
370
+ from: z.ZodLiteral<"stepStart">;
371
+ }, z.core.$strict>, z.ZodObject<{
372
+ from: z.ZodLiteral<"runStart">;
373
+ }, z.core.$strict>, z.ZodObject<{
374
+ from: z.ZodLiteral<"marker">;
375
+ markerId: z.ZodString;
376
+ }, z.core.$strict>], "from">>;
234
377
  timeoutMs: z.ZodNumber;
235
378
  }, z.core.$strict>], "type">>;
236
379
  action: z.ZodLiteral<"scrollTo">;
237
- locator: z.ZodObject<{
238
- resourceId: z.ZodOptional<z.ZodString>;
239
- text: z.ZodOptional<z.ZodString>;
240
- contentDescription: z.ZodOptional<z.ZodString>;
241
- }, z.core.$strict>;
242
- container: z.ZodObject<{
243
- resourceId: z.ZodOptional<z.ZodString>;
244
- text: z.ZodOptional<z.ZodString>;
245
- contentDescription: z.ZodOptional<z.ZodString>;
246
- }, z.core.$strict>;
380
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
381
+ container: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
247
382
  direction: z.ZodEnum<{
248
383
  left: "left";
249
384
  right: "right";
@@ -265,14 +400,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
265
400
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
266
401
  type: z.ZodLiteral<"activity">;
267
402
  value: z.ZodString;
403
+ packageName: z.ZodOptional<z.ZodString>;
268
404
  timeoutMs: z.ZodNumber;
269
405
  }, z.core.$strict>, z.ZodObject<{
270
406
  type: z.ZodLiteral<"element">;
271
- locator: z.ZodObject<{
272
- resourceId: z.ZodOptional<z.ZodString>;
273
- text: z.ZodOptional<z.ZodString>;
274
- contentDescription: z.ZodOptional<z.ZodString>;
275
- }, z.core.$strict>;
407
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
408
+ enabled: z.ZodOptional<z.ZodBoolean>;
409
+ clickable: z.ZodOptional<z.ZodBoolean>;
410
+ absent: z.ZodOptional<z.ZodBoolean>;
411
+ packageName: z.ZodOptional<z.ZodString>;
276
412
  timeoutMs: z.ZodNumber;
277
413
  }, z.core.$strict>, z.ZodObject<{
278
414
  type: z.ZodLiteral<"logcat">;
@@ -291,6 +427,36 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
291
427
  literal: "literal";
292
428
  regex: "regex";
293
429
  }>>;
430
+ packageName: z.ZodOptional<z.ZodString>;
431
+ timeoutMs: z.ZodNumber;
432
+ }, z.core.$strict>, z.ZodObject<{
433
+ type: z.ZodLiteral<"logcatEvent">;
434
+ tag: z.ZodString;
435
+ event: z.ZodString;
436
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
437
+ correlation: z.ZodOptional<z.ZodObject<{
438
+ key: z.ZodString;
439
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
440
+ }, z.core.$strict>>;
441
+ capture: z.ZodOptional<z.ZodObject<{
442
+ name: z.ZodString;
443
+ field: z.ZodOptional<z.ZodString>;
444
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
445
+ valueType: z.ZodEnum<{
446
+ string: "string";
447
+ integer: "integer";
448
+ identifier: "identifier";
449
+ }>;
450
+ }, z.core.$strict>>;
451
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
452
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
453
+ from: z.ZodLiteral<"stepStart">;
454
+ }, z.core.$strict>, z.ZodObject<{
455
+ from: z.ZodLiteral<"runStart">;
456
+ }, z.core.$strict>, z.ZodObject<{
457
+ from: z.ZodLiteral<"marker">;
458
+ markerId: z.ZodString;
459
+ }, z.core.$strict>], "from">>;
294
460
  timeoutMs: z.ZodNumber;
295
461
  }, z.core.$strict>], "type">>;
296
462
  action: z.ZodLiteral<"back">;
@@ -306,14 +472,15 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
306
472
  expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
307
473
  type: z.ZodLiteral<"activity">;
308
474
  value: z.ZodString;
475
+ packageName: z.ZodOptional<z.ZodString>;
309
476
  timeoutMs: z.ZodNumber;
310
477
  }, z.core.$strict>, z.ZodObject<{
311
478
  type: z.ZodLiteral<"element">;
312
- locator: z.ZodObject<{
313
- resourceId: z.ZodOptional<z.ZodString>;
314
- text: z.ZodOptional<z.ZodString>;
315
- contentDescription: z.ZodOptional<z.ZodString>;
316
- }, z.core.$strict>;
479
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
480
+ enabled: z.ZodOptional<z.ZodBoolean>;
481
+ clickable: z.ZodOptional<z.ZodBoolean>;
482
+ absent: z.ZodOptional<z.ZodBoolean>;
483
+ packageName: z.ZodOptional<z.ZodString>;
317
484
  timeoutMs: z.ZodNumber;
318
485
  }, z.core.$strict>, z.ZodObject<{
319
486
  type: z.ZodLiteral<"logcat">;
@@ -332,9 +499,122 @@ export declare const ProposedStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
332
499
  literal: "literal";
333
500
  regex: "regex";
334
501
  }>>;
502
+ packageName: z.ZodOptional<z.ZodString>;
503
+ timeoutMs: z.ZodNumber;
504
+ }, z.core.$strict>, z.ZodObject<{
505
+ type: z.ZodLiteral<"logcatEvent">;
506
+ tag: z.ZodString;
507
+ event: z.ZodString;
508
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
509
+ correlation: z.ZodOptional<z.ZodObject<{
510
+ key: z.ZodString;
511
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
512
+ }, z.core.$strict>>;
513
+ capture: z.ZodOptional<z.ZodObject<{
514
+ name: z.ZodString;
515
+ field: z.ZodOptional<z.ZodString>;
516
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
517
+ valueType: z.ZodEnum<{
518
+ string: "string";
519
+ integer: "integer";
520
+ identifier: "identifier";
521
+ }>;
522
+ }, z.core.$strict>>;
523
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
524
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
525
+ from: z.ZodLiteral<"stepStart">;
526
+ }, z.core.$strict>, z.ZodObject<{
527
+ from: z.ZodLiteral<"runStart">;
528
+ }, z.core.$strict>, z.ZodObject<{
529
+ from: z.ZodLiteral<"marker">;
530
+ markerId: z.ZodString;
531
+ }, z.core.$strict>], "from">>;
335
532
  timeoutMs: z.ZodNumber;
336
533
  }, z.core.$strict>], "type">>;
337
534
  action: z.ZodLiteral<"wait">;
535
+ }, z.core.$strict>, z.ZodObject<{
536
+ binding: z.ZodObject<{
537
+ generationId: z.ZodString;
538
+ baseRevision: z.ZodNumber;
539
+ snapshotHash: z.ZodString;
540
+ }, z.core.$strict>;
541
+ activity: z.ZodObject<{
542
+ before: z.ZodString;
543
+ }, z.core.$strict>;
544
+ expect: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
545
+ type: z.ZodLiteral<"activity">;
546
+ value: z.ZodString;
547
+ packageName: z.ZodOptional<z.ZodString>;
548
+ timeoutMs: z.ZodNumber;
549
+ }, z.core.$strict>, z.ZodObject<{
550
+ type: z.ZodLiteral<"element">;
551
+ locator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
552
+ enabled: z.ZodOptional<z.ZodBoolean>;
553
+ clickable: z.ZodOptional<z.ZodBoolean>;
554
+ absent: z.ZodOptional<z.ZodBoolean>;
555
+ packageName: z.ZodOptional<z.ZodString>;
556
+ timeoutMs: z.ZodNumber;
557
+ }, z.core.$strict>, z.ZodObject<{
558
+ type: z.ZodLiteral<"logcat">;
559
+ tag: z.ZodString;
560
+ level: z.ZodOptional<z.ZodEnum<{
561
+ V: "V";
562
+ D: "D";
563
+ I: "I";
564
+ W: "W";
565
+ E: "E";
566
+ F: "F";
567
+ A: "A";
568
+ }>>;
569
+ pattern: z.ZodString;
570
+ match: z.ZodDefault<z.ZodEnum<{
571
+ literal: "literal";
572
+ regex: "regex";
573
+ }>>;
574
+ packageName: z.ZodOptional<z.ZodString>;
575
+ timeoutMs: z.ZodNumber;
576
+ }, z.core.$strict>, z.ZodObject<{
577
+ type: z.ZodLiteral<"logcatEvent">;
578
+ tag: z.ZodString;
579
+ event: z.ZodString;
580
+ fields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
581
+ correlation: z.ZodOptional<z.ZodObject<{
582
+ key: z.ZodString;
583
+ value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodString]>;
584
+ }, z.core.$strict>>;
585
+ capture: z.ZodOptional<z.ZodObject<{
586
+ name: z.ZodString;
587
+ field: z.ZodOptional<z.ZodString>;
588
+ group: z.ZodOptional<z.ZodLiteral<"correlation">>;
589
+ valueType: z.ZodEnum<{
590
+ string: "string";
591
+ integer: "integer";
592
+ identifier: "identifier";
593
+ }>;
594
+ }, z.core.$strict>>;
595
+ unique: z.ZodDefault<z.ZodLiteral<true>>;
596
+ window: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
597
+ from: z.ZodLiteral<"stepStart">;
598
+ }, z.core.$strict>, z.ZodObject<{
599
+ from: z.ZodLiteral<"runStart">;
600
+ }, z.core.$strict>, z.ZodObject<{
601
+ from: z.ZodLiteral<"marker">;
602
+ markerId: z.ZodString;
603
+ }, z.core.$strict>], "from">>;
604
+ timeoutMs: z.ZodNumber;
605
+ }, z.core.$strict>], "type">>;
606
+ action: z.ZodLiteral<"bridge">;
607
+ scenario: z.ZodEnum<{
608
+ custom: "custom";
609
+ photoCapture: "photoCapture";
610
+ pickImage: "pickImage";
611
+ pickFile: "pickFile";
612
+ }>;
613
+ description: z.ZodString;
614
+ triggerLocator: z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>;
615
+ returnTimeoutMs: z.ZodNumber;
616
+ flow: z.ZodOptional<z.ZodString>;
617
+ escapeTimeoutMs: z.ZodOptional<z.ZodNumber>;
338
618
  }, z.core.$strict>], "action">;
339
619
  export type ProposedStep = z.infer<typeof ProposedStepSchema>;
340
620
  export type ProposalBinding = z.infer<typeof ProposalBindingSchema>;
@@ -1,6 +1,6 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { z } from "zod";
3
- import { ExpectSchema } from "./journey.js";
3
+ import { ExpectSchema, BridgeScenarioSchema } from "./journey.js";
4
4
  import { LocatorSchema } from "./layout.js";
5
5
  const QualifiedActivitySchema = z.string().regex(/^(?:[A-Za-z_$][\w$]*\.)+[A-Za-z_$][\w$]*$/, "Activity checkpoint must be fully qualified");
6
6
  const ProposedActivitySchema = z.strictObject({
@@ -58,6 +58,16 @@ const WaitStepSchema = z.strictObject({
58
58
  action: z.literal("wait"),
59
59
  ...CommonStepShape
60
60
  });
61
+ const BridgeStepSchema = z.strictObject({
62
+ action: z.literal("bridge"),
63
+ scenario: BridgeScenarioSchema,
64
+ description: z.string().min(1),
65
+ triggerLocator: LocatorSchema,
66
+ returnTimeoutMs: z.number().int().positive(),
67
+ flow: z.string().trim().min(1).optional(),
68
+ escapeTimeoutMs: z.number().int().positive().optional(),
69
+ ...CommonStepShape
70
+ });
61
71
  export const ProposedStepSchema = z.discriminatedUnion("action", [
62
72
  ClickStepSchema,
63
73
  LongClickStepSchema,
@@ -65,8 +75,18 @@ export const ProposedStepSchema = z.discriminatedUnion("action", [
65
75
  SwipeStepSchema,
66
76
  ScrollToStepSchema,
67
77
  BackStepSchema,
68
- WaitStepSchema
69
- ]);
78
+ WaitStepSchema,
79
+ BridgeStepSchema
80
+ ]).superRefine((step, context) => {
81
+ if (step.expect?.type === "logcatEvent"
82
+ && step.expect.window.from !== "stepStart") {
83
+ context.addIssue({
84
+ code: "custom",
85
+ path: ["expect", "window"],
86
+ message: "Generation proposals support only stepStart Logcat event windows"
87
+ });
88
+ }
89
+ });
70
90
  function canonicalize(value) {
71
91
  if (Array.isArray(value)) {
72
92
  return value.map(canonicalize);