lex-llm-anthropic 0.2.0 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a17bd5b25cc4b70aa861ad36f5c700dc96558efde25b11dc9a362ac7d545450e
-  data.tar.gz: 7f02f82b866d53792ca985c45cc36672d025722922fa853c8ac36948ed9514d1
+  metadata.gz: 252dd911c10a76d9d23226a35240579ab7f835fae19d3974cbaaed01318f439d
+  data.tar.gz: e0a232078d4a3b9a74b3a4d251caa22106798a67493e0f0247f8a6cc9125558e
 SHA512:
-  metadata.gz: b2b0860a1bb74cf8498f748aff5d709783591c8334c3f8ecfa52fd09fe6c29d84b0b74c2863fb64b76a3465520259ca26497b368e9db5cb6330a79f46a2a004c
-  data.tar.gz: 57800905a3e9e3faf9dd34e964b01c3b66a0eda08d86d7e2e4d3a7357d46a41164ab6740d5b5f532b505e7c150749cfe59fef411dffa2a4d0b3aeffb97644623
+  metadata.gz: 46891728b8ba7c71c01cf07d0987023507c0e801d3de9af0f0b03ff8cab5b9bc9bb9b25f5c5757ad008763f74bf759cd39d14eb6f198f57822cbb98ef3c9db63
+  data.tar.gz: de200293bd0fcc79b7cf6b1c72e6bd4cb4b03083f2e64490ef0df27b2d3a63dc3bac859bf4de50a5a7f4ac301928cf3151ea0148b7e4f14c92522b28f7ee5185

data/.github/workflows/ci.yml

@@ -8,8 +8,20 @@ jobs:
   ci:
     uses: LegionIO/.github/.github/workflows/ci.yml@main
 
+  excluded-files:
+    uses: LegionIO/.github/.github/workflows/excluded-files.yml@main
+
+  security:
+    uses: LegionIO/.github/.github/workflows/security-scan.yml@main
+
+  version-changelog:
+    uses: LegionIO/.github/.github/workflows/version-changelog.yml@main
+
+  dependency-review:
+    uses: LegionIO/.github/.github/workflows/dependency-review.yml@main
+
   release:
-    needs: ci
+    needs: [ci, excluded-files, security]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     uses: LegionIO/.github/.github/workflows/release.yml@main
     secrets:

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.2.5 - 2026-05-06
+
+- Load provider-owned fleet actors through the LegionIO subscription base and the canonical Anthropic provider root.
+- Keep fleet runners anchored on the provider root namespace so provider constants and instance discovery are always loaded.
+- Strip temporary generic API key fields from discovered Anthropic instance configs after credential deduplication.
+- Gate release publishing on the shared security workflow.
+
+## 0.2.4 - 2026-05-06
+
+- Use the shared `lex-llm` fleet provider responder helper for provider-owned fleet workers.
+- Remove the runtime `legion-llm` dependency and require `lex-llm >= 0.4.3` for responder-side fleet execution.
+- Refresh README installation, credential discovery, and fleet ownership documentation for the runtime dependency split.
+
+## 0.2.3 - 2026-05-06
+
+- Remove require-time provider self-registration; `legion-llm` now owns adapter creation and registry writes from loaded provider discovery metadata.
+- Declare the `:claude` compatibility provider family through `provider_aliases`.
+- Bump dependency floors to `lex-llm >= 0.4.1` and `legion-llm >= 0.9.1`.
+
+## 0.2.2 - 2026-05-06
+
+- Enforce the shared keyword-only `lex-llm` provider contract with provider contract specs.
+- Keep Anthropic defaults on `Legion::Extensions::Llm.provider_settings` with instance-level fleet responder settings.
+- Add provider-owned fleet responder actor and runner backed by `legion-llm` fleet policy execution.
+- Bump the transport dependency floor to `legion-transport >= 1.4.14`.
+
+## 0.2.1 - 2026-05-03
+
+- Normalize generic settings keys to Anthropic provider config keys during instance discovery.
+- Support named Anthropic instances from extension settings.
+
 ## 0.2.0 - 2026-05-01
 
 - Add auto-discovery via CredentialSources and AutoRegistration from lex-llm 0.3.0

data/Gemfile

@@ -4,6 +4,8 @@ source 'https://rubygems.org'
 
 group :test do
   llm_base_path = ENV.fetch('LEX_LLM_PATH', File.expand_path('../lex-llm', __dir__))
+  transport_path = ENV.fetch('LEGION_TRANSPORT_PATH', File.expand_path('../../legion-transport', __dir__))
+  gem 'legion-transport', path: transport_path if File.directory?(transport_path)
   gem 'lex-llm', path: llm_base_path if File.directory?(llm_base_path)
 end
 

data/README.md

@@ -2,10 +2,18 @@
 
 LegionIO LLM provider extension for Anthropic.
 
-This gem lives under `Legion::Extensions::Llm::Anthropic` and depends on `lex-llm` for shared provider-neutral routing, fleet, and schema primitives.
+This gem lives under `Legion::Extensions::Llm::Anthropic` and depends on `lex-llm >= 0.4.3` for shared provider contracts, response normalization, fleet responder helpers, and schema primitives. It does not require `legion-llm` at runtime.
 
 Load it with `require 'legion/extensions/llm/anthropic'`.
 
+## Installation
+
+```ruby
+gem 'lex-llm-anthropic', '~> 0.2'
+```
+
+Anthropic credentials are discovered from `ANTHROPIC_API_KEY`, Claude config, configured provider instances, or an identity broker when one is available.
+
 ## Provider
 
 `Legion::Extensions::Llm::Anthropic::Provider` registers with `Legion::Extensions::Llm::Provider` as `:anthropic` and uses Anthropic's Messages API:
@@ -28,3 +36,25 @@ end
 ```
 
 `anthropic_api_base` can override the default `https://api.anthropic.com` endpoint for tests or compatible Anthropic gateways.
+
+Named instances can use generic provider keys such as `api_key`, `endpoint`, and `version`; the extension normalizes them to Anthropic-specific provider options during discovery.
+
+## Fleet Responder
+
+Provider instances can opt in to consuming Legion LLM fleet requests. The provider-owned fleet actor only starts when at least one configured instance enables `respond_to_requests`.
+
+```yaml
+extensions:
+  llm:
+    anthropic:
+      instances:
+        local:
+          fleet:
+            enabled: true
+            respond_to_requests: true
+            capabilities:
+              - chat
+              - stream_chat
+```
+
+Fleet execution is delegated to `Legion::Extensions::Llm::Fleet::ProviderResponder` from `lex-llm`. The responder owns provider invocation for this gem; routing and fleet request publication remain outside this provider extension.

data/lex-llm-anthropic.gemspec

@@ -26,5 +26,6 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'legion-json', '>= 1.2.1'
   spec.add_dependency 'legion-logging', '>= 1.3.2'
   spec.add_dependency 'legion-settings', '>= 1.3.14'
-  spec.add_dependency 'lex-llm', '>= 0.3.0'
+  spec.add_dependency 'legion-transport', '>= 1.4.14'
+  spec.add_dependency 'lex-llm', '>= 0.4.3'
 end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+begin
+  require 'legion/extensions/actors/subscription'
+rescue LoadError => e
+  warn(e.message) if $VERBOSE
+end
+
+unless defined?(Legion::Extensions::Actors::Subscription)
+  raise LoadError, 'LegionIO actor runtime is required for Anthropic fleet worker'
+end
+
+require 'legion/extensions/llm/anthropic'
+require 'legion/extensions/llm/fleet/provider_responder'
+
+module Legion
+  module Extensions
+    module Llm
+      module Anthropic
+        module Actor
+          # Subscription actor for Anthropic fleet request consumption.
+          class FleetWorker < Legion::Extensions::Actors::Subscription
+            def runner_class
+              'Legion::Extensions::Llm::Anthropic::Runners::FleetWorker'
+            end
+
+            def runner_function
+              'handle_fleet_request'
+            end
+
+            def use_runner?
+              false
+            end
+
+            def enabled?
+              Legion::Extensions::Llm::Fleet::ProviderResponder.enabled_for?(Anthropic.discover_instances)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -47,7 +47,7 @@ module Legion
           def stream_url = completion_url
           def models_url = '/v1/models'
 
-          def embed(_text, model:, dimensions:)
+          def embed(**_provider_options)
             raise NotImplementedError, 'Anthropic does not expose embeddings through this provider'
           end
 

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/llm/fleet/provider_responder'
+require 'legion/extensions/llm/anthropic'
+
+module Legion
+  module Extensions
+    module Llm
+      module Anthropic
+        module Runners
+          # Runner entrypoint for Anthropic fleet request execution.
+          module FleetWorker
+            module_function
+
+            def handle_fleet_request(payload, delivery: nil, properties: nil)
+              Legion::Extensions::Llm::Fleet::ProviderResponder.call(
+                payload: payload,
+                provider_family: Anthropic::PROVIDER_FAMILY,
+                provider_class: Anthropic::Provider,
+                provider_instances: -> { Anthropic.discover_instances },
+                delivery: delivery,
+                properties: properties
+              )
+            end
+          end
+        end
+      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.0'
+        VERSION = '0.2.5'
       end
     end
   end

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

@@ -24,8 +24,16 @@ module Legion
               tier: :frontier,
               transport: :http,
               credentials: { api_key: 'env://ANTHROPIC_API_KEY' },
-              usage: { inference: true, embedding: false },
-              limits: { concurrency: 4 }
+              usage: { inference: true, embedding: false, image: false },
+              limits: { concurrency: 4 },
+              fleet: {
+                enabled: false,
+                respond_to_requests: false,
+                capabilities: %i[chat stream_chat],
+                lanes: [],
+                concurrency: 4,
+                queue_suffix: nil
+              }
             }
           )
         end
@@ -34,7 +42,11 @@ module Legion
           Provider
         end
 
-        def self.discover_instances # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        def self.provider_aliases
+          [:claude]
+        end
+
+        def self.discover_instances # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           candidates = {}
 
           env_key = CredentialSources.env('ANTHROPIC_API_KEY')
@@ -59,11 +71,22 @@ module Legion
           if settings_config.is_a?(Hash)
             settings_key = settings_config[:api_key] || settings_config['api_key']
             if settings_key
-              candidates[:settings] = settings_config.merge(
+              candidates[:settings] = normalize_instance_config(settings_config).merge(
+                api_key: settings_key,
                 anthropic_api_key: settings_key,
                 tier: :frontier
               )
             end
+
+            settings_instances(settings_config).each do |name, config|
+              next unless config.is_a?(Hash)
+
+              normalized = normalize_instance_config(config)
+              next unless normalized[:anthropic_api_key]
+
+              normalized[:api_key] = normalized[:anthropic_api_key]
+              candidates[name.to_sym] = normalized.merge(tier: :frontier)
+            end
           end
 
           if defined?(Legion::Identity::Broker)
@@ -77,20 +100,31 @@ module Legion
             end
           end
 
-          CredentialSources.dedup_credentials(candidates)
+          CredentialSources.dedup_credentials(candidates).transform_values { |config| sanitize_instance_config(config) }
         end
 
-        def self.register_discovered_instances
-          super
-          return unless defined?(Legion::LLM::Call::Registry)
+        def self.settings_instances(config)
+          instances = config[:instances] || config['instances']
+          instances.is_a?(Hash) ? instances : {}
+        end
 
-          Legion::LLM::Call::Registry.instances_for(:anthropic).each do |instance_id, adapter|
-            Legion::LLM::Call::Registry.register(:claude, adapter, instance: instance_id)
-          end
+        def self.normalize_instance_config(config) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+          normalized = config.to_h.transform_keys { |key| key.respond_to?(:to_sym) ? key.to_sym : key }
+          normalized[:anthropic_api_key] ||= normalized.delete(:api_key)
+          normalized[:anthropic_api_base] ||= normalized.delete(:base_url)
+          normalized[:anthropic_api_base] ||= normalized.delete(:api_base)
+          normalized[:anthropic_api_base] ||= normalized.delete(:endpoint)
+          normalized[:anthropic_version] ||= normalized.delete(:version)
+          normalized.compact.except(:instances)
+        end
+
+        def self.sanitize_instance_config(config)
+          config.except(:api_key)
         end
+
+        Legion::Extensions::Llm::Configuration.register_provider_options(Provider.configuration_options) if
+          Legion::Extensions::Llm::Configuration.respond_to?(:register_provider_options)
       end
     end
   end
 end
-
-Legion::Extensions::Llm::Anthropic.register_discovered_instances

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-anthropic
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.5
 platform: ruby
 authors:
 - LegionIO
@@ -51,20 +51,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.14
 - !ruby/object:Gem::Dependency
   name: lex-llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.3
 description: Anthropic provider integration for the LegionIO LLM routing framework.
 email:
 - matthewdiverson@gmail.com
@@ -83,9 +97,11 @@ files:
 - README.md
 - lex-llm-anthropic.gemspec
 - lib/legion/extensions/llm/anthropic.rb
+- lib/legion/extensions/llm/anthropic/actors/fleet_worker.rb
 - lib/legion/extensions/llm/anthropic/provider.rb
 - lib/legion/extensions/llm/anthropic/registry_event_builder.rb
 - lib/legion/extensions/llm/anthropic/registry_publisher.rb
+- lib/legion/extensions/llm/anthropic/runners/fleet_worker.rb
 - lib/legion/extensions/llm/anthropic/transport/exchanges/llm_registry.rb
 - lib/legion/extensions/llm/anthropic/transport/messages/registry_event.rb
 - lib/legion/extensions/llm/anthropic/version.rb