nitro_intelligence 2.6.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92e09bec20a682ff36923a40ad1dc9d3804c3bea3da199374859d5779034d524
-  data.tar.gz: 303cfc371638d3c14e41ad2610ca2de68944c5f0877db5ab77921ec77b192dd2
+  metadata.gz: d87085d656ea4f0e2ee7ee00f1d1e360de33aa91257847a7c127ba65082b5e7c
+  data.tar.gz: f7587153b62be7ab17a60302ce8438ab483d35e9b499aee634c69cd1388cf2a9
 SHA512:
-  metadata.gz: 1d7b784fb71aa635ec0f6dc6388b6925312200e4cb757a6598b498ea0c8632bfd1413cbe6dd2a192244bd206d83f335a8865f3387d11d038092beeac65ae5397
-  data.tar.gz: 6225968bb8d513bffe785dbf91aba771bfdf0306571f8d3150489a839e8780c60b1ab7e15608f310ac56305c8dfd643b7b00a312485db3c3ee716d7573f895b7
+  metadata.gz: ea8307af597a82b4e7511589eb5258ab1006805a63e3cc358dc7db6b2ca55882b0e522701667d7b98f5d851e89b214b9290d3c9330ff27a8957290c3c00584c8
+  data.tar.gz: 9a891b5281ec8f6f34b4611ab8a0204027b5c14a9b63ea02999f273386a06ab9b4d2a5410b18be0041b6acb4ad7ace1f8146c2115148dc81d70c12b2372a37a6

data/docs/README.md

@@ -18,10 +18,10 @@ NitroIntelligence.configure do |config|
 
   # Inference (LLM) settings
   config.inference_api_key  = "..."              # API key for the inference service
-  config.inference_base_url = "https://..."      # Base URL for the inference service
+  config.inference_base_url = "https://..."      # Base URL for the inference service (optional; defaults to the inference gateway)
 
   # Observability (Langfuse) settings
-  config.observability_base_url = "https://..."  # Base URL for the observability service
+  config.observability_base_url = "https://..."  # Base URL for the observability service (optional; defaults to Cerebro)
   config.observability_projects = [              # Array of project credential hashes
     {
       "slug"       => "my-feature-project",
@@ -83,10 +83,10 @@ end
 | `environment`            | `String`      | `"test"`              | Runtime environment name                                                                                                                                                                                   |
 | `cache_provider`         | cache store   | `NullCache`           | ActiveSupport-compatible cache store                                                                                                                                                                       |
 | `inference_api_key`      | `String`      | `""`                  | API key for the LLM inference service                                                                                                                                                                      |
-| `inference_base_url`     | `String`      | `""`                  | Base URL for the LLM inference service                                                                                                                                                                     |
-| `observability_base_url` | `String`      | `""`                  | Base URL for the Langfuse observability service                                                                                                                                                            |
+| `inference_base_url`     | `String`      | `"https://inference.powerhome.ai"` | Base URL for the LLM inference service. Defaults to the shared inference gateway, so only a host talking to a different one needs to set it                                                                 |
+| `observability_base_url` | `String`      | `"https://cerebro.powerhome.ai"` | Base URL for the Langfuse observability service. Defaults to Cerebro, so only a host talking to a different one needs to set it                                                                             |
 | `observability_projects` | `Array<Hash>` | `[]`                  | Langfuse project credentials (slug, id, public_key, secret_key)                                                                                                                                            |
-| `assistants_config`      | `Hash`        | `{}`                  | Assistants to make addressable by key. `base_url` (String) and `user_id` (String, default: `"default-user"`) are shared by every entry; `definitions` (Hash) holds one entry per assistant, keyed by what it is looked up with, each able to override a shared value. Without `definitions` the hash is read as credentials for a single `Assistants.new` — see [Assistants](#assistants) |
+| `assistants_config`      | `Hash`        | `{}`                  | Assistants to make addressable by key. `base_url` (String, default: `"https://assistants.powerhome.ai"`) and `user_id` (String, default: `"default-user"`) are shared by every entry; `definitions` (Hash) holds one entry per assistant, keyed by what it is looked up with, each able to override a shared value. Without `definitions` the hash is read as credentials for a single `Assistants.new`, which takes the same two defaults — see [Assistants](#assistants) |
 | `model_config`           | `Hash`        | `{}`                  | Model defaults and per-model settings. Top-level keys: `default_text_model`, `default_audio_transcription_model`, `default_image_model`, `default_text_to_speech_model`, and `models` (array of per-model hashes keyed by `name` and `type`, with type-specific options like `aspect_ratios`/`resolutions` for images or `voices`/`response_formats` for TTS) |
 
 ## Basic Usage
@@ -525,6 +525,7 @@ entry per assistant, keyed by what you look it up with:
 
 ```ruby
 config.assistants_config = {
+  # Optional. Defaults to the shared Assistants deployment.
   "base_url" => "https://nip-assistants.example.com",
   "user_id" => "my-app",
   "definitions" => {
@@ -562,9 +563,14 @@ convention, so nothing here is tied to one deployment's wiring.
 
 A key that resolves without them raises `Assistant::ConfigurationError`, naming every field it
 is missing at once so a host resolving them from elsewhere can see which lookup failed.
+`base_url` is not among them: an entry that says nothing about where to reach its assistant
+gets `https://assistants.powerhome.ai`, so only a host talking to a different deployment — a
+review environment, a local server — sets it.
 
 ### Without `definitions`
 
 `assistants_config` lacking `definitions` is read as keyword arguments for a single
 `Assistants` client, and `NitroIntelligence.assistants` returns that client rather than a
 registry. This is the shape that predates lookup by key; a host still on it is left alone.
+`base_url` is optional here too, and a configuration without one reaches the same shared
+deployment.

data/lib/nitro_intelligence/assistant.rb

@@ -1,3 +1,5 @@
+require "nitro_intelligence/assistants"
+
 module NitroIntelligence
   # One assistant resolved by name: the client for its deployment, plus the id every run has to
   # carry.
@@ -8,8 +10,10 @@ module NitroIntelligence
   class Assistant
     class ConfigurationError < StandardError; end
 
-    DEFAULT_USER_ID = "default-user".freeze
-    REQUIRED = %w[base_url api_key assistant_id].freeze
+    DEFAULT_USER_ID = Assistants::DEFAULT_USER_ID
+
+    # `base_url` is not among them: the client defaults it, so it cannot be missing.
+    REQUIRED = %w[api_key assistant_id].freeze
 
     # The key an assistant is filed and looked up under. Not its name: an entry usually carries
     # a `name` of its own, a human-readable label for the assistant's record, and the two are
@@ -25,7 +29,7 @@ module NitroIntelligence
     # application has no use for, such as the graph or the observability project it reports to.
     def initialize(key, base_url: nil, api_key: nil, assistant_id: nil, user_id: nil, **_kwargs)
       @key = key.to_s
-      @base_url = base_url.presence
+      @base_url = base_url.presence || Assistants::DEFAULT_BASE_URL
       @api_key = api_key.presence
       @assistant_id = assistant_id.presence
       @user_id = user_id.presence || DEFAULT_USER_ID
@@ -66,7 +70,7 @@ module NitroIntelligence
     # Reported together and named, since a host resolving these from somewhere else needs to
     # know which one it failed to supply.
     def validate!
-      values = { "base_url" => @base_url, "api_key" => @api_key, "assistant_id" => @assistant_id }
+      values = { "api_key" => @api_key, "assistant_id" => @assistant_id }
       missing = REQUIRED.select { |field| values[field].blank? }
       return if missing.empty?
 

data/lib/nitro_intelligence/assistant_registry.rb

@@ -59,7 +59,11 @@ module NitroIntelligence
               "Configured: #{keys.sort.join(', ').presence || '(none)'}"
       end
 
-      attributes = @config.slice(*SHARED_KEYS).merge(definition.to_h.deep_stringify_keys)
+      # Blank entry values are dropped rather than merged, so a definition built from a source
+      # that writes an unset field as null falls back to the shared setting instead of shadowing
+      # it with nothing.
+      entry = definition.to_h.deep_stringify_keys.compact_blank
+      attributes = @config.slice(*SHARED_KEYS).merge(entry)
       Assistant.new(key, **attributes.symbolize_keys)
     end
   end

data/lib/nitro_intelligence/assistants.rb

@@ -14,14 +14,20 @@ module NitroIntelligence
     # Assistants answers with a conflict when `ifExists: "raise"` is sent for a thread that already exists.
     THREAD_CONFLICT_CODE = 409
 
+    # Every assistant this gem is built for is served by the same deployment, so a client told
+    # nothing about where to reach one gets that deployment. A host talking to a different one
+    # -- a review environment, a local server -- still says so.
+    DEFAULT_BASE_URL = "https://assistants.powerhome.ai".freeze
+
+    DEFAULT_USER_ID = "default-user".freeze
+
     attr_reader :base_url, :user_id
 
-    def initialize(base_url:, api_key:, user_id: "default-user")
-      raise ConfigurationError, "base_url is required" if base_url.blank?
+    def initialize(api_key:, base_url: nil, user_id: DEFAULT_USER_ID)
       raise ConfigurationError, "api_key is required" if api_key.blank?
       raise ConfigurationError, "user_id is required" if user_id.blank?
 
-      @base_url = base_url
+      @base_url = base_url.presence || DEFAULT_BASE_URL
       @api_key = api_key
       @user_id = user_id
       @tool_call_review_validator = ToolCallReviewValidator.new

data/lib/nitro_intelligence/configuration.rb

@@ -12,9 +12,9 @@ module NitroIntelligence
     config_accessor :environment, default: "test"
     config_accessor :assistants_config, default: {}
     config_accessor :inference_api_key, default: ""
-    config_accessor :inference_base_url, default: ""
+    config_accessor :inference_base_url, default: "https://inference.powerhome.ai"
     config_accessor :model_config, default: {}
-    config_accessor :observability_base_url, default: ""
+    config_accessor :observability_base_url, default: "https://cerebro.powerhome.ai"
     config_accessor :observability_projects, default: []
     config_accessor :observability_user_id, default: ""
 

data/lib/nitro_intelligence/version.rb

@@ -1,3 +1,3 @@
 module NitroIntelligence
-  VERSION = "2.6.0".freeze
+  VERSION = "2.7.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nitro_intelligence
 version: !ruby/object:Gem::Version
-  version: 2.6.0
+  version: 2.7.0
 platform: ruby
 authors:
 - Igor Artemenko