ace-llm 0.40.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48321c690b49c8d136a85e6f131328bbb4a6cfc55e504d1467c56d4d2a554092
-  data.tar.gz: 0af124c46785c2278cd5b1d10b4e5fee3b7f67ff6e446cd28e9bbe091abea429
+  metadata.gz: 2fae0fd9e7709654101b452e68a39a32412c1788948f60ff6b3ea619ca4877d8
+  data.tar.gz: c5ecb76fe5e258e27e5c71ddd8d0f760637ca7a0f67766a7239fe2e60acf3dbf
 SHA512:
-  metadata.gz: e13d32931c1e249cba948d8113e124fc7412462fbafd2d397f389c38effe2beadc8f7413ce7e196893680e9c27842cae15218bba6da1db5c3f5e9a085ec34aff
-  data.tar.gz: 73b5a3eab3ffeceab03a5c67631162ab245ff512e01262029b253a04bc7acad610926ce4e13c62944f618c9c03b19964ecf0af2ffd9adfec8d7fce23a5bca9f5
+  metadata.gz: a885b5933135a969eb4f91a4e013af1e9a35b1e79450c8f47b8ce2b9afa372226c482c1023bab1033438a04b2fc95fbc6ccf4f8592e5b5ce6b763d0820bfb429
+  data.tar.gz: b378d04c4280ede3e36d60b01fbe7ee821f28597ac0c9074745961126d642db7e822af19c44f0362d15eaf5067e3ed6b4ee9cf9a2779abf15652e979f9313114

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.41.0] - 2026-09-27
+
+### Changed
+
+- Query results now derive the top-level `usage` record from provider metadata token counts (model, input/output/cached/total). Absent counts stay absent; a measured zero cache read is kept so cost models can distinguish "no cache" from "unknown". Sessions no longer report "usage unavailable" when the provider supplied tokens.
+
 ## [0.40.0] - 2026-09-24
 
 ### Fixed

data/lib/ace/llm/query_interface.rb

@@ -153,7 +153,7 @@ module Ace
           thinking_level: response.fetch(:execution, {}).fetch(:thinking_level, parse_result.thinking_level),
           execution: response[:execution],
           requested_selector: provider_model,
-          usage: response[:usage],
+          usage: build_usage(response[:metadata]),
           metadata: response[:metadata]
         }
 
@@ -182,6 +182,27 @@ module Ace
 
       private
 
+      # Derive the measured usage record from client metadata. Providers hand
+      # token counts to session recording through metadata keys; absent counts
+      # stay absent (never zero) so cost models can tell "no cache" from
+      # "unknown". Returns nil when the client reported no token counts at all.
+      def self.build_usage(metadata)
+        meta = metadata.is_a?(Hash) ? metadata : {}
+        input = meta[:input_tokens] || meta["input_tokens"]
+        output = meta[:output_tokens] || meta["output_tokens"]
+        return nil if input.nil? && output.nil?
+
+        usage = {model: meta[:model] || meta["model"]}
+        usage[:input_tokens] = input unless input.nil?
+        usage[:output_tokens] = output unless output.nil?
+        cached = meta[:cached_tokens] || meta["cached_tokens"]
+        usage[:cached_tokens] = cached unless cached.nil?
+        total = meta[:total_tokens] || meta["total_tokens"]
+        usage[:total_tokens] = total.nil? ? (input.to_i + output.to_i) : total
+        usage
+      end
+      private_class_method :build_usage
+
       def self.resolve_preset_name(suffix_preset, explicit_preset)
         suffix = suffix_preset&.to_s&.strip
         explicit = explicit_preset&.to_s&.strip

data/lib/ace/llm/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module LLM
-    VERSION = "0.40.0"
+    VERSION = "0.41.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-llm
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-09-24 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli