feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-705638ac8966569986bd9ebb7c9761bf0016909e9f2753e77ceabb12c8049511.yml
-openapi_spec_hash: a8fbbcaa38e91c7f97313620b42d8d62
+configured_endpoints: 1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-516862e7e90968bc55ac44ce7ffe2d5c1f738c11757471c2b9e0e4cff9384f2c.yml
+openapi_spec_hash: 19bbe52a6ae0eec7fc3f6698e831ee55
 config_hash: a35b56eb05306a0f02e83c11d57f975f

README.md

@@ -34,9 +34,9 @@ stagehand = Stagehand::Client.new(
   model_api_key: ENV["MODEL_API_KEY"] # This is the default and can be omitted
 )
 
-response = stagehand.sessions.act("00000000-your-session-id-000000000000", input: "click the first link on the page")
+response = stagehand.sessions.start
 
-puts(response.actions)
+puts(response)
 ```
 
 ### Handling errors
@@ -45,10 +45,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(
-    browserbase_api_key: "your Browserbase API key",
-    browserbase_project_id: "your Browserbase Project ID"
-  )
+  session = stagehand.sessions.start
 rescue Stagehand::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -91,11 +88,7 @@ stagehand = Stagehand::Client.new(
 )
 
 # Or, configure per-request:
-stagehand.sessions.start(
-  browserbase_api_key: "your Browserbase API key",
-  browserbase_project_id: "your Browserbase Project ID",
-  request_options: {max_retries: 5}
-)
+stagehand.sessions.start(request_options: {max_retries: 5})
 ```
 
 ### Timeouts
@@ -109,11 +102,7 @@ stagehand = Stagehand::Client.new(
 )
 
 # Or, configure per-request:
-stagehand.sessions.start(
-  browserbase_api_key: "your Browserbase API key",
-  browserbase_project_id: "your Browserbase Project ID",
-  request_options: {timeout: 5}
-)
+stagehand.sessions.start(request_options: {timeout: 5})
 ```
 
 On timeout, `Stagehand::Errors::APITimeoutError` is raised.
@@ -145,8 +134,6 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 ```ruby
 response =
   stagehand.sessions.start(
-    browserbase_api_key: "your Browserbase API key",
-    browserbase_project_id: "your Browserbase Project ID",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -192,46 +179,18 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-stagehand.sessions.act("00000000-your-session-id-000000000000", input: "click the first link on the page")
+stagehand.sessions.start
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-stagehand.sessions.act("00000000-your-session-id-000000000000", input: "click the first link on the page")
+stagehand.sessions.start
 
 # You can also splat a full Params class:
-params = Stagehand::SessionActParams.new(input: "click the first link on the page")
-stagehand.sessions.act("00000000-your-session-id-000000000000", **params)
-```
-
-### Enums
-
-Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
-
-```ruby
-# :true
-puts(Stagehand::SessionActParams::XStreamResponse::TRUE)
-
-# Revealed type: `T.all(Stagehand::SessionActParams::XStreamResponse, Symbol)`
-T.reveal_type(Stagehand::SessionActParams::XStreamResponse::TRUE)
-```
-
-Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
-
-```ruby
-# Using the enum constants preserves the tagged type information:
-stagehand.sessions.act(
-  x_stream_response: Stagehand::SessionActParams::XStreamResponse::TRUE,
-  # …
-)
-
-# Literal values are also permissible:
-stagehand.sessions.act(
-  x_stream_response: :true,
-  # …
-)
+params = Stagehand::SessionStartParams.new
+stagehand.sessions.start(**params)
 ```
 
 ## Versioning

lib/stagehand.rb

@@ -54,18 +54,6 @@
 require_relative "stagehand/client"
 require_relative "stagehand/models/action"
 require_relative "stagehand/models/model_config"
-require_relative "stagehand/models/session_act_params"
-require_relative "stagehand/models/session_act_response"
-require_relative "stagehand/models/session_end_params"
-require_relative "stagehand/models/session_end_response"
-require_relative "stagehand/models/session_execute_agent_params"
-require_relative "stagehand/models/session_execute_agent_response"
-require_relative "stagehand/models/session_extract_params"
-require_relative "stagehand/models/session_extract_response"
-require_relative "stagehand/models/session_navigate_params"
-require_relative "stagehand/models/session_navigate_response"
-require_relative "stagehand/models/session_observe_params"
-require_relative "stagehand/models/session_observe_response"
 require_relative "stagehand/models/session_start_params"
 require_relative "stagehand/models/session_start_response"
 require_relative "stagehand/models"

lib/stagehand/internal/type/base_model.rb

@@ -440,9 +440,9 @@ def deep_to_h = self.class.recursively_to_h(@data, convert: false)
         # @example
         #   # `action` is a `Stagehand::Action`
         #   action => {
-        #     arguments: arguments,
         #     description: description,
-        #     method_: method_
+        #     selector: selector,
+        #     arguments: arguments
         #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)

lib/stagehand/internal/type/union.rb

@@ -6,14 +6,14 @@ module Type
       # @api private
       #
       # @example
-      #   # `session_extract_response` is a `Stagehand::Models::SessionExtractResponse`
-      #   case session_extract_response
-      #   when Stagehand::Models::SessionExtractResponse::Extraction
-      #     puts(session_extract_response.extraction)
-      #   when Stagehand::Models::SessionExtractResponse::CustomMap
+      #   # `model_config` is a `Stagehand::ModelConfig`
+      #   case model_config
+      #   when String
       #     # ...
+      #   when Stagehand::ModelConfig::UnionMember1
+      #     puts(model_config.model_name)
       #   else
-      #     puts(session_extract_response)
+      #     puts(model_config)
       #   end
       module Union
         include Stagehand::Internal::Type::Converter

lib/stagehand/models.rb

@@ -43,17 +43,5 @@ module Stagehand
 
   ModelConfig = Stagehand::Models::ModelConfig
 
-  SessionActParams = Stagehand::Models::SessionActParams
-
-  SessionEndParams = Stagehand::Models::SessionEndParams
-
-  SessionExecuteAgentParams = Stagehand::Models::SessionExecuteAgentParams
-
-  SessionExtractParams = Stagehand::Models::SessionExtractParams
-
-  SessionNavigateParams = Stagehand::Models::SessionNavigateParams
-
-  SessionObserveParams = Stagehand::Models::SessionObserveParams
-
   SessionStartParams = Stagehand::Models::SessionStartParams
 end

lib/stagehand/models/action.rb

@@ -3,46 +3,40 @@
 module Stagehand
   module Models
     class Action < Stagehand::Internal::Type::BaseModel
-      # @!attribute arguments
-      #   Arguments for the method
-      #
-      #   @return [Array<String>]
-      required :arguments, Stagehand::Internal::Type::ArrayOf[String]
-
       # @!attribute description
       #   Human-readable description of the action
       #
       #   @return [String]
       required :description, String
 
-      # @!attribute method_
-      #   Method to execute (e.g., "click", "fill")
-      #
-      #   @return [String]
-      required :method_, String, api_name: :method
-
       # @!attribute selector
-      #   CSS or XPath selector for the element
+      #   CSS selector or XPath for the element
       #
       #   @return [String]
       required :selector, String
 
-      # @!attribute backend_node_id
-      #   CDP backend node ID
+      # @!attribute arguments
+      #   Arguments to pass to the method
+      #
+      #   @return [Array<String>, nil]
+      optional :arguments, Stagehand::Internal::Type::ArrayOf[String]
+
+      # @!attribute method_
+      #   The method to execute (click, fill, etc.)
       #
-      #   @return [Integer, nil]
-      optional :backend_node_id, Integer, api_name: :backendNodeId
+      #   @return [String, nil]
+      optional :method_, String, api_name: :method
 
-      # @!method initialize(arguments:, description:, method_:, selector:, backend_node_id: nil)
-      #   @param arguments [Array<String>] Arguments for the method
+      # @!method initialize(description:, selector:, arguments: nil, method_: nil)
+      #   Action object returned by observe and used by act
       #
       #   @param description [String] Human-readable description of the action
       #
-      #   @param method_ [String] Method to execute (e.g., "click", "fill")
+      #   @param selector [String] CSS selector or XPath for the element
       #
-      #   @param selector [String] CSS or XPath selector for the element
+      #   @param arguments [Array<String>] Arguments to pass to the method
       #
-      #   @param backend_node_id [Integer] CDP backend node ID
+      #   @param method_ [String] The method to execute (click, fill, etc.)
     end
   end
 end

lib/stagehand/models/model_config.rb

@@ -2,50 +2,37 @@
 
 module Stagehand
   module Models
-    class ModelConfig < Stagehand::Internal::Type::BaseModel
-      # @!attribute api_key
-      #   API key for the model provider
-      #
-      #   @return [String, nil]
-      optional :api_key, String, api_name: :apiKey
-
-      # @!attribute base_url
-      #   Custom base URL for API
-      #
-      #   @return [String, nil]
-      optional :base_url, String, api_name: :baseURL
-
-      # @!attribute model
-      #   Model name
-      #
-      #   @return [String, nil]
-      optional :model, String
-
-      # @!attribute provider
-      #
-      #   @return [Symbol, Stagehand::Models::ModelConfig::Provider, nil]
-      optional :provider, enum: -> { Stagehand::ModelConfig::Provider }
-
-      # @!method initialize(api_key: nil, base_url: nil, model: nil, provider: nil)
-      #   @param api_key [String] API key for the model provider
-      #
-      #   @param base_url [String] Custom base URL for API
-      #
-      #   @param model [String] Model name
-      #
-      #   @param provider [Symbol, Stagehand::Models::ModelConfig::Provider]
-
-      # @see Stagehand::Models::ModelConfig#provider
-      module Provider
-        extend Stagehand::Internal::Type::Enum
-
-        OPENAI = :openai
-        ANTHROPIC = :anthropic
-        GOOGLE = :google
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
+    module ModelConfig
+      extend Stagehand::Internal::Type::Union
+
+      variant String
+
+      variant -> { Stagehand::ModelConfig::UnionMember1 }
+
+      class UnionMember1 < Stagehand::Internal::Type::BaseModel
+        # @!attribute model_name
+        #
+        #   @return [String]
+        required :model_name, String, api_name: :modelName
+
+        # @!attribute api_key
+        #
+        #   @return [String, nil]
+        optional :api_key, String, api_name: :apiKey
+
+        # @!attribute base_url
+        #
+        #   @return [String, nil]
+        optional :base_url, String, api_name: :baseURL
+
+        # @!method initialize(model_name:, api_key: nil, base_url: nil)
+        #   @param model_name [String]
+        #   @param api_key [String]
+        #   @param base_url [String]
       end
+
+      # @!method self.variants
+      #   @return [Array(String, Stagehand::Models::ModelConfig::UnionMember1)]
     end
   end
 end