waygraph 0.15.54 → 0.16.1

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 (552) hide show
  1. package/README.md +8 -3
  2. package/bin/waygraph +2 -2
  3. package/dist/analysis/check.d.ts +38 -0
  4. package/dist/analysis/check.js +87 -0
  5. package/dist/analysis/coverage-gap.d.ts +1 -1
  6. package/dist/analysis/coverage-gap.js +14 -37
  7. package/dist/analysis/flow-source.d.ts +9 -0
  8. package/dist/analysis/flow-source.js +25 -0
  9. package/dist/analysis/graph.d.ts +10 -14
  10. package/dist/analysis/graph.js +48 -371
  11. package/dist/analysis/map-check.js +4 -39
  12. package/dist/analysis/practices-check.d.ts +1 -1
  13. package/dist/analysis/practices-check.js +24 -45
  14. package/dist/cli/args.d.ts +23 -0
  15. package/dist/cli/args.js +20 -0
  16. package/dist/{cli.d.ts → cli/cli.d.ts} +0 -1
  17. package/dist/{cli.js → cli/cli.js} +10 -9
  18. package/dist/{commands → cli/commands}/agent-dive-scaffold.js +35 -64
  19. package/dist/cli/commands/agent-dive.js +42 -0
  20. package/dist/cli/commands/browser.d.ts +2 -0
  21. package/dist/cli/commands/browser.js +109 -0
  22. package/dist/{commands → cli/commands}/check.d.ts +0 -1
  23. package/dist/cli/commands/check.js +104 -0
  24. package/dist/cli/commands/codemod-checkpoints.d.ts +18 -0
  25. package/dist/cli/commands/codemod-checkpoints.js +186 -0
  26. package/dist/cli/commands/codemod-flows.d.ts +18 -0
  27. package/dist/cli/commands/codemod-flows.js +284 -0
  28. package/dist/cli/commands/codemod-stubs.d.ts +10 -0
  29. package/dist/cli/commands/codemod-stubs.js +187 -0
  30. package/dist/{commands → cli/commands}/extensions.js +5 -4
  31. package/dist/{commands → cli/commands}/init.js +1 -2
  32. package/dist/{commands → cli/commands}/list.js +9 -7
  33. package/dist/cli/commands/manifest.d.ts +2 -0
  34. package/dist/cli/commands/manifest.js +20 -0
  35. package/dist/cli/commands/map.js +57 -0
  36. package/dist/cli/commands/pilot.d.ts +2 -0
  37. package/dist/cli/commands/pilot.js +102 -0
  38. package/dist/{commands → cli/commands}/run.d.ts +0 -1
  39. package/dist/cli/commands/run.js +64 -0
  40. package/dist/cli/commands/session-ops.d.ts +3 -0
  41. package/dist/cli/commands/session-ops.js +257 -0
  42. package/dist/cli/commands/session.js +132 -0
  43. package/dist/{commands → cli/commands}/test.js +11 -14
  44. package/dist/cli/commands/traverse.js +105 -0
  45. package/dist/{commands → cli/commands}/try.js +29 -25
  46. package/dist/{commands → cli/commands}/upgrade.js +40 -4
  47. package/dist/cli/flags.d.ts +193 -16
  48. package/dist/cli/flags.js +179 -234
  49. package/dist/cli/run-chain.d.ts +1 -0
  50. package/dist/cli/run-chain.js +42 -7
  51. package/dist/cli/usage.d.ts +1 -1
  52. package/dist/cli/usage.js +21 -53
  53. package/dist/cli/util.d.ts +2 -2
  54. package/dist/cli/util.js +2 -3
  55. package/dist/{highlights → demo/narration}/css.d.ts +1 -1
  56. package/dist/{highlights → demo/narration}/css.js +2 -3
  57. package/dist/{highlights → demo/narration}/demo-pace.d.ts +4 -12
  58. package/dist/{highlights → demo/narration}/demo-pace.js +5 -11
  59. package/dist/{highlights → demo/narration}/device.d.ts +4 -4
  60. package/dist/{highlights → demo/narration}/device.js +1 -1
  61. package/dist/demo/narration/merge.d.ts +10 -0
  62. package/dist/demo/narration/merge.js +67 -0
  63. package/dist/demo/narration/narration.d.ts +39 -0
  64. package/dist/{highlights/run-phase.js → demo/narration/narration.js} +25 -94
  65. package/dist/{highlights → demo/narration}/shorthand.d.ts +1 -1
  66. package/dist/demo/narration/stub-ctx.d.ts +8 -0
  67. package/dist/demo/narration/stub-ctx.js +164 -0
  68. package/dist/{highlights → demo/narration}/style.d.ts +1 -7
  69. package/dist/{highlights → demo/narration}/style.js +1 -41
  70. package/dist/{highlights → demo/narration}/todo-dock.d.ts +8 -8
  71. package/dist/{highlights → demo/narration}/todo-dock.js +13 -30
  72. package/dist/demo/overlay/auto-chrome.d.ts +7 -0
  73. package/dist/demo/overlay/auto-chrome.js +97 -0
  74. package/dist/demo/overlay/cursor.d.ts +19 -0
  75. package/dist/demo/overlay/cursor.js +142 -0
  76. package/dist/demo/overlay/device-stage.d.ts +26 -0
  77. package/dist/demo/overlay/device-stage.js +396 -0
  78. package/dist/demo/overlay/inpage/banner.d.ts +2 -0
  79. package/dist/demo/overlay/inpage/banner.js +160 -0
  80. package/dist/demo/overlay/inpage/caption.d.ts +2 -0
  81. package/dist/demo/overlay/inpage/caption.js +24 -0
  82. package/dist/demo/overlay/inpage/core.d.ts +2 -0
  83. package/dist/demo/overlay/inpage/core.js +345 -0
  84. package/dist/demo/overlay/inpage/device-chip.d.ts +1 -0
  85. package/dist/demo/overlay/inpage/device-chip.js +191 -0
  86. package/dist/demo/overlay/inpage/network.d.ts +10 -0
  87. package/dist/demo/overlay/inpage/network.js +189 -0
  88. package/dist/demo/overlay/inpage/panel-chrome.d.ts +1 -0
  89. package/dist/demo/overlay/inpage/panel-chrome.js +203 -0
  90. package/dist/demo/overlay/inpage/stamp.d.ts +1 -0
  91. package/dist/demo/overlay/inpage/stamp.js +46 -0
  92. package/dist/demo/overlay/inpage/swipe-zoom.d.ts +1 -0
  93. package/dist/demo/overlay/inpage/swipe-zoom.js +220 -0
  94. package/dist/demo/overlay/inpage/todos.d.ts +2 -0
  95. package/dist/demo/overlay/inpage/todos.js +293 -0
  96. package/dist/demo/overlay/locator-theater.d.ts +25 -0
  97. package/dist/demo/overlay/locator-theater.js +76 -0
  98. package/dist/demo/overlay/network-capture.d.ts +22 -0
  99. package/dist/demo/overlay/network-capture.js +127 -0
  100. package/dist/demo/overlay/overlay-css.d.ts +3 -0
  101. package/dist/demo/overlay/overlay-css.js +369 -0
  102. package/dist/demo/overlay/overlay-stage.d.ts +31 -0
  103. package/dist/demo/overlay/overlay-stage.js +106 -0
  104. package/dist/demo/overlay/overlay.d.ts +10 -0
  105. package/dist/demo/overlay/overlay.js +89 -0
  106. package/dist/{pilot-overlay/overlay-fixtures.d.ts → demo/overlay/phase-fixtures.d.ts} +2 -2
  107. package/dist/{pilot-overlay/overlay-fixtures.js → demo/overlay/phase-fixtures.js} +2 -2
  108. package/dist/{pilot-overlay/action-ring.js → demo/overlay/pilot/actions.js} +2 -1
  109. package/dist/{pilot-overlay → demo/overlay/pilot}/fixtures.d.ts +6 -5
  110. package/dist/{pilot-overlay → demo/overlay/pilot}/fixtures.js +19 -18
  111. package/dist/{pilot-overlay → demo/overlay/pilot}/shell.d.ts +2 -2
  112. package/dist/{pilot-overlay → demo/overlay/pilot}/shell.js +13 -22
  113. package/dist/demo/overlay/reattach.d.ts +7 -0
  114. package/dist/demo/overlay/reattach.js +23 -0
  115. package/dist/demo/overlay/rings.d.ts +61 -0
  116. package/dist/demo/overlay/rings.js +422 -0
  117. package/dist/{ui → demo/overlay/ui}/components/ring.js +2 -2
  118. package/dist/{ui → demo/overlay/ui}/overlay.css +4 -4
  119. package/dist/{ui → demo/overlay/ui}/shadow.d.ts +1 -1
  120. package/dist/{ui → demo/overlay/ui}/shadow.js +39 -2
  121. package/dist/demo/stepper/after.d.ts +3 -0
  122. package/dist/demo/stepper/after.js +103 -0
  123. package/dist/demo/stepper/banner-log.d.ts +35 -0
  124. package/dist/demo/stepper/banner-log.js +65 -0
  125. package/dist/demo/stepper/before.d.ts +4 -0
  126. package/dist/demo/stepper/before.js +110 -0
  127. package/dist/demo/stepper/demo-log.d.ts +48 -0
  128. package/dist/demo/stepper/demo-log.js +292 -0
  129. package/dist/demo/stepper/gate.d.ts +11 -0
  130. package/dist/demo/stepper/gate.js +78 -0
  131. package/dist/demo/stepper/interaction-patch.d.ts +4 -0
  132. package/dist/demo/stepper/interaction-patch.js +323 -0
  133. package/dist/demo/stepper/pacing.d.ts +21 -0
  134. package/dist/demo/stepper/pacing.js +23 -0
  135. package/dist/demo/stepper/panel-after.d.ts +17 -0
  136. package/dist/demo/stepper/panel-after.js +166 -0
  137. package/dist/demo/stepper/panel-before.d.ts +12 -0
  138. package/dist/demo/stepper/panel-before.js +241 -0
  139. package/dist/demo/stepper/slides.d.ts +23 -0
  140. package/dist/demo/stepper/slides.js +233 -0
  141. package/dist/demo/stepper/step-panels.d.ts +69 -0
  142. package/dist/demo/stepper/step-panels.js +172 -0
  143. package/dist/demo/stepper/stepper.d.ts +24 -0
  144. package/dist/demo/stepper/stepper.js +122 -0
  145. package/dist/demo/stepper/teardown.d.ts +47 -0
  146. package/dist/demo/stepper/teardown.js +178 -0
  147. package/dist/demo/stepper/todo-advance.d.ts +15 -0
  148. package/dist/demo/stepper/todo-advance.js +110 -0
  149. package/dist/demo/stepper/view.d.ts +58 -0
  150. package/dist/demo/stepper/view.js +31 -0
  151. package/dist/demo/types.d.ts +85 -0
  152. package/dist/demo/verbose-log.js +15 -0
  153. package/dist/engine/block/action-page.d.ts +53 -0
  154. package/dist/engine/block/action-page.js +1 -0
  155. package/dist/{types.d.ts → engine/block/block.d.ts} +102 -142
  156. package/dist/{core → engine/block}/block.js +12 -130
  157. package/dist/engine/block/branch.d.ts +17 -0
  158. package/dist/engine/block/branch.js +40 -0
  159. package/dist/{core → engine/block}/compose.d.ts +9 -7
  160. package/dist/{core → engine/block}/compose.js +1 -1
  161. package/dist/engine/block/dialog.d.ts +13 -0
  162. package/dist/engine/block/dialog.js +37 -0
  163. package/dist/{core/blocks → engine/block/kinds}/api.d.ts +16 -12
  164. package/dist/{core/blocks → engine/block/kinds}/api.js +26 -18
  165. package/dist/{core/blocks → engine/block/kinds}/effect.d.ts +13 -18
  166. package/dist/engine/block/kinds/effect.js +17 -0
  167. package/dist/{core/blocks → engine/block/kinds}/method.d.ts +17 -29
  168. package/dist/{core/blocks → engine/block/kinds}/method.js +6 -21
  169. package/dist/{core/blocks → engine/block/kinds}/nav.d.ts +21 -31
  170. package/dist/{core/blocks → engine/block/kinds}/nav.js +6 -12
  171. package/dist/{core/blocks → engine/block/kinds}/page.d.ts +14 -20
  172. package/dist/{core/blocks → engine/block/kinds}/page.js +5 -7
  173. package/dist/engine/checkpoint/checkpoint.d.ts +22 -0
  174. package/dist/engine/checkpoint/checkpoint.js +8 -0
  175. package/dist/engine/checkpoint/route.d.ts +28 -0
  176. package/dist/engine/checkpoint/route.js +28 -0
  177. package/dist/{core → engine}/config.d.ts +7 -2
  178. package/dist/engine/config.js +6 -0
  179. package/dist/engine/engine.d.ts +45 -0
  180. package/dist/{core → engine}/engine.js +6 -10
  181. package/dist/engine/env.d.ts +59 -0
  182. package/dist/engine/env.js +83 -0
  183. package/dist/{errors.d.ts → engine/errors.d.ts} +22 -22
  184. package/dist/{errors.js → engine/errors.js} +22 -22
  185. package/dist/{core → engine/flow}/branch-regression.d.ts +7 -7
  186. package/dist/{core → engine/flow}/branch-regression.js +4 -3
  187. package/dist/engine/flow/flow.d.ts +162 -0
  188. package/dist/engine/flow/flow.js +244 -0
  189. package/dist/engine/flow/map-branch.d.ts +9 -0
  190. package/dist/engine/flow/map-branch.js +57 -0
  191. package/dist/{core → engine/flow}/map-builder.d.ts +34 -54
  192. package/dist/engine/flow/map-builder.js +242 -0
  193. package/dist/engine/flow/map-steps.d.ts +30 -0
  194. package/dist/engine/flow/map-steps.js +87 -0
  195. package/dist/{core → engine}/locate.d.ts +1 -1
  196. package/dist/{core → engine}/locate.js +1 -2
  197. package/dist/{mem-stub.d.ts → engine/mem/mem-stub.d.ts} +9 -8
  198. package/dist/{mem-stub.js → engine/mem/mem-stub.js} +2 -2
  199. package/dist/{mem-page.d.ts → engine/mem/mem.d.ts} +1 -1
  200. package/dist/{mem-page.js → engine/mem/mem.js} +2 -1
  201. package/dist/engine/page-gone.d.ts +5 -0
  202. package/dist/engine/page-gone.js +20 -0
  203. package/dist/engine/run/connect.d.ts +28 -0
  204. package/dist/{types.js → engine/run/connect.js} +11 -10
  205. package/dist/engine/run/events.d.ts +67 -0
  206. package/dist/engine/run/events.js +90 -0
  207. package/dist/engine/run/hooks.d.ts +16 -0
  208. package/dist/engine/run/hooks.js +8 -0
  209. package/dist/engine/run/launch.d.ts +13 -0
  210. package/dist/engine/run/launch.js +27 -0
  211. package/dist/{core/run-graph.d.ts → engine/run/run.d.ts} +8 -12
  212. package/dist/{core/run-graph.js → engine/run/run.js} +22 -12
  213. package/dist/engine/stub/pace.d.ts +12 -0
  214. package/dist/engine/stub/pace.js +2 -0
  215. package/dist/engine/stub/ring.d.ts +130 -0
  216. package/dist/engine/stub/ring.js +41 -0
  217. package/dist/engine/stub/stub.d.ts +268 -0
  218. package/dist/engine/stub/stub.js +1 -0
  219. package/dist/engine/stub/todos.d.ts +104 -0
  220. package/dist/engine/stub/todos.js +2 -0
  221. package/dist/engine/stub/viewport.d.ts +26 -0
  222. package/dist/engine/stub/viewport.js +2 -0
  223. package/dist/{trait.d.ts → engine/trait/trait.d.ts} +1 -1
  224. package/dist/{trait.js → engine/trait/trait.js} +1 -1
  225. package/dist/index.d.ts +88 -36
  226. package/dist/index.js +46 -19
  227. package/dist/live/auto/auto.d.ts +22 -0
  228. package/dist/live/auto/auto.js +207 -0
  229. package/dist/{session/auto-explore.d.ts → live/auto/explore.d.ts} +4 -14
  230. package/dist/{session/auto-explore.js → live/auto/explore.js} +21 -127
  231. package/dist/live/auto/mem.d.ts +11 -0
  232. package/dist/live/auto/mem.js +85 -0
  233. package/dist/live/auto/menu.d.ts +30 -0
  234. package/dist/live/auto/menu.js +335 -0
  235. package/dist/live/auto-session/auto-session.d.ts +113 -0
  236. package/dist/live/auto-session/auto-session.js +452 -0
  237. package/dist/live/auto-session/console.d.ts +4 -0
  238. package/dist/live/auto-session/console.js +41 -0
  239. package/dist/live/auto-session/files.d.ts +44 -0
  240. package/dist/live/auto-session/files.js +145 -0
  241. package/dist/{auto-session → live/auto-session}/helpers.d.ts +9 -5
  242. package/dist/{auto-session → live/auto-session}/helpers.js +18 -1
  243. package/dist/live/auto-session/inspect.d.ts +4 -0
  244. package/dist/live/auto-session/inspect.js +75 -0
  245. package/dist/{session/auto-session-ipc.d.ts → live/auto-session/ipc.d.ts} +8 -25
  246. package/dist/{session/auto-session-ipc.js → live/auto-session/ipc.js} +36 -161
  247. package/dist/live/auto-session/open-browser.d.ts +6 -0
  248. package/dist/live/auto-session/open-browser.js +47 -0
  249. package/dist/{session/browser.d.ts → live/auto-session/start.d.ts} +1 -2
  250. package/dist/{session/browser.js → live/auto-session/start.js} +2 -3
  251. package/dist/{pilot-overlay → live/pilot}/panel.d.ts +1 -1
  252. package/dist/{pilot-overlay → live/pilot}/panel.js +23 -31
  253. package/dist/{session → live/pilot}/pilot.d.ts +3 -3
  254. package/dist/{session → live/pilot}/pilot.js +5 -4
  255. package/dist/{traverse/run.d.ts → live/traverse/traverse.d.ts} +1 -1
  256. package/dist/live/traverse/traverse.js +212 -0
  257. package/dist/live/traverse/worker.d.ts +37 -0
  258. package/dist/live/traverse/worker.js +200 -0
  259. package/dist/manifest/manifest.d.ts +52 -0
  260. package/dist/manifest/manifest.js +93 -0
  261. package/dist/manifest/map-imports.d.ts +7 -0
  262. package/dist/manifest/map-imports.js +22 -0
  263. package/dist/manifest/maps.d.ts +33 -0
  264. package/dist/manifest/maps.js +62 -0
  265. package/dist/manifest/pack.d.ts +21 -0
  266. package/dist/manifest/pack.js +109 -0
  267. package/dist/manifest/project.d.ts +60 -0
  268. package/dist/manifest/project.js +101 -0
  269. package/dist/{session/block-inject.js → manifest/roots.js} +1 -18
  270. package/dist/manifest/scan.d.ts +19 -0
  271. package/dist/manifest/scan.js +57 -0
  272. package/dist/manifest/source.d.ts +23 -0
  273. package/dist/manifest/source.js +86 -0
  274. package/dist/runner/mode.d.ts +71 -0
  275. package/dist/runner/mode.js +1 -0
  276. package/dist/runner/modes/branches.d.ts +5 -0
  277. package/dist/runner/modes/branches.js +37 -0
  278. package/dist/runner/modes/demo.d.ts +3 -0
  279. package/dist/runner/modes/demo.js +13 -0
  280. package/dist/runner/modes/report.d.ts +2 -0
  281. package/dist/runner/modes/report.js +54 -0
  282. package/dist/runner/modes/run.d.ts +2 -0
  283. package/dist/runner/modes/run.js +3 -0
  284. package/dist/runner/options.d.ts +31 -0
  285. package/dist/runner/options.js +42 -0
  286. package/dist/runner/plan/find.d.ts +18 -0
  287. package/dist/runner/plan/find.js +65 -0
  288. package/dist/runner/plan/plan.d.ts +11 -0
  289. package/dist/runner/plan/plan.js +97 -0
  290. package/dist/runner/plan/seed-mem.d.ts +12 -0
  291. package/dist/runner/plan/seed-mem.js +98 -0
  292. package/dist/runner/plan/spec.d.ts +5 -0
  293. package/dist/runner/plan/spec.js +17 -0
  294. package/dist/runner/play-steps.d.ts +2 -0
  295. package/dist/runner/play-steps.js +59 -0
  296. package/dist/runner/runner.d.ts +4 -0
  297. package/dist/runner/runner.js +64 -0
  298. package/dist/runner/session.d.ts +9 -0
  299. package/dist/runner/session.js +87 -0
  300. package/dist/{browser.js → runtime/browser.js} +4 -2
  301. package/dist/{env-file.js → runtime/env-file.js} +7 -12
  302. package/dist/{extensions.d.ts → runtime/extensions.d.ts} +1 -5
  303. package/dist/{extensions.js → runtime/extensions.js} +2 -1
  304. package/dist/runtime/full-launch.d.ts +1 -0
  305. package/dist/runtime/full-launch.js +34 -0
  306. package/dist/runtime/global-flag.d.ts +5 -0
  307. package/dist/runtime/global-flag.js +18 -0
  308. package/dist/{playwright-config.d.ts → runtime/playwright-config.d.ts} +1 -1
  309. package/dist/{playwright.config.js → runtime/playwright.config.js} +3 -2
  310. package/dist/runtime/run-log.d.ts +2 -0
  311. package/dist/runtime/run-log.js +17 -0
  312. package/dist/{video-dir.js → runtime/video-dir.js} +3 -2
  313. package/dist/{config.d.ts → runtime/waygraph-config.d.ts} +6 -9
  314. package/dist/{config.js → runtime/waygraph-config.js} +21 -51
  315. package/dist/{webserver.js → runtime/webserver.js} +5 -30
  316. package/examples/routed-demo/config/waygraph.config.ts +20 -0
  317. package/examples/routed-demo/package.json +1 -4
  318. package/examples/routed-demo/scripts/fixture-server.mjs +1 -1
  319. package/examples/routed-demo/src/flows/routed-demo-map.flow.ts +2 -4
  320. package/examples/routed-demo/src/flows/routed-demo.flow.ts +1 -2
  321. package/examples/routed-demo/src/map/(app_base)/dashboard/_methods/click-widget.block.ts +5 -4
  322. package/examples/routed-demo/src/map/(app_base)/dashboard/_nav.block.ts +3 -3
  323. package/examples/routed-demo/src/map/(app_base)/dashboard/_page.block.ts +3 -3
  324. package/examples/routed-demo/src/map/(external)/docs/_nav.block.ts +3 -3
  325. package/examples/routed-demo/src/map/(external)/docs/_page.block.ts +3 -3
  326. package/examples/routed-demo/src/states/routed-demo.states.ts +5 -3
  327. package/examples/routed-demo/tests/routed-demo.spec.ts +4 -4
  328. package/examples/routed-demo/tsconfig.json +1 -1
  329. package/examples/saucedemo/docs/CONVENTION.md +4 -5
  330. package/examples/saucedemo/docs/HELPERS.md +11 -11
  331. package/examples/saucedemo/src/blocks/SITE-MAP.md +0 -1
  332. package/examples/saucedemo/src/blocks/saucedemo-web/NAV.md +1 -5
  333. package/examples/saucedemo/src/blocks/saucedemo-web/cart/nav-cart.block.ts +3 -3
  334. package/examples/saucedemo/src/blocks/saucedemo-web/cart/nav-checkout-info.block.ts +3 -3
  335. package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-one/methods/fill-first-name.method.block.ts +5 -4
  336. package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-one/methods/fill-last-name.method.block.ts +5 -4
  337. package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-one/methods/fill-postal-code.method.block.ts +5 -4
  338. package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-one/methods/submit-checkout-info.method.block.ts +5 -4
  339. package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.ts +5 -8
  340. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/inventory.page.block.ts +3 -3
  341. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/methods/add-all-to-cart.method.block.ts +4 -6
  342. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/methods/add-to-cart.effect.block.ts +35 -43
  343. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/methods/remove-all-from-cart.method.block.ts +4 -6
  344. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/methods/remove-from-cart.effect.block.ts +4 -3
  345. package/examples/saucedemo/src/blocks/saucedemo-web/inventory/nav-item-detail.block.ts +3 -3
  346. package/examples/saucedemo/src/blocks/saucedemo-web/inventory-item/nav-back-to-inventory.block.ts +3 -3
  347. package/examples/saucedemo/src/blocks/saucedemo-web/inventory-item/nav-back-to-products.block.ts +3 -3
  348. package/examples/saucedemo/src/blocks/saucedemo-web/inventory-item/nav-continue-shopping.block.ts +3 -3
  349. package/examples/saucedemo/src/blocks/saucedemo-web/methods/fill-password.method.block.ts +5 -4
  350. package/examples/saucedemo/src/blocks/saucedemo-web/methods/fill-username.method.block.ts +5 -4
  351. package/examples/saucedemo/src/blocks/saucedemo-web/methods/submit-login.method.block.ts +4 -5
  352. package/examples/saucedemo/src/blocks/saucedemo-web/methods/submit-logout.method.block.ts +5 -4
  353. package/examples/saucedemo/src/blocks/saucedemo-web/nav-login.block.ts +3 -3
  354. package/examples/saucedemo/src/flows/api-demo.flow.ts +12 -10
  355. package/examples/saucedemo/src/states/checkout.states.ts +21 -11
  356. package/examples/saucedemo/src/stubs/device-showcase.ts +8 -10
  357. package/examples/saucedemo/tests/auto-graph.spec.ts +4 -12
  358. package/package.json +14 -6
  359. package/templates/agents/waygraph-planner.agent.md +2 -2
  360. package/templates/quickstart/docs/CONVENTION.md +4 -4
  361. package/templates/quickstart/docs/HELPERS.md +10 -8
  362. package/templates/quickstart/package.json +0 -3
  363. package/templates/quickstart/src/blocks/SITE-MAP.md +0 -1
  364. package/templates/quickstart/src/blocks/saucedemo-web/NAV.md +1 -5
  365. package/templates/quickstart/src/blocks/saucedemo-web/cart/nav-cart.block.ts +3 -3
  366. package/templates/quickstart/src/blocks/saucedemo-web/cart/nav-checkout-info.block.ts +3 -3
  367. package/templates/quickstart/src/blocks/saucedemo-web/checkout-step-one/methods/fill-first-name.method.block.ts +5 -4
  368. package/templates/quickstart/src/blocks/saucedemo-web/checkout-step-one/methods/fill-last-name.method.block.ts +5 -4
  369. package/templates/quickstart/src/blocks/saucedemo-web/checkout-step-one/methods/fill-postal-code.method.block.ts +5 -4
  370. package/templates/quickstart/src/blocks/saucedemo-web/checkout-step-one/methods/submit-checkout-info.method.block.ts +5 -4
  371. package/templates/quickstart/src/blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.ts +5 -8
  372. package/templates/quickstart/src/blocks/saucedemo-web/inventory/inventory.page.block.ts +3 -3
  373. package/templates/quickstart/src/blocks/saucedemo-web/inventory/methods/add-all-to-cart.method.block.ts +4 -6
  374. package/templates/quickstart/src/blocks/saucedemo-web/inventory/methods/add-to-cart.effect.block.ts +35 -43
  375. package/templates/quickstart/src/blocks/saucedemo-web/inventory/methods/remove-all-from-cart.method.block.ts +4 -6
  376. package/templates/quickstart/src/blocks/saucedemo-web/inventory/methods/remove-from-cart.effect.block.ts +4 -3
  377. package/templates/quickstart/src/blocks/saucedemo-web/inventory/nav-item-detail.block.ts +3 -3
  378. package/templates/quickstart/src/blocks/saucedemo-web/inventory-item/nav-back-to-inventory.block.ts +3 -3
  379. package/templates/quickstart/src/blocks/saucedemo-web/inventory-item/nav-back-to-products.block.ts +3 -3
  380. package/templates/quickstart/src/blocks/saucedemo-web/inventory-item/nav-continue-shopping.block.ts +3 -3
  381. package/templates/quickstart/src/blocks/saucedemo-web/methods/fill-password.method.block.ts +5 -4
  382. package/templates/quickstart/src/blocks/saucedemo-web/methods/fill-username.method.block.ts +5 -4
  383. package/templates/quickstart/src/blocks/saucedemo-web/methods/submit-login.method.block.ts +4 -5
  384. package/templates/quickstart/src/blocks/saucedemo-web/methods/submit-logout.method.block.ts +5 -4
  385. package/templates/quickstart/src/blocks/saucedemo-web/nav-login.block.ts +3 -3
  386. package/templates/quickstart/src/flows/api-demo.flow.ts +12 -10
  387. package/templates/quickstart/src/states/checkout.states.ts +21 -11
  388. package/templates/quickstart/src/stubs/device-showcase.ts +8 -10
  389. package/templates/scaffold/README.md +2 -1
  390. package/templates/scaffold/STRUCTURE.md +5 -4
  391. package/templates/scaffold/config/waygraph.config.ts +1 -0
  392. package/templates/scaffold/gitignore +1 -0
  393. package/templates/scaffold/src/flows/README.md +2 -2
  394. package/templates/scaffold/src/map/(app_base)/docs/_nav.block.ts +3 -3
  395. package/templates/scaffold/src/map/(app_base)/docs/_page.block.ts +3 -3
  396. package/templates/scaffold/src/map/(app_base)/home/_methods/add-item.effect.block.ts +4 -4
  397. package/templates/scaffold/src/map/(app_base)/home/_methods/assert-hello.method.block.ts +3 -3
  398. package/templates/scaffold/src/map/(app_base)/home/_methods/assert-item-added.method.block.ts +3 -3
  399. package/templates/scaffold/src/map/(app_base)/home/_methods/clear-cart.method.block.ts +5 -4
  400. package/templates/scaffold/src/map/(app_base)/home/_methods/remove-item.effect.block.ts +4 -4
  401. package/templates/scaffold/src/map/(app_base)/home/_nav.block.ts +3 -3
  402. package/templates/scaffold/src/map/(app_base)/home/_page.block.ts +3 -3
  403. package/templates/scaffold/src/map/(app_base)/home/nav-verification-link.block.ts +4 -4
  404. package/templates/scaffold/src/map/(external)/hoppscotch/_keys.ts +21 -0
  405. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/assert-response-body.method.block.ts +4 -4
  406. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/assert-response-header.method.block.ts +4 -4
  407. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/assert-status.method.block.ts +4 -4
  408. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/pick-extension-interceptor.method.block.ts +5 -4
  409. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/read-response-body.method.block.ts +6 -5
  410. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/read-response-headers.method.block.ts +6 -5
  411. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/send-request.method.block.ts +5 -4
  412. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-bearer-token.method.block.ts +6 -5
  413. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-headers.method.block.ts +6 -5
  414. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-json-body.method.block.ts +6 -5
  415. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-method.method.block.ts +6 -5
  416. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-query-params.method.block.ts +6 -5
  417. package/templates/scaffold/src/map/(external)/hoppscotch/_methods/set-url.method.block.ts +6 -5
  418. package/templates/scaffold/src/map/(external)/hoppscotch/_nav.block.ts +3 -3
  419. package/templates/scaffold/src/map/(external)/hoppscotch/_page.block.ts +3 -3
  420. package/templates/scaffold/src/map/(external)/hoppscotch/_states.ts +6 -0
  421. package/templates/scaffold/src/map/(external)/hoppscotch/settings/_nav.block.ts +3 -3
  422. package/templates/scaffold/src/map/(external)/mailpit/_keys.ts +13 -0
  423. package/templates/scaffold/src/map/(external)/mailpit/_methods/assert-email-content.method.block.ts +4 -4
  424. package/templates/scaffold/src/map/(external)/mailpit/_methods/assert-email-received.method.block.ts +4 -4
  425. package/templates/scaffold/src/map/(external)/mailpit/_methods/extract-email-link.method.block.ts +6 -5
  426. package/templates/scaffold/src/map/(external)/mailpit/_methods/open-message.method.block.ts +6 -5
  427. package/templates/scaffold/src/map/(external)/mailpit/_nav.block.ts +3 -3
  428. package/templates/scaffold/src/map/(external)/mailpit/_page.block.ts +3 -3
  429. package/templates/scaffold/src/map/(external)/mailpit/_states.ts +9 -0
  430. package/templates/scaffold/src/map/README.md +7 -0
  431. package/templates/scaffold/src/states/README.md +4 -1
  432. package/templates/scaffold/src/states/demo.mem-keys.ts +1 -29
  433. package/templates/scaffold/src/states/demo.states.ts +14 -20
  434. package/templates/scaffold/tests/hoppscotch.spec.ts +1 -11
  435. package/templates/scaffold/tests/mail-verify.spec.ts +2 -2
  436. package/templates/skills/waygraph-blind-pilot.skill.md +2 -6
  437. package/templates/skills/waygraph-convention.skill.md +23 -14
  438. package/templates/skills/waygraph-pilot.skill.md +7 -4
  439. package/dist/auto-session/session.d.ts +0 -193
  440. package/dist/auto-session/session.js +0 -719
  441. package/dist/auto-session/verbose-log.js +0 -16
  442. package/dist/auto-session.d.ts +0 -2
  443. package/dist/auto-session.js +0 -3
  444. package/dist/cli/discover.d.ts +0 -40
  445. package/dist/cli/discover.js +0 -148
  446. package/dist/commands/agent-dive.js +0 -52
  447. package/dist/commands/check.js +0 -192
  448. package/dist/commands/map.js +0 -29
  449. package/dist/commands/run.js +0 -104
  450. package/dist/commands/session.js +0 -600
  451. package/dist/commands/traverse.js +0 -177
  452. package/dist/core/block.d.ts +0 -109
  453. package/dist/core/blocks/effect.js +0 -23
  454. package/dist/core/config.js +0 -17
  455. package/dist/core/engine.d.ts +0 -198
  456. package/dist/core/flow.d.ts +0 -294
  457. package/dist/core/flow.js +0 -432
  458. package/dist/core/map-builder.js +0 -383
  459. package/dist/core.d.ts +0 -14
  460. package/dist/core.js +0 -15
  461. package/dist/highlights/merge.d.ts +0 -8
  462. package/dist/highlights/merge.js +0 -173
  463. package/dist/highlights/run-phase.d.ts +0 -43
  464. package/dist/highlights/stub-ctx.d.ts +0 -10
  465. package/dist/highlights/stub-ctx.js +0 -331
  466. package/dist/highlights/types.d.ts +0 -613
  467. package/dist/highlights.d.ts +0 -9
  468. package/dist/highlights.js +0 -10
  469. package/dist/pilot-overlay.d.ts +0 -5
  470. package/dist/pilot-overlay.js +0 -6
  471. package/dist/runner/banner-log.js +0 -63
  472. package/dist/runner/chain-run.js +0 -102
  473. package/dist/runner/cursor.js +0 -140
  474. package/dist/runner/demo-log.js +0 -316
  475. package/dist/runner/device-stage.d.ts +0 -9
  476. package/dist/runner/device-stage.js +0 -420
  477. package/dist/runner/discovery.js +0 -105
  478. package/dist/runner/index.js +0 -2
  479. package/dist/runner/inpage/banner.d.ts +0 -21
  480. package/dist/runner/inpage/banner.js +0 -156
  481. package/dist/runner/inpage/caption.d.ts +0 -3
  482. package/dist/runner/inpage/caption.js +0 -23
  483. package/dist/runner/inpage/core.d.ts +0 -4
  484. package/dist/runner/inpage/core.js +0 -316
  485. package/dist/runner/inpage/device.d.ts +0 -3
  486. package/dist/runner/inpage/device.js +0 -211
  487. package/dist/runner/inpage/network.d.ts +0 -15
  488. package/dist/runner/inpage/network.js +0 -217
  489. package/dist/runner/inpage/panel-chrome.js +0 -192
  490. package/dist/runner/inpage/stamp.js +0 -46
  491. package/dist/runner/inpage/swipe-zoom.js +0 -220
  492. package/dist/runner/inpage/todos.js +0 -337
  493. package/dist/runner/interaction-patch.js +0 -384
  494. package/dist/runner/main.js +0 -469
  495. package/dist/runner/network-capture.d.ts +0 -9
  496. package/dist/runner/network-capture.js +0 -126
  497. package/dist/runner/overlay-css.d.ts +0 -3
  498. package/dist/runner/overlay-css.js +0 -377
  499. package/dist/runner/overlay-install.js +0 -90
  500. package/dist/runner/overlay-stage.js +0 -110
  501. package/dist/runner/rings.js +0 -514
  502. package/dist/runner/seed-mem.js +0 -110
  503. package/dist/runner/slides.js +0 -278
  504. package/dist/runner/step-mode.js +0 -703
  505. package/dist/runner/step-panels.js +0 -729
  506. package/dist/runner/teardown.js +0 -202
  507. package/dist/runner/todo-dock.js +0 -142
  508. package/dist/session/auto-explore-run.d.ts +0 -40
  509. package/dist/session/auto-explore-run.js +0 -707
  510. package/dist/session/step-overlay.d.ts +0 -37
  511. package/dist/session/step-overlay.js +0 -244
  512. package/dist/traverse/run.js +0 -423
  513. package/examples/routed-demo/playwright.config.ts +0 -21
  514. package/examples/saucedemo/src/blocks/saucedemo-web/ff-owner-auth.block.ts +0 -22
  515. package/templates/quickstart/src/blocks/saucedemo-web/ff-owner-auth.block.ts +0 -22
  516. /package/dist/{commands → cli/commands}/agent-dive-scaffold.d.ts +0 -0
  517. /package/dist/{commands → cli/commands}/agent-dive.d.ts +0 -0
  518. /package/dist/{commands → cli/commands}/extensions.d.ts +0 -0
  519. /package/dist/{commands → cli/commands}/init.d.ts +0 -0
  520. /package/dist/{commands → cli/commands}/list.d.ts +0 -0
  521. /package/dist/{commands → cli/commands}/map.d.ts +0 -0
  522. /package/dist/{commands → cli/commands}/session.d.ts +0 -0
  523. /package/dist/{commands → cli/commands}/test.d.ts +0 -0
  524. /package/dist/{commands → cli/commands}/traverse.d.ts +0 -0
  525. /package/dist/{commands → cli/commands}/try.d.ts +0 -0
  526. /package/dist/{commands → cli/commands}/upgrade.d.ts +0 -0
  527. /package/dist/{highlights → demo/narration}/shorthand.js +0 -0
  528. /package/dist/{session/overlay-beacon.d.ts → demo/overlay/beacon.d.ts} +0 -0
  529. /package/dist/{session/overlay-beacon.js → demo/overlay/beacon.js} +0 -0
  530. /package/dist/{pilot-overlay/action-ring.d.ts → demo/overlay/pilot/actions.d.ts} +0 -0
  531. /package/dist/{ui → demo/overlay/ui}/components/ring.d.ts +0 -0
  532. /package/dist/{ui → demo/overlay/ui}/stylesheet.d.ts +0 -0
  533. /package/dist/{ui → demo/overlay/ui}/stylesheet.js +0 -0
  534. /package/dist/{ui → demo/overlay/ui}/tokens.d.ts +0 -0
  535. /package/dist/{ui → demo/overlay/ui}/tokens.js +0 -0
  536. /package/dist/{highlights → demo}/types.js +0 -0
  537. /package/dist/{auto-session → demo}/verbose-log.d.ts +0 -0
  538. /package/dist/{selector.d.ts → engine/trait/selector.d.ts} +0 -0
  539. /package/dist/{selector.js → engine/trait/selector.js} +0 -0
  540. /package/dist/{traverse → live/traverse}/coverage.d.ts +0 -0
  541. /package/dist/{traverse → live/traverse}/coverage.js +0 -0
  542. /package/dist/{traverse → live/traverse}/lease.d.ts +0 -0
  543. /package/dist/{traverse → live/traverse}/lease.js +0 -0
  544. /package/dist/{session/block-inject.d.ts → manifest/roots.d.ts} +0 -0
  545. /package/dist/{blocks-select.d.ts → manifest/select.d.ts} +0 -0
  546. /package/dist/{blocks-select.js → manifest/select.js} +0 -0
  547. /package/dist/{browser.d.ts → runtime/browser.d.ts} +0 -0
  548. /package/dist/{env-file.d.ts → runtime/env-file.d.ts} +0 -0
  549. /package/dist/{playwright-config.js → runtime/playwright-config.js} +0 -0
  550. /package/dist/{playwright.config.d.ts → runtime/playwright.config.d.ts} +0 -0
  551. /package/dist/{video-dir.d.ts → runtime/video-dir.d.ts} +0 -0
  552. /package/dist/{webserver.d.ts → runtime/webserver.d.ts} +0 -0
@@ -1,600 +0,0 @@
1
- // Split out of the former 8,700-line cli.ts (see src/ARCHITECTURE.md). Behavior unchanged.
2
- import { printBrowserSessionsList, printBrowserUsage } from "../cli/usage.js";
3
- import { applyRunFlags, looksLikeFlowFileRef, parseRunFlags, resolveBaseUrl } from "../cli/flags.js";
4
- import { runChain } from "../cli/run-chain.js";
5
- import { runChainAuto } from "./check.js";
6
- import { resolve } from "node:path";
7
- import { browserStart, listBrowserSessions, stopAllBrowserSessions, stopBrowserSession } from "../session/browser.js";
8
- import { existsSync, statSync } from "node:fs";
9
- import { resolveInjectRoots } from "../session/block-inject.js";
10
- import { requestSession, resolveSessionMeta, runAttachLoop, runAutoServeCommand, spawnDetachedSession } from "../session/auto-session-ipc.js";
11
- import { pilotAttach, pilotStart } from "../session/pilot.js";
12
- import { parseHighlightShorthand } from "../highlights/shorthand.js";
13
- import { isFileSelectToken, parseBlocksSelect } from "../blocks-select.js";
14
- import { runAutoExplore } from "../session/auto-explore-run.js";
15
- import { discoverGraph, findOrphanBlocks, toMermaid } from "../analysis/graph.js";
16
- export async function sessionCase(args, command) {
17
- if (command === "browser") {
18
- const sub = args[1];
19
- if (sub === "sessions") {
20
- const rest = args.slice(2);
21
- const json = rest.includes("--json");
22
- const positional = rest.filter((a) => a !== "--json");
23
- const proj = resolve(positional[0] ?? process.cwd());
24
- const sessions = listBrowserSessions(proj);
25
- if (json) {
26
- console.log(JSON.stringify(sessions, null, 2));
27
- }
28
- else {
29
- printBrowserSessionsList(sessions, proj);
30
- }
31
- return;
32
- }
33
- if (sub === "stop") {
34
- const proj = resolve(args[3] ?? process.cwd());
35
- const target = args[2];
36
- if (!target) {
37
- console.error("waygraph browser stop: usage: waygraph browser stop <sessionId|--all> [project]");
38
- process.exit(1);
39
- }
40
- if (target === "--all") {
41
- const n = stopAllBrowserSessions(proj);
42
- console.log(JSON.stringify({ stopped: n, projectDir: proj }));
43
- return;
44
- }
45
- if (!stopBrowserSession(proj, target)) {
46
- console.error(`waygraph browser stop: no such session "${target}"`);
47
- process.exit(1);
48
- }
49
- console.log(JSON.stringify({ stopped: target }));
50
- return;
51
- }
52
- if (!sub) {
53
- printBrowserUsage();
54
- return;
55
- }
56
- if (sub === "start" || sub.startsWith("-")) {
57
- const flagArgs = sub === "start" ? args.slice(2) : args.slice(1);
58
- const flags = parseRunFlags(flagArgs);
59
- applyRunFlags(flags);
60
- const proj = resolve(flags.positionals[0] ?? process.cwd());
61
- if (!existsSync(proj)) {
62
- console.error(`waygraph browser: no such directory: ${proj}`);
63
- process.exit(1);
64
- }
65
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
66
- try {
67
- const inject = flags.inject?.length ? resolveInjectRoots(flags.inject, proj) : undefined;
68
- const result = await browserStart({
69
- projectDir: proj,
70
- ...(inject?.length ? { inject } : {}),
71
- ...(baseURL ? { baseURL } : {}),
72
- ...(flags.goto
73
- ? { startUrl: flags.goto, skipInitialNavigation: false }
74
- : { skipInitialNavigation: flags.blank !== false }),
75
- headless: flags.headlessBrowser === true,
76
- });
77
- console.log(JSON.stringify(result));
78
- if (!result.headless) {
79
- console.error(`Session ${result.sessionId} started. List all: waygraph browser sessions`);
80
- }
81
- if (flags.cli) {
82
- await runAttachLoop(proj, result.sessionId);
83
- }
84
- }
85
- catch (err) {
86
- console.error(`waygraph browser start: ${err instanceof Error ? err.message : String(err)}`);
87
- process.exit(1);
88
- }
89
- return;
90
- }
91
- if (sub !== "send" &&
92
- sub !== "status" &&
93
- sub !== "attach" &&
94
- sub !== "dom" &&
95
- sub !== "trace" &&
96
- sub !== "console" &&
97
- sub !== "storage" &&
98
- sub !== "upload" &&
99
- sub !== "click" &&
100
- sub !== "type" &&
101
- sub !== "press" &&
102
- sub !== "goto" &&
103
- sub !== "reload" &&
104
- sub !== "reach" &&
105
- sub !== "resync" &&
106
- sub !== "highlight") {
107
- console.error("waygraph browser: unknown subcommand — run `waygraph browser` for usage");
108
- printBrowserUsage();
109
- process.exit(1);
110
- }
111
- }
112
- if (command === "pilot") {
113
- if (args[1] === "sessions") {
114
- const rest = args.slice(2);
115
- const json = rest.includes("--json");
116
- const positional = rest.filter((a) => a !== "--json");
117
- const proj = resolve(positional[0] ?? process.cwd());
118
- const sessions = listBrowserSessions(proj);
119
- if (json) {
120
- console.log(JSON.stringify(sessions, null, 2));
121
- }
122
- else {
123
- printBrowserSessionsList(sessions, proj);
124
- }
125
- return;
126
- }
127
- if (args[1] === "attach") {
128
- const sessionId = args[2];
129
- if (!sessionId) {
130
- console.error("waygraph pilot attach: usage: waygraph pilot attach <sessionId> [--inject …] [project]");
131
- process.exit(1);
132
- }
133
- const flags = parseRunFlags(args.slice(3));
134
- const proj = resolve(flags.positionals[0] ?? process.cwd());
135
- try {
136
- const inject = flags.inject?.length ? resolveInjectRoots(flags.inject, proj) : undefined;
137
- const result = await pilotAttach(proj, sessionId, inject);
138
- console.log(JSON.stringify(result));
139
- }
140
- catch (err) {
141
- console.error(`waygraph pilot attach: ${err instanceof Error ? err.message : String(err)}`);
142
- process.exit(1);
143
- }
144
- return;
145
- }
146
- if (args[1] === "start" || !args[1] || args[1].startsWith("-")) {
147
- const flagArgs = args[1] === "start" ? args.slice(2) : args.slice(1);
148
- const flags = parseRunFlags(flagArgs);
149
- applyRunFlags(flags);
150
- const proj = resolve(flags.positionals[0] ?? process.cwd());
151
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
152
- try {
153
- const result = await pilotStart({
154
- projectDir: proj,
155
- ...(flags.inject?.length ? { injectTokens: flags.inject } : {}),
156
- ...(baseURL ? { baseURL } : {}),
157
- ...(flags.goto
158
- ? { startUrl: flags.goto, skipInitialNavigation: false }
159
- : flags.blank === true
160
- ? { skipInitialNavigation: true }
161
- : {}),
162
- headless: flags.headlessBrowser === true,
163
- });
164
- console.log(JSON.stringify(result));
165
- if (!result.headless) {
166
- console.error(`Chromium window opened (session ${result.sessionId}). ` +
167
- `Terminal menu: waygraph pilot attach ${result.sessionId}`);
168
- }
169
- if (flags.cli) {
170
- await runAttachLoop(proj, result.sessionId);
171
- }
172
- }
173
- catch (err) {
174
- console.error(`waygraph pilot start: ${err instanceof Error ? err.message : String(err)}`);
175
- process.exit(1);
176
- }
177
- return;
178
- }
179
- if (args[1] !== "send" &&
180
- args[1] !== "status" &&
181
- args[1] !== "dom" &&
182
- args[1] !== "trace" &&
183
- args[1] !== "console" &&
184
- args[1] !== "storage" &&
185
- args[1] !== "upload" &&
186
- args[1] !== "click" &&
187
- args[1] !== "type" &&
188
- args[1] !== "press" &&
189
- args[1] !== "goto" &&
190
- args[1] !== "reload" &&
191
- args[1] !== "reach" &&
192
- args[1] !== "resync" &&
193
- args[1] !== "highlight") {
194
- console.error("waygraph pilot: usage:\n" +
195
- " waygraph pilot start [--inject …] [--goto <url>] [--headless] [--cli] [--base-url <url>] [project]\n" +
196
- " waygraph pilot sessions [project] # list live browser sessions\n" +
197
- " waygraph pilot attach <sessionId> # graph + snapshot for an existing session\n" +
198
- " waygraph pilot send|status|attach|highlight|… <sessionId> … (controls browser — same as browser/auto)");
199
- process.exit(1);
200
- }
201
- }
202
- // auto send|status|attach <sessionId> - session control against a
203
- // --detach'd background session. Intercepted before the normal
204
- // project-directory resolution below, same pattern `try demo|auto|
205
- // auto:cli` already uses for a sub-verb positional.
206
- if ((command === "auto" || command === "browser" || command === "pilot") &&
207
- (args[1] === "send" ||
208
- args[1] === "status" ||
209
- (args[1] === "attach" && command !== "pilot") ||
210
- args[1] === "dom" ||
211
- args[1] === "trace" ||
212
- args[1] === "console" ||
213
- args[1] === "storage" ||
214
- args[1] === "upload" ||
215
- args[1] === "click" ||
216
- args[1] === "type" ||
217
- args[1] === "press" ||
218
- args[1] === "goto" ||
219
- args[1] === "reload" ||
220
- args[1] === "reach" ||
221
- args[1] === "resync" ||
222
- args[1] === "highlight")) {
223
- const sub = args[1];
224
- const sessionId = args[2];
225
- if (!sessionId) {
226
- console.error(`waygraph ${command} ${sub}: missing <sessionId>`);
227
- process.exit(1);
228
- }
229
- const projHint = resolve(process.cwd());
230
- const meta = resolveSessionMeta(sessionId, projHint);
231
- if (!meta) {
232
- console.error(`waygraph ${command} ${sub}: no such session "${sessionId}" — ` +
233
- "wrong directory? run `waygraph pilot sessions` from the project that started it");
234
- process.exit(1);
235
- }
236
- const proj = meta.projectDir;
237
- if (sub === "attach") {
238
- await runAttachLoop(proj, sessionId);
239
- return;
240
- }
241
- if (sub === "send") {
242
- const pick = args[3];
243
- if (pick === undefined) {
244
- console.error('waygraph auto send: usage: waygraph auto send <sessionId> "<pick>" [--timeout <ms>]');
245
- process.exit(1);
246
- }
247
- // Real, direct need found live: a single Block can legitimately
248
- // run a genuinely slow real interaction (e.g. a multi-step mouse
249
- // drag) that exceeds the 15s default - same reasoning `auto
250
- // reach` already gets a 90s default for (multiple Blocks in one
251
- // call). Unlike reach, send has no way to know ahead of time
252
- // whether the ONE Block it's running is fast or slow, so this is
253
- // opt-in via a flag rather than a raised default.
254
- let timeoutMs;
255
- for (let i = 4; i < args.length; i++) {
256
- if (args[i] === "--timeout") {
257
- const raw = args[++i];
258
- const n = Number(raw);
259
- if (!Number.isFinite(n) || n <= 0) {
260
- console.error(`waygraph auto send: --timeout must be a positive number of ms, got "${raw}"`);
261
- process.exit(1);
262
- }
263
- timeoutMs = n;
264
- }
265
- }
266
- const res = await requestSession(proj, sessionId, { op: "send", pick }, timeoutMs);
267
- console.log(JSON.stringify(res));
268
- if (!res.ok)
269
- process.exitCode = 1;
270
- return;
271
- }
272
- if (sub === "dom") {
273
- const domArgs = args.slice(3);
274
- let mode;
275
- let selector;
276
- let depth;
277
- for (let i = 0; i < domArgs.length; i++) {
278
- const a = domArgs[i];
279
- if (a === "--mode" || a.startsWith("--mode=")) {
280
- const v = a.startsWith("--mode=") ? a.slice("--mode=".length) : domArgs[++i];
281
- if (v !== "aria" && v !== "full") {
282
- console.error(`waygraph auto dom: --mode must be "aria" or "full", got "${v}"`);
283
- process.exit(1);
284
- }
285
- mode = v;
286
- }
287
- else if (a === "--selector" || a.startsWith("--selector=")) {
288
- selector = a.startsWith("--selector=") ? a.slice("--selector=".length) : domArgs[++i];
289
- }
290
- else if (a === "--depth" || a.startsWith("--depth=")) {
291
- const raw = a.startsWith("--depth=") ? a.slice("--depth=".length) : domArgs[++i];
292
- const n = Number(raw);
293
- if (!Number.isInteger(n) || n < 1) {
294
- console.error(`waygraph auto dom: --depth must be a positive integer, got "${raw}"`);
295
- process.exit(1);
296
- }
297
- depth = n;
298
- }
299
- else {
300
- console.error(`waygraph auto dom: unrecognized argument "${a}"`);
301
- process.exit(1);
302
- }
303
- }
304
- const res = await requestSession(proj, sessionId, {
305
- op: "dom",
306
- ...(mode ? { mode } : {}),
307
- ...(selector ? { selector } : {}),
308
- ...(depth !== undefined ? { depth } : {}),
309
- });
310
- console.log(JSON.stringify(res));
311
- if (!res.ok)
312
- process.exitCode = 1;
313
- return;
314
- }
315
- if (sub === "trace") {
316
- const res = await requestSession(proj, sessionId, { op: "trace" });
317
- console.log(JSON.stringify(res));
318
- if (!res.ok)
319
- process.exitCode = 1;
320
- return;
321
- }
322
- if (sub === "console") {
323
- const res = await requestSession(proj, sessionId, { op: "console" });
324
- console.log(JSON.stringify(res));
325
- if (!res.ok)
326
- process.exitCode = 1;
327
- return;
328
- }
329
- if (sub === "storage") {
330
- const res = await requestSession(proj, sessionId, { op: "storage" });
331
- console.log(JSON.stringify(res));
332
- if (!res.ok)
333
- process.exitCode = 1;
334
- return;
335
- }
336
- if (sub === "click") {
337
- const selector = args[3];
338
- if (selector === undefined) {
339
- console.error('waygraph auto click: usage: waygraph auto click <sessionId> "<selector>"');
340
- process.exit(1);
341
- }
342
- const res = await requestSession(proj, sessionId, { op: "click", selector });
343
- console.log(JSON.stringify(res));
344
- if (!res.ok)
345
- process.exitCode = 1;
346
- return;
347
- }
348
- if (sub === "type") {
349
- const selector = args[3];
350
- const text = args[4];
351
- if (selector === undefined || text === undefined) {
352
- console.error('waygraph auto type: usage: waygraph auto type <sessionId> "<selector>" "<text>"');
353
- process.exit(1);
354
- }
355
- const res = await requestSession(proj, sessionId, { op: "type", selector, text });
356
- console.log(JSON.stringify(res));
357
- if (!res.ok)
358
- process.exitCode = 1;
359
- return;
360
- }
361
- if (sub === "press") {
362
- const selector = args[3];
363
- const key = args[4];
364
- if (selector === undefined || key === undefined) {
365
- console.error('waygraph auto press: usage: waygraph auto press <sessionId> "<selector>" <key>');
366
- process.exit(1);
367
- }
368
- const res = await requestSession(proj, sessionId, { op: "press", selector, key });
369
- console.log(JSON.stringify(res));
370
- if (!res.ok)
371
- process.exitCode = 1;
372
- return;
373
- }
374
- if (sub === "goto") {
375
- const url = args[3];
376
- if (url === undefined) {
377
- console.error("waygraph auto goto: usage: waygraph auto goto <sessionId> <url>");
378
- process.exit(1);
379
- }
380
- const res = await requestSession(proj, sessionId, { op: "goto", url });
381
- console.log(JSON.stringify(res));
382
- if (!res.ok)
383
- process.exitCode = 1;
384
- return;
385
- }
386
- if (sub === "upload") {
387
- const selector = args[3];
388
- const kindOrPath = args[4];
389
- if (selector === undefined || kindOrPath === undefined) {
390
- console.error('waygraph auto upload: usage: waygraph auto upload <sessionId> "<selector>" <image|pdf|video|path-to-file>');
391
- process.exit(1);
392
- }
393
- const stub = kindOrPath === "image" || kindOrPath === "pdf" || kindOrPath === "video"
394
- ? { selector, stub: kindOrPath }
395
- : { selector, stub: { filePath: resolve(process.cwd(), kindOrPath) } };
396
- const res = await requestSession(proj, sessionId, { op: "upload", ...stub });
397
- console.log(JSON.stringify(res));
398
- if (!res.ok)
399
- process.exitCode = 1;
400
- return;
401
- }
402
- if (sub === "reload") {
403
- const res = await requestSession(proj, sessionId, { op: "reload" });
404
- console.log(JSON.stringify(res));
405
- if (!res.ok)
406
- process.exitCode = 1;
407
- return;
408
- }
409
- if (sub === "reach") {
410
- const checkpoint = args[3];
411
- if (checkpoint === undefined) {
412
- console.error("waygraph auto reach: usage: waygraph auto reach <sessionId> <Checkpoint>");
413
- process.exit(1);
414
- }
415
- // Longer than every other op's default (15s): a real multi-step
416
- // route runs several real Blocks in sequence server-side before
417
- // responding - a legitimately slow single request, not a hang.
418
- const res = await requestSession(proj, sessionId, { op: "reach", checkpoint }, 90_000);
419
- console.log(JSON.stringify(res));
420
- if (!res.ok)
421
- process.exitCode = 1;
422
- return;
423
- }
424
- if (sub === "resync") {
425
- const res = await requestSession(proj, sessionId, { op: "resync" });
426
- console.log(JSON.stringify(res));
427
- if (!res.ok)
428
- process.exitCode = 1;
429
- return;
430
- }
431
- if (sub === "highlight") {
432
- const raw = args[3];
433
- if (raw === undefined) {
434
- console.error(`waygraph ${command} highlight: usage:\n` +
435
- ` waygraph ${command} highlight <sessionId> '{"rings":[{"selector":"#x","label":"X"}]}'\n` +
436
- ` waygraph ${command} highlight <sessionId> "#x|X" (shorthand: <selector>|<label>[|<tone>], rings separated by ";")`);
437
- process.exit(1);
438
- }
439
- let fixtures;
440
- try {
441
- fixtures = JSON.parse(raw);
442
- }
443
- catch (jsonErr) {
444
- const shorthand = parseHighlightShorthand(raw);
445
- if (shorthand.type === "error") {
446
- console.error(`waygraph ${command} highlight: body is neither valid JSON (${jsonErr instanceof Error ? jsonErr.message : String(jsonErr)}) nor valid shorthand (${shorthand.reason})`);
447
- process.exit(1);
448
- }
449
- fixtures = shorthand.fixtures;
450
- }
451
- if (fixtures.op !== undefined && fixtures.op !== "highlight") {
452
- console.error(`waygraph ${command} highlight: do not set "op" (or set it to "highlight")`);
453
- process.exit(1);
454
- }
455
- const { op: _ignore, ...rest } = fixtures;
456
- const res = await requestSession(proj, sessionId, {
457
- op: "highlight",
458
- ...rest,
459
- });
460
- console.log(JSON.stringify(res));
461
- if (!res.ok)
462
- process.exitCode = 1;
463
- return;
464
- }
465
- const res = await requestSession(proj, sessionId, { op: "status" });
466
- console.log(JSON.stringify(res));
467
- if (!res.ok)
468
- process.exitCode = 1;
469
- return;
470
- }
471
- const flags = parseRunFlags(args.slice(1));
472
- applyRunFlags(flags);
473
- const mermaid = flags.mermaid === true;
474
- const mapOnly = command === "graph" || flags.map === true;
475
- const cliPicker = flags.cli === true;
476
- const firstPos = flags.positionals[0];
477
- // auto src/flows/shop.flow.ts → run that flow (same as `run`). Do not
478
- // treat a .flow.ts path as a project directory (existsSync is true for files).
479
- if (command === "auto" && firstPos && looksLikeFlowFileRef(firstPos) && !flags.blocksFromTo) {
480
- const proj = resolve(process.cwd());
481
- if (!existsSync(proj) || !statSync(proj).isDirectory()) {
482
- console.error(`waygraph: no such directory: ${proj}`);
483
- process.exit(1);
484
- }
485
- if (!process.env.WAYGRAPH_BASE_URL) {
486
- const resolved = await resolveBaseUrl(proj);
487
- if (resolved)
488
- process.env.WAYGRAPH_BASE_URL = resolved;
489
- }
490
- await runChain(proj, firstPos);
491
- return;
492
- }
493
- const proj = resolve(firstPos ?? process.cwd());
494
- if (!existsSync(proj)) {
495
- console.error(`waygraph: no such directory: ${proj}`);
496
- process.exit(1);
497
- }
498
- if (!statSync(proj).isDirectory()) {
499
- console.error(`waygraph ${command}: "${firstPos}" is a file, not a project directory\n` +
500
- " run a flow: waygraph auto src/flows/shop.flow.ts\n" +
501
- " or explore: waygraph auto\n" +
502
- " or path-find: waygraph auto --blocks LoginPage OrderComplete");
503
- process.exit(1);
504
- }
505
- // auto --cli --detach: start the explore session as a background socket
506
- // server instead of blocking in the interactive loop. Session control
507
- // only applies to --cli (spec: "Headful mode is unaffected").
508
- if (command === "auto" && flags.detach) {
509
- if (!cliPicker) {
510
- console.error("waygraph auto --detach requires --cli (headful has no session control)");
511
- process.exit(1);
512
- }
513
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
514
- try {
515
- const meta = await spawnDetachedSession({
516
- projectDir: proj,
517
- ...(baseURL ? { baseURL } : {}),
518
- ...(flags.nonHeadless ? { headless: false } : {}),
519
- });
520
- console.log(JSON.stringify({ sessionId: meta.sessionId, socketPath: meta.socketPath, headless: meta.headless }));
521
- }
522
- catch (err) {
523
- console.error(`waygraph auto --detach: ${err instanceof Error ? err.message : String(err)}`);
524
- process.exit(1);
525
- }
526
- return;
527
- }
528
- // auto --blocks From To (graph path-find + run)
529
- // auto --blocks '/regex/' or '**/*.block.ts' (Phase C file select → explore)
530
- if (command === "auto" && (flags.blocksFromTo || flags.blocks)) {
531
- if (flags.blocksFromTo) {
532
- const [fromTag, toTag] = flags.blocksFromTo;
533
- await runChainAuto(proj, fromTag, toTag);
534
- return;
535
- }
536
- if (flags.blocks && isFileSelectToken(flags.blocks)) {
537
- const blocksSelect = parseBlocksSelect(flags.blocks);
538
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
539
- await runAutoExplore(proj, baseURL
540
- ? { cli: cliPicker, baseURL, blocksSelect }
541
- : { cli: cliPicker, blocksSelect });
542
- return;
543
- }
544
- console.error("waygraph auto --blocks expects <fromCheckpoint> <toCheckpoint>\n" +
545
- " or file select: --blocks '**/mailpit/**/*.block.ts' / --blocks '/mailpit/'\n" +
546
- ' e.g. waygraph auto --blocks LoginPage OrderComplete\n' +
547
- ' for a hand-named chain use: waygraph run --blocks "a then b"\n' +
548
- " or: waygraph auto src/flows/shop.flow.ts");
549
- process.exit(1);
550
- }
551
- if (mapOnly || mermaid) {
552
- const orphans = await findOrphanBlocks(proj);
553
- const graph = await discoverGraph(proj);
554
- if (mermaid) {
555
- console.log(toMermaid(graph));
556
- }
557
- else {
558
- console.log(JSON.stringify({ ...graph, orphans }, null, 2));
559
- }
560
- console.error(`waygraph graph: ${graph.nodes.length} node(s), ${graph.edges.length} edge(s), ` +
561
- `${graph.skipped.length} Block(s) skipped (Out not resolvable), ` +
562
- `${orphans.length} orphan Block(s)`);
563
- if (orphans.length > 0) {
564
- console.error("waygraph graph: orphan Blocks block auto --blocks path-find - wire each into a .flow.ts (waygraph check)");
565
- }
566
- return;
567
- }
568
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
569
- await runAutoExplore(proj, baseURL ? { cli: cliPicker, baseURL } : { cli: cliPicker });
570
- return;
571
- }
572
- export async function autoServeCase(args) {
573
- const proj = resolve(args[1] ?? process.cwd());
574
- const flags = parseRunFlags(args.slice(2));
575
- const sessionIdIdx = args.indexOf("--session-id");
576
- const sessionId = sessionIdIdx >= 0 ? args[sessionIdIdx + 1] : undefined;
577
- if (!sessionId) {
578
- console.error("waygraph __auto-serve: missing --session-id");
579
- process.exit(1);
580
- }
581
- const baseURL = flags.baseUrl ?? process.env.WAYGRAPH_BASE_URL ?? (await resolveBaseUrl(proj));
582
- const inject = flags.inject?.length ? resolveInjectRoots(flags.inject, proj) : undefined;
583
- let headless;
584
- if (flags.headlessBrowser)
585
- headless = true;
586
- else if (flags.nonHeadless)
587
- headless = false;
588
- await runAutoServeCommand({
589
- projectDir: proj,
590
- ...(baseURL ? { baseURL } : {}),
591
- ...(flags.goto
592
- ? { startUrl: flags.goto, skipInitialNavigation: false }
593
- : flags.blank === true
594
- ? { skipInitialNavigation: true }
595
- : {}),
596
- ...(headless !== undefined ? { headless } : {}),
597
- ...(inject?.length ? { inject } : {}),
598
- }, sessionId);
599
- return;
600
- }