ask-core 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3344dad8d0965fe27ab622e6ff3a216bc000de33d844ca801b534763d0b7337c
-  data.tar.gz: 0053ed57a1a8c5c24e691352f1ef0781555ba0e1d4278fc05a9ee9c688f217ed
+  metadata.gz: e87a2c3690127974ace8b8143002728a1eb6bebbaae9d54b321c5f4342c20485
+  data.tar.gz: 605fb219de7a80fcf33a97b21a9a2149f688e7bdd25a066484f235e41e127420
 SHA512:
-  metadata.gz: 3bb49abe262df54f05dca655031e434dd94afa029709431d0def3a2ba13fb745aac3479c6c97634f466e6da1da35674fa464afa261a914b0c5ca66f2213c74c0
-  data.tar.gz: f009877f5d58f03b0b20bca5922a3d87f43f83951bdaa9ebae81b0def2f78fba4ee4aee79a703771966e6466736f86cb8d121dc065e19f3c4e99dd7fe1e9f46b
+  metadata.gz: 1b8852000559343d48f693bb80cda7b7bc4ed9ecf935fc3e2336c80798277a35e31e4dd37a8453ae9d69adbc88a3e80650f26b6eaf64fa7d757f0711301106c1
+  data.tar.gz: 8713f24a5530fbc86f347016e3eb811e4e2ddb14cf5d08368bf6f8d28ffa3aa5c32127a91c75923146ffc3e940295a6edff2bab4c2df7838f50bd207e7dc3232

data/CHANGELOG.md

@@ -1,4 +1,15 @@
-## [0.2.1] - 2026-06-25
+## [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
+- `Ask::ModelCatalog::PROVIDER_PREFERENCE` — includes `opencode`, `opencode_go`, `mimo` for proper disambiguation of models served by aggregator providers.
+
+## [0.2.1] — 2026-06-25
 
 ### Changed
 - Testing infrastructure: rubocop, overcommit, bin/setup, gemspec validation, SimpleCov, CI matrix, .minitest config

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,15 +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
-      openrouter deepseek mistral perplexity xai
-      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
 
@@ -317,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?))
@@ -389,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.1"
+  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.1
+  version: 0.2.3
 platform: ruby
 authors:
 - Kaka Ruto