feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-705638ac8966569986bd9ebb7c9761bf0016909e9f2753e77ceabb12c8049511.yml
-openapi_spec_hash: a8fbbcaa38e91c7f97313620b42d8d62
+configured_endpoints: 1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-516862e7e90968bc55ac44ce7ffe2d5c1f738c11757471c2b9e0e4cff9384f2c.yml
+openapi_spec_hash: 19bbe52a6ae0eec7fc3f6698e831ee55
 config_hash: a35b56eb05306a0f02e83c11d57f975f

README.md

@@ -41,11 +41,7 @@ client = Stagehand(
     model_api_key=os.environ.get("MODEL_API_KEY"),  # This is the default and can be omitted
 )
 
-response = client.sessions.act(
-    session_id="00000000-your-session-id-000000000000",
-    input="click the first link on the page",
-)
-print(response.actions)
+response = client.sessions.start()
 ```
 
 While you can provide a `browserbase_api_key` keyword argument,
@@ -74,11 +70,7 @@ client = AsyncStagehand(
 
 
 async def main() -> None:
-    response = await client.sessions.act(
-        session_id="00000000-your-session-id-000000000000",
-        input="click the first link on the page",
-    )
-    print(response.actions)
+    response = await client.sessions.start()
 
 
 asyncio.run(main())
@@ -117,11 +109,7 @@ async def main() -> None:
         model_api_key=os.environ.get("MODEL_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
-        response = await client.sessions.act(
-            session_id="00000000-your-session-id-000000000000",
-            input="click the first link on the page",
-        )
-        print(response.actions)
+        response = await client.sessions.start()
 
 
 asyncio.run(main())
@@ -136,23 +124,6 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
-## Nested params
-
-Nested parameters are dictionaries, typed using `TypedDict`, for example:
-
-```python
-from stagehand import Stagehand
-
-client = Stagehand()
-
-response = client.sessions.act(
-    session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-    input="click the sign in button",
-    options={},
-)
-print(response.options)
-```
-
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `stagehand.APIConnectionError` is raised.
@@ -169,10 +140,7 @@ from stagehand import Stagehand
 client = Stagehand()
 
 try:
-    client.sessions.start(
-        browserbase_api_key="your Browserbase API key",
-        browserbase_project_id="your Browserbase Project ID",
-    )
+    client.sessions.start()
 except stagehand.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -215,10 +183,7 @@ client = Stagehand(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).sessions.start(
-    browserbase_api_key="your Browserbase API key",
-    browserbase_project_id="your Browserbase Project ID",
-)
+client.with_options(max_retries=5).sessions.start()
 ```
 
 ### Timeouts
@@ -241,10 +206,7 @@ client = Stagehand(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).sessions.start(
-    browserbase_api_key="your Browserbase API key",
-    browserbase_project_id="your Browserbase Project ID",
-)
+client.with_options(timeout=5.0).sessions.start()
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -285,14 +247,11 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from stagehand import Stagehand
 
 client = Stagehand()
-response = client.sessions.with_raw_response.start(
-    browserbase_api_key="your Browserbase API key",
-    browserbase_project_id="your Browserbase Project ID",
-)
+response = client.sessions.with_raw_response.start()
 print(response.headers.get('X-My-Header'))
 
 session = response.parse()  # get the object that `sessions.start()` would have returned
-print(session.available)
+print(session)
 ```
 
 These methods return an [`APIResponse`](https://github.com/browserbase/stagehand-python/tree/stainless/src/stagehand/_response.py) object.
@@ -306,10 +265,7 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.sessions.with_streaming_response.start(
-    browserbase_api_key="your Browserbase API key",
-    browserbase_project_id="your Browserbase Project ID",
-) as response:
+with client.sessions.with_streaming_response.start() as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():

api.md

@@ -3,25 +3,9 @@
 Types:
 
 ```python
-from stagehand.types import (
-    Action,
-    ModelConfig,
-    SessionActResponse,
-    SessionEndResponse,
-    SessionExecuteAgentResponse,
-    SessionExtractResponse,
-    SessionNavigateResponse,
-    SessionObserveResponse,
-    SessionStartResponse,
-)
+from stagehand.types import Action, ModelConfig
 ```
 
 Methods:
 
-- <code title="post /sessions/{sessionId}/act">client.sessions.<a href="./src/stagehand/resources/sessions.py">act</a>(session_id, \*\*<a href="src/stagehand/types/session_act_params.py">params</a>) -> <a href="./src/stagehand/types/session_act_response.py">SessionActResponse</a></code>
-- <code title="post /sessions/{sessionId}/end">client.sessions.<a href="./src/stagehand/resources/sessions.py">end</a>(session_id) -> <a href="./src/stagehand/types/session_end_response.py">SessionEndResponse</a></code>
-- <code title="post /sessions/{sessionId}/agentExecute">client.sessions.<a href="./src/stagehand/resources/sessions.py">execute_agent</a>(session_id, \*\*<a href="src/stagehand/types/session_execute_agent_params.py">params</a>) -> <a href="./src/stagehand/types/session_execute_agent_response.py">SessionExecuteAgentResponse</a></code>
-- <code title="post /sessions/{sessionId}/extract">client.sessions.<a href="./src/stagehand/resources/sessions.py">extract</a>(session_id, \*\*<a href="src/stagehand/types/session_extract_params.py">params</a>) -> <a href="./src/stagehand/types/session_extract_response.py">SessionExtractResponse</a></code>
-- <code title="post /sessions/{sessionId}/navigate">client.sessions.<a href="./src/stagehand/resources/sessions.py">navigate</a>(session_id, \*\*<a href="src/stagehand/types/session_navigate_params.py">params</a>) -> <a href="./src/stagehand/types/session_navigate_response.py">Optional[SessionNavigateResponse]</a></code>
-- <code title="post /sessions/{sessionId}/observe">client.sessions.<a href="./src/stagehand/resources/sessions.py">observe</a>(session_id, \*\*<a href="src/stagehand/types/session_observe_params.py">params</a>) -> <a href="./src/stagehand/types/session_observe_response.py">SessionObserveResponse</a></code>
-- <code title="post /sessions/start">client.sessions.<a href="./src/stagehand/resources/sessions.py">start</a>(\*\*<a href="src/stagehand/types/session_start_params.py">params</a>) -> <a href="./src/stagehand/types/session_start_response.py">SessionStartResponse</a></code>
+- <code title="post /sessions/start">client.sessions.<a href="./src/stagehand/resources/sessions.py">start</a>(\*\*<a href="src/stagehand/types/session_start_params.py">params</a>) -> object</code>