girb-ruby_llm 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66f01e57eaba72b64b36e0621eabd8c01251ebf92baacd82b738332867e5f6e8
-  data.tar.gz: fa63bea432ab5e4d36be4253df606c526c1b0920e1e22e4ca6b2929a7f837cdc
+  metadata.gz: 53c8af5d1f30750451fed2b555cd064e492468da3e7954cf5976443374eb4d4d
+  data.tar.gz: '0149788d1aa79cd0de9bd0531ca8e855e4934c7e3b63a2fa59000ba2469e6048'
 SHA512:
-  metadata.gz: 0a94d28c70c59bb44802dd7932b5a33e46e488bad840cdf4b3666070353d61058b501135e58edc7baea4ca0d4fe6a0dc93bdf19491452d768eca1e968f54510d
-  data.tar.gz: d0e28049f1c2eb77f30a0e1ede71d39af6d96b1e96975986fd4803805cc982b2f1bfec6301646a574a3261e366617c2c819aa38e1e7d23e11f4986a1b997b2f7
+  metadata.gz: 78f109efbd1bb1a677295a8de6bc319f5dbd979df13bac7222cdf8015468b3973b88322bf7ca1cfb528b91d35ed1c2b220ca689eaa04147621dd18ae5abe1c35
+  data.tar.gz: 7770dbb62a2f71cf5197bb0db15a4b526824cf6d4f5a1a410170672dce64cb92251efcefabc71d851f75ab1b8d719a98b974cbea9e5c8d3fbbd964bbc891ee37

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.2.0] - 2026-02-05
+
+### Added
+
+- Debug gem (rdbg) support for AI-assisted debugging
+
+## [0.1.2] - 2026-02-03
+
+### Fixed
+
+- Fix tool names being empty strings in dynamic RubyLLM::Tool classes
+- Properly execute girb tools within RubyLLM's auto-execute framework
+
 ## [0.1.1] - 2026-02-03
 
 ### Added

data/README.md

@@ -8,48 +8,55 @@ This gem allows you to use multiple LLM providers (OpenAI, Anthropic, Google Gem
 
 ## Installation
 
+### For Rails Projects
+
 Add to your Gemfile:
 
 ```ruby
-gem 'girb'
-gem 'girb-ruby_llm'
+group :development do
+  gem 'girb-ruby_llm'
+end
 ```
 
-Or install directly:
+Then run:
 
 ```bash
-gem install girb girb-ruby_llm
+bundle install
 ```
 
-## Setup
-
-### Option 1: Configure in ~/.irbrc (Recommended)
-
-Add to your `~/.irbrc`:
+Create a `.girbrc` file in your project root:
 
 ```ruby
+# .girbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.gemini_api_key = 'your-api-key'
-end
-
 Girb.configure do |c|
   c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
 end
 ```
 
-Then use regular `irb` command.
+Now `rails console` will automatically load girb!
 
-### Option 2: Configure via environment variables
+### For Non-Rails Projects
+
+Install globally:
 
 ```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=gemini-2.5-flash
-export GEMINI_API_KEY=your-api-key
+gem install girb girb-ruby_llm
+```
+
+Create a `.girbrc` file in your project directory:
+
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-Then start with `girb` command.
+Then use `girb` command instead of `irb`.
 
 ## Configuration
 
@@ -90,56 +97,74 @@ Set your API key or endpoint as an environment variable:
 
 ## Examples
 
+### Using Google Gemini
+
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# Set GEMINI_API_KEY environment variable
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
+```
+
 ### Using OpenAI
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=gpt-4o
-export OPENAI_API_KEY="sk-..."
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# Set OPENAI_API_KEY environment variable
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gpt-4o')
+end
 ```
 
 ### Using Anthropic Claude
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=claude-sonnet-4-20250514
-export ANTHROPIC_API_KEY="sk-ant-..."
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# Set ANTHROPIC_API_KEY environment variable
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'claude-sonnet-4-20250514')
+end
 ```
 
 ### Using Ollama (Local)
 
-```bash
-# Start Ollama first
-ollama serve
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
 
-# Set the provider, model, and API base URL
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=llama3.2:latest
-export OLLAMA_API_BASE="http://localhost:11434/v1"
-girb
+# Set OLLAMA_API_BASE environment variable (e.g., http://localhost:11434/v1)
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'llama3.2:latest')
+end
 ```
 
 ### Using OpenAI-compatible APIs (e.g., LM Studio, vLLM)
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=your-model-name
-export OPENAI_API_KEY="not-needed"  # Some require any non-empty value
-export OPENAI_API_BASE="http://localhost:1234/v1"
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# Set OPENAI_API_BASE and OPENAI_API_KEY environment variables
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'your-model-name')
+end
 ```
 
 ### Advanced Configuration
 
-For more control, configure Girb in your `~/.irbrc`:
-
 ```ruby
-# ~/.irbrc
+# .girbrc
 require 'girb-ruby_llm'
 
 Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
   c.debug = true  # Enable debug output
   c.custom_prompt = <<~PROMPT
     Always confirm before destructive operations.
@@ -149,6 +174,17 @@ end
 
 Note: `RubyLLM::Models.refresh!` is automatically called for local providers (Ollama, GPUStack).
 
+## Alternative: Environment Variable Configuration
+
+For the `girb` command, you can also configure via environment variables (used when no `.girbrc` is found):
+
+```bash
+export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
+girb
+```
+
 ## Supported Models
 
 See [RubyLLM Available Models](https://rubyllm.com/reference/available-models) for the full list of supported models.

data/README_ja.md

@@ -6,48 +6,55 @@
 
 ## インストール
 
+### Railsプロジェクトの場合
+
 Gemfileに追加:
 
 ```ruby
-gem 'girb'
-gem 'girb-ruby_llm'
+group :development do
+  gem 'girb-ruby_llm'
+end
 ```
 
-または直接インストール:
+そして実行:
 
 ```bash
-gem install girb girb-ruby_llm
+bundle install
 ```
 
-## セットアップ
-
-### 方法1: ~/.irbrcで設定（推奨）
-
-`~/.irbrc` に追加:
+プロジェクトルートに `.girbrc` ファイルを作成:
 
 ```ruby
+# .girbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.gemini_api_key = 'your-api-key'
-end
-
 Girb.configure do |c|
   c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
 end
 ```
 
-通常の `irb` コマンドで使用できます。
+これで `rails console` が自動的にgirbを読み込みます！
 
-### 方法2: 環境変数で設定
+### 非Railsプロジェクトの場合
+
+グローバルにインストール:
 
 ```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=gemini-2.5-flash
-export GEMINI_API_KEY=your-api-key
+gem install girb girb-ruby_llm
+```
+
+プロジェクトディレクトリに `.girbrc` ファイルを作成:
+
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-`girb` コマンドで起動します。
+`irb` の代わりに `girb` コマンドを使用します。
 
 ## 設定
 
@@ -88,56 +95,74 @@ APIキーまたはエンドポイントを環境変数として設定します:
 
 ## 使用例
 
+### Google Geminiを使用
+
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# GEMINI_API_KEY 環境変数を設定
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
+```
+
 ### OpenAIを使用
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=gpt-4o
-export OPENAI_API_KEY="sk-..."
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# OPENAI_API_KEY 環境変数を設定
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gpt-4o')
+end
 ```
 
 ### Anthropic Claudeを使用
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=claude-sonnet-4-20250514
-export ANTHROPIC_API_KEY="sk-ant-..."
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# ANTHROPIC_API_KEY 環境変数を設定
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'claude-sonnet-4-20250514')
+end
 ```
 
 ### Ollama（ローカル）を使用
 
-```bash
-# まずOllamaを起動
-ollama serve
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
 
-# プロバイダー、モデル、APIベースURLを設定
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=llama3.2:latest
-export OLLAMA_API_BASE="http://localhost:11434/v1"
-girb
+# OLLAMA_API_BASE 環境変数を設定（例: http://localhost:11434/v1）
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'llama3.2:latest')
+end
 ```
 
 ### OpenAI互換API（LM Studio、vLLMなど）を使用
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GIRB_MODEL=your-model-name
-export OPENAI_API_KEY="not-needed"  # 空でない値が必要な場合
-export OPENAI_API_BASE="http://localhost:1234/v1"
-girb
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
+
+# OPENAI_API_BASE と OPENAI_API_KEY 環境変数を設定
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'your-model-name')
+end
 ```
 
 ### 詳細設定
 
-より細かい制御が必要な場合、`~/.irbrc`でGirbを設定できます:
-
 ```ruby
-# ~/.irbrc
+# .girbrc
 require 'girb-ruby_llm'
 
 Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
   c.debug = true  # デバッグ出力を有効化
   c.custom_prompt = <<~PROMPT
     破壊的操作の前に必ず確認してください。
@@ -147,6 +172,17 @@ end
 
 注: ローカルプロバイダー（Ollama、GPUStack）使用時は`RubyLLM::Models.refresh!`が自動的に呼ばれます。
 
+## 代替: 環境変数での設定
+
+`girb` コマンドでは、`.girbrc` が見つからない場合に環境変数で設定することもできます:
+
+```bash
+export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
+girb
+```
+
 ## 対応モデル
 
 サポートされているモデルの完全なリストは[RubyLLM Available Models](https://rubyllm.com/reference/available-models)を参照してください。

data/lib/girb/providers/ruby_llm.rb

@@ -10,7 +10,7 @@ module Girb
         @model = model
       end
 
-      def chat(messages:, system_prompt:, tools:)
+      def chat(messages:, system_prompt:, tools:, binding: nil)
         # Use specified model or RubyLLM's default
         chat_options = @model ? { model: @model } : {}
         ruby_llm_chat = ::RubyLLM.chat(**chat_options)
@@ -18,19 +18,15 @@ module Girb
         # Set system prompt
         ruby_llm_chat.with_instructions(system_prompt) if system_prompt && !system_prompt.empty?
 
-        # Add tools
+        # Add tool schemas (for API payload generation only, not auto-executed)
         tool_instances = build_tools(tools)
         tool_instances.each { |tool| ruby_llm_chat.with_tool(tool) }
 
-        # Add messages except the last user message
-        add_messages_to_chat(ruby_llm_chat, messages[0..-2])
+        # Add all messages to the chat
+        add_messages_to_chat(ruby_llm_chat, messages)
 
-        # Get the last user message
-        last_message = messages.last
-        last_content = extract_content(last_message)
-
-        # Send the request
-        response = ruby_llm_chat.ask(last_content)
+        # Get raw response without auto-executing tools
+        response = raw_complete(ruby_llm_chat)
 
         parse_response(response)
       rescue Faraday::BadRequestError => e
@@ -41,6 +37,22 @@ module Girb
 
       private
 
+      # Call provider.complete() directly, bypassing RubyLLM's handle_tool_calls.
+      # This returns the raw response so the caller can handle tool execution.
+      def raw_complete(chat)
+        provider = chat.instance_variable_get(:@provider)
+        provider.complete(
+          chat.messages,
+          tools: chat.tools,
+          temperature: chat.instance_variable_get(:@temperature),
+          model: chat.model,
+          params: chat.params,
+          headers: chat.headers,
+          schema: chat.schema,
+          thinking: chat.instance_variable_get(:@thinking)
+        )
+      end
+
       def add_messages_to_chat(chat, messages)
         messages.each do |msg|
           case msg[:role]
@@ -49,13 +61,13 @@ module Girb
           when :assistant
             chat.add_message(role: :assistant, content: msg[:content])
           when :tool_call
-            # Add as assistant message with tool_calls
+            id = msg[:id] || "call_#{SecureRandom.hex(12)}"
             chat.add_message(
               role: :assistant,
               content: nil,
               tool_calls: {
-                msg[:name] => ::RubyLLM::ToolCall.new(
-                  id: msg[:id] || "call_#{SecureRandom.hex(12)}",
+                id => ::RubyLLM::ToolCall.new(
+                  id: id,
                   name: msg[:name],
                   arguments: msg[:args]
                 )
@@ -71,15 +83,6 @@ module Girb
         end
       end
 
-      def extract_content(message)
-        case message[:role]
-        when :user, :assistant
-          message[:content]
-        else
-          message[:content].to_s
-        end
-      end
-
       def build_tools(tools)
         return [] if tools.nil? || tools.empty?
 
@@ -93,11 +96,10 @@ module Girb
         tool_description = tool_def[:description]
         tool_parameters = tool_def[:parameters] || {}
 
-        # Create a dynamic tool class
+        # Create a dynamic tool class for schema generation only
         tool_class = Class.new(::RubyLLM::Tool) do
           description tool_description
 
-          # Define parameters
           properties = tool_parameters[:properties] || {}
           required_params = tool_parameters[:required] || []
 
@@ -108,11 +110,12 @@ module Girb
                   required: required_params.include?(prop_name.to_s) || required_params.include?(prop_name)
           end
 
-          # Override name method to return the custom name
           define_method(:name) { tool_name }
 
-          # Execute method (never actually called, just for tool definition)
-          define_method(:execute) { |**_args| "" }
+          # Not used — tool execution is handled by the caller's tool loop
+          define_method(:execute) do |**_args|
+            raise "Tool execution should be handled by the caller, not by the provider"
+          end
         end
 
         tool_class.new
@@ -132,6 +135,7 @@ module Girb
 
         response.tool_calls.map do |_id, tool_call|
           {
+            id: tool_call.id,
             name: tool_call.name.to_s,
             args: tool_call.arguments || {}
           }

data/lib/girb-ruby_llm/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: girb-ruby_llm
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - rira100000000