ai-chat 0.5.4 → 0.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9012bf87a54da64ccab695a2d440249cf691f2f5943272c918065b24137fa6fb
-  data.tar.gz: 9d3931249dc62145f8eb3cc3fc44382a038c901b8bfc4a2ccda0d01d8653489d
+  metadata.gz: e997805c08f99471c8ebb6ed5fe4ebaf1662f2934e3831e0c263dc8190803e95
+  data.tar.gz: faed24eeb06233ac4ad19c3f3300858e39a6fff938cee15ec69d3466acf0aa4f
 SHA512:
-  metadata.gz: d9447afcbff626605c7b865675cd28d598e2c3cee19010aa86a9955b5a3cf109ea68ea40765bfe9aa92f43d823710eb91f7d4b3cfd92d4105c02f6ad9e45bdc9
-  data.tar.gz: 5ae2565d62ae358f62938a5b888e55d73bc581449e0f0e1c4de836f713832c1bf19fe0e9ba6d8ae0c4b108323532ab5e905dc22079e0aa4ecc833b6a9b884386
+  metadata.gz: 15dfedd0a5e5fec19d76acd155e4384cbbc5c7aa46fc88cf706cfb4ed5184e94ae1886afcc29c44bf6bb7f01ccb227f7e77cc1735b753226a9bb455968ff522f
+  data.tar.gz: 35dea135530c56c31da1e24265feb31f303402068f67b83f0badfc0b30a3ba571eff7b0644e71fa87727d6e864e2df90b6e00bae9d0c94a383f93e713175d3b5

data/README.md

@@ -671,6 +671,15 @@ The `reasoning_effort` parameter guides the model on how many reasoning tokens t
 
 By default, `reasoning_effort` is `nil`, which means no reasoning parameter is sent to the API. For `gpt-5.2` (the default model), this is equivalent to `"none"` reasoning.
 
+## Verbosity
+
+Verbosity determines how many output tokens are generated. Lowering the number of tokens reduces overall latency. While the model's reasoning approach stays mostly the same, the model finds ways to answer more concisely—which can either improve or diminish answer quality, depending on your use case. Here are some scenarios for both ends of the verbosity spectrum:
+
+- High verbosity: Use when you need the model to provide thorough explanations of documents or perform extensive code refactoring.
+- Low verbosity: Best for situations where you want concise answers or simple code generation, such as SQL queries.
+
+The supported values are `:high`, `:medium`, or `:low`. The default value is `:medium` for `gpt-5.2`. **Older models (like `gpt-4.1-nano`) only support `:medium`**.
+
 ## Advanced: Response Details
 
 When you call `generate!` (or later call `get_response` in background mode), the gem stores additional information about the API response:

data/ai-chat.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "ai-chat"
-  spec.version = "0.5.4"
+  spec.version = "0.5.5"
   spec.authors = ["Raghu Betina", "Jelani Woods"]
   spec.email = ["raghu@firstdraft.com", "jelani@firstdraft.com"]
   spec.homepage = "https://github.com/firstdraft/ai-chat"

data/lib/ai/chat.rb

@@ -19,7 +19,7 @@ module AI
   class Chat
     # :reek:Attribute
     attr_accessor :background, :code_interpreter, :conversation_id, :image_generation, :image_folder, :messages, :model, :reasoning_effort, :web_search
-    attr_reader :client, :last_response_id, :proxy, :schema, :schema_file
+    attr_reader :client, :last_response_id, :proxy, :schema, :schema_file, :verbosity
 
     BASE_PROXY_URL = "https://prepend.me/api.openai.com/v1"
 
@@ -34,6 +34,7 @@ module AI
       @image_generation = false
       @image_folder = "./images"
       @api_key_validated = false
+      @verbosity = :medium
     end
 
     def self.generate_schema!(description, location: "schema.json", api_key: nil, api_key_env_var: "OPENAI_API_KEY", proxy: false)
@@ -183,6 +184,14 @@ module AI
       self.schema = content
     end
 
+    def verbosity=(value)
+      if ["low", "medium", "high"].include?(value.to_s)
+        @verbosity = value.to_sym
+      else
+        raise ArgumentError, "Invalid verbosity value:'#{value}'. Must be one of :low, :medium, :high."
+      end
+    end
+
     def last
       messages.last
     end
@@ -221,6 +230,7 @@ module AI
       attrs << [:@web_search, @web_search] if @web_search
       attrs << [:@schema, @schema] if @schema
       attrs << [:@schema_file, @schema_file] if @schema_file
+      attrs << [:@verbosity, verbosity] if verbosity
 
       attrs
     end
@@ -274,6 +284,7 @@ module AI
 
       create_conversation unless conversation_id
       parameters[:conversation] = conversation_id
+      parameters[:text] = (parameters[:text] || {}).merge(verbosity: verbosity) if verbosity
 
       messages_to_send = prepare_messages_for_api
       parameters[:input] = strip_responses(messages_to_send) unless messages_to_send.empty?

data/lib/ai/items.rb

@@ -1,14 +1,28 @@
 # frozen_string_literal: true
 
-require "delegate"
-
 module AI
-  class Items < SimpleDelegator
+  # NOTE: This is intentionally *not* a SimpleDelegator.
+  #
+  # IRB's default inspector uses PP, and PP has special handling for Delegator
+  # instances that unwraps them (via __getobj__) before printing. That causes
+  # IRB to display the underlying OpenAI cursor page instead of our custom
+  # formatted output.
+  #
+  # By using a plain wrapper + method_missing delegation, `chat.get_items`
+  # displays nicely in IRB/Rails console while still forwarding API helpers
+  # like `.data`, `.has_more`, etc.
+  class Items
     def initialize(response, conversation_id:)
-      super(response)
+      @response = response
       @conversation_id = conversation_id
     end
 
+    attr_reader :response
+
+    def data
+      response.data
+    end
+
     def to_html
       AI.wrap_html(build_output(html: true))
     end
@@ -25,6 +39,16 @@ module AI
       q.output << inspect
     end
 
+    def method_missing(method_name, *args, &block)
+      return super unless response.respond_to?(method_name)
+
+      response.public_send(method_name, *args, &block)
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      response.respond_to?(method_name, include_private) || super
+    end
+
     private
 
     def build_output(html: false, plain: false)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ai-chat
 version: !ruby/object:Gem::Version
-  version: 0.5.4
+  version: 0.5.5
 platform: ruby
 authors:
 - Raghu Betina