llm_rescuer 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ccbd1c233b14f52a25b9718471106654feecc940a6a5e437307793b1a64d974
-  data.tar.gz: 1a2e08037d1a3acf18e694473b77246a4d67e53269b7b8bfcc03106032c0bdf3
+  metadata.gz: 1b388eff130d25dfb070076b70ec3ddd04d574f779a3ee3139428d0bf82ba918
+  data.tar.gz: d30a3efb6b8e400e0aea0021c23fc7eed0a76a0aa0b5473a0663a4bb10d8248e
 SHA512:
-  metadata.gz: 0a579571e96a250591237dead0cfd33a9f87966a62c24f4707138acf7dd087ed19c3e2362cc973246a7bbf6385289b2df7db6ee757c3b3355d460790db29dfba
-  data.tar.gz: 3f7db8460e977a030c18d3d94e6f82de41449702a2dea95d442099c018256ddb4b11ebf069d66b235e9b7d797e51fbfaeb8a2e358b6ffcf5c82ce4d246a967f2
+  metadata.gz: 52cf7a6343cbece8a25cc822875b0ee183be89dd8db6c001796782a1252f4b036f5bd0c5ad3190690beebaa96eedd28552a56cba1317c7762fb77d603822c13f
+  data.tar.gz: dffdc10bf211d7f34f5f7d3b639882a42a62f41780df11bdf05bddd8b5a07432f306d501d0f4360ff8feee01238ca3f3b1dc4c4cd098084daa491c816d4b095a

data/lib/llm_rescuer/nil_extension.rb

@@ -7,51 +7,66 @@ module LlmRescuer
 
   module NilExtension
     class ResponseSchema < RubyLLM::Schema
-      string :ruby_expression, description: "ruby expression to evaluate to recover from the exception"
-      string :comment, description: "comment about the response"
-      string :error_message, description: "error message from the exception"
+      string :ruby_expression, description: "The heroic ruby expression that will save this program from certain doom"
+      string :comment, description: "Your witty commentary on this rescue mission (be entertaining!)"
+      string :error_message, description: "A friendly explanation of what went wrong (no boring technical jargon!)"
     end
 
     def method_missing(method_name, *args, &block)
-      chat =
-        RubyLLM
-          .chat
-          .with_tool(Tools::ReadSourceCodeTool)
-          .on_tool_call do |tool_call|
-          # Called when the AI decides to use a tool
-          puts "Calling tool: #{tool_call.name}"
-          puts "Arguments: #{tool_call.arguments}"
-        end
-          .on_tool_result do |result|
-          # Called after the tool returns its result
-          puts "Tool returned: #{result}"
-        end
+      chat = RubyLLM
+        .chat
+        .with_tool(Tools::ReadSourceCodeTool)
 
       chat.with_instructions <<~SYSTEM_PROMPT
-        A ruby program is about to crash or test about to fail because the method `#{method_name}` has been called on `nil`.
-        We are trying to determine what the return value of `NilClass.method_missing` should be so the program can resume.
-        You can use the `read_source_code` tool to read the source code of a file.
-        Generate a response with a ruby expression to evaluate.
-
-        Some examples of expression could be:
-        - super if we want to raise the error
-        - `nil` if we want to behave like &.
-        - a boolean
-        - a number
-        - a new instance of a class
-
-        The goal is to help the program to resume successfully with the best possible expression.
-        You need to look at the business logic of the caller to determine the best expression.
+        🚨 EMERGENCY! EMERGENCY! 🚨
+
+        A Ruby program has called `#{method_name}` on `nil` and is about to crash! You are the LLM Rescuer -
+        an AI-powered superhero whose job is to save this program from the dreaded NoMethodError.
+
+        Your mission, should you choose to accept it (and you will, because you're an AI):
+        1. 🕵️ Use the `read_source_code` tool to investigate the crime scene
+        2. 🧠 Channel your inner Sherlock Holmes to deduce what the programmer PROBABLY wanted
+        3. 🎭 Return a ruby expression that will keep this show running
+
+        Remember: You're not just fixing code, you're preventing existential crises! Every nil you rescue
+        is a developer who doesn't have to question their life choices (today).
+
+        Your response should be a ruby expression that makes sense in context. Some heroic examples:
+        - `super` - when you want to let it crash dramatically (sometimes necessary for character development)
+        - `nil` - when you want to be the safe choice (like using &.)
+        - `""` or `[]` or `{}` - when you sense they wanted an empty container
+        - `0` or `false` - when the context screams for these values
+        - A sensible default object - when you're feeling particularly creative
+
+        🎯 Your goal: Keep the program running with the most logical, contextually-appropriate value.
+        Think like a mind-reader, but with better documentation skills!
+
+        Pro tip: The business logic holds the secrets. Read it like the fascinating novel it definitely isn't.
       SYSTEM_PROMPT
 
       filtered_caller = caller.filter { |line| line.start_with?(LlmRescuer.prefix) }.join("\n")
 
       prompt = <<~PROMPT
-        Here is the failing method call:
-        method name: #{method_name}
-        arguments: #{args.inspect}
-        backtrace:
+        🔍 CASE FILE: The Great Nil Mystery of #{Time.now.strftime("%Y")}
+
+        **THE CRIME:**
+        Method `#{method_name}` was called on a nil object! The audacity!
+
+        **THE EVIDENCE:**
+        - Method name: `#{method_name}`
+        - Arguments provided: #{args.inspect}
+        - Witnesses (call stack):
         #{filtered_caller}
+
+        **YOUR MISSION:**
+        Detective AI, please examine the evidence and determine what this nil object
+        SHOULD have been. What would make the most sense in this context?
+
+        Remember: You're not just guessing - you're channeling the collective wisdom
+        of a thousand rubber ducks and the programming intuition of developers who
+        forgot to check for nil (again).
+
+        Return your best guess as a ruby expression that will save the day! 🦸‍♀️
       PROMPT
       response = chat.with_schema(ResponseSchema).ask(prompt)
       eval(response.content["ruby_expression"]) # standard:disable Security/Eval

data/lib/llm_rescuer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmRescuer
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/sig/llm_rescuer.rbs

@@ -1,4 +1,68 @@
+# LLM Rescuer Type Signatures 🤖💰
+# Public API for fixing the billion-dollar mistake, one expensive token at a time
+
 module LlmRescuer
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+
+  # Set the project path prefix to limit AI chaos to your codebase only
+  def self.prefix=: (String path) -> String
+  def self.prefix: () -> String?
+
+  # Unleash AI upon your nil objects (prepare your wallet)
+  def self.setup: () -> void
+end
+
+# After setup, nil gains supernatural AI-powered abilities:
+class NilClass
+  # User-related methods that AI loves to guess about
+  def name: () -> ("Anonymous User" | "John Doe" | "🤖 AI Assistant" | nil)
+  def email: () -> ("no-reply@example.com" | "user@domain.com" | "" | nil)
+  def age: () -> (Integer | nil)
+  def username: () -> ("guest" | "anonymous" | "user123" | nil)
+  def first_name: () -> ("Unknown" | "Anonymous" | "Friend" | nil)
+  def last_name: () -> ("User" | "Person" | "McUserface" | nil)
+
+  # Boolean methods where AI gets philosophical
+  def active?: () -> (bool | "maybe" | "undefined" | nil)
+  def valid?: () -> (bool | "who can say?" | "validation is a construct" | nil)
+  def present?: () -> (false | "technically no" | "philosophically yes" | nil)
+  def admin?: () -> (false | "nice try" | "in your dreams" | nil)
+  def premium?: () -> (false | "upgrade required" | "💰" | nil)
+
+  # Numeric methods where AI shows its creativity
+  def count: () -> (0 | "zero" | "∅" | nil)
+  def length: () -> (0 | "nothing to measure" | Float::INFINITY | nil)
+  def size: () -> (0 | "null-sized" | "undefined" | nil)
+  def balance: () -> (0.0 | 999999.99 | "insufficient_funds" | "💸" | nil)
+  def price: () -> (0.0 | "priceless" | "free" | 3.50 | nil)
+  def total: () -> (0 | "the sum of nothing" | "∑nil" | nil)
+
+  # Collection methods that make AI existential
+  def friends: () -> ([] | ["AI Bot"] | "forever alone" | "404: friends not found" | nil)
+  def items: () -> ([] | "empty cart" | "nothing to see here" | nil)
+  def children: () -> ([] | "childless" | "no offspring" | nil)
+  def tags: () -> ([] | ["untagged"] | "#nil" | nil)
+
+  # String methods where AI gets creative
+  def to_s: () -> ("" | "null" | "undefined" | "¯\\_(ツ)_/¯" | "void")
+  def inspect: () -> ("nil" | "nothing" | "🕳️" | "the absence of being")
+  def title: () -> ("Untitled" | "No Title" | "Title Not Found" | "TBD" | nil)
+  def description: () -> ("No description available" | "..." | "words fail me" | nil)
+  def status: () -> ("unknown" | "undefined" | "404" | "¯\\_(ツ)_/¯" | nil)
+
+  # Time/Date methods where AI shows temporal confusion
+  def created_at: () -> (Time | "time is a construct" | "never" | nil)
+  def updated_at: () -> (Time | "last updated: never" | "时间不存在" | nil)
+  def birthday: () -> (Date | "unborn" | "ageless" | nil)
+
+  # Mood and personality methods
+  def mood: () -> ("confused" | "optimistic" | "💭" | :existential_crisis | "zen" | nil)
+  def personality: () -> ("undefined" | "mysterious" | "null and void" | "🤖" | nil)
+  def vibe: () -> ("absent" | "ethereal" | "404 vibe not found" | "✨" | nil)
+
+  # Action methods that AI finds amusing
+  def save!: () -> (true | "saved to /dev/null" | "cannot save nothing" | "💾" | nil)
+  def delete!: () -> (true | "already deleted" | "you cannot destroy nothing" | nil)
+  def refresh: () -> (self | "refreshed nothingness" | "still nil" | nil)
+  def reload: () -> (self | "reloaded emptiness" | "nil.exe has stopped working" | nil)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_rescuer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Paul Chobert