pwn 0.5.453 → 0.5.455

data/lib/pwn/ai/introspection.rb

@@ -45,7 +45,9 @@ module PWN
               system_role_content: system_role_content,
               spinner: false
             )
-            puts response
+            response = response[:choices].last[:content] if response.is_a?(Hash) &&
+                                                            response.key?(:choices) &&
+                                                            response[:choices].last.keys.include?(:content)
           when :openai
             response = PWN::AI::OpenAI.chat(
               request: request.chomp,

data/lib/pwn/config.rb

@@ -7,10 +7,46 @@ module PWN
   # Used to manage PWN configuration settings within PWN drivers.
   module Config
     # Supported Method Parameters::
-    # env = PWN::Config.minimal_env
-    public_class_method def self.minimal_env(opts = {})
+    # PWN::Config.redact_sensitive_artifacts(
+    #   config: 'optional - Hash to redact sensitive artifacts from.  Defaults to PWN::Env'
+    # )
+    public_class_method def self.redact_sensitive_artifacts(opts = {})
+      config = opts[:config] ||= PWN::Env
+
+      sensitive_keys = %i[api_key key pass password psk token]
+
+      # Transform values at the current level: redact sensitive keys
+      config.transform_values.with_index do |v, k|
+        if sensitive_keys.include?(config.keys[k])
+          '>>> REDACTED >>> USE `pwn-vault` FOR ADMINISTRATION <<< REDACTED <<<'
+        else
+          v.is_a?(Hash) ? redact_sensitive_artifacts(config: v) : v
+        end
+      end
+    rescue StandardError => e
+      raise e
+    end
+
+    # Supported Method Parameters::
+    # env = PWN::Config.init_driver_options
+    public_class_method def self.init_driver_options
+      env = {
+        driver_opts: {
+          pwn_env_path: nil,
+          pwn_dec_path: nil
+        }
+      }
+      PWN.const_set(:Env, env)
+      # puts '[*] Loaded driver options.'
+    rescue StandardError => e
+      raise e
+    end
+
+    # Supported Method Parameters::
+    # env = PWN::Config.default_env
+    public_class_method def self.default_env(opts = {})
       pwn_env_path = opts[:pwn_env_path]
-      pwn_dec_path = "#{File.dirname(pwn_env_path)}/pwn.decryptor.yaml"
+      pwn_dec_path = "#{pwn_env_path}.decryptor"
 
       puts "
         [*] NOTICE:
@@ -26,38 +62,38 @@ module PWN
       "
       env = {
         ai: {
-          active: "'grok'",
+          active: 'grok',
           introspection: false,
           grok: {
-            base_uri: "'optional - Base URI for Grok - Use private base OR defaults to https://api.x.ai/v1'",
-            key: "'required - OpenAI API Key'",
-            model: "'optional - Grok model to use'",
-            system_role_content: "'You are an ethically hacking OpenAI agent.'",
-            temp: "'optional - OpenAI temperature'"
+            base_uri: 'optional - Base URI for Grok - Use private base OR defaults to https://api.x.ai/v1',
+            key: 'required - OpenAI API Key',
+            model: 'optional - Grok model to use',
+            system_role_content: 'You are an ethically hacking OpenAI agent.',
+            temp: 'optional - OpenAI temperature'
           },
           openai: {
-            base_uri: "'optional - Base URI for OpenAI - Use private base OR defaults to https://api.openai.com/v1'",
-            key: "'required - OpenAI API Key'",
-            model: "'optional - OpenAI model to use'",
-            system_role_content: "'You are an ethically hacking OpenAI agent.'",
-            temp: "'optional - OpenAI temperature'"
+            base_uri: 'optional - Base URI for OpenAI - Use private base OR defaults to https://api.openai.com/v1',
+            key: 'required - OpenAI API Key',
+            model: 'optional - OpenAI model to use',
+            system_role_content: 'You are an ethically hacking OpenAI agent.',
+            temp: 'optional - OpenAI temperature'
           },
           ollama: {
-            base_uri: "'required - Base URI for Open WebUI - e.g. https://ollama.local'",
-            key: "'required - Open WebUI API Key Under Settings  >> Account >> JWT Token'",
-            model: "'required - Ollama model to use'",
-            system_role_content: "'You are an ethically hacking Ollama agent.'",
-            temp: "'optional - Ollama temperature'"
+            base_uri: 'required - Base URI for Open WebUI - e.g. https://ollama.local',
+            key: 'required - Open WebUI API Key Under Settings  >> Account >> JWT Token',
+            model: 'required - Ollama model to use',
+            system_role_content: 'You are an ethically hacking Ollama agent.',
+            temp: 'optional - Ollama temperature'
           }
         },
         plugins: {
-          asm: { arch: "'#{PWN::Plugins::DetectOS.arch}'", endian: "'#{PWN::Plugins::DetectOS.endian}'" },
+          asm: { arch: PWN::Plugins::DetectOS.arch, endian: PWN::Plugins::DetectOS.endian.to_s },
           blockchain: {
             bitcoin: {
-              rpc_host: "'localhost'",
+              rpc_host: 'localhost',
               rpc_port: 8332,
-              rpc_user: "'bitcoin RPC Username'",
-              rpc_pass: "'bitcoin RPC Password'"
+              rpc_user: 'bitcoin RPC Username',
+              rpc_pass: 'bitcoin RPC Password'
             }
           },
           irc: {
@@ -84,9 +120,23 @@ module PWN
           },
           hunter: { api_key: 'hunter.how API Key' },
           meshtastic: {
-            psks: {
-              LongFast: 'AQ==',
-              PWN: 'required - PSK for pwn channel'
+            mqtt: {
+              host: 'mqtt.meshtastic.org',
+              port: 1883,
+              user: 'meshdev',
+              pass: 'large4cats'
+            },
+            channel: {
+              LongFast: {
+                psk: 'AQ==',
+                region: 'US/<STATE>',
+                channel_topic: '2/e/#'
+              },
+              PWN: {
+                psk: 'required - PSK for pwn channel',
+                region: 'US/<STATE>',
+                channel_topic: '2/e/PWN/#'
+              }
             }
           },
           shodan: { api_key: 'SHODAN API Key' }
@@ -116,7 +166,7 @@ module PWN
     # Supported Method Parameters::
     # PWN::Config.refresh_env(
     #   pwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml',
-    #   pwn_dec_path: 'optional - Path to pwn.decryptor.yaml file.  Defaults to ~/.pwn/pwn.decryptor.yaml'
+    #   pwn_dec_path: 'optional - Path to pwn.yaml.decryptor file.  Defaults to ~/.pwn/pwn.yaml.decryptor'
     # )
 
     public_class_method def self.refresh_env(opts = {})
@@ -124,30 +174,27 @@ module PWN
       FileUtils.mkdir_p(pwn_env_root)
 
       pwn_env_path = opts[:pwn_env_path] ||= "#{pwn_env_root}/pwn.yaml"
-      return minimal_env(pwn_env_path: pwn_env_path) unless File.exist?(pwn_env_path)
+      return default_env(pwn_env_path: pwn_env_path) unless File.exist?(pwn_env_path)
 
       is_encrypted = PWN::Plugins::Vault.file_encrypted?(file: pwn_env_path)
+      raise "PWN Environment (#{pwn_env_path}) is not encrypted!  Use PWN::Vault.create(file: '#{pwn_env_path}', decryptor_file: '#{pwn_env_path}.decryptor') to encrypt it." unless is_encrypted
 
-      if is_encrypted
-        pwn_dec_path = opts[:pwn_dec_path] ||= "#{pwn_env_root}/pwn.decryptor.yaml"
-        raise "PWN Decryptor (#{pwn_dec_path}) does not exist!" unless File.exist?(pwn_dec_path)
+      pwn_dec_path = opts[:pwn_dec_path] ||= "#{pwn_env_path}.decryptor"
+      raise "PWN Decryptor (#{pwn_dec_path}) does not exist!" unless File.exist?(pwn_dec_path)
 
-        pwn_decryptor = YAML.load_file(pwn_dec_path, symbolize_names: true)
+      pwn_decryptor = YAML.load_file(pwn_dec_path, symbolize_names: true)
 
-        key = opts[:key] ||= pwn_decryptor[:key] ||= ENV.fetch('PWN_DECRYPTOR_KEY')
-        key = PWN::Plugins::AuthenticationHelper.mask_password(prompt: 'Decryption Key') if key.nil?
+      key = opts[:key] ||= pwn_decryptor[:key] ||= ENV.fetch('PWN_DECRYPTOR_KEY')
+      key = PWN::Plugins::AuthenticationHelper.mask_password(prompt: 'Decryption Key') if key.nil?
 
-        iv = opts[:iv] ||= pwn_decryptor[:iv] ||= ENV.fetch('PWN_DECRYPTOR_IV')
-        iv = PWN::Plugins::AuthenticationHelper.mask_password(prompt: 'Decryption IV') if iv.nil?
+      iv = opts[:iv] ||= pwn_decryptor[:iv] ||= ENV.fetch('PWN_DECRYPTOR_IV')
+      iv = PWN::Plugins::AuthenticationHelper.mask_password(prompt: 'Decryption IV') if iv.nil?
 
-        env = PWN::Plugins::Vault.dump(
-          file: pwn_env_path,
-          key: key,
-          iv: iv
-        )
-      else
-        env = YAML.load_file(pwn_env_path, symbolize_names: true)
-      end
+      env = PWN::Plugins::Vault.dump(
+        file: pwn_env_path,
+        key: key,
+        iv: iv
+      )
 
       valid_ai_engines = PWN::AI.help.reject { |e| e.downcase == :introspection }.map(&:downcase)
 
@@ -185,9 +232,18 @@ module PWN
         pwn_dec_path: pwn_dec_path
       }
 
-      Pry.config.refresh_pwn_env = false if defined?(Pry)
+      # Assign the refreshed env to PWN::Env
       PWN.send(:remove_const, :Env) if PWN.const_defined?(:Env)
       PWN.const_set(:Env, env.freeze)
+
+      # Redact sensitive artifacts from PWN::Env and store in PWN::EnvRedacted
+      env_redacted = redact_sensitive_artifacts(config: env)
+      PWN.send(:remove_const, :EnvRedacted) if PWN.const_defined?(:EnvRedacted)
+      PWN.const_set(:EnvRedacted, env_redacted.freeze)
+
+      Pry.config.refresh_pwn_env = false if defined?(Pry)
+
+      puts "[*] PWN::Env loaded via: #{pwn_env_path}\n"
     rescue StandardError => e
       raise e
     end
@@ -204,13 +260,13 @@ module PWN
 
     public_class_method def self.help
       puts "USAGE:
-        #{self}.minimal_env(
+        #{self}.default_env(
           pwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml'
         )
 
         #{self}.refresh_env(
           pwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml',
-          pwn_dec_path: 'optional - Path to pwn.decryptor.yaml file.  Defaults to ~/.pwn/pwn.decryptor.yaml'
+        pwn_dec_path: 'optional - Path to pwn.yaml.decryptor file.  Defaults to ~/.pwn/pwn.yaml.decryrptor'
         )
 
         #{self}.authors

data/lib/pwn/driver.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'optparse'
+
+module PWN
+  # Used to consume options passed into PWN drivers and load PWN::Env
+  class Driver
+    # Add OptionParser options to PWN::Env
+    class Parser < OptionParser
+      attr_accessor :auto_opts_help,
+                    :opts
+
+      def initialize
+        super
+        @opts = PWN::Env[:driver_opts]
+        @auto_opts_help = true
+
+        banner = "USAGE: #{File.basename($PROGRAM_NAME)} [opts]\n"
+        on(
+          '-YPATH',
+          '--pwn_env=PATH',
+          '<Optional - PWN::Env YAML file path (Default: ~/.pwn/pwn.yaml)>'
+        ) do |o|
+          @opts[:pwn_env_path] = o
+        end
+        on(
+          '-ZPATH',
+          '--pwn_dec=PATH',
+          '<Optional - Out-of-Band YAML file path (Default: ~/.pwn/pwn.decryptor.yaml)>'
+        ) do |o|
+          @opts[:pwn_dec_path] = o
+        end
+      end
+
+      def parse!
+        super(ARGV, into: @opts)
+        # puts @opts
+
+        PWN::Config.refresh_env(
+          pwn_env_path: @opts[:pwn_env_path],
+          pwn_dec_path: @opts[:pwn_dec_path]
+        )
+
+        if @auto_opts_help && @opts.keys.join(' ') == 'pwn_env_path pwn_dec_path'
+          puts `#{File.basename($PROGRAM_NAME)} --help`
+          exit 1
+        end
+      end
+    end
+
+    # Author(s):: 0day Inc. <support@0dayinc.com>
+
+    public_class_method def self.authors
+      "AUTHOR(S):
+        0day Inc. <support@0dayinc.com>
+      "
+    end
+
+    # Display Usage for this Module
+
+    public_class_method def self.help
+      puts "USAGE:
+        # Load default driver options into PWN::Env
+        opts = PWN::Env[:driver_opts]
+        #{self}::Parser.new.parse(&:on).parse!
+
+        # Add more options by passing a block to the parser
+        opts = PWN::Env[:driver_opts]
+        #{self}::Parser.new do |options|
+          # Boolean option
+          options.on('-b', '--boolean') do |o|
+            opts[:boolean] = o
+          end
+
+          # String option
+          options.on('-sSTRING', '--string=STRING') do |o|
+            opts[:string] = o
+          end
+        end.parse!
+
+        #{self}.authors
+      "
+    end
+  end
+end

data/lib/pwn/plugins/repl.rb

@@ -489,6 +489,7 @@ module PWN
         # Define REPL Hooks
         # Welcome Banner Hook
         Pry.config.hooks.add_hook(:before_session, :welcome) do |output, _binding, _pi|
+          Pry.config.refresh_pwn_env = false
           output.puts PWN::Banner.welcome
         end
 
@@ -597,11 +598,11 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::REPL.start(
-      #   opts: 'required - Hash object passed in via pwn OptParser'
-      # )
+      # PWN::Plugins::REPL.start
+
+      public_class_method def self.start
+        opts = PWN::Env[:driver_opts]
 
-      public_class_method def self.start(opts = {})
         # Monkey Patch Pry, add commands, && hooks
         PWN::Plugins::MonkeyPatch.pry
         pwn_env_root = "#{Dir.home}/.pwn"
@@ -646,13 +647,9 @@ module PWN
 
           #{self}.add_commands
 
-          #{self}.add_hooks(
-            opts: 'required - Hash object passed in via pwn OptParser'
-          )
+          #{self}.add_hooks
 
-          #{self}.start(
-            opts: 'required - Hash object passed in via pwn OptParser'
-          )
+          #{self}.start
 
           #{self}.authors
         "

data/lib/pwn/plugins/transparent_browser.rb

@@ -7,7 +7,7 @@ require 'nokogiri'
 require 'openssl'
 require 'rest-client'
 require 'securerandom'
-require 'selenium/devtools/v140'
+require 'selenium/devtools'
 require 'selenium/webdriver'
 require 'socksify'
 require 'timeout'

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.453'
+  VERSION = '0.5.455'
 end

data/lib/pwn.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'json'
-require 'optparse'
 require 'pwn/version'
 require 'yaml'
 
@@ -16,21 +15,23 @@ module PWN
   autoload :Banner, 'pwn/banner'
   autoload :Blockchain, 'pwn/blockchain'
   autoload :Config, 'pwn/config'
+  autoload :Driver, 'pwn/driver'
   autoload :FFI, 'pwn/ffi'
   autoload :Plugins, 'pwn/plugins'
   autoload :Reports, 'pwn/reports'
   autoload :SAST, 'pwn/sast'
   autoload :WWW, 'pwn/www'
 
+  # Initialize Options for Drivers
+
+  PWN::Config.init_driver_options
+
   # Display a List of Every PWN Module
 
   public_class_method def self.help
     constants.sort
   end
 
-  # Initialize PWN configuration file
-  # PWN::Env is the constant that stores the configuration data
-  PWN::Config.refresh_env
 rescue StandardError => e
   puts e.backtrace
   raise e

data/spec/lib/pwn/driver_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::Driver do
+  it 'should display information for authors' do
+    authors_response = PWN::Driver
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::Driver
+    expect(help_response).to respond_to :help
+  end
+end

data/third_party/pwn_rdoc.jsonl

@@ -7,7 +7,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Grok.help Usage"},{"role":"assistant","content":"`PWN::AI::Grok.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Introspection.authors Usage"},{"role":"assistant","content":"`PWN::AI::Introspection.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Introspection.help Usage"},{"role":"assistant","content":"`PWN::AI::Introspection.help`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Introspection.reflect Usage"},{"role":"assistant","content":"`PWN::AI::Introspection.reflect`: Supported Method Parameters\n\nresponse = PWN::AI::Introspection.reflect(\n\nrequest: 'required - String - What you want the AI to reflect on'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Introspection.reflect_on Usage"},{"role":"assistant","content":"`PWN::AI::Introspection.reflect_on`: Supported Method Parameters\n\nresponse = PWN::AI::Introspection.reflect_on(\n\nrequest: 'required - String - What you want the AI to reflect on',\nsystem_role_content: 'optional - context to set up the model behavior for reflection'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.authors Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.chat Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.chat(\n\nrequest: 'required - message to ChatGPT'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:ollama][:model])',\ntemp: 'optional - creative response float (deafults to PWN::Env[:ai][:ollama][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:ollama][:system_role_content])',\nresponse_history: 'optional - pass response back in to have a conversation',\nspeak_answer: 'optional speak answer using PWN::Plugins::Voice.text_to_speech (Default: nil)',\ntimeout: 'optional timeout in seconds (defaults to 300)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.get_models`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.get_models\n"}]}
@@ -458,9 +458,15 @@
 {"messages":[{"role":"user","content":"PWN::Blockchain::ETH.get_latest_block Usage"},{"role":"assistant","content":"`PWN::Blockchain::ETH.get_latest_block`: Supported Method Parameters\n\nlatest_block = PWN::Blockchain::ETH.get_latest_block(\n\ntoken: 'optional - API token for higher rate limits'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Blockchain::ETH.help Usage"},{"role":"assistant","content":"`PWN::Blockchain::ETH.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.authors Usage"},{"role":"assistant","content":"`PWN::Config.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.default_env Usage"},{"role":"assistant","content":"`PWN::Config.default_env`: Supported Method Parameters\n\nenv = PWN::Config.default_env\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.help Usage"},{"role":"assistant","content":"`PWN::Config.help`: "}]}
-{"messages":[{"role":"user","content":"PWN::Config.minimal_env Usage"},{"role":"assistant","content":"`PWN::Config.minimal_env`: Supported Method Parameters\n\nenv = PWN::Config.minimal_env\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.init_driver_options Usage"},{"role":"assistant","content":"`PWN::Config.init_driver_options`: Supported Method Parameters\n\nenv = PWN::Config.init_driver_options\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.redact_sensitive_artifacts Usage"},{"role":"assistant","content":"`PWN::Config.redact_sensitive_artifacts`: Supported Method Parameters\n\nPWN::Config.redact_sensitive_artifacts(\n\nconfig: 'optional - Hash to redact sensitive artifacts from.  Defaults to PWN::Env'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.refresh_env Usage"},{"role":"assistant","content":"`PWN::Config.refresh_env`: Supported Method Parameters\n\nPWN::Config.refresh_env(\n\npwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml',\npwn_dec_path: 'optional - Path to pwn.decryptor.yaml file.  Defaults to ~/.pwn/pwn.decryptor.yaml'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Driver.authors Usage"},{"role":"assistant","content":"`PWN::Driver.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::Driver.help Usage"},{"role":"assistant","content":"`PWN::Driver.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::Driver::Parser.new Usage"},{"role":"assistant","content":"`PWN::Driver::Parser.new`: "}]}
+{"messages":[{"role":"user","content":"PWN::Driver::Parser.parse! Usage"},{"role":"assistant","content":"`PWN::Driver::Parser.parse!`: "}]}
 {"messages":[{"role":"user","content":"PWN::FFI.help Usage"},{"role":"assistant","content":"`PWN::FFI.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::FFI::Stdio.authors Usage"},{"role":"assistant","content":"`PWN::FFI::Stdio.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::FFI::Stdio.help Usage"},{"role":"assistant","content":"`PWN::FFI::Stdio.help`: "}]}
@@ -903,7 +909,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::REPL.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::REPL.help Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::REPL.refresh_ps1_proc Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.refresh_ps1_proc`: Supported Method Parameters\n\nPWN::Plugins::REPL.refresh_ps1_proc(\n\nmode: 'required - :splat or nil'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::REPL.start Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.start`: Supported Method Parameters\n\nPWN::Plugins::REPL.start(\n\nopts: 'required - Hash object passed in via pwn OptParser'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::REPL.start Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.start`: Supported Method Parameters\n\nPWN::Plugins::REPL.start\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::REPL.process Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.process`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::REPL.top_h1_program_scope Usage"},{"role":"assistant","content":"`PWN::Plugins::REPL.top_h1_program_scope`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::RFIDler.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::RFIDler.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
@@ -997,11 +1003,11 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.close_tab Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.close_tab`: Supported Method Parameters\n\ntab = PWN::Plugins::TransparentBrowser.close_tab(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\nindex: 'optional - index of tab to close (defaults to closing active tab)',\nkeyword: 'optional - keyword in title or url used to close tabs (defaults to closing active tab)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.console Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.console`: Supported Method Parameters\n\nconsole_resp = PWN::Plugins::TransparentBrowser.console(\n\nbrowser_obj: browser_obj1,\njs: 'required - JavaScript expression to evaluate',\nreturn_to: 'optional - return to :console or :stdout (defaults to :console)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.debugger Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.debugger`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.debugger(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\naction: 'optional - action to take :enable|:pause|:resume|:disable (Defaults to :enable)',\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.devtools_websocket_messages Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.devtools_websocket_messages`: Supported Method Parameters\n\nmessages = PWN::Plugins::TransparentBrowser.devtools_websocket_messages(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.dom Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.dom`: Supported Method Parameters\n\ncurrent_dom = PWN::Plugins::TransparentBrowser.dom(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.dump_links Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.dump_links`: Supported Method Parameters\n\nbrowser_obj = PWN::Plugins::TransparentBrowser.dump_links(\n\nbrowser_obj: browser_obj1\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.find_elements_by_text Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.find_elements_by_text`: Supported Method Parameters\n\nbrowser_obj = PWN::Plugins::TransparentBrowser.find_elements_by_text(\n\nbrowser_obj: browser_obj1,\ntext: 'required - text to search for in the DOM'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.get_page_state Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.get_page_state`: Supported Method Parameters\n\npage_state = PWN::Plugins::TransparentBrowser.get_page_state(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.get_possible_breakpoints Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.get_possible_breakpoints`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.get_possible_breakpoints(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.help Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.hide_dom_mutations Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.hide_dom_mutations`: Supported Method Parameters\n\nconsole_resp = PWN::Plugins::TransparentBrowser.hide_dom_mutations(\n\nbrowser_obj: browser_obj1,\nindex: 'optional - index of tab to switch to (defaults to active tab)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.jmp_devtools_panel Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.jmp_devtools_panel`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.jmp_devtools_panel(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\npanel: 'optional - panel to switch to :elements|:inspector|:console|:debugger|:sources|:network\n\n)\n"}]}
@@ -1009,7 +1015,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.list_tabs Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.list_tabs`: Supported Method Parameters\n\ntabs = PWN::Plugins::TransparentBrowser.list_tabs(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.new_tab Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.new_tab`: Supported Method Parameters\n\ntab = PWN::Plugins::TransparentBrowser.new_tab(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\nurl: 'optional - URL to open in new tab'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.open Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.open`: Supported Method Parameters\n\nbrowser_obj1 = PWN::Plugins::TransparentBrowser.open(\n\nbrowser_type: 'optional - :firefox|:chrome|:headless|:rest|:websocket (defaults to :chrome)',\nproxy: 'optional - scheme://proxy_host:port || tor (defaults to nil)',\ndevtools: 'optional - boolean (defaults to false)',\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.step Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.step`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.step(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\naction: 'optional - action to take :into|:out|:over (Defaults to :into)',\nsteps: 'optional - number of steps taken (Defaults to 1)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.step Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.step`: Supported Method Parameters\n\npage_state_arr = PWN::Plugins::TransparentBrowser.step(\n\nbrowser_obj: 'required - browser_obj returned from #open method)',\naction: 'optional - action to take :into|:out|:over (Defaults to :into)',\nsteps: 'optional - number of steps taken (Defaults to 1)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.toggle_devtools Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.toggle_devtools`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.toggle_devtools(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.type_as_human Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.type_as_human`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.type_as_human(\n\nstring: 'required - string to type as human',\nrand_sleep_float: 'optional - float timing in between keypress (defaults to 0.09)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.update_about_config Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.update_about_config`: Supported Method Parameters\n\nPWN::Plugins::TransparentBrowser.update_about_config(\n\nbrowser_obj: browser_obj1,\nkey: 'required - key to update in about:config',\nvalue: 'required - value to set for key in about:config'\n\n)\n"}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.453
+  version: 0.5.455
 platform: ruby
 authors:
 - 0day Inc.
@@ -127,14 +127,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.1.1
+        version: 5.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.1.1
+        version: 5.2.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -289,20 +289,6 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 1.17.2
-- !ruby/object:Gem::Dependency
-  name: fftw3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: '0.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: gdb
   requirement: !ruby/object:Gem::Requirement
@@ -1261,14 +1247,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 6.0.2
+        version: 6.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 6.0.2
+        version: 6.0.3
 - !ruby/object:Gem::Dependency
   name: whois-parser
   requirement: !ruby/object:Gem::Requirement
@@ -1449,8 +1435,6 @@ files:
 - documentation/pwn_wallpaper.jpg
 - documentation/ringing-spectrogram.png
 - documentation/ringing-waveform.png
-- etc/pwn.decryptor.yaml.EXAMPLE
-- etc/pwn.yaml.EXAMPLE
 - etc/systemd/msfrpcd.service
 - etc/systemd/openvas.service
 - etc/userland/aws/apache2/jenkins_443.conf
@@ -1876,6 +1860,7 @@ files:
 - lib/pwn/blockchain/btc.rb
 - lib/pwn/blockchain/eth.rb
 - lib/pwn/config.rb
+- lib/pwn/driver.rb
 - lib/pwn/ffi.rb
 - lib/pwn/ffi/stdio.rb
 - lib/pwn/plugins.rb
@@ -2229,6 +2214,7 @@ files:
 - spec/lib/pwn/blockchain/eth_spec.rb
 - spec/lib/pwn/blockchain_spec.rb
 - spec/lib/pwn/config_spec.rb
+- spec/lib/pwn/driver_spec.rb
 - spec/lib/pwn/ffi/stdio_spec.rb
 - spec/lib/pwn/ffi_spec.rb
 - spec/lib/pwn/plugins/android_spec.rb

data/etc/pwn.decryptor.yaml.EXAMPLE

@@ -1,5 +0,0 @@
-# Drop this file in $HOME/.pwn/pwn.decryptor.yaml
-# If you rely upon this file, it should be out-of-band for optimal security
-# (e.g. not available in code repos, permission protected, limited access, etc.) 
-key: 'KEY PROVIDED WHEN USING PWN::Plugins::Vault.create(file: "pwn.yaml") TO ENCRYPT pwn.yaml'
-iv: 'KEY PROVIDED WHEN USING PWN::Plugins::Vault.create(file: "pwn.yaml") TO ENCRYPT pwn.yaml'