llm.rb 15.2.2 → 15.4.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 15.2.2
+  version: 15.4.0
 platform: ruby
 authors:
 - Robert Gleeson
@@ -429,6 +429,7 @@ files:
 - lib/llm/active_record.rb
 - lib/llm/active_record/acts_as_agent.rb
 - lib/llm/active_record/acts_as_llm.rb
+- lib/llm/active_record/message.rb
 - lib/llm/agent.rb
 - lib/llm/buffer.rb
 - lib/llm/compactor.rb
@@ -492,7 +493,6 @@ files:
 - lib/llm/function/thread/task.rb
 - lib/llm/function/tracing.rb
 - lib/llm/guard.rb
-- lib/llm/guard/loop.rb
 - lib/llm/guard/null.rb
 - lib/llm/json_adapter.rb
 - lib/llm/mcp.rb
@@ -695,8 +695,8 @@ metadata:
   source_code_uri: https://github.com/r-uby-dev/llm
   documentation_uri: https://r.uby.dev
   changelog_uri: https://github.com/r-uby-dev/llm/blob/main/CHANGELOG.md
-post_install_message: "\nGot a question about llm.rb? \nThe https://r.uby.dev website
-  can help.\n\n"
+post_install_message: "\nWant to see what I'm building with llm.rb? \nCheckout the
+  https://r.uby.dev website.\n\n"
 rdoc_options: []
 require_paths:
 - lib
@@ -711,7 +711,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.20
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Ruby's capable AI runtime
 test_files: []

data/lib/llm/guard/loop.rb

@@ -1,89 +0,0 @@
-# frozen_string_literal: true
-
-class LLM::Guard
-  ##
-  # {LLM::Guard::Loop LLM::Guard::Loop} is the built-in loop-detection
-  # guard. It detects when a context is repeating the same tool-call
-  # pattern instead of making progress, and returns an in-band
-  # {LLM::Function::Return LLM::Function::Return} so {LLM::Context
-  # LLM::Context} can block the pending tool work.
-  class Loop < self
-    ##
-    # The default number of repeated tool-call patterns required before
-    # the guard intervenes.
-    # @return [Integer]
-    DEFAULT_THRESHOLD = 3
-
-    ##
-    # Checks the current context for repeated tool-call patterns.
-    #
-    # This method inspects assistant tool calls only. It reduces each call
-    # to a `[tool_name, arguments]` signature and checks whether the tail
-    # of the sequence is repeating.
-    #
-    # @param [LLM::Function] function
-    #  The pending function being decided about. Only its id and name are
-    #  used to build the return.
-    # @param [Integer] threshold
-    #  How many repeated tool-call patterns must appear at the tail of the
-    #  sequence before the guard returns a warning.
-    # @param [Hash] opts
-    #  Additional per-call options (ignored).
-    # @return [LLM::Function::Return, nil]
-    #  Returns a tool return that blocks this function's pending call, or
-    #  nil when execution should continue.
-    def call(function:, threshold: DEFAULT_THRESHOLD, **opts)
-      repetitions = detect(messages.to_a, threshold)
-      return unless repetitions
-      function.return(error: true, type: "guard_error", message: warning(repetitions))
-    end
-
-    private
-
-    def detect(messages, threshold)
-      signatures = extract_signatures(messages)
-      return if signatures.size < threshold
-      check_repeating_pattern(signatures, threshold)
-    end
-
-    def warning(repetitions)
-      <<~MSG
-        SYSTEM NOTICE: Repeated tool-call pattern detected - the same pattern has repeated #{repetitions} times.
-        You are stuck in a loop and not making progress. Stop and try a fundamentally different approach:
-        - Re-read the relevant context before retrying
-        - Try a different tool or strategy
-        - Break the problem into smaller steps
-        - If a tool keeps failing, investigate why before retrying
-      MSG
-    end
-
-    def extract_signatures(messages)
-      messages
-        .select(&:assistant?)
-        .flat_map { |message| message.functions.map { [_1.name.to_s, _1.arguments.to_h] } }
-    end
-
-    def check_repeating_pattern(sequence, threshold)
-      max_pattern_len = sequence.size / threshold
-      (1..max_pattern_len).each do |pattern_len|
-        count = count_tail_repetitions(sequence, pattern_len)
-        return count if count >= threshold
-      end
-      nil
-    end
-
-    def count_tail_repetitions(sequence, length)
-      return 0 if sequence.size < length
-      pattern = sequence.last(length)
-      count = 1
-      pos = sequence.size - length
-      while pos >= length
-        candidate = sequence[(pos - length)...pos]
-        break unless candidate == pattern
-        count += 1
-        pos -= length
-      end
-      count
-    end
-  end
-end