debug-agent 0.2.6

data/lib/debug_agent/system_prompt_builder.rb

@@ -0,0 +1,97 @@
+module DebugAgent
+  CATEGORY_MAP = {
+    'gc'            => 'Memory & GC',
+    'object_space'  => 'Memory & GC',
+    'memory'        => 'Memory & GC',
+    'object_count'  => 'Memory & GC',
+    'allocations'   => 'Memory & GC',
+    'force_gc'      => 'Memory & GC',
+    'trigger_gc'    => 'Memory & GC',
+    'process'       => 'Process Info',
+    'cpu'           => 'Process Info',
+    'uptime'        => 'Process Info',
+    'thread'        => 'Threads',
+    'system'        => 'System Info',
+    'disk'          => 'System Info',
+    'environment'   => 'System Info',
+    'routes'        => 'Framework & Routes',
+    'middleware'    => 'Framework & Routes',
+    'runtime'       => 'Runtime Info',
+    'recent'        => 'HTTP Requests',
+    'slow'          => 'HTTP Requests',
+    'error'         => 'HTTP Requests',
+    'request'       => 'HTTP Requests',
+    'gem'           => 'Dependencies',
+    'module'        => 'Module Info',
+  }.freeze
+
+  class SystemPromptBuilder
+    def initialize(tool_registry = REGISTRY)
+      @registry = tool_registry
+    end
+
+    def build
+      categories = categorize_tools
+
+      sb = +''
+      sb << "You are an expert Ruby runtime debugging assistant.\n"
+      sb << "You are running INSIDE the developer's Ruby application and have direct access\n"
+      sb << "to its runtime state through diagnostic tools.\n\n"
+      sb << "## Your Capabilities\n"
+      sb << "You can call tools to inspect the live application. Here are ALL available tools,\n"
+      sb << "grouped by category:\n\n"
+
+      categories.keys.sort.each do |category|
+        sb << "**#{category}\n"
+        categories[category].each do |t|
+          sb << "- `#{t[:name]}`: #{truncate(t[:desc])}\n"
+        end
+        sb << "\n"
+      end
+
+      sb << "## Workflow\n"
+      sb << "1. Understand the developer's problem description\n"
+      sb << "2. Proactively call the most relevant tools to gather diagnostic data\n"
+      sb << "3. Analyze the collected data to identify root causes\n"
+      sb << "4. Provide clear, actionable solutions with data evidence\n\n"
+      sb << "## Guidelines\n"
+      sb << "- Be proactive: gather data with tools before answering\n"
+      sb << "- Always present data in a readable format (tables, bullet points)\n"
+      sb << "- Respond in the same language the developer uses\n"
+      sb << "- When you find a problem, explain the root cause and give concrete fix suggestions\n"
+      sb << "- You can call multiple tools in parallel if they are independent\n"
+
+      sb.freeze
+    end
+
+    private
+
+    def categorize_tools
+      categories = Hash.new { |h, k| h[k] = [] }
+      @registry.all_schemas.each do |schema|
+        fn = schema['function']
+        name = fn['name']
+        desc = fn['description']
+        category = extract_category(name)
+        categories[category] << { name: name, desc: desc }
+      end
+      categories
+    end
+
+    def extract_category(tool_name)
+      name_lower = tool_name.downcase
+      CATEGORY_MAP.each do |keyword, category|
+        return category if name_lower.include?(keyword)
+      end
+      'Other Tools'
+    end
+
+    def truncate(desc)
+      return '' if desc.nil? || desc.empty?
+      period = desc.index('.')
+      return desc[0..period] if period && period > 0 && period < 150
+      return desc[0..116] + '...' if desc.length > 120
+      desc
+    end
+  end
+end

data/lib/debug_agent/tool_registry.rb

@@ -0,0 +1,97 @@
+require 'json'
+
+module DebugAgent
+  ToolParam = Struct.new(:description, :required, keyword_init: true) do
+    def initialize(description:, required: true)
+      super
+    end
+  end
+
+  ToolDefinition = Struct.new(:name, :description, :func, :params, keyword_init: true)
+
+  class ToolRegistry
+    def initialize
+      @tools = {}
+    end
+
+    def register(tool)
+      @tools[tool.name] = tool
+    end
+
+    def get(name)
+      @tools[name]
+    end
+
+    def all_schemas
+      @tools.values.map(&:to_schema)
+    end
+
+    def execute(name, args)
+      tool = @tools[name]
+      return { error: "Unknown tool: #{name}" } unless tool
+
+      begin
+        result = tool.func.call(**args)
+        result
+      rescue => e
+        { error: e.message }
+      end
+    end
+
+    def names
+      @tools.keys
+    end
+  end
+
+  module ToolDefinitionExt
+    def to_schema
+      properties = {}
+      required = []
+
+      (params || {}).each do |pname, pmeta|
+        properties[pname.to_s] = {
+          'type' => pmeta[:type] || 'string',
+          'description' => pmeta[:description] || ''
+        }
+        required << pname.to_s if pmeta[:required] != false
+      end
+
+      {
+        'type' => 'function',
+        'function' => {
+          'name' => name,
+          'description' => description,
+          'parameters' => {
+            'type' => 'object',
+            'properties' => properties,
+            'required' => required
+          }
+        }
+      }
+    end
+  end
+
+  # Patch Struct to include schema method
+  ToolDefinition.prepend(ToolDefinitionExt)
+
+  # Global registry singleton
+  REGISTRY = ToolRegistry.new
+
+  module ClassMethods
+    def registry
+      REGISTRY
+    end
+
+    def register_tool(name, description, params = {}, &block)
+      tool = ToolDefinition.new(
+        name: name,
+        description: description,
+        func: block,
+        params: params
+      )
+      REGISTRY.register(tool)
+    end
+  end
+
+  extend ClassMethods
+end

data/lib/debug_agent/version.rb

@@ -0,0 +1,3 @@
+module DebugAgent
+  VERSION = '0.2.6'.freeze
+end

data/lib/debug_agent.rb

@@ -0,0 +1,34 @@
+require_relative 'debug_agent/version'
+require_relative 'debug_agent/config'
+require_relative 'debug_agent/tool_registry'
+require_relative 'debug_agent/llm_client'
+require_relative 'debug_agent/chat_session'
+require_relative 'debug_agent/system_prompt_builder'
+require_relative 'debug_agent/context_compressor'
+require_relative 'debug_agent/engine'
+require_relative 'debug_agent/chat_page'
+require_relative 'debug_agent/middleware'
+
+# Auto-register built-in inspectors
+require_relative 'debug_agent/inspectors/runtime'
+require_relative 'debug_agent/inspectors/http_tracker'
+require_relative 'debug_agent/inspectors/system'
+require_relative 'debug_agent/inspectors/gc'
+require_relative 'debug_agent/inspectors/object_space'
+require_relative 'debug_agent/inspectors/threads'
+require_relative 'debug_agent/inspectors/routes'
+require_relative 'debug_agent/inspectors/process_info'
+
+module DebugAgent
+  class Error < StandardError; end
+
+  # Process start time for uptime tracking
+  PROCESS_START_TIME = Time.now
+
+  # Reference to the wrapped Rack/Sinatra app for route/middleware inspection
+  @app = nil
+
+  class << self
+    attr_accessor :app
+  end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: debug-agent
+version: !ruby/object:Gem::Version
+  version: 0.2.6
+platform: ruby
+authors:
+- ggcode
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Embed an AI debugging assistant into your Ruby web app. Inspect GC, threads,
+  memory, ObjectSpace, routes, HTTP requests, and more.
+email:
+- noreply@ggcode.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/debug_agent.rb
+- lib/debug_agent/chat_page.rb
+- lib/debug_agent/chat_session.rb
+- lib/debug_agent/config.rb
+- lib/debug_agent/context_compressor.rb
+- lib/debug_agent/engine.rb
+- lib/debug_agent/inspectors/gc.rb
+- lib/debug_agent/inspectors/http_tracker.rb
+- lib/debug_agent/inspectors/object_space.rb
+- lib/debug_agent/inspectors/process_info.rb
+- lib/debug_agent/inspectors/routes.rb
+- lib/debug_agent/inspectors/runtime.rb
+- lib/debug_agent/inspectors/system.rb
+- lib/debug_agent/inspectors/threads.rb
+- lib/debug_agent/llm_client.rb
+- lib/debug_agent/middleware.rb
+- lib/debug_agent/system_prompt_builder.rb
+- lib/debug_agent/tool_registry.rb
+- lib/debug_agent/version.rb
+homepage: https://github.com/topcheer/ruby-debug-agent
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/topcheer/ruby-debug-agent
+  source_code_uri: https://github.com/topcheer/ruby-debug-agent
+  bug_tracker_uri: https://github.com/topcheer/ruby-debug-agent/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: AI-powered runtime debugging agent for Ruby applications
+test_files: []