lex-llm-anthropic 0.2.6 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5ffb30606527237b262367541e2855945a51f3b678dae09cde5e874ad4b68dd
-  data.tar.gz: d96e03b52d36827fca0a297e208994da831336f50e64aa234ad07602675835b2
+  metadata.gz: 23d189a1ea15ce64735d14d88766fcb6717136b9734c393599a7fbd3c7544b54
+  data.tar.gz: 5c3153468a9753fc406e5229ee41036113b5c396eb0b5761f933c2c8a78fba91
 SHA512:
-  metadata.gz: 720aa58289499d4289a695e7b83e6f15a6ba6f2508d5fff9d49e203c5cd0c8c14ead5a8b3bcdd22d1f5e08346b6f9ac4c5fb1f54026de32063bcf9c966e2053f
-  data.tar.gz: f2647cccc377307c382fec5f20acd6a778bf62c0914e59232a79ec6273c4398c73e89a4191a014c8e23e0159d4bc81ca4435096a21e5691c92164ba99dd713cf
+  metadata.gz: 97685da785d9c89c5b63cb64406c3487f12b943aa28b289ef553de7ca32ab3e454ef51f8cff9ad0af4762fadd760453899e64f902a79579d652c2ee045ce0b8f
+  data.tar.gz: 796d40a66a89b96ac401beb3b74237a09c7bfb2fa26819e589c937adfc771cc40051338899dc19c80204006a351fd0a7886af1524f74d7b507bbb1d8e0e6836a

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.2.8 - 2026-05-13
+
+- Remove `:claude` provider alias (`provider_aliases` now returns `[]`).
+- Attach `source` and `credential_fingerprint` to all discovered instances.
+- Inject `default_model: 'claude-sonnet-4-6'` and `capabilities: [:completion, :streaming, :vision]` into every discovered instance.
+- Add static `CONTEXT_WINDOWS` map for known Claude model families.
+- Override `fetch_model_detail` to return context window from static map.
+- Use `model_detail` in `parse_list_models_response` for cached `context_length` lookup.
+- Add `infer_context_window` helper for prefix-based context window inference.
+
+## 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,14 +55,27 @@ 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
 
+          CONTEXT_WINDOWS = {
+            'claude-opus-4' => 200_000,
+            'claude-sonnet-4' => 200_000,
+            'claude-haiku-4' => 200_000,
+            'claude-3-5' => 200_000,
+            'claude-3-opus' => 200_000,
+            'claude-3-sonnet' => 200_000,
+            'claude-3-haiku' => 200_000
+          }.freeze
+
           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 +92,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
@@ -347,14 +370,26 @@ module Legion
           def parse_list_models_response(response, provider, _capabilities)
             Array(response.body['data']).map do |model|
               model_id = model.fetch('id')
+              detail = model_detail(model_id)
+              ctx = detail&.dig(:context_window) || infer_context_window(model_id)
               Legion::Extensions::Llm::Model::Info.new(
                 id: model_id,
                 name: model['display_name'] || model_id,
                 provider: provider,
+                context_length: ctx,
                 metadata: model.merge('created_at' => model['created_at']).compact
               )
             end
           end
+
+          def infer_context_window(model_id)
+            CONTEXT_WINDOWS.find { |prefix, _| model_id.start_with?(prefix) }&.last
+          end
+
+          def fetch_model_detail(model_name)
+            ctx = infer_context_window(model_name)
+            ctx ? { context_window: ctx } : nil
+          end
         end
       end
     end

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.8'
       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'
@@ -10,8 +11,9 @@ module Legion
   module Extensions
     module Llm
       # Anthropic provider extension namespace.
-      module Anthropic
+      module Anthropic # rubocop:disable Metrics/ModuleLength
         extend ::Legion::Extensions::Core if ::Legion::Extensions.const_defined?(:Core, false)
+        extend Legion::Logging::Helper
         extend Legion::Extensions::Llm::AutoRegistration
 
         PROVIDER_FAMILY = :anthropic
@@ -20,6 +22,7 @@ module Legion
           ::Legion::Extensions::Llm.provider_settings(
             family: PROVIDER_FAMILY,
             instance: {
+              default_model: 'claude-sonnet-4-6',
               endpoint: 'https://api.anthropic.com',
               tier: :frontier,
               transport: :http,
@@ -43,7 +46,7 @@ module Legion
         end
 
         def self.provider_aliases
-          [:claude]
+          []
         end
 
         def self.discover_instances # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
@@ -54,7 +57,9 @@ module Legion
             candidates[:env] = {
               api_key: env_key,
               anthropic_api_key: env_key,
-              tier: :frontier
+              tier: :frontier,
+              source: CredentialSources.source_tag(:env, 'ANTHROPIC_API_KEY'),
+              credential_fingerprint: CredentialSources.credential_fingerprint(env_key)
             }
           end
 
@@ -63,7 +68,9 @@ module Legion
             candidates[:claude] = {
               api_key: claude_key,
               anthropic_api_key: claude_key,
-              tier: :frontier
+              tier: :frontier,
+              source: CredentialSources.source_tag(:file, '~/.claude/settings.json', 'anthropicApiKey'),
+              credential_fingerprint: CredentialSources.credential_fingerprint(claude_key)
             }
           end
 
@@ -74,7 +81,9 @@ module Legion
               candidates[:settings] = normalize_instance_config(settings_config).merge(
                 api_key: settings_key,
                 anthropic_api_key: settings_key,
-                tier: :frontier
+                tier: :frontier,
+                source: CredentialSources.source_tag(:settings, 'extensions.llm.anthropic'),
+                credential_fingerprint: CredentialSources.credential_fingerprint(settings_key)
               )
             end
 
@@ -85,6 +94,10 @@ module Legion
               next unless normalized[:anthropic_api_key]
 
               normalized[:api_key] = normalized[:anthropic_api_key]
+              normalized[:source] =
+                CredentialSources.source_tag(:settings, "extensions.llm.anthropic.instances.#{name}")
+              normalized[:credential_fingerprint] =
+                CredentialSources.credential_fingerprint(normalized[:anthropic_api_key])
               candidates[name.to_sym] = normalized.merge(tier: :frontier)
             end
           end
@@ -95,12 +108,19 @@ module Legion
               candidates[:broker] = {
                 api_key: broker_cred,
                 anthropic_api_key: broker_cred,
-                tier: :frontier
+                tier: :frontier,
+                source: CredentialSources.source_tag(:broker, 'identity', 'anthropic'),
+                credential_fingerprint: CredentialSources.credential_fingerprint(broker_cred)
               }
             end
           end
 
-          CredentialSources.dedup_credentials(candidates).transform_values { |config| sanitize_instance_config(config) }
+          CredentialSources.dedup_credentials(candidates).transform_values do |config|
+            sanitized = sanitize_instance_config(config)
+            sanitized[:capabilities] ||= %i[completion streaming vision].freeze
+            sanitized[:default_model] ||= 'claude-sonnet-4-6'
+            sanitized
+          end
         end
 
         def self.settings_instances(config)

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.8
 platform: ruby
 authors:
 - LegionIO