Skip to content

Commit 3162ca0

Browse files
feat(api): manual updates
1 parent a972ef7 commit 3162ca0

23 files changed

Lines changed: 231 additions & 100 deletions

.stats.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 7
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-d571232203ef4e00986a3245224267db6f8aaffdad57780f712e0694dc8d9e37.yml
3-
openapi_spec_hash: d5d635dd7b24a2e1255c6f2a895253ff
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-817d1d4e845b1946dac8ee10fd34b3f533aa36f74ac598582ffb1b0399a5a932.yml
3+
openapi_spec_hash: 9d856db62b34909fec94743235b3d7be
44
config_hash: 88e87ba7021be93d267ecfc8f5e6b891

lib/stagehand/internal/type/union.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ module Type
1010
# case model_config
1111
# when String
1212
# # ...
13-
# when Stagehand::ModelConfig::UnionMember1
13+
# when Stagehand::ModelConfig::ModelConfigObject
1414
# puts(model_config.model_name)
1515
# else
1616
# puts(model_config)

lib/stagehand/models/model_config.rb

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,37 +2,45 @@
22

33
module Stagehand
44
module Models
5+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
6+
# 'anthropic/claude-4.5-opus')
57
module ModelConfig
68
extend Stagehand::Internal::Type::Union
79

10+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus')
811
variant String
912

10-
variant -> { Stagehand::ModelConfig::UnionMember1 }
13+
variant -> { Stagehand::ModelConfig::ModelConfigObject }
1114

12-
class UnionMember1 < Stagehand::Internal::Type::BaseModel
15+
class ModelConfigObject < Stagehand::Internal::Type::BaseModel
1316
# @!attribute model_name
17+
# Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus')
1418
#
1519
# @return [String]
1620
required :model_name, String, api_name: :modelName
1721

1822
# @!attribute api_key
23+
# API key for the model provider
1924
#
2025
# @return [String, nil]
2126
optional :api_key, String, api_name: :apiKey
2227

2328
# @!attribute base_url
29+
# Base URL for the model provider
2430
#
2531
# @return [String, nil]
2632
optional :base_url, String, api_name: :baseURL
2733

2834
# @!method initialize(model_name:, api_key: nil, base_url: nil)
29-
# @param model_name [String]
30-
# @param api_key [String]
31-
# @param base_url [String]
35+
# @param model_name [String] Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus')
36+
#
37+
# @param api_key [String] API key for the model provider
38+
#
39+
# @param base_url [String] Base URL for the model provider
3240
end
3341

3442
# @!method self.variants
35-
# @return [Array(String, Stagehand::Models::ModelConfig::UnionMember1)]
43+
# @return [Array(String, Stagehand::Models::ModelConfig::ModelConfigObject)]
3644
end
3745
end
3846
end

lib/stagehand/models/session_act_params.rb

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -117,8 +117,10 @@ class ActionInput < Stagehand::Internal::Type::BaseModel
117117

118118
class Options < Stagehand::Internal::Type::BaseModel
119119
# @!attribute model
120+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
121+
# 'anthropic/claude-4.5-opus')
120122
#
121-
# @return [String, Stagehand::Models::ModelConfig::UnionMember1, nil]
123+
# @return [String, Stagehand::Models::ModelConfig::ModelConfigObject, nil]
122124
optional :model, union: -> { Stagehand::ModelConfig }
123125

124126
# @!attribute timeout
@@ -134,7 +136,10 @@ class Options < Stagehand::Internal::Type::BaseModel
134136
optional :variables, Stagehand::Internal::Type::HashOf[String]
135137

136138
# @!method initialize(model: nil, timeout: nil, variables: nil)
137-
# @param model [String, Stagehand::Models::ModelConfig::UnionMember1]
139+
# Some parameter documentations has been truncated, see
140+
# {Stagehand::Models::SessionActParams::Options} for more details.
141+
#
142+
# @param model [String, Stagehand::Models::ModelConfig::ModelConfigObject] Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/cl
138143
#
139144
# @param timeout [Float] Timeout in ms for the action
140145
#

lib/stagehand/models/session_end_response.rb

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,13 @@ module Models
55
# @see Stagehand::Resources::Sessions#end_
66
class SessionEndResponse < Stagehand::Internal::Type::BaseModel
77
# @!attribute success
8+
# Indicates whether the request was successful
89
#
9-
# @return [Boolean, true]
10-
required :success, const: true
10+
# @return [Boolean]
11+
required :success, Stagehand::Internal::Type::Boolean
1112

12-
# @!method initialize(success: true)
13-
# @param success [Boolean, true]
13+
# @!method initialize(success:)
14+
# @param success [Boolean] Indicates whether the request was successful
1415
end
1516
end
1617
end

lib/stagehand/models/session_execute_params.rb

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,10 @@ class AgentConfig < Stagehand::Internal::Type::BaseModel
7474
optional :cua, Stagehand::Internal::Type::Boolean
7575

7676
# @!attribute model
77+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
78+
# 'anthropic/claude-4.5-opus')
7779
#
78-
# @return [String, Stagehand::Models::ModelConfig::UnionMember1, nil]
80+
# @return [String, Stagehand::Models::ModelConfig::ModelConfigObject, nil]
7981
optional :model, union: -> { Stagehand::ModelConfig }
8082

8183
# @!attribute system_prompt
@@ -85,9 +87,12 @@ class AgentConfig < Stagehand::Internal::Type::BaseModel
8587
optional :system_prompt, String, api_name: :systemPrompt
8688

8789
# @!method initialize(cua: nil, model: nil, system_prompt: nil)
90+
# Some parameter documentations has been truncated, see
91+
# {Stagehand::Models::SessionExecuteParams::AgentConfig} for more details.
92+
#
8893
# @param cua [Boolean] Enable Computer Use Agent mode
8994
#
90-
# @param model [String, Stagehand::Models::ModelConfig::UnionMember1]
95+
# @param model [String, Stagehand::Models::ModelConfig::ModelConfigObject] Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/cl
9196
#
9297
# @param system_prompt [String] Custom system prompt for the agent
9398
end

lib/stagehand/models/session_extract_params.rb

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,10 @@ class SessionExtractParams < Stagehand::Internal::Type::BaseModel
7575

7676
class Options < Stagehand::Internal::Type::BaseModel
7777
# @!attribute model
78+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
79+
# 'anthropic/claude-4.5-opus')
7880
#
79-
# @return [String, Stagehand::Models::ModelConfig::UnionMember1, nil]
81+
# @return [String, Stagehand::Models::ModelConfig::ModelConfigObject, nil]
8082
optional :model, union: -> { Stagehand::ModelConfig }
8183

8284
# @!attribute selector
@@ -92,7 +94,10 @@ class Options < Stagehand::Internal::Type::BaseModel
9294
optional :timeout, Float
9395

9496
# @!method initialize(model: nil, selector: nil, timeout: nil)
95-
# @param model [String, Stagehand::Models::ModelConfig::UnionMember1]
97+
# Some parameter documentations has been truncated, see
98+
# {Stagehand::Models::SessionExtractParams::Options} for more details.
99+
#
100+
# @param model [String, Stagehand::Models::ModelConfig::ModelConfigObject] Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/cl
96101
#
97102
# @param selector [String] CSS selector to scope extraction to a specific element
98103
#

lib/stagehand/models/session_observe_params.rb

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,10 @@ class SessionObserveParams < Stagehand::Internal::Type::BaseModel
6767

6868
class Options < Stagehand::Internal::Type::BaseModel
6969
# @!attribute model
70+
# Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
71+
# 'anthropic/claude-4.5-opus')
7072
#
71-
# @return [String, Stagehand::Models::ModelConfig::UnionMember1, nil]
73+
# @return [String, Stagehand::Models::ModelConfig::ModelConfigObject, nil]
7274
optional :model, union: -> { Stagehand::ModelConfig }
7375

7476
# @!attribute selector
@@ -84,7 +86,10 @@ class Options < Stagehand::Internal::Type::BaseModel
8486
optional :timeout, Float
8587

8688
# @!method initialize(model: nil, selector: nil, timeout: nil)
87-
# @param model [String, Stagehand::Models::ModelConfig::UnionMember1]
89+
# Some parameter documentations has been truncated, see
90+
# {Stagehand::Models::SessionObserveParams::Options} for more details.
91+
#
92+
# @param model [String, Stagehand::Models::ModelConfig::ModelConfigObject] Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/cl
8893
#
8994
# @param selector [String] CSS selector to scope observation to a specific element
9095
#

lib/stagehand/models/session_start_params.rb

Lines changed: 31 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,8 @@ class SessionStartParams < Stagehand::Internal::Type::BaseModel
6868
# @!attribute verbose
6969
# Logging verbosity level (0=quiet, 1=normal, 2=debug)
7070
#
71-
# @return [Integer, nil]
72-
optional :verbose, Integer
71+
# @return [Integer, Stagehand::Models::SessionStartParams::Verbose, nil]
72+
optional :verbose, enum: -> { Stagehand::SessionStartParams::Verbose }
7373

7474
# @!attribute wait_for_captcha_solves
7575
#
@@ -121,7 +121,7 @@ class SessionStartParams < Stagehand::Internal::Type::BaseModel
121121
#
122122
# @param system_prompt [String] Custom system prompt for AI operations
123123
#
124-
# @param verbose [Integer] Logging verbosity level (0=quiet, 1=normal, 2=debug)
124+
# @param verbose [Integer, Stagehand::Models::SessionStartParams::Verbose] Logging verbosity level (0=quiet, 1=normal, 2=debug)
125125
#
126126
# @param wait_for_captcha_solves [Boolean]
127127
#
@@ -377,7 +377,7 @@ class BrowserbaseSessionCreateParams < Stagehand::Internal::Type::BaseModel
377377

378378
# @!attribute proxies
379379
#
380-
# @return [Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::ExternalProxyConfig>, nil]
380+
# @return [Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::External>, nil]
381381
optional :proxies, union: -> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies }
382382

383383
# @!attribute region
@@ -402,7 +402,7 @@ class BrowserbaseSessionCreateParams < Stagehand::Internal::Type::BaseModel
402402
# @param extension_id [String]
403403
# @param keep_alive [Boolean]
404404
# @param project_id [String]
405-
# @param proxies [Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::ExternalProxyConfig>]
405+
# @param proxies [Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::External>]
406406
# @param region [Symbol, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Region]
407407
# @param timeout [Float]
408408
# @param user_metadata [Hash{Symbol=>Object}]
@@ -643,11 +643,15 @@ module Proxies
643643
module UnionMember1
644644
extend Stagehand::Internal::Type::Union
645645

646-
variant -> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig }
646+
discriminator :type
647647

648-
variant -> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::ExternalProxyConfig }
648+
variant :browserbase,
649+
-> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase }
649650

650-
class BrowserbaseProxyConfig < Stagehand::Internal::Type::BaseModel
651+
variant :external,
652+
-> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::External }
653+
654+
class Browserbase < Stagehand::Internal::Type::BaseModel
651655
# @!attribute type
652656
#
653657
# @return [Symbol, :browserbase]
@@ -660,16 +664,16 @@ class BrowserbaseProxyConfig < Stagehand::Internal::Type::BaseModel
660664

661665
# @!attribute geolocation
662666
#
663-
# @return [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig::Geolocation, nil]
667+
# @return [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase::Geolocation, nil]
664668
optional :geolocation,
665-
-> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig::Geolocation }
669+
-> { Stagehand::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase::Geolocation }
666670

667671
# @!method initialize(domain_pattern: nil, geolocation: nil, type: :browserbase)
668672
# @param domain_pattern [String]
669-
# @param geolocation [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig::Geolocation]
673+
# @param geolocation [Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase::Geolocation]
670674
# @param type [Symbol, :browserbase]
671675

672-
# @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig#geolocation
676+
# @see Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase#geolocation
673677
class Geolocation < Stagehand::Internal::Type::BaseModel
674678
# @!attribute country
675679
#
@@ -693,7 +697,7 @@ class Geolocation < Stagehand::Internal::Type::BaseModel
693697
end
694698
end
695699

696-
class ExternalProxyConfig < Stagehand::Internal::Type::BaseModel
700+
class External < Stagehand::Internal::Type::BaseModel
697701
# @!attribute server
698702
#
699703
# @return [String]
@@ -728,11 +732,11 @@ class ExternalProxyConfig < Stagehand::Internal::Type::BaseModel
728732
end
729733

730734
# @!method self.variants
731-
# @return [Array(Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::ExternalProxyConfig)]
735+
# @return [Array(Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::External)]
732736
end
733737

734738
# @!method self.variants
735-
# @return [Array(Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::BrowserbaseProxyConfig, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::ExternalProxyConfig>)]
739+
# @return [Array(Boolean, Array<Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::Browserbase, Stagehand::Models::SessionStartParams::BrowserbaseSessionCreateParams::Proxies::UnionMember1::External>)]
736740

737741
# @type [Stagehand::Internal::Type::Converter]
738742
UnionMember1Array =
@@ -755,6 +759,18 @@ module Region
755759
end
756760
end
757761

762+
# Logging verbosity level (0=quiet, 1=normal, 2=debug)
763+
module Verbose
764+
extend Stagehand::Internal::Type::Enum
765+
766+
VERBOSE_0 = 0
767+
VERBOSE_1 = 1
768+
VERBOSE_2 = 2
769+
770+
# @!method self.values
771+
# @return [Array<Integer>]
772+
end
773+
758774
# Client SDK language
759775
module XLanguage
760776
extend Stagehand::Internal::Type::Enum

lib/stagehand/resources/sessions.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -287,7 +287,7 @@ def observe(id, params = {})
287287
#
288288
# @param system_prompt [String] Body param: Custom system prompt for AI operations
289289
#
290-
# @param verbose [Integer] Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
290+
# @param verbose [Integer, Stagehand::Models::SessionStartParams::Verbose] Body param: Logging verbosity level (0=quiet, 1=normal, 2=debug)
291291
#
292292
# @param wait_for_captcha_solves [Boolean] Body param:
293293
#

0 commit comments

Comments
 (0)