llm_chain 0.5.2 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a926b1222ae2f5fda1d4562ade3663cf1b9d9aff0e1162f8c8c6b17ab817a27c
-  data.tar.gz: 9a9c7ad9c081899e5ae014d0236eaf01cf93fa66fcdae2c439d18cf54e7de532
+  metadata.gz: 8c94520a98ace3d2bb61ca2b470af041e0f95d6818120ce01dfc5a9cfe76316b
+  data.tar.gz: 5155099cdf777ecaed3a30c9da1e7e200476258369ef3b976967888daf001876
 SHA512:
-  metadata.gz: 0f6736ee81ee8cc057e7f283de27f7d7cda086a3161b2c0bd7b8b434542b9df3c52df905cbc4c561c069f47afbaa333f36f52fbbe9fac56a83fe766a165c71f2
-  data.tar.gz: 17750148dce41dd667b24621d1e19051f9ff253213a72ef4e79ffda7d6291494c2db79a88215257f0afb69b4a857583e734e9872fa515e10d7879d5b62f139cb
+  metadata.gz: b37c6ed16c6b6a66d1f9c6e2a62717e576c5211aba605b98b97e5ba54b436d9a38602aabcedf34a23963ee034d6332dadefe03fa6c6a5d4d3f4941b2df9efd88
+  data.tar.gz: 4e5c3b6921e4f0656ea8266ca67a00dbcbc8c11736573df9172b8cb2d8821d3799f87085f31e7975d916d56c29f10a4637c6df5f102520fc2da3f5284143ef79

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.3] - 2025-07-05
+
+### Added
+* **CLI Executable** (`llm-chain`) with commands:
+  * `chat` – one-off prompt
+  * `diagnose` – system diagnostics
+  * `tools list` – list default tools
+  * `repl` – interactive Read-Eval-Print Loop with in-memory history and helper slash-commands
+
+### Changed
+* CLI autodetects Bundler only in development repo to avoid gem conflicts.
+
+### Fixed
+* Version conflicts when running CLI inside unrelated Bundler projects.
+
 ## [0.5.2] - 2025-01-XX
 
 ### Added
@@ -68,7 +83,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Initial stable release with core functionality
 
-[Unreleased]: https://github.com/FuryCow/llm_chain/compare/v0.5.2...HEAD
+[Unreleased]: https://github.com/FuryCow/llm_chain/compare/v0.5.3...HEAD
+[0.5.3]: https://github.com/FuryCow/llm_chain/compare/v0.5.2...v0.5.3
 [0.5.2]: https://github.com/FuryCow/llm_chain/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/FuryCow/llm_chain/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/FuryCow/llm_chain/releases/tag/v0.5.0 

data/README.md

@@ -8,14 +8,16 @@
 
 LLMChain is a Ruby analog of LangChain, providing a unified interface for interacting with various LLMs, built-in tool system, and RAG (Retrieval-Augmented Generation) support.
 
-## 🎉 What's New in v0.5.2
+## 🎉 What's New in v0.5.3
 
-- ✅ **System Diagnostics** - Built-in health checks with `LLMChain.diagnose_system`
-- ✅ **Configuration Validation** - Early detection of setup issues and helpful warnings  
-- ✅ **Enhanced Error Handling** - Retry logic with exponential backoff for network requests
-- ✅ **Robust WebSearch** - Better timeout handling and graceful degradation
-- ✅ **Improved Code Extraction** - Enhanced support for various code block formats
-- ✅ **Debug Logging** - Structured logging with `LLM_CHAIN_DEBUG=true`
+* 🖥️ **New CLI executable** `llm-chain`
+  * `chat` – ask a one-off question from your shell
+  * `repl` – interactive session with conversation memory and helper commands (`/help`, `/mem clear`, `/tools list`)
+  * `diagnose` – run the built-in environment health-check
+  * `tools list` – inspect available tools
+* 🔄 **Bundler-aware loading** – CLI detects if it’s executed inside the gem repo and avoids version clashes with external Gemfiles.
+
+That’s all you need to start talking to LLMs straight from the terminal. See the **Command-line Interface** section below for usage examples.
 
 ## ✨ Key Features
 
@@ -80,6 +82,37 @@ response = chain.ask("Hello! How are you?")
 puts response
 ```
 
+## 🖥️ Command-line Interface (v0.5.3+)
+
+Alongside the Ruby API, LLMChain ships with a convenient CLI executable `llm-chain`.
+
+### Basic commands
+
+```bash
+# One-off question
+llm-chain chat "Hello! How are you?"
+
+# Interactive REPL with conversation memory (/help in session)
+llm-chain repl
+
+# System diagnostics (same as LLMChain.diagnose_system)
+llm-chain diagnose
+
+# List default tools
+llm-chain tools list
+
+# Show gem version
+llm-chain -v
+```
+
+The CLI is installed automatically with the gem. If your shell doesn’t find the command, make sure RubyGems’ bindir is in your `$PATH` or use Bundler-aware launch:
+
+```bash
+bundle exec llm-chain chat "…"
+```
+
+Set `LLM_CHAIN_DEBUG=true` to print extra logs.
+
 ## 🔍 System Diagnostics (v0.5.2+)
 
 Before diving into development, it's recommended to check your system configuration:

data/exe/llm-chain

@@ -0,0 +1,126 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Load Bundler only if running from the development repo (Gemfile present)
+if File.exist?(File.expand_path("../../Gemfile", __dir__))
+  begin
+    require "bundler/setup"
+  rescue LoadError
+    warn "[llm-chain] Bundler not available; continuing without it"
+  end
+end
+
+require "llm_chain"
+require "optparse"
+require "readline"
+
+USAGE = <<~TEXT.freeze
+  Usage: llm-chain <command> [options]
+
+  Commands:
+    chat <prompt>        Send prompt to quick_chain and print response
+    repl                Start interactive REPL session
+    diagnose             Run system diagnostics
+    tools list           List registered tools in the default toolset
+    version              Print LLMChain gem version
+
+  Environment variables:
+    LLM_CHAIN_DEBUG      Enable verbose diagnostic logs
+TEXT
+
+# Exit with usage if no command
+if ARGV.empty?
+  warn USAGE
+  exit 1
+end
+
+command = ARGV.shift
+
+case command
+when "repl"
+  puts "LLMChain REPL — type /help for commands, /exit to quit"
+  chain = LLMChain.quick_chain
+
+  loop do
+    line = Readline.readline("> ", true)
+    break if line.nil? || line.strip == "/exit" || line.strip == "/quit"
+
+    case line.strip
+    when "/help"
+      puts "/exit            Exit REPL\n" \
+           "/mem clear       Clear conversation memory\n" \
+           "/tools list      List available tools"
+      next
+    when "/mem clear"
+      chain.memory.clear if chain.memory.respond_to?(:clear)
+      puts "[memory cleared]"
+      next
+    when "/tools list"
+      if chain.tools.respond_to?(:tools_description)
+        puts chain.tools.tools_description
+      else
+        puts "No ToolManager attached"
+      end
+      next
+    end
+
+    # Empty input => skip
+    next if line.strip.empty?
+
+    begin
+      response = chain.ask(line)
+      puts response
+    rescue => e
+      warn "Error: #{e.message}"
+    end
+  end
+
+  puts "Bye!"
+
+when "chat"
+  # Collect prompt from remaining args or STDIN
+  prompt = if ARGV.empty?
+             puts "Enter prompt (end with CTRL+D):"
+             STDIN.read
+           else
+             ARGV.join(" ")
+           end
+  if prompt.nil? || prompt.strip.empty?
+    warn "No prompt provided"
+    exit 1
+  end
+
+  begin
+    chain = LLMChain.quick_chain
+    response = chain.ask(prompt)
+    puts "\n=== Response ===\n"
+    puts response
+  rescue Interrupt
+    warn "Interrupted"
+  rescue => e
+    warn "Error: #{e.message}"
+    exit 1
+  end
+
+when "diagnose"
+  LLMChain.diagnose_system
+
+when "tools"
+  sub = ARGV.shift
+  case sub
+  when "list"
+    tm = LLMChain::Tools::ToolManager.create_default_toolset
+    puts tm.tools_description
+  else
+    warn "Unknown tools subcommand"; warn USAGE
+    exit 1
+  end
+
+when "version", "--version", "-v"
+  puts LlmChain::VERSION
+
+else
+  warn "Unknown command: #{command}"
+  warn USAGE
+  exit 1
+end 

data/lib/llm_chain/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmChain
-  VERSION = "0.5.2"
+  VERSION = "0.5.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: llm_chain
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.3
 platform: ruby
 authors:
 - FuryCow
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-30 00:00:00.000000000 Z
+date: 2025-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -111,7 +111,8 @@ dependencies:
 description:
 email:
 - dreamweaver0408@gmail.com
-executables: []
+executables:
+- llm-chain
 extensions: []
 extra_rdoc_files: []
 files:
@@ -124,6 +125,7 @@ files:
 - Rakefile
 - examples/quick_demo.rb
 - examples/tools_example.rb
+- exe/llm-chain
 - lib/llm_chain.rb
 - lib/llm_chain/chain.rb
 - lib/llm_chain/client_registry.rb