feat(api): tweak branding and fix some config fields

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.STAGEHAND_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
-          GEM_HOST_API_KEY: ${{ secrets.STAGEHAND_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}
+          RUBYGEMS_HOST: ${{ secrets.BROWSERBASE_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
+          GEM_HOST_API_KEY: ${{ secrets.BROWSERBASE_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.STAGEHAND_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
-          GEM_HOST_API_KEY: ${{ secrets.STAGEHAND_GEM_HOST_API_KEY || secrets.GEM_HOST_API_KEY }}
+          RUBYGEMS_HOST: ${{ secrets.BROWSERBASE_RUBYGEMS_HOST || secrets.RUBYGEMS_HOST }}
+          GEM_HOST_API_KEY: ${{ secrets.BROWSERBASE_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: cb2b1795c195a63201c8ef7a617934d1
+config_hash: 1548ab91b7e8621f7fa79e8cff0c3f93

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Stagehand
+   Copyright 2025 Browserbase
 
    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,6 +1,6 @@
-# Stagehand Ruby API library
+# Browserbase Ruby API library
 
-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.
+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.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
@@ -28,12 +28,12 @@ gem "stagehand", "~> 0.0.1"
 require "bundler/setup"
 require "stagehand"
 
-stagehand = Stagehand::Client.new(
+browserbase = Stagehand::Client.new(
   api_key: ENV["STAGEHAND_API_KEY"], # This is the default and can be omitted
-  environment: "environment_1" # defaults to "production"
+  environment: "dev" # or "production" | "local"; defaults to "production"
 )
 
-response = stagehand.sessions.start(env: "LOCAL")
+response = browserbase.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 = stagehand.sessions.start(env: "LOCAL")
+  session = browserbase.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:
-stagehand = Stagehand::Client.new(
+browserbase = Stagehand::Client.new(
   max_retries: 0 # default is 2
 )
 
 # Or, configure per-request:
-stagehand.sessions.start(env: "LOCAL", request_options: {max_retries: 5})
+browserbase.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:
-stagehand = Stagehand::Client.new(
+browserbase = Stagehand::Client.new(
   timeout: nil # default is 60
 )
 
 # Or, configure per-request:
-stagehand.sessions.start(env: "LOCAL", request_options: {timeout: 5})
+browserbase.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 =
-  stagehand.sessions.start(
+  browserbase.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
-stagehand.sessions.start(env: "LOCAL")
+browserbase.sessions.start(env: "LOCAL")
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-stagehand.sessions.start(env: "LOCAL")
+browserbase.sessions.start(env: "LOCAL")
 
 # You can also splat a full Params class:
 params = Stagehand::SessionStartParams.new(env: "LOCAL")
-stagehand.sessions.start(**params)
+browserbase.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:
-stagehand.sessions.act(
+browserbase.sessions.act(
   x_stream_response: Stagehand::SessionActParams::XStreamResponse::TRUE,
   # …
 )
 
 # Literal values are also permissible:
-stagehand.sessions.act(
+browserbase.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 Stagehand, please follow the respective company's security reporting guidelines.
+or products provided by Browserbase, please follow the respective company's security reporting guidelines.
 
 ---
 

lib/stagehand/client.rb

@@ -18,10 +18,14 @@ class Client < Stagehand::Internal::Transport::BaseClient
     # rubocop:disable Style/MutableConstant
     # @type [Hash{Symbol=>String}]
     ENVIRONMENTS =
-      {production: "http://localhost:3000/v1", environment_1: "https://api.stagehand.browserbase.com/v1"}
+      {
+        production: "https://api.stagehand.browserbase.com/v1",
+        dev: "https://api.stagehand.dev.browserbase.com/v1",
+        local: "http://localhost:5000/v1"
+      }
     # rubocop:enable Style/MutableConstant
 
-    # @return [String, nil]
+    # @return [String]
     attr_reader :api_key
 
     # @return [Stagehand::Resources::Sessions]
@@ -40,15 +44,16 @@ class Client < Stagehand::Internal::Transport::BaseClient
     #
     # @param api_key [String, nil] Defaults to `ENV["STAGEHAND_API_KEY"]`
     #
-    # @param environment [:production, :environment_1, nil] Specifies the environment to use for the API.
+    # @param environment [:production, :dev, :local, nil] Specifies the environment to use for the API.
     #
     # Each environment maps to a different base URL:
     #
-    # - `production` corresponds to `http://localhost:3000/v1`
-    # - `environment_1` corresponds to `https://api.stagehand.browserbase.com/v1`
+    # - `production` corresponds to `https://api.stagehand.browserbase.com/v1`
+    # - `dev` corresponds to `https://api.stagehand.dev.browserbase.com/v1`
+    # - `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["STAGEHAND_BASE_URL"]`
+    # `"https://api.example.com/v2/"`. Defaults to `ENV["BROWSERBASE_BASE_URL"]`
     #
     # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
     #
@@ -60,7 +65,7 @@ class Client < Stagehand::Internal::Transport::BaseClient
     def initialize(
       api_key: ENV["STAGEHAND_API_KEY"],
       environment: nil,
-      base_url: ENV["STAGEHAND_BASE_URL"],
+      base_url: ENV["BROWSERBASE_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,
@@ -71,7 +76,11 @@ def initialize(
         raise ArgumentError.new(message)
       end
 
-      @api_key = api_key&.to_s
+      if api_key.nil?
+        raise ArgumentError.new("api_key is required, and can be set via environ: \"STAGEHAND_API_KEY\"")
+      end
+
+      @api_key = api_key.to_s
 
       super(
         base_url: base_url,

rbi/stagehand/client.rbi

@@ -13,13 +13,14 @@ module Stagehand
     ENVIRONMENTS =
       T.let(
         {
-          production: "http://localhost:3000/v1",
-          environment_1: "https://api.stagehand.browserbase.com/v1"
+          production: "https://api.stagehand.browserbase.com/v1",
+          dev: "https://api.stagehand.dev.browserbase.com/v1",
+          local: "http://localhost:5000/v1"
         },
         T::Hash[Symbol, String]
       )
 
-    sig { returns(T.nilable(String)) }
+    sig { returns(String) }
     attr_reader :api_key
 
     sig { returns(Stagehand::Resources::Sessions) }
@@ -49,12 +50,13 @@ module Stagehand
       #
       # Each environment maps to a different base URL:
       #
-      # - `production` corresponds to `http://localhost:3000/v1`
-      # - `environment_1` corresponds to `https://api.stagehand.browserbase.com/v1`
+      # - `production` corresponds to `https://api.stagehand.browserbase.com/v1`
+      # - `dev` corresponds to `https://api.stagehand.dev.browserbase.com/v1`
+      # - `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["STAGEHAND_BASE_URL"]`
-      base_url: ENV["STAGEHAND_BASE_URL"],
+      # `"https://api.example.com/v2/"`. Defaults to `ENV["BROWSERBASE_BASE_URL"]`
+      base_url: ENV["BROWSERBASE_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,

sig/stagehand/client.rbs

@@ -9,19 +9,20 @@ module Stagehand
     DEFAULT_MAX_RETRY_DELAY: Float
 
     ENVIRONMENTS: {
-      production: "http://localhost:3000/v1",
-      :environment_1 => "https://api.stagehand.browserbase.com/v1"
+      production: "https://api.stagehand.browserbase.com/v1",
+      dev: "https://api.stagehand.dev.browserbase.com/v1",
+      local: "http://localhost:5000/v1"
     }
 
-    attr_reader api_key: String?
+    attr_reader api_key: String
 
     attr_reader sessions: Stagehand::Resources::Sessions
 
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (
       ?api_key: String?,
-      ?environment: :production | :environment_1 | nil,
+      ?environment: :production | :dev | :local | nil,
       ?base_url: String?,
       ?max_retries: Integer,
       ?timeout: Float,

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 Stagehand API"
-  s.authors = ["Stagehand"]
+  s.summary = "Ruby library to access the Browserbase API"
+  s.authors = ["Browserbase"]
   s.email = ""
   s.homepage = "https://gemdocs.org/gems/stagehand"
   s.metadata["homepage_uri"] = s.homepage