girb-ruby_llm 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66f01e57eaba72b64b36e0621eabd8c01251ebf92baacd82b738332867e5f6e8
-  data.tar.gz: fa63bea432ab5e4d36be4253df606c526c1b0920e1e22e4ca6b2929a7f837cdc
+  metadata.gz: cfe19c19205f70c38e3f95b1fca105e6c3c5d5c3398871e1a43cf5310e7bfb7a
+  data.tar.gz: 52dcce3593879b4bd66864f8928e5b7eb0aa1f4adc186c62bc665bfc217c1fd5
 SHA512:
-  metadata.gz: 0a94d28c70c59bb44802dd7932b5a33e46e488bad840cdf4b3666070353d61058b501135e58edc7baea4ca0d4fe6a0dc93bdf19491452d768eca1e968f54510d
-  data.tar.gz: d0e28049f1c2eb77f30a0e1ede71d39af6d96b1e96975986fd4803805cc982b2f1bfec6301646a574a3261e366617c2c819aa38e1e7d23e11f4986a1b997b2f7
+  metadata.gz: e030b3dd7df74d07d15b6bfef72e61c7f5c1d9c6d8aa093eed9440855960c8e0773bb3046461a8d05e496e07d8891d6366a4e17bac299cb74d4d8da3bfb5fc2b
+  data.tar.gz: eb256345ace0da90621bd10069a4b0ed3dc94bc72b768d5da79cfd3cf4f558250fae6d9aa0aa3782aa66c632c86783931cf025739dab8dd6e1826b6010dca17f

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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

@@ -6,11 +6,23 @@ require "girb/providers/base"
 module Girb
   module Providers
     class RubyLlm < Base
+      # Thread-local storage for current binding
+      def self.current_binding=(binding)
+        Thread.current[:girb_ruby_llm_binding] = binding
+      end
+
+      def self.current_binding
+        Thread.current[:girb_ruby_llm_binding]
+      end
+
       def initialize(model: nil)
         @model = model
       end
 
-      def chat(messages:, system_prompt:, tools:)
+      def chat(messages:, system_prompt:, tools:, binding: nil)
+        # Store binding for tool execution
+        self.class.current_binding = binding
+
         # Use specified model or RubyLLM's default
         chat_options = @model ? { model: @model } : {}
         ruby_llm_chat = ::RubyLLM.chat(**chat_options)
@@ -29,7 +41,7 @@ module Girb
         last_message = messages.last
         last_content = extract_content(last_message)
 
-        # Send the request
+        # Send the request - RubyLLM will auto-execute tools
         response = ruby_llm_chat.ask(last_content)
 
         parse_response(response)
@@ -37,6 +49,8 @@ module Girb
         Response.new(error: "API Error: #{e.message}")
       rescue StandardError => e
         Response.new(error: "Error: #{e.message}")
+      ensure
+        self.class.current_binding = nil
       end
 
       private
@@ -108,11 +122,42 @@ module Girb
                   required: required_params.include?(prop_name.to_s) || required_params.include?(prop_name)
           end
 
-          # Override name method to return the custom name
+          # Store tool_name for execute method and override name for RubyLLM
+          define_method(:girb_tool_name) { tool_name }
           define_method(:name) { tool_name }
 
-          # Execute method (never actually called, just for tool definition)
-          define_method(:execute) { |**_args| "" }
+          # Execute method - actually execute the girb tool
+          define_method(:execute) do |**args|
+            tool_name_for_log = girb_tool_name
+
+            if Girb.configuration&.debug
+              args_str = args.map { |k, v| "#{k}: #{v.inspect}" }.join(", ")
+              puts "[girb] Tool: #{tool_name_for_log}(#{args_str})"
+            end
+
+            binding = Girb::Providers::RubyLlm.current_binding
+            girb_tool_class = Girb::Tools.find_tool(tool_name_for_log)
+
+            unless girb_tool_class
+              return { error: "Unknown tool: #{tool_name_for_log}" }
+            end
+
+            girb_tool = girb_tool_class.new
+
+            result = if binding
+                       girb_tool.execute(binding, **args)
+                     else
+                       { error: "No binding available for tool execution" }
+                     end
+
+            if Girb.configuration&.debug && result.is_a?(Hash) && result[:error]
+              puts "[girb] Tool error: #{result[:error]}"
+            end
+
+            result
+          rescue StandardError => e
+            { error: "Tool execution failed: #{e.class} - #{e.message}" }
+          end
         end
 
         tool_class.new

data/lib/girb-ruby_llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GirbRubyLlm
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 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.1.2
 platform: ruby
 authors:
 - rira100000000