Merge branch 'main' into fm/stg-489-add-regression-tests

i# Please enter a commit message to explain why this merge is necessary,
merge main

Author: filip-michalsky

.changeset/daffy-rapid-turaco.md

@@ -47,7 +47,7 @@ jobs:
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: context.issue.number,
-                body: `❌ **Parity Label Removed**\n\n@${context.actor}, you do not have sufficient permissions to add the 'parity' label. Only users with write access can trigger feature parity issues.\n\nIf you believe this feature should be implemented in the Python SDK, please ask a maintainer to add the label.`
+                body: `❌ **Parity Label Removed**\n\n@${context.actor}, you do not have sufficient permissions to add the 'parity' label. Only users with write access can trigger feature parity issues.\n\nIf you believe this feature should be implemented in the Typescript SDK, please ask a maintainer to add the label.`
               });
               
               throw new Error(`User ${context.actor} does not have write access to add parity label`);
@@ -62,7 +62,7 @@ jobs:
           app-id: ${{ secrets.PARITY_APP_ID }}
           private-key: ${{ secrets.PARITY_APP_PRIVATE_KEY }}
           owner: browserbase
-          repositories: stagehand
+          repositories: stagehand-python
 
       - name: Create issue in Python SDK repository
         uses: actions/github-script@v7
@@ -104,7 +104,7 @@ jobs:
             const issueTitle = `[Feature Parity] ${pullRequest.title}`;
             const issueBody = `## Feature Parity Request
 
-            This issue was automatically created from a pull request in the TypeScript Stagehand repository that was labeled with 'parity'.
+            This issue was automatically created from a pull request in the Python Stagehand repository that was labeled with 'parity'.
 
             ### Original PR Details
             - **PR**: #${context.issue.number} - ${pullRequest.title}
@@ -120,12 +120,12 @@ jobs:
             ${commentsSection}
 
             ### Action Required
-            Please review the changes in the original PR and implement equivalent functionality in the Python SDK if applicable.
+            Please review the changes in the original PR and implement equivalent functionality in the Typescript SDK if applicable.
 
             ---
             *This issue was automatically generated by the Feature Parity workflow.*`;
 
-            // Create the issue in the Python repository
+            // Create the issue in the Typescript repository
             const { data: issue } = await github.rest.issues.create({
               owner: 'browserbase',
               repo: 'stagehand',
@@ -141,5 +141,5 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: context.issue.number,
-              body: `🔄 **Feature Parity Issue Created**\n\nAn issue has been automatically created in the Python SDK repository to track parity implementation:\n${issue.html_url}`
+              body: `🔄 **Feature Parity Issue Created**\n\nAn issue has been automatically created in the Typescript SDK repository to track parity implementation:\n${issue.html_url}`
             });

.changeset/masterful-amiable-leopard.md

@@ -1,5 +1,18 @@
 # Stagehand Python Changelog
 
+## 0.5.0
+
+### Minor Changes
+[#167](https://github.com/browserbase/stagehand-python/pull/167) [`76669f0`](https://github.com/browserbase/stagehand-python/commit/76669f0) Thanks @miguelg719! - Enable access to iframes on api
+
+### Patch Changes
+
+[#168](https://github.com/browserbase/stagehand-python/pull/168) [`a7d8c5e`](https://github.com/browserbase/stagehand-python/commit/a7d8c5e) Thanks @miguelg719! - Patch issue with passing a created session_id to init on api mode
+[#155](https://github.com/browserbase/stagehand-python/pull/155) [`8d55709`](https://github.com/browserbase/stagehand-python/commit/8d55709) Thanks @Zach10za! - Fix error in press_key act util function
+[#158](https://github.com/browserbase/stagehand-python/pull/158) [`426df10`](https://github.com/browserbase/stagehand-python/commit/426df10) Thanks @miguelg719! - Fix parsing schema for extract with no arguments (full page extract)
+[#166](https://github.com/browserbase/stagehand-python/pull/166) [`15fd40b`](https://github.com/browserbase/stagehand-python/commit/15fd40b) Thanks @filip-michalsky! - fix logging param name
+[#159](https://github.com/browserbase/stagehand-python/pull/159) [`cd3dc7f`](https://github.com/browserbase/stagehand-python/commit/cd3dc7f) Thanks @tkattkat! - Add support for claude 4 sonnet in agent & remove all images but the last two from anthropic cua client
+
 ## 0.4.1
 
 ### Patch Changes

.changeset/sceptical-mutant-shrew.md

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stagehand"
-version = "0.4.1"
+version = "0.5.0"
 description = "Python SDK for Stagehand"
 readme = "README.md"
 classifiers = [ "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent",]

.github/workflows/feature-parity.yml

@@ -30,6 +30,7 @@ async def _create_session(self):
         "modelName": self.model_name,
         "verbose": 2 if self.verbose == 3 else self.verbose,
         "domSettleTimeoutMs": self.dom_settle_timeout_ms,
+        "browserbaseSessionID": self.session_id,
         "browserbaseSessionCreateParams": (
             browserbase_session_create_params
             if browserbase_session_create_params

CHANGELOG.md

@@ -399,15 +399,7 @@ async def init(self):
         if self.env == "BROWSERBASE":
             # Create session if we don't have one
             if self.use_api:
-                if not self.session_id:
-                    await self._create_session()  # Uses self._client and api_url
-                    self.logger.debug(
-                        f"Created new Browserbase session via Stagehand server: {self.session_id}"
-                    )
-                else:
-                    self.logger.debug(
-                        f"Using existing Browserbase session: {self.session_id}"
-                    )
+                await self._create_session()  # Uses self._client and api_url
 
             # Connect to remote browser
             try:

pyproject.toml

@@ -137,9 +137,14 @@ async def act(
         elif isinstance(action_or_result, ActOptions):
             payload = action_or_result.model_dump(exclude_none=True, by_alias=True)
         elif isinstance(action_or_result, dict):
-            payload = ObserveResult(**action_or_result).model_dump(
-                exclude_none=True, by_alias=True
-            )
+            if "description" in action_or_result:
+                payload = ObserveResult(**action_or_result).model_dump(
+                    exclude_none=True, by_alias=True
+                )
+            else:
+                payload = ActOptions(**action_or_result).model_dump(
+                    exclude_none=True, by_alias=True
+                )
         else:
             raise TypeError(
                 "Invalid arguments for 'act'. Expected str, ObserveResult, or ActOptions."
@@ -156,6 +161,10 @@ async def act(
                     self, self._stagehand, "", self._stagehand.self_heal
                 )
             self._stagehand.logger.debug("act", category="act", auxiliary=payload)
+            if payload.get("iframes"):
+                raise ValueError(
+                    "iframes is not yet supported without API (to enable make sure you set env=BROWSERBASE and use_api=true)"
+                )
             result = await self._act_handler.act(payload)
             return result
 
@@ -606,7 +615,7 @@ async def sweep_stalled_requests():
                         meta.pop(request_id, None)
                         self._stagehand.logger.debug(
                             "⏳ forcing completion of stalled iframe document",
-                            extra={"url": request_meta["url"][:120]},
+                            auxiliary={"url": request_meta["url"][:120]},
                         )
                 maybe_quiet()
 
@@ -620,7 +629,7 @@ async def timeout_guard():
                 if len(inflight) > 0:
                     self._stagehand.logger.debug(
                         "⚠️ DOM-settle timeout reached – network requests still pending",
-                        extra={"count": len(inflight)},
+                        auxiliary={"count": len(inflight)},
                     )
                 resolve_done()
 

stagehand/api.py

@@ -53,6 +53,7 @@ class ActOptions(StagehandBaseModel):
     dom_settle_timeout_ms: Optional[int] = None
     timeout_ms: Optional[int] = None
     model_client_options: Optional[dict[str, Any]] = None
+    iframes: Optional[bool] = None
 
 
 class ActResult(StagehandBaseModel):
@@ -98,6 +99,7 @@ class ExtractOptions(StagehandBaseModel):
     use_text_extract: Optional[bool] = None
     dom_settle_timeout_ms: Optional[int] = None
     model_client_options: Optional[dict[Any, Any]] = None
+    iframes: Optional[bool] = None
 
     @field_serializer("schema_definition")
     def serialize_schema_definition(
@@ -196,6 +198,7 @@ class ObserveOptions(StagehandBaseModel):
     draw_overlay: Optional[bool] = None
     dom_settle_timeout_ms: Optional[int] = None
     model_client_options: Optional[dict[str, Any]] = None
+    iframes: Optional[bool] = None
 
 
 class ObserveResult(StagehandBaseModel):