pwn 0.5.503 → 0.5.505

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd561ae532d36fea188dbd8a3344d5803912e45f20b100c6d2783441e52c9c7e
-  data.tar.gz: dec66439bcef3c6d8f05b2b655385923477c90060e3ef2d120858075b4b9aae1
+  metadata.gz: bee5101dd6376bc129ed438a7e5afdf0fb2fb71612ff4663aa9747b9b538c639
+  data.tar.gz: ceac8682de6d7347a350ed8fd3598f371c6a4d1df107f471920bfd8ca7da8520
 SHA512:
-  metadata.gz: e24cb600887dba7365f9947c88689fb3d416517594a51deb440fba7fc13c4a5b59352ff99eab10941a70f0114b25268ae45e0aba176eb8b8d14d4ecec0f61003
-  data.tar.gz: 322e6ed5eefa780c44f5a0f459043d093cbd5d4e6915c42d1039ed6bc984f48fb2dce01894f2974164ba0fa5bb7e2c817b93cce2653d87cd19f187b64ba9a8d7
+  metadata.gz: 4791d10076ceda124e859a7cc92efa78822ede231a3d47acd05e5cd80526aff75d3679f857d2a0c89e52245191fb1f5b211c74e415e3307325f9e8e1f19be331
+  data.tar.gz: d039ccf4f5b7ee4fafa39b444fccf29ded52d294d70ef29f4b8df16f170328896885ef9babd5dd0b19588bcbbe24a63bd79f7cab739819e0cad1343e7a2d9d46

data/.rubocop.yml

@@ -18,7 +18,7 @@ Metrics/CyclomaticComplexity:
 Metrics/MethodLength:
   Max: 565
 Metrics/ModuleLength:
-  Max: 1475
+  Max: 1561
 Metrics/PerceivedComplexity:
   Max: 157
 Style/HashEachMethods:

data/Gemfile

@@ -82,7 +82,7 @@ gem 'rspec', '3.13.2'
 gem 'rtesseract', '3.1.4'
 gem 'rubocop', '1.81.7'
 gem 'rubocop-rake', '0.7.1'
-gem 'rubocop-rspec', '3.7.0'
+gem 'rubocop-rspec', '3.8.0'
 gem 'ruby-audio', '1.6.1'
 gem 'ruby-nmap', '1.0.3'
 gem 'ruby-saml', '1.18.1'

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.503]:001 >>> PWN.help
+pwn[v0.5.505]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.4.4@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.503]:001 >>> PWN.help
+pwn[v0.5.505]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.4.4@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.503]:001 >>> PWN.help
+pwn[v0.5.505]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/lib/pwn/plugins/burp_suite.rb

@@ -46,7 +46,7 @@ module PWN
       # Supported Method Parameters::
       # burp_obj = PWN::Plugins::BurpSuite.init_introspection_thread(
       #   burp_obj: 'required - burp_obj returned by #start method',
-      #   enumerable_array: 'required - array of items to process in the thread'
+      #   type: 'required - type of history to introspect (:sitemap, :proxy_history, :websocket_history)'
       # )
       private_class_method def self.init_introspection_thread(opts = {})
         #  if PWN::Env[:ai][:introspection] is true,
@@ -60,12 +60,17 @@ module PWN
         burp_obj = opts[:burp_obj]
         raise 'ERROR: burp_obj parameter is required' unless burp_obj.is_a?(Hash)
 
+        valid_types = %i[sitemap proxy_history websocket_history]
+        type = opts[:type]
+        raise "ERROR: type parameter is required and must be one of: #{valid_types.join(', ')}" unless valid_types.include?(type)
+
         if PWN::Env[:ai][:introspection]
+          introspection_thread_arr = burp_obj[:introspection_threads] ||= []
           introspection_thread = Thread.new do
             system_role_content = '
-              Your expertise lies in dissecting HTTP request/response pairs to identify high-impact vulnerabilities, including but not limited to XSS (reflected, stored, DOM-based), CSRF, SSRF, IDOR, open redirects, CORS misconfigurations, authentication bypasses, SQLi/NoSQLi, command/code injection, business logic flaws, and API abuse. You prioritize zero-days and novel chains, always focusing on exploitability, impact (e.g., account takeover, data exfiltration, RCE), and reproducibility.
+              Your expertise lies in dissecting HTTP request/response pairs and WebSocket messages to identify high-impact vulnerabilities, including but not limited to XSS (reflected, stored, DOM-based), CSRF, SSRF, IDOR, open redirects, CORS misconfigurations, authentication bypasses, SQLi/NoSQLi, command/code injection, business logic flaws, race conditions, and API abuse. You prioritize zero-days and novel chains, always focusing on exploitability, impact (e.g., account takeover, data exfiltration, RCE), and reproducibility.
 
-              When analyzing HTTP request/response pairs:
+              During analysis:
 
               1. **Parse and Contextualize Traffic**:
                  - Break down every element: HTTP method, URI (path, query parameters), headers (e.g., Host, User-Agent, Cookies, Authorization, Referer, Origin, Content-Type), request body (e.g., form data, JSON payloads), response status code, response headers, and response body (HTML, JSON, XML, etc.).
@@ -119,95 +124,128 @@ module PWN
               highlight_color
             end
 
-            proxy_history = []
             loop do
-              # TODO: Implement sitemap and repeater into the loop.
-              # Sitemap should work the same as proxy history.
+              # TODO: Implement repeater into the loop?  This reduces load to LLM but is slooow.
               # Repeater should analyze the reqesut/response pair and suggest
-              # modifications to the request to further probe for vulnerabilities.
-              sitemap = get_sitemap(burp_obj: burp_obj)
-              sitemap.each do |entry|
-                next unless entry.key?(:comment) && entry[:comment].to_s.strip.empty?
-
-                request = entry[:request]
-                response = entry[:response]
-                host = entry[:http_service][:host]
-                port = entry[:http_service][:port]
-                protocol = entry[:http_service][:protocol]
-                next if request.nil? || response.nil? || host.nil? || port.nil? || protocol.nil?
-
-                proxy_history_entry = nil
-                if proxy_history.any?
-                  proxy_history_entry = proxy_history.find do |proxy_entry|
-                    next unless proxy_entry.key?(:http_service) && proxy_entry.key?(:request)
-
-                    proxy_entry[:http_service][:host] == host &&
-                      proxy_entry[:http_service][:port] == port &&
-                      proxy_entry[:http_service][:protocol] == protocol &&
-                      proxy_entry[:request] == entry[:request]
+              # modifications to the request to further probe for vulnerabilities _quickly_.
+              case type
+              when :sitemap
+                proxy_history = get_proxy_history(burp_obj: burp_obj)
+                sitemap = get_sitemap(burp_obj: burp_obj)
+                sitemap.each do |entry|
+                  next unless entry.key?(:comment) && entry[:comment].to_s.strip.empty?
+
+                  request = entry[:request]
+                  response = entry[:response]
+                  host = entry[:http_service][:host]
+                  port = entry[:http_service][:port]
+                  protocol = entry[:http_service][:protocol]
+                  next if request.nil? || response.nil? || host.nil? || port.nil? || protocol.nil?
+
+                  proxy_history_entry = nil
+                  if proxy_history.any?
+                    proxy_history_entry = proxy_history.find do |proxy_entry|
+                      next unless proxy_entry.key?(:http_service) && proxy_entry.key?(:request)
+
+                      proxy_entry[:http_service][:host] == host &&
+                        proxy_entry[:http_service][:port] == port &&
+                        proxy_entry[:http_service][:protocol] == protocol &&
+                        proxy_entry[:request] == entry[:request]
+                    end
                   end
-                end
 
-                if proxy_history_entry.is_a?(Hash) && proxy_history_entry[:comment].length.positive?
-                  entry[:comment] = proxy_history_entry[:comment]
-                  entry[:highlight] = proxy_history_entry[:highlight]
-                else
-                  request = Base64.strict_decode64(request)
-                  response = Base64.strict_decode64(response)
-                  http_request_response = PWN::Plugins::Char.force_utf8("#{request}\r\n\r\n#{response}")
-                  ai_analysis = PWN::AI::Introspection.reflect_on(
-                    system_role_content: system_role_content,
-                    request: http_request_response,
-                    suppress_pii_warning: true
+                  if proxy_history_entry.is_a?(Hash) && proxy_history_entry[:comment].length.positive?
+                    entry[:comment] = proxy_history_entry[:comment]
+                    entry[:highlight] = proxy_history_entry[:highlight]
+                  else
+                    request = Base64.strict_decode64(request)
+                    response = Base64.strict_decode64(response)
+                    http_request_response = PWN::Plugins::Char.force_utf8("#{request}\r\n\r\n#{response}")
+                    ai_analysis = PWN::AI::Introspection.reflect_on(
+                      system_role_content: system_role_content,
+                      request: http_request_response,
+                      suppress_pii_warning: true
+                    )
+
+                    next if ai_analysis.nil? || ai_analysis.strip.empty?
+
+                    entry[:comment] = ai_analysis
+                    entry[:highlight] = get_highlight_color.call(ai_analysis: ai_analysis)
+                  end
+
+                  update_sitemap(
+                    burp_obj: burp_obj,
+                    entry: entry
                   )
+                end
 
-                  next if ai_analysis.nil? || ai_analysis.strip.empty?
+              when :proxy_history
+                sitemap = get_sitemap(burp_obj: burp_obj)
+                proxy_history = get_proxy_history(burp_obj: burp_obj)
+                proxy_history.each do |entry|
+                  next unless entry.key?(:comment) && entry[:comment].to_s.strip.empty?
+
+                  request = entry[:request]
+                  response = entry[:response]
+                  host = entry[:http_service][:host]
+                  port = entry[:http_service][:port]
+                  protocol = entry[:http_service][:protocol]
+                  next if request.nil? || response.nil? || host.nil? || port.nil? || protocol.nil?
+
+                  # If sitemap comment and highlight color exists, use that instead of re-analyzing
+                  sitemap_entry = nil
+                  if sitemap.any?
+                    sitemap_entry = sitemap.find do |site|
+                      next unless site.key?(:http_service) && site.key?(:request)
+
+                      site[:http_service][:host] == host &&
+                        site[:http_service][:port] == port &&
+                        site[:http_service][:protocol] == protocol &&
+                        site[:request] == entry[:request]
+                    end
+                  end
 
-                  entry[:comment] = ai_analysis
-                  entry[:highlight] = get_highlight_color.call(ai_analysis: ai_analysis)
-                end
+                  if sitemap_entry.is_a?(Hash) && sitemap_entry[:comment].length.positive?
+                    entry[:comment] = sitemap_entry[:comment]
+                    entry[:highlight] = sitemap_entry[:highlight]
+                  else
+                    request = Base64.strict_decode64(request)
+                    response = Base64.strict_decode64(response)
 
-                update_sitemap(
-                  burp_obj: burp_obj,
-                  entry: entry
-                )
-              end
+                    http_request_response = PWN::Plugins::Char.force_utf8("#{request}\r\n\r\n#{response}")
+                    ai_analysis = PWN::AI::Introspection.reflect_on(
+                      system_role_content: system_role_content,
+                      request: http_request_response,
+                      suppress_pii_warning: true
+                    )
 
-              proxy_history = get_proxy_history(burp_obj: burp_obj)
-              proxy_history.each do |entry|
-                next unless entry.key?(:comment) && entry[:comment].to_s.strip.empty?
-
-                request = entry[:request]
-                response = entry[:response]
-                host = entry[:http_service][:host]
-                port = entry[:http_service][:port]
-                protocol = entry[:http_service][:protocol]
-                next if request.nil? || response.nil? || host.nil? || port.nil? || protocol.nil?
-
-                # If sitemap comment and highlight color exists, use that instead of re-analyzing
-                sitemap_entry = nil
-                if sitemap.any?
-                  sitemap_entry = sitemap.find do |site|
-                    next unless site.key?(:http_service) && site.key?(:request)
-
-                    site[:http_service][:host] == host &&
-                      site[:http_service][:port] == port &&
-                      site[:http_service][:protocol] == protocol &&
-                      site[:request] == entry[:request]
+                    next if ai_analysis.nil? || ai_analysis.strip.empty?
+
+                    entry[:comment] = ai_analysis
+                    entry[:highlight] = get_highlight_color.call(ai_analysis: ai_analysis)
                   end
+
+                  update_proxy_history(
+                    burp_obj: burp_obj,
+                    entry: entry
+                  )
                 end
 
-                if sitemap_entry.is_a?(Hash) && sitemap_entry[:comment].length.positive?
-                  entry[:comment] = sitemap_entry[:comment]
-                  entry[:highlight] = sitemap_entry[:highlight]
-                else
-                  request = Base64.strict_decode64(request)
-                  response = Base64.strict_decode64(response)
+              when :websocket_history
+                websocket_history = get_websocket_history(burp_obj: burp_obj)
+                websocket_history.each do |entry|
+                  next unless entry.key?(:comment) && entry[:comment].to_s.strip.empty?
 
-                  http_request_response = PWN::Plugins::Char.force_utf8("#{request}\r\n\r\n#{response}")
+                  web_socket_id = entry[:web_socket_id]
+                  direction = entry[:direction]
+                  payload = entry[:payload]
+                  next if web_socket_id.nil? || direction.nil? || payload.nil?
+
+                  payload = Base64.strict_decode64(payload)
+                  websocket_req = PWN::Plugins::Char.force_utf8("WebSocket ID: #{web_socket_id}\nDirection: #{direction}\nPayload:\n#{payload}")
                   ai_analysis = PWN::AI::Introspection.reflect_on(
                     system_role_content: system_role_content,
-                    request: http_request_response,
+                    request: websocket_req,
                     suppress_pii_warning: true
                   )
 
@@ -215,17 +253,18 @@ module PWN
 
                   entry[:comment] = ai_analysis
                   entry[:highlight] = get_highlight_color.call(ai_analysis: ai_analysis)
-                end
 
-                update_proxy_history(
-                  burp_obj: burp_obj,
-                  entry: entry
-                )
+                  update_websocket_history(
+                    burp_obj: burp_obj,
+                    entry: entry
+                  )
+                end
               end
-              sleep 3
+
+              sleep Random.rand(30..60)
             end
           rescue Errno::ECONNREFUSED
-            puts 'Thread Terminating...'
+            puts 'BurpSuite AI Introspection Thread >>> Terminating API Calls...'
           rescue StandardError => e
             puts "BurpSuite AI Introspection Thread Error: #{e}"
             puts e.backtrace
@@ -234,7 +273,7 @@ module PWN
             puts 'BurpSuite AI Introspection Thread >>> Goodbye.'
           end
 
-          burp_obj[:introspection_thread] = introspection_thread
+          burp_obj[:introspection_threads] = introspection_thread_arr.push(introspection_thread)
         end
 
         burp_obj
@@ -323,7 +362,9 @@ module PWN
           enabled: true
         )
 
-        init_introspection_thread(burp_obj: burp_obj)
+        burp_obj = init_introspection_thread(burp_obj: burp_obj, type: :sitemap)
+        burp_obj = init_introspection_thread(burp_obj: burp_obj, type: :proxy_history)
+        init_introspection_thread(burp_obj: burp_obj, type: :websocket_history)
       rescue StandardError => e
         stop(burp_obj: burp_obj) unless burp_obj.nil?
         raise e
@@ -586,7 +627,7 @@ module PWN
         keyword = opts[:keyword]
         return_as = opts[:return_as] ||= :base64
 
-        rest_call = "http://#{mitm_rest_api}/proxyhistory"
+        rest_call = "http://#{mitm_rest_api}/proxy/history"
 
         sitemap = rest_browser.get(
           rest_call,
@@ -780,7 +821,78 @@ module PWN
         put_body = entry.to_json
 
         proxy_history_resp = rest_browser.put(
-          "http://#{mitm_rest_api}/proxyhistory/#{id}",
+          "http://#{mitm_rest_api}/proxy/history/#{id}",
+          put_body,
+          content_type: 'application/json; charset=UTF8'
+        )
+
+        JSON.parse(proxy_history_resp, symbolize_names: true)
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # json_web_socket_history = PWN::Plugins::BurpSuite.get_websocket_history(
+      #   burp_obj: 'required - burp_obj returned by #start method',
+      #   keyword: 'optional - keyword to filter websocket history entries (default: nil)'
+      # )
+
+      public_class_method def self.get_websocket_history(opts = {})
+        burp_obj = opts[:burp_obj]
+        rest_browser = burp_obj[:rest_browser]
+        mitm_rest_api = burp_obj[:mitm_rest_api]
+        keyword = opts[:keyword]
+
+        rest_call = "http://#{mitm_rest_api}/websocket/history"
+
+        sitemap = rest_browser.get(
+          rest_call,
+          content_type: 'application/json; charset=UTF8'
+        )
+
+        sitemap_arr = JSON.parse(sitemap, symbolize_names: true)
+
+        if keyword
+          sitemap_arr = sitemap_arr.select do |site|
+            decoded_request = Base64.strict_decode64(site[:request])
+            decoded_request.include?(keyword)
+          end
+        end
+
+        sitemap_arr.uniq
+      rescue StandardError => e
+        stop(burp_obj: burp_obj) unless burp_obj.nil?
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # json_proxy_history = PWN::Plugins::BurpSuite.update_proxy_history(
+      #   burp_obj: 'required - burp_obj returned by #start method',
+      #   entry: 'required - hash of the websocket history entry to update'
+      # )
+
+      public_class_method def self.update_websocket_history(opts = {})
+        burp_obj = opts[:burp_obj]
+        raise 'ERROR: burp_obj parameter is required' unless burp_obj.is_a?(Hash)
+
+        entry = opts[:entry]
+        raise 'ERROR: entry parameter is required and must be a hash' unless entry.is_a?(Hash)
+
+        id = entry[:id]
+        raise 'ERROR: id key value pair is required within entry hash' if id.nil?
+
+        rest_browser = burp_obj[:rest_browser]
+        mitm_rest_api = burp_obj[:mitm_rest_api]
+
+        # Only allow updating of comment and highlight fields
+        entry.delete(:web_socket_id)
+        entry.delete(:direction)
+        entry.delete(:payload)
+
+        put_body = entry.to_json
+
+        proxy_history_resp = rest_browser.put(
+          "http://#{mitm_rest_api}/websocket/history/#{id}",
           put_body,
           content_type: 'application/json; charset=UTF8'
         )
@@ -1894,8 +2006,9 @@ module PWN
         browser_obj = burp_obj[:mitm_browser]
         rest_browser = burp_obj[:rest_browser]
         mitm_rest_api = burp_obj[:mitm_rest_api]
-        introspection_thread = burp_obj[:introspection_thread]
-        introspection_thread.kill unless introspection_thread.nil?
+        introspection_thread_arr = burp_obj[:introspection_threads]
+        introspection_thread_arr.each(&:kill) if introspection_thread_arr.is_a?(Array) && introspection_thread_arr.any?
+        # introspection_thread.kill unless introspection_thread.nil?
 
         PWN::Plugins::TransparentBrowser.close(browser_obj: browser_obj)
         rest_browser.post("http://#{mitm_rest_api}/shutdown", '')
@@ -1981,6 +2094,16 @@ module PWN
             entry: 'required - proxy history entry hash to update'
           )
 
+          json_proxy_history = #{self}.get_websocket_history(
+            burp_obj: 'required - burp_obj returned by #start method',
+            keyword: 'optional - keyword to filter websocket history results (default: nil)'
+          )
+
+          json_proxy_history = #{self}.update_websocket_history(
+            burp_obj: 'required - burp_obj returned by #start method',
+            entry: 'required - websocket history entry hash to update'
+          )
+
           json_sitemap = #{self}.get_sitemap(
             burp_obj: 'required - burp_obj returned by #start method',
             keyword: 'optional - keyword to filter sitemap results (default: nil)',

data/lib/pwn/version.rb

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

data/third_party/pwn_rdoc.jsonl

@@ -1,15 +1,15 @@
 {"messages":[{"role":"user","content":"PWN.help Usage"},{"role":"assistant","content":"`PWN.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI.help Usage"},{"role":"assistant","content":"`PWN::AI.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.authors Usage"},{"role":"assistant","content":"`PWN::AI::Grok.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Grok.chat Usage"},{"role":"assistant","content":"`PWN::AI::Grok.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Grok.chat(\n\nrequest: 'required - message to ChatGPT'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:grok][:model])',\ntemp: 'optional - creative response float (deafults to PWN::Env[:ai][:grok][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:grok][: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::Grok.chat Usage"},{"role":"assistant","content":"`PWN::AI::Grok.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Grok.chat(\n\nrequest: 'required - message to Grok'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:grok][:model])',\ntemp: 'optional - creative response float (deafults to PWN::Env[:ai][:grok][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:grok][: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::Grok.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Grok.get_models`: Supported Method Parameters\n\nmodels = PWN::AI::Grok.get_models\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.grok_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Grok.grok_rest_call`: Supported Method Parameters\n\ngrok_ai_rest_call(\n\ntoken: 'required - grok_ai bearer token',\nhttp_method: 'optional HTTP method (defaults to GET)\nbase_uri: 'optional base grok api URI (defaults to https://api.x.ai/v1)',\nrest_call: 'required rest call to make per the schema',\nparams: 'optional params passed in the URI or HTTP Headers',\nhttp_body: 'optional HTTP body sent in HTTP methods that support it e.g. POST',\ntimeout: 'optional timeout in seconds (defaults to 180)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
 {"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_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',\nspinner: 'optional - Boolean - Display spinner during operation (default: false)'\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',\nspinner: 'optional - Boolean - Display spinner during operation (default: false)',\nsuppress_pii_warning: 'optional - Boolean - Suppress PII Warnings (default: false)'\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.chat Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.chat(\n\nrequest: 'required - message to Ollama'\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"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.help Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.ollama_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.ollama_rest_call`: Supported Method Parameters\n\nollama_rest_call(\n\nbase_uri: 'required - base URI for the Ollama API',\ntoken: 'required - ollama bearer token',\nhttp_method: 'optional HTTP method (defaults to GET)\nrest_call: 'required rest call to make per the schema',\nparams: 'optional params passed in the URI or HTTP Headers',\nhttp_body: 'optional HTTP body sent in HTTP methods that support it e.g. POST',\ntimeout: 'optional timeout in seconds (defaults to 300)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
@@ -562,6 +562,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.format_uri_from_sitemap_resp Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.format_uri_from_sitemap_resp`: Supported Method Parameters\n\nuri = PWN::Plugins::BurpSuite.format_uri_from_sitemap_resp(\n\nscheme: 'required - scheme of the URI (http|https)',\nhost: 'required - host of the URI',\nport: 'optional - port of the URI',\npath: 'optional - path of the URI',\nquery: 'optional - query string of the URI'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.generate_scan_report Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.generate_scan_report`: Supported Method Parameters\n\nPWN::Plugins::BurpSuite.generate_scan_report(\n\nburp_obj: 'required - burp_obj returned by #start method',\ntarget_url: 'required - target_url passed to #active_scan method',\noutput_dir: 'required - directory to save the report',\nreport_type: required - <:html|:xml>'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.get_all_repeater_tabs Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.get_all_repeater_tabs`: Supported Method Parameters\n\nrepeater_tabs = PWN::Plugins::BurpSuite.get_all_repeater_tabs(\n\nburp_obj: 'required - burp_obj returned by #start method'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.get_proxy_history Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.get_proxy_history`: Supported Method Parameters\n\njson_proxy_history = PWN::Plugins::BurpSuite.get_proxy_history(\n\nburp_obj: 'required - burp_obj returned by #start method',\nkeyword: 'optional - keyword to filter proxy history entries (default: nil)',\nreturn_as: 'optional - :base64 or :har (defaults to :base64)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.get_proxy_listeners Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.get_proxy_listeners`: Supported Method Parameters\n\njson_proxy_listeners = PWN::Plugins::BurpSuite.get_proxy_listeners(\n\nburp_obj: 'required - burp_obj returned by #start method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.get_repeater_tab Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.get_repeater_tab`: Supported Method Parameters\n\nrepeater_tab = PWN::Plugins::BurpSuite.get_repeater_tab(\n\nburp_obj: 'required - burp_obj returned by #start method',\nid: 'required - id of the repeater tab to get'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.get_scan_issues Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.get_scan_issues`: Supported Method Parameters\n\njson_scan_issues = PWN::Plugins::BurpSuite.get_scan_issues(\n\nburp_obj: 'required - burp_obj returned by #start method'\n\n)\n"}]}
@@ -569,13 +570,16 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.help Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.import_openapi_to_sitemap Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.import_openapi_to_sitemap`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.in_scope Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.in_scope`: Supported Method Parameters\n\nuri_in_scope = PWN::Plugins::BurpSuite.in_scope(\n\nburp_obj: 'required - burp_obj returned by #start method',\nuri: 'required - URI to determine if in scope'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.init_introspection_thread Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.init_introspection_thread`: Supported Method Parameters\n\nburp_obj = PWN::Plugins::BurpSuite.init_introspection_thread(\n\nburp_obj: 'required - burp_obj returned by #start method',\nenumerable_array: 'required - array of items to process in the thread'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.send_repeater_request Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.send_repeater_request`: Supported Method Parameters\n\nrepeater_resp = PWN::Plugins::BurpSuite.send_repeater_request(\n\nburp_obj: 'required - burp_obj returned by #start method',\nid: 'required - id of the repeater tab to send'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.spider Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.spider`: Supported Method Parameters\n\njson_spider = PWN::Plugins::BurpSuite.spider(\n\nburp_obj: 'required - burp_obj returned by #start method',\ntarget_url: 'required - target url to add to crawl / spider'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.start Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.start`: Supported Method Parameters\n\nburp_obj1 = PWN::Plugins::BurpSuite.start(\n\nburp_jar_path: 'optional - path of burp suite pro jar file (defaults to /opt/burpsuite/burpsuite_pro.jar)',\nheadless: 'optional - run burp headless if set to true',\nbrowser_type: 'optional - defaults to :firefox. See PWN::Plugins::TransparentBrowser.help for a list of types',\nburp_ip: 'optional - IP address for the Burp proxy (defaults to 127.0.0.1)',\nburp_port: 'optional - port for the Burp proxy (defaults to a random unused port)',\npwn_burp_ip: 'optional - IP address for the PWN Burp API (defaults to 127.0.0.1)',\npwn_burp_port: 'optional - port for the PWN Burp API (defaults to a random unused port)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.stop Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.stop`: Supported Method Parameters\n\nPWN::Plugins::BurpSuite.stop(\n\nburp_obj: 'required - burp_obj returned by #start method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.update_burp_jar Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.update_burp_jar`: Supported Method Parameters\n\nPWN::Plugins::BurpSuite.update_burp_jar( )\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.update_proxy_history Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.update_proxy_history`: Supported Method Parameters\n\njson_proxy_history = PWN::Plugins::BurpSuite.update_proxy_history(\n\nburp_obj: 'required - burp_obj returned by #start method',\nentry: 'required - hash of the proxy history entry to update'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.update_proxy_listener Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.update_proxy_listener`: Supported Method Parameters\n\njson_proxy_listener = PWN::Plugins::BurpSuite.update_proxy_listener(\n\nburp_obj: 'required - burp_obj returned by #start method',\nid: 'optional - ID of the proxy listener (defaults to 0)',\nbindAddress: 'optional - bind address for the proxy listener (defaults to value of existing listener)',\nport: 'optional - port for the proxy listener (defaults to value of existing listener)',\nenabled: 'optional - enable or disable the listener (defaults to value of existing listener)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.update_repeater_tab Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.update_repeater_tab`: Supported Method Parameters\n\nrepeater_obj = PWN::Plugins::BurpSuite.update_repeater_tab(\n\nburp_obj: 'required - burp_obj returned by #start method',\nid: 'required - id of the repeater tab to update',\nname: 'required - name of the repeater tab (max 30 characters)',\nrequest: 'required - base64 encoded HTTP request string'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::BurpSuite.update_sitemap Usage"},{"role":"assistant","content":"`PWN::Plugins::BurpSuite.update_sitemap`: Supported Method Parameters\n\njson_sitemap = PWN::Plugins::BurpSuite.update_sitemap(\n\nburp_obj: 'required - burp_obj returned by #start method',\nentry: 'required - hash of the sitemap entry to update'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BusPirate.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::BusPirate.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BusPirate.connect Usage"},{"role":"assistant","content":"`PWN::Plugins::BusPirate.connect`: Supported Method Parameters\n\nbus_pirate_obj = PWN::Plugins::BusPirate.connect(\n\nblock_dev: 'optional serial block device path (defaults to /dev/ttyUSB0)',\nbaud: 'optional (defaults to 9600)',\ndata_bits: 'optional (defaults to 8)',\nstop_bits: 'optional (defaults to 1)',\nparity: 'optional (defaults to SerialPort::NONE)',\nflow_control: 'optional (defaults to SerialPort::HARD) SerialPort::NONE|SerialPort::SOFT|SerialPort::HARD'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::BusPirate.connect_via_screen Usage"},{"role":"assistant","content":"`PWN::Plugins::BusPirate.connect_via_screen`: Supported Method Parameters\n\nPWN::Plugins::BusPirate.connect_via_screen(\n\nblock_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)'\n\n)\n"}]}
@@ -594,6 +598,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.cyrillic_supplement Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.cyrillic_supplement`: Supported Method Parameters\n\nPWN::Plugins::Char.cyrillic_supplement\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.diacritical_marks Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.diacritical_marks`: Supported Method Parameters\n\nPWN::Plugins::Char.diacritical_marks\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.dingbats Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.dingbats`: Supported Method Parameters\n\nPWN::Plugins::Char.dingbats\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Char.force_utf8 Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.force_utf8`: Supported Method Parameters\n\nPWN::Plugins::Char.force_utf8(\n\nobj: 'required - object to force to UTF-8'\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.generate_by_range Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.generate_by_range`: Supported Method Parameters\n\nPWN::Plugins::Char.generate_by_range(\n\nfrom: 'required - integer to start from',\nto: 'required - integer to end UTF-8 generation'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.generate_encoded_files Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.generate_encoded_files`: Supported Method Parameters\n\nPWN::Plugins::Char.generate_encoded_files(\n\nfrom: 'required - integer to start from',\nto: 'required - integer to end UTF-8 generation',\noutput_dir: 'required - folder to create files'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Char.geometric_shapes Usage"},{"role":"assistant","content":"`PWN::Plugins::Char.geometric_shapes`: Supported Method Parameters\n\nPWN::Plugins::Char.geometric_shapes\n"}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.503
+  version: 0.5.505
 platform: ruby
 authors:
 - 0day Inc.
@@ -995,14 +995,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.7.0
+        version: 3.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.7.0
+        version: 3.8.0
 - !ruby/object:Gem::Dependency
   name: ruby-audio
   requirement: !ruby/object:Gem::Requirement