llm.rb 13.0.0 → 14.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 13.0.0
+  version: 14.0.0
 platform: ruby
 authors:
 - robert
@@ -280,23 +280,26 @@ dependencies:
 description: |
   llm.rb is an advanced runtime for building capable AI applications
   on CRuby. By default it has zero runtime dependencies although certain
-  functionality – such as ActiveRecord support – require
+  functionality (such as ActiveRecord support) require
   optional dependencies that are opt-in.
 email:
 - robert@r.uby.dev
-executables: []
+executables:
+- llm.rb
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- bin/llm.rb
 - data/anthropic.json
 - data/bedrock.json
 - data/deepinfra.json
 - data/deepseek.json
 - data/google.json
 - data/mistral.json
+- data/moonshot.json
 - data/openai.json
 - data/xai.json
 - data/zai.json
@@ -355,8 +358,10 @@ files:
 - lib/llm/function/thread/group.rb
 - 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/loop_guard.rb
 - lib/llm/mcp.rb
 - lib/llm/mcp/command.rb
 - lib/llm/mcp/error.rb
@@ -433,6 +438,7 @@ files:
 - lib/llm/providers/mistral.rb
 - lib/llm/providers/mistral/request_adapter.rb
 - lib/llm/providers/mistral/request_adapter/completion.rb
+- lib/llm/providers/moonshot.rb
 - lib/llm/providers/ollama.rb
 - lib/llm/providers/ollama/error_handler.rb
 - lib/llm/providers/ollama/models.rb
@@ -475,16 +481,20 @@ files:
 - lib/llm/registry.rb
 - lib/llm/repl.rb
 - lib/llm/repl/bar.rb
+- lib/llm/repl/buffer.rb
+- lib/llm/repl/color.rb
 - lib/llm/repl/command.rb
 - lib/llm/repl/commands/compact.rb
 - lib/llm/repl/commands/exit.rb
 - lib/llm/repl/commands/help.rb
 - lib/llm/repl/input.rb
+- lib/llm/repl/input/char.rb
+- lib/llm/repl/input/row.rb
 - lib/llm/repl/markdown.rb
 - lib/llm/repl/markdown/table.rb
+- lib/llm/repl/node.rb
 - lib/llm/repl/status.rb
 - lib/llm/repl/stream.rb
-- lib/llm/repl/transcript.rb
 - lib/llm/repl/walker.rb
 - lib/llm/repl/window.rb
 - lib/llm/response.rb
@@ -517,21 +527,25 @@ files:
 - lib/llm/tool/param.rb
 - lib/llm/tools.rb
 - lib/llm/tools/chdir.rb
+- lib/llm/tools/edit-file.rb
 - lib/llm/tools/git.rb
 - lib/llm/tools/ls.rb
 - lib/llm/tools/mkdir.rb
 - lib/llm/tools/pwd.rb
 - lib/llm/tools/read_file.rb
 - lib/llm/tools/rg.rb
+- lib/llm/tools/ruby.rb
 - lib/llm/tools/shell.rb
-- lib/llm/tools/swap_text.rb
 - lib/llm/tools/utils.rb
 - lib/llm/tools/which.rb
 - lib/llm/tools/write_file.rb
 - lib/llm/tracer.rb
 - lib/llm/tracer/logger.rb
 - lib/llm/tracer/null.rb
+- lib/llm/tracer/pretty_logger.rb
 - lib/llm/tracer/telemetry.rb
+- lib/llm/transformer.rb
+- lib/llm/transformer/null.rb
 - lib/llm/transport.rb
 - lib/llm/transport/curb.rb
 - lib/llm/transport/execution.rb
@@ -552,6 +566,30 @@ files:
 - lib/sequel/plugins/llm.rb
 - llm.gemspec
 - resources/deepdive.md
+- resources/deepdive/advanced/cancellation.md
+- resources/deepdive/advanced/compaction.md
+- resources/deepdive/advanced/context.md
+- resources/deepdive/advanced/guard.md
+- resources/deepdive/advanced/tracer.md
+- resources/deepdive/advanced/transformer.md
+- resources/deepdive/advanced/transports.md
+- resources/deepdive/everything_else/audio.md
+- resources/deepdive/everything_else/cost.md
+- resources/deepdive/everything_else/images.md
+- resources/deepdive/everything_else/object.md
+- resources/deepdive/everything_else/ocr.md
+- resources/deepdive/fundamentals/agents.md
+- resources/deepdive/fundamentals/builtin_tools.md
+- resources/deepdive/fundamentals/concurrency.md
+- resources/deepdive/fundamentals/database.md
+- resources/deepdive/fundamentals/embeddings.md
+- resources/deepdive/fundamentals/repl.md
+- resources/deepdive/fundamentals/schema.md
+- resources/deepdive/fundamentals/skills.md
+- resources/deepdive/fundamentals/stream.md
+- resources/deepdive/fundamentals/tools.md
+- resources/deepdive/protocols/a2a.md
+- resources/deepdive/protocols/mcp.md
 homepage: https://r.uby.dev/llm/
 licenses:
 - MIT
@@ -560,6 +598,11 @@ metadata:
   source_code_uri: https://github.com/r-uby-dev/llm.rb
   documentation_uri: https://r.uby.dev/llm/
   changelog_uri: https://r.uby.dev/api-docs/llm.rb/file.CHANGELOG.html
+post_install_message: |2+
+
+  Learn more about llm.rb by reading the deepdive:
+  https://r.uby.dev/llm/deepdive
+
 rdoc_options: []
 require_paths:
 - lib
@@ -574,7 +617,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Ruby's capable AI runtime
 test_files: []
+...

data/lib/llm/loop_guard.rb

@@ -1,107 +0,0 @@
-# frozen_string_literal: true
-
-##
-# {LLM::LoopGuard LLM::LoopGuard} is the built-in implementation of
-# llm.rb's `guard` capability.
-#
-# A guard is a context-level supervisor for agentic execution. It can inspect
-# the current runtime state and return a warning string when pending tool work
-# should be blocked before the loop keeps going.
-#
-# {LLM::LoopGuard LLM::LoopGuard} detects when a context is repeating the same
-# tool-call pattern instead of making progress.
-#
-# The public interface is intentionally small:
-# - `call(ctx)` returns `nil` when no intervention is needed
-# - `call(ctx)` returns a warning string when pending tool execution should be blocked
-#
-# {LLM::Context LLM::Context} can use that warning to return in-band
-# {LLM::GuardError LLM::GuardError} tool errors, and
-# {LLM::Agent LLM::Agent} enables this guard by default through its wrapped
-# context.
-#
-class LLM::LoopGuard
-  ##
-  # The default number of repeated tool-call patterns required before
-  # the guard intervenes.
-  # @return [Integer]
-  DEFAULT_THRESHOLD = 3
-
-  ##
-  # Returns the repetition threshold.
-  # @return [Integer]
-  attr_reader :threshold
-
-  ##
-  # @param [Hash] config
-  # @option config [Integer] :threshold
-  #  How many repeated tool-call patterns must appear at the tail of the
-  #  sequence before the guard returns a warning.
-  def initialize(config = {})
-    @threshold = config.fetch(:threshold, DEFAULT_THRESHOLD)
-  end
-
-  ##
-  # 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::Context] ctx
-  # @return [String, nil]
-  #  Returns a warning string when pending tool execution should be blocked,
-  #  or `nil` when execution should continue.
-  def call(ctx)
-    repetitions = detect(ctx.messages.to_a)
-    repetitions ? warning(repetitions) : nil
-  end
-
-  private
-
-  def detect(messages)
-    signatures = extract_signatures(messages)
-    return if signatures.size < threshold
-    check_repeating_pattern(signatures)
-  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 { _1.respond_to?(:functions) && _1.assistant? }
-      .flat_map { |message| message.functions.map { [_1.name.to_s, _1.arguments.to_s] } }
-  end
-
-  def check_repeating_pattern(sequence)
-    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