girb-gemini 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7181aaaf0ef47945d34fbf816fac795156073eba874678e0ff206a73867946d1
-  data.tar.gz: c27aae4cd27cdfe4aa0bfa0ea9351fc096bfece04167fe8d1553ab58c65945ae
+  metadata.gz: f31f46cab9413d0ab42e04ab660d422d2c2eab6aa3c24c73bd0cb92302ddee7b
+  data.tar.gz: 96d2cf77aec44f0d0e3e7ed58974be763f5f0fd84b5ffeeadf02b1fe501825ae
 SHA512:
-  metadata.gz: 772fb412059de24c75cb39d166d81b68e0047fc5c90488e3d69448516dd5f3aa3a795e287e3a78365006e43a56d349bfa7639c81eb84404df6e8565dc37626ed
-  data.tar.gz: e15f65f649f5a0f8ee16ac2b622ad1f7bcaec2dad90854ca6215e0b45486c7b54a163dcee55e7d1a817f18f7c9db76b1f870137b4514f42effe9c9445249f2bb
+  metadata.gz: e732d81d5c50e8e9d816c4980c0dd6ae88e050f08903bbae28a05b55a86a31c2a829893adfa8c2ddbb9a54be75b561aade611bf8ec81365de0b7483583055385
+  data.tar.gz: f9e9a2ce202940ed7085e4c3e3ee82cf73345233e29afb45006b4adcf2e1520d9b2c09a67fae97776c5fbd87316b5963da5b96da3e3820a5acc7e16fdbcabf82

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.3.0] - 2026-02-12
+
+### Added
+
+- Web search tool powered by Google Search grounding
+- Support for gemini-3-flash-preview and gemini-3-pro-preview models
+
+## [0.2.0] - 2026-02-07
+
+### Fixed
+
+- Fix Gemini 3 thought_signature error on function calls
+- Preserve thought_signature from API response and include it when sending function call history back to the API
+- Clear false-positive websocket-native LoadError from ExceptionCapture after loading ruby-gemini-api
+
 ## [0.1.1] - 2026-02-03
 
 ### Added

data/README.md

@@ -6,52 +6,103 @@ Google Gemini LLM provider for [girb](https://github.com/rira100000000/girb) (AI
 
 ## Installation
 
+### For Rails Projects
+
 Add to your Gemfile:
 
 ```ruby
-gem 'girb'
-gem 'girb-gemini'
+group :development do
+  gem 'girb-gemini'
+end
 ```
 
-Or install directly:
+Then run:
 
 ```bash
-gem install girb girb-gemini
+bundle install
 ```
 
-## Setup
+Create a `.girbrc` file in your project root:
 
-### Option 1: Configure in ~/.irbrc (Recommended)
+```ruby
+# .girbrc
+require 'girb-gemini'
 
-Add to your `~/.irbrc`:
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash'
+  )
+end
+```
+
+Now `rails console` will automatically load girb!
+
+### For Non-Rails Projects
+
+Install globally:
+
+```bash
+gem install girb girb-gemini
+```
+
+Create a `.girbrc` file in your project directory:
 
 ```ruby
+# .girbrc
 require 'girb-gemini'
 
 Girb.configure do |c|
   c.provider = Girb::Providers::Gemini.new(
-    api_key: 'your-api-key',
+    api_key: ENV['GEMINI_API_KEY'],
     model: 'gemini-2.5-flash'
   )
 end
 ```
 
-Then use regular `irb` command.
+Then use `girb` command instead of `irb`.
 
-### Option 2: Configure via environment variables
+## Configuration
+
+Set your API key as an environment variable:
 
 ```bash
-export GIRB_PROVIDER=girb-gemini
-export GIRB_MODEL=gemini-2.5-flash  # optional, defaults to gemini-2.5-flash
 export GEMINI_API_KEY=your-api-key
 ```
 
-Then start with `girb` command.
-
 ## Available Models
 
 - `gemini-2.5-flash` (default) - Fast and efficient
 - `gemini-2.5-pro` - More capable, slower
+- `gemini-3-flash-preview` - Next generation, fast
+- `gemini-3-pro-preview` - Next generation, more capable
+
+## Web Search
+
+girb-gemini includes a built-in web search tool powered by Google Search. This allows the AI to retrieve up-to-date information during your IRB session.
+
+Web search is **enabled by default**. To disable it:
+
+```ruby
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash',
+    google_search: false
+  )
+end
+```
+
+## 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-gemini
+export GIRB_MODEL=gemini-2.5-flash  # optional, defaults to gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
+girb
+```
 
 ## License
 

data/README_ja.md

@@ -4,52 +4,103 @@
 
 ## インストール
 
+### Railsプロジェクトの場合
+
 Gemfileに追加:
 
 ```ruby
-gem 'girb'
-gem 'girb-gemini'
+group :development do
+  gem 'girb-gemini'
+end
 ```
 
-または直接インストール:
+そして実行:
 
 ```bash
-gem install girb girb-gemini
+bundle install
 ```
 
-## セットアップ
+プロジェクトルートに `.girbrc` ファイルを作成:
 
-### 方法1: ~/.irbrcで設定（推奨）
+```ruby
+# .girbrc
+require 'girb-gemini'
 
-`~/.irbrc` に追加:
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash'
+  )
+end
+```
+
+これで `rails console` が自動的にgirbを読み込みます！
+
+### 非Railsプロジェクトの場合
+
+グローバルにインストール:
+
+```bash
+gem install girb girb-gemini
+```
+
+プロジェクトディレクトリに `.girbrc` ファイルを作成:
 
 ```ruby
+# .girbrc
 require 'girb-gemini'
 
 Girb.configure do |c|
   c.provider = Girb::Providers::Gemini.new(
-    api_key: 'your-api-key',
+    api_key: ENV['GEMINI_API_KEY'],
     model: 'gemini-2.5-flash'
   )
 end
 ```
 
-通常の `irb` コマンドで使用できます。
+`irb` の代わりに `girb` コマンドを使用します。
 
-### 方法2: 環境変数で設定
+## 設定
+
+APIキーを環境変数として設定:
 
 ```bash
-export GIRB_PROVIDER=girb-gemini
-export GIRB_MODEL=gemini-2.5-flash  # オプション、デフォルトは gemini-2.5-flash
 export GEMINI_API_KEY=your-api-key
 ```
 
-`girb` コマンドで起動します。
-
 ## 利用可能なモデル
 
 - `gemini-2.5-flash` (デフォルト) - 高速で効率的
 - `gemini-2.5-pro` - より高性能、やや遅い
+- `gemini-3-flash-preview` - 次世代モデル、高速
+- `gemini-3-pro-preview` - 次世代モデル、より高性能
+
+## Web検索
+
+girb-geminiにはGoogle Searchを利用したWeb検索ツールが組み込まれています。IRBセッション中にAIが最新の情報を取得できます。
+
+Web検索は**デフォルトで有効**です。無効にするには:
+
+```ruby
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash',
+    google_search: false
+  )
+end
+```
+
+## 代替: 環境変数での設定
+
+`girb` コマンドでは、`.girbrc` が見つからない場合に環境変数で設定することもできます:
+
+```bash
+export GIRB_PROVIDER=girb-gemini
+export GIRB_MODEL=gemini-2.5-flash  # オプション、デフォルトは gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
+girb
+```
 
 ## ライセンス
 

data/lib/girb/providers/gemini.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 require "gemini"
+# ruby-gemini-apiがgemini/live→websocket→websocket-native(オプション)を
+# requireする過程でLoadErrorが発生しrescueされるが、
+# ExceptionCaptureのTracePointに捕捉される場合があるためクリアする
+Girb::ExceptionCapture.clear if defined?(Girb::ExceptionCapture)
 require "girb/providers/base"
 
 module Girb
@@ -8,12 +12,19 @@ module Girb
     class Gemini < Base
       DEFAULT_MODEL = "gemini-2.5-flash"
 
-      def initialize(api_key:, model: DEFAULT_MODEL)
+      def initialize(api_key:, model: DEFAULT_MODEL, google_search: true)
         @client = ::Gemini::Client.new(api_key)
         @model = model
+        @google_search = google_search
+
+        if @google_search
+          setup_web_search_tool
+        else
+          disable_web_search_tool
+        end
       end
 
-      def chat(messages:, system_prompt:, tools:)
+      def chat(messages:, system_prompt:, tools:, binding: nil)
         contents = convert_messages(messages)
         tools_param = build_tools_param(tools)
 
@@ -41,15 +52,16 @@ module Girb
           when :assistant
             { role: "model", parts: [{ text: msg[:content] }] }
           when :tool_call
-            {
-              role: "model",
-              parts: [{
-                function_call: {
-                  name: msg[:name],
-                  args: msg[:args]
-                }
-              }]
+            part = {
+              functionCall: {
+                name: msg[:name],
+                args: msg[:args]
+              }
             }
+            if msg.dig(:metadata, :thought_signature)
+              part[:thoughtSignature] = msg[:metadata][:thought_signature]
+            end
+            { role: "model", parts: [part] }
           when :tool_result
             {
               role: "user",
@@ -109,13 +121,41 @@ module Girb
       def parse_function_calls(response)
         return [] unless response.function_calls&.any?
 
+        # Extract thought_signature from response parts
+        thought_signature = extract_thought_signature(response)
+
         response.function_calls.map do |fc|
-          {
+          result = {
             name: fc["name"],
             args: fc["args"] || {}
           }
+          if thought_signature
+            result[:metadata] = { thought_signature: thought_signature }
+          end
+          result
         end
       end
+
+      def extract_thought_signature(response)
+        return nil unless response.respond_to?(:first_thought_signature)
+
+        response.first_thought_signature
+      rescue
+        nil
+      end
+
+      def setup_web_search_tool
+        require_relative "web_search_tool"
+        WebSearchTool.client = @client
+        WebSearchTool.model = @model
+        Girb::Tools.register(WebSearchTool)
+      end
+
+      def disable_web_search_tool
+        return unless defined?(WebSearchTool)
+
+        WebSearchTool.client = nil
+      end
     end
   end
 end

data/lib/girb/providers/web_search_tool.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Girb
+  module Providers
+    class WebSearchTool < Girb::Tools::Base
+      @client = nil
+      @model = nil
+
+      class << self
+        attr_accessor :client, :model
+
+        def tool_name
+          "web_search"
+        end
+
+        def description
+          "Search the web for current information. Use this when you need up-to-date information " \
+          "that may not be in your training data, such as latest API documentation, recent changes " \
+          "to libraries/frameworks, current error messages, or any real-time information."
+        end
+
+        def parameters
+          {
+            type: "object",
+            properties: {
+              query: {
+                type: "string",
+                description: "The search query. Be specific and include version numbers or dates when relevant."
+              }
+            },
+            required: ["query"]
+          }
+        end
+
+        def available?
+          !@client.nil?
+        end
+      end
+
+      def execute(binding, query:)
+        client = self.class.client
+        model = self.class.model
+        return { error: "Web search not configured" } unless client
+
+        response = client.generate_content(
+          query,
+          model: model,
+          google_search: true
+        )
+
+        text = response.text || ""
+        sources = format_sources(response)
+
+        {
+          result: text,
+          sources: sources
+        }
+      rescue StandardError => e
+        { error: "Web search failed: #{e.message}" }
+      end
+
+      private
+
+      def format_sources(response)
+        return [] unless response.respond_to?(:grounded?) && response.grounded?
+
+        response.grounding_sources.map do |s|
+          "#{s[:title]}: #{s[:url]}"
+        end
+      rescue
+        []
+      end
+    end
+  end
+end

data/lib/girb-gemini/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: girb-gemini
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - rira100000000
@@ -54,6 +54,7 @@ files:
 - lib/girb-gemini.rb
 - lib/girb-gemini/version.rb
 - lib/girb/providers/gemini.rb
+- lib/girb/providers/web_search_tool.rb
 homepage: https://github.com/rira100000000/girb-gemini
 licenses:
 - MIT