ov.operate.driver

The scripted/guided driver – model-free journey execution (Phase 1).

Two deterministic strategies that compose the operate primitives over a CaptureSession:

• replay() – execute a scripted list of actions (guided-replay), capturing state and journaling each step.

• crawl() – a polite, same-origin breadth-first crawl (crawl-and-map), capturing each visited page and stopping on max_pages / no-progress.

These let the capture spine produce a real multi-state journey with no model. Goal-pursuit (advance toward a success predicate) is the host’s job via the ov-operate skill; the package supplies the hands, not the policy.

ov.operate.driver.crawl(session: Any, *, max_pages: int = 5) → list[JourneyStep]

Politely crawl same-origin links breadth-first, capturing each page.

Stops at max_pages, on max_steps, or when the deterministic progress signal reports a loop. The host can run a richer crawl; this is the model-free baseline that yields a multi-state capture.

ov.operate.driver.replay(session: Any, actions: list[Action | dict[str, Any]]) → list[JourneyStep]

Execute a scripted action list, capturing + journaling each step.

>>> # actions are Action models or dicts: {"type": "click", "ref": "e3"}
>>> callable(replay)
True