stagehand 4.4.0a0.dev1676__tar.gz → 4.4.1a0.dev1689__tar.gz

stagehand-4.4.1a0.dev1689/PKG-INFO

@@ -0,0 +1,256 @@
+Metadata-Version: 2.4
+Name: stagehand
+Version: 4.4.1a0.dev1689
+Summary: Browserbase's SDK for building browser agents
+Keywords: ai,agent,ai-agent,browser,browser-agent,browser-automation,computer-use,headless,playwright,cdp,llm,automation,web-scraping,testing
+Author: Browserbase
+License-Expression: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Classifier: Framework :: AsyncIO
+Requires-Dist: browserbase>=1.15,<2
+Requires-Dist: httpx>=0.23,<1
+Requires-Dist: opentelemetry-api>=1.35,<2
+Requires-Dist: pydantic>=2.12,<3
+Requires-Dist: typing-extensions>=4.12,<5
+Requires-Dist: websockets>=16.1.1
+Requires-Python: >=3.11
+Project-URL: Homepage, https://stagehand.dev
+Project-URL: Documentation, https://docs.stagehand.dev
+Project-URL: Repository, https://github.com/browserbase/stagehand
+Project-URL: Issues, https://github.com/browserbase/stagehand/issues
+Description-Content-Type: text/markdown
+
+<div id="toc" align="center" style="margin-bottom: 0;">
+  <ul style="list-style: none; margin: 0; padding: 0;">
+    <a href="https://stagehand.dev">
+      <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_logo.png" />
+        <img alt="Stagehand" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_logo.png" width="200" style="margin-right: 30px;" />
+      </picture>
+    </a>
+  </ul>
+</div>
+<p align="center">
+  <strong>Stagehand is the SDK for browser agents</strong><br>
+</p>
+
+<p align="center">
+  <a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.stagehand.dev"><strong>Docs</strong></a> ·
+  <a href="https://docs.stagehand.dev/v4/first-steps/quickstart"><strong>Quickstart</strong></a> ·
+  <a href="https://github.com/browserbase/stagehand"><strong>⭐ Star this repo</strong></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/browserbase/stagehand/tree/main?tab=MIT-1-ov-file#MIT-1-ov-file">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_license.svg" />
+      <img alt="MIT License" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_license.svg" />
+    </picture>
+  </a>
+  <a href="https://discord.gg/stagehand">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_discord.svg" />
+      <img alt="Discord Community" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_discord.svg" />
+    </picture>
+  </a>
+  <a href="https://deepwiki.com/browserbase/stagehand">
+    <img alt="Ask DeepWiki" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/deepwiki.svg" width="156" height="32" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://stagehand.dev">
+    <img src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/stagehand-website-banner.png" alt="Stagehand homepage showing browser automation in TypeScript, Python, and Go and a speed comparison with Playwright" width="100%" />
+  </a>
+</p>
+
+# Stagehand Python SDK
+
+## AI that uses the browser like humans.
+
+Sign in once, keep the session, and pull structured data out the other side.
+
+Replace `app.example.com` with your application's URL and set `OPENAI_API_KEY`, `APP_EMAIL`, and
+`APP_PASSWORD` before running this example.
+
+```python
+import asyncio
+import os
+
+from pydantic import BaseModel
+from stagehand import Stagehand, local_browser
+
+
+class Invoice(BaseModel):
+    number: str
+    amount: float
+    paid: bool
+
+
+class Invoices(BaseModel):
+    invoices: list[Invoice]
+
+
+async def main() -> None:
+    # Cookies persist in ./browser-data, so the next run starts already signed in
+    browser = await local_browser.launch(user_data_dir="./browser-data")
+    try:
+        stagehand = await Stagehand.create(
+            browser=browser,
+            model="openai/gpt-5.4-mini",
+            model_api_key=os.environ["OPENAI_API_KEY"],
+        )
+        try:
+            page = (await browser.context.pages())[0]
+            await page.goto("https://app.example.com/login")
+
+            # observe() returns real selectors, so credentials never reach the model
+            email = await stagehand.observe("find the email input")
+            password = await stagehand.observe("find the password input")
+            await page.locator(email.data[0].selector).fill(os.environ["APP_EMAIL"])
+            await page.locator(password.data[0].selector).fill(os.environ["APP_PASSWORD"])
+
+            # act() self-heals when the site redesigns its form
+            await stagehand.act("click the sign in button")
+            await stagehand.act("open the billing page")
+
+            # extract() returns schema-validated data
+            result = await stagehand.extract(
+                "extract every invoice in the table",
+                Invoices,
+            )
+            print(result.data.invoices)
+        finally:
+            await stagehand.close()
+    finally:
+        await browser.close()
+
+
+asyncio.run(main())
+```
+
+## Install
+
+```bash
+pip install stagehand
+```
+
+Requires Python 3.11 or later. Local runs need [Chrome](https://www.google.com/chrome/) installed.
+Full setup: [Quickstart](https://docs.stagehand.dev/v4/first-steps/quickstart).
+
+## Why Stagehand
+
+- **Familiar APIs:** The Playwright-style methods you and your agents already know: `goto`, `click`, `locator`, `screenshot`.
+- **Token efficiency:** Hybrid accessibility-tree trimming gives agents exactly the page context they need and nothing more.
+- **Faster in production:** Stagehand runs as an extension next to the browser, cutting round-trip latency on every action.
+- **Self-healing:** `act`, `observe`, and `extract` refresh how an action happens when the site changes underneath it.
+- **Built for agents:** WebMCP, clipboard support, batch commands, deep locators for nested iframes and closed Shadow DOMs, OTel traces.
+- **Three languages:** One complete browser driver across TypeScript, Python, and Go.
+
+## Run it on Browserbase
+
+Point the same script at [Browserbase](https://www.browserbase.com). The
+[Model Gateway](https://docs.stagehand.dev/v4/configuration/models#model-gateway) handles model
+routing, and [server-side caching](https://docs.stagehand.dev/v4/best-practices/caching) reuses
+results for repeated actions.
+
+Import `browserbase` from `stagehand`, then use these browser and client setup calls inside the
+async `main()` above, keeping its `try`/`finally` cleanup:
+
+```python
+from stagehand import browserbase
+
+browser = await browserbase.launch(api_key=os.environ["BROWSERBASE_API_KEY"])
+stagehand = await Stagehand.create(browser=browser, cache=True)
+```
+
+Use `browserbase.connect(api_key=..., session_id=...)` to attach to an existing session.
+`browser.close()` releases the Browserbase session. For a `keep_alive=True` session, use
+`await browser.disconnect()` to close the client and connection while keeping the session for later.
+See [browser configuration](https://docs.stagehand.dev/v4/configuration/browser) for more options.
+
+## Search and fetch without a browser
+
+[Fetch](https://docs.stagehand.dev/v4/add-ons/fetch) grabs the content of a URL as markdown.
+[Search](https://docs.stagehand.dev/v4/add-ons/search) provides fast, token-efficient web search
+results. Both complement browser sessions without launching a browser.
+
+```python
+import asyncio
+import os
+
+from stagehand import browserbase
+
+
+async def search_and_fetch() -> None:
+    results = await browserbase.search(
+        api_key=os.environ["BROWSERBASE_API_KEY"],
+        query="browser agent frameworks",
+        num_results=5,
+    )
+    fetched = await browserbase.fetch(
+        api_key=os.environ["BROWSERBASE_API_KEY"],
+        url=results.results[0].url,
+        format="markdown",
+    )
+    print(fetched.content)
+
+
+asyncio.run(search_and_fetch())
+```
+
+## Python API notes
+
+`Stagehand.act()`, `Stagehand.observe()`, and `Stagehand.extract()` use the active page by
+default. Pass `page=page` to target a specific SDK `Page`.
+
+`Page.goto()`, `reload()`, `go_back()`, and `go_forward()` return the main-document `Response`,
+or `None` when navigation does not produce one. Response bodies and complete headers are retrieved
+lazily while the Stagehand session remains open.
+
+When contributing examples or tests, keep browser ownership explicit: launch or connect a
+browser handle, pass it to `Stagehand.create()`, close Stagehand first, and close the browser in
+the outermost `finally` block.
+
+## Docs and resources
+
+- [Python examples](https://github.com/browserbase/stagehand/tree/main/packages/sdk-python/examples): actions, extraction, observation, and custom LLM usage.
+- [Page](https://docs.stagehand.dev/v4/reference/page) and [locator](https://docs.stagehand.dev/v4/reference/locator): Playwright-style browser and element APIs.
+- [Integrations](https://docs.stagehand.dev/v4/integrations/overview): agent frameworks and coding agents.
+- [Main README](https://github.com/browserbase/stagehand/blob/main/README.md): project overview, MCP setup, and community links.
+
+## Contributing
+
+Clone the [Stagehand repository](https://github.com/browserbase/stagehand) and run these commands
+from its root. All Python projects share the root uv workspace, `uv.lock`, and `.venv`.
+`just install` installs all workspace members, and consumers use this SDK from source.
+See [the contributing guide](https://github.com/browserbase/stagehand/blob/main/CONTRIBUTING.md)
+for workspace membership and package-specific commands.
+
+```bash
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install just
+brew install just
+
+just install
+just generate
+just check
+just test
+just build
+```

stagehand-4.4.1a0.dev1689/README.md

@@ -0,0 +1,224 @@
+<div id="toc" align="center" style="margin-bottom: 0;">
+  <ul style="list-style: none; margin: 0; padding: 0;">
+    <a href="https://stagehand.dev">
+      <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_logo.png" />
+        <img alt="Stagehand" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_logo.png" width="200" style="margin-right: 30px;" />
+      </picture>
+    </a>
+  </ul>
+</div>
+<p align="center">
+  <strong>Stagehand is the SDK for browser agents</strong><br>
+</p>
+
+<p align="center">
+  <a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.stagehand.dev"><strong>Docs</strong></a> ·
+  <a href="https://docs.stagehand.dev/v4/first-steps/quickstart"><strong>Quickstart</strong></a> ·
+  <a href="https://github.com/browserbase/stagehand"><strong>⭐ Star this repo</strong></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/browserbase/stagehand/tree/main?tab=MIT-1-ov-file#MIT-1-ov-file">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_license.svg" />
+      <img alt="MIT License" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_license.svg" />
+    </picture>
+  </a>
+  <a href="https://discord.gg/stagehand">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_discord.svg" />
+      <img alt="Discord Community" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_discord.svg" />
+    </picture>
+  </a>
+  <a href="https://deepwiki.com/browserbase/stagehand">
+    <img alt="Ask DeepWiki" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/deepwiki.svg" width="156" height="32" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://stagehand.dev">
+    <img src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/stagehand-website-banner.png" alt="Stagehand homepage showing browser automation in TypeScript, Python, and Go and a speed comparison with Playwright" width="100%" />
+  </a>
+</p>
+
+# Stagehand Python SDK
+
+## AI that uses the browser like humans.
+
+Sign in once, keep the session, and pull structured data out the other side.
+
+Replace `app.example.com` with your application's URL and set `OPENAI_API_KEY`, `APP_EMAIL`, and
+`APP_PASSWORD` before running this example.
+
+```python
+import asyncio
+import os
+
+from pydantic import BaseModel
+from stagehand import Stagehand, local_browser
+
+
+class Invoice(BaseModel):
+    number: str
+    amount: float
+    paid: bool
+
+
+class Invoices(BaseModel):
+    invoices: list[Invoice]
+
+
+async def main() -> None:
+    # Cookies persist in ./browser-data, so the next run starts already signed in
+    browser = await local_browser.launch(user_data_dir="./browser-data")
+    try:
+        stagehand = await Stagehand.create(
+            browser=browser,
+            model="openai/gpt-5.4-mini",
+            model_api_key=os.environ["OPENAI_API_KEY"],
+        )
+        try:
+            page = (await browser.context.pages())[0]
+            await page.goto("https://app.example.com/login")
+
+            # observe() returns real selectors, so credentials never reach the model
+            email = await stagehand.observe("find the email input")
+            password = await stagehand.observe("find the password input")
+            await page.locator(email.data[0].selector).fill(os.environ["APP_EMAIL"])
+            await page.locator(password.data[0].selector).fill(os.environ["APP_PASSWORD"])
+
+            # act() self-heals when the site redesigns its form
+            await stagehand.act("click the sign in button")
+            await stagehand.act("open the billing page")
+
+            # extract() returns schema-validated data
+            result = await stagehand.extract(
+                "extract every invoice in the table",
+                Invoices,
+            )
+            print(result.data.invoices)
+        finally:
+            await stagehand.close()
+    finally:
+        await browser.close()
+
+
+asyncio.run(main())
+```
+
+## Install
+
+```bash
+pip install stagehand
+```
+
+Requires Python 3.11 or later. Local runs need [Chrome](https://www.google.com/chrome/) installed.
+Full setup: [Quickstart](https://docs.stagehand.dev/v4/first-steps/quickstart).
+
+## Why Stagehand
+
+- **Familiar APIs:** The Playwright-style methods you and your agents already know: `goto`, `click`, `locator`, `screenshot`.
+- **Token efficiency:** Hybrid accessibility-tree trimming gives agents exactly the page context they need and nothing more.
+- **Faster in production:** Stagehand runs as an extension next to the browser, cutting round-trip latency on every action.
+- **Self-healing:** `act`, `observe`, and `extract` refresh how an action happens when the site changes underneath it.
+- **Built for agents:** WebMCP, clipboard support, batch commands, deep locators for nested iframes and closed Shadow DOMs, OTel traces.
+- **Three languages:** One complete browser driver across TypeScript, Python, and Go.
+
+## Run it on Browserbase
+
+Point the same script at [Browserbase](https://www.browserbase.com). The
+[Model Gateway](https://docs.stagehand.dev/v4/configuration/models#model-gateway) handles model
+routing, and [server-side caching](https://docs.stagehand.dev/v4/best-practices/caching) reuses
+results for repeated actions.
+
+Import `browserbase` from `stagehand`, then use these browser and client setup calls inside the
+async `main()` above, keeping its `try`/`finally` cleanup:
+
+```python
+from stagehand import browserbase
+
+browser = await browserbase.launch(api_key=os.environ["BROWSERBASE_API_KEY"])
+stagehand = await Stagehand.create(browser=browser, cache=True)
+```
+
+Use `browserbase.connect(api_key=..., session_id=...)` to attach to an existing session.
+`browser.close()` releases the Browserbase session. For a `keep_alive=True` session, use
+`await browser.disconnect()` to close the client and connection while keeping the session for later.
+See [browser configuration](https://docs.stagehand.dev/v4/configuration/browser) for more options.
+
+## Search and fetch without a browser
+
+[Fetch](https://docs.stagehand.dev/v4/add-ons/fetch) grabs the content of a URL as markdown.
+[Search](https://docs.stagehand.dev/v4/add-ons/search) provides fast, token-efficient web search
+results. Both complement browser sessions without launching a browser.
+
+```python
+import asyncio
+import os
+
+from stagehand import browserbase
+
+
+async def search_and_fetch() -> None:
+    results = await browserbase.search(
+        api_key=os.environ["BROWSERBASE_API_KEY"],
+        query="browser agent frameworks",
+        num_results=5,
+    )
+    fetched = await browserbase.fetch(
+        api_key=os.environ["BROWSERBASE_API_KEY"],
+        url=results.results[0].url,
+        format="markdown",
+    )
+    print(fetched.content)
+
+
+asyncio.run(search_and_fetch())
+```
+
+## Python API notes
+
+`Stagehand.act()`, `Stagehand.observe()`, and `Stagehand.extract()` use the active page by
+default. Pass `page=page` to target a specific SDK `Page`.
+
+`Page.goto()`, `reload()`, `go_back()`, and `go_forward()` return the main-document `Response`,
+or `None` when navigation does not produce one. Response bodies and complete headers are retrieved
+lazily while the Stagehand session remains open.
+
+When contributing examples or tests, keep browser ownership explicit: launch or connect a
+browser handle, pass it to `Stagehand.create()`, close Stagehand first, and close the browser in
+the outermost `finally` block.
+
+## Docs and resources
+
+- [Python examples](https://github.com/browserbase/stagehand/tree/main/packages/sdk-python/examples): actions, extraction, observation, and custom LLM usage.
+- [Page](https://docs.stagehand.dev/v4/reference/page) and [locator](https://docs.stagehand.dev/v4/reference/locator): Playwright-style browser and element APIs.
+- [Integrations](https://docs.stagehand.dev/v4/integrations/overview): agent frameworks and coding agents.
+- [Main README](https://github.com/browserbase/stagehand/blob/main/README.md): project overview, MCP setup, and community links.
+
+## Contributing
+
+Clone the [Stagehand repository](https://github.com/browserbase/stagehand) and run these commands
+from its root. All Python projects share the root uv workspace, `uv.lock`, and `.venv`.
+`just install` installs all workspace members, and consumers use this SDK from source.
+See [the contributing guide](https://github.com/browserbase/stagehand/blob/main/CONTRIBUTING.md)
+for workspace membership and package-specific commands.
+
+```bash
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install just
+brew install just
+
+just install
+just generate
+just check
+just test
+just build
+```

{stagehand-4.4.0a0.dev1676 → stagehand-4.4.1a0.dev1689}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stagehand"
-version = "4.4.0a0.dev1676"
+version = "4.4.1a0.dev1689"
 description = "Browserbase's SDK for building browser agents"
 readme = "README.md"
 requires-python = ">=3.11"

{stagehand-4.4.0a0.dev1676 → stagehand-4.4.1a0.dev1689}/src/stagehand/_extension/manifest.json

@@ -32,5 +32,5 @@
     }
   ],
   "options_page": "wake-service-worker.html",
-  "version": "1.3.0"
+  "version": "1.3.1"
 }

{stagehand-4.4.0a0.dev1676 → stagehand-4.4.1a0.dev1689}/src/stagehand/_extension/service-worker.js

@@ -9206,7 +9206,7 @@ function isRecord$2(value) {
 }
 var package_default$1 = {
 	name: "@browserbasehq/stagehand-protocol",
-	version: "3.1.1-alpha-c82e6170c29ab6fb17c4a10e44812bd29507e7d4",
+	version: "3.1.1",
 	"private": true,
 	type: "module",
 	exports: {
@@ -66119,7 +66119,7 @@ var WebTracerProvider = class extends BasicTracerProvider {
 };
 var package_default = {
 	name: "@browserbasehq/stagehand-extension",
-	version: "1.3.0-alpha-c82e6170c29ab6fb17c4a10e44812bd29507e7d4",
+	version: "1.3.1-alpha-2fe947c01c828279a5df0234f0100f9750bc3b9e",
 	"private": true,
 	type: "module",
 	scripts: {
@@ -67067,9 +67067,12 @@ function createDeferred$1() {
 function normaliseHeaderName(name) {
 	return name.toLowerCase();
 }
-/** Split multi-value header strings into discrete values while trimming. */
+/**
+* Split multi-value header strings into discrete values while trimming. An
+* empty value is kept: the header was still sent, so it must stay visible.
+*/
 function splitHeaderValues(value) {
-	return value.split(/\r?\n/).map((part) => part.trim()).filter(Boolean);
+	return value.split(/\r?\n/).map((part) => part.trim());
 }
 /**
 * Parse an HTTP header text block (as emitted by CDP) into an ordered array of

{stagehand-4.4.0a0.dev1676 → stagehand-4.4.1a0.dev1689}/src/stagehand/_generated/protocol_version.py

@@ -1,4 +1,4 @@
 """Generated from packages/protocol/package.json. Do not edit."""
 
 PROTOCOL_SEMVER_PATTERN = '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$'
-STAGEHAND_PROTOCOL_VERSION = '3.1.1-alpha-c82e6170c29ab6fb17c4a10e44812bd29507e7d4'
+STAGEHAND_PROTOCOL_VERSION = '3.1.1'

stagehand-4.4.0a0.dev1676/PKG-INFO

@@ -1,205 +0,0 @@
-Metadata-Version: 2.4
-Name: stagehand
-Version: 4.4.0a0.dev1676
-Summary: Browserbase's SDK for building browser agents
-Keywords: ai,agent,ai-agent,browser,browser-agent,browser-automation,computer-use,headless,playwright,cdp,llm,automation,web-scraping,testing
-Author: Browserbase
-License-Expression: MIT
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Testing
-Classifier: Typing :: Typed
-Classifier: Framework :: AsyncIO
-Requires-Dist: browserbase>=1.15,<2
-Requires-Dist: httpx>=0.23,<1
-Requires-Dist: opentelemetry-api>=1.35,<2
-Requires-Dist: pydantic>=2.12,<3
-Requires-Dist: typing-extensions>=4.12,<5
-Requires-Dist: websockets>=16.1.1
-Requires-Python: >=3.11
-Project-URL: Homepage, https://stagehand.dev
-Project-URL: Documentation, https://docs.stagehand.dev
-Project-URL: Repository, https://github.com/browserbase/stagehand
-Project-URL: Issues, https://github.com/browserbase/stagehand/issues
-Description-Content-Type: text/markdown
-
-<div id="toc" align="center" style="margin-bottom: 0;">
-  <ul style="list-style: none; margin: 0; padding: 0;">
-    <a href="https://stagehand.dev">
-      <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_logo.png" />
-        <img alt="Stagehand" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_logo.png" width="200" style="margin-right: 30px;" />
-      </picture>
-    </a>
-  </ul>
-</div>
-<p align="center">
-  <strong>Stagehand is the SDK for browser agents.</strong><br>
-  <a href="https://docs.stagehand.dev">Read the Docs</a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/browserbase/stagehand/tree/main?tab=MIT-1-ov-file#MIT-1-ov-file">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_license.svg" />
-      <img alt="MIT License" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_license.svg" />
-    </picture>
-  </a>
-  <a href="https://discord.gg/stagehand">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_discord.svg" />
-      <img alt="Discord Community" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_discord.svg" />
-    </picture>
-  </a>
-</p>
-
-<p align="center">
-	<a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-</p>
-
-<p align="center">
-  <a href="https://deepwiki.com/browserbase/stagehand">
-    <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" />
-  </a>
-</p>
-
-# Stagehand Python SDK
-
-## What is Stagehand?
-
-Stagehand is the SDK for browser agents. Playwright was built for testing, Stagehand is built for agents. Use familiar APIs, self-healing actions, and network-level security across TypeScript, Python, and Go.
-
-## Why Stagehand?
-
-Stagehand gives browser agents an interface built for how they actually work. It combines familiar Playwright-style APIs with self-healing actions, agent-optimized page context, and native support for complex DOM structures like out-of-process iframes and closed Shadow DOMs.
-
-Agents use fewer tokens, recover when websites change, and complete tasks more reliably. With a complete browser driver across TypeScript, Python, and Go, Stagehand delivers the flexibility of AI without sacrificing the speed, control, determinism, reliability, and observability required in production.
-
-For the full overview, examples, and contributing guide, see the [main README](https://github.com/browserbase/stagehand/blob/main/README.md).
-
-## Example
-
-The async Python SDK for Stagehand browser automation:
-
-```python
-import asyncio
-import os
-
-from pydantic import BaseModel
-
-from stagehand import Stagehand, browserbase, local_browser
-
-
-class PullRequest(BaseModel):
-    author: str
-    title: str
-
-
-async def main() -> None:
-    browser = await local_browser.launch(headless=True)
-    try:
-        stagehand = await Stagehand.create(
-            browser=browser,
-            model="openai/gpt-5.4-mini",
-            model_api_key=os.environ["OPENAI_API_KEY"],
-        )
-        try:
-            page = (await browser.context.pages())[0]
-            await page.goto("https://github.com/browserbase")
-
-            # act() executes individual actions
-            await stagehand.act("click on the stagehand repo")
-
-            # observe() reports what is actionable on the page
-            observed = await stagehand.observe("find the latest PR")
-
-            # Locators give deterministic, Playwright-style actions
-            await page.locator(observed.data[0].selector).click()
-
-            # extract() returns structured data validated by a pydantic model
-            result = await stagehand.extract(
-                "extract the author and title of the PR",
-                PullRequest,
-            )
-            print(result.data.author, result.data.title)
-        finally:
-            await stagehand.close()
-    finally:
-        await browser.close()
-
-
-asyncio.run(main())
-```
-
-See [`examples`](examples) for action, extraction, observation, and custom LLM usage.
-
-For hosted browsers, import `browserbase` from `stagehand` and use
-`browserbase.launch(api_key=...)` or `browserbase.connect(api_key=..., session_id=...)` instead of
-`local_browser`. Calling `close()` on the browser handle releases the Browserbase session. To keep
-a `keep_alive=True` session for later, call `stagehand.close()` without `browser.close()`.
-
-The same `browserbase` facade exposes Browserbase Search and Fetch without launching a browser:
-
-```python
-import asyncio
-import os
-
-from stagehand import browserbase
-
-
-async def search_and_fetch() -> None:
-    results = await browserbase.search(
-        api_key=os.environ["BROWSERBASE_API_KEY"],
-        query="browser agent frameworks",
-        num_results=5,
-    )
-    fetched = await browserbase.fetch(
-        api_key=os.environ["BROWSERBASE_API_KEY"],
-        url=results.results[0].url,
-        format="markdown",
-    )
-    print(fetched.content)
-
-
-asyncio.run(search_and_fetch())
-```
-
-`Stagehand.act()`, `Stagehand.observe()`, and `Stagehand.extract()` use the active page by
-default. Pass `page=page` to target a specific SDK `Page`.
-
-`Page.goto()`, `reload()`, `go_back()`, and `go_forward()` return the main-document `Response`,
-or `None` when navigation does not produce one. Response bodies and complete headers are retrieved
-lazily while the Stagehand session remains open.
-
-When contributing examples or tests, keep browser ownership explicit: launch or connect a
-browser handle, pass it to `Stagehand.create()`, close Stagehand first, and close the browser in
-the outermost `finally` block.
-
-## Contributing
-
-Clone the [Stagehand repository](https://github.com/browserbase/stagehand) and run these commands
-from its root. All Python projects share the root uv workspace, `uv.lock`, and `.venv`.
-`just install` installs all workspace members, and consumers use this SDK from source.
-See [the contributing guide](https://github.com/browserbase/stagehand/blob/main/CONTRIBUTING.md)
-for workspace membership and package-specific commands.
-
-```bash
-# Install uv
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Install just
-brew install just
-
-just install
-just generate
-just check
-just test
-just build
-```

stagehand-4.4.0a0.dev1676/README.md

@@ -1,173 +0,0 @@
-<div id="toc" align="center" style="margin-bottom: 0;">
-  <ul style="list-style: none; margin: 0; padding: 0;">
-    <a href="https://stagehand.dev">
-      <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_logo.png" />
-        <img alt="Stagehand" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_logo.png" width="200" style="margin-right: 30px;" />
-      </picture>
-    </a>
-  </ul>
-</div>
-<p align="center">
-  <strong>Stagehand is the SDK for browser agents.</strong><br>
-  <a href="https://docs.stagehand.dev">Read the Docs</a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/browserbase/stagehand/tree/main?tab=MIT-1-ov-file#MIT-1-ov-file">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_license.svg" />
-      <img alt="MIT License" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_license.svg" />
-    </picture>
-  </a>
-  <a href="https://discord.gg/stagehand">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/browserbase/stagehand/main/media/dark_discord.svg" />
-      <img alt="Discord Community" src="https://raw.githubusercontent.com/browserbase/stagehand/main/media/light_discord.svg" />
-    </picture>
-  </a>
-</p>
-
-<p align="center">
-	<a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-</p>
-
-<p align="center">
-  <a href="https://deepwiki.com/browserbase/stagehand">
-    <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" />
-  </a>
-</p>
-
-# Stagehand Python SDK
-
-## What is Stagehand?
-
-Stagehand is the SDK for browser agents. Playwright was built for testing, Stagehand is built for agents. Use familiar APIs, self-healing actions, and network-level security across TypeScript, Python, and Go.
-
-## Why Stagehand?
-
-Stagehand gives browser agents an interface built for how they actually work. It combines familiar Playwright-style APIs with self-healing actions, agent-optimized page context, and native support for complex DOM structures like out-of-process iframes and closed Shadow DOMs.
-
-Agents use fewer tokens, recover when websites change, and complete tasks more reliably. With a complete browser driver across TypeScript, Python, and Go, Stagehand delivers the flexibility of AI without sacrificing the speed, control, determinism, reliability, and observability required in production.
-
-For the full overview, examples, and contributing guide, see the [main README](https://github.com/browserbase/stagehand/blob/main/README.md).
-
-## Example
-
-The async Python SDK for Stagehand browser automation:
-
-```python
-import asyncio
-import os
-
-from pydantic import BaseModel
-
-from stagehand import Stagehand, browserbase, local_browser
-
-
-class PullRequest(BaseModel):
-    author: str
-    title: str
-
-
-async def main() -> None:
-    browser = await local_browser.launch(headless=True)
-    try:
-        stagehand = await Stagehand.create(
-            browser=browser,
-            model="openai/gpt-5.4-mini",
-            model_api_key=os.environ["OPENAI_API_KEY"],
-        )
-        try:
-            page = (await browser.context.pages())[0]
-            await page.goto("https://github.com/browserbase")
-
-            # act() executes individual actions
-            await stagehand.act("click on the stagehand repo")
-
-            # observe() reports what is actionable on the page
-            observed = await stagehand.observe("find the latest PR")
-
-            # Locators give deterministic, Playwright-style actions
-            await page.locator(observed.data[0].selector).click()
-
-            # extract() returns structured data validated by a pydantic model
-            result = await stagehand.extract(
-                "extract the author and title of the PR",
-                PullRequest,
-            )
-            print(result.data.author, result.data.title)
-        finally:
-            await stagehand.close()
-    finally:
-        await browser.close()
-
-
-asyncio.run(main())
-```
-
-See [`examples`](examples) for action, extraction, observation, and custom LLM usage.
-
-For hosted browsers, import `browserbase` from `stagehand` and use
-`browserbase.launch(api_key=...)` or `browserbase.connect(api_key=..., session_id=...)` instead of
-`local_browser`. Calling `close()` on the browser handle releases the Browserbase session. To keep
-a `keep_alive=True` session for later, call `stagehand.close()` without `browser.close()`.
-
-The same `browserbase` facade exposes Browserbase Search and Fetch without launching a browser:
-
-```python
-import asyncio
-import os
-
-from stagehand import browserbase
-
-
-async def search_and_fetch() -> None:
-    results = await browserbase.search(
-        api_key=os.environ["BROWSERBASE_API_KEY"],
-        query="browser agent frameworks",
-        num_results=5,
-    )
-    fetched = await browserbase.fetch(
-        api_key=os.environ["BROWSERBASE_API_KEY"],
-        url=results.results[0].url,
-        format="markdown",
-    )
-    print(fetched.content)
-
-
-asyncio.run(search_and_fetch())
-```
-
-`Stagehand.act()`, `Stagehand.observe()`, and `Stagehand.extract()` use the active page by
-default. Pass `page=page` to target a specific SDK `Page`.
-
-`Page.goto()`, `reload()`, `go_back()`, and `go_forward()` return the main-document `Response`,
-or `None` when navigation does not produce one. Response bodies and complete headers are retrieved
-lazily while the Stagehand session remains open.
-
-When contributing examples or tests, keep browser ownership explicit: launch or connect a
-browser handle, pass it to `Stagehand.create()`, close Stagehand first, and close the browser in
-the outermost `finally` block.
-
-## Contributing
-
-Clone the [Stagehand repository](https://github.com/browserbase/stagehand) and run these commands
-from its root. All Python projects share the root uv workspace, `uv.lock`, and `.venv`.
-`just install` installs all workspace members, and consumers use this SDK from source.
-See [the contributing guide](https://github.com/browserbase/stagehand/blob/main/CONTRIBUTING.md)
-for workspace membership and package-specific commands.
-
-```bash
-# Install uv
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Install just
-brew install just
-
-just install
-just generate
-just check
-just test
-just build
-```