lex-claude 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9e951db1ed95bb767cf7b1e4b8d5131bc0f99facb11671fd60a4076430931664
+  data.tar.gz: cd22fd58a0a78106e2db87e11cddad4c11c70eac0c09bcd8c529d09fb34c9f4e
+SHA512:
+  metadata.gz: f1f39899fea69d4d1bae1218ee1b1c56faf9d012ebf55c69fddf219c890bd5ce604dedc60e9f89098af5757b0d13941b803875b1bd8248219def76f149a2ea8a
+  data.tar.gz: 21744108eec4bbe05653f5d91b08e3a8cf9ecf9c206ef5056dfc5f7b9c3a4c7604e57165b0207728a90a1e6f6666bf2dcec82215a98a719649620e98876388f1

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,50 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
+Metrics/BlockLength:
+  Max: 40
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/AbcSize:
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 17
+
+Style/Documentation:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Naming/FileName:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.1] - 2026-03-18
+
+### Changed
+- deleted gemfile.lock
+
+## [0.1.0] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,57 @@
+# lex-claude: Claude Anthropic Integration for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-ai/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that connects LegionIO to the Claude Anthropic API. Provides runners for message creation, token counting, model listing, and asynchronous batch processing.
+
+**GitHub**: https://github.com/LegionIO/lex-claude
+**License**: MIT
+**Version**: 0.1.0
+**Specs**: 18 examples
+
+## 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:, ...)
+│   └── Batches            # create_batch, list_batches, retrieve_batch, cancel_batch, batch_results
+├── Helpers/
+│   └── Client             # Faraday-based Anthropic API client (module, factory method)
+└── 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.
+
+`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(...)`.
+
+## Key Design Decisions
+
+- Runners use `extend Helpers::Client` so `client(...)` is available as a module-function without instantiation.
+- `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.
+- `include Legion::Extensions::Helpers::Lex` is guarded: only included when `lex-lex` is loaded.
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `faraday` >= 2.0 | HTTP client for Anthropic API |
+| `multi_json` | JSON parser abstraction |
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec        # 18 examples
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Dockerfile

@@ -0,0 +1,6 @@
+FROM legionio/legion
+
+COPY . /usr/src/app/lex-claude
+
+WORKDIR /usr/src/app/lex-claude
+RUN bundle install

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+gemspec
+
+group :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'rspec_junit_formatter'
+  gem 'rubocop'
+  gem 'simplecov'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Esity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,96 @@
+# lex-claude
+
+Claude Anthropic API integration for [LegionIO](https://github.com/LegionIO/LegionIO). Provides runners for creating messages, listing models, counting tokens, and managing message batches.
+
+## Installation
+
+```bash
+gem install lex-claude
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'lex-claude'
+```
+
+## Functions
+
+### Messages
+- `create` - Create a message (chat completion) with Claude
+- `count_tokens` - Count input tokens for a message request
+
+### Models
+- `list` - List available Claude models
+- `retrieve` - Get details for a specific model
+
+### Batches
+- `create_batch` - Create an asynchronous message batch
+- `list_batches` - List message batches
+- `retrieve_batch` - Get details for a specific batch
+- `cancel_batch` - Cancel an in-progress batch
+- `batch_results` - Retrieve results for a completed batch
+
+## Configuration
+
+Set your API key in your LegionIO settings:
+
+```json
+{
+  "claude": {
+    "api_key": "sk-ant-..."
+  }
+}
+```
+
+## Standalone Usage
+
+```ruby
+require 'legion/extensions/claude/client'
+
+client = Legion::Extensions::Claude::Client.new(api_key: ENV['ANTHROPIC_API_KEY'])
+
+# Create a message
+result = client.create(
+  model: 'claude-opus-4-6',
+  messages: [{ role: 'user', content: 'Hello, Claude!' }],
+  max_tokens: 1024
+)
+puts result[:result]['content'].first['text']
+
+# List models
+models = client.list
+puts models[:result]['data'].map { |m| m['id'] }
+
+# Count tokens
+tokens = client.count_tokens(
+  model: 'claude-opus-4-6',
+  messages: [{ role: 'user', content: 'How many tokens is this?' }]
+)
+puts tokens[:result]['input_tokens']
+
+# Create an async batch
+batch = client.create_batch(
+  requests: [
+    { custom_id: 'req-1', params: { model: 'claude-opus-4-6',
+                                    messages: [{ role: 'user', content: 'Hello' }],
+                                    max_tokens: 100 } }
+  ]
+)
+puts batch[:result]['id']
+```
+
+## Dependencies
+
+- `faraday` >= 2.0 - HTTP client
+- `multi_json` - JSON parser abstraction
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework (optional for standalone client usage)
+- Anthropic API key
+
+## License
+
+MIT

data/lex-claude.gemspec

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/claude/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-claude'
+  spec.version       = Legion::Extensions::Claude::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX Claude'
+  spec.description   = 'Connects LegionIO to the Claude Anthropic API'
+  spec.homepage      = 'https://github.com/LegionIO/lex-claude'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-claude'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-claude'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-claude'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-claude/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 2.0'
+  spec.add_dependency 'multi_json'
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/claude/helpers/client'
+require 'legion/extensions/claude/runners/messages'
+require 'legion/extensions/claude/runners/models'
+require 'legion/extensions/claude/runners/batches'
+
+module Legion
+  module Extensions
+    module Claude
+      class Client
+        include Legion::Extensions::Claude::Runners::Messages
+        include Legion::Extensions::Claude::Runners::Models
+        include Legion::Extensions::Claude::Runners::Batches
+
+        attr_reader :config
+
+        def initialize(api_key:, host: Helpers::Client::DEFAULT_HOST, **opts)
+          @config = { api_key: api_key, host: host, **opts }
+        end
+
+        private
+
+        def client(**override_opts)
+          merged = config.merge(override_opts)
+          Legion::Extensions::Claude::Helpers::Client.client(**merged)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/claude/helpers/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'multi_json'
+
+module Legion
+  module Extensions
+    module Claude
+      module Helpers
+        module Client
+          DEFAULT_HOST = 'https://api.anthropic.com'
+          API_VERSION = '2023-06-01'
+
+          module_function
+
+          def client(api_key:, host: DEFAULT_HOST, **_opts)
+            Faraday.new(url: host) do |conn|
+              conn.request :json
+              conn.response :json, content_type: /\bjson$/
+              conn.headers['x-api-key'] = api_key
+              conn.headers['anthropic-version'] = API_VERSION
+              conn.headers['Content-Type'] = 'application/json'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/claude/runners/batches.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/claude/helpers/client'
+
+module Legion
+  module Extensions
+    module Claude
+      module Runners
+        module Batches
+          extend Legion::Extensions::Claude::Helpers::Client
+
+          def create_batch(api_key:, requests:, **)
+            body = { requests: requests }
+            response = client(api_key: api_key, **).post('/v1/messages/batches', body)
+            { result: response.body, status: response.status }
+          end
+
+          def list_batches(api_key:, limit: 20, before_id: nil, after_id: nil, **)
+            params = { limit: limit }
+            params[:before_id] = before_id if before_id
+            params[:after_id] = after_id if after_id
+
+            response = client(api_key: api_key, **).get('/v1/messages/batches', params)
+            { result: response.body, status: response.status }
+          end
+
+          def retrieve_batch(api_key:, batch_id:, **)
+            response = client(api_key: api_key, **).get("/v1/messages/batches/#{batch_id}")
+            { result: response.body, status: response.status }
+          end
+
+          def cancel_batch(api_key:, batch_id:, **)
+            response = client(api_key: api_key, **).post("/v1/messages/batches/#{batch_id}/cancel")
+            { result: response.body, status: response.status }
+          end
+
+          def batch_results(api_key:, batch_id:, **)
+            response = client(api_key: api_key, **).get("/v1/messages/batches/#{batch_id}/results")
+            { result: response.body, status: response.status }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/claude/runners/messages.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/claude/helpers/client'
+
+module Legion
+  module Extensions
+    module Claude
+      module Runners
+        module Messages
+          extend Legion::Extensions::Claude::Helpers::Client
+
+          def create(api_key:, model:, messages:, max_tokens: 1024, system: nil, temperature: nil, # rubocop:disable Metrics/ParameterLists
+                     top_p: nil, top_k: nil, stop_sequences: nil, metadata: nil, tools: nil,
+                     tool_choice: nil, stream: false, **)
+            body = {
+              model:      model,
+              messages:   messages,
+              max_tokens: max_tokens,
+              stream:     stream
+            }
+            body[:system] = system if system
+            body[:temperature] = temperature if temperature
+            body[:top_p] = top_p if top_p
+            body[:top_k] = top_k if top_k
+            body[:stop_sequences] = stop_sequences if stop_sequences
+            body[:metadata] = metadata if metadata
+            body[:tools] = tools if tools
+            body[:tool_choice] = tool_choice if tool_choice
+
+            response = client(api_key: api_key, **).post('/v1/messages', body)
+            { result: response.body, status: response.status }
+          end
+
+          def count_tokens(api_key:, model:, messages:, system: nil, tools: nil, **) # rubocop:disable Metrics/ParameterLists
+            body = { model: model, messages: messages }
+            body[:system] = system if system
+            body[:tools] = tools if tools
+
+            response = client(api_key: api_key, **).post('/v1/messages/count_tokens', body)
+            { result: response.body, status: response.status }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/claude/runners/models.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/claude/helpers/client'
+
+module Legion
+  module Extensions
+    module Claude
+      module Runners
+        module Models
+          extend Legion::Extensions::Claude::Helpers::Client
+
+          def list(api_key:, limit: 20, before_id: nil, after_id: nil, **)
+            params = { limit: limit }
+            params[:before_id] = before_id if before_id
+            params[:after_id] = after_id if after_id
+
+            response = client(api_key: api_key, **).get('/v1/models', params)
+            { result: response.body, status: response.status }
+          end
+
+          def retrieve(api_key:, model_id:, **)
+            response = client(api_key: api_key, **).get("/v1/models/#{model_id}")
+            { result: response.body, status: response.status }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Claude
+      VERSION = '0.1.1'
+    end
+  end
+end

data/lib/legion/extensions/claude.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/claude/version'
+require 'legion/extensions/claude/helpers/client'
+require 'legion/extensions/claude/runners/messages'
+require 'legion/extensions/claude/runners/models'
+require 'legion/extensions/claude/runners/batches'
+
+module Legion
+  module Extensions
+    module Claude
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+    end
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: lex-claude
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Esity
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Connects LegionIO to the Claude Anthropic API
+email:
+- matthewdiverson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- Dockerfile
+- Gemfile
+- LICENSE
+- README.md
+- lex-claude.gemspec
+- lib/legion/extensions/claude.rb
+- lib/legion/extensions/claude/client.rb
+- lib/legion/extensions/claude/helpers/client.rb
+- lib/legion/extensions/claude/runners/batches.rb
+- lib/legion/extensions/claude/runners/messages.rb
+- lib/legion/extensions/claude/runners/models.rb
+- lib/legion/extensions/claude/version.rb
+homepage: https://github.com/LegionIO/lex-claude
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/LegionIO/lex-claude
+  source_code_uri: https://github.com/LegionIO/lex-claude
+  documentation_uri: https://github.com/LegionIO/lex-claude
+  changelog_uri: https://github.com/LegionIO/lex-claude
+  bug_tracker_uri: https://github.com/LegionIO/lex-claude/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: LEX Claude
+test_files: []