lex-llm-anthropic 0.2.16 → 0.2.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ef129fbcb71eb5500eff0ef7047dda892d97d57b21dab9567488be60cca0401
-  data.tar.gz: 3efed0ed6d287da75ac969e7dd29121b1c4e49e11f989a7fb7fed4f8c24f1ac2
+  metadata.gz: c8d65710f4980c8851f9ff9457cadb0053493ec4817e91b0b046ea354297c9a2
+  data.tar.gz: d88fda72706b4035cd5ba2866c3b4354c2f36bdcad1d56bd1373684a8c82b0f9
 SHA512:
-  metadata.gz: dfd4e546964d3994cb294860aae5d2f81476c0c067b76519b9c65506eb782e32df58fda6ede3df2f9c17095b1b7aaf7e940a2e5afc4ea34efb7d086c00e17c4f
-  data.tar.gz: 62d2e1ac960fd5084becf6d83beb966ad02556205f1d70b183ab48892a69cb3783004eddcbea08435986b7a8ec569a3f41f8b835a5e12aed63b8388b078471e3
+  metadata.gz: 8a81ea1ad5a04c67d4079af690238308be289c66315f19555a4d5423a92c43f3ffc940356bf52791d6fd504a446e5fc53fc495c798458f42a7e18bc6beaa5863
+  data.tar.gz: d53359d7292d05f5719a7412b90d6a8761cc2982f8325a63446dc92ded3c77957c2914a1138eda5eaf52ff56e41408aeea3337cb49c62a00506de860780ad89f

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.2.20 - 2026-06-16
+
+- dependency updates, code quality improvements
+
+## 0.2.19 - 2026-06-15
+
+- **CapabilityPolicy integration** — Streaming and tools from `:provider_envelope`; vision/thinking default false unless explicitly enabled via settings. Settings overrides at provider/instance/model level supported.
+
+## 0.2.18 - 2026-06-13
+
+- **Gemfile cleanup** — Remove local path overrides; all dependencies resolve from gemspec via rubygems.
+- 135 examples, 0 failures; 20 files, 0 rubocop offenses.
+
+## 0.2.17 - 2026-06-10
+
+- **Canonical provider translator (Phase 3)** — New `Translator` class implementing the Anthropic↔canonical boundary per N×N routing design. Public interface: `render_request(canonical_request)`, `parse_response(wire)`, `parse_chunk(raw)`, `capabilities`. Extracted from existing `Provider` render/parse methods — behaviour preserved, not rewritten (translator.rb).
+- **Anthropic capability declarations** — `thinking: :signature_lifecycle`, `assistant_prefill: true`, `tool_calls: :native`, `system_content_blocks: true`, `supported_params` explicitly listed.
+- **G18 param mapping** — max_tokens, temperature, stop_sequences, seed, response_format rendered to Anthropic wire format. max_thinking_tokens → thinking.budget_tokens. top_p, top_k, frequency_penalty, presence_penalty dropped with debug log (Anthropic doesn't support).
+- **stop_reason mapping** — Maps 1:1 with canonical enums: end_turn, tool_use, max_tokens, stop_sequence, content_filter. Unmapped values default to end_turn with debug log.
+- **Thinking/signature lifecycle** — Parsing handles both canonical-form (delta as string) and Anthropic wire-form (delta as nested {text, thinking, signature} object). Supports thinking_content, redacted_thinking, signature_delta lifecycle per R4.
+- **Usage parsing** — input/output tokens, cache_read_input_tokens → cache_read_tokens, cache_creation_input_tokens → cache_write_tokens, thinking_tokens output_tokens_details.reasoning_tokens fallback chain.
+- **Conformance kit integration** — spec_helper loads `it_behaves_like('a canonical provider translator')` and `it_behaves_like('a canonical client translator')` shared examples from lex-llm gem spec directory per B1b consumer pattern.
+- **Lex-llm dependency bumped to >= 0.5.0** — Requires canonical types (B1a) and conformance kit (B1b) shipped in lex-llm 0.5.0 (gemspec).
+- **Rules** — No bare `::JSON` (Legion::JSON.load with ParseError rescue), no `_foo:` kwargs, no `**_rest`, all tunable defaults in config. 135 examples, 0 failures; 20 files, 0 rubocop offenses.
+
 ## 0.2.16 - 2026-06-10
 
 - **Hash-backed tool support** — `format_tools` and `tool_schema` now handle both `ToolDefinition` objects and plain Hashes from `native_dispatch` via `respond_to?` checks with symbol/string key fallbacks. Prevents `NoMethodError` when tools arrive as hash-backed definitions (provider.rb).

data/Gemfile

@@ -2,13 +2,6 @@
 
 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
-
 gemspec
 
 group :development do

data/lex-llm-anthropic.gemspec

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

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

@@ -36,6 +36,9 @@ module Legion
               return unless defined?(Legion::LLM::Discovery)
 
               Legion::LLM::Discovery.refresh_discovered_models!(provider: :anthropic)
+
+              Legion::LLM::Router.populate_auto_rules(Legion::LLM::Discovery.discovered_instances) if defined?(Legion::LLM::Router) && Legion::LLM::Router.respond_to?(:populate_auto_rules)
+              Legion::LLM::Inventory.invalidate_offerings_cache! if defined?(Legion::LLM::Inventory) && Legion::LLM::Inventory.respond_to?(:invalidate_offerings_cache!)
             rescue StandardError => e
               handle_exception(e, level: :warn, handled: true, operation: 'anthropic.actor.discovery_refresh')
             end

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

@@ -20,7 +20,7 @@ module Legion
             def capabilities = Capabilities
 
             def registry_publisher
-              @registry_publisher ||= RegistryPublisher.new
+              @registry_publisher ||= Legion::Extensions::Llm::RegistryPublisher.new(provider_family: :anthropic)
             end
           end
 
@@ -54,6 +54,10 @@ module Legion
           def stream_url = completion_url
           def models_url = '/v1/models'
 
+          def translator
+            @translator ||= Translator.new(config)
+          end
+
           def embed(**_provider_options)
             raise NotImplementedError, 'Anthropic does not expose embeddings through this provider'
           end
@@ -76,6 +80,8 @@ module Legion
             'claude-3-haiku'  => 200_000
           }.freeze
 
+          COMPLETION_BASE = [:completion].freeze
+
           private
 
           def render_payload(messages, tools:, temperature:, model:, stream:, schema:, thinking:, tool_prefs:)
@@ -186,7 +192,11 @@ module Legion
 
           def format_tool_call_message(message, thinking:, cache:)
             blocks = content_blocks(message.content, thinking:, message:, cache:)
-            message.tool_calls.each_value { |tool_call| blocks << tool_use_block(tool_call, cache:) }
+            # tool_calls is an Array of ToolCall since the adapter stopped
+            # name-keying them (name-keyed hashes silently dropped parallel
+            # same-name calls); tolerate the legacy Hash shape from old callers.
+            calls = message.tool_calls.is_a?(Hash) ? message.tool_calls.values : Array(message.tool_calls)
+            calls.each { |tool_call| blocks << tool_use_block(tool_call, cache:) }
             { role: 'assistant', content: blocks }
           end
 
@@ -274,8 +284,8 @@ module Legion
           def tool_schema(tool)
             return tool.params_schema if tool.respond_to?(:params_schema) && tool.params_schema
 
-            { type: 'object',
-              properties: tool.respond_to?(:parameters) ? tool.parameters : (tool[:parameters] || tool['parameters'] || {}), required: [] }
+            raw = tool.respond_to?(:parameters) ? tool.parameters : (tool[:parameters] || tool['parameters'])
+            Legion::Extensions::Llm::Canonical::ToolDefinition.normalize_parameters(raw)
           end
 
           def tool_choice(tool_prefs)
@@ -318,116 +328,124 @@ module Legion
 
           def parse_completion_response(response)
             body = response.body
-            content_blocks = body['content'] || []
-            usage = body['usage'] || {}
-
-            Legion::Extensions::Llm::Message.new(
-              role:                  :assistant,
-              content:               text_from(content_blocks),
-              model_id:              body['model'],
-              thinking:              thinking_from(content_blocks),
-              tool_calls:            parse_tool_calls(content_blocks),
-              input_tokens:          usage['input_tokens'],
-              output_tokens:         usage['output_tokens'],
-              cached_tokens:         usage['cache_read_input_tokens'],
-              cache_creation_tokens: cache_creation_tokens(usage),
-              thinking_tokens:       thinking_tokens(usage),
-              raw:                   body
-            )
+            canonical = translator.parse_response(body)
+            to_legacy_message(canonical, body)
           end
 
-          def text_from(blocks)
-            blocks.select { |block| block['type'] == 'text' }.map { |block| block['text'] }.join
-          end
-
-          def thinking_from(blocks)
-            thinking_block = blocks.find { |block| block['type'] == 'thinking' }
-            redacted_block = blocks.find { |block| block['type'] == 'redacted_thinking' }
-
-            Legion::Extensions::Llm::Thinking.build(
-              text:      thinking_block&.dig('thinking') || thinking_block&.dig('text'),
-              signature: thinking_block&.dig('signature') || redacted_block&.dig('data')
-            )
-          end
-
-          def cache_creation_tokens(usage)
-            cache_creation = usage['cache_creation']
-            cache_creation_values = cache_creation.values if cache_creation
+          def build_chunk(data)
+            canonical_chunk = translator.parse_chunk(data)
+            return nil if canonical_chunk.nil?
 
-            usage['cache_creation_input_tokens'] || cache_creation_values&.compact&.sum
+            to_legacy_chunk(canonical_chunk, data)
           end
 
-          def thinking_tokens(usage)
-            usage.dig('output_tokens_details', 'thinking_tokens') ||
-              usage.dig('output_tokens_details', 'reasoning_tokens') ||
-              usage['thinking_tokens'] ||
-              usage['reasoning_tokens']
+          def to_legacy_message(canonical, raw_body)
+            usage = canonical.usage
+            Legion::Extensions::Llm::Message.new(
+              role:                  :assistant,
+              content:               canonical.text,
+              model_id:              canonical.model,
+              thinking:              if canonical.thinking
+                                       Legion::Extensions::Llm::Thinking.build(
+                                         text:      canonical.thinking.content,
+                                         signature: canonical.thinking.signature
+                                       )
+                                     end,
+              tool_calls:            legacy_tool_calls(canonical.tool_calls),
+              input_tokens:          usage&.input_tokens,
+              output_tokens:         usage&.output_tokens,
+              cached_tokens:         usage&.cache_read_tokens,
+              cache_creation_tokens: usage&.cache_write_tokens,
+              thinking_tokens:       usage&.thinking_tokens,
+              raw:                   raw_body
+            )
           end
 
-          def build_chunk(data)
-            delta_type = data.dig('delta', 'type')
-
+          def to_legacy_chunk(canonical_chunk, raw_data)
             Legion::Extensions::Llm::Chunk.new(
               role:          :assistant,
-              content:       delta_type == 'text_delta' ? data.dig('delta', 'text') : nil,
-              model_id:      data.dig('message', 'model'),
-              thinking:      Legion::Extensions::Llm::Thinking.build(
-                text:      delta_type == 'thinking_delta' ? data.dig('delta', 'thinking') : nil,
-                signature: delta_type == 'signature_delta' ? data.dig('delta', 'signature') : nil
-              ),
-              input_tokens:  data.dig('message', 'usage', 'input_tokens'),
-              output_tokens: data.dig('message', 'usage', 'output_tokens') || data.dig('usage', 'output_tokens'),
-              tool_calls:    extract_streaming_tool_calls(data, delta_type)
+              content:       canonical_chunk.text_delta? ? canonical_chunk.delta : nil,
+              model_id:      raw_data.dig('message', 'model'),
+              thinking:      if canonical_chunk.thinking_delta?
+                               Legion::Extensions::Llm::Thinking.build(
+                                 text:      canonical_chunk.delta,
+                                 signature: canonical_chunk.signature
+                               )
+                             end,
+              input_tokens:  canonical_chunk.usage&.input_tokens,
+              output_tokens: canonical_chunk.usage&.output_tokens,
+              tool_calls:    legacy_streaming_tool_calls(canonical_chunk)
             )
           end
 
-          def extract_streaming_tool_calls(data, _delta_type)
-            content_block = data['content_block']
-            return nil unless content_block && content_block['type'] == 'tool_use'
+          def legacy_tool_calls(canonical_tool_calls)
+            return nil if canonical_tool_calls.nil? || canonical_tool_calls.empty?
 
-            { content_block['id'] => Legion::Extensions::Llm::ToolCall.new(
-              id: content_block['id'], name: content_block['name'], arguments: ''
-            ) }
-          end
-
-          def parse_tool_calls(content_blocks)
-            blocks = Array(content_blocks).select { |block| block && block['type'] == 'tool_use' }
-            return nil if blocks.empty?
-
-            blocks.to_h do |block|
+            canonical_tool_calls.to_h do |tc|
               [
-                block['id'],
+                tc.id,
                 Legion::Extensions::Llm::ToolCall.new(
-                  id:        block['id'],
-                  name:      block['name'],
-                  arguments: block['input'] || {}
+                  id: tc.id, name: tc.name, arguments: tc.arguments || {}
                 )
               ]
             end
           end
 
+          def legacy_streaming_tool_calls(canonical_chunk)
+            return nil unless canonical_chunk.tool_call_delta?
+
+            tc = canonical_chunk.tool_call
+            return nil unless tc
+
+            { tc.id => Legion::Extensions::Llm::ToolCall.new(
+              id: tc.id, name: tc.name, arguments: tc.arguments || ''
+            ) }
+          end
+
           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)
+              resolved = resolve_model_capabilities(model_id)
               Legion::Extensions::Llm::Model::Info.new(
                 id:             model_id,
                 name:           model['display_name'] || model_id,
                 provider:       provider,
-                capabilities:   %i[completion streaming tools],
+                capabilities:   COMPLETION_BASE + resolved[:capabilities],
                 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
+          def resolve_model_capabilities(model_id)
+            provider_settings = CredentialSources.setting(:extensions, :llm, :anthropic)
+            provider_cfg = provider_settings.is_a?(Hash) ? provider_settings.except(:instances) : {}
+            model_cfg = model_config_for(model_id, provider_settings)
+
+            Legion::Extensions::Llm::CapabilityPolicy.resolve(
+              real:              {},
+              provider_catalog:  {},
+              probe:             {},
+              provider_envelope: { streaming: true, tools: true },
+              provider_config:   provider_cfg,
+              instance_config:   config.respond_to?(:to_h) ? config.to_h : {},
+              model_config:      model_cfg
+            )
           end
 
-          def model_detail(model_name)
-            fetch_model_detail(model_name)
+          def model_config_for(model_id, provider_settings)
+            return {} unless provider_settings.is_a?(Hash)
+
+            models = provider_settings[:models] || provider_settings['models']
+            return {} unless models.is_a?(Hash)
+
+            models[model_id.to_sym] || models[model_id] || {}
+          end
+
+          def infer_context_window(model_id)
+            CONTEXT_WINDOWS.find { |prefix, _| model_id.start_with?(prefix) }&.last
           end
 
           def fetch_model_detail(model_name)

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

@@ -0,0 +1,651 @@
+# frozen_string_literal: true
+
+require 'legion/logging/helper'
+require 'legion/extensions/llm/canonical'
+
+module Legion
+  module Extensions
+    module Llm
+      module Anthropic
+        # Canonical provider translator for Anthropic Messages API.
+        # Implements the provider-boundary contract: canonical to Anthropic wire format.
+        # Extracted from Provider render_format/parse methods - behaviour preserved, not rewritten.
+        class Translator
+          include Legion::Logging::Helper
+
+          # Anthropic-specific capabilities per the Phase 3 design.
+          CAPABILITIES = {
+            provider:              'anthropic',
+            # Thinking lifecycle: open thinking -> delta -> signature_delta -> close.
+            # Signature required alongside thinking content on Anthropic.
+            thinking:              :signature_lifecycle,
+            # Anthropic supports assistant prefill (sending partial assistant message
+            # to bias completion direction) - used in mid-stream failover (G6).
+            assistant_prefill:     true,
+            # Streaming support.
+            streaming:             true,
+            # Tool calls are first-class (tool_use content blocks).
+            tool_calls:            :native,
+            # System prompt as array of content blocks.
+            system_content_blocks: true,
+            # Supported params (G18). Unsupported params dropped with debug log.
+            supported_params:      %i[
+              max_tokens temperature stop_sequences seed response_format
+            ].freeze
+          }.freeze
+
+          def capabilities = CAPABILITIES
+          def config = @config || {}
+          def initialize(config = {}) = @config = config
+
+          # Render: Canonical::Request to Anthropic wire Hash.
+          def render_request(canonical_request)
+            msgs = canonical_request.messages || []
+            system_messages, chat_messages = msgs.partition { |msg| msg.role == :system }
+
+            system_parts = if canonical_request.system
+                             render_system_string(canonical_request.system)
+                           else
+                             render_system_content(system_messages)
+                           end
+            message_parts = render_messages(chat_messages, thinking: thinking_enabled?(canonical_request))
+            tools = render_tools(canonical_request.tools)
+            tool_choice = render_tool_choice(canonical_request.tool_choice)
+            model_id = canonical_request.metadata&.dig(:model) || 'claude-sonnet-4'
+
+            base = {
+              model:       model_id,
+              messages:    message_parts,
+              stream:      canonical_request.stream,
+              system:      system_parts,
+              temperature: canonical_request.params&.temperature
+            }.compact
+
+            params = canonical_request.params
+            if params
+              base[:max_tokens] = params.max_tokens
+              base[:stop_sequences] = params.stop_sequences
+              base[:seed] = params.seed
+              drop_unsupported_params(params)
+              base[:response_format] = render_response_format(params.response_format)
+            end
+
+            base[:thinking] = render_thinking_config(canonical_request) if thinking_enabled?(canonical_request)
+            base[:tools] = tools if tools && !tools.empty?
+            base[:tool_choice] = tool_choice if tool_choice
+            base[:max_tokens] ||= canonical_request.metadata&.dig(:default_max_tokens) || settings_default_max_tokens
+
+            base.compact
+          end
+
+          # Parse: Anthropic wire Hash to Canonical::Response. Accepts both Anthropic wire format
+          # (content: array of blocks) and canonical form (text: string) for conformance kit compatibility.
+          def parse_response(wire)
+            # If the wire has canonical 'text' key, pass through using Canonical::Response factory.
+            return Canonical::Response.from_hash(wire) if wire.key?(:text) || wire.key('text')
+
+            content = Array(wire[:content] || wire['content'] || [])
+            usage = wire[:usage] || wire['usage'] || {}
+            raw_usage = parse_usage(usage)
+
+            text = extract_text(content)
+            thinking = extract_thinking(content)
+            tool_calls = extract_tool_calls(content)
+            stop_reason = map_stop_reason(wire[:stop_reason] || wire['stop_reason'])
+            model = wire[:model] || wire['model']
+
+            Canonical::Response.build(
+              text:        text,
+              thinking:    thinking,
+              tool_calls:  tool_calls,
+              usage:       raw_usage,
+              stop_reason: stop_reason,
+              model:       model,
+              routing:     {},
+              metadata:    wire.except(:content, :usage, :stop_reason, :model).compact
+            )
+          end
+
+          # Parse chunk: raw Anthropic SSE event to Canonical::Chunk.
+          # Real Anthropic events use top-level types like content_block_delta, message_delta,
+          # content_block_start; the delta kind is nested inside delta.type.
+          def parse_chunk(raw)
+            return nil unless raw.is_a?(Hash) && (raw.key?(:type) || raw.key?('type'))
+
+            type = (raw[:type] || raw['type']).to_s
+            delta = raw[:delta] || raw['delta'] || {}
+            delta = {} unless delta.is_a?(Hash)
+            delta_type = (delta[:type] || delta['type']).to_s
+
+            case type
+            when 'content_block_delta'
+              parse_content_block_delta(raw, delta, delta_type)
+            when 'content_block_start'
+              parse_content_block_start(raw)
+            when 'message_start'
+              parse_message_start(raw)
+            when 'message_delta'
+              parse_message_delta(raw, delta)
+            when 'message_stop'
+              Canonical::Chunk.done(
+                request_id:  raw[:request_id] || '',
+                stop_reason: map_stop_reason(delta[:stop_reason] || delta['stop_reason'])
+              )
+            when 'text_delta'
+              Canonical::Chunk.text_delta(
+                delta:       extract_delta(raw, 'text_delta'),
+                request_id:  raw[:request_id],
+                block_index: raw[:block_index] || raw['index']
+              )
+            when 'thinking_delta'
+              sig_from_delta = (delta[:signature] || delta['signature'] if delta.any?)
+              Canonical::Chunk.thinking_delta(
+                delta:       extract_delta(raw, 'thinking_delta'),
+                request_id:  raw[:request_id],
+                block_index: raw[:block_index] || raw['index'],
+                signature:   raw[:signature] || raw['signature'] || sig_from_delta
+              )
+            when 'tool_call_delta'
+              tc = extract_tool_call_from_chunk(raw)
+              return nil unless tc
+
+              Canonical::Chunk.tool_call_delta(
+                tool_call:   tc,
+                request_id:  raw[:request_id],
+                block_index: raw[:block_index] || raw['index']
+              )
+            when 'error'
+              Canonical::Chunk.error_chunk(
+                error:      raw[:error] || raw['error'] || 'unknown',
+                request_id: raw[:request_id] || '',
+                metadata:   raw[:metadata] || raw['metadata'] || {}
+              )
+            when 'done'
+              usage = (Canonical::Usage.from_hash(raw[:usage] || raw['usage'] || {}) if raw[:usage] || raw['usage'])
+              Canonical::Chunk.done(
+                request_id:  raw[:request_id] || '',
+                usage:       usage,
+                stop_reason: map_stop_reason(raw[:stop_reason] || raw['stop_reason'])
+              )
+            else
+              log.debug("[anthropic translator] ignoring unknown chunk type: #{type.inspect}")
+              nil
+            end
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true, operation: 'anthropic.translator.parse_chunk')
+            Canonical::Chunk.error_chunk(
+              error:      "#{e.class}: #{e.message}",
+              request_id: raw[:request_id] || ''
+            )
+          end
+
+          private
+
+          # --- render_messages ---
+
+          def render_messages(messages, thinking:)
+            messages.map do |msg|
+              case msg.role
+              when :assistant
+                render_assistant_message(msg, thinking:)
+              when :tool
+                render_tool_result_message(msg)
+              else
+                {
+                  role:    msg.role.to_s,
+                  content: render_content_blocks(msg.content)
+                }
+              end
+            end
+          end
+
+          def render_assistant_message(msg, thinking:)
+            blocks = render_content_blocks(msg.content)
+            blocks.unshift({ type: 'text', text: '' }) if thinking && msg.text.to_s.empty? && !msg.tool_calls&.empty?
+
+            Array(msg.tool_calls).each do |tc|
+              args = tc.is_a?(Canonical::ToolCall) ? tc.arguments : (tc[:arguments] || tc['arguments'] || {})
+              args = parse_json_or_hash(args)
+              blocks << {
+                type:  'tool_use',
+                id:    tc.is_a?(Canonical::ToolCall) ? tc.id : (tc[:id] || tc['id']),
+                name:  tc.is_a?(Canonical::ToolCall) ? tc.name : (tc[:name] || tc['name']),
+                input: args
+              }
+            end
+
+            { role: 'assistant', content: blocks }
+          end
+
+          def render_tool_result_message(msg)
+            tool_call_id = msg.tool_call_id
+            result_content = render_content_blocks(msg.content)
+
+            {
+              role:    'user',
+              content: [
+                { type: 'tool_result', tool_use_id: tool_call_id, content: result_content }
+              ]
+            }
+          end
+
+          def render_content_blocks(content)
+            return [{ type: 'text', text: content.to_s }] if content.is_a?(String)
+            return [] if content.nil?
+
+            blocks = Array(content).filter_map do |block|
+              case block
+              when Canonical::ContentBlock
+                content_block_to_wire(block)
+              when Hash
+                hash_block_to_wire(block)
+              else
+                { type: 'text', text: block.to_s }
+              end
+            end
+            blocks.empty? ? [] : blocks
+          end
+
+          def content_block_to_wire(block)
+            wire = case block.type
+                   when :thinking
+                     { type: 'thinking', thinking: block.text || '' }
+                   when :tool_use
+                     { type: 'tool_use', id: block.id, name: block.name, input: block.input || {} }
+                   when :tool_result
+                     { type: 'tool_result', tool_use_id: block.tool_use_id,
+                       content: [{ type: 'text', text: block.text || '' }] }
+                   when :image
+                     { type: 'image', source: { type: block.source_type || 'base64',
+                                                media_type: block.media_type, data: block.data } }
+                   else
+                     { type: 'text', text: block.text || '' }
+                   end
+            wire[:cache_control] = block.cache_control if block.cache_control
+            wire
+          end
+
+          def hash_block_to_wire(block)
+            block_type = block[:type] || block['type']
+            cc = block[:cache_control] || block['cache_control']
+
+            wire = case block_type
+                   when 'image'
+                     { type: 'image', source: block[:source] || block['source'] || {} }
+                   when 'tool_result'
+                     {
+                       type:        'tool_result',
+                       tool_use_id: block[:tool_use_id] || block['tool_use_id'],
+                       content:     Array(block[:content] || block['content']).map do |item|
+                         if item.is_a?(Hash)
+                           { type: 'text', text: item[:text] || item['text'] || '' }
+                         else
+                           { type: 'text', text: item.to_s }
+                         end
+                       end
+                     }
+                   else
+                     return block
+                   end
+            wire[:cache_control] = cc if cc
+            wire
+          end
+
+          # --- system content ---
+
+          def render_system_string(system_input)
+            return system_input if system_input.is_a?(Hash) || system_input.is_a?(Array)
+
+            [{ type: 'text', text: system_input.to_s }]
+          end
+
+          def render_system_content(messages)
+            parts = messages.flat_map do |msg|
+              content = msg.content
+              if content.is_a?(Canonical::ContentBlock) && content.type == :text
+                [{ type: 'text', text: content.text || '' }]
+              elsif content.is_a?(Array)
+                render_content_blocks(content)
+              else
+                [{ type: 'text', text: content.to_s }]
+              end
+            end
+            parts.empty? ? nil : parts
+          end
+
+          # --- tools ---
+
+          def render_tools(tools)
+            return nil if tools.nil? || tools.empty?
+
+            tools.values.map do |tool|
+              name = tool.is_a?(Canonical::ToolDefinition) ? tool.name : (tool[:name] || tool['name'])
+              desc = tool.is_a?(Canonical::ToolDefinition) ? tool.description : (tool[:description] || tool['description'] || '')
+              params = if tool.is_a?(Canonical::ToolDefinition)
+                         tool.parameters
+                       else
+                         Canonical::ToolDefinition.normalize_parameters(tool[:parameters] || tool['parameters'])
+                       end
+
+              { name: name, description: desc, input_schema: params }
+            end
+          end
+
+          # --- tool_choice ---
+
+          def render_tool_choice(tool_choice)
+            return nil unless tool_choice
+
+            case tool_choice
+            when :auto, 'auto'
+              { type: 'auto' }
+            when :none, 'none'
+              nil
+            when :required, 'required'
+              { type: 'any' }
+            when Hash
+              { type: 'tool', name: tool_choice[:name] || tool_choice['name'] }
+            when Symbol, String
+              { type: 'tool', name: tool_choice.to_s }
+            end
+          end
+
+          # --- thinking ---
+
+          def thinking_enabled?(canonical_request)
+            thinking = canonical_request.thinking
+            return false unless thinking
+
+            case thinking
+            when Canonical::Thinking::Config
+              thinking.enabled?
+            when Hash
+              !!thinking
+            else
+              true
+            end
+          end
+
+          def render_thinking_config(canonical_request)
+            tc = canonical_request.thinking
+            budget = case tc
+                     when Canonical::Thinking::Config
+                       tc.budget
+                     when Hash
+                       tc[:budget] || tc['budget'] || tc[:budget_tokens] || tc['budget_tokens']
+                     end
+
+            budget ||= canonical_request.params&.max_thinking_tokens
+            budget = default_thinking_budget if budget.nil? || budget.zero?
+
+            { type: 'enabled', budget_tokens: budget }
+          end
+
+          def default_thinking_budget
+            @config[:default_thinking_budget] || 1024
+          end
+
+          # --- response_format ---
+
+          def render_response_format(fmt)
+            return nil unless fmt
+
+            normalized = fmt.is_a?(Hash) ? fmt : {}
+            fmt_type = normalized[:type] || normalized['type']
+            schema = normalized[:schema] || normalized['schema'] || normalized.except(:type)
+
+            case fmt_type
+            when 'json_object', 'json_schema'
+              if schema && !schema.empty?
+                { type: 'json_schema', schema: schema }
+              else
+                { type: 'json_object' }
+              end
+            when :json, 'json'
+              { type: 'json_object' }
+            end
+          end
+
+          # --- unsupported params ---
+
+          def drop_unsupported_params(params)
+            # Anthropic Messages API does NOT support: top_p, top_k, frequency_penalty, presence_penalty.
+            unsupported = {}
+            unsupported[:top_p] = params.top_p if params.top_p
+            unsupported[:top_k] = params.top_k if params.top_k
+            unsupported[:frequency_penalty] = params.frequency_penalty if params.frequency_penalty
+            unsupported[:presence_penalty] = params.presence_penalty if params.presence_penalty
+
+            return if unsupported.empty?
+
+            log.debug("[anthropic translator] dropping unsupported params: #{unsupported.keys.join(', ')}")
+          end
+
+          # --- response parsing ---
+
+          def extract_text(blocks)
+            blocks.select { |b| (b[:type] || b['type']) == 'text' }
+                  .map { |b| b[:text] || b['text'] || '' }
+                  .join
+          end
+
+          def extract_thinking(blocks)
+            thinking_block = blocks.find { |b| (b[:type] || b['type']) == 'thinking' }
+            redacted_block = blocks.find { |b| (b[:type] || b['type']) == 'redacted_thinking' }
+
+            content = thinking_block&.dig(:thinking) || thinking_block&.dig('thinking') ||
+                      thinking_block&.dig(:text) || thinking_block&.dig('text')
+            signature = thinking_block&.dig(:signature) || thinking_block&.dig('signature') ||
+                        redacted_block&.dig(:data) || redacted_block&.dig('data')
+
+            Canonical::Thinking.from_hash({ content: content, signature: signature })
+          end
+
+          def extract_tool_calls(blocks)
+            tc_blocks = blocks.select { |b| (b[:type] || b['type']) == 'tool_use' }
+            return [] if tc_blocks.empty?
+
+            tc_blocks.map do |block|
+              args_input = block[:input] || block['input'] || {}
+              args = parse_json_or_hash(args_input)
+
+              Canonical::ToolCall.build(
+                id:        block[:id] || block['id'],
+                name:      block[:name] || block['name'],
+                arguments: args,
+                source:    :client
+              )
+            end
+          end
+
+          def parse_json_or_hash(input)
+            return input if input.is_a?(Hash)
+
+            if input.is_a?(String)
+              begin
+                Legion::JSON.load(input)
+              rescue Legion::JSON::ParseError
+                { raw_json: input }
+              end
+            else
+              {}
+            end
+          end
+
+          def parse_usage(usage)
+            Canonical::Usage.from_hash(
+              input_tokens:       usage[:input_tokens] || usage['input_tokens'],
+              output_tokens:      usage[:output_tokens] || usage['output_tokens'],
+              cache_read_tokens:  usage[:cache_read_input_tokens] || usage['cache_read_input_tokens'],
+              cache_write_tokens: cache_creation_input_tokens(usage),
+              thinking_tokens:    thinking_tokens_raw(usage)
+            )
+          end
+
+          def cache_creation_input_tokens(usage)
+            val = usage[:cache_creation_input_tokens] || usage['cache_creation_input_tokens']
+            return val if val
+
+            cache_creation = usage[:cache_creation] || usage['cache_creation']
+            return cache_creation.values.sum if cache_creation.is_a?(Hash)
+
+            val
+          end
+
+          def thinking_tokens_raw(usage)
+            usage.dig(:output_tokens_details, :thinking_tokens) ||
+              usage.dig('output_tokens_details', 'thinking_tokens') ||
+              usage.dig(:output_tokens_details, :reasoning_tokens) ||
+              usage.dig('output_tokens_details', 'reasoning_tokens') ||
+              usage[:thinking_tokens] || usage['thinking_tokens'] ||
+              usage[:reasoning_tokens] || usage['reasoning_tokens']
+          end
+
+          # --- chunk parsing ---
+
+          # --- Anthropic wire-format SSE event parsers ---
+
+          def parse_content_block_delta(raw, delta, delta_type)
+            index = raw[:index] || raw['index']
+            case delta_type
+            when 'text_delta'
+              Canonical::Chunk.text_delta(
+                delta:       delta[:text] || delta['text'] || '',
+                request_id:  raw[:request_id],
+                block_index: index
+              )
+            when 'thinking_delta'
+              Canonical::Chunk.thinking_delta(
+                delta:       delta[:thinking] || delta['thinking'] || '',
+                request_id:  raw[:request_id],
+                block_index: index
+              )
+            when 'signature_delta'
+              Canonical::Chunk.thinking_delta(
+                delta:       '',
+                request_id:  raw[:request_id],
+                block_index: index,
+                signature:   delta[:signature] || delta['signature']
+              )
+            when 'input_json_delta'
+              tc = Canonical::ToolCall.new(
+                id: nil, exchange_id: nil, name: nil, source: nil,
+                arguments: delta[:partial_json] || delta['partial_json'] || '',
+                status: nil, duration_ms: nil, result: nil, error: nil,
+                started_at: nil, finished_at: nil, category: nil,
+                data_handling_classification: nil, policy_decision: nil
+              )
+              Canonical::Chunk.tool_call_delta(
+                tool_call:   tc,
+                request_id:  raw[:request_id],
+                block_index: index
+              )
+            else
+              log.debug("[anthropic translator] ignoring content_block_delta delta_type: #{delta_type}")
+              nil
+            end
+          end
+
+          def parse_content_block_start(raw)
+            content_block = raw[:content_block] || raw['content_block'] || {}
+            return nil unless content_block.is_a?(Hash)
+
+            block_type = content_block[:type] || content_block['type']
+            return nil unless block_type == 'tool_use'
+
+            tc = Canonical::ToolCall.build(
+              id:   content_block[:id] || content_block['id'],
+              name: content_block[:name] || content_block['name']
+            )
+            Canonical::Chunk.tool_call_delta(
+              tool_call:   tc,
+              request_id:  raw[:request_id],
+              block_index: raw[:index] || raw['index']
+            )
+          end
+
+          def parse_message_start(raw)
+            message = raw[:message] || raw['message'] || {}
+            message = {} unless message.is_a?(Hash)
+            usage_raw = message[:usage] || message['usage']
+            usage = Canonical::Usage.from_hash(usage_raw) if usage_raw.is_a?(Hash) && usage_raw.any?
+
+            Canonical::Chunk.usage_chunk(
+              usage:      usage,
+              request_id: raw[:request_id] || ''
+            )
+          end
+
+          def parse_message_delta(raw, delta)
+            usage_raw = raw[:usage] || raw['usage']
+            usage = Canonical::Usage.from_hash(usage_raw) if usage_raw.is_a?(Hash) && usage_raw.any?
+            stop_reason = delta[:stop_reason] || delta['stop_reason']
+
+            Canonical::Chunk.done(
+              request_id:  raw[:request_id] || '',
+              usage:       usage,
+              stop_reason: map_stop_reason(stop_reason)
+            )
+          end
+
+          def extract_delta(raw, _type)
+            delta_val = raw[:delta] || raw['delta']
+            # Canonical form: delta is a plain string (e.g. from conformance fixtures).
+            return delta_val if delta_val.is_a?(String) && !delta_val.empty?
+
+            # Anthropic wire form: delta is a nested object with {text:} or {thinking:}.
+            raw.dig(:delta, :text) || raw.dig('delta', 'text') ||
+              raw.dig(:delta, :thinking) || raw.dig('delta', 'thinking') ||
+              ''
+          end
+
+          def extract_tool_call_from_chunk(raw)
+            # Canonical form: tool_call is directly in the chunk (e.g. from conformance fixtures).
+            tc_data = raw[:tool_call] || raw['tool_call']
+            return extract_tc_from_data(tc_data) if tc_data
+
+            # Anthropic wire form: tool call is in content_block with type 'tool_use'.
+            cb = raw[:content_block] || raw['content_block']
+            return nil unless cb && ((cb[:type] || cb['type']) == 'tool_use')
+
+            extract_tc_from_data(cb)
+          end
+
+          def extract_tc_from_data(data)
+            Canonical::ToolCall.build(
+              id:        data[:id] || data['id'],
+              name:      data[:name] || data['name'],
+              arguments: data[:arguments] || data['arguments'] || {}
+            )
+          end
+
+          # --- stop_reason mapping ---
+
+          def map_stop_reason(raw)
+            return nil unless raw
+
+            mapping = {
+              'end_turn'       => :end_turn,
+              'tool_use'       => :tool_use,
+              'max_tokens'     => :max_tokens,
+              'stop_sequence'  => :stop_sequence,
+              'content_filter' => :content_filter
+            }
+
+            result = mapping[raw.to_s]
+            return result if result
+
+            log.debug("[anthropic translator] unmapped stop_reason: #{raw.inspect}, defaulting to :end_turn")
+            :end_turn
+          end
+
+          # --- settings helpers ---
+
+          def settings_default_max_tokens
+            @config[:default_max_tokens] || 4096
+          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.16'
+        VERSION = '0.2.20'
       end
     end
   end

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

@@ -2,10 +2,10 @@
 
 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'
+require 'legion/extensions/llm/anthropic/translator'
 require 'legion/extensions/llm/anthropic/version'
+require_relative 'anthropic/actors/discovery_refresh'
 
 module Legion
   module Extensions
@@ -34,10 +34,7 @@ module Legion
               fleet:              {
                 enabled:             false,
                 respond_to_requests: false,
-                capabilities:        %i[chat stream_chat],
-                lanes:               [],
-                concurrency:         4,
-                queue_suffix:        nil
+                capabilities:        %i[chat stream_chat]
               }
             }
           )
@@ -144,8 +141,7 @@ module Legion
           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)
+        Legion::Extensions::Llm::Configuration.register_provider_options(Provider.configuration_options)
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-anthropic
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.2.20
 platform: ruby
 authors:
 - LegionIO
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.5.0
 description: Anthropic provider integration for the LegionIO LLM routing framework.
 email:
 - matthewdiverson@gmail.com
@@ -103,6 +103,7 @@ files:
 - 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/translator.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