Added x_sdk_version headers + resolved api path

Author: monadoid

examples/act_example.py

@@ -0,0 +1,75 @@
+"""
+Example demonstrating calling act() with a string instruction.
+
+This example shows how to use the act() method with a natural language
+string instruction instead of an Action object from observe().
+
+The act() method accepts either:
+1. A string instruction (demonstrated here): input="click the button"
+2. An Action object from observe(): input=action_object
+
+Required environment variables:
+- BROWSERBASE_API_KEY: Your Browserbase API key
+- BROWSERBASE_PROJECT_ID: Your Browserbase project ID
+- MODEL_API_KEY: Your OpenAI API key
+"""
+
+import os
+
+from stagehand import Stagehand
+
+
+def main() -> None:
+    # Create client using environment variables
+    # BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
+    client = Stagehand(
+        browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
+        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
+        model_api_key=os.environ.get("MODEL_API_KEY"),
+    )
+
+    # Start a new browser session
+    start_response = client.sessions.start(
+        model_name="openai/gpt-5-nano",
+    )
+
+    session_id = start_response.data.session_id
+    print(f"Session started: {session_id}")
+
+    try:
+        # Navigate to example.com
+        client.sessions.navigate(
+            id=session_id,
+            url="https://www.example.com",
+            frame_id="",  # Empty string for main frame
+        )
+        print("Navigated to example.com")
+
+        # Call act() with a string instruction directly
+        # This is the key test - passing a string instead of an Action object
+        print("\nAttempting to call act() with string input...")
+        act_response = client.sessions.act(
+            id=session_id,
+            input="click the 'More information' link",  # String instruction
+        )
+
+        print(f"Act completed successfully!")
+        print(f"Result: {act_response.data.result.message}")
+        print(f"Success: {act_response.data.result.success}")
+
+    except Exception as e:
+        print(f"Error: {e}")
+        print(f"Error type: {type(e).__name__}")
+        import traceback
+        traceback.print_exc()
+
+    finally:
+        # End the session to clean up resources
+        client.sessions.end(
+            id=session_id,
+        )
+        print("\nSession ended")
+
+
+if __name__ == "__main__":
+    main()

examples/full_example.py

@@ -22,9 +22,6 @@
 
 
 def main() -> None:
-    # SDK version for API compatibility (matches TypeScript SDK v3)
-    SDK_VERSION = "3.0.6"
-
     # Create client using environment variables
     # BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
     client = Stagehand(
@@ -36,8 +33,6 @@ def main() -> None:
     # Start a new browser session
     start_response = client.sessions.start(
         model_name="openai/gpt-5-nano",
-        x_language="typescript",
-        x_sdk_version=SDK_VERSION,
     )
 
     session_id = start_response.data.session_id
@@ -49,17 +44,13 @@ def main() -> None:
             id=session_id,
             url="https://news.ycombinator.com",
             frame_id="",  # Empty string for main frame
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
         )
         print("Navigated to Hacker News")
 
         # Observe to find possible actions - looking for the comments link
         observe_response = client.sessions.observe(
             id=session_id,
             instruction="find the link to view comments for the top post",
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
         )
 
         results = observe_response.data.result
@@ -77,8 +68,6 @@ def main() -> None:
         act_response = client.sessions.act(
             id=session_id,
             input=result,  # type: ignore[arg-type]
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
         )
         print(f"Act completed: {act_response.data.result.message}")
 
@@ -101,8 +90,6 @@ def main() -> None:
                 },
                 "required": ["commentText"]
             },
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
         )
 
         # Get the extracted result
@@ -133,8 +120,6 @@ def main() -> None:
                 },
                 "cua": False,
             },
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
             timeout=300.0,  # 5 minutes
         )
 
@@ -146,8 +131,6 @@ def main() -> None:
         # End the session to clean up resources
         client.sessions.end(
             id=session_id,
-            x_language="typescript",
-            x_sdk_version=SDK_VERSION,
         )
         print("Session ended")
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stagehand-alpha"
-version = "0.2.3"
+version = "1.0.0"
 description = "The official Python library for the stagehand API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/stagehand/_client.py

@@ -149,7 +149,7 @@ def __init__(
             if base_url is None:
                 base_url = os.environ.get("STAGEHAND_BASE_URL")
             if base_url is None:
-                base_url = f"https://api.stagehand.browserbase.com/v1"
+                base_url = f"https://api.stagehand.browserbase.com"
 
         super().__init__(
             version=__version__,
@@ -223,6 +223,7 @@ def default_headers(self) -> dict[str, str | Omit]:
         return {
             **super().default_headers,
             "x-language": "python",
+            "x-sdk-version": __version__,
             "X-Stainless-Async": "false",
             **self._custom_headers,
         }
@@ -438,7 +439,7 @@ def __init__(
             if base_url is None:
                 base_url = os.environ.get("STAGEHAND_BASE_URL")
             if base_url is None:
-                base_url = f"https://api.stagehand.browserbase.com/v1"
+                base_url = f"https://api.stagehand.browserbase.com"
 
         super().__init__(
             version=__version__,
@@ -512,6 +513,7 @@ def default_headers(self) -> dict[str, str | Omit]:
         return {
             **super().default_headers,
             "x-language": "python",
+            "x-sdk-version": __version__,
             "X-Stainless-Async": f"async:{get_async_library()}",
             **self._custom_headers,
         }