stagehand 0.0.4 → 3.5.2

data/sig/stagehand/models/session_start_response.rbs

@@ -0,0 +1,44 @@
+module Stagehand
+  module Models
+    type session_start_response =
+      { data: Stagehand::Models::SessionStartResponse::Data, success: bool }
+
+    class SessionStartResponse < Stagehand::Internal::Type::BaseModel
+      attr_accessor data: Stagehand::Models::SessionStartResponse::Data
+
+      attr_accessor success: bool
+
+      def initialize: (
+        data: Stagehand::Models::SessionStartResponse::Data,
+        success: bool
+      ) -> void
+
+      def to_hash: -> {
+        data: Stagehand::Models::SessionStartResponse::Data,
+        success: bool
+      }
+
+      type data = { available: bool, session_id: String, cdp_url: String? }
+
+      class Data < Stagehand::Internal::Type::BaseModel
+        attr_accessor available: bool
+
+        attr_accessor session_id: String
+
+        attr_accessor cdp_url: String?
+
+        def initialize: (
+          available: bool,
+          session_id: String,
+          ?cdp_url: String?
+        ) -> void
+
+        def to_hash: -> {
+          available: bool,
+          session_id: String,
+          cdp_url: String?
+        }
+      end
+    end
+  end
+end

data/sig/stagehand/models/stream_event.rbs

@@ -0,0 +1,109 @@
+module Stagehand
+  module Models
+    type stream_event =
+      {
+        id: String,
+        data: Stagehand::Models::StreamEvent::data,
+        type: Stagehand::Models::StreamEvent::type_
+      }
+
+    class StreamEvent < Stagehand::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor data: Stagehand::Models::StreamEvent::data
+
+      attr_accessor type: Stagehand::Models::StreamEvent::type_
+
+      def initialize: (
+        id: String,
+        data: Stagehand::Models::StreamEvent::data,
+        type: Stagehand::Models::StreamEvent::type_
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        data: Stagehand::Models::StreamEvent::data,
+        type: Stagehand::Models::StreamEvent::type_
+      }
+
+      type data =
+        Stagehand::StreamEvent::Data::StreamEventSystemDataOutput
+        | Stagehand::StreamEvent::Data::StreamEventLogDataOutput
+
+      module Data
+        extend Stagehand::Internal::Type::Union
+
+        type stream_event_system_data_output =
+          {
+            status: Stagehand::Models::StreamEvent::Data::StreamEventSystemDataOutput::status,
+            error: String,
+            result: top
+          }
+
+        class StreamEventSystemDataOutput < Stagehand::Internal::Type::BaseModel
+          attr_accessor status: Stagehand::Models::StreamEvent::Data::StreamEventSystemDataOutput::status
+
+          attr_reader error: String?
+
+          def error=: (String) -> String
+
+          attr_reader result: top?
+
+          def result=: (top) -> top
+
+          def initialize: (
+            status: Stagehand::Models::StreamEvent::Data::StreamEventSystemDataOutput::status,
+            ?error: String,
+            ?result: top
+          ) -> void
+
+          def to_hash: -> {
+            status: Stagehand::Models::StreamEvent::Data::StreamEventSystemDataOutput::status,
+            error: String,
+            result: top
+          }
+
+          type status = :starting | :connected | :running | :finished | :error
+
+          module Status
+            extend Stagehand::Internal::Type::Enum
+
+            STARTING: :starting
+            CONNECTED: :connected
+            RUNNING: :running
+            FINISHED: :finished
+            ERROR: :error
+
+            def self?.values: -> ::Array[Stagehand::Models::StreamEvent::Data::StreamEventSystemDataOutput::status]
+          end
+        end
+
+        type stream_event_log_data_output =
+          { message: String, status: :running }
+
+        class StreamEventLogDataOutput < Stagehand::Internal::Type::BaseModel
+          attr_accessor message: String
+
+          attr_accessor status: :running
+
+          def initialize: (message: String, ?status: :running) -> void
+
+          def to_hash: -> { message: String, status: :running }
+        end
+
+        def self?.variants: -> ::Array[Stagehand::Models::StreamEvent::data]
+      end
+
+      type type_ = :system | :log
+
+      module Type
+        extend Stagehand::Internal::Type::Enum
+
+        SYSTEM: :system
+        LOG: :log
+
+        def self?.values: -> ::Array[Stagehand::Models::StreamEvent::type_]
+      end
+    end
+  end
+end

data/sig/stagehand/models.rbs

@@ -0,0 +1,23 @@
+module Stagehand
+  class Action = Stagehand::Models::Action
+
+  class ModelConfig = Stagehand::Models::ModelConfig
+
+  class SessionActParams = Stagehand::Models::SessionActParams
+
+  class SessionEndParams = Stagehand::Models::SessionEndParams
+
+  class SessionExecuteParams = Stagehand::Models::SessionExecuteParams
+
+  class SessionExtractParams = Stagehand::Models::SessionExtractParams
+
+  class SessionNavigateParams = Stagehand::Models::SessionNavigateParams
+
+  class SessionObserveParams = Stagehand::Models::SessionObserveParams
+
+  class SessionReplayParams = Stagehand::Models::SessionReplayParams
+
+  class SessionStartParams = Stagehand::Models::SessionStartParams
+
+  class StreamEvent = Stagehand::Models::StreamEvent
+end

data/sig/stagehand/request_options.rbs

@@ -0,0 +1,34 @@
+module Stagehand
+  type request_opts =
+    Stagehand::RequestOptions | Stagehand::request_options | ::Hash[Symbol, top]
+
+  type request_options =
+    {
+      idempotency_key: String?,
+      extra_query: ::Hash[String, (::Array[String] | String)?]?,
+      extra_headers: ::Hash[String, String?]?,
+      extra_body: top?,
+      max_retries: Integer?,
+      timeout: Float?
+    }
+
+  class RequestOptions < Stagehand::Internal::Type::BaseModel
+    def self.validate!: (Stagehand::request_opts opts) -> void
+
+    attr_accessor idempotency_key: String?
+
+    attr_accessor extra_query: ::Hash[String, (::Array[String] | String)?]?
+
+    attr_accessor extra_headers: ::Hash[String, String?]?
+
+    attr_accessor extra_body: top?
+
+    attr_accessor max_retries: Integer?
+
+    attr_accessor timeout: Float?
+
+    def initialize: (
+      ?Stagehand::request_options | ::Hash[Symbol, top] values
+    ) -> void
+  end
+end

data/sig/stagehand/resources/sessions.rbs

@@ -0,0 +1,121 @@
+module Stagehand
+  module Resources
+    class Sessions
+      def act: (
+        String id,
+        input: Stagehand::Models::SessionActParams::input,
+        ?frame_id: String?,
+        ?options: Stagehand::SessionActParams::Options,
+        ?x_stream_response: Stagehand::Models::SessionActParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionActResponse
+
+      def act_streaming: (
+        String id,
+        input: Stagehand::Models::SessionActParams::input,
+        ?frame_id: String?,
+        ?options: Stagehand::SessionActParams::Options,
+        ?x_stream_response: Stagehand::Models::SessionActParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Internal::Stream[Stagehand::StreamEvent]
+
+      def end_: (
+        String id,
+        ?x_stream_response: Stagehand::Models::SessionEndParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionEndResponse
+
+      def execute: (
+        String id,
+        agent_config: Stagehand::SessionExecuteParams::AgentConfig,
+        execute_options: Stagehand::SessionExecuteParams::ExecuteOptions,
+        ?frame_id: String?,
+        ?should_cache: bool,
+        ?x_stream_response: Stagehand::Models::SessionExecuteParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionExecuteResponse
+
+      def execute_streaming: (
+        String id,
+        agent_config: Stagehand::SessionExecuteParams::AgentConfig,
+        execute_options: Stagehand::SessionExecuteParams::ExecuteOptions,
+        ?frame_id: String?,
+        ?should_cache: bool,
+        ?x_stream_response: Stagehand::Models::SessionExecuteParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Internal::Stream[Stagehand::StreamEvent]
+
+      def extract: (
+        String id,
+        ?frame_id: String?,
+        ?instruction: String,
+        ?options: Stagehand::SessionExtractParams::Options,
+        ?schema: ::Hash[Symbol, top],
+        ?x_stream_response: Stagehand::Models::SessionExtractParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionExtractResponse
+
+      def extract_streaming: (
+        String id,
+        ?frame_id: String?,
+        ?instruction: String,
+        ?options: Stagehand::SessionExtractParams::Options,
+        ?schema: ::Hash[Symbol, top],
+        ?x_stream_response: Stagehand::Models::SessionExtractParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Internal::Stream[Stagehand::StreamEvent]
+
+      def navigate: (
+        String id,
+        url: String,
+        ?frame_id: String?,
+        ?options: Stagehand::SessionNavigateParams::Options,
+        ?stream_response: bool,
+        ?x_stream_response: Stagehand::Models::SessionNavigateParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionNavigateResponse
+
+      def observe: (
+        String id,
+        ?frame_id: String?,
+        ?instruction: String,
+        ?options: Stagehand::SessionObserveParams::Options,
+        ?x_stream_response: Stagehand::Models::SessionObserveParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionObserveResponse
+
+      def observe_streaming: (
+        String id,
+        ?frame_id: String?,
+        ?instruction: String,
+        ?options: Stagehand::SessionObserveParams::Options,
+        ?x_stream_response: Stagehand::Models::SessionObserveParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Internal::Stream[Stagehand::StreamEvent]
+
+      def replay: (
+        String id,
+        ?x_stream_response: Stagehand::Models::SessionReplayParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionReplayResponse
+
+      def start: (
+        model_name: String,
+        ?act_timeout_ms: Float,
+        ?browser: Stagehand::SessionStartParams::Browser,
+        ?browserbase_session_create_params: Stagehand::SessionStartParams::BrowserbaseSessionCreateParams,
+        ?browserbase_session_id: String,
+        ?dom_settle_timeout_ms: Float,
+        ?experimental: bool,
+        ?self_heal: bool,
+        ?system_prompt: String,
+        ?verbose: Stagehand::Models::SessionStartParams::verbose,
+        ?wait_for_captcha_solves: bool,
+        ?x_stream_response: Stagehand::Models::SessionStartParams::x_stream_response,
+        ?request_options: Stagehand::request_opts
+      ) -> Stagehand::Models::SessionStartResponse
+
+      def initialize: (client: Stagehand::Client) -> void
+    end
+  end
+end

data/sig/stagehand/version.rbs

@@ -0,0 +1,3 @@
+module Stagehand
+  VERSION: String
+end

metadata

@@ -1,93 +1,209 @@
 --- !ruby/object:Gem::Specification
 name: stagehand
 version: !ruby/object:Gem::Version
-  version: 0.0.4
-  prerelease: 
+  version: 3.5.2
 platform: ruby
 authors:
-- Reed Law
-autorequire: 
+- Stagehand
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2011-10-25 00:00:00.000000000Z
+date: 2026-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &88349500 !ruby/object:Gem::Requirement
-    none: false
+  name: cgi
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.0
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
-  version_requirements: *88349500
-- !ruby/object:Gem::Dependency
-  name: yajl-ruby
-  requirement: &88349180 !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: *88349180
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: httparty
-  requirement: &88348780 !ruby/object:Gem::Requirement
-    none: false
+  name: connection_pool
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *88348780
-description: Client-side library for manipulating RESTful resources provided by Personas,
-  a Rails + Backbone user managment service
-email:
-- reed@smashingboxes.com.com
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email: ''
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
-- .gitignore
-- Gemfile
+- ".ignore"
+- CHANGELOG.md
 - README.md
-- Rakefile
+- SECURITY.md
 - lib/stagehand.rb
 - lib/stagehand/client.rb
-- lib/stagehand/client/oauth.rb
-- lib/stagehand/client/user.rb
-- lib/stagehand/rack/middleware.rb
-- lib/stagehand/railtie.rb
+- lib/stagehand/errors.rb
+- lib/stagehand/file_part.rb
+- lib/stagehand/internal.rb
+- lib/stagehand/internal/stream.rb
+- lib/stagehand/internal/transport/base_client.rb
+- lib/stagehand/internal/transport/pooled_net_requester.rb
+- lib/stagehand/internal/type/array_of.rb
+- lib/stagehand/internal/type/base_model.rb
+- lib/stagehand/internal/type/base_page.rb
+- lib/stagehand/internal/type/base_stream.rb
+- lib/stagehand/internal/type/boolean.rb
+- lib/stagehand/internal/type/converter.rb
+- lib/stagehand/internal/type/enum.rb
+- lib/stagehand/internal/type/file_input.rb
+- lib/stagehand/internal/type/hash_of.rb
+- lib/stagehand/internal/type/request_parameters.rb
+- lib/stagehand/internal/type/union.rb
+- lib/stagehand/internal/type/unknown.rb
+- lib/stagehand/internal/util.rb
+- lib/stagehand/local.rb
+- lib/stagehand/models.rb
+- lib/stagehand/models/action.rb
+- lib/stagehand/models/model_config.rb
+- lib/stagehand/models/session_act_params.rb
+- lib/stagehand/models/session_act_response.rb
+- lib/stagehand/models/session_end_params.rb
+- lib/stagehand/models/session_end_response.rb
+- lib/stagehand/models/session_execute_params.rb
+- lib/stagehand/models/session_execute_response.rb
+- lib/stagehand/models/session_extract_params.rb
+- lib/stagehand/models/session_extract_response.rb
+- lib/stagehand/models/session_navigate_params.rb
+- lib/stagehand/models/session_navigate_response.rb
+- lib/stagehand/models/session_observe_params.rb
+- lib/stagehand/models/session_observe_response.rb
+- lib/stagehand/models/session_replay_params.rb
+- lib/stagehand/models/session_replay_response.rb
+- lib/stagehand/models/session_start_params.rb
+- lib/stagehand/models/session_start_response.rb
+- lib/stagehand/models/stream_event.rb
+- lib/stagehand/request_options.rb
+- lib/stagehand/resources/sessions.rb
 - lib/stagehand/version.rb
-- spec/spec_helper.rb
-- spec/stagehand_spec.rb
-- stagehand.gemspec
-homepage: https://github.com/smashingboxes/stagehand
+- manifest.yaml
+- rbi/stagehand/client.rbi
+- rbi/stagehand/errors.rbi
+- rbi/stagehand/file_part.rbi
+- rbi/stagehand/internal.rbi
+- rbi/stagehand/internal/stream.rbi
+- rbi/stagehand/internal/transport/base_client.rbi
+- rbi/stagehand/internal/transport/pooled_net_requester.rbi
+- rbi/stagehand/internal/type/array_of.rbi
+- rbi/stagehand/internal/type/base_model.rbi
+- rbi/stagehand/internal/type/base_page.rbi
+- rbi/stagehand/internal/type/base_stream.rbi
+- rbi/stagehand/internal/type/boolean.rbi
+- rbi/stagehand/internal/type/converter.rbi
+- rbi/stagehand/internal/type/enum.rbi
+- rbi/stagehand/internal/type/file_input.rbi
+- rbi/stagehand/internal/type/hash_of.rbi
+- rbi/stagehand/internal/type/request_parameters.rbi
+- rbi/stagehand/internal/type/union.rbi
+- rbi/stagehand/internal/type/unknown.rbi
+- rbi/stagehand/internal/util.rbi
+- rbi/stagehand/models.rbi
+- rbi/stagehand/models/action.rbi
+- rbi/stagehand/models/model_config.rbi
+- rbi/stagehand/models/session_act_params.rbi
+- rbi/stagehand/models/session_act_response.rbi
+- rbi/stagehand/models/session_end_params.rbi
+- rbi/stagehand/models/session_end_response.rbi
+- rbi/stagehand/models/session_execute_params.rbi
+- rbi/stagehand/models/session_execute_response.rbi
+- rbi/stagehand/models/session_extract_params.rbi
+- rbi/stagehand/models/session_extract_response.rbi
+- rbi/stagehand/models/session_navigate_params.rbi
+- rbi/stagehand/models/session_navigate_response.rbi
+- rbi/stagehand/models/session_observe_params.rbi
+- rbi/stagehand/models/session_observe_response.rbi
+- rbi/stagehand/models/session_replay_params.rbi
+- rbi/stagehand/models/session_replay_response.rbi
+- rbi/stagehand/models/session_start_params.rbi
+- rbi/stagehand/models/session_start_response.rbi
+- rbi/stagehand/models/stream_event.rbi
+- rbi/stagehand/request_options.rbi
+- rbi/stagehand/resources/sessions.rbi
+- rbi/stagehand/version.rbi
+- sig/stagehand/client.rbs
+- sig/stagehand/errors.rbs
+- sig/stagehand/file_part.rbs
+- sig/stagehand/internal.rbs
+- sig/stagehand/internal/stream.rbs
+- sig/stagehand/internal/transport/base_client.rbs
+- sig/stagehand/internal/transport/pooled_net_requester.rbs
+- sig/stagehand/internal/type/array_of.rbs
+- sig/stagehand/internal/type/base_model.rbs
+- sig/stagehand/internal/type/base_page.rbs
+- sig/stagehand/internal/type/base_stream.rbs
+- sig/stagehand/internal/type/boolean.rbs
+- sig/stagehand/internal/type/converter.rbs
+- sig/stagehand/internal/type/enum.rbs
+- sig/stagehand/internal/type/file_input.rbs
+- sig/stagehand/internal/type/hash_of.rbs
+- sig/stagehand/internal/type/request_parameters.rbs
+- sig/stagehand/internal/type/union.rbs
+- sig/stagehand/internal/type/unknown.rbs
+- sig/stagehand/internal/util.rbs
+- sig/stagehand/models.rbs
+- sig/stagehand/models/action.rbs
+- sig/stagehand/models/model_config.rbs
+- sig/stagehand/models/session_act_params.rbs
+- sig/stagehand/models/session_act_response.rbs
+- sig/stagehand/models/session_end_params.rbs
+- sig/stagehand/models/session_end_response.rbs
+- sig/stagehand/models/session_execute_params.rbs
+- sig/stagehand/models/session_execute_response.rbs
+- sig/stagehand/models/session_extract_params.rbs
+- sig/stagehand/models/session_extract_response.rbs
+- sig/stagehand/models/session_navigate_params.rbs
+- sig/stagehand/models/session_navigate_response.rbs
+- sig/stagehand/models/session_observe_params.rbs
+- sig/stagehand/models/session_observe_response.rbs
+- sig/stagehand/models/session_replay_params.rbs
+- sig/stagehand/models/session_replay_response.rbs
+- sig/stagehand/models/session_start_params.rbs
+- sig/stagehand/models/session_start_response.rbs
+- sig/stagehand/models/stream_event.rbs
+- sig/stagehand/request_options.rbs
+- sig/stagehand/resources/sessions.rbs
+- sig/stagehand/version.rbs
+homepage: https://gemdocs.org/gems/stagehand
 licenses: []
-post_install_message: 
+metadata:
+  homepage_uri: https://gemdocs.org/gems/stagehand
+  source_code_uri: https://github.com/browserbase/stagehand-ruby
+  rubygems_mfa_required: 'false'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: stagehand
-rubygems_version: 1.8.10
-signing_key: 
-specification_version: 3
-summary: client library for Personas (user management) service
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: Ruby library to access the Stagehand API
 test_files: []

data/.gitignore

@@ -1,16 +0,0 @@
-*.gem
-.bundle
-Gemfile.lock
-pkg/*
-
-# Emacs
-*~
-.\#*
-\#*\#
-/.emacs.desktop
-/.emacs.desktop.lock
-.elc
-auto-save-list
-tramp
-.*swp
-TAGS

data/Gemfile

@@ -1,4 +0,0 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in stagehand.gemspec
-gemspec

data/Rakefile

@@ -1,10 +0,0 @@
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-desc "Run RSpec"
-RSpec::Core::RakeTask.new do |t|
-  t.verbose = false
-end
-
-task :default => :spec
-

data/lib/stagehand/client/oauth.rb

@@ -1,32 +0,0 @@
-module Stagehand
-  class Client
-    # Methods for OAuth 2.0 authentication
-    module OAuth
-      # URL used for initial OAuth login and authorization
-      def authorize_url
-        Stagehand.config.resource_host + "/oauth/authorize?client_id=#{Stagehand.config.client_id}&client_secret=#{Stagehand.config.client_secret}&redirect_uri=#{Stagehand.config.client_host}/callback"
-      end
-
-      def access_token_url
-        Stagehand.config.resource_host + "/oauth/access_token"
-      end
-
-      def redirect_uri
-        Stagehand.config.client_host + "/callback"
-      end
-
-      def logout_url
-        Stagehand.config.resource_host + "/logout?redirect_uri=#{Stagehand.config.client_host}"
-      end
-
-      def access_token
-        request.env['rack.session'][:access_token]
-      end
-
-      def get_with_access_token(path, params)
-        params[:oauth_token] = access_token
-        HTTParty.get(Stagehand.config.resource_host + path, query: params)
-      end
-    end
-  end
-end

data/lib/stagehand/client/user.rb

@@ -1,10 +0,0 @@
-module Stagehand
-  class Client
-    # Methods for users
-    module User
-      def profile
-        response = get(Stagehand.config.resource_host + "/profile.json")
-      end
-    end
-  end
-end