lex-llm 0.4.16 → 0.5.0

data/spec/support/fake_llm_provider.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module SpecSupport
+  class FakeLLMProvider < Legion::Extensions::Llm::Provider
+    class << self
+      def configuration_options
+        %i[fake_llm_api_key fake_llm_api_base]
+      end
+
+      def slug
+        'fake_llm'
+      end
+
+      def configuration_requirements
+        []
+      end
+
+      def capabilities
+        Module.new do
+          def self.chat?(_model) = true
+          def self.streaming?(_model) = true
+          def self.vision?(_model) = true
+          def self.functions?(_model) = true
+        end
+      end
+    end
+
+    def api_base
+      config.fake_llm_api_base || 'https://fake-llm.invalid/v1'
+    end
+
+    # rubocop:disable Metrics/ParameterLists, Lint/UnusedMethodArgument
+    def complete(messages, tools:, temperature:, model:, params: {}, headers: {}, schema: nil, thinking: nil,
+                 tool_prefs: nil)
+      if block_given?
+        yield Legion::Extensions::Llm::Chunk.new(content: 'streamed ', role: :assistant)
+        yield Legion::Extensions::Llm::Chunk.new(content: 'response', role: :assistant)
+      end
+
+      if tools.any? && messages.none?(&:tool_result?)
+        tool = tools.values.first
+        return Legion::Extensions::Llm::Message.new(
+          role: :assistant,
+          content: nil,
+          model_id: model.id,
+          tool_calls: {
+            tool.name.to_sym => Legion::Extensions::Llm::ToolCall.new(id: 'tool-call-1', name: tool.name,
+                                                                      arguments: { value: 21 })
+          },
+          input_tokens: 12,
+          output_tokens: 3
+        )
+      end
+
+      content = if schema
+                  Legion::JSON.generate({ answer: 42 })
+                elsif thinking
+                  'fake response with thinking enabled'
+                elsif messages.any?(&:tool_result?)
+                  "tool result: #{messages.last.content}"
+                else
+                  "fake response to #{messages.last.content}"
+                end
+
+      Legion::Extensions::Llm::Message.new(
+        role: :assistant,
+        content: content,
+        model_id: model.id,
+        input_tokens: 10,
+        output_tokens: 5
+      )
+    end
+    # rubocop:enable Metrics/ParameterLists, Lint/UnusedMethodArgument
+
+    def embed(text:, model:, dimensions: nil)
+      size = dimensions || 3
+      vectors = Array(text).map { Array.new(size, 0.5) }
+      vectors = vectors.first unless text.is_a?(Array)
+
+      Legion::Extensions::Llm::Embedding.new(vectors: vectors, model: model, input_tokens: Array(text).size)
+    end
+
+    def moderate(_input, model:)
+      Legion::Extensions::Llm::Moderation.new(
+        id: 'moderation-1',
+        model: model,
+        results: [{ 'flagged' => false, 'categories' => {}, 'category_scores' => {} }]
+      )
+    end
+
+    def paint(_prompt, model:, size:, with: nil, mask: nil, params: {}) # rubocop:disable Metrics/ParameterLists, Lint/UnusedMethodArgument
+      Legion::Extensions::Llm::Image.new(data: Base64.strict_encode64('fake-image'), mime_type: 'image/png',
+                                         model_id: model)
+    end
+
+    def transcribe(_audio_file, model:, language:, **)
+      Legion::Extensions::Llm::Transcription.new(text: 'fake transcript', model: model, language: language)
+    end
+  end
+
+  class BackupFakeLLMProvider < FakeLLMProvider
+    class << self
+      def configuration_options
+        %i[backup_fake_llm_api_key backup_fake_llm_api_base]
+      end
+
+      def slug
+        'backup_fake_llm'
+      end
+    end
+  end
+end
+
+# Namespace module that mimics a real lex-llm-* provider extension.
+# Models.scan_provider_classes discovers providers via this pattern.
+module Legion
+  module Extensions
+    module Llm
+      module FakeLlmProvider
+        PROVIDER_FAMILY = :fake_llm
+
+        def self.provider_class
+          SpecSupport::FakeLLMProvider
+        end
+      end
+
+      module BackupFakeLlmProvider
+        PROVIDER_FAMILY = :backup_fake_llm
+
+        def self.provider_class
+          SpecSupport::BackupFakeLLMProvider
+        end
+      end
+    end
+  end
+end
+
+# Register provider-specific configuration options at load time,
+# the same way real lex-llm-* extensions declare their options.
+[SpecSupport::FakeLLMProvider, SpecSupport::BackupFakeLLMProvider].each do |klass|
+  Array(klass.configuration_options).each do |key|
+    Legion::Extensions::Llm::Configuration.send(:option, key, nil)
+  end
+end
+
+RSpec.shared_context 'with fake llm provider' do
+  # Provider modules are defined at load time above; no runtime registration needed.
+end

data/spec/support/llm_configuration.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+Legion::Extensions::Llm.configure do |config|
+  config.max_retries = 0
+  config.retry_backoff_factor = 0
+  config.retry_interval = 0
+  config.retry_interval_randomness = 0
+end
+
+RSpec.shared_context 'with configured Legion::Extensions::Llm' do
+  before do
+    Legion::Extensions::Llm.configure do |config|
+      # Disable retries in tests for deterministic, fast failures.
+      config.max_retries = 0
+      config.request_timeout = 600
+      config.retry_backoff_factor = 0
+      config.retry_interval = 0
+      config.retry_interval_randomness = 0
+    end
+  end
+end

data/spec/support/rspec_configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  status_suffix = ENV['TEST_ENV_NUMBER'].to_s
+  config.example_status_persistence_file_path = ".rspec_status#{status_suffix}"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+
+  config.before do
+    # Provider lookup is now namespace-based via Models.scan_provider_classes;
+    # no mutable hash to clear between examples.
+  end
+end

data/spec/support/simplecov_configuration.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+unless ENV['SKIP_COVERAGE']
+  SimpleCov.start do
+    track_files 'lib/**/*.rb'
+
+    add_filter '/spec/'
+    add_filter '/vendor/'
+    add_filter 'acts_as_legacy.rb'
+
+    enable_coverage :branch
+
+    formatter SimpleCov::Formatter::MultiFormatter.new(
+      [
+        SimpleCov::Formatter::SimpleFormatter,
+        SimpleCov::Formatter::CoberturaFormatter
+      ].compact
+    )
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm
 version: !ruby/object:Gem::Version
-  version: 0.4.16
+  version: 0.5.0
 platform: ruby
 authors:
 - LegionIO
@@ -108,6 +108,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1'
+- !ruby/object:Gem::Dependency
+  name: faraday-typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: legion-cache
   requirement: !ruby/object:Gem::Requirement
@@ -220,20 +234,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
 description: Provider-neutral LLM primitives, schemas, routing metadata, and shared
   codecs for LegionIO LLM provider extensions.
 email:
@@ -248,6 +248,7 @@ files:
 - ".gitignore"
 - ".rubocop.yml"
 - ".rubocop.yml.new"
+- B1b-conformance-kit.md
 - CHANGELOG.md
 - Gemfile
 - LICENSE
@@ -259,6 +260,17 @@ files:
 - lib/legion/extensions/llm/aliases.rb
 - lib/legion/extensions/llm/attachment.rb
 - lib/legion/extensions/llm/auto_registration.rb
+- lib/legion/extensions/llm/canonical.rb
+- lib/legion/extensions/llm/canonical/chunk.rb
+- lib/legion/extensions/llm/canonical/content_block.rb
+- lib/legion/extensions/llm/canonical/message.rb
+- lib/legion/extensions/llm/canonical/params.rb
+- lib/legion/extensions/llm/canonical/request.rb
+- lib/legion/extensions/llm/canonical/response.rb
+- lib/legion/extensions/llm/canonical/thinking.rb
+- lib/legion/extensions/llm/canonical/tool_call.rb
+- lib/legion/extensions/llm/canonical/tool_definition.rb
+- lib/legion/extensions/llm/canonical/usage.rb
 - lib/legion/extensions/llm/chat.rb
 - lib/legion/extensions/llm/chunk.rb
 - lib/legion/extensions/llm/configuration.rb
@@ -322,6 +334,89 @@ files:
 - lib/legion/extensions/llm/transport/messages/registry_event.rb
 - lib/legion/extensions/llm/utils.rb
 - lib/legion/extensions/llm/version.rb
+- spec/fixtures/ruby.mp3
+- spec/fixtures/ruby.mp4
+- spec/fixtures/ruby.png
+- spec/fixtures/ruby.txt
+- spec/fixtures/ruby.wav
+- spec/fixtures/ruby.xml
+- spec/fixtures/sample.pdf
+- spec/legion/extensions/llm/agent_spec.rb
+- spec/legion/extensions/llm/attachment_spec.rb
+- spec/legion/extensions/llm/auto_registration_spec.rb
+- spec/legion/extensions/llm/canonical/chunk_spec.rb
+- spec/legion/extensions/llm/canonical/content_block_spec.rb
+- spec/legion/extensions/llm/canonical/message_spec.rb
+- spec/legion/extensions/llm/canonical/params_spec.rb
+- spec/legion/extensions/llm/canonical/request_spec.rb
+- spec/legion/extensions/llm/canonical/response_spec.rb
+- spec/legion/extensions/llm/canonical/thinking_spec.rb
+- spec/legion/extensions/llm/canonical/tool_call_spec.rb
+- spec/legion/extensions/llm/canonical/tool_definition_spec.rb
+- spec/legion/extensions/llm/canonical/usage_spec.rb
+- spec/legion/extensions/llm/configuration_spec.rb
+- spec/legion/extensions/llm/conformance/client_translator_examples.rb
+- spec/legion/extensions/llm/conformance/conformance.rb
+- spec/legion/extensions/llm/conformance/echo_translator.rb
+- spec/legion/extensions/llm/conformance/echo_translator_spec.rb
+- spec/legion/extensions/llm/conformance/fixtures/canonical_empty_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_error_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_fleet_round_trip.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_metering_audit_events.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_params_mapping_request.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_simple_text_request.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_simple_text_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_stop_reason_matrix.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_streaming_accumulated_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_streaming_error_chunks.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_streaming_text_chunks.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_streaming_thinking_chunks.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_streaming_tool_call_chunks.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_system_prompt_request.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_thinking_request.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_thinking_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_tool_results_continuation_request.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_tool_use_response.json
+- spec/legion/extensions/llm/conformance/fixtures/canonical_tools_request.json
+- spec/legion/extensions/llm/conformance/provider_translator_examples.rb
+- spec/legion/extensions/llm/connection_logging_spec.rb
+- spec/legion/extensions/llm/connection_retry_spec.rb
+- spec/legion/extensions/llm/context_spec.rb
+- spec/legion/extensions/llm/credential_sources_spec.rb
+- spec/legion/extensions/llm/error_middleware_spec.rb
+- spec/legion/extensions/llm/error_spec.rb
+- spec/legion/extensions/llm/fleet/provider_responder_spec.rb
+- spec/legion/extensions/llm/fleet/token_validator_spec.rb
+- spec/legion/extensions/llm/fleet/worker_execution_spec.rb
+- spec/legion/extensions/llm/fleet_messages_spec.rb
+- spec/legion/extensions/llm/gemspec_spec.rb
+- spec/legion/extensions/llm/message_spec.rb
+- spec/legion/extensions/llm/model/info_spec.rb
+- spec/legion/extensions/llm/models_spec.rb
+- spec/legion/extensions/llm/provider/open_ai_compatible_spec.rb
+- spec/legion/extensions/llm/provider_contract_spec.rb
+- spec/legion/extensions/llm/provider_settings_spec.rb
+- spec/legion/extensions/llm/provider_spec.rb
+- spec/legion/extensions/llm/registry_event_builder_spec.rb
+- spec/legion/extensions/llm/registry_publisher_spec.rb
+- spec/legion/extensions/llm/responses/response_objects_spec.rb
+- spec/legion/extensions/llm/responses/thinking_extractor_spec.rb
+- spec/legion/extensions/llm/routing/model_offering_spec.rb
+- spec/legion/extensions/llm/routing/offering_registry_spec.rb
+- spec/legion/extensions/llm/routing/registry_event_spec.rb
+- spec/legion/extensions/llm/stream_accumulator_spec.rb
+- spec/legion/extensions/llm/streaming_spec.rb
+- spec/legion/extensions/llm/tool_spec.rb
+- spec/legion/extensions/llm/transport/fleet_lane_spec.rb
+- spec/legion/extensions/llm/utils_spec.rb
+- spec/legion/extensions/llm_base_contract_spec.rb
+- spec/legion/extensions/llm_extension_spec.rb
+- spec/legion/extensions/llm_root_spec.rb
+- spec/spec_helper.rb
+- spec/support/fake_llm_provider.rb
+- spec/support/llm_configuration.rb
+- spec/support/rspec_configuration.rb
+- spec/support/simplecov_configuration.rb
 homepage: https://github.com/LegionIO/lex-llm
 licenses:
 - MIT