Live messages

Poll V4 run events incrementally to monitor progress or build a custom UI.

V4 exposes an ordered event stream for each run. Poll with after set to the previous response’s next_after / nextAfter so you only receive new events.

Each event has id, ts, type, and data. Event types include run lifecycle updates, model calls, browser readiness, tool activity, artifacts, and completion.

Python

import asyncio
from browser_use_sdk.v4 import AsyncBrowserUse

TERMINAL = {"completed", "failed", "cancelled"}

client = AsyncBrowserUse()
created = await client.runs.create("Find the top story on Hacker News")

after = None
while True:
    page = await client.runs.events(created.id, after=after, limit=100)
    for event in page.events:
        print(event.type, event.data)
    if page.next_after is not None:
        after = page.next_after

    status = await client.runs.status(created.id)
    if status.status.value in TERMINAL:
        break
    await asyncio.sleep(1)

run = await client.runs.get(created.id)
print(run.result)

The status endpoint is intentionally tiny and cheap to poll. Fetch the full run only after its status is terminal.

Cancel a run

Python

cancelled = await client.runs.cancel(created.id)
print(cancelled.status)

Cancelling a run does not delete its session. You can send another turn with the same session ID.

Related

• Get run events — event response and cursor fields
• Get run status — lightweight poll target
• Follow-up tasks — continue or queue work in the same session