ask-core 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5579b4c8482eca770eebc83285f046ad7797d1a032f8d55e355028c7986a9776
-  data.tar.gz: 4d21bf4c9c13690ff1368b01a364ff7f961de2347660fdb33bc989ff0635c418
+  metadata.gz: e87a2c3690127974ace8b8143002728a1eb6bebbaae9d54b321c5f4342c20485
+  data.tar.gz: 605fb219de7a80fcf33a97b21a9a2149f688e7bdd25a066484f235e41e127420
 SHA512:
-  metadata.gz: b309f9490cde3fc1c6b0712757256804af5b34f562d7114596e8cf4c69f4fb273558afd05e5545bab22fdcce13f9d0bb2214f1ef3794776a96fea8576900804c
-  data.tar.gz: 19ceabf03606c291b4edea7ec222cc8152d61a13be16429428906325d2334b21ff4c97d328731a2264c9b6f5b26c9dc0d34481c30dbb0e2d69f71a4d6b048dc3
+  metadata.gz: 1b8852000559343d48f693bb80cda7b7bc4ed9ecf935fc3e2336c80798277a35e31e4dd37a8453ae9d69adbc88a3e80650f26b6eaf64fa7d757f0711301106c1
+  data.tar.gz: 8713f24a5530fbc86f347016e3eb811e4e2ddb14cf5d08368bf6f8d28ffa3aa5c32127a91c75923146ffc3e940295a6edff2bab4c2df7838f50bd207e7dc3232

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.2.3] — 2026-07-14
+
+### Changed
+- `Ask::ModelCatalog.find(model_id)` now returns `Array<Ask::ModelInfo>` (all matches) — provider preference disambiguation is removed. Provider-scoped `find(model_id, provider)` still returns a single model or raises.
+- Removed `Ask::ModelCatalog::PROVIDER_PREFERENCE`. No preference list anywhere — all providers and models are treated equally.
+
 ## [0.2.2] — 2026-07-14
 
 ### Added

data/lib/ask/models.rb

@@ -256,12 +256,11 @@ module Ask
     end
   end
 
-  # Catalog of available AI models. Provides model resolution by name/ID,
-  # filtering by capability, and refresh from the models.dev API.
+  # Catalog of available AI models.
   #
-  #   Ask::ModelCatalog.find("gpt-4o")
-  #   Ask::ModelCatalog.chat_models
-  #   Ask::ModelCatalog.refresh!
+  #   Ask::ModelCatalog.find("gpt-4o")                  # => ModelInfo or raises
+  #   Ask::ModelCatalog.find("gpt-4o", provider: "openai")  # => ModelInfo or raises
+  #   Ask::ModelCatalog.where("gpt-4o")                 # => [ModelInfo, ...] (all matches)
   #
   class ModelCatalog
     include Enumerable
@@ -269,17 +268,8 @@ module Ask
     # @return [String] URL for the models.dev API
     MODELS_DEV_URL = "https://models.dev/api.json".freeze
 
-    # Ordered provider preference for disambiguation.
-    PROVIDER_PREFERENCE = %w[
-      openai anthropic gemini vertexai bedrock
-      opencode opencode_go
-      openrouter deepseek mistral perplexity xai
-      mimo
-      azure ollama gpustack github
-    ].freeze
-
     # Methods delegated to the singleton instance.
-    DELEGATES = %i[all each find chat_models embedding_models
+    DELEGATES = %i[all each find where chat_models embedding_models
                    audio_models image_models by_family by_provider
                    refresh!].freeze
 
@@ -319,19 +309,28 @@ module Ask
       @models.each(&block)
     end
 
-    # Find a model by ID, optionally scoped to a provider.
+    # Find a single model by ID. Scopes to provider when given.
     # @param model_id [String] model identifier
-    # @param provider [String, nil] provider slug
+    # @param provider [String, nil] provider slug (optional keyword)
     # @return [Ask::ModelInfo]
-    # @raise [ModelNotFound] if the model is not found
-    def find(model_id, provider = nil)
+    # @raise [ModelNotFound] if no matching model is found
+    def find(model_id, provider: nil)
       if provider
-        find_with_provider(model_id, provider.to_s)
+        @models.find { |m| m.id == model_id && m.provider == provider.to_s } ||
+          raise(ModelNotFound, "Model #{model_id.inspect} not found for provider #{provider.inspect}.")
       else
-        find_without_provider(model_id)
+        @models.find { |m| m.id == model_id } ||
+          raise(ModelNotFound, "Unknown model: #{model_id.inspect}.")
       end
     end
 
+    # Find all models matching an ID. Never raises.
+    # @param model_id [String] model identifier
+    # @return [Array<Ask::ModelInfo>] matching models (empty if none)
+    def where(model_id)
+      @models.select { |m| m.id == model_id }
+    end
+
     # @return [Ask::ModelCatalog] new catalog containing only chat models
     def chat_models
       self.class.new(@models.select(&:chat?))
@@ -391,31 +390,6 @@ module Ask
 
     private
 
-    def find_with_provider(model_id, provider)
-      exact = @models.find { |m| m.id == model_id && m.provider == provider }
-      return exact if exact
-
-      @models.find { |m| m.id == model_id && m.provider == provider } ||
-        raise(ModelNotFound, "Model #{model_id.inspect} not found for provider #{provider.inspect}. " \
-                             "Try ModelCatalog.refresh! to update the catalog.")
-    end
-
-    def find_without_provider(model_id)
-      matches = @models.select { |m| m.id == model_id }
-      return preferred_match(matches) if matches.any?
-
-      raise ModelNotFound, "Unknown model: #{model_id.inspect}. " \
-                           "Try ModelCatalog.refresh! to update the catalog."
-    end
-
-    def preferred_match(candidates)
-      return candidates.first if candidates.size == 1
-
-      candidates.min_by do |model|
-        PROVIDER_PREFERENCE.index(model.provider) || PROVIDER_PREFERENCE.length
-      end
-    end
-
     def fetch_from_models_dev(timeout: 10)
       uri = URI(MODELS_DEV_URL)
       http = Net::HTTP.new(uri.host, uri.port)

data/lib/ask/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ask
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-core
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Kaka Ruto