lex-xai 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f122be7885c3d5f79b22015679579e69bbf8ccbb841a4e5f903688e2ae2d1221
-  data.tar.gz: 7738c16fc492d2f975702b535d9b1d54ca370bbe8013a0d03946b7203070386b
+  metadata.gz: 68b63fbc6b6bf1522fa9d02196661d696f988f51c27955f1f4d9fe75af2f05e4
+  data.tar.gz: 610e5fddafd6cdc9a38adc9fc43750cce8bd5bc216fed3d7594da83613538ff6
 SHA512:
-  metadata.gz: 6b39da9f13c8445ca28b69402162d9323fc280eb84770c96040a0979f4890eae53c7acc1017ed7f07c4db8e140a57b38c51abb065cee872b82423e5c59b77aec
-  data.tar.gz: 9aea0da6fc20892bad4346e9c72d27c25244987b10d650b79f273fc0db53b313f965b4f605b4e00960c11d34f893a77e0fc85b1cef28c4651c082d6c8d2b8fea
+  metadata.gz: c319c74d16f878256c34689399f97975575feedce876cbb511ad982fd6b585c522fe955613f967ef725a0aa82aae76301f83aee3081115abd205aac81640c361
+  data.tar.gz: '061680b95c34d13bbfb460aabfc66bd652a73f01ce5a81ded3c29865b804cd1d4aef9ecbf369ff12dbcc560bf5052061278414e4068f996f9017b59d06ad60e1'

data/CHANGELOG.md

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

data/CLAUDE.md

@@ -10,8 +10,8 @@ Legion Extension that connects LegionIO to the xAI Grok API. Provides runners fo
 
 **GitHub**: https://github.com/LegionIO/lex-xai
 **License**: MIT
-**Version**: 0.1.2
-**Specs**: 23 examples
+**Version**: 0.1.5
+**Specs**: 43 examples (4 spec files)
 
 ## Architecture
 
@@ -26,7 +26,7 @@ Legion::Extensions::Xai
 └── Client             # Standalone client class (includes all runners, holds @config)
 ```
 
-`Helpers::Client` is a **module** with a `client(api_key:, base_url: DEFAULT_BASE_URL, ...)` factory method. `DEFAULT_BASE_URL` is `'https://api.x.ai'`. Authentication uses `Authorization: Bearer #{api_key}` header. Runner modules `extend` it to gain `client(...)` as a module-level method.
+`Helpers::Client` is a **module** with a `client(api_key:, base_url: DEFAULT_BASE_URL, ...)` factory method. `DEFAULT_BASE_URL = 'https://api.x.ai'`. Authentication uses `Authorization: Bearer #{api_key}` header. Runner modules `extend` it to gain `client(...)` as a module-level method.
 
 `Client` (class) provides a standalone instantiable wrapper that holds `@config` and delegates through `Helpers::Client`.
 
@@ -37,6 +37,7 @@ Legion::Extensions::Xai
 - `Chat#create` supports `stream: false` kwarg (passed through to API body) but does not handle streaming responses internally.
 - API paths use `/v1/` prefix: `/v1/chat/completions`, `/v1/models`, `/v1/models/:model`, `/v1/embeddings`.
 - `Models#retrieve` uses the method name `retrieve` (not `get`) for consistency with lex-claude and lex-openai.
+- `Chat` and `Embeddings` return `{ result: response.body }`. `Models` returns `{ models: ... }` / `{ model: ... }`.
 - `include Legion::Extensions::Helpers::Lex` is guarded with `const_defined?` pattern.
 
 ## Dependencies
@@ -45,15 +46,17 @@ Legion::Extensions::Xai
 |-----|---------|
 | `faraday` >= 2.0 | HTTP client for xAI 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        # 23 examples
+bundle exec rspec        # 43 examples
 bundle exec rubocop
 ```
 
 ---
 
 **Maintained By**: Matthew Iverson (@Esity)
+**Last Updated**: 2026-04-06

data/README.md

@@ -23,34 +23,68 @@ require 'legion/extensions/xai/client'
 
 client = Legion::Extensions::Xai::Client.new(api_key: 'your-xai-api-key')
 
-# Chat completions
-result = client.create(messages: [{ role: 'user', content: 'Hello!' }])
+# Chat completions (default model: grok-3)
+result = client.create(
+  messages: [{ role: 'user', content: 'Hello!' }]
+)
+# => { result: { 'choices' => [...], ... } }
+
+# With explicit model
+result = client.create(
+  model: 'grok-3',
+  messages: [{ role: 'user', content: 'What is 2+2?' }]
+)
 
 # List models
 result = client.list
+# => { models: [...] }
 
-# Retrieve a model
+# Retrieve a specific model
 result = client.retrieve(model: 'grok-3')
+# => { model: { ... } }
 
-# Create embeddings
-result = client.create(input: 'Hello world')
+# Create embeddings (default model: embedding-beta)
+result = client.create(
+  input: 'Hello world'
+)
+# => { result: { 'data' => [...], ... } }
 ```
 
 ### Runner Modules
 
 ```ruby
-include Legion::Extensions::Xai::Runners::Chat
-
-result = create(api_key: 'your-key', messages: [{ role: 'user', content: 'Hello!' }])
+result = Legion::Extensions::Xai::Runners::Chat.create(
+  api_key: 'your-key',
+  messages: [{ role: 'user', content: 'Hello!' }]
+)
+
+result = Legion::Extensions::Xai::Runners::Embeddings.create(
+  api_key: 'your-key',
+  input: 'text to embed'
+)
+
+result = Legion::Extensions::Xai::Runners::Models.list(api_key: 'your-key')
+result = Legion::Extensions::Xai::Runners::Models.retrieve(api_key: 'your-key', model: 'grok-3')
 ```
 
 ## API Coverage
 
-| Runner | Methods |
-|--------|---------|
-| `Chat` | `create` |
-| `Models` | `list`, `retrieve` |
-| `Embeddings` | `create` |
+| Runner | Methods | Default Model |
+|--------|---------|---------------|
+| `Chat` | `create` | `grok-3` |
+| `Embeddings` | `create` | `embedding-beta` |
+| `Models` | `list`, `retrieve` | — |
+
+## 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)
+- xAI API key
 
 ## Related
 
@@ -58,6 +92,10 @@ result = create(api_key: 'your-key', messages: [{ role: 'user', content: 'Hello!
 - `legion-llm` — High-level LLM interface across providers
 - `extensions-ai/CLAUDE.md` — Architecture patterns shared across all AI extensions
 
+## Version
+
+0.1.4
+
 ## License
 
 MIT

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Xai
+      module Identity
+        module_function
+
+        def provider_name  = :xai
+        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:   :xai,
+            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, :xai, :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/xai/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Xai
-      VERSION = '0.1.4'
+      VERSION = '0.1.5'
     end
   end
 end

data/lib/legion/extensions/xai.rb

@@ -5,6 +5,7 @@ require 'legion/extensions/xai/helpers/client'
 require 'legion/extensions/xai/runners/chat'
 require 'legion/extensions/xai/runners/models'
 require 'legion/extensions/xai/runners/embeddings'
+require 'legion/extensions/xai/identity'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-xai
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Esity
@@ -157,6 +157,7 @@ files:
 - lib/legion/extensions/xai.rb
 - lib/legion/extensions/xai/client.rb
 - lib/legion/extensions/xai/helpers/client.rb
+- lib/legion/extensions/xai/identity.rb
 - lib/legion/extensions/xai/runners/chat.rb
 - lib/legion/extensions/xai/runners/embeddings.rb
 - lib/legion/extensions/xai/runners/models.rb