ask-llm-providers 0.13.7 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 702da6909b940ff6695187cda4e588bd047a2c7d8edbaabd1c037ff68dcedc6b
-  data.tar.gz: 363641a625952797604bd8bb2fc3e3089819ce8cdd89a1d20f8c030092e828e0
+  metadata.gz: 1d97e79228f15d501abab8d4569ca8c5c5faf94d086ee4a4604209739ef1ce73
+  data.tar.gz: d8b980e5ad87e0b2a5bad0ea78ccc8f3c688a34baa5d02903d6a9fb422bcdf86
 SHA512:
-  metadata.gz: 13253c6eed671a1159c349dafbb2bab8138725b55d07664aaf4ac60956bc42a4930df14cce7cb9f8212413b8b4447c8b4de5aefc1163a4f5aa704b590ab0247f
-  data.tar.gz: bbeca3575d85b2f45d54f7602f12d8453488e1fd30302516d1bd9622ba8b24d20ef04ce0fe6effd9b2f06e33cade84a0b995480aa41d3c11e5e06f24eb28dfeb
+  metadata.gz: 96cdc8251cc3c4554b79ef0af7c7d3e9737ca2107980eb6757dd2077a8240147e0ebada7e68becf87bc05d582c4708d6a2ad06f4c15d52e1335b6f6fc7c1be89
+  data.tar.gz: 7e85861afa257bb7746d22c7c796796dbfcb63ff0d5f3bda6750fdf1fe11071ce851e37dd2821e72bbbe1dd2f2b2fc59b3f734499b332a089f2466a1bec1b9d8

data/lib/ask/llm/cost_calculator.rb

@@ -98,12 +98,58 @@ module Ask
           result
         end
 
+        # Which pricing tier applies at a given moment.
+        #
+        # Providers bill some models at a higher rate during peak windows
+        # (Command Code doubles the DeepSeek V4 family on weekday mornings).
+        # A model with no +peak_schedule+ in its metadata always bills at
+        # :standard. Windows are UTC.
+        #
+        #   CostCalculator.tier_at(model)                               # now
+        #   CostCalculator.tier_at(model, at: Time.utc(2026, 9, 14, 7)) # => :peak
+        #
+        # @return [Symbol] :peak or :standard
+        def tier_at(model, at: Time.now)
+          schedule = extract_metadata(model)["peak_schedule"]
+          return :standard unless schedule.is_a?(Array) && schedule.any?
+
+          moment = at.getutc
+          day = moment.strftime("%a").downcase
+          minute = (moment.hour * 60) + moment.min
+
+          in_window = schedule.any? do |window|
+            next false unless Array(window["days"]).map { |d| d.to_s.downcase }.include?(day)
+
+            from = clock_minutes(window["from"])
+            to = clock_minutes(window["to"])
+            next false unless from && to
+
+            minute >= from && minute < to
+          end
+
+          in_window ? :peak : :standard
+        end
+
         private
 
         def extract_pricing(model)
           model.respond_to?(:pricing) ? model.pricing : model
         end
 
+        def extract_metadata(model)
+          return model.metadata || {} if model.respond_to?(:metadata)
+
+          model.is_a?(Hash) ? (model[:metadata] || model["metadata"] || {}) : {}
+        end
+
+        # "06:00" => 360
+        def clock_minutes(value)
+          match = value.to_s.match(/\A(\d{1,2}):(\d{2})\z/)
+          return nil unless match
+
+          (match[1].to_i * 60) + match[2].to_i
+        end
+
         def cost(tokens, rate)
           return 0.0 unless rate && tokens > 0
           (tokens * rate) / MILLION.to_f

data/lib/ask/llm/models.json

@@ -5222,7 +5222,33 @@
       }
     },
     "metadata": {
-      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak"
+      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak",
+      "peak_schedule": [
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "01:00",
+          "to": "04:00",
+          "zone": "UTC"
+        },
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "06:00",
+          "to": "10:00",
+          "zone": "UTC"
+        }
+      ]
     }
   },
   {
@@ -5257,7 +5283,33 @@
       }
     },
     "metadata": {
-      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak"
+      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak",
+      "peak_schedule": [
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "01:00",
+          "to": "04:00",
+          "zone": "UTC"
+        },
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "06:00",
+          "to": "10:00",
+          "zone": "UTC"
+        }
+      ]
     }
   },
   {
@@ -5321,7 +5373,33 @@
       }
     },
     "metadata": {
-      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak"
+      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak",
+      "peak_schedule": [
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "01:00",
+          "to": "04:00",
+          "zone": "UTC"
+        },
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "06:00",
+          "to": "10:00",
+          "zone": "UTC"
+        }
+      ]
     }
   },
   {
@@ -5356,7 +5434,33 @@
       }
     },
     "metadata": {
-      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak"
+      "peak_windows": "Mon-Fri 01:00-04:00 and 06:00-10:00 UTC bill at 2x (peak tier); weekends are fully off-peak",
+      "peak_schedule": [
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "01:00",
+          "to": "04:00",
+          "zone": "UTC"
+        },
+        {
+          "days": [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+          ],
+          "from": "06:00",
+          "to": "10:00",
+          "zone": "UTC"
+        }
+      ]
     }
   },
   {
@@ -14873,4 +14977,4 @@
     "pricing": {},
     "created_at": "2026-01-28"
   }
-]
+]

data/lib/ask/llm/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module LLM
-    VERSION = "0.13.7"
+    VERSION = "0.14.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-llm-providers
 version: !ruby/object:Gem::Version
-  version: 0.13.7
+  version: 0.14.1
 platform: ruby
 authors:
 - Kaka Ruto
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.4
+        version: 0.12.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.4
+        version: 0.12.0
 - !ruby/object:Gem::Dependency
   name: ask-auth
   requirement: !ruby/object:Gem::Requirement