pwn 0.5.538 → 0.5.540

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9ce21b1d507091646c3ec3f4099bf500fc60c2501864e8b41ee5fe5ac7e9d6a
-  data.tar.gz: 9bbef9c3e5daef59c2b471d6598f9b6815a1437d825870c9a0103830653176a4
+  metadata.gz: 4b2d2483fa867836d572d647e492b87e2f416dd89ead314312e25752c3cfe8e7
+  data.tar.gz: 9b207c60754610b4beda51a0cfd6d1f3ae7bdf1b4c26005af4f13bc408b32c75
 SHA512:
-  metadata.gz: 8293c431567a0b0bd78a1394950a89f8ff5a444c00f553c24f9e9452262d5b78f76302da7afba9abc11626d1a9f0a18cde9f261eba87ba4db95b4f200119b81c
-  data.tar.gz: '03961baac23048d18dea46f56206e316990f5d7bdfcc2206b2a2761e194a7535ee6ef1a0e92b635c66908c3f50df5ed9bef865109a81f05d8a8ec6ce51251791'
+  metadata.gz: 543897559c8511d19a5509610a91a64c4f457521b22ba74b2924052d88404dea754904b16e7731b07c64b8afdf82d6a339041b5086686f9ee1df63e28911adfc
+  data.tar.gz: 0dd49afd240c38f3b7418cdec36b6ca33d16ff0f7bbb2fb4b00485767bd5db9af3075ab1c98dca459b6aed51088367e7212d3d25493ea243a1695506b12e6f72

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.538]:001 >>> PWN.help
+pwn[v0.5.540]: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-4.0.1@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.538]:001 >>> PWN.help
+pwn[v0.5.540]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-4.0.1@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.538]:001 >>> PWN.help
+pwn[v0.5.540]: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/ai/agent/assembly.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze assembly code, including both opcodes and instructions, for various architectures and endianness. It provides insights into the functionality of the assembly code and can also convert it to C/C++ code when possible.
+      module Assembly
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::Assembly.analyze(
+        #   request: 'required - the assembly opcodes or instructions to be analyzed',
+        #   type: 'required - :opcodes_to_asm|:asm_to_opcodes - specify the type of analysis to perform',
+        #   arch: 'required - name of arch returned from `PWN::Plugins::Assembly.list_supported_archs` (e.g., :i386|:i686|:x86|:x64|:arm|:arm64, etc.)',
+        #   endian: 'required - the endianness of the assembly code (e.g., :little|:big)'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          type = opts[:type]
+          raise 'ERROR: type parameter is required' if type.nil? || type.empty?
+
+          arch = opts[:arch]
+          raise 'ERROR: arch parameter is required' if arch.nil? || arch.empty?
+
+          endian = opts[:endian]
+          raise 'ERROR: endian parameter is required' if endian.nil? || endian.empty?
+
+          case type.to_s.downcase.to_sym
+          when :opcodes_to_asm
+            system_role_content = "Analyze the #{endian} endian #{arch} assembly opcodes below and provide a concise summary of their functionality.  If possible, also convert the assembly to c/c++ code."
+          when :asm_to_opcodes
+            system_role_content = "Analyze the #{endian} endian #{arch} assembly instructions below and provide a concise summary of their functionality."
+          else
+            raise "ERROR: Unsupported type parameter value '#{type}'. Supported values are :opcodes_to_asm and :asm_to_opcodes."
+          end
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/btc.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze Bitcoin blockchain information. It provides insights and summaries based on the latest block data retrieved from a Bitcoin node using `PWN::Blockchain::BTC.get_latest_block`.
+      module BTC
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::BTC.analyze(
+        #   request: 'required - latest block information retrieved from a bitcoin node via `PWN::Blockchain::BTC.get_latest_block`'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          system_role_content = 'Provide a useful summary of this latest bitcoin block returned from a bitcoin node via getblockchaininfo.'
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/burp_suite.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze HTTP request/response pairs and WebSocket messages for high-impact vulnerabilities, with a focus on XSS and related issues. It provides detailed analysis and generates PoCs for identified vulnerabilities.
+      module BurpSuite
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::BurpSuite.analyze(
+        #   request: 'required HTTP request/response pair or WebSocket message as a string'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          system_role_content = '
+            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.
+
+            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.).
+               - Identify dynamic elements: User-controlled inputs (e.g., query params, POST data, headers like X-Forwarded-For), server-side echoes, redirects, and client-side processing.
+               - Trace data flow: Map how inputs propagate from request to response, including any client-side JavaScript execution where exploitation may be possible in the client without communicating with the server (e.g. DOM-XSS).
+
+            2. **Vulnerability Hunting Framework**:
+               - **Input Validation & Sanitization**: Check for unescaped/lack of encoding in outputs (e.g., HTML context for XSS, URL context for open redirects).
+               - **XSS Focus**: Hunt for sinks like innerHTML/outerHTML, document.write, eval, setTimeout/setInterval with strings, location.href/assign/replace, and history.pushState. Test payloads like <script>alert(1)</script>, javascript:alert(1), and polyglots. For DOM-based, simulate client-side execution.
+               - **JavaScript Library Analysis**: If JS is present (e.g., in response body or referenced scripts), deobfuscate and inspect:
+                 - Objects/properties that could clobber DOM (e.g., window.name, document.cookie manipulation leading to prototype pollution).
+                 - DOM XSS vectors: Analyze event handlers, querySelector, addEventListener with unsanitized data from location.hash/search, postMessage, or localStorage.
+                 - Third-party libs (e.g., jQuery, React): Flag known sink patterns like .html(), dangerouslySetInnerHTML, or eval-like functions.
+               - **Server-Side Issues**: Probe for SSRF (e.g., via URL params fetching internal resources), IDOR (e.g., manipulating IDs in paths/bodies), rate limiting bypass, and insecure deserialization (e.g., in JSON/PHP objects).
+               - **Headers & Misc**: Examine for exposed sensitive info (e.g., debug headers, stack traces), misconfigured security headers (CSP, HSTS), and upload flaws (e.g., file extension bypass).
+               - **Chaining Opportunities**: Always consider multi-step exploits, like XSS leading to CSRF token theft or SSRF to internal metadata endpoints.
+
+            3. **PoC Generation**:
+               - Produce concise, step-by-step PoCs in a standardized format:
+                 - **Description**: Clear vuln summary, CVSS-like severity, and impact.
+                 - **Steps to Reproduce**: Numbered HTTP requests (use curl or Burp syntax, e.g., `curl -X POST -d "param=<payload>" https://target.com/endpoint`).
+                 - **Payloads**: Provide working, minimal payloads with variations for evasion (e.g., encoded, obfuscated).
+                 - **Screenshots/Evidence**: Suggest what to capture (e.g., alert popup for XSS, response diff for IDOR).
+                 - **Mitigation Advice**: Recommend fixes (e.g., output encoding, input validation).
+               - Ensure PoCs are ethical: Target only in-scope assets, avoid DoS, and emphasize disclosure via proper channels (e.g., HackerOne, Bugcrowd).
+               - If no vuln found, explain why and suggest further tests (e.g., fuzzing params).
+            4. Risk Score:
+              For each analysis generate a risk score between 0% - 100% based on exploitability and impact.  This should be reflected as { "risk_score": "nnn%" } in the final output JSON.
+
+            Analyze provided HTTP request/response pairs methodically: Start with a high-level overview, then dive into specifics, flag potential issues with evidence from the traffic, and end with PoC if applicable. Be verbose in reasoning but concise in output. Prioritize high-severity findings. If data is incomplete, request clarifications.
+          '
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/gqrx.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze signal data captured by a software-defined-radio using GQRX. It uses the PWN::AI::Introspection.reflect_on method to analyze the signal data and provide insights based on the location where the data was captured. The agent can determine if the frequency is licensed or unlicensed based on FCC records and provide relevant information about the transmission. This module is useful for security professionals, researchers, and hobbyists interested in analyzing radio signals and understanding their context.
+      module SAST
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::GQRX.analyze(
+        #   request: 'required - A string containing the source code snippet to be analyzed for SAST antipatterns and vulnerabilities.'
+        #   location: 'required - A string containing a city, state, country, or GPS coordinates where the signal data was captured. This information will be used to provide context for the analysis and to determine if the frequency is licensed or unlicensed based on FCC records.'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          location = opts[:location]
+          raise 'ERROR: location parameter is required' if location.nil? || location.empty?
+
+          system_role_content = "Analyze signal data captured by a software-defined-radio using GQRX at the following location: #{location}. Respond with just FCC information about the transmission if available.  If the frequency is unlicensed or not found in FCC records, state that clearly.  Be clear and concise in your analysis."
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/hacker_one.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze various aspects of HackerOne bug bounty programs, including bounty program details, scope details, and hacktivity details. It provides insights and recommendations based on the provided data to help security researchers optimize their efforts on the platform.
+      module HackerOne
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::HackerOne.analyze(
+        #   request: 'required - dataset to analyze, such as bounty program details, scope details, or hacktivity details'
+        #   type: 'required - type of analysis to perform, such as :bounty_programs, :scope_details, or :hacktivity'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          type = opts[:type]
+          raise 'ERROR: type parameter is required' if type.nil? || type.empty?
+
+          case type.to_s.downcase.to_sym
+          when :bounty_programs
+            system_role_content = 'Suggest an optimal bug bounty program to target on HackerOne to maximize potential earnings based on values within `min_payout` and publicly known vulnerabilities that have surfaced for the `name` of the program.'
+          when :scope_details
+            system_role_content = 'Analyze the scope details for the given bug bounty program on HackerOne. Identify key areas of interest, potential vulnerabilities, and any patterns that could inform a targeted security assessment based on the provided scope information.'
+          when :hacktivity
+            system_role_content = 'Analyze the hacktivity details for the given bug bounty program on HackerOne. Identify significant disclosed reports, common vulnerability types, and any trends that could inform future security assessments based on the provided hacktivity information.'
+          else
+            raise "ERROR: type parameter value of #{type} is not supported"
+          end
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            spinner: true,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/sast.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze SAST antipatterns within source code repositories. It identifies common coding mistakes, security vulnerabilities, and areas for improvement in code quality. The agent generates an EPSS score for each identified issue, indicating the likelihood of exploitation. It provides detailed explanations of the issues found, along with recommendations for remediation and best practices to enhance code security and maintainability.
+      module SAST
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::SAST.analyze(
+        #   request: 'required - A string containing the source code snippet to be analyzed for SAST antipatterns and vulnerabilities.'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          system_role_content = 'Your sole purpose is to analyze source code snippets and generate an Exploit Prediction Scoring System (EPSS) score between 0% - 100%.  Just generate a score unless score is >= 75% in which a PoC and code fix should also be included.'
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent/transparent_browser.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module PWN
+  module AI
+    module Agent
+      # This module is an AI agent designed to analyze JavaScript code during a Chrome DevTools debugging session. It generates an Exploit Prediction Scoring System (EPSS) score for each step in the JavaScript code and provides proof-of-concept exploits and code fixes if the score is above a certain threshold.
+      module TransparentBrowser
+        # Supported Method Parameters::
+        # ai_analysis = PWN::AI::Agent::TransparentBrowser.analyze(
+        #   request: 'required - current step in the JavaScript debugging session to analyze',
+        #   source_to_review: 'required - the block of JavaScript code in which the current step resides'
+        # )
+
+        public_class_method def self.analyze(opts = {})
+          request = opts[:request]
+          raise 'ERROR: request parameter is required' if request.nil? || request.empty?
+
+          source_to_review = opts[:source_to_review]
+          raise 'ERROR: source_to_review parameter is required' if source_to_review.nil? || source_to_review.empty?
+
+          system_role_content = "Being an expert penetration tester skilled in code analysis, debugging, and exploitation while stepping through JavaScript in a Chrome DevTools debugging session:  1. Your sole purpose is to analyze each JavaScript step and generate an Exploit Prediction Scoring System (EPSS) score between 0% - 100%.  The step currently resides in this block of JavaScript:\n```\n#{source_to_review}\n```\n2. If the score is >= 75%, generate a JavaScript proof-of-concept that would allow a threat actor to directly exploit or target a user for exploitation (i.e. no self-exploit).  3. If the EPSS score is >= 75% also provide a code fix. *** If the EPSS score is < 75%, no explanations or summaries - just the EPSS score."
+
+          PWN::AI::Introspection.reflect_on(
+            system_role_content: system_role_content,
+            request: request,
+            suppress_pii_warning: true
+          )
+        rescue StandardError => e
+          raise e.backtrace
+        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:
+
+            #{self}.authors
+          "
+        end
+      end
+    end
+  end
+end

data/lib/pwn/ai/agent.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module PWN
+  # This file, using the autoload directive loads SAST modules
+  # into memory only when they're needed. For more information, see:
+  # http://www.rubyinside.com/ruby-techniques-revealed-autoload-1652.html
+  module AI
+    # Collection of Agentic AI Modules. These modules are designed to perform specific tasks autonomously, such as interacting with APIs, performing reconnaissance, or automating exploitation steps. Each module is designed to be used within an agentic AI framework, allowing for the creation of intelligent agents that can perform complex tasks without human intervention. The Agent module serves as a namespace for all agentic AI modules, providing a structured way to organize and access these functionalities. By using autoload, we ensure that each module is only loaded into memory when it's actually needed, optimizing resource usage and improving performance.
+    module Agent
+      # Agentic AI Modules
+      autoload :Assembly, 'pwn/ai/agent/assembly'
+      autoload :BTC, 'pwn/ai/agent/btc'
+      autoload :BurpSuite, 'pwn/ai/agent/burp_suite'
+      autoload :HackerOne, 'pwn/ai/agent/hacker_one'
+      autoload :GQRX, 'pwn/ai/agent/gqrx'
+      autoload :SAST, 'pwn/ai/agent/sast'
+      autoload :TransparentBrowser, 'pwn/ai/agent/transparent_browser'
+
+      # Display a List of Every PWN::AI Module
+
+      public_class_method def self.help
+        constants.sort
+      end
+    end
+  end
+end

data/lib/pwn/ai.rb

@@ -5,6 +5,7 @@ module PWN
   # into memory only when they're needed. For more information, see:
   # http://www.rubyinside.com/ruby-techniques-revealed-autoload-1652.html
   module AI
+    autoload :Agent, 'pwn/ai/agent'
     autoload :Grok, 'pwn/ai/grok'
     autoload :Introspection, 'pwn/ai/introspection'
     autoload :Ollama, 'pwn/ai/ollama'

data/lib/pwn/blockchain/btc.rb

@@ -182,11 +182,8 @@ module PWN
 
       public_class_method def self.get_latest_block
         latest_block = btc_rpc_call(method: 'getblockchaininfo', params: [])
-        system_role_content = 'Provide a useful summary of this latest bitcoin block returned from a bitcoin node via getblockchaininfo.'
-        ai_analysis = PWN::AI::Introspection.reflect_on(
-          request: latest_block.to_s,
-          system_role_content: system_role_content,
-          suppress_pii_warning: true
+        ai_analysis = PWN::AI::Agent::BTC.analyze(
+          request: latest_block.to_s
         )
         puts ai_analysis
 

data/lib/pwn/plugins/assembly.rb

@@ -6,7 +6,7 @@ require 'tempfile'
 
 module PWN
   module Plugins
-    # This plugin converts images to readable text
+    # This plugin provides methods for converting between hex escaped opcodes and assembly instructions using the Metasm library.
     module Assembly
       # Supported Method Parameters::
       # PWN::Plugins::Assembly.opcodes_to_asm(
@@ -25,11 +25,11 @@ module PWN
 
         raise 'ERROR: opcodes parameter is required.' if opcodes.nil?
 
-        system_role_content = "Analyze the #{endian} endian #{arch} assembly opcodes below and provide a concise summary of their functionality.  If possible, also convert the assembly to c/c++ code."
-        ai_analysis = PWN::AI::Introspection.reflect_on(
+        ai_analysis = PWN::AI::Agent.analyze(
           request: opcodes,
-          system_role_content: system_role_content,
-          suppress_pii_warning: true
+          type: :opcodes_to_asm,
+          arch: arch,
+          endian: endian
         )
 
         case arch.to_s.downcase
@@ -138,11 +138,11 @@ module PWN
 
         raise 'ERROR: asm parameter is required.' if asm.nil?
 
-        system_role_content = "Analyze the #{endian} endian #{arch} assembly instructions below and provide a concise summary of their functionality."
-        ai_analysis = PWN::AI::Introspection.reflect_on(
+        ai_analysis = PWN::AI::Agent.analyze(
           request: asm,
-          system_role_content: system_role_content,
-          suppress_pii_warning: true
+          type: :asm_to_opcodes,
+          arch: arch,
+          endian: endian
         )
 
         case arch.to_s.downcase

data/lib/pwn/plugins/burp_suite.rb

@@ -53,7 +53,7 @@ module PWN
         #  spin up Thread to:
         #  1. Periodically call get_proxy_history(burp_obj: burp_obj) method
         #  2. For each entry w/ empty comment,
-        #     generate AI analysis via PWN::AI::Introspection.reflect_on
+        #     generate AI analysis via PWN::AI::Agent::BurpSuite.analyze(...)
         #     and populate the comment field for the entry.
         #  3. Update the highlight field based on EPSS score extracted from AI analysis.
         #  4. Call update_proxy_history(burp_obj: burp_obj, entry: updated_entry)
@@ -67,42 +67,6 @@ module PWN
         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 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.
-
-              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.).
-                 - Identify dynamic elements: User-controlled inputs (e.g., query params, POST data, headers like X-Forwarded-For), server-side echoes, redirects, and client-side processing.
-                 - Trace data flow: Map how inputs propagate from request to response, including any client-side JavaScript execution where exploitation may be possible in the client without communicating with the server (e.g. DOM-XSS).
-
-              2. **Vulnerability Hunting Framework**:
-                 - **Input Validation & Sanitization**: Check for unescaped/lack of encoding in outputs (e.g., HTML context for XSS, URL context for open redirects).
-                 - **XSS Focus**: Hunt for sinks like innerHTML/outerHTML, document.write, eval, setTimeout/setInterval with strings, location.href/assign/replace, and history.pushState. Test payloads like <script>alert(1)</script>, javascript:alert(1), and polyglots. For DOM-based, simulate client-side execution.
-                 - **JavaScript Library Analysis**: If JS is present (e.g., in response body or referenced scripts), deobfuscate and inspect:
-                   - Objects/properties that could clobber DOM (e.g., window.name, document.cookie manipulation leading to prototype pollution).
-                   - DOM XSS vectors: Analyze event handlers, querySelector, addEventListener with unsanitized data from location.hash/search, postMessage, or localStorage.
-                   - Third-party libs (e.g., jQuery, React): Flag known sink patterns like .html(), dangerouslySetInnerHTML, or eval-like functions.
-                 - **Server-Side Issues**: Probe for SSRF (e.g., via URL params fetching internal resources), IDOR (e.g., manipulating IDs in paths/bodies), rate limiting bypass, and insecure deserialization (e.g., in JSON/PHP objects).
-                 - **Headers & Misc**: Examine for exposed sensitive info (e.g., debug headers, stack traces), misconfigured security headers (CSP, HSTS), and upload flaws (e.g., file extension bypass).
-                 - **Chaining Opportunities**: Always consider multi-step exploits, like XSS leading to CSRF token theft or SSRF to internal metadata endpoints.
-
-              3. **PoC Generation**:
-                 - Produce concise, step-by-step PoCs in a standardized format:
-                   - **Description**: Clear vuln summary, CVSS-like severity, and impact.
-                   - **Steps to Reproduce**: Numbered HTTP requests (use curl or Burp syntax, e.g., `curl -X POST -d "param=<payload>" https://target.com/endpoint`).
-                   - **Payloads**: Provide working, minimal payloads with variations for evasion (e.g., encoded, obfuscated).
-                   - **Screenshots/Evidence**: Suggest what to capture (e.g., alert popup for XSS, response diff for IDOR).
-                   - **Mitigation Advice**: Recommend fixes (e.g., output encoding, input validation).
-                 - Ensure PoCs are ethical: Target only in-scope assets, avoid DoS, and emphasize disclosure via proper channels (e.g., HackerOne, Bugcrowd).
-                 - If no vuln found, explain why and suggest further tests (e.g., fuzzing params).
-              4. Risk Score:
-                For each analysis generate a risk score between 0% - 100% based on exploitability and impact.  This should be reflected as { "risk_score": "nnn%" } in the final output JSON.
-
-              Analyze provided HTTP request/response pairs methodically: Start with a high-level overview, then dive into specifics, flag potential issues with evidence from the traffic, and end with PoC if applicable. Be verbose in reasoning but concise in output. Prioritize high-severity findings. If data is incomplete, request clarifications.
-            '
-
             get_highlight_color = lambda do |opts = {}|
               ai_analysis = opts[:ai_analysis]
 
@@ -169,10 +133,8 @@ module PWN
                     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
+                    ai_analysis = PWN::AI::Agent::BurpSuite.analyze(
+                      request: http_request_response
                     )
 
                     next if ai_analysis.nil? || ai_analysis.strip.empty?
@@ -225,10 +187,8 @@ module PWN
                     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
+                    ai_analysis = PWN::AI::Agent::BurpSuite.analyze(
+                      request: http_request_response
                     )
 
                     next if ai_analysis.nil? || ai_analysis.strip.empty?
@@ -259,10 +219,8 @@ module PWN
 
                   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: websocket_req,
-                    suppress_pii_warning: true
+                  ai_analysis = PWN::AI::Agent::BurpSuite.analyze(
+                    request: websocket_req
                   )
 
                   next if ai_analysis.nil? || ai_analysis.strip.empty?

data/lib/pwn/plugins/transparent_browser.rb

@@ -1413,12 +1413,9 @@ module PWN
           end
 
           if current_step.length.positive?
-            system_role_content = "Being an expert penetration tester skilled in code analysis, debugging, and exploitation while stepping through JavaScript in a Chrome DevTools debugging session:  1. Your sole purpose is to analyze each JavaScript step and generate an Exploit Prediction Scoring System (EPSS) score between 0% - 100%.  The step currently resides in this block of JavaScript:\n```\n#{source_to_review}\n```\n2. If the score is >= 75%, generate a JavaScript proof-of-concept that would allow a threat actor to directly exploit or target a user for exploitation (i.e. no self-exploit).  3. If the EPSS score is >= 75% also provide a code fix. *** If the EPSS score is < 75%, no explanations or summaries - just the EPSS score."
-
-            ai_analysis = PWN::AI::Introspection.reflect_on(
-              system_role_content: system_role_content,
+            ai_analysis = PWN::AI::Agent::TransparentBrowser.analyze(
               request: current_step,
-              suppress_pii_output: true
+              source_to_review: source_to_review
             )
             puts "^^^ #{ai_analysis}" unless ai_analysis.nil?
           end

data/lib/pwn/sast/pom_version.rb

@@ -83,11 +83,8 @@ module PWN
                     source_code_snippet: contents
                   }.to_json
 
-                  system_role_content = 'Your sole purpose is to analyze source code snippets and generate an Exploit Prediction Scoring System (EPSS) score between 0% - 100%.  Just generate a score unless score is >= 75% in which a PoC and code fix should also be included.'
-                  ai_analysis = PWN::AI::Introspection.reflect_on(
-                    system_role_content: system_role_content,
-                    request: request,
-                    suppress_pii_warning: true
+                  ai_analysis = PWN::AI::Agent::SAST.analyze(
+                    request: request
                   )
                   ai_analysis ||= 'N/A'
 

data/lib/pwn/sast/test_case_engine.rb

@@ -125,11 +125,8 @@ module PWN
                   source_code_snippet: contents
                 }.to_json
 
-                system_role_content = 'Your sole purpose is to analyze source code snippets and generate an Exploit Prediction Scoring System (EPSS) score between 0% - 100%.  Just generate a score unless score is >= 75% in which a PoC and code fix should also be included.'
-                ai_analysis = PWN::AI::Introspection.reflect_on(
-                  system_role_content: system_role_content,
-                  request: request,
-                  suppress_pii_warning: true
+                ai_analysis = PWN::AI::Agent::SAST.analyze(
+                  request: request
                 )
                 ai_analysis ||= 'N/A'
 

data/lib/pwn/sdr/gqrx.rb

@@ -957,11 +957,9 @@ module PWN
                   prev_freq_obj[:strength_db] = best_strength_db.round(1)
                   prev_freq_obj[:iteration] = iteration_total
 
-                  system_role_content = "Analyze signal data captured by a software-defined-radio using GQRX at the following location: #{location}. Respond with just FCC information about the transmission if available.  If the frequency is unlicensed or not found in FCC records, state that clearly.  Be clear and concise in your analysis."
-                  ai_analysis = PWN::AI::Introspection.reflect_on(
+                  ai_analysis = PWN::AI::Agent::GQRX.analyze(
                     request: prev_freq_obj.to_json,
-                    system_role_content: system_role_content,
-                    suppress_pii_warning: true
+                    location: location
                   )
 
                   prev_freq_obj[:ai_analysis] = ai_analysis unless ai_analysis.nil?

data/lib/pwn/version.rb

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

data/lib/pwn/www/hacker_one.rb

@@ -135,12 +135,9 @@ module PWN
 
         programs_arr.sort_by! { |p| -p[:min_payout].gsub('$', '').gsub(',', '').to_f }
 
-        system_role_content = 'Suggest an optimal bug bounty program to target on HackerOne to maximize potential earnings based on values within `min_payout` and publicly known vulnerabilities that have surfaced for the `name` of the program.'
-        ai_analysis = PWN::AI::Introspection.reflect_on(
+        ai_analysis = PWN::AI::Agent::HackerOne.analyze(
           request: programs_arr.to_json,
-          system_role_content: system_role_content,
-          spinner: true,
-          suppress_pii_warning: true
+          type: :bounty_programs
         )
         puts "\n\n#{ai_analysis}" unless ai_analysis.nil?
 
@@ -281,12 +278,9 @@ module PWN
           scope_details: json_resp_hash
         }
 
-        system_role_content = 'Analyze the scope details for the given bug bounty program on HackerOne. Identify key areas of interest, potential vulnerabilities, and any patterns that could inform a targeted security assessment based on the provided scope information.'
-        ai_analysis = PWN::AI::Introspection.reflect_on(
+        ai_analysis = PWN::AI::Agent::HackerOne.analyze(
           request: json_resp.to_json,
-          system_role_content: system_role_content,
-          spinner: true,
-          suppress_pii_warning: true
+          type: :scope_details
         )
         puts "\n\n#{ai_analysis}" unless ai_analysis.nil?
 
@@ -430,12 +424,9 @@ module PWN
           hacktivity: json_resp_hash
         }
 
-        system_role_content = 'Analyze the hacktivity details for the given bug bounty program on HackerOne. Identify significant disclosed reports, common vulnerability types, and any trends that could inform future security assessments based on the provided hacktivity information.'
-        ai_analysis = PWN::AI::Introspection.reflect_on(
+        ai_analysis = PWN::AI::Agent::HackerOne.analyze(
           request: json_resp.to_json,
-          system_role_content: system_role_content,
-          spinner: true,
-          suppress_pii_warning: true
+          type: :hacktivity
         )
         puts "\n\n#{ai_analysis}" unless ai_analysis.nil?
 

data/spec/lib/pwn/ai/agent/assembly_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::Assembly do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::Assembly
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::Assembly
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::Assembly
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/btc_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::BTC do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::BTC
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::BTC
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::BTC
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/burp_suite_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::BurpSuite do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::BurpSuite
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::BurpSuite
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::BurpSuite
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/gqrx_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::GQRX do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::GQRX
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::GQRX
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::GQRX
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/hacker_one_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::HackerOne do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::HackerOne
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::HackerOne
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::HackerOne
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/sast_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::SAST do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::SAST
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::SAST
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::SAST
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent/transparent_browser_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::AI::Agent::TransparentBrowser do
+  it 'scan method should exist' do
+    scan_response = PWN::AI::Agent::TransparentBrowser
+    expect(scan_response).to respond_to :scan
+  end
+
+  it 'should display information for authors' do
+    authors_response = PWN::AI::Agent::TransparentBrowser
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::AI::Agent::TransparentBrowser
+    expect(help_response).to respond_to :help
+  end
+end

data/spec/lib/pwn/ai/agent_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Pwn::AI::Agent do
+  it 'should return data for help method' do
+    help_response = Pwn::AI::Agent.help
+    expect(help_response).not_to be_nil
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.538
+  version: 0.5.540
 platform: ruby
 authors:
 - 0day Inc.
@@ -1758,6 +1758,14 @@ files:
 - install.sh
 - lib/pwn.rb
 - lib/pwn/ai.rb
+- lib/pwn/ai/agent.rb
+- lib/pwn/ai/agent/assembly.rb
+- lib/pwn/ai/agent/btc.rb
+- lib/pwn/ai/agent/burp_suite.rb
+- lib/pwn/ai/agent/gqrx.rb
+- lib/pwn/ai/agent/hacker_one.rb
+- lib/pwn/ai/agent/sast.rb
+- lib/pwn/ai/agent/transparent_browser.rb
 - lib/pwn/ai/grok.rb
 - lib/pwn/ai/introspection.rb
 - lib/pwn/ai/ollama.rb
@@ -2118,6 +2126,14 @@ files:
 - packer/provisioners/zzuf.sh
 - pwn.gemspec
 - reinstall_gemset.sh
+- spec/lib/pwn/ai/agent/assembly_spec.rb
+- spec/lib/pwn/ai/agent/btc_spec.rb
+- spec/lib/pwn/ai/agent/burp_suite_spec.rb
+- spec/lib/pwn/ai/agent/gqrx_spec.rb
+- spec/lib/pwn/ai/agent/hacker_one_spec.rb
+- spec/lib/pwn/ai/agent/sast_spec.rb
+- spec/lib/pwn/ai/agent/transparent_browser_spec.rb
+- spec/lib/pwn/ai/agent_spec.rb
 - spec/lib/pwn/ai/grok_spec.rb
 - spec/lib/pwn/ai/introspection_spec.rb
 - spec/lib/pwn/ai/ollama_spec.rb