feat(api): api update

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -35,31 +35,17 @@ jobs:
       - name: Run lints
         run: ./scripts/lint
 
-  build:
+  upload:
     if: github.repository == 'stainless-sdks/browserbase-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
     timeout-minutes: 10
-    name: build
+    name: upload
     permissions:
       contents: read
       id-token: write
     runs-on: depot-ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
-
-      - name: Install dependencies
-        run: rye sync --all-features
-
-      - name: Run build
-        run: rye build
-
       - name: Get GitHub OIDC Token
         id: github-oidc
         uses: actions/github-script@v6

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-e2ed1b5267eeff92982918505349017b9155da2c7ab948787ab11cf9068af1b8.yml
-openapi_spec_hash: 77cba4a3c422b7378ecc7d57d84ff0b1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-fe7af3b907d79ac271560c1d2e887ed741cfcc08cb8b75596094411a2091e223.yml
+openapi_spec_hash: 999fb6ba05cd9be138ff94b787957ce9
 config_hash: b3ca4ec5b02e5333af51ebc2e9fdef1b

README.md

@@ -134,7 +134,7 @@ from browserbase import Browserbase
 client = Browserbase()
 
 session = client.sessions.create(
-    project_id="projectId",
+    project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
     browser_settings={},
 )
 print(session.browser_settings)

api.md

@@ -3,64 +3,64 @@
 Types:
 
 ```python
-from browserbase.types import Context, ContextCreateResponse, ContextUpdateResponse
+from browserbase.types import ContextCreateResponse, ContextRetrieveResponse, ContextUpdateResponse
 ```
 
 Methods:
 
 - <code title="post /v1/contexts">client.contexts.<a href="./src/browserbase/resources/contexts.py">create</a>(\*\*<a href="src/browserbase/types/context_create_params.py">params</a>) -> <a href="./src/browserbase/types/context_create_response.py">ContextCreateResponse</a></code>
-- <code title="get /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">retrieve</a>(id) -> <a href="./src/browserbase/types/context.py">Context</a></code>
+- <code title="get /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">retrieve</a>(id) -> <a href="./src/browserbase/types/context_retrieve_response.py">ContextRetrieveResponse</a></code>
 - <code title="put /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">update</a>(id) -> <a href="./src/browserbase/types/context_update_response.py">ContextUpdateResponse</a></code>
 
 # Extensions
 
 Types:
 
 ```python
-from browserbase.types import Extension
+from browserbase.types import ExtensionCreateResponse, ExtensionRetrieveResponse
 ```
 
 Methods:
 
-- <code title="post /v1/extensions">client.extensions.<a href="./src/browserbase/resources/extensions.py">create</a>(\*\*<a href="src/browserbase/types/extension_create_params.py">params</a>) -> <a href="./src/browserbase/types/extension.py">Extension</a></code>
-- <code title="get /v1/extensions/{id}">client.extensions.<a href="./src/browserbase/resources/extensions.py">retrieve</a>(id) -> <a href="./src/browserbase/types/extension.py">Extension</a></code>
+- <code title="post /v1/extensions">client.extensions.<a href="./src/browserbase/resources/extensions.py">create</a>(\*\*<a href="src/browserbase/types/extension_create_params.py">params</a>) -> <a href="./src/browserbase/types/extension_create_response.py">ExtensionCreateResponse</a></code>
+- <code title="get /v1/extensions/{id}">client.extensions.<a href="./src/browserbase/resources/extensions.py">retrieve</a>(id) -> <a href="./src/browserbase/types/extension_retrieve_response.py">ExtensionRetrieveResponse</a></code>
 - <code title="delete /v1/extensions/{id}">client.extensions.<a href="./src/browserbase/resources/extensions.py">delete</a>(id) -> None</code>
 
 # Projects
 
 Types:
 
 ```python
-from browserbase.types import Project, ProjectUsage, ProjectListResponse
+from browserbase.types import ProjectRetrieveResponse, ProjectListResponse, ProjectUsageResponse
 ```
 
 Methods:
 
-- <code title="get /v1/projects/{id}">client.projects.<a href="./src/browserbase/resources/projects.py">retrieve</a>(id) -> <a href="./src/browserbase/types/project.py">Project</a></code>
+- <code title="get /v1/projects/{id}">client.projects.<a href="./src/browserbase/resources/projects.py">retrieve</a>(id) -> <a href="./src/browserbase/types/project_retrieve_response.py">ProjectRetrieveResponse</a></code>
 - <code title="get /v1/projects">client.projects.<a href="./src/browserbase/resources/projects.py">list</a>() -> <a href="./src/browserbase/types/project_list_response.py">ProjectListResponse</a></code>
-- <code title="get /v1/projects/{id}/usage">client.projects.<a href="./src/browserbase/resources/projects.py">usage</a>(id) -> <a href="./src/browserbase/types/project_usage.py">ProjectUsage</a></code>
+- <code title="get /v1/projects/{id}/usage">client.projects.<a href="./src/browserbase/resources/projects.py">usage</a>(id) -> <a href="./src/browserbase/types/project_usage_response.py">ProjectUsageResponse</a></code>
 
 # Sessions
 
 Types:
 
 ```python
 from browserbase.types import (
-    Session,
-    SessionLiveURLs,
     SessionCreateResponse,
     SessionRetrieveResponse,
+    SessionUpdateResponse,
     SessionListResponse,
+    SessionDebugResponse,
 )
 ```
 
 Methods:
 
 - <code title="post /v1/sessions">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">create</a>(\*\*<a href="src/browserbase/types/session_create_params.py">params</a>) -> <a href="./src/browserbase/types/session_create_response.py">SessionCreateResponse</a></code>
 - <code title="get /v1/sessions/{id}">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">retrieve</a>(id) -> <a href="./src/browserbase/types/session_retrieve_response.py">SessionRetrieveResponse</a></code>
-- <code title="post /v1/sessions/{id}">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">update</a>(id, \*\*<a href="src/browserbase/types/session_update_params.py">params</a>) -> <a href="./src/browserbase/types/session.py">Session</a></code>
+- <code title="post /v1/sessions/{id}">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">update</a>(id, \*\*<a href="src/browserbase/types/session_update_params.py">params</a>) -> <a href="./src/browserbase/types/session_update_response.py">SessionUpdateResponse</a></code>
 - <code title="get /v1/sessions">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">list</a>(\*\*<a href="src/browserbase/types/session_list_params.py">params</a>) -> <a href="./src/browserbase/types/session_list_response.py">SessionListResponse</a></code>
-- <code title="get /v1/sessions/{id}/debug">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">debug</a>(id) -> <a href="./src/browserbase/types/session_live_urls.py">SessionLiveURLs</a></code>
+- <code title="get /v1/sessions/{id}/debug">client.sessions.<a href="./src/browserbase/resources/sessions/sessions.py">debug</a>(id) -> <a href="./src/browserbase/types/session_debug_response.py">SessionDebugResponse</a></code>
 
 ## Downloads
 
@@ -73,7 +73,7 @@ Methods:
 Types:
 
 ```python
-from browserbase.types.sessions import SessionLog, LogListResponse
+from browserbase.types.sessions import LogListResponse
 ```
 
 Methods:
@@ -85,7 +85,7 @@ Methods:
 Types:
 
 ```python
-from browserbase.types.sessions import SessionRecording, RecordingRetrieveResponse
+from browserbase.types.sessions import RecordingRetrieveResponse
 ```
 
 Methods:

scripts/utils/upload-artifact.sh

@@ -1,9 +1,7 @@
 #!/usr/bin/env bash
 set -exuo pipefail
 
-FILENAME=$(basename dist/*.whl)
-
-RESPONSE=$(curl -X POST "$URL?filename=$FILENAME" \
+RESPONSE=$(curl -X POST "$URL" \
   -H "Authorization: Bearer $AUTH" \
   -H "Content-Type: application/json")
 
@@ -14,13 +12,13 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(curl -v -X PUT \
-  -H "Content-Type: binary/octet-stream" \
-  --data-binary "@dist/$FILENAME" "$SIGNED_URL" 2>&1)
+UPLOAD_RESPONSE=$(tar -cz . | curl -v -X PUT \
+  -H "Content-Type: application/gzip" \
+  --data-binary @- "$SIGNED_URL" 2>&1)
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"
-  echo -e "\033[32mInstallation: pip install 'https://pkg.stainless.com/s/browserbase-python/$SHA/$FILENAME'\033[0m"
+  echo -e "\033[32mInstallation: pip install 'https://pkg.stainless.com/s/browserbase-python/$SHA'\033[0m"
 else
   echo -e "\033[31mFailed to upload artifact.\033[0m"
   exit 1

src/browserbase/resources/contexts.py

@@ -16,9 +16,9 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
-from ..types.context import Context
 from ..types.context_create_response import ContextCreateResponse
 from ..types.context_update_response import ContextUpdateResponse
+from ..types.context_retrieve_response import ContextRetrieveResponse
 
 __all__ = ["ContextsResource", "AsyncContextsResource"]
 
@@ -89,9 +89,9 @@ def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Context:
+    ) -> ContextRetrieveResponse:
         """
-        Context
+        Get a Context
 
         Args:
           extra_headers: Send extra headers
@@ -109,7 +109,7 @@ def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Context,
+            cast_to=ContextRetrieveResponse,
         )
 
     def update(
@@ -124,7 +124,7 @@ def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ContextUpdateResponse:
         """
-        Update Context
+        Update a Context
 
         Args:
           extra_headers: Send extra headers
@@ -212,9 +212,9 @@ async def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Context:
+    ) -> ContextRetrieveResponse:
         """
-        Context
+        Get a Context
 
         Args:
           extra_headers: Send extra headers
@@ -232,7 +232,7 @@ async def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Context,
+            cast_to=ContextRetrieveResponse,
         )
 
     async def update(
@@ -247,7 +247,7 @@ async def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ContextUpdateResponse:
         """
-        Update Context
+        Update a Context
 
         Args:
           extra_headers: Send extra headers

src/browserbase/resources/extensions.py

@@ -18,7 +18,8 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
-from ..types.extension import Extension
+from ..types.extension_create_response import ExtensionCreateResponse
+from ..types.extension_retrieve_response import ExtensionRetrieveResponse
 
 __all__ = ["ExtensionsResource", "AsyncExtensionsResource"]
 
@@ -53,7 +54,7 @@ def create(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Extension:
+    ) -> ExtensionCreateResponse:
         """
         Upload an Extension
 
@@ -79,7 +80,7 @@ def create(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Extension,
+            cast_to=ExtensionCreateResponse,
         )
 
     def retrieve(
@@ -92,9 +93,9 @@ def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Extension:
+    ) -> ExtensionRetrieveResponse:
         """
-        Extension
+        Get an Extension
 
         Args:
           extra_headers: Send extra headers
@@ -112,7 +113,7 @@ def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Extension,
+            cast_to=ExtensionRetrieveResponse,
         )
 
     def delete(
@@ -127,7 +128,7 @@ def delete(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete Extension
+        Delete an Extension
 
         Args:
           extra_headers: Send extra headers
@@ -180,7 +181,7 @@ async def create(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Extension:
+    ) -> ExtensionCreateResponse:
         """
         Upload an Extension
 
@@ -206,7 +207,7 @@ async def create(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Extension,
+            cast_to=ExtensionCreateResponse,
         )
 
     async def retrieve(
@@ -219,9 +220,9 @@ async def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Extension:
+    ) -> ExtensionRetrieveResponse:
         """
-        Extension
+        Get an Extension
 
         Args:
           extra_headers: Send extra headers
@@ -239,7 +240,7 @@ async def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=Extension,
+            cast_to=ExtensionRetrieveResponse,
         )
 
     async def delete(
@@ -254,7 +255,7 @@ async def delete(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete Extension
+        Delete an Extension
 
         Args:
           extra_headers: Send extra headers