nuntius-rb 1.0.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e94e856798181b8d99d873394ea2dacfcdfbe5ee04e10933dbf45145ee7f09b0
+  data.tar.gz: e742055df4793f45133dc3116f0d8fb6f31b417fa361db28605b58d137c90ba6
+SHA512:
+  metadata.gz: f59b7bdcc9d294d42458499f701894c90d473a38bfd3866f54a883c670380263175951acf898464156b8e943ab083ea2160b5c600f27aefa89a11623e099cd72
+  data.tar.gz: cf853e0af5eeb9352b3b697083a279a1c627c958aba7b7f33ad326745c3252ac64b838e2b5685871fa55ad2279b7ac0d274c24401a93efe02aba672fd97cabc8

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vesper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,315 @@
+# Vesper
+<img src="website/assets/readme-header.png" alt="Vesper" 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)
+
+<br>
+
+Ruby client for Gemini `generateContent`. Includes a CLI and a PR review app.
+
+<br>
+
+# Installation
+
+<br>
+
+```bash
+gem install nuntius-rb
+```
+
+<br>
+
+With Bundler:
+
+<br>
+
+```ruby
+gem 'nuntius-rb', require: 'vesper'
+```
+
+<br>
+
+The package is published as `nuntius-rb`. The runtime entrypoint is `vesper`.
+
+<br>
+
+Set your API key in `.env`:
+
+<br>
+
+```
+GEMINI_API_KEY=your_api_key
+```
+
+<br>
+
+> [!NOTE]
+> Ensure your API key is kept secure and not committed to version control.
+
+<br>
+
+# Usage
+
+<br>
+
+# Basic Setup
+
+<br>
+
+```ruby
+require 'vesper'
+GeminiAI.load_env
+
+client = GeminiAI::Client.new
+puts client.generate_text('Write a haiku about Ruby')
+```
+
+<br>
+
+Use a different model when needed:
+
+<br>
+
+```ruby
+fast_client = GeminiAI::Client.new(model: :flash)
+puts fast_client.generate_text('Explain Ruby in one sentence')
+```
+
+<br>
+
+# generateContent Text Models
+
+<br>
+
+| Key | ID |
+| --- | --- |
+| `: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_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`.
+
+<br>
+
+The gem does not wrap embeddings, Imagen, or Veo APIs.
+
+<br>
+
+# Capabilities
+
+<br>
+
+Vesper supports text generation, chat, image input for `generateContent`, model aliases, safety settings, API key masking, retries, and a local CLI.
+
+<br>
+
+# Handling Errors
+
+<br>
+
+Client validation and API failures raise `GeminiAI::Error` with a readable message.
+HTTP 429 responses are retried automatically up to three times with exponential backoff.
+
+<br>
+
+```ruby
+begin
+  response = client.generate_text('Hello')
+  puts response
+rescue GeminiAI::Error => err
+  warn "Generation failed: #{err.message}"
+end
+```
+
+<br>
+
+Common failures include:
+
+<br>
+
+- Missing or invalid `GEMINI_API_KEY`
+- Empty prompts
+- Prompts over the configured maximum length
+- Gemini API errors returned by the service
+- Network errors raised by HTTParty
+
+<br>
+
+# Retries
+
+<br>
+
+Rate-limit responses (`429`) are retried up to three times with waits of 5, 10, and 20 seconds.
+
+<br>
+
+# Timeouts
+
+<br>
+
+Requests use a 30 second HTTParty timeout.
+
+<br>
+
+# Logging
+
+<br>
+
+```ruby
+require 'vesper'
+
+GeminiAI::Client.logger.level = Logger::INFO
+client = GeminiAI::Client.new
+```
+
+<br>
+
+# Requirements
+
+<br>
+
+Ruby 3.3 or later. Linux and macOS are tested.
+
+<br>
+
+# Environment Variables
+
+<br>
+
+```bash
+GEMINI_API_KEY=your_api_key_here
+```
+
+<br>
+
+# Repo CLI
+
+<br>
+
+```bash
+./bin/gemini test
+./bin/gemini generate "Your prompt"
+./bin/gemini chat
+```
+
+<br>
+
+# Local Development & Testing
+
+<br>
+
+```bash
+bundle exec rake test          # Run tests
+bundle exec rake docs          # Build API docs
+gem build nuntius-rb.gemspec
+```
+
+<br>
+
+# Review App
+
+<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`.
+
+<br>
+
+For setup details, see [`vesper/Vesper.md`](vesper/Vesper.md).
+
+<br>
+
+# Examples
+
+<br>
+
+# Text Generation
+
+<br>
+
+```ruby
+client = GeminiAI::Client.new
+puts client.generate_text('Write a haiku about Ruby')
+```
+
+<br>
+
+# Image Analysis
+
+<br>
+
+```ruby
+image_data = Base64.strict_encode64(File.binread('path/to/image.jpg'))
+puts client.generate_image_text(image_data, 'Describe this image')
+```
+
+<br>
+
+# Chat
+
+<br>
+
+```ruby
+messages = [
+  { role: 'user', content: 'Hello!' },
+  { role: 'model', content: 'Hi there!' },
+  { role: 'user', content: 'Tell me about Ruby.' }
+]
+puts client.chat(messages, system_instruction: 'Be concise.')
+```
+
+<br>
+
+# Documentation
+
+<br>
+
+| Need | Link |
+| --- | --- |
+| Start | [`Quickstart`](docs/start/quickstart.md) |
+| API | [`Reference`](docs/reference/api.md) |
+| Recipes | [`Cookbook`](docs/reference/cookbook.md) |
+| Practice | [`Best practices`](docs/guides/practices.md) |
+| Automation | [`Workflows`](docs/guides/workflows.md) |
+| Project | [`Contributing`](docs/CONTRIBUTING.md) |
+
+<br>
+
+# Contributing
+
+<br>
+
+Fork the repo and open a pull request.
+
+<br>
+
+# License
+
+<br>
+
+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>
+
+<br>
+
+  <a href="https://github.com/apps/vesper-review"><code>Vesper Review</code></a>
+</p>

data/lib/core/client.rb

@@ -0,0 +1,288 @@
+# frozen_string_literal: true
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 vesper
+
+require 'httparty'
+require 'json'
+require 'base64'
+require 'logger'
+require 'dotenv/load'
+require_relative 'errors'
+require_relative '../utils/moderation'
+
+module GeminiAI
+  # Core client class for Gemini AI API communication
+  class Client
+    BASE_URL = 'https://generativelanguage.googleapis.com/v1beta/models'
+    # generateContent text model aliases.
+    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_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',
+
+      # 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'
+    }.freeze
+
+    # Deprecated models removed in this version (log warning and default to :pro)
+    DEPRECATED_MODELS = {
+      pro_1_5: 'gemini-1.5-pro',
+      flash_1_5: 'gemini-1.5-flash',
+      flash_8b: 'gemini-1.5-flash-8b'
+    }.freeze
+
+    # Configure logging
+    def self.logger
+      @logger ||= Logger.new($stdout).tap do |log|
+        log.level = Logger::DEBUG
+        log.formatter = proc do |severity, datetime, _progname, msg|
+          # Mask any potential API key in logs
+          masked_msg = msg.to_s.gsub(/AIza[a-zA-Z0-9_-]{35,}/, '[REDACTED]')
+          "#{datetime}: #{severity} -- #{masked_msg}\n"
+        end
+      end
+    end
+
+    def initialize(api_key = nil, model: :pro)
+      # Prioritize passed API key, then environment variable
+      @api_key = api_key || ENV.fetch('GEMINI_API_KEY', nil)
+
+      # Rate limiting - track last request time
+      @last_request_time = nil
+      # More conservative rate limiting in CI environments
+      @min_request_interval = ENV['CI'] == 'true' || ENV['GITHUB_ACTIONS'] == 'true' ? 3.0 : 1.0
+
+      # Extensive logging for debugging
+      self.class.logger.debug('Initializing Client')
+      self.class.logger.debug("API Key present: #{!@api_key.nil?}")
+      self.class.logger.debug("API Key length: #{@api_key&.length}")
+
+      # Validate API key before proceeding
+      validate_api_key!
+
+      @model = resolve_model(model)
+
+      self.class.logger.debug("Selected model: #{@model}")
+    end
+
+    def generate_text(prompt, options = {})
+      validate_prompt!(prompt)
+
+      request_body = {
+        contents: [{ parts: [{ text: prompt }] }],
+        generationConfig: build_generation_config(options)
+      }
+
+      # Add safety settings if provided
+      if options[:safety_settings]
+        request_body[:safetySettings] = options[:safety_settings].map do |setting|
+          {
+            category: setting[:category],
+            threshold: setting[:threshold]
+          }
+        end
+      end
+
+      apply_moderation(send_request(request_body), options)
+    end
+
+    def generate_image_text(image_base64, prompt, options = {})
+      raise Error, 'Image is required' if image_base64.nil? || image_base64.empty?
+
+      request_body = {
+        contents: [
+          { parts: [
+            { inline_data: { mime_type: 'image/jpeg', data: image_base64 } },
+            { text: prompt }
+          ] }
+        ],
+        generationConfig: build_generation_config(options)
+      }
+
+      # Use the pro model for image-to-text tasks
+      apply_moderation(send_request(request_body, model: :pro), options)
+    end
+
+    def chat(messages, options = {})
+      request_body = {
+        contents: messages.map { |msg| { role: msg[:role], parts: [{ text: msg[:content] }] } },
+        generationConfig: build_generation_config(options)
+      }
+
+      # Add system instruction if provided
+      if options[:system_instruction]
+        request_body[:systemInstruction] = {
+          parts: [
+            { text: options[:system_instruction] }
+          ]
+        }
+      end
+
+      apply_moderation(send_request(request_body), options)
+    end
+
+    private
+
+    def apply_moderation(response, options)
+      if options[:moderate]
+        moderated, warnings = Utils::Moderation.moderate_text(response)
+        warnings.each { |w| self.class.logger.warn(w) } unless warnings.empty?
+        moderated
+      else
+        response
+      end
+    end
+
+    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]
+      else
+        MODELS.fetch(model) do
+          self.class.logger.warn("Invalid model: #{model}, defaulting to pro")
+          MODELS[:pro]
+        end
+      end
+    end
+
+    def validate_api_key!
+      if @api_key.nil? || @api_key.to_s.strip.empty?
+        self.class.logger.error('API key is missing')
+        raise Error, 'API key is required. Set GEMINI_API_KEY environment variable or pass key directly.'
+      end
+
+      # Optional: Add basic API key format validation
+      unless valid_api_key_format?(@api_key)
+        self.class.logger.error('Invalid API key format')
+        raise Error, 'Invalid API key format. Please check your key.'
+      end
+
+      # Optional: Check key length and complexity
+      return unless @api_key.length < 40
+
+      self.class.logger.warn('Potentially weak API key detected')
+    end
+
+    def valid_api_key_format?(key)
+      # Strict format check: starts with 'AIza', reasonable length
+      key =~ /^AIza[a-zA-Z0-9_-]{35,}$/
+    end
+
+    def validate_prompt!(prompt)
+      if prompt.nil? || prompt.strip.empty?
+        self.class.logger.error('Empty prompt provided')
+        raise Error, 'Prompt cannot be empty'
+      end
+
+      return unless prompt.length > 8192
+
+      self.class.logger.error('Prompt exceeds maximum length')
+      raise Error, 'Prompt too long (max 8192 tokens)'
+    end
+
+    def build_generation_config(options)
+      {
+        temperature: options[:temperature] || 0.7,
+        maxOutputTokens: options[:max_tokens] || 1024,
+        topP: options[:top_p] || 0.9,
+        topK: options[:top_k] || 40
+      }
+    end
+
+    def send_request(body, model: nil, retry_count: 0)
+      # Rate limiting - ensure minimum interval between requests
+      rate_limit_delay
+
+      current_model = model ? MODELS.fetch(model) { MODELS[:pro] } : @model
+      url = "#{BASE_URL}/#{current_model}:generateContent?key=#{@api_key}"
+
+      # Log URL with masked API key for security
+      masked_url = "#{BASE_URL}/#{current_model}:generateContent?key=#{mask_api_key(@api_key)}"
+      self.class.logger.debug("Request URL: #{masked_url}")
+      self.class.logger.debug("Request Body: #{body.to_json}")
+
+      begin
+        response = HTTParty.post(
+          url,
+          body: body.to_json,
+          headers: {
+            'Content-Type' => 'application/json',
+            'x-goog-api-client' => 'vesper_ruby_gem/0.1.0'
+          },
+          timeout: 30
+        )
+
+        self.class.logger.debug("Response Code: #{response.code}")
+        self.class.logger.debug("Response Body: #{response.body}")
+
+        parse_response(response, retry_count, body, model)
+      rescue HTTParty::Error, Net::OpenTimeout => e
+        self.class.logger.error("API request failed: #{e.message}")
+        raise Error, "API request failed: #{e.message}"
+      end
+    end
+
+    def parse_response(response, retry_count, body, model)
+      case response.code
+      when 200
+        text = response.parsed_response
+                       .dig('candidates', 0, 'content', 'parts', 0, 'text')
+        text || 'No response generated'
+      when 429
+        # Rate limit exceeded - implement exponential backoff
+        max_retries = 3
+        if retry_count < max_retries
+          wait_time = (2**retry_count) * 5 # 5, 10, 20 seconds
+          self.class.logger.warn("Rate limit hit (429). Retrying in #{wait_time}s (attempt #{retry_count + 1}/#{max_retries})")
+          sleep(wait_time)
+          send_request(body, model: model, retry_count: retry_count + 1)
+        else
+          self.class.logger.error("Rate limit exceeded after #{max_retries} retries")
+          raise Error, 'Rate limit exceeded. Please check your quota and billing details.'
+        end
+      else
+        error_message = response.parsed_response['error']&.dig('message') || response.body
+        self.class.logger.error("API Error: #{error_message}")
+        raise Error, "API Error: #{error_message}"
+      end
+    end
+
+    # Rate limiting to prevent hitting API limits
+    def rate_limit_delay
+      current_time = Time.now
+
+      if @last_request_time
+        time_since_last = current_time - @last_request_time
+        if time_since_last < @min_request_interval
+          sleep_time = @min_request_interval - time_since_last
+          self.class.logger.debug("Rate limiting: sleeping #{sleep_time.round(2)}s")
+          sleep(sleep_time)
+        end
+      end
+
+      @last_request_time = Time.now
+    end
+
+    # Mask API key for logging and error reporting
+    def mask_api_key(key)
+      return '[REDACTED]' if key.nil?
+
+      # Keep first 4 and last 4 characters, replace middle with asterisks
+      return key if key.length <= 8
+
+      "#{key[0, 4]}#{'*' * (key.length - 8)}#{key[-4, 4]}"
+    end
+  end
+end

data/lib/core/errors.rb

@@ -0,0 +1,24 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 vesper
+
+# frozen_string_literal: true
+
+module GeminiAI
+  # Base error class for all GeminiAI related errors
+  class Error < StandardError; end
+
+  # API related errors
+  class APIError < Error; end
+
+  # Authentication errors
+  class AuthenticationError < Error; end
+
+  # Rate limit errors
+  class RateLimitError < Error; end
+
+  # Invalid request errors
+  class InvalidRequestError < Error; end
+
+  # Network/connection errors
+  class NetworkError < Error; end
+end

data/lib/core/version.rb

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

data/lib/gemini.rb

@@ -0,0 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 vesper
+
+# frozen_string_literal: true
+
+# Main entry point for the GeminiAI 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)
+    Client.new(api_key, model: model)
+  end
+
+  # Load environment variables
+  def self.load_env(file_path = '.env')
+    Utils::Loader.load(file_path)
+  end
+end

data/lib/mac/README.md

@@ -0,0 +1,39 @@
+# 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

@@ -0,0 +1,15 @@
+# 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/utils/loader.rb

@@ -0,0 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 vesper
+
+# frozen_string_literal: true
+
+module GeminiAI
+  module Utils
+    # Utility class for loading environment variables from .env files
+    class Loader
+      def self.load(file_path = '.env')
+        return unless File.exist?(file_path)
+
+        File.readlines(file_path).each do |line|
+          line = line.strip
+          next if line.empty? || line.start_with?('#')
+
+          key, value = line.split('=', 2)
+          ENV[key] = value if key && value
+        end
+      end
+    end
+  end
+end

data/lib/utils/logger.rb

@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 vesper
+
+# frozen_string_literal: true
+
+require 'logger'
+
+module GeminiAI
+  module Utils
+    # Centralized logging utility
+    class Logger
+      def self.instance
+        @instance ||= ::Logger.new($stdout).tap do |log|
+          log.level = ::Logger::INFO
+          log.formatter = proc do |severity, datetime, _progname, msg|
+            # Mask any potential API key in logs
+            masked_msg = msg.to_s.gsub(/AIza[a-zA-Z0-9_-]{35,}/, '[REDACTED]')
+            "#{datetime}: #{severity} -- #{masked_msg}\n"
+          end
+        end
+      end
+
+      def self.debug(message)
+        instance.debug(message)
+      end
+
+      def self.info(message)
+        instance.info(message)
+      end
+
+      def self.warn(message)
+        instance.warn(message)
+      end
+
+      def self.error(message)
+        instance.error(message)
+      end
+    end
+  end
+end

data/lib/utils/moderation.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module GeminiAI
+  module Utils
+    # Content moderation utility for filtering potentially harmful or inappropriate content
+    class Moderation
+      # Patterns for detecting potentially harmful content
+      HARMFUL_PATTERNS = [
+        /\b(hack|exploit|malware|virus|trojan|ransomware)/i,
+        /\b(illegal|unlawful|criminal)/i,
+        /\b(violence|kill|harm|attack)/i,
+        /\b(drug|weapon|nuclear)/i
+      ].freeze
+
+      # Moderate text by checking for harmful patterns and redacting them
+      # Returns [moderated_text, warnings_array]
+      def self.moderate_text(text)
+        return [text, []] unless text.is_a?(String)
+
+        moderated = text.dup
+        warnings = []
+
+        HARMFUL_PATTERNS.each do |pattern|
+          if moderated.gsub!(pattern, '[REDACTED]')
+            warnings << "Detected potentially harmful pattern: #{pattern.inspect}"
+          end
+        end
+
+        [moderated, warnings]
+      end
+    end
+  end
+end

data/lib/vesper.rb

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

metadata

@@ -0,0 +1,216 @@
+--- !ruby/object:Gem::Specification
+name: nuntius-rb
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre
+platform: ruby
+authors:
+- Niladri Das
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: logger
+  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: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.4.2
+- !ruby/object:Gem::Dependency
+  name: github-markup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.34
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.34
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.87.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.87.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+description: Provides text generation with Google's Gemini AI models
+email:
+- bniladridas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- 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/utils/loader.rb
+- lib/utils/logger.rb
+- lib/utils/moderation.rb
+- lib/vesper.rb
+homepage: https://github.com/bniladridas/vesper
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: A Ruby gem for interacting with Google's Gemini AI models
+test_files: []