feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 19
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-b92143ddb16135de4ff65ce8bcdfe9991d11c73570f42f07ea27e0da86209a44.yml
-openapi_spec_hash: 16eb6e6c9687f01d2a791775b27dc315
-config_hash: b01d72cbe03bd762a73b05744086b2ec
+configured_endpoints: 18
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-be7a4aeebb1605262935b4b3ab446a95b1fad8a7d18098943dd548c8a486ef13.yml
+openapi_spec_hash: 1c950a109f80140711e7ae2cf87fddad
+config_hash: b3ca4ec5b02e5333af51ebc2e9fdef1b

README.md

@@ -135,6 +135,7 @@ from browserbase import Browserbase
 client = Browserbase()
 
 session = client.sessions.create(
+    project_id="projectId",
     browser_settings={},
 )
 print(session.browser_settings)

api.md

@@ -3,65 +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>
-- <code title="delete /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">delete</a>(id) -> None</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
 
@@ -74,7 +73,7 @@ Methods:
 Types:
 
 ```python
-from browserbase.types.sessions import SessionLog, LogListResponse
+from browserbase.types.sessions import LogListResponse
 ```
 
 Methods:
@@ -86,7 +85,7 @@ Methods:
 Types:
 
 ```python
-from browserbase.types.sessions import SessionRecording, RecordingRetrieveResponse
+from browserbase.types.sessions import RecordingRetrieveResponse
 ```
 
 Methods:

src/browserbase/resources/contexts.py

@@ -5,7 +5,7 @@
 import httpx
 
 from ..types import context_create_params
-from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
+from .._types import Body, Query, Headers, NotGiven, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -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"]
 
@@ -46,7 +46,7 @@ def with_streaming_response(self) -> ContextsResourceWithStreamingResponse:
     def create(
         self,
         *,
-        project_id: str | Omit = omit,
+        project_id: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -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
@@ -145,40 +145,6 @@ def update(
             cast_to=ContextUpdateResponse,
         )
 
-    def delete(
-        self,
-        id: str,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> None:
-        """
-        Delete Context
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return self._delete(
-            f"/v1/contexts/{id}",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=NoneType,
-        )
-
 
 class AsyncContextsResource(AsyncAPIResource):
     @cached_property
@@ -203,7 +169,7 @@ def with_streaming_response(self) -> AsyncContextsResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        project_id: str | Omit = omit,
+        project_id: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -246,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
@@ -266,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(
@@ -281,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
@@ -302,40 +268,6 @@ async def update(
             cast_to=ContextUpdateResponse,
         )
 
-    async def delete(
-        self,
-        id: str,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> None:
-        """
-        Delete Context
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return await self._delete(
-            f"/v1/contexts/{id}",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=NoneType,
-        )
-
 
 class ContextsResourceWithRawResponse:
     def __init__(self, contexts: ContextsResource) -> None:
@@ -350,9 +282,6 @@ def __init__(self, contexts: ContextsResource) -> None:
         self.update = to_raw_response_wrapper(
             contexts.update,
         )
-        self.delete = to_raw_response_wrapper(
-            contexts.delete,
-        )
 
 
 class AsyncContextsResourceWithRawResponse:
@@ -368,9 +297,6 @@ def __init__(self, contexts: AsyncContextsResource) -> None:
         self.update = async_to_raw_response_wrapper(
             contexts.update,
         )
-        self.delete = async_to_raw_response_wrapper(
-            contexts.delete,
-        )
 
 
 class ContextsResourceWithStreamingResponse:
@@ -386,9 +312,6 @@ def __init__(self, contexts: ContextsResource) -> None:
         self.update = to_streamed_response_wrapper(
             contexts.update,
         )
-        self.delete = to_streamed_response_wrapper(
-            contexts.delete,
-        )
 
 
 class AsyncContextsResourceWithStreamingResponse:
@@ -404,6 +327,3 @@ def __init__(self, contexts: AsyncContextsResource) -> None:
         self.update = async_to_streamed_response_wrapper(
             contexts.update,
         )
-        self.delete = async_to_streamed_response_wrapper(
-            contexts.delete,
-        )