open_router_enhanced 1.2.2 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d14a6a35444f5f2321779b457bcd3e72bbb6f549faed1271f845a094195a7cc7
-  data.tar.gz: 5633d120125f115e56cf00a4da5e6be0d2a16934180fd2c6f9b4088342ea2615
+  metadata.gz: 8974bb5aa236326b1c938307f3ba59724b95dfbad012fa2151624d4e9247d2d4
+  data.tar.gz: ce35a08da2c0d6a6b41ad65ff4a1120be661a4eb7cf0f896f880c4fd90be044b
 SHA512:
-  metadata.gz: 5abeac77e6a1e81c3151df75b3450841912b74e3326f745eea5000be8f784822df73daaec90e92e928a1745df79a4eb335b1be922cd01c587a8b73c0b3cb391b
-  data.tar.gz: b6e344ffd954a89ebe79f7cf42a308f95e6e93569863e0a06ecb4b28d97d16ff6e656284312bb0dd80ad8943c3018f529794e03aa541624aa8f5b040dd1ca4cf
+  metadata.gz: b2add01adf57714a7b16848cac438f6cc3df98ea7dc2c0e6436e3f78dd2cdc8889c3ab05b3646686645c290001d6c13fd08a9c059157f2b05af1df1ae649c5c1
+  data.tar.gz: c54028cfbdfef0aa67658bbea76205ee278cb902850fe315f8a1a38523db80e0efcb7c191512fc4a6f144dd8ca621b5b4600d68b269d6073ec9885c730c3f0d1

data/.rubocop_todo.yml

@@ -1,14 +1,12 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-07 18:18:35 UTC using RuboCop version 1.79.2.
+# on 2025-12-25 09:19:33 UTC using RuboCop version 1.82.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
 # Offense count: 1
-# Configuration parameters: Severity, Include.
-# Include: **/*.gemspec
 Gemspec/RequiredRubyVersion:
   Exclude:
     - 'open_router_enhanced.gemspec'
@@ -20,42 +18,42 @@ Lint/ShadowedException:
 
 # Offense count: 19
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AutoCorrect, IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
+# Configuration parameters: IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
 Lint/UnusedBlockArgument:
   Exclude:
     - 'spec/force_structured_output_spec.rb'
     - 'spec/integration/structured_output_flow_spec.rb'
 
-# Offense count: 24
+# Offense count: 26
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
   Max: 69
 
-# Offense count: 183
+# Offense count: 193
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
   Max: 464
 
-# Offense count: 7
+# Offense count: 6
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 339
+  Max: 260
 
 # Offense count: 16
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 21
 
-# Offense count: 44
+# Offense count: 48
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 42
+  Max: 40
 
 # Offense count: 6
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
-  Max: 10
+  Max: 9
 
 # Offense count: 13
 # Configuration parameters: AllowedMethods, AllowedPatterns.
@@ -87,7 +85,13 @@ Naming/VariableNumber:
   Exclude:
     - 'spec/vcr/prompt_template_spec.rb'
 
-# Offense count: 9
+# Offense count: 2
+Security/Eval:
+  Exclude:
+    - 'examples/responses_api_example.rb'
+    - 'examples/tool_loop_example.rb'
+
+# Offense count: 8
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Exclude:
@@ -100,7 +104,21 @@ Style/Documentation:
     - 'lib/open_router/response.rb'
     - 'lib/open_router/schema.rb'
     - 'lib/open_router/tool.rb'
-    - 'lib/open_router/tool_call.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: format, sprintf, percent
+Style/FormatString:
+  Exclude:
+    - 'examples/dynamic_model_switching_example.rb'
+    - 'examples/real_world_schemas_example.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Style/IdenticalConditionalBranches:
+  Exclude:
+    - 'examples/responses_api_example.rb'
 
 # Offense count: 8
 # This cop supports safe autocorrection (--autocorrect).
@@ -122,9 +140,9 @@ Style/OptionalBooleanParameter:
   Exclude:
     - 'lib/open_router/schema.rb'
 
-# Offense count: 37
+# Offense count: 40
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Max: 210

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [1.2.2] - 2025-12-25
+
+### Fixed
+- Fixed SSL certificate verification error in `ModelRegistry` by switching from `Net::HTTP` to `Faraday` for consistent HTTP handling across the gem
+
+### Added
+- New examples in `examples/` directory:
+  - `real_world_schemas_example.rb` - Practical structured data extraction scenarios
+  - `tool_loop_example.rb` - Complete Chat Completions API tool calling workflow
+  - `responses_api_example.rb` - Responses API with multi-turn tool loops
+  - `dynamic_model_switching_example.rb` - Runtime model selection and capability detection
+
 ## [1.2.1] - 2025-12-24
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    open_router_enhanced (1.2.1)
+    open_router_enhanced (1.2.3)
       activesupport (>= 6.0, < 9.0)
       dotenv (>= 2.0, < 4.0)
       faraday (>= 1.0, < 3.0)

data/docs/tools.md

@@ -999,7 +999,7 @@ end
 api_tool = OpenRouter::Tool.define do
   name "external_api"
   description "Call external REST APIs"
-  
+
   parameters do
     string :endpoint, required: true,
            description: "API endpoint URL"
@@ -1013,4 +1013,237 @@ api_tool = OpenRouter::Tool.define do
             description: "Request timeout in seconds"
   end
 end
+```
+
+### Model Delegation Tool (AI-as-a-Tool)
+
+A powerful pattern where one model can delegate tasks to a different, specialized model and incorporate the results. This enables "multi-agent" workflows where you route specific subtasks to the best model for the job.
+
+```ruby
+# Define a tool that calls a different model
+specialist_tool = OpenRouter::Tool.define do
+  name "consult_specialist"
+  description "Consult a specialist AI model for specific tasks like code review, math, or creative writing. Use this when a task would benefit from a specialized model's expertise."
+
+  parameters do
+    string :task_type, required: true,
+           enum: ["code_review", "math_reasoning", "creative_writing", "analysis"],
+           description: "Type of task to delegate"
+    string :prompt, required: true,
+           description: "The specific question or task for the specialist"
+    string :context,
+           description: "Additional context to provide to the specialist"
+  end
+end
+
+# Tool executor that routes to different models
+class ModelDelegationExecutor
+  MODEL_ROUTING = {
+    "code_review" => "anthropic/claude-sonnet-4",
+    "math_reasoning" => "deepseek/deepseek-r1",
+    "creative_writing" => "anthropic/claude-sonnet-4",
+    "analysis" => "openai/gpt-4o"
+  }.freeze
+
+  def initialize(client)
+    @client = client
+  end
+
+  def execute(tool_call)
+    args = tool_call.arguments
+    task_type = args["task_type"]
+    prompt = args["prompt"]
+    context = args["context"]
+
+    # Select the appropriate specialist model
+    specialist_model = MODEL_ROUTING[task_type]
+
+    # Build the specialist prompt
+    specialist_messages = [
+      {
+        role: "system",
+        content: system_prompt_for(task_type)
+      },
+      {
+        role: "user",
+        content: context ? "Context: #{context}\n\nTask: #{prompt}" : prompt
+      }
+    ]
+
+    # Call the specialist model
+    specialist_response = @client.complete(
+      specialist_messages,
+      model: specialist_model
+    )
+
+    {
+      specialist_model: specialist_model,
+      task_type: task_type,
+      response: specialist_response.content
+    }
+  end
+
+  private
+
+  def system_prompt_for(task_type)
+    case task_type
+    when "code_review"
+      "You are an expert code reviewer. Analyze the code for bugs, security issues, and improvements."
+    when "math_reasoning"
+      "You are a mathematics expert. Solve problems step by step with clear explanations."
+    when "creative_writing"
+      "You are a creative writing expert. Help with storytelling, prose, and narrative."
+    when "analysis"
+      "You are an analytical expert. Provide thorough, well-reasoned analysis."
+    end
+  end
+end
+
+# Usage in a tool loop
+client = OpenRouter::Client.new
+executor = ModelDelegationExecutor.new(client)
+
+messages = [
+  { role: "user", content: "Review this Ruby code and also help me solve: what's the integral of x^2?" }
+]
+
+# Primary model (orchestrator)
+response = client.complete(
+  messages,
+  model: "openai/gpt-4o-mini",  # Fast, cheap orchestrator
+  tools: [specialist_tool],
+  tool_choice: "auto"
+)
+
+if response.has_tool_calls?
+  messages << response.to_message
+
+  response.tool_calls.each do |tool_call|
+    puts "Delegating #{tool_call.arguments['task_type']} to specialist..."
+
+    result = executor.execute(tool_call)
+    puts "Specialist (#{result[:specialist_model]}) responded"
+
+    messages << tool_call.to_result_message(result)
+  end
+
+  # Get final synthesized response from orchestrator
+  final_response = client.complete(
+    messages,
+    model: "openai/gpt-4o-mini",
+    tools: [specialist_tool]
+  )
+
+  puts final_response.content
+end
+```
+
+#### Advanced: Multi-Model Reasoning Pipeline
+
+```ruby
+# Chain multiple specialist consultations for complex tasks
+class ReasoningPipeline
+  def initialize(client)
+    @client = client
+  end
+
+  def solve_complex_problem(problem)
+    # Step 1: Break down the problem with a reasoning model
+    breakdown = consult_model(
+      model: "deepseek/deepseek-r1",
+      system: "Break this problem into smaller, solvable steps.",
+      prompt: problem
+    )
+
+    # Step 2: Solve each step with appropriate specialists
+    solutions = breakdown[:steps].map do |step|
+      model = select_model_for_step(step)
+      consult_model(
+        model: model,
+        system: "Solve this specific step thoroughly.",
+        prompt: step
+      )
+    end
+
+    # Step 3: Synthesize with a capable general model
+    consult_model(
+      model: "anthropic/claude-sonnet-4",
+      system: "Synthesize these solutions into a coherent final answer.",
+      prompt: "Problem: #{problem}\n\nStep solutions:\n#{solutions.join("\n\n")}"
+    )
+  end
+
+  private
+
+  def consult_model(model:, system:, prompt:)
+    response = @client.complete(
+      [
+        { role: "system", content: system },
+        { role: "user", content: prompt }
+      ],
+      model: model
+    )
+    response.content
+  end
+
+  def select_model_for_step(step)
+    # Route based on step content
+    case step
+    when /code|programming|function/i
+      "anthropic/claude-sonnet-4"
+    when /math|calculate|equation/i
+      "deepseek/deepseek-r1"
+    when /research|analyze|compare/i
+      "openai/gpt-4o"
+    else
+      "openai/gpt-4o-mini"
+    end
+  end
+end
+```
+
+#### Cost-Aware Model Routing
+
+```ruby
+# Route based on task complexity to optimize cost
+class CostAwareRouter
+  MODELS_BY_TIER = {
+    cheap: "openai/gpt-4o-mini",
+    standard: "openai/gpt-4o",
+    premium: "anthropic/claude-sonnet-4",
+    reasoning: "deepseek/deepseek-r1"
+  }.freeze
+
+  def initialize(client)
+    @client = client
+  end
+
+  def route_task(task, complexity: :auto)
+    tier = complexity == :auto ? estimate_complexity(task) : complexity
+    model = MODELS_BY_TIER[tier]
+
+    @client.complete(
+      [{ role: "user", content: task }],
+      model: model
+    )
+  end
+
+  private
+
+  def estimate_complexity(task)
+    # Quick heuristics for complexity
+    word_count = task.split.size
+
+    case
+    when task.match?(/prove|derive|analyze deeply|comprehensive/i)
+      :reasoning
+    when task.match?(/code|debug|security|architecture/i)
+      :premium
+    when word_count > 200 || task.match?(/compare|evaluate|synthesize/i)
+      :standard
+    else
+      :cheap
+    end
+  end
+end
 ```