Add sync and async hyper-agent task examples

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -262,6 +262,7 @@ Ready-to-run examples are available in `examples/`:
 - `examples/async_extension_create.py`
 - `examples/async_extension_list.py`
 - `examples/async_extract.py`
+- `examples/async_hyper_agent_task.py`
 - `examples/async_profile_list.py`
 - `examples/async_scrape.py`
 - `examples/async_session_list.py`
@@ -274,6 +275,7 @@ Ready-to-run examples are available in `examples/`:
 - `examples/sync_extension_create.py`
 - `examples/sync_extension_list.py`
 - `examples/sync_extract.py`
+- `examples/sync_hyper_agent_task.py`
 - `examples/sync_profile_list.py`
 - `examples/sync_scrape.py`
 - `examples/sync_session_list.py`

examples/async_hyper_agent_task.py

@@ -0,0 +1,28 @@
+"""
+Asynchronous HyperAgent task example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python3 examples/async_hyper_agent_task.py
+"""
+
+import asyncio
+
+from hyperbrowser import AsyncHyperbrowser
+from hyperbrowser.models.agents.hyper_agent import StartHyperAgentTaskParams
+
+
+async def main() -> None:
+    async with AsyncHyperbrowser() as client:
+        result = await client.agents.hyper_agent.start_and_wait(
+            StartHyperAgentTaskParams(
+                task="Open https://example.com and summarize the page.",
+                max_steps=4,
+            )
+        )
+        print(f"Job status: {result.status}")
+        print(f"Steps collected: {len(result.steps)}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/sync_hyper_agent_task.py

@@ -0,0 +1,26 @@
+"""
+Synchronous HyperAgent task example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python3 examples/sync_hyper_agent_task.py
+"""
+
+from hyperbrowser import Hyperbrowser
+from hyperbrowser.models.agents.hyper_agent import StartHyperAgentTaskParams
+
+
+def main() -> None:
+    with Hyperbrowser() as client:
+        result = client.agents.hyper_agent.start_and_wait(
+            StartHyperAgentTaskParams(
+                task="Open https://example.com and summarize the page.",
+                max_steps=4,
+            )
+        )
+        print(f"Job status: {result.status}")
+        print(f"Steps collected: {len(result.steps)}")
+
+
+if __name__ == "__main__":
+    main()