gemini-ai 4.1.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eda19196e43e0d519127fd3e91c477835d03035115d837849ac398788901d50a
-  data.tar.gz: dad8ccd200487954be14b3cd2e459848e5e557bb10961bcbfdedc70733191742
+  metadata.gz: 5ad19a7cfc87b01f59e5b9eeb11241d63f68a843da3c1f1f8a2784fc20c55cd4
+  data.tar.gz: 2527dda3745613f278c1164aa4625ad447564e22853737e3bce69d423a076fcc
 SHA512:
-  metadata.gz: ee6e3a097d57d1a4f81d74bcec541a03aa23e1829d36b0296817345da6503fc1a198baad7e333e68996654f586ddc822704572159c297afe05e41ba687e2bba3
-  data.tar.gz: 55eae644861d7c4a45ab2551357e17c44b4490f0d73b706adeb26b12a1931f65db77a5ca64b589b2447367404fea7951cc15710ba12ce2b4561a7b12f84fc05e
+  metadata.gz: 51da36a047e941a324de2ee0d7c110aef52c379c63d8e38af219bdd4bae7b61952648933abf06608c75558cd439168304549d8c6d6e0a347f5f8aa6e190cac95
+  data.tar.gz: d967a7c1ec04f3dd6f9959de82fa4c6295c5e79a2d1a8c9f442902a0147bcd0ecd11beec3599e8550247c6d91b7c0b8ef854b29ba638fcb08b6f826f21f9aac8

data/Gemfile

@@ -5,9 +5,9 @@ source 'https://rubygems.org'
 gemspec
 
 group :test, :development do
-  gem 'dotenv', '~> 3.1', '>= 3.1.2'
-  gem 'pry-byebug', '~> 3.10', '>= 3.10.1'
-  gem 'rspec', '~> 3.13'
-  gem 'rubocop', '~> 1.64', '>= 1.64.1'
-  gem 'rubocop-rspec', '~> 3.0', '>= 3.0.1'
+  gem 'dotenv', '~> 3.1', '>= 3.1.8'
+  gem 'pry-byebug', '~> 3.11'
+  gem 'rspec', '~> 3.13', '>= 3.13.1'
+  gem 'rubocop', '~> 1.78'
+  gem 'rubocop-rspec', '~> 3.6'
 end

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    gemini-ai (4.1.0)
+    gemini-ai (4.3.0)
       event_stream_parser (~> 1.0)
-      faraday (~> 2.9, >= 2.9.2)
+      faraday (~> 2.13, >= 2.13.2)
       faraday-typhoeus (~> 1.1)
       googleauth (~> 1.8)
       typhoeus (~> 1.4, >= 1.4.1)
@@ -13,107 +13,116 @@ GEM
   specs:
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    byebug (11.1.3)
+    ast (2.4.3)
+    base64 (0.3.0)
+    byebug (12.0.0)
     coderay (1.1.3)
-    diff-lcs (1.5.1)
-    dotenv (3.1.2)
+    diff-lcs (1.6.2)
+    dotenv (3.1.8)
     ethon (0.16.0)
       ffi (>= 1.15.0)
     event_stream_parser (1.0.0)
-    faraday (2.9.2)
-      faraday-net_http (>= 2.0, < 3.2)
-    faraday-net_http (3.1.0)
-      net-http
+    faraday (2.13.2)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
     faraday-typhoeus (1.1.0)
       faraday (~> 2.0)
       typhoeus (~> 1.4)
-    ffi (1.17.0)
-    google-cloud-env (2.1.1)
+    ffi (1.17.2)
+    google-cloud-env (2.3.1)
+      base64 (~> 0.2)
       faraday (>= 1.0, < 3.a)
-    googleauth (1.11.0)
+    google-logging-utils (0.2.0)
+    googleauth (1.14.0)
       faraday (>= 1.0, < 3.a)
-      google-cloud-env (~> 2.1)
+      google-cloud-env (~> 2.2)
+      google-logging-utils (~> 0.1)
       jwt (>= 1.4, < 3.0)
       multi_json (~> 1.11)
       os (>= 0.9, < 2.0)
       signet (>= 0.16, < 2.a)
-    json (2.7.2)
-    jwt (2.8.2)
+    json (2.12.2)
+    jwt (2.10.2)
       base64
-    language_server-protocol (3.17.0.3)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
     method_source (1.1.0)
     multi_json (1.15.0)
-    net-http (0.4.1)
+    net-http (0.6.0)
       uri
     os (1.1.4)
-    parallel (1.25.1)
-    parser (3.3.3.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
-    pry (0.14.2)
+    prism (1.4.0)
+    pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
-    public_suffix (6.0.0)
-    racc (1.8.0)
+    pry-byebug (3.11.0)
+      byebug (~> 12.0)
+      pry (>= 0.13, < 0.16)
+    public_suffix (6.0.2)
+    racc (1.8.1)
     rainbow (3.1.1)
-    regexp_parser (2.9.2)
-    rexml (3.3.0)
-      strscan
-    rspec (3.13.0)
+    regexp_parser (2.10.0)
+    rspec (3.13.1)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.5)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.64.1)
+    rspec-support (3.13.4)
+    rubocop (1.78.0)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.45.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-rspec (3.0.1)
-      rubocop (~> 1.61)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-rspec (3.6.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
     ruby-progressbar (1.13.0)
-    signet (0.19.0)
+    signet (0.20.0)
       addressable (~> 2.8)
       faraday (>= 0.17.5, < 3.a)
       jwt (>= 1.5, < 3.0)
       multi_json (~> 1.10)
-    strscan (3.1.0)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    uri (1.0.3)
 
 PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  dotenv (~> 3.1, >= 3.1.2)
+  dotenv (~> 3.1, >= 3.1.8)
   gemini-ai!
-  pry-byebug (~> 3.10, >= 3.10.1)
-  rspec (~> 3.13)
-  rubocop (~> 1.64, >= 1.64.1)
-  rubocop-rspec (~> 3.0, >= 3.0.1)
+  pry-byebug (~> 3.11)
+  rspec (~> 3.13, >= 3.13.1)
+  rubocop (~> 1.78)
+  rubocop-rspec (~> 3.6)
 
 BUNDLED WITH
    2.4.22

data/README.md

@@ -9,7 +9,7 @@ A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/ge
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 4.1.0'
+gem 'gemini-ai', '~> 4.3.0'
 ```
 
 ```ruby
@@ -59,6 +59,12 @@ result = client.stream_generate_content({
 })
 ```
 
+Google now supports a [global endpoint](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#global-endpoint):
+
+```ruby
+Gemini.new(credentials: { region: 'global' })
+```
+
 Result:
 ```ruby
 [{ 'candidates' =>
@@ -91,6 +97,7 @@ Result:
     - [Option 3: Application Default Credentials (Vertex AI API)](#option-3-application-default-credentials-vertex-ai-api)
     - [Required Data](#required-data)
   - [Custom Version](#custom-version)
+  - [Global Endpoint](#global-endpoint)
 - [Available Models](#available-models)
 - [Usage](#usage)
   - [Client](#client)
@@ -113,6 +120,7 @@ Result:
   - [Back-and-Forth Conversations](#back-and-forth-conversations)
   - [Safety Settings](#safety-settings)
   - [System Instructions](#system-instructions)
+  - [Counting Tokens](#counting-tokens)
   - [JSON Format Responses](#json-format-responses)
     - [JSON Schema](#json-schema)
     - [Models That Support JSON](#models-that-support-json)
@@ -137,11 +145,11 @@ Result:
 ### Installing
 
 ```sh
-gem install gemini-ai -v 4.1.0
+gem install gemini-ai -v 4.3.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 4.1.0'
+gem 'gemini-ai', '~> 4.3.0'
 ```
 
 ### Credentials
@@ -358,6 +366,14 @@ client = Gemini.new(
 )
 ```
 
+### Global Endpoint
+
+Google now supports a [global endpoint](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#global-endpoint):
+
+```ruby
+Gemini.new(credentials: { region: 'global' })
+```
+
 ## Available Models
 
 These models are accessible to the repository **author** as of June 2025 in the `us-east4` region. Access to models may vary by region, user, and account. All models here are expected to work, if you can access them. This is just a reference of what a "typical" user may expect to have access to right away:
@@ -991,6 +1007,27 @@ Output:
 Meow! I'm Neko, a fluffy and playful cat. :3
 ```
 
+### Counting Tokens
+
+You can [count tokens](https://ai.google.dev/gemini-api/docs/tokens#count-tokens) and preview how many tokens a request is expected to consume:
+
+```ruby
+client.count_tokens(
+  { contents: { role: 'user', parts: { text: 'hi!' } } }
+)
+```
+
+Output for Generative Language API:
+```ruby
+{ 'totalTokens' => 3 }
+```
+
+Output for Vertex AI API:
+
+```ruby
+{ 'totalTokens' => 2, 'totalBillableCharacters' => 3 }
+```
+
 ### JSON Format Responses
 
 > _As of the writing of this README, only the `vertex-ai-api` service and `gemini` models version `1.5` support this feature._
@@ -1418,7 +1455,7 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-4.1.0.gem
+gem push gemini-ai-4.3.0.gem
 ```
 
 ### Updating the README

data/controllers/client.rb

@@ -56,7 +56,11 @@ module Gemini
 
         @base_address = case @service
                         when 'vertex-ai-api'
-                          "https://#{config[:credentials][:region]}-aiplatform.googleapis.com/#{@service_version}/projects/#{@project_id}/locations/#{config[:credentials][:region]}"
+                          if config[:credentials][:region] == 'global'
+                            "https://aiplatform.googleapis.com/#{@service_version}/projects/#{@project_id}/locations/#{config[:credentials][:region]}"
+                          else
+                            "https://#{config[:credentials][:region]}-aiplatform.googleapis.com/#{@service_version}/projects/#{@project_id}/locations/#{config[:credentials][:region]}"
+                          end
                         when 'generative-language-api'
                           "https://generativelanguage.googleapis.com/#{@service_version}"
                         end
@@ -75,9 +79,7 @@ module Gemini
         @faraday_adapter = config.dig(:options, :connection, :adapter) || DEFAULT_FARADAY_ADAPTER
 
         @request_options = if @request_options.is_a?(Hash)
-                             @request_options.select do |key, _|
-                               ALLOWED_REQUEST_OPTIONS.include?(key)
-                             end
+                             @request_options.slice(*ALLOWED_REQUEST_OPTIONS)
                            else
                              {}
                            end
@@ -109,6 +111,17 @@ module Gemini
         result
       end
 
+      def count_tokens(payload, server_sent_events: nil, &callback)
+        result = request(
+          "#{@model_address}:countTokens", payload,
+          server_sent_events:, &callback
+        )
+
+        return result.first if result.is_a?(Array) && result.size == 1
+
+        result
+      end
+
       def embed_content(payload, server_sent_events: nil, &callback)
         result = request(
           "#{@model_address}:embedContent", payload,

data/gemini-ai.gemspec

@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['ports/dsl']
 
   spec.add_dependency 'event_stream_parser', '~> 1.0'
-  spec.add_dependency 'faraday', '~> 2.9', '>= 2.9.2'
+  spec.add_dependency 'faraday', '~> 2.13', '>= 2.13.2'
   spec.add_dependency 'faraday-typhoeus', '~> 1.1'
 
   # Before upgrading, check this:

data/static/gem.rb

@@ -3,7 +3,7 @@
 module Gemini
   GEM = {
     name: 'gemini-ai',
-    version: '4.1.0',
+    version: '4.3.0',
     author: 'gbaptista',
     summary: "Interact with Google's Gemini AI.",
     description: "A Ruby Gem for interacting with Gemini through Vertex AI, Generative Language API, or AI Studio, Google's generative AI services.",

data/template.md

@@ -9,7 +9,7 @@ A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/ge
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 4.1.0'
+gem 'gemini-ai', '~> 4.3.0'
 ```
 
 ```ruby
@@ -59,6 +59,12 @@ result = client.stream_generate_content({
 })
 ```
 
+Google now supports a [global endpoint](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#global-endpoint):
+
+```ruby
+Gemini.new(credentials: { region: 'global' })
+```
+
 Result:
 ```ruby
 [{ 'candidates' =>
@@ -88,11 +94,11 @@ Result:
 ### Installing
 
 ```sh
-gem install gemini-ai -v 4.1.0
+gem install gemini-ai -v 4.3.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 4.1.0'
+gem 'gemini-ai', '~> 4.3.0'
 ```
 
 ### Credentials
@@ -309,6 +315,14 @@ client = Gemini.new(
 )
 ```
 
+### Global Endpoint
+
+Google now supports a [global endpoint](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#global-endpoint):
+
+```ruby
+Gemini.new(credentials: { region: 'global' })
+```
+
 ## Available Models
 
 These models are accessible to the repository **author** as of June 2025 in the `us-east4` region. Access to models may vary by region, user, and account. All models here are expected to work, if you can access them. This is just a reference of what a "typical" user may expect to have access to right away:
@@ -942,6 +956,27 @@ Output:
 Meow! I'm Neko, a fluffy and playful cat. :3
 ```
 
+### Counting Tokens
+
+You can [count tokens](https://ai.google.dev/gemini-api/docs/tokens#count-tokens) and preview how many tokens a request is expected to consume:
+
+```ruby
+client.count_tokens(
+  { contents: { role: 'user', parts: { text: 'hi!' } } }
+)
+```
+
+Output for Generative Language API:
+```ruby
+{ 'totalTokens' => 3 }
+```
+
+Output for Vertex AI API:
+
+```ruby
+{ 'totalTokens' => 2, 'totalBillableCharacters' => 3 }
+```
+
 ### JSON Format Responses
 
 > _As of the writing of this README, only the `vertex-ai-api` service and `gemini` models version `1.5` support this feature._
@@ -1369,7 +1404,7 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-4.1.0.gem
+gem push gemini-ai-4.3.0.gem
 ```
 
 ### Updating the README

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gemini-ai
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 4.3.0
 platform: ruby
 authors:
 - gbaptista
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-23 00:00:00.000000000 Z
+date: 2025-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: event_stream_parser
@@ -30,20 +30,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.9'
+        version: '2.13'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.9.2
+        version: 2.13.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.9'
+        version: '2.13'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.9.2
+        version: 2.13.2
 - !ruby/object:Gem::Dependency
   name: faraday-typhoeus
   requirement: !ruby/object:Gem::Requirement