lex-claude 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8689f00ee81cef79b268cbe7ee94cbc4e243488e34a68397af609543e6a34305
-  data.tar.gz: eb1c05e7db5f8e322d286b00263fd8aa402d0989860cb5c86443bbe0357671ec
+  metadata.gz: 99a567735a4299c9772d4f8da83db0e0a79f546c8e6dda1f5ff97c5d94cba849
+  data.tar.gz: 9b0dab8a910c81ca19a4a9124958e8cb915a5bae601e28106242097491c3d99f
 SHA512:
-  metadata.gz: 9f9a6640fc83eb4640df99eeb03d1581c1d6fab7addb59a23fe154804b760e4c41bdd51d994d433ed0c47ae0a9b7c53b0eee8e8bc90060cbef6aeabde641b1fa
-  data.tar.gz: 2f3ddb1f8d0d028e557f1b8037c0ba1754bfca699d276fab627c0a7de28e9d85ec5bd830eb484e64a8be72671b968dc8d9a8aecdfc52df50efa526a414209313
+  metadata.gz: ac91d469375b3923985a2c2ee31fe1a0ae298d7daf69a2b34a617c85ede7e18c4143c66622d96bdf28832054e62a1e5272c7c654fb572b37ca5f277f882fe668
+  data.tar.gz: 1421869fbb95bc2b354c7c9bec559bba48bbbae85c69bba3dff54073fd1e2041eca01da3800a9869ec7b1d2079ee1efff6f1332ebc2af81862ba082b7b0533b6

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.3.3] - 2026-04-06
+
+### Added
+- Credential-only identity module for Phase 8 Broker integration (`Identity` module with `provide_token`)
+
 ## [0.3.2] - 2026-03-31
 
 ### Added

data/CLAUDE.md

@@ -6,35 +6,48 @@
 
 ## Purpose
 
-Legion Extension that connects LegionIO to the Claude Anthropic API. Provides runners for message creation, token counting, model listing, and asynchronous batch processing.
+Legion Extension that connects LegionIO to the Claude Anthropic API. Provides runners for message creation (streaming and non-streaming), token counting, model listing, and asynchronous batch processing. Full support for prompt caching, extended thinking, structured output, web search, effort control, fast mode, and context management betas.
 
 **GitHub**: https://github.com/LegionIO/lex-claude
 **License**: MIT
-**Version**: 0.1.2
-**Specs**: 18 examples
+**Version**: 0.3.3
+**Specs**: 134 examples (12 spec files)
 
 ## Architecture
 
 ```
 Legion::Extensions::Claude
 ├── Runners/
-│   ├── Messages           # create(api_key:, model:, messages:, ...), count_tokens(api_key:, model:, messages:, ...)
-│   ├── Models             # list(api_key:, ...), retrieve(api_key:, model_id:, ...)
+│   ├── Messages           # create, create_stream, count_tokens
+│   ├── Models             # list, retrieve
 │   └── Batches            # create_batch, list_batches, retrieve_batch, cancel_batch, batch_results
 ├── Helpers/
-│   └── Client             # Faraday-based Anthropic API client (module, factory method)
+│   ├── Client             # Faraday-based Anthropic API client (module + streaming_client factory)
+│   ├── Errors             # structured exception hierarchy (ApiError, RateLimitError, AuthenticationError, etc.)
+│   ├── Models             # model symbol alias resolution (Helpers::Models.resolve)
+│   ├── Response           # response handling + usage parsing (handle_response, parse_usage)
+│   ├── Retry              # Helpers::Retry.with_retry (configurable max_attempts)
+│   ├── Sse                # SSE stream parser (parse_stream, collect_text, collect_usage)
+│   └── Tools              # tool descriptor builders (web_search)
 └── Client                 # Standalone client class (includes all runners, holds @config)
 ```
 
-`Helpers::Client` is a **module** with a `client(api_key:, ...)` factory method. It sets `x-api-key` and `anthropic-version` headers. The `API_VERSION` constant is `'2023-06-01'` and `DEFAULT_HOST` is `'https://api.anthropic.com'`. All runner modules `extend` it.
+`Helpers::Client` is a **module** with two factory methods:
+- `client(api_key:, betas: nil, ...)` — standard Faraday connection, sets `x-api-key` and `anthropic-version` headers, encodes betas as `anthropic-beta` header.
+- `streaming_client(api_key:, betas: nil)` — same connection but configured for streaming responses.
 
-`Client` (class) provides a standalone instantiable wrapper. It `include`s all runner modules and holds a persistent `@config` hash. Its private `client(**override_opts)` merges config with any per-call overrides and delegates to `Helpers::Client.client(...)`.
+`API_VERSION = '2023-06-01'`. `DEFAULT_HOST = 'https://api.anthropic.com'`.
+
+`Client` (class) provides a standalone instantiable wrapper. It `include`s all runner modules and holds a persistent `@config` hash. Its private `client(**override_opts)` merges config with per-call overrides and delegates to `Helpers::Client.client(...)`.
 
 ## Key Design Decisions
 
-- `Helpers::Client` uses `module_function`, making `client(...)` callable as both a module-level method and as an instance method when mixed in. Runners use `extend Helpers::Client` to get `client(...)` as a module-level method.
-- `Client` class uses `include` (not `extend`) so runner methods become instance methods on the client object.
-- The Batches runner uses JSON-only payloads — no multipart dependency.
+- `Messages#create` auto-resolves beta headers based on opts: `cache_scope: :global` adds `:prompt_caching_scope`, `thinking:` adds `:interleaved_thinking`, `output_config.format` adds `:structured_outputs`, `output_config.effort` adds `:effort`, `fast_mode: true` adds `:fast_mode`, `context_management:` adds `:context_management`.
+- `Messages#create_stream` uses `Helpers::Sse.parse_stream` for SSE event parsing. Returns `{ result: accumulated_text, events:, usage:, status: 200 }`.
+- `Messages#count_tokens` posts to `/v1/messages/count_tokens`.
+- `Batches` runner uses JSON-only payloads — no multipart dependency.
+- `Helpers::Errors.from_response` builds typed exceptions from HTTP status codes.
+- `Helpers::Retry.with_retry` retries on rate limit and server errors with exponential backoff.
 - `include Legion::Extensions::Helpers::Lex` is guarded: only included when `lex-lex` is loaded.
 
 ## Dependencies
@@ -43,15 +56,17 @@ Legion::Extensions::Claude
 |-----|---------|
 | `faraday` >= 2.0 | HTTP client for Anthropic API |
 | `multi_json` | JSON parser abstraction |
+| `legion-cache`, `legion-crypt`, `legion-data`, `legion-json`, `legion-logging`, `legion-settings`, `legion-transport` | LegionIO core |
 
 ## Testing
 
 ```bash
 bundle install
-bundle exec rspec        # 18 examples
+bundle exec rspec        # 134 examples
 bundle exec rubocop
 ```
 
 ---
 
 **Maintained By**: Matthew Iverson (@Esity)
+**Last Updated**: 2026-04-06

data/README.md

@@ -191,6 +191,10 @@ result = Legion::Extensions::Claude::Helpers::Retry.with_retry(max_attempts: 3)
 end
 ```
 
+## Version
+
+0.3.3
+
 ## Dependencies
 
 - `faraday` >= 2.0 — HTTP client
@@ -208,6 +212,10 @@ end
 - `legion-llm` — High-level LLM interface
 - `extensions-ai/CLAUDE.md` — Architecture patterns shared across all AI extensions
 
+## Version
+
+0.3.3
+
 ## License
 
 MIT

data/lib/legion/extensions/claude/identity.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Claude
+      module Identity
+        module_function
+
+        def provider_name  = :anthropic
+        def provider_type  = :credential
+        def facing         = nil
+        def capabilities   = %i[credentials]
+
+        def resolve(canonical_name: nil) # rubocop:disable Lint/UnusedMethodArgument
+          nil
+        end
+
+        def provide_token
+          api_key = resolve_api_key
+          return nil unless api_key
+
+          Legion::Identity::Lease.new(
+            provider:   :anthropic,
+            credential: api_key,
+            expires_at: nil,
+            renewable:  false,
+            issued_at:  Time.now,
+            metadata:   { credential_type: :api_key }
+          )
+        end
+
+        def resolve_api_key
+          return nil unless defined?(Legion::Settings)
+
+          value = Legion::Settings.dig(:llm, :providers, :anthropic, :api_key)
+          value = value.find { |v| v && !v.empty? } if value.is_a?(Array)
+          value unless value.nil? || (value.is_a?(String) && (value.empty? || value.start_with?('env://')))
+        end
+
+        private_class_method :resolve_api_key
+      end
+    end
+  end
+end

data/lib/legion/extensions/claude/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Claude
-      VERSION = '0.3.2'
+      VERSION = '0.3.3'
     end
   end
 end

data/lib/legion/extensions/claude.rb

@@ -11,6 +11,7 @@ require 'legion/extensions/claude/helpers/models'
 require 'legion/extensions/claude/runners/messages'
 require 'legion/extensions/claude/runners/models'
 require 'legion/extensions/claude/runners/batches'
+require 'legion/extensions/claude/identity'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-claude
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - Esity
@@ -164,6 +164,7 @@ files:
 - lib/legion/extensions/claude/helpers/retry.rb
 - lib/legion/extensions/claude/helpers/sse.rb
 - lib/legion/extensions/claude/helpers/tools.rb
+- lib/legion/extensions/claude/identity.rb
 - lib/legion/extensions/claude/runners/batches.rb
 - lib/legion/extensions/claude/runners/messages.rb
 - lib/legion/extensions/claude/runners/models.rb