lex-llm-ledger 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a69d4ccf5975f45c795e6e54ab6ed59272a269855394bbef4d1149a48bd338e7
-  data.tar.gz: 60bfc3f268526d0cf427ccfa90f2e230f9e0491fd88584ff685604c93faf63c4
+  metadata.gz: 84be271a1d8b2960d1eeef98a01c950ed2d44cab4e2e6d4c8dd6708980d027d4
+  data.tar.gz: 6da1a77c998891e3b2e1a5fae24b1109c51715c762b52aa308ebb73abb886188
 SHA512:
-  metadata.gz: e166ea0dc31b758dd45d5c1595f6a72c78629b7dfd69d09d9928a699ce14f475658d9bf77f08018608bc98f394532f4c19b5887c3b2649bb1761aecbe2b4b5c8
-  data.tar.gz: 226be9d0592d67fcca0ff956fe0c62db56a311cc3f6bde5a16523f21801d43079d976a6d6582e2a0f1022396089555495df37ccf81ccfd56ddfd3f2344f9d27f
+  metadata.gz: 51705c939e26737dfda07ac40df418887d15550e758b4db28aea1e377579b8c65108614cd5abd1ef6a309696c4b90149d1d3dacce6507011a219b90edb7d3a1e
+  data.tar.gz: 163077fbadc935cdeb751645fc59d06a59bf3cd47db7d93d427b721cbdc067f6749c0d6adf6641b1ded3c160c03a252f2382b383d778068b7f59ececcb1b6bb0

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2] - 2026-05-13
+
+### Fixed
+- Keep metering-only writes from creating placeholder conversation messages so later prompt audits can attach the real user and assistant messages without sequence collisions.
+- Use the request reference as the default inference metric idempotency key so metering and prompt audit events enrich the same metric row.
+- Suppress duplicate insert warnings for unique races handled by the official ledger writer while retaining debug-level collision messages.
+
 ## [0.3.1] - 2026-05-13
 
 ### Fixed

data/lib/legion/extensions/llm/ledger/backfill/legacy_llm_records.rb

@@ -184,7 +184,7 @@ module Legion
             end
 
             def official_metric_uuid(payload)
-              ref = payload[:message_id] || "metric:#{Writers::OfficialRecordWriter.request_ref(payload)}"
+              ref = payload[:metric_id] || payload[:metric_ref] || "metric:#{Writers::OfficialRecordWriter.request_ref(payload)}"
               Writers::OfficialRecordWriter.stable_uuid(ref)
             end
 

data/lib/legion/extensions/llm/ledger/helpers/persistence_logging.rb

@@ -19,13 +19,15 @@ module Legion
 
             module_function
 
-            def insert_row(db, table, attributes, operation:)
+            def insert_row(db, table, attributes, operation:, warn_on_unique: true)
               row_id = db[table].insert(attributes)
               log.info(log_message('inserted', table, operation, row_id, attributes))
               row_id
             rescue Sequel::UniqueConstraintViolation => e
-              log.warn(log_message('insert_failed', table, operation, nil, attributes,
-                                   error_class: e.class, error: e.message))
+              if warn_on_unique
+                log.warn(log_message('insert_failed', table, operation, nil, attributes,
+                                     error_class: e.class, error: e.message))
+              end
               raise
             rescue StandardError => e
               log.error(log_message('insert_failed', table, operation, nil, attributes,

data/lib/legion/extensions/llm/ledger/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Llm
       module Ledger
-        VERSION = '0.3.1'
+        VERSION = '0.3.2'
       end
     end
   end

data/lib/legion/extensions/llm/ledger/writers/official_record_writer.rb

@@ -42,8 +42,7 @@ module Legion
 
               db.transaction do
                 conversation = find_or_create_conversation(db, body)
-                user_message = find_or_create_user_message(db, conversation, body)
-                request = find_or_create_request(db, conversation, user_message, body)
+                request = find_or_create_request(db, conversation, nil, body)
                 response = find_or_create_response(db, request, nil, body)
                 metric = find_or_create_metric(db, request, response, body)
                 result = { result: :ok, request_id: request[:id], response_id: response[:id], metric_id: metric[:id] }
@@ -109,17 +108,14 @@ module Legion
             def find_or_create_request(db, conversation, latest_message, body)
               request_id = request_ref(body)
               existing = db[:llm_message_inference_requests].where(request_ref: request_id).first
-              if existing
-                enrich_request!(db, existing, body)
-                return existing
-              end
+              return enrich_request!(db, existing, body, latest_message) if existing
 
               operation = operation(body)
               caller_refs = caller_identity_refs(db, body)
               id = insert_with_savepoint(db, :llm_message_inference_requests, {
                                            uuid:                  stable_uuid(request_id),
                                            conversation_id:       conversation[:id],
-                                           latest_message_id:     latest_message[:id],
+                                           latest_message_id:     latest_message&.dig(:id),
                                            caller_principal_id:   caller_refs[:principal_id],
                                            caller_identity_id:    caller_refs[:identity_id],
                                            runtime_caller_type:   caller_type(body),
@@ -144,10 +140,7 @@ module Legion
             rescue Sequel::UniqueConstraintViolation => e
               log.debug("[ledger] request collision resolved request_ref=#{request_id} error=#{e.class}")
               existing = db[:llm_message_inference_requests].where(request_ref: request_id).first
-              if existing
-                enrich_request!(db, existing, body)
-                return existing
-              end
+              return enrich_request!(db, existing, body, latest_message) if existing
 
               raise
             end
@@ -252,7 +245,7 @@ module Legion
             end
 
             def find_or_create_metric(db, request, response, body)
-              metric_uuid = stable_uuid(reference(body, :message_id) || "metric:#{request_ref(body)}")
+              metric_uuid = stable_uuid(reference(body, :metric_id, :metric_ref) || "metric:#{request_ref(body)}")
               existing = db[:llm_message_inference_metrics].where(uuid: metric_uuid).first
               return existing if existing
 
@@ -287,7 +280,7 @@ module Legion
             end
 
             def insert_row(db, table, attributes, operation:)
-              Helpers::PersistenceLogging.insert_row(db, table, attributes, operation: operation)
+              Helpers::PersistenceLogging.insert_row(db, table, attributes, operation: operation, warn_on_unique: false)
             end
 
             def insert_with_savepoint(db, table, attributes, operation:)
@@ -309,8 +302,9 @@ module Legion
               db[:llm_messages].where(id: response_message[:id]).update(message_inference_response_id: response[:id])
             end
 
-            def enrich_request!(db, existing, body)
+            def enrich_request!(db, existing, body, latest_message = nil)
               updates = {}
+              update_if_missing(updates, existing, :latest_message_id, latest_message&.dig(:id))
               caller_refs = caller_identity_refs(db, body)
               updates[:caller_identity_id] = caller_refs[:identity_id] if existing[:caller_identity_id].nil? && caller_refs[:identity_id]
               updates[:caller_principal_id] = caller_refs[:principal_id] if existing[:caller_principal_id].nil? && caller_refs[:principal_id]
@@ -322,10 +316,11 @@ module Legion
               msg_count = Array(body.dig(:request, :messages) || body[:messages]).size
               updates[:context_message_count] = msg_count if existing[:context_message_count].to_i.zero? && msg_count.positive?
 
-              return if updates.empty?
+              return existing if updates.empty?
 
               db[:llm_message_inference_requests].where(id: existing[:id]).update(updates)
               log.info("[ledger] enriched request id=#{existing[:id]} fields=#{updates.keys.join(',')}")
+              existing.merge(updates)
             end
 
             def caller_identity(body)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-ledger
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Esity