ask-core 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e87a2c3690127974ace8b8143002728a1eb6bebbaae9d54b321c5f4342c20485
-  data.tar.gz: 605fb219de7a80fcf33a97b21a9a2149f688e7bdd25a066484f235e41e127420
+  metadata.gz: 27b1acea84966d56137426aa88ddc1cda8f61dd277a37c9c9961f79540c156f2
+  data.tar.gz: 5096b62044dd0110ba21e59642a2af4d2ce149cf7a3e24bf6235cbe025f9412d
 SHA512:
-  metadata.gz: 1b8852000559343d48f693bb80cda7b7bc4ed9ecf935fc3e2336c80798277a35e31e4dd37a8453ae9d69adbc88a3e80650f26b6eaf64fa7d757f0711301106c1
-  data.tar.gz: 8713f24a5530fbc86f347016e3eb811e4e2ddb14cf5d08368bf6f8d28ffa3aa5c32127a91c75923146ffc3e940295a6edff2bab4c2df7838f50bd207e7dc3232
+  metadata.gz: 5d92e48754c546c5904f3fec07d398569dadf4c8d70ba8068a098e3e9d2ee363133f5466c08e50402325054241df2b815cf4d53435bca121f6941a92eb20a6d7
+  data.tar.gz: 00752dace3a9a4d017e0af32c8caaf0cbbd2e57af89b9cd797e54a275458ef6e30be7c255c5bc3d39eef7bb0089b67243e40ae0327cce1cfa981034827e3470d

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.2.4] — 2026-07-17
+
+### Added
+
+- **Rich error categories** — `RateLimitError` now carries `category` (`RateLimitCategory::VENDOR` or `::LOCAL`), `rate_limit_type` (`RateLimitType::REQUESTS`, `::TOKENS`, `::CONCURRENT`, `::BUDGET`), and `retry_after` (seconds) for intelligent error handling. Inspired by LiteLLM's error hierarchy.
+
 ## [0.2.3] — 2026-07-14
 
 ### Changed

data/lib/ask/errors.rb

@@ -28,9 +28,6 @@ module Ask
   # Raised when the context window is exceeded.
   class ContextLengthExceeded < Error; end
 
-  # Raised when the API rate limit is hit.
-  class RateLimitError < Error; end
-
   # Raised when authentication fails.
   class Unauthorized < Error; end
 
@@ -40,11 +37,41 @@ module Ask
   # Raised when the service is unavailable.
   class ServiceUnavailable < Error; end
 
+  # Categories for {RateLimitError} — tells you who rate-limited the request.
+  module RateLimitCategory
+    VENDOR = :vendor  # upstream LLM provider (OpenAI, Anthropic, etc.)
+    LOCAL  = :local   # ask-rb's own limiter (ask-auth thresholds)
+  end
+
+  # Rate limit dimension that was exceeded — orthogonal to {RateLimitCategory}.
+  module RateLimitType
+    REQUESTS   = :requests    # requests-per-minute ceiling
+    TOKENS     = :tokens      # tokens-per-minute ceiling
+    CONCURRENT = :concurrent  # max parallel requests
+    BUDGET     = :budget      # spend budget cap
+  end
+
+  # Raised when the API rate limit is hit.
+  # Carries optional category, type, and retry_after for intelligent handling.
+  class RateLimitError < Error
+    # @return [Symbol, nil] who rate-limited (:vendor, :local)
+    attr_reader :category
+
+    # @return [Symbol, nil] which limit was hit (:requests, :tokens, :concurrent, :budget)
+    attr_reader :rate_limit_type
+
+    # @return [Integer, Float, nil] suggested seconds to wait before retrying
+    attr_reader :retry_after
+
+    def initialize(message, category: nil, rate_limit_type: nil, retry_after: nil)
+      @category = category
+      @rate_limit_type = rate_limit_type
+      @retry_after = retry_after
+      super(message)
+    end
+  end
+
   # Raised when a provider's API returns an unexpected response.
-  # @!attribute [r] status_code
-  #   @return [Integer, nil] the HTTP status code
-  # @!attribute [r] response_body
-  #   @return [String, nil] the raw response body
   class ProviderError < Error
     attr_reader :status_code, :response_body
 

data/lib/ask/provider.rb

@@ -93,9 +93,6 @@ module Ask
     # @return [Boolean] true if the provider requires a remote API
     def remote? = !local?
 
-    # @return [Boolean] true if all models can be assumed to exist
-    def assume_models_exist? = self.class.assume_models_exist?
-
     # --- Slug / name / capabilities ---
 
     # @return [String] lowercased provider slug
@@ -199,10 +196,7 @@ module Ask
         !local?
       end
 
-      # @return [Boolean] whether all models can be assumed to exist
-      def assume_models_exist?
-        false
-      end
+
 
       private
 

data/lib/ask/version.rb

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

metadata

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