updated readme

Author: SentienceDEV

examples/asserts/README.md

@@ -13,4 +13,3 @@ python examples/asserts/v1_state_assertions.py
 python examples/asserts/v2_eventually_min_confidence.py
 python examples/asserts/v2_vision_fallback.py
 ```
-

examples/asserts/eventually_min_confidence.py

@@ -10,7 +10,7 @@
 import asyncio
 import os
 
-from sentience import AsyncSentienceBrowser, AgentRuntime
+from sentience import AgentRuntime, AsyncSentienceBrowser
 from sentience.tracing import JsonlTraceSink, Tracer
 from sentience.verification import exists
 
@@ -21,7 +21,9 @@ async def main() -> None:
 
     async with AsyncSentienceBrowser(headless=True) as browser:
         page = await browser.new_page()
-        runtime = await AgentRuntime.from_sentience_browser(browser=browser, page=page, tracer=tracer)
+        runtime = await AgentRuntime.from_sentience_browser(
+            browser=browser, page=page, tracer=tracer
+        )
         if sentience_api_key:
             runtime.sentience_api_key = sentience_api_key
 
@@ -46,4 +48,3 @@ async def main() -> None:
 
 if __name__ == "__main__":
     asyncio.run(main())
-

examples/asserts/state_assertions.py

@@ -11,7 +11,7 @@
 import asyncio
 import os
 
-from sentience import AsyncSentienceBrowser, AgentRuntime
+from sentience import AgentRuntime, AsyncSentienceBrowser
 from sentience.tracing import JsonlTraceSink, Tracer
 from sentience.verification import (
     exists,
@@ -30,7 +30,9 @@ async def main() -> None:
 
     async with AsyncSentienceBrowser(headless=True) as browser:
         page = await browser.new_page()
-        runtime = await AgentRuntime.from_sentience_browser(browser=browser, page=page, tracer=tracer)
+        runtime = await AgentRuntime.from_sentience_browser(
+            browser=browser, page=page, tracer=tracer
+        )
 
         # If you have a Pro/Enterprise key, set it on the runtime so snapshots use the Gateway.
         # (This improves selector quality and unlocks state-aware fields for assertions.)
@@ -44,10 +46,16 @@ async def main() -> None:
         # v1: state-aware assertions (examples)
         runtime.assert_(exists("role=heading"), label="has_heading")
         runtime.assert_(is_enabled("role=link"), label="some_link_enabled")
-        runtime.assert_(is_disabled("role=button text~'continue'"), label="continue_disabled_if_present")
-        runtime.assert_(is_checked("role=checkbox name~'subscribe'"), label="subscribe_checked_if_present")
+        runtime.assert_(
+            is_disabled("role=button text~'continue'"), label="continue_disabled_if_present"
+        )
+        runtime.assert_(
+            is_checked("role=checkbox name~'subscribe'"), label="subscribe_checked_if_present"
+        )
         runtime.assert_(is_expanded("role=button name~'more'"), label="more_is_expanded_if_present")
-        runtime.assert_(value_contains("role=textbox name~'email'", "@"), label="email_has_at_if_present")
+        runtime.assert_(
+            value_contains("role=textbox name~'email'", "@"), label="email_has_at_if_present"
+        )
 
         # Failure intelligence: if something fails you’ll see:
         # - details.reason_code
@@ -58,4 +66,3 @@ async def main() -> None:
 
 if __name__ == "__main__":
     asyncio.run(main())
-

examples/asserts/vision_fallback.py

@@ -13,29 +13,35 @@
 import asyncio
 import os
 
-from sentience import AsyncSentienceBrowser, AgentRuntime
+from sentience import AgentRuntime, AsyncSentienceBrowser
 from sentience.llm_provider import OpenAIProvider
 from sentience.tracing import JsonlTraceSink, Tracer
 from sentience.verification import exists
 
 
 async def main() -> None:
-    tracer = Tracer(run_id="asserts-v2-vision", sink=JsonlTraceSink("trace_asserts_v2_vision.jsonl"))
+    tracer = Tracer(
+        run_id="asserts-v2-vision", sink=JsonlTraceSink("trace_asserts_v2_vision.jsonl")
+    )
     sentience_api_key = os.getenv("SENTIENCE_API_KEY")
 
     # Any provider implementing supports_vision() + generate_with_image() works.
     vision = OpenAIProvider(api_key=os.getenv("OPENAI_API_KEY"), model="gpt-4o")
 
     async with AsyncSentienceBrowser(headless=True) as browser:
         page = await browser.new_page()
-        runtime = await AgentRuntime.from_sentience_browser(browser=browser, page=page, tracer=tracer)
+        runtime = await AgentRuntime.from_sentience_browser(
+            browser=browser, page=page, tracer=tracer
+        )
         if sentience_api_key:
             runtime.sentience_api_key = sentience_api_key
 
         await page.goto("https://example.com")
         runtime.begin_step("Assert v2 vision fallback")
 
-        ok = await runtime.check(exists("text~'Example Domain'"), label="example_domain_text").eventually(
+        ok = await runtime.check(
+            exists("text~'Example Domain'"), label="example_domain_text"
+        ).eventually(
             timeout_s=10.0,
             poll_s=0.25,
             min_confidence=0.7,
@@ -50,4 +56,3 @@ async def main() -> None:
 
 if __name__ == "__main__":
     asyncio.run(main())
-

sentience/models.py

@@ -250,7 +250,9 @@ def get_grid_bounds(self, grid_id: int | None = None) -> list[GridInfo]:
             if max_dominant_count > 0:
                 # Find grid(s) with highest count
                 dominant_grids = [
-                    gid for gid, (count, _total) in grid_dominant_counts.items() if count == max_dominant_count
+                    gid
+                    for gid, (count, _total) in grid_dominant_counts.items()
+                    if count == max_dominant_count
                 ]
                 # If multiple grids tie, prefer the one with highest percentage
                 if len(dominant_grids) > 1: