llm_conductor 1.1.2 → 1.3.0

data/lib/llm_conductor/clients/zai_client.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative 'concerns/vision_support'
+
+module LlmConductor
+  module Clients
+    # Z.ai client implementation for accessing GLM models including GLM-4.5V
+    # Supports both text-only and multimodal (vision) requests
+    #
+    # Note: Z.ai uses OpenAI-compatible API format but with /v4/ path instead of /v1/
+    # We use Faraday directly instead of the ruby-openai gem to properly handle the API path
+    class ZaiClient < BaseClient
+      include Concerns::VisionSupport
+
+      private
+
+      def generate_content(prompt)
+        content = format_content(prompt)
+
+        # Retry logic for transient errors (similar to OpenRouter)
+        max_retries = 3
+        retry_count = 0
+
+        begin
+          # Make direct HTTP request to Z.ai API since they use /v4/ instead of /v1/
+          response = http_client.post('chat/completions') do |req|
+            req.body = {
+              model:,
+              messages: [{ role: 'user', content: }]
+            }.to_json
+          end
+
+          # Response body is already parsed as Hash by Faraday's JSON middleware
+          response_data = response.body.is_a?(String) ? JSON.parse(response.body) : response.body
+          response_data.dig('choices', 0, 'message', 'content')
+        rescue Faraday::ServerError => e
+          retry_count += 1
+
+          # Log retry attempts if logger is configured
+          configuration.logger&.warn(
+            "Z.ai API error (attempt #{retry_count}/#{max_retries}): #{e.message}"
+          )
+
+          raise unless retry_count < max_retries
+
+          wait_time = 2**retry_count # Exponential backoff: 2, 4, 8 seconds
+          configuration.logger&.info("Retrying in #{wait_time}s...")
+          sleep(wait_time)
+          retry
+        end
+      end
+
+      # HTTP client for making requests to Z.ai API
+      # Z.ai uses /v4/ in their path, not /v1/ like OpenAI, so we use Faraday directly
+      def http_client
+        @http_client ||= begin
+          config = LlmConductor.configuration.provider_config(:zai)
+          base_url = config[:uri_base] || 'https://api.z.ai/api/paas/v4'
+
+          Faraday.new(url: base_url) do |f|
+            f.request :json
+            f.response :json
+            f.headers['Authorization'] = "Bearer #{config[:api_key]}"
+            f.headers['Content-Type'] = 'application/json'
+            f.adapter Faraday.default_adapter
+          end
+        end
+      end
+
+      # Legacy client method for compatibility (not used, but kept for reference)
+      def client
+        http_client
+      end
+    end
+  end
+end

data/lib/llm_conductor/configuration.rb

@@ -72,6 +72,14 @@ module LlmConductor
       }
     end
 
+    # Configure Z.ai provider
+    def zai(api_key: nil, **options)
+      @providers[:zai] = {
+        api_key: api_key || ENV['ZAI_API_KEY'],
+        **options
+      }
+    end
+
     # Get provider configuration
     def provider_config(provider)
       @providers[provider.to_sym] || {}
@@ -126,6 +134,14 @@ module LlmConductor
       groq(api_key: value)
     end
 
+    def zai_api_key
+      provider_config(:zai)[:api_key]
+    end
+
+    def zai_api_key=(value)
+      zai(api_key: value)
+    end
+
     private
 
     def setup_defaults_from_env
@@ -135,6 +151,7 @@ module LlmConductor
       openrouter if ENV['OPENROUTER_API_KEY']
       gemini if ENV['GEMINI_API_KEY']
       groq if ENV['GROQ_API_KEY']
+      zai if ENV['ZAI_API_KEY']
       ollama # Always configure Ollama with default URL
     end
   end

data/lib/llm_conductor/prompt_manager.rb

@@ -59,9 +59,7 @@ module LlmConductor
       def validate_prompt_class!(prompt_class)
         raise InvalidPromptClassError, 'Prompt must be a class' unless prompt_class.is_a?(Class)
 
-        unless prompt_class < Prompts::BasePrompt
-          raise InvalidPromptClassError, 'Prompt class must inherit from BasePrompt'
-        end
+        raise InvalidPromptClassError, 'Prompt class must inherit from BasePrompt' unless prompt_class < Prompts::BasePrompt
 
         return if prompt_class.instance_methods(false).include?(:render)
 

data/lib/llm_conductor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmConductor
-  VERSION = '1.1.2'
+  VERSION = '1.3.0'
 end

data/lib/llm_conductor.rb

@@ -14,10 +14,11 @@ require_relative 'llm_conductor/clients/groq_client'
 require_relative 'llm_conductor/clients/ollama_client'
 require_relative 'llm_conductor/clients/openrouter_client'
 require_relative 'llm_conductor/clients/gemini_client'
+require_relative 'llm_conductor/clients/zai_client'
 require_relative 'llm_conductor/client_factory'
 
 # LLM Conductor provides a unified interface for multiple Language Model providers
-# including OpenAI GPT, Anthropic Claude, Google Gemini, Groq, OpenRouter, and Ollama
+# including OpenAI GPT, Anthropic Claude, Google Gemini, Groq, OpenRouter, Z.ai, and Ollama
 # with built-in prompt templates, token counting, and extensible client architecture.
 module LlmConductor
   class Error < StandardError; end
@@ -63,16 +64,17 @@ module LlmConductor
       when :ollama then Clients::OllamaClient
       when :gemini, :google then Clients::GeminiClient
       when :groq then Clients::GroqClient
+      when :zai then Clients::ZaiClient
       else
         raise ArgumentError,
               "Unsupported vendor: #{vendor}. " \
-              'Supported vendors: anthropic, openai, openrouter, ollama, gemini, groq'
+              'Supported vendors: anthropic, openai, openrouter, ollama, gemini, groq, zai'
       end
     end
   end
 
   # List of supported vendors
-  SUPPORTED_VENDORS = %i[anthropic openai openrouter ollama gemini groq].freeze
+  SUPPORTED_VENDORS = %i[anthropic openai openrouter ollama gemini groq zai].freeze
 
   # List of supported prompt types
   SUPPORTED_PROMPT_TYPES = %i[

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llm_conductor
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Ben Zheng
 bindir: exe
 cert_chain: []
-date: 2025-10-29 00:00:00.000000000 Z
+date: 2025-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -154,22 +154,27 @@ files:
 - Rakefile
 - VISION_USAGE.md
 - config/initializers/llm_conductor.rb
+- examples/claude_vision_usage.rb
 - examples/data_builder_usage.rb
 - examples/gemini_usage.rb
+- examples/gpt_vision_usage.rb
 - examples/groq_usage.rb
 - examples/openrouter_vision_usage.rb
 - examples/prompt_registration.rb
 - examples/rag_usage.rb
 - examples/simple_usage.rb
+- examples/zai_usage.rb
 - lib/llm_conductor.rb
 - lib/llm_conductor/client_factory.rb
 - lib/llm_conductor/clients/anthropic_client.rb
 - lib/llm_conductor/clients/base_client.rb
+- lib/llm_conductor/clients/concerns/vision_support.rb
 - lib/llm_conductor/clients/gemini_client.rb
 - lib/llm_conductor/clients/gpt_client.rb
 - lib/llm_conductor/clients/groq_client.rb
 - lib/llm_conductor/clients/ollama_client.rb
 - lib/llm_conductor/clients/openrouter_client.rb
+- lib/llm_conductor/clients/zai_client.rb
 - lib/llm_conductor/configuration.rb
 - lib/llm_conductor/data_builder.rb
 - lib/llm_conductor/prompt_manager.rb