llm_providers 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2f9351f5b2fcd03887b26b61aad5a7efdd810207d9ae96577455b5450730c96
-  data.tar.gz: 17aa0c0c838045102727f5650ba5be88d232ac6e54b7bf283eb5d8bcc7b1b2d4
+  metadata.gz: 11691e71acf36321f3ea66a3fec9ff250eceb606080c4b0d153af8d6ce405329
+  data.tar.gz: 64409688e08600e19b7a9cd310b8243783dfba3ae50de28483b2a0c22b0383e4
 SHA512:
-  metadata.gz: 6ec192e3c3bd4d66d29e7dd619f7821cd2a79d41bd0df3ee61376dee03bf5fa0fd78b1fb1fb9f0ee2a4481c0f419139decade2f70767bc7493d6c59f619bc158
-  data.tar.gz: 5482d3ed05b2dedc3285cfc6b337e08ed1334826eefa4549e79a64a1effabe4c97078fd550b0946db24b4b5b9f5f14885636a683352cd6f9559e9982808758e1
+  metadata.gz: f481b19793475b67cb25ba44f05e63ecd0b16ac9527e8d2274b3e2a9b8bb21f84639e5980cb1049e10ab4146c9476c0dd53051802c12a52f50655635b96e2ecb
+  data.tar.gz: 688e43303a8b97593698091710f4f1e945278974a941e9d5f60a6e4da5262118786d6a10522a4a2f7791242958ad7b57df1a80dccdd88ed6642b0c8315040575

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.2.0] - 2026-02-27
+
+### Added
+
+- OpenRouter provider is now fully supported (no longer experimental)
+  - Custom headers: `X-Title`, `HTTP-Referer` via `app_name:` / `app_url:` options or ENV
+  - Provider routing: `provider:` option for order, fallback, data collection preferences
+  - `Openrouter.models` class method for model discovery
+  - Improved error handling with upstream provider name from OpenRouter metadata
+
+### Changed
+
+- Extracted `request_headers` method in OpenAI provider for extensibility
+- Extracted `format_stream_error` / `parse_sync_error` methods in OpenAI provider for extensibility
+
 ## [0.1.1] - 2026-02-27
 
 ### Fixed

data/lib/llm_providers/providers/openai.rb

@@ -111,6 +111,13 @@ module LlmProviders
         end
       end
 
+      def request_headers
+        {
+          "Content-Type" => "application/json",
+          "Authorization" => "Bearer #{api_key}"
+        }
+      end
+
       def stream_response(payload, &block)
         payload[:stream] = true
         payload[:stream_options] = { include_usage: true }
@@ -133,7 +140,7 @@ module LlmProviders
             event = JSON.parse(data)
 
             if event["error"]
-              stream_error = event.dig("error", "message") || event["error"].to_s
+              stream_error = format_stream_error(event)
               next
             end
 
@@ -176,8 +183,7 @@ module LlmProviders
         end
 
         response = conn.post(self.class::API_URL) do |req|
-          req.headers["Content-Type"] = "application/json"
-          req.headers["Authorization"] = "Bearer #{api_key}"
+          request_headers.each { |k, v| req.headers[k] = v }
           req.body = payload.to_json
           req.options.on_data = proc do |chunk, _|
             raw_chunks += chunk
@@ -192,7 +198,7 @@ module LlmProviders
         # Process any remaining data in the buffer
         process_sse_line.call(line_buffer) unless line_buffer.empty?
 
-        raise ProviderError.new(stream_error, code: "openai_error") if stream_error
+        raise ProviderError.new(stream_error, code: error_code) if stream_error
 
         unless response.success?
           error_body = begin
@@ -203,7 +209,7 @@ module LlmProviders
           error_msg = error_body.dig("error", "message") || (raw_chunks.empty? ? nil : raw_chunks) || response.body.to_s
           raise ProviderError.new(
             error_msg[0, 500],
-            code: "openai_error"
+            code: error_code
           )
         end
 
@@ -224,14 +230,14 @@ module LlmProviders
         started_at = Time.now
 
         response = http_client.post(self.class::API_URL) do |req|
-          req.headers["Authorization"] = "Bearer #{api_key}"
+          request_headers.each { |k, v| req.headers[k] = v }
           req.body = payload
         end
 
         unless response.success?
           raise ProviderError.new(
-            response.body.dig("error", "message") || "API error",
-            code: "openai_error"
+            parse_sync_error(response),
+            code: error_code
           )
         end
 
@@ -260,6 +266,18 @@ module LlmProviders
         }
       end
 
+      def error_code
+        "openai_error"
+      end
+
+      def format_stream_error(event)
+        event.dig("error", "message") || event["error"].to_s
+      end
+
+      def parse_sync_error(response)
+        response.body.dig("error", "message") || "API error"
+      end
+
       def parse_tool_input(arguments)
         return {} if arguments.nil? || arguments.empty?
 

data/lib/llm_providers/providers/openrouter.rb

@@ -2,11 +2,45 @@
 
 module LlmProviders
   module Providers
-    # Experimental: OpenRouter support is provided as-is.
-    # It wraps the OpenAI-compatible API at openrouter.ai.
-    # Not all features may work as expected with every model.
     class Openrouter < Openai
       API_URL = "https://openrouter.ai/api/v1/chat/completions"
+      MODELS_URL = "https://openrouter.ai/api/v1/models"
+
+      def self.models
+        api_key = ENV.fetch("OPENROUTER_API_KEY")
+        conn = Faraday.new do |f|
+          f.response :json
+          f.adapter Faraday.default_adapter
+        end
+
+        response = conn.get(MODELS_URL) do |req|
+          req.headers["Authorization"] = "Bearer #{api_key}"
+        end
+
+        unless response.success?
+          error_msg = response.body.dig("error", "message") || "Failed to fetch models"
+          raise ProviderError.new(error_msg, code: "openrouter_error")
+        end
+
+        (response.body["data"] || []).map do |model|
+          {
+            id: model["id"],
+            name: model["name"],
+            context_length: model["context_length"],
+            pricing: {
+              prompt: model.dig("pricing", "prompt"),
+              completion: model.dig("pricing", "completion")
+            }
+          }
+        end
+      end
+
+      def initialize(app_name: nil, app_url: nil, provider: nil, **options)
+        super(**options)
+        @app_name = app_name || ENV["OPENROUTER_APP_NAME"]
+        @app_url = app_url || ENV["OPENROUTER_APP_URL"]
+        @provider_preferences = provider
+      end
 
       protected
 
@@ -17,6 +51,43 @@ module LlmProviders
       def api_key
         ENV.fetch("OPENROUTER_API_KEY")
       end
+
+      private
+
+      def build_payload(messages, system, tools)
+        payload = super
+        payload[:provider] = @provider_preferences if @provider_preferences
+        payload
+      end
+
+      def request_headers
+        headers = super
+        headers["X-Title"] = @app_name if @app_name
+        headers["HTTP-Referer"] = @app_url if @app_url
+        headers
+      end
+
+      def error_code
+        "openrouter_error"
+      end
+
+      def format_stream_error(event)
+        message = event.dig("error", "message") || event["error"].to_s
+        provider_name = event.dig("error", "metadata", "provider_name")
+        provider_name ? "[#{provider_name}] #{message}" : message
+      end
+
+      def parse_sync_error(response)
+        body = response.body
+        body = begin
+          JSON.parse(body)
+        rescue StandardError
+          {}
+        end if body.is_a?(String)
+        message = body.dig("error", "message") || "API error"
+        provider_name = body.dig("error", "metadata", "provider_name")
+        provider_name ? "[#{provider_name}] #{message}" : message
+      end
     end
   end
 end

data/lib/llm_providers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmProviders
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_providers
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - kaba