feat(api): manual updates

Author: stainless-app[bot]

.github/workflows/publish-gem.yml

@@ -27,5 +27,5 @@ jobs:
           bash ./bin/publish-gem
         env:
           # `RUBYGEMS_HOST` is only required for private gem repositories, not https://rubygems.org
-          RUBYGEMS_HOST: ${{ secrets.BROWSERBASE_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
-          GEM_HOST_API_KEY: ${{ secrets.BROWSERBASE_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}
+          RUBYGEMS_HOST: ${{ secrets.STAGEHAND_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
+          GEM_HOST_API_KEY: ${{ secrets.STAGEHAND_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}

.github/workflows/release-doctor.yml

@@ -18,5 +18,5 @@ jobs:
         run: |
           bash ./bin/check-release-environment
         env:
-          RUBYGEMS_HOST: ${{ secrets.BROWSERBASE_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
-          GEM_HOST_API_KEY: ${{ secrets.BROWSERBASE_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}
+          RUBYGEMS_HOST: ${{ secrets.STAGEHAND_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
+          GEM_HOST_API_KEY: ${{ secrets.STAGEHAND_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-0c12f985340be2a9287e8e01ff8733f7f2d02e019149d1ae95f1a8f8798c6690.yml
 openapi_spec_hash: efb79934e1dc63763dd4e8493b825273
-config_hash: 905fc70fd4344c8631aab6754bffd883
+config_hash: 1de7cb9bd4dc46fe3e20b637bc534908

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Browserbase
+   Copyright 2025 Stagehand
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -1,14 +1,14 @@
-# Browserbase Ruby API library
+# Stagehand Ruby API library
 
-The Browserbase Ruby library provides convenient access to the Browserbase REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/browserbase/stagehand-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+The Stagehand Ruby library provides convenient access to the Stagehand REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/browserbase/stagehand-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/stagehand).
 
-The REST API documentation can be found on [browserbase.com](https://browserbase.com).
+The REST API documentation can be found on [docs.stagehand.dev](https://docs.stagehand.dev).
 
 ## Installation
 
@@ -28,12 +28,12 @@ gem "stagehand", "~> 0.0.1"
 require "bundler/setup"
 require "stagehand"
 
-browserbase = Stagehand::Client.new(
+stagehand = Stagehand::Client.new(
   api_key: ENV["STAGEHAND_API_KEY"], # This is the default and can be omitted
   environment: "dev" # or "production" | "local"; defaults to "production"
 )
 
-response = browserbase.sessions.start(env: "LOCAL")
+response = stagehand.sessions.start(env: "LOCAL")
 
 puts(response.available)
 ```
@@ -44,7 +44,7 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  session = browserbase.sessions.start(env: "LOCAL")
+  session = stagehand.sessions.start(env: "LOCAL")
 rescue Stagehand::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -82,12 +82,12 @@ You can use the `max_retries` option to configure or disable this:
 
 ```ruby
 # Configure the default for all requests:
-browserbase = Stagehand::Client.new(
+stagehand = Stagehand::Client.new(
   max_retries: 0 # default is 2
 )
 
 # Or, configure per-request:
-browserbase.sessions.start(env: "LOCAL", request_options: {max_retries: 5})
+stagehand.sessions.start(env: "LOCAL", request_options: {max_retries: 5})
 ```
 
 ### Timeouts
@@ -96,12 +96,12 @@ By default, requests will time out after 60 seconds. You can use the timeout opt
 
 ```ruby
 # Configure the default for all requests:
-browserbase = Stagehand::Client.new(
+stagehand = Stagehand::Client.new(
   timeout: nil # default is 60
 )
 
 # Or, configure per-request:
-browserbase.sessions.start(env: "LOCAL", request_options: {timeout: 5})
+stagehand.sessions.start(env: "LOCAL", request_options: {timeout: 5})
 ```
 
 On timeout, `Stagehand::Errors::APITimeoutError` is raised.
@@ -132,7 +132,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 
 ```ruby
 response =
-  browserbase.sessions.start(
+  stagehand.sessions.start(
     env: "LOCAL",
     request_options: {
       extra_query: {my_query_parameter: value},
@@ -179,18 +179,18 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-browserbase.sessions.start(env: "LOCAL")
+stagehand.sessions.start(env: "LOCAL")
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-browserbase.sessions.start(env: "LOCAL")
+stagehand.sessions.start(env: "LOCAL")
 
 # You can also splat a full Params class:
 params = Stagehand::SessionStartParams.new(env: "LOCAL")
-browserbase.sessions.start(**params)
+stagehand.sessions.start(**params)
 ```
 
 ### Enums
@@ -209,13 +209,13 @@ Enum parameters have a "relaxed" type, so you can either pass in enum constants
 
 ```ruby
 # Using the enum constants preserves the tagged type information:
-browserbase.sessions.act(
+stagehand.sessions.act(
   x_stream_response: Stagehand::SessionActParams::XStreamResponse::TRUE,
   # …
 )
 
 # Literal values are also permissible:
-browserbase.sessions.act(
+stagehand.sessions.act(
   x_stream_response: :true,
   # …
 )

SECURITY.md

@@ -16,7 +16,7 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Browserbase, please follow the respective company's security reporting guidelines.
+or products provided by Stagehand, please follow the respective company's security reporting guidelines.
 
 ---
 

lib/stagehand/client.rb

@@ -53,7 +53,7 @@ class Client < Stagehand::Internal::Transport::BaseClient
     # - `local` corresponds to `http://localhost:5000/v1`
     #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
-    # `"https://api.example.com/v2/"`. Defaults to `ENV["BROWSERBASE_BASE_URL"]`
+    # `"https://api.example.com/v2/"`. Defaults to `ENV["STAGEHAND_BASE_URL"]`
     #
     # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
     #
@@ -65,7 +65,7 @@ class Client < Stagehand::Internal::Transport::BaseClient
     def initialize(
       api_key: ENV["STAGEHAND_API_KEY"],
       environment: nil,
-      base_url: ENV["BROWSERBASE_BASE_URL"],
+      base_url: ENV["STAGEHAND_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,

rbi/stagehand/client.rbi

@@ -55,8 +55,8 @@ module Stagehand
       # - `local` corresponds to `http://localhost:5000/v1`
       environment: nil,
       # Override the default base URL for the API, e.g.,
-      # `"https://api.example.com/v2/"`. Defaults to `ENV["BROWSERBASE_BASE_URL"]`
-      base_url: ENV["BROWSERBASE_BASE_URL"],
+      # `"https://api.example.com/v2/"`. Defaults to `ENV["STAGEHAND_BASE_URL"]`
+      base_url: ENV["STAGEHAND_BASE_URL"],
       # Max number of retries to attempt after a failed retryable request.
       max_retries: Stagehand::Client::DEFAULT_MAX_RETRIES,
       timeout: Stagehand::Client::DEFAULT_TIMEOUT_IN_SECONDS,

stagehand.gemspec

@@ -5,8 +5,8 @@ require_relative "lib/stagehand/version"
 Gem::Specification.new do |s|
   s.name = "stagehand"
   s.version = Stagehand::VERSION
-  s.summary = "Ruby library to access the Browserbase API"
-  s.authors = ["Browserbase"]
+  s.summary = "Ruby library to access the Stagehand API"
+  s.authors = ["Stagehand"]
   s.email = ""
   s.homepage = "https://gemdocs.org/gems/stagehand"
   s.metadata["homepage_uri"] = s.homepage

test/stagehand/client_test.rb

@@ -44,10 +44,10 @@ def test_raises_on_missing_non_nullable_opts
   def test_client_default_request_default_retry_attempts
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
     end
 
     assert_requested(:any, /./, times: 3)
@@ -56,10 +56,10 @@ def test_client_default_request_default_retry_attempts
   def test_client_given_request_default_retry_attempts
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 3)
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 3)
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
     end
 
     assert_requested(:any, /./, times: 4)
@@ -68,10 +68,10 @@ def test_client_given_request_default_retry_attempts
   def test_client_default_request_given_retry_attempts
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL, request_options: {max_retries: 3})
+      stagehand.sessions.start(env: :LOCAL, request_options: {max_retries: 3})
     end
 
     assert_requested(:any, /./, times: 4)
@@ -80,10 +80,10 @@ def test_client_default_request_given_retry_attempts
   def test_client_given_request_given_retry_attempts
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 3)
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 3)
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL, request_options: {max_retries: 4})
+      stagehand.sessions.start(env: :LOCAL, request_options: {max_retries: 4})
     end
 
     assert_requested(:any, /./, times: 5)
@@ -96,10 +96,10 @@ def test_client_retry_after_seconds
       body: {}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
     end
 
     assert_requested(:any, /./, times: 2)
@@ -113,11 +113,11 @@ def test_client_retry_after_date
       body: {}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
 
     assert_raises(Stagehand::Errors::InternalServerError) do
       Thread.current.thread_variable_set(:time_now, Time.now)
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
       Thread.current.thread_variable_set(:time_now, nil)
     end
 
@@ -132,10 +132,10 @@ def test_client_retry_after_ms
       body: {}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key", max_retries: 1)
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
     end
 
     assert_requested(:any, /./, times: 2)
@@ -145,10 +145,10 @@ def test_client_retry_after_ms
   def test_retry_count_header
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(env: :LOCAL)
+      stagehand.sessions.start(env: :LOCAL)
     end
 
     3.times do
@@ -159,10 +159,10 @@ def test_retry_count_header
   def test_omit_retry_count_header
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(
+      stagehand.sessions.start(
         env: :LOCAL,
         request_options: {extra_headers: {"x-stainless-retry-count" => nil}}
       )
@@ -176,10 +176,10 @@ def test_omit_retry_count_header
   def test_overwrite_retry_count_header
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 500, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::InternalServerError) do
-      browserbase.sessions.start(
+      stagehand.sessions.start(
         env: :LOCAL,
         request_options: {extra_headers: {"x-stainless-retry-count" => "42"}}
       )
@@ -199,10 +199,10 @@ def test_client_redirect_307
       headers: {"location" => "/redirected"}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::APIConnectionError) do
-      browserbase.sessions.start(env: :LOCAL, request_options: {extra_headers: {}})
+      stagehand.sessions.start(env: :LOCAL, request_options: {extra_headers: {}})
     end
 
     recorded, = WebMock::RequestRegistry.instance.requested_signatures.hash.first
@@ -228,10 +228,10 @@ def test_client_redirect_303
       headers: {"location" => "/redirected"}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::APIConnectionError) do
-      browserbase.sessions.start(env: :LOCAL, request_options: {extra_headers: {}})
+      stagehand.sessions.start(env: :LOCAL, request_options: {extra_headers: {}})
     end
 
     assert_requested(:get, "http://localhost/redirected", times: Stagehand::Client::MAX_REDIRECTS) do
@@ -252,10 +252,10 @@ def test_client_redirect_auth_keep_same_origin
       headers: {"location" => "/redirected"}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::APIConnectionError) do
-      browserbase.sessions.start(
+      stagehand.sessions.start(
         env: :LOCAL,
         request_options: {extra_headers: {"authorization" => "Bearer xyz"}}
       )
@@ -282,10 +282,10 @@ def test_client_redirect_auth_strip_cross_origin
       headers: {"location" => "https://example.com/redirected"}
     )
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
     assert_raises(Stagehand::Errors::APIConnectionError) do
-      browserbase.sessions.start(
+      stagehand.sessions.start(
         env: :LOCAL,
         request_options: {extra_headers: {"authorization" => "Bearer xyz"}}
       )
@@ -300,9 +300,9 @@ def test_client_redirect_auth_strip_cross_origin
   def test_default_headers
     stub_request(:post, "http://localhost/sessions/start").to_return_json(status: 200, body: {})
 
-    browserbase = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
+    stagehand = Stagehand::Client.new(base_url: "http://localhost", api_key: "My API Key")
 
-    browserbase.sessions.start(env: :LOCAL)
+    stagehand.sessions.start(env: :LOCAL)
 
     assert_requested(:any, /./) do |req|
       headers = req.headers.transform_keys(&:downcase).fetch_values("accept", "content-type")