ask-core 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e87a2c3690127974ace8b8143002728a1eb6bebbaae9d54b321c5f4342c20485
-  data.tar.gz: 605fb219de7a80fcf33a97b21a9a2149f688e7bdd25a066484f235e41e127420
+  metadata.gz: 2b573cb0709bd479e2a888becc0ce41cacafcf5f2e48afee24b2d6af1a7b99d5
+  data.tar.gz: c690b789d00985df0d9723c4f436c6b4a51e62f1857479af9ff2f652b59cd7d8
 SHA512:
-  metadata.gz: 1b8852000559343d48f693bb80cda7b7bc4ed9ecf935fc3e2336c80798277a35e31e4dd37a8453ae9d69adbc88a3e80650f26b6eaf64fa7d757f0711301106c1
-  data.tar.gz: 8713f24a5530fbc86f347016e3eb811e4e2ddb14cf5d08368bf6f8d28ffa3aa5c32127a91c75923146ffc3e940295a6edff2bab4c2df7838f50bd207e7dc3232
+  metadata.gz: 4506564311573fcd2a43d277eef97157d1abafa7add2968bc336551ad1f6e4133f87b1aa2d47607963e2c0b3d0fdfb92ad332c6ff55eddb3a927276cee647a3e
+  data.tar.gz: ec2c10ed1152e01783272fffc16ff0695334c53bae829d9a0ebb7077317c084b3587490d6bc80820e2c78fd10e19e676dfe319147f667a4a453f763fb08782a7

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ask
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 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.4
 platform: ruby
 authors:
 - Kaka Ruto