release: 1.6.0 (#160)

* chore(test): do not count install time for mock server timeout

* chore(ci): skip uploading artifacts on stainless-internal branches

* chore: update placeholder string

* feat: [CORE-1804][apps/api] Add fetch API schema

* release: 1.6.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -61,14 +61,18 @@ jobs:
         run: rye build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/browserbase-python'
+        if: |-
+          github.repository == 'stainless-sdks/browserbase-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/browserbase-python'
+        if: |-
+          github.repository == 'stainless-sdks/browserbase-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.5.0"
+  ".": "1.6.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 19
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-215bc4361122162181eecce83c0dbdda7c45a21801e7addb75102e8011413069.yml
-openapi_spec_hash: c4fadc5bb6b84cd3988c8d864b67bf61
-config_hash: a106b247c7cdf02ac1033077402cfe2d
+configured_endpoints: 20
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-b20f9fea14d79990ab1af3d276f931e026cd955ac623ec6ace80b2af90de170f.yml
+openapi_spec_hash: 943ff4b3297014503fdc9854544cb9a4
+config_hash: 55c54fdafc9e80be584829b5724b00ab

CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.6.0 (2026-03-11)
+
+Full Changelog: [v1.5.0...v1.6.0](https://github.com/browserbase/sdk-python/compare/v1.5.0...v1.6.0)
+
+### Features
+
+* [CORE-1804][apps/api] Add fetch API schema ([a56673c](https://github.com/browserbase/sdk-python/commit/a56673cf002d95b97d855befa64d46bd55559323))
+* **api:** api update ([#39](https://github.com/browserbase/sdk-python/issues/39)) ([8c98d9e](https://github.com/browserbase/sdk-python/commit/8c98d9e9da61daba527262aa1b0a1334da22a596))
+* **api:** api update ([#41](https://github.com/browserbase/sdk-python/issues/41)) ([0557ee5](https://github.com/browserbase/sdk-python/commit/0557ee507fc35faa9aabd8d06ce8047bb07843aa))
+* **api:** api update ([#44](https://github.com/browserbase/sdk-python/issues/44)) ([718ef11](https://github.com/browserbase/sdk-python/commit/718ef11db8e865347c24b2205b22f906bccb24e7))
+* **api:** update via SDK Studio ([#10](https://github.com/browserbase/sdk-python/issues/10)) ([712cb9f](https://github.com/browserbase/sdk-python/commit/712cb9f5d36d3f882e36848413fb96f32558b67c))
+* **api:** update via SDK Studio ([#13](https://github.com/browserbase/sdk-python/issues/13)) ([ec90079](https://github.com/browserbase/sdk-python/commit/ec900790bd56f92b174304bb227461a65209cbdb))
+* **api:** update via SDK Studio ([#16](https://github.com/browserbase/sdk-python/issues/16)) ([3739129](https://github.com/browserbase/sdk-python/commit/37391297ef3c3d59105c618ba9026ecae551a77b))
+* **api:** update via SDK Studio ([#18](https://github.com/browserbase/sdk-python/issues/18)) ([c8ff679](https://github.com/browserbase/sdk-python/commit/c8ff67974dbcf8a99dae87aea6e9b18046bf5acd))
+* **api:** update via SDK Studio ([#19](https://github.com/browserbase/sdk-python/issues/19)) ([1556b70](https://github.com/browserbase/sdk-python/commit/1556b7064ad2ec507d74536a1d074e5f464c3d12))
+* **api:** update via SDK Studio ([#20](https://github.com/browserbase/sdk-python/issues/20)) ([8876008](https://github.com/browserbase/sdk-python/commit/887600814fca35fbaf4cb4ddd2a0112a51a3f068))
+* **api:** update via SDK Studio ([#21](https://github.com/browserbase/sdk-python/issues/21)) ([8f22de1](https://github.com/browserbase/sdk-python/commit/8f22de1da97f9157ef52647f20895cabe5ecfd26))
+* **api:** update via SDK Studio ([#27](https://github.com/browserbase/sdk-python/issues/27)) ([b1facb8](https://github.com/browserbase/sdk-python/commit/b1facb8db6d821a2d3c5465dbeb474e0140ed90e))
+* **api:** update via SDK Studio ([#28](https://github.com/browserbase/sdk-python/issues/28)) ([0735db2](https://github.com/browserbase/sdk-python/commit/0735db24fb833dbeb5d09f30b8fd18e67d7a2e5d))
+* **api:** update via SDK Studio ([#29](https://github.com/browserbase/sdk-python/issues/29)) ([c1e0eb9](https://github.com/browserbase/sdk-python/commit/c1e0eb9d84a8b83b30fce673a4c5e6262ce732b2))
+* **api:** update via SDK Studio ([#32](https://github.com/browserbase/sdk-python/issues/32)) ([54a7ed4](https://github.com/browserbase/sdk-python/commit/54a7ed479088a68434961cd92ae225064bf8e8a1))
+* **api:** update via SDK Studio ([#35](https://github.com/browserbase/sdk-python/issues/35)) ([cdc05f9](https://github.com/browserbase/sdk-python/commit/cdc05f947c676bd56bed22e77fcfd48c313f3596))
+* **api:** update via SDK Studio ([#7](https://github.com/browserbase/sdk-python/issues/7)) ([90f80c7](https://github.com/browserbase/sdk-python/commit/90f80c7d8a44b155cac6dc9ed73ac55dbbb9596d))
+* various codegen changes ([a70c78e](https://github.com/browserbase/sdk-python/commit/a70c78ecf5c0f4763c9222a332c164249c1060bc))
+
+
+### Chores
+
+* **ci:** skip uploading artifacts on stainless-internal branches ([99d0409](https://github.com/browserbase/sdk-python/commit/99d0409a98d14dc19359b80a966c30e2aa5d99f0))
+* **test:** do not count install time for mock server timeout ([b19e21b](https://github.com/browserbase/sdk-python/commit/b19e21bf4d411face9fd8f252f35bac1981370ef))
+* update placeholder string ([8ff9f32](https://github.com/browserbase/sdk-python/commit/8ff9f32b3d608ea9a2a4e6bd9120c029bd05f6d4))
+* update SDK settings ([#1](https://github.com/browserbase/sdk-python/issues/1)) ([dc1e229](https://github.com/browserbase/sdk-python/commit/dc1e229189470b0f3df3c5a2e7da4e789fc76279))
+
 ## 1.5.0-alpha.2 (2026-03-03)
 
 Full Changelog: [v1.5.0-alpha.1...v1.5.0-alpha.2](https://github.com/browserbase/sdk-python/compare/v1.5.0-alpha.1...v1.5.0-alpha.2)

api.md

@@ -27,6 +27,18 @@ Methods:
 - <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="delete /v1/extensions/{id}">client.extensions.<a href="./src/browserbase/resources/extensions.py">delete</a>(id) -> None</code>
 
+# FetchAPI
+
+Types:
+
+```python
+from browserbase.types import FetchAPICreateResponse
+```
+
+Methods:
+
+- <code title="post /v1/fetch">client.fetch_api.<a href="./src/browserbase/resources/fetch_api.py">create</a>(\*\*<a href="src/browserbase/types/fetch_api_create_params.py">params</a>) -> <a href="./src/browserbase/types/fetch_api_create_response.py">FetchAPICreateResponse</a></code>
+
 # Projects
 
 Types:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "browserbase"
-version = "1.5.0"
+version = "1.6.0"
 description = "The official Python library for the Browserbase API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/mock

@@ -21,11 +21,22 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
+  # Pre-install the package so the download doesn't eat into the startup timeout
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism --version
+
   npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
-  # Wait for server to come online
+  # Wait for server to come online (max 30s)
   echo -n "Waiting for server"
+  attempts=0
   while ! grep -q "✖  fatal\|Prism is listening" ".prism.log" ; do
+    attempts=$((attempts + 1))
+    if [ "$attempts" -ge 300 ]; then
+      echo
+      echo "Timed out waiting for Prism server to start"
+      cat .prism.log
+      exit 1
+    fi
     echo -n "."
     sleep 0.1
   done

src/browserbase/_client.py

@@ -31,9 +31,10 @@
 )
 
 if TYPE_CHECKING:
-    from .resources import contexts, projects, sessions, extensions
+    from .resources import contexts, projects, sessions, fetch_api, extensions
     from .resources.contexts import ContextsResource, AsyncContextsResource
     from .resources.projects import ProjectsResource, AsyncProjectsResource
+    from .resources.fetch_api import FetchAPIResource, AsyncFetchAPIResource
     from .resources.extensions import ExtensionsResource, AsyncExtensionsResource
     from .resources.sessions.sessions import SessionsResource, AsyncSessionsResource
 
@@ -116,6 +117,12 @@ def extensions(self) -> ExtensionsResource:
 
         return ExtensionsResource(self)
 
+    @cached_property
+    def fetch_api(self) -> FetchAPIResource:
+        from .resources.fetch_api import FetchAPIResource
+
+        return FetchAPIResource(self)
+
     @cached_property
     def projects(self) -> ProjectsResource:
         from .resources.projects import ProjectsResource
@@ -308,6 +315,12 @@ def extensions(self) -> AsyncExtensionsResource:
 
         return AsyncExtensionsResource(self)
 
+    @cached_property
+    def fetch_api(self) -> AsyncFetchAPIResource:
+        from .resources.fetch_api import AsyncFetchAPIResource
+
+        return AsyncFetchAPIResource(self)
+
     @cached_property
     def projects(self) -> AsyncProjectsResource:
         from .resources.projects import AsyncProjectsResource
@@ -451,6 +464,12 @@ def extensions(self) -> extensions.ExtensionsResourceWithRawResponse:
 
         return ExtensionsResourceWithRawResponse(self._client.extensions)
 
+    @cached_property
+    def fetch_api(self) -> fetch_api.FetchAPIResourceWithRawResponse:
+        from .resources.fetch_api import FetchAPIResourceWithRawResponse
+
+        return FetchAPIResourceWithRawResponse(self._client.fetch_api)
+
     @cached_property
     def projects(self) -> projects.ProjectsResourceWithRawResponse:
         from .resources.projects import ProjectsResourceWithRawResponse
@@ -482,6 +501,12 @@ def extensions(self) -> extensions.AsyncExtensionsResourceWithRawResponse:
 
         return AsyncExtensionsResourceWithRawResponse(self._client.extensions)
 
+    @cached_property
+    def fetch_api(self) -> fetch_api.AsyncFetchAPIResourceWithRawResponse:
+        from .resources.fetch_api import AsyncFetchAPIResourceWithRawResponse
+
+        return AsyncFetchAPIResourceWithRawResponse(self._client.fetch_api)
+
     @cached_property
     def projects(self) -> projects.AsyncProjectsResourceWithRawResponse:
         from .resources.projects import AsyncProjectsResourceWithRawResponse
@@ -513,6 +538,12 @@ def extensions(self) -> extensions.ExtensionsResourceWithStreamingResponse:
 
         return ExtensionsResourceWithStreamingResponse(self._client.extensions)
 
+    @cached_property
+    def fetch_api(self) -> fetch_api.FetchAPIResourceWithStreamingResponse:
+        from .resources.fetch_api import FetchAPIResourceWithStreamingResponse
+
+        return FetchAPIResourceWithStreamingResponse(self._client.fetch_api)
+
     @cached_property
     def projects(self) -> projects.ProjectsResourceWithStreamingResponse:
         from .resources.projects import ProjectsResourceWithStreamingResponse
@@ -544,6 +575,12 @@ def extensions(self) -> extensions.AsyncExtensionsResourceWithStreamingResponse:
 
         return AsyncExtensionsResourceWithStreamingResponse(self._client.extensions)
 
+    @cached_property
+    def fetch_api(self) -> fetch_api.AsyncFetchAPIResourceWithStreamingResponse:
+        from .resources.fetch_api import AsyncFetchAPIResourceWithStreamingResponse
+
+        return AsyncFetchAPIResourceWithStreamingResponse(self._client.fetch_api)
+
     @cached_property
     def projects(self) -> projects.AsyncProjectsResourceWithStreamingResponse:
         from .resources.projects import AsyncProjectsResourceWithStreamingResponse

src/browserbase/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "browserbase"
-__version__ = "1.5.0"  # x-release-please-version
+__version__ = "1.6.0"  # x-release-please-version

src/browserbase/resources/__init__.py

@@ -24,6 +24,14 @@
     SessionsResourceWithStreamingResponse,
     AsyncSessionsResourceWithStreamingResponse,
 )
+from .fetch_api import (
+    FetchAPIResource,
+    AsyncFetchAPIResource,
+    FetchAPIResourceWithRawResponse,
+    AsyncFetchAPIResourceWithRawResponse,
+    FetchAPIResourceWithStreamingResponse,
+    AsyncFetchAPIResourceWithStreamingResponse,
+)
 from .extensions import (
     ExtensionsResource,
     AsyncExtensionsResource,
@@ -46,6 +54,12 @@
     "AsyncExtensionsResourceWithRawResponse",
     "ExtensionsResourceWithStreamingResponse",
     "AsyncExtensionsResourceWithStreamingResponse",
+    "FetchAPIResource",
+    "AsyncFetchAPIResource",
+    "FetchAPIResourceWithRawResponse",
+    "AsyncFetchAPIResourceWithRawResponse",
+    "FetchAPIResourceWithStreamingResponse",
+    "AsyncFetchAPIResourceWithStreamingResponse",
     "ProjectsResource",
     "AsyncProjectsResource",
     "ProjectsResourceWithRawResponse",