nuntius-rb 1.0.0.pre → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e94e856798181b8d99d873394ea2dacfcdfbe5ee04e10933dbf45145ee7f09b0
-  data.tar.gz: e742055df4793f45133dc3116f0d8fb6f31b417fa361db28605b58d137c90ba6
+  metadata.gz: e0f5a8c8df36dd86149885936e553f180f4501b9f1e3a65c0ca8a5165f0f9bec
+  data.tar.gz: bc86749dc66129a851f2a32c4b066e2661c07473be5d099b90bf627360c30ad8
 SHA512:
-  metadata.gz: f59b7bdcc9d294d42458499f701894c90d473a38bfd3866f54a883c670380263175951acf898464156b8e943ab083ea2160b5c600f27aefa89a11623e099cd72
-  data.tar.gz: cf853e0af5eeb9352b3b697083a279a1c627c958aba7b7f33ad326745c3252ac64b838e2b5685871fa55ad2279b7ac0d274c24401a93efe02aba672fd97cabc8
+  metadata.gz: 200edf2400f1a649fe56b520f8b6168e636be63cbd34ab89f6678be3b4a10f24c40f840559d71b1b568c31667c5e94cd0afb5e51d987b12b597bc57167ea766a
+  data.tar.gz: ef8cba98917f75c53039ad9a5f719bfa8e567ed72d7aa26ea911eadc2d52d36971ce742f36e078f9f11d2eff07a2e6e9b90fa06f2a837dfc2b1c8da68f0ef1e7

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 vesper
+Copyright (c) 2026 Palmshed
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,9 +1,8 @@
-# Vesper
-<img src="website/assets/readme-header.png" alt="Vesper" width="100%">
+# Nuntius
+<img src="website/assets/nuntius-header.png" alt="Nuntius" width="100%">
 
 <br>
 
-[![Gem](https://img.shields.io/gem/v/nuntius-rb?style=flat-square&label=gem)](https://rubygems.org/gems/nuntius-rb)
 ![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-cc342d?style=flat-square)
 [![License](https://img.shields.io/badge/license-MIT-2f4858?style=flat-square)](LICENSE)
 ![Tests](https://img.shields.io/badge/tests-passing-2e7d32?style=flat-square)
@@ -29,12 +28,12 @@ With Bundler:
 <br>
 
 ```ruby
-gem 'nuntius-rb', require: 'vesper'
+gem 'nuntius-rb', require: 'nuntius'
 ```
 
 <br>
 
-The package is published as `nuntius-rb`. The runtime entrypoint is `vesper`.
+The package is published as `nuntius-rb`. The runtime entrypoint is `nuntius`.
 
 <br>
 
@@ -62,10 +61,10 @@ GEMINI_API_KEY=your_api_key
 <br>
 
 ```ruby
-require 'vesper'
-GeminiAI.load_env
+require 'nuntius'
+Nuntius.load_env
 
-client = GeminiAI::Client.new
+client = Nuntius::Client.new
 puts client.generate_text('Write a haiku about Ruby')
 ```
 
@@ -76,32 +75,31 @@ Use a different model when needed:
 <br>
 
 ```ruby
-fast_client = GeminiAI::Client.new(model: :flash)
+fast_client = Nuntius::Client.new(model: :flash)
 puts fast_client.generate_text('Explain Ruby in one sentence')
 ```
 
 <br>
 
-# generateContent Text Models
+# generateContent Text Models: Flash family (Free-Tier)
 
 <br>
 
 | Key | ID |
 | --- | --- |
 | `:flash_latest` | `gemini-flash-latest` |
-| `:pro_latest` | `gemini-pro-latest` |
+| `:flash_3_7` | `gemini-3.7-flash` |
+| `:flash_3_6` | `gemini-3.6-flash` |
 | `:flash_3_5` | `gemini-3.5-flash` |
-| `:pro_3_preview` | `gemini-3-pro-preview` |
+| `:flash_3_5_lite` | `gemini-3.5-flash-lite` |
 | `:flash_3_preview` | `gemini-3-flash-preview` |
-| `:pro_3_1_preview` | `gemini-3.1-pro-preview` |
 | `:flash_3_1_lite` | `gemini-3.1-flash-lite` |
-| `:pro_2_5` | `gemini-2.5-pro` |
 | `:flash_2_5` | `gemini-2.5-flash` |
 | `:flash_2_0` | `gemini-2.0-flash` |
 
 <br>
 
-Short aliases: `:pro` uses `gemini-pro-latest`, `:flash` uses `gemini-3.5-flash`, and `:flash_lite` uses `gemini-3.1-flash-lite`. Legacy `:pro_2_0` maps to `gemini-2.0-flash`.
+Short aliases: `:flash` uses `gemini-3.7-flash` (default), `:flash_fallback` uses `gemini-3.6-flash`, and `:flash_lite` uses `gemini-3.1-flash-lite`. Legacy `:pro_2_0` maps to `gemini-2.0-flash`. Pro models (`gemini-pro-latest`, `gemini-3.1-pro-preview`, `gemini-2.5-pro`) are retired for Free-Tier, as they resolve to the `3.1-pro` backend and hit quota `0`. Use billing to enable.
 
 <br>
 
@@ -113,7 +111,7 @@ The gem does not wrap embeddings, Imagen, or Veo APIs.
 
 <br>
 
-Vesper supports text generation, chat, image input for `generateContent`, model aliases, safety settings, API key masking, retries, and a local CLI.
+Nuntius supports text generation, chat, image input for `generateContent`, model aliases, safety settings, API key masking, retries, and a local CLI.
 
 <br>
 
@@ -121,7 +119,7 @@ Vesper supports text generation, chat, image input for `generateContent`, model
 
 <br>
 
-Client validation and API failures raise `GeminiAI::Error` with a readable message.
+Client validation and API failures raise `Nuntius::Error` with a readable message.
 HTTP 429 responses are retried automatically up to three times with exponential backoff.
 
 <br>
@@ -130,7 +128,7 @@ HTTP 429 responses are retried automatically up to three times with exponential
 begin
   response = client.generate_text('Hello')
   puts response
-rescue GeminiAI::Error => err
+rescue Nuntius::Error => err
   warn "Generation failed: #{err.message}"
 end
 ```
@@ -170,10 +168,10 @@ Requests use a 30 second HTTParty timeout.
 <br>
 
 ```ruby
-require 'vesper'
+require 'nuntius'
 
-GeminiAI::Client.logger.level = Logger::INFO
-client = GeminiAI::Client.new
+Nuntius::Client.logger.level = Logger::INFO
+client = Nuntius::Client.new
 ```
 
 <br>
@@ -224,11 +222,11 @@ gem build nuntius-rb.gemspec
 
 <br>
 
-Vesper Review is the PR review app in this repo. It defaults to `gemini-3.5-flash`; retrieval context is off unless enabled in `vesper/config.yaml`.
+Nuntius Review is the PR review app in this repo. It defaults to `gemini-3.7-flash` (fallback `gemini-3.6-flash` for large diffs). Override with `NUNTIUS_GEMINI_MODEL`. Retrieval context is off unless enabled in `nuntius/config.yaml`. Only verified `generateContent` Flash models are listed as supported. See API `GET /v1beta/models` for existence, not quota.
 
 <br>
 
-For setup details, see [`vesper/Vesper.md`](vesper/Vesper.md).
+For setup details, see [`nuntius/Nuntius.md`](nuntius/Nuntius.md).
 
 <br>
 
@@ -241,7 +239,7 @@ For setup details, see [`vesper/Vesper.md`](vesper/Vesper.md).
 <br>
 
 ```ruby
-client = GeminiAI::Client.new
+client = Nuntius::Client.new
 puts client.generate_text('Write a haiku about Ruby')
 ```
 
@@ -305,11 +303,11 @@ MIT → see [`LICENSE`](LICENSE).
 <br>
 
 <p align="center">
-  <a href="https://github.com/apps/vesper-review">
-    <img src="website/favicon.svg" alt="Vesper Review app" width="96">
+  <a href="https://github.com/apps/nuntius-review">
+    <img src="website/favicon.svg" alt="Nuntius Review app" width="96">
   </a>
 
 <br>
 
-  <a href="https://github.com/apps/vesper-review"><code>Vesper Review</code></a>
+  <a href="https://github.com/apps/nuntius-review"><code>Nuntius Review</code></a>
 </p>

data/lib/core/client.rb

@@ -1,42 +1,68 @@
 # frozen_string_literal: true
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 require 'httparty'
 require 'json'
 require 'base64'
 require 'logger'
+require 'yaml'
 require 'dotenv/load'
 require_relative 'errors'
 require_relative '../utils/moderation'
 
-module GeminiAI
+module Nuntius
   # Core client class for Gemini AI API communication
   class Client
     BASE_URL = 'https://generativelanguage.googleapis.com/v1beta/models'
-    # generateContent text model aliases.
+
+    # Canonical model source: config/models.yaml (repository-wide)
+    # This file is the single source of truth. Code must not duplicate model names.
+    CANONICAL_PATH = File.expand_path('../../config/models.yaml', __dir__)
+    CANONICAL = begin
+      if File.exist?(CANONICAL_PATH)
+        YAML.safe_load(File.read(CANONICAL_PATH)) || {}
+      else
+        {}
+      end
+    rescue StandardError
+      {}
+    end.freeze
+
+    CANONICAL_DEFAULT = (CANONICAL['default'] || 'gemini-3.7-flash').freeze
+    CANONICAL_FALLBACK = (CANONICAL['fallback'] || 'gemini-3.6-flash').freeze
+    CANONICAL_STABLE = (CANONICAL['stable_baseline'] || 'gemini-3.5-flash').freeze
+    CANONICAL_LIGHTWEIGHT = (CANONICAL['lightweight'] || ['gemini-3.1-flash-lite', 'gemini-3.5-flash-lite']).freeze
+    CANONICAL_LIGHT = CANONICAL_LIGHTWEIGHT.first || 'gemini-3.1-flash-lite'
+
+    # generateContent text model aliases: Flash family only (Free-Tier compatible).
+    # Values are derived from config/models.yaml. Do not hard-code elsewhere.
     MODELS = {
       flash_latest: 'gemini-flash-latest',
-      pro_latest: 'gemini-pro-latest',
-      flash_3_5: 'gemini-3.5-flash',
-
-      pro_3_preview: 'gemini-3-pro-preview',
+      flash_3_7: CANONICAL_DEFAULT,
+      flash_3_6: CANONICAL_FALLBACK,
+      flash_3_5: CANONICAL_STABLE,
+      flash_3_5_lite: CANONICAL_LIGHTWEIGHT[1] || 'gemini-3.5-flash-lite',
       flash_3_preview: 'gemini-3-flash-preview',
-      pro_3_1_preview: 'gemini-3.1-pro-preview',
-      flash_3_1_lite: 'gemini-3.1-flash-lite',
-      pro_2_5: 'gemini-2.5-pro',
+      flash_3_1_lite: CANONICAL_LIGHT,
       flash_2_5: 'gemini-2.5-flash',
       flash_2_0: 'gemini-2.0-flash',
 
-      # Short aliases.
-      pro: 'gemini-pro-latest',
-      flash: 'gemini-3.5-flash',
-      flash_lite: 'gemini-3.1-flash-lite',
-      pro_2_0: 'gemini-2.0-flash'
+      # Short aliases: default Flash is 3.7, fallback 3.6.
+      flash: CANONICAL_DEFAULT,
+      flash_fallback: CANONICAL_FALLBACK,
+      flash_lite: CANONICAL_LIGHT,
+      pro_2_0: 'gemini-2.0-flash' # legacy alias, resolves to Flash (gemini-2.0-flash), keep for backward compat
     }.freeze
 
-    # Deprecated models removed in this version (log warning and default to :pro)
+    # Deprecated/retired models: Pro family requires billing, not usable on Free-Tier.
+    # Kept for backward compat but warn and default to :flash (gemini-3.7-flash).
     DEPRECATED_MODELS = {
+      pro_latest: 'gemini-pro-latest',
+      pro: 'gemini-pro-latest',
+      pro_3_preview: 'gemini-3-pro-preview',
+      pro_3_1_preview: 'gemini-3.1-pro-preview',
+      pro_2_5: 'gemini-2.5-pro',
       pro_1_5: 'gemini-1.5-pro',
       flash_1_5: 'gemini-1.5-flash',
       flash_8b: 'gemini-1.5-flash-8b'
@@ -54,7 +80,7 @@ module GeminiAI
       end
     end
 
-    def initialize(api_key = nil, model: :pro)
+    def initialize(api_key = nil, model: :flash)
       # Prioritize passed API key, then environment variable
       @api_key = api_key || ENV.fetch('GEMINI_API_KEY', nil)
 
@@ -110,8 +136,8 @@ module GeminiAI
         generationConfig: build_generation_config(options)
       }
 
-      # Use the pro model for image-to-text tasks
-      apply_moderation(send_request(request_body, model: :pro), options)
+      # Use the flash model for image-to-text tasks (Free-Tier compatible)
+      apply_moderation(send_request(request_body, model: :flash), options)
     end
 
     def chat(messages, options = {})
@@ -146,13 +172,13 @@ module GeminiAI
 
     def resolve_model(model)
       if DEPRECATED_MODELS.key?(model)
-        self.class.logger.warn("Model #{model} (#{DEPRECATED_MODELS[model]}) is deprecated and has been removed. " \
-                               'Defaulting to :pro (gemini-pro-latest). Please update your code to use supported models.')
-        MODELS[:pro]
+        self.class.logger.warn("Model #{model} (#{DEPRECATED_MODELS[model]}) is deprecated/retired (Pro requires billing). " \
+                               "Defaulting to :flash (#{CANONICAL_DEFAULT}). Please update your code to use Flash models.")
+        MODELS[:flash]
       else
         MODELS.fetch(model) do
-          self.class.logger.warn("Invalid model: #{model}, defaulting to pro")
-          MODELS[:pro]
+          self.class.logger.warn("Invalid model: #{model}, defaulting to flash")
+          MODELS[:flash]
         end
       end
     end
@@ -176,8 +202,7 @@ module GeminiAI
     end
 
     def valid_api_key_format?(key)
-      # Strict format check: starts with 'AIza', reasonable length
-      key =~ /^AIza[a-zA-Z0-9_-]{35,}$/
+      key.length >= 30
     end
 
     def validate_prompt!(prompt)
@@ -205,7 +230,7 @@ module GeminiAI
       # Rate limiting - ensure minimum interval between requests
       rate_limit_delay
 
-      current_model = model ? MODELS.fetch(model) { MODELS[:pro] } : @model
+      current_model = model ? MODELS.fetch(model) { MODELS[:flash] } : @model
       url = "#{BASE_URL}/#{current_model}:generateContent?key=#{@api_key}"
 
       # Log URL with masked API key for security
@@ -219,7 +244,7 @@ module GeminiAI
           body: body.to_json,
           headers: {
             'Content-Type' => 'application/json',
-            'x-goog-api-client' => 'vesper_ruby_gem/0.1.0'
+            'x-goog-api-client' => 'nuntius_ruby_gem/0.1.0'
           },
           timeout: 30
         )

data/lib/core/errors.rb

@@ -1,10 +1,10 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 # frozen_string_literal: true
 
-module GeminiAI
-  # Base error class for all GeminiAI related errors
+module Nuntius
+  # Base error class for all Nuntius related errors
   class Error < StandardError; end
 
   # API related errors

data/lib/core/version.rb

@@ -1,8 +1,8 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 # frozen_string_literal: true
 
-module GeminiAI
-  VERSION = '1.0.0.pre'
+module Nuntius
+  VERSION = '1.0.0'
 end

data/lib/{gemini.rb → nuntius.rb}

@@ -1,18 +1,18 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 # frozen_string_literal: true
 
-# Main entry point for the GeminiAI gem
+# Main entry point for the Nuntius gem
 require_relative 'core/version'
 require_relative 'core/errors'
 require_relative 'core/client'
 require_relative 'utils/loader'
 require_relative 'utils/logger'
 
-module GeminiAI
-  # Convenience method to create a new client
-  def self.new(api_key = nil, model: :pro)
+module Nuntius
+  # Convenience method to create a new client: default is Flash (3.7) for Free-Tier
+  def self.new(api_key = nil, model: :flash)
     Client.new(api_key, model: model)
   end
 

data/lib/utils/loader.rb

@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 # frozen_string_literal: true
 
-module GeminiAI
+module Nuntius
   module Utils
     # Utility class for loading environment variables from .env files
     class Loader

data/lib/utils/logger.rb

@@ -1,11 +1,11 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
+# Copyright (c) 2026 Palmshed
 
 # frozen_string_literal: true
 
 require 'logger'
 
-module GeminiAI
+module Nuntius
   module Utils
     # Centralized logging utility
     class Logger

data/lib/utils/moderation.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module GeminiAI
+module Nuntius
   module Utils
     # Content moderation utility for filtering potentially harmful or inappropriate content
     class Moderation

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nuntius-rb
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre
+  version: 1.0.0
 platform: ruby
 authors:
 - Niladri Das
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -51,13 +50,27 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -134,28 +147,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.87.0
+        version: 1.89.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.87.0
+        version: 1.89.0
 - !ruby/object:Gem::Dependency
   name: rubocop-minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.39.1
+        version: 0.40.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.39.1
+        version: 0.40.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -182,19 +195,15 @@ files:
 - lib/core/client.rb
 - lib/core/errors.rb
 - lib/core/version.rb
-- lib/gemini.rb
-- lib/mac/README.md
-- lib/mac/mac_utils.rb
+- lib/nuntius.rb
 - lib/utils/loader.rb
 - lib/utils/logger.rb
 - lib/utils/moderation.rb
-- lib/vesper.rb
-homepage: https://github.com/bniladridas/vesper
+homepage: https://github.com/palmshed/nuntius
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -205,12 +214,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A Ruby gem for interacting with Google's Gemini AI models
 test_files: []

data/lib/mac/README.md

@@ -1,39 +0,0 @@
-# Mac Utils
-
-<br>
-
-This module provides macOS-specific utilities for the vesper gem.
-
-<br>
-
-# Methods
-
-<br>
-
-# `GeminiAI::MacUtils.mac?`
-
-<br>
-
-Returns `true` if the current platform is macOS (Darwin), `false` otherwise.
-
-<br>
-
-# `GeminiAI::MacUtils.version`
-
-<br>
-
-Returns the macOS version string (e.g., "14.1") if running on macOS, `nil` otherwise.
-
-<br>
-
-# Usage
-
-<br>
-
-```ruby
-require 'mac/mac_utils'
-
-if GeminiAI::MacUtils.mac?
-  puts "Running on macOS version #{GeminiAI::MacUtils.version}"
-end
-```

data/lib/mac/mac_utils.rb

@@ -1,15 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
-
-module GeminiAI
-  module MacUtils
-    def self.mac?
-      require 'rbconfig'
-      RbConfig::CONFIG['host_os'] =~ /darwin/
-    end
-
-    def self.version
-      `/usr/bin/sw_vers -productVersion`.strip if mac?
-    end
-  end
-end

data/lib/vesper.rb

@@ -1,7 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2026 vesper
-
-# frozen_string_literal: true
-
-# Main entry point for the vesper gem
-require_relative 'gemini'