lex-llm-anthropic 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5ffb30606527237b262367541e2855945a51f3b678dae09cde5e874ad4b68dd
-  data.tar.gz: d96e03b52d36827fca0a297e208994da831336f50e64aa234ad07602675835b2
+  metadata.gz: 706b82cf938d0f347b19db1fbf2f1e66ff0a1fc2c0029c20ba0696b14463bf16
+  data.tar.gz: addcd78f5164cef165a316369f69fc6e8cabbd0e338f0a2c7bb6daacc8638392
 SHA512:
-  metadata.gz: 720aa58289499d4289a695e7b83e6f15a6ba6f2508d5fff9d49e203c5cd0c8c14ead5a8b3bcdd22d1f5e08346b6f9ac4c5fb1f54026de32063bcf9c966e2053f
-  data.tar.gz: f2647cccc377307c382fec5f20acd6a778bf62c0914e59232a79ec6273c4398c73e89a4191a014c8e23e0159d4bc81ca4435096a21e5691c92164ba99dd713cf
+  metadata.gz: 51a06c3a1c8e14435677f4ca79a7f8adadbcf497c7228ace93d7e6afaa1d2ae9d8796a0d36594ed8b8aa966e9ec85716a25da20a1ef80388527e7fcc944e3955
+  data.tar.gz: 58d3e043cc3f82a0982198a70535c321681236e637832c437674d54f9247449743f4a92519e4df562a54db5466267a8269351a9f9d2f493214f65a0f74440981

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.7 - 2026-05-13
+
+- Use `Legion::Logging::Helper` for Anthropic provider and registry diagnostics.
+- Route registry fallback errors through `handle_exception` with useful operation metadata.
+
 ## 0.2.6 - 2026-05-08
 
 - Accept keyword arguments in `list_models` to match the base provider contract called by `discover_offerings`.

data/lib/legion/extensions/llm/anthropic/actors/fleet_worker.rb

@@ -1,12 +1,21 @@
 # frozen_string_literal: true
 
+require 'legion/logging/helper'
+
+actor_load_logger = Object.new.extend(Legion::Logging::Helper)
+actor_load_logger.define_singleton_method(:lex_filename) { 'llm_anthropic' }
+
 begin
   require 'legion/extensions/actors/subscription'
 rescue LoadError => e
-  warn(e.message) if $VERBOSE
+  subscription_load_error = e
 end
 
 unless defined?(Legion::Extensions::Actors::Subscription)
+  if subscription_load_error
+    actor_load_logger.handle_exception(subscription_load_error, level: :warn, handled: true,
+                                                                operation: 'anthropic.actor.subscription_load')
+  end
   raise LoadError, 'LegionIO actor runtime is required for Anthropic fleet worker'
 end
 

data/lib/legion/extensions/llm/anthropic/provider.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/llm'
+require 'legion/logging/helper'
 
 module Legion
   module Extensions
@@ -8,6 +9,8 @@ module Legion
       module Anthropic
         # Anthropic Messages API provider implementation for the Legion::Extensions::Llm contract.
         class Provider < Legion::Extensions::Llm::Provider # rubocop:disable Metrics/ClassLength
+          include Legion::Logging::Helper
+
           class << self
             attr_writer :registry_publisher
 
@@ -52,7 +55,9 @@ module Legion
           end
 
           def list_models(**)
+            log.debug { 'listing available Anthropic models' }
             super.tap do |models|
+              log.debug { "discovered #{Array(models).size} Anthropic model(s); publishing to registry" }
               self.class.registry_publisher.publish_models_async(models, readiness: readiness(live: false))
             end
           end
@@ -60,6 +65,7 @@ module Legion
           private
 
           def render_payload(messages, tools:, temperature:, model:, stream:, schema:, thinking:, tool_prefs:) # rubocop:disable Metrics/ParameterLists
+            log_render_payload(messages:, tools:, model:, stream:, schema:)
             system_messages, chat_messages = messages.partition { |message| message.role == :system }
 
             {
@@ -76,6 +82,13 @@ module Legion
             }.compact
           end
 
+          def log_render_payload(messages:, tools:, model:, stream:, schema:)
+            log.debug do
+              "rendering Anthropic #{stream ? 'stream' : 'chat'} payload for #{model.id} " \
+                "with #{messages.size} message(s), #{tools.size} tool(s), schema=#{!schema.nil?}"
+            end
+          end
+
           def system_content(messages)
             content = messages.flat_map { |message| content_blocks(message.content) }
             content.empty? ? nil : content

data/lib/legion/extensions/llm/anthropic/registry_event_builder.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
+require 'legion/logging/helper'
+
 module Legion
   module Extensions
     module Llm
       module Anthropic
         # Builds sanitized lex-llm registry envelopes for Anthropic provider state.
         class RegistryEventBuilder
+          include Legion::Logging::Helper
+
           def model_available(model, readiness:)
             registry_event_class.available(
               model_offering(model),
@@ -54,7 +58,9 @@ module Legion
             configured_node = (::Legion::Settings.dig(:node, :canonical_name) if defined?(::Legion::Settings))
             value = configured_node.to_s.strip
             value.empty? ? :anthropic : value.to_sym
-          rescue StandardError
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true,
+                                operation: 'anthropic.registry.provider_instance')
             :anthropic
           end
 

data/lib/legion/extensions/llm/anthropic/registry_publisher.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
+require 'legion/logging/helper'
+
 module Legion
   module Extensions
     module Llm
       module Anthropic
         # Best-effort publisher for Anthropic provider availability events.
         class RegistryPublisher
+          include Legion::Logging::Helper
+
           APP_ID = 'lex-llm-anthropic'
 
           def initialize(builder: RegistryEventBuilder.new)
@@ -13,6 +17,7 @@ module Legion
           end
 
           def publish_models_async(models, readiness:)
+            log.debug { "publishing #{Array(models).size} Anthropic model event(s) to llm.registry" }
             schedule do
               Array(models).each do |model|
                 publish_event(@builder.model_available(model, readiness:))
@@ -29,10 +34,12 @@ module Legion
               Thread.current.abort_on_exception = false
               yield
             rescue StandardError => e
-              log_publish_failure(e, level: :debug)
+              handle_exception(e, level: :debug, handled: true,
+                                  operation: 'anthropic.registry.schedule_thread')
             end
           rescue StandardError => e
-            log_publish_failure(e, level: :debug)
+            handle_exception(e, level: :debug, handled: true,
+                                operation: 'anthropic.registry.schedule')
             false
           end
 
@@ -41,7 +48,8 @@ module Legion
 
             message_class.new(event:, app_id: APP_ID).publish(spool: false)
           rescue StandardError => e
-            log_publish_failure(e)
+            handle_exception(e, level: :warn, handled: true,
+                                operation: 'anthropic.registry.publish_event')
             false
           end
 
@@ -52,7 +60,9 @@ module Legion
             return true unless ::Legion::Transport::Connection.respond_to?(:session_open?)
 
             ::Legion::Transport::Connection.session_open?
-          rescue StandardError
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true,
+                                operation: 'anthropic.registry.publishing_available?')
             false
           end
 
@@ -66,7 +76,9 @@ module Legion
 
             require 'legion/extensions/llm/anthropic/transport/messages/registry_event'
             message_class_defined?
-          rescue LoadError
+          rescue LoadError => e
+            handle_exception(e, level: :debug, handled: true,
+                                operation: 'anthropic.registry.transport_load')
             false
           end
 
@@ -77,18 +89,6 @@ module Legion
           def message_class
             ::Legion::Extensions::Llm::Anthropic::Transport::Messages::RegistryEvent
           end
-
-          def log_publish_failure(error, level: :warn)
-            message = "[lex-llm-anthropic] llm.registry publish failed: #{error.class}: #{error.message}"
-            logger = ::Legion::Extensions::Llm.logger if defined?(::Legion::Extensions::Llm)
-            if logger.respond_to?(level)
-              logger.public_send(level, message)
-            elsif logger.respond_to?(:debug)
-              logger.debug(message)
-            end
-          rescue StandardError
-            nil
-          end
         end
       end
     end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Llm
       module Anthropic
-        VERSION = '0.2.6'
+        VERSION = '0.2.7'
       end
     end
   end

data/lib/legion/extensions/llm/anthropic.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/llm'
+require 'legion/logging/helper'
 require 'legion/extensions/llm/anthropic/registry_event_builder'
 require 'legion/extensions/llm/anthropic/registry_publisher'
 require 'legion/extensions/llm/anthropic/provider'
@@ -12,6 +13,7 @@ module Legion
       # Anthropic provider extension namespace.
       module Anthropic
         extend ::Legion::Extensions::Core if ::Legion::Extensions.const_defined?(:Core, false)
+        extend Legion::Logging::Helper
         extend Legion::Extensions::Llm::AutoRegistration
 
         PROVIDER_FAMILY = :anthropic

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-anthropic
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - LegionIO