Act, choose and check

import notte

# needs OPENROUTER_API_KEY (Jev through OpenRouter, and the text writer), and `pip install "notte[llm]"`
with notte.Session() as session:
    _ = session.execute(type="goto", url="https://en.wikipedia.org/wiki/Main_Page")

    # one observe -> decide -> execute step per call
    result = session.act("type Ada Lovelace in the search box")
    print(result.status, result.action, result.confidence)
    print(result.timings)  # observe / decide / write / fresh / execute, in ms

    result = session.act("open the Ada Lovelace article")
    assert result.success

from notte_core.act import NoActionFoundError

import notte

with notte.Session() as session:
    _ = session.execute(type="goto", url="https://www.saucedemo.com/")

    # values in `variables` replace {{name}} in the typed text after the model call:
    # the model never sees them
    typed = session.act("type {{user}} in the username field", variables={"user": "standard_user"})
    print(typed.value)  # "{{user}}": the template, as the model wrote it

    # choose without executing, then run the proposed action yourself
    proposal = session.act("click the login button", dry_run=True)
    if proposal.action is not None and (proposal.confidence or 0) > 0.8:
        _ = session.execute(proposal.action)

    # refuse uncertain decisions; return instead of raising when nothing fits
    try:
        cart = session.act("open the shopping cart", min_confidence=0.7)
    except NoActionFoundError as error:
        print("blocked:", error.result)
    result = session.act("open the shopping cart", min_confidence=0.7, raise_on_failure=False)
    print(result.status)  # executed, done, blocked or stale

import notte

with notte.Session() as session:
    _ = session.execute(type="goto", url="https://news.ycombinator.com")

    # pick one option about the current page, with a probability per option
    choice = session.choose("What kind of page is this?", ["news aggregator", "online shop", "login page"])
    print(choice.choice, choice.probabilities, choice.confidence)

    # options can carry descriptions
    choice = session.choose(
        "Is there a way to sign in?",
        {"link": "a login link is visible", "form": "a login form is visible", "none": "no way to sign in"},
    )

    # the probability that a yes/no question holds on the page
    if session.check("Is the user logged in?") < 0.5:
        print("not logged in")

from notte_core.act import ActResult

import notte


def act_until_done(session: notte.Session, instruction: str, max_steps: int = 20) -> list[ActResult]:
    results: list[ActResult] = []
    for _ in range(max_steps):
        result = session.act(instruction, raise_on_failure=False)
        results.append(result)
        if result.status != "executed":  # done, blocked or stale
            break
        # 3 actions in a row (WAIT and scrolls aside: the fingerprint has no scroll position) that left the page unchanged: stop
        recent = results[-4:]
        if (
            len(recent) == 4
            and all(r.fingerprint is not None for r in recent)
            and len({r.fingerprint for r in recent}) == 1
            and all(r.operation not in ("WAIT", "SCROLL_DOWN", "SCROLL_UP") for r in recent[:-1])
        ):
            break
    return results


with notte.Session() as session:
    _ = session.execute(type="goto", url="https://en.wikipedia.org/wiki/Main_Page")
    steps = act_until_done(session, "Search Wikipedia for Ada Lovelace and open her article")
    print([(r.status, r.operation) for r in steps])

    # notte ships a fuller version that also stops on actions alternating on one element:
    # `from notte_core.act import act_until_done`

from notte_llm import JevDecider, LlmDecider, LlmWriter

import notte

# explicit deciders instead of the environment-based default
# the writer asks `fallback_model` once when its own provider refuses on content-policy grounds
writer = LlmWriter("inception/mercury-3", fallback_model="google/gemini-3.1-flash-lite")
jev = JevDecider(route="openrouter", writer=writer)  # OPENROUTER_API_KEY (route="typesafe": TYPESAFE_API_KEY)
llm = LlmDecider("google/gemini-3.1-flash-lite")  # OPENROUTER_API_KEY

with notte.Session() as session:
    _ = session.execute(type="goto", url="https://en.wikipedia.org/wiki/Main_Page")
    typed = session.act("type Ada Lovelace in the search box", decider=jev)
    submitted = session.act("submit the search", decider=llm)
    print(typed.status, submitted.status)