ollama-client 0.2.5 → 0.2.7

data/lib/ollama/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ollama
-  VERSION = "0.2.5"
+  VERSION = "0.2.7"
 end

data/lib/ollama_client.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# Load .env file if available (.env takes precedence over shell environment variables)
+require "dotenv"
+Dotenv.overload
+
+require_relative "ollama/version"
 require_relative "ollama/config"
 require_relative "ollama/errors"
 require_relative "ollama/schema_validator"
@@ -9,21 +14,27 @@ require_relative "ollama/tool"
 require_relative "ollama/client"
 require_relative "ollama/document_loader"
 require_relative "ollama/streaming_observer"
+require_relative "ollama/chat_session"
 require_relative "ollama/agent/messages"
 require_relative "ollama/agent/planner"
 require_relative "ollama/agent/executor"
+require_relative "ollama/mcp"
+require_relative "ollama/personas"
 
 # Main entry point for OllamaClient gem
 #
 # ⚠️ THREAD SAFETY WARNING:
-# Global configuration via OllamaClient.configure is NOT thread-safe.
-# For concurrent agents or multi-threaded applications, use per-client
-# configuration instead:
+# Global configuration access is protected by mutex, but modifying
+# global config while clients are active can cause race conditions.
+# For concurrent agents or multi-threaded applications, prefer
+# per-client configuration (recommended):
 #
 #   config = Ollama::Config.new
 #   config.model = "llama3.1"
 #   client = Ollama::Client.new(config: config)
 #
+# Each client instance is thread-safe when using its own config.
+#
 module OllamaClient
   @config_mutex = Mutex.new
   @warned_thread_config = false
@@ -37,8 +48,9 @@ module OllamaClient
   def self.configure
     if Thread.current != Thread.main && !@warned_thread_config
       @warned_thread_config = true
-      msg = "[ollama-client] Global OllamaClient.configure is not thread-safe. " \
-            "Prefer per-client config (Ollama::Client.new(config: ...))."
+      msg = "[ollama-client] Global OllamaClient.configure called from non-main thread. " \
+            "While access is mutex-protected, modifying global config concurrently can cause " \
+            "race conditions. Prefer per-client config: Ollama::Client.new(config: ...)"
       warn(msg)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ollama-client
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.7
 platform: ruby
 authors:
 - Shubham Taywade
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-21 00:00:00.000000000 Z
+date: 2026-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -60,7 +60,6 @@ description: A production-ready, agent-first Ruby client for the Ollama API with
 email:
 - shubhamtaywade82@gmail.com
 executables:
-- dhan_console
 - ollama-client
 extensions: []
 extra_rdoc_files: []
@@ -70,76 +69,51 @@ files:
 - CONTRIBUTING.md
 - LICENSE.txt
 - README.md
+- RELEASE_NOTES_v0.2.6.md
 - Rakefile
+- docs/AREAS_FOR_CONSIDERATION.md
 - docs/CLOUD.md
 - docs/CONSOLE_IMPROVEMENTS.md
+- docs/EXAMPLE_REORGANIZATION.md
 - docs/FEATURES_ADDED.md
+- docs/GETTING_STARTED.md
 - docs/HANDLERS_ANALYSIS.md
+- docs/INTEGRATION_TESTING.md
+- docs/NEXT_STEPS_SUMMARY.md
+- docs/PERSONAS.md
 - docs/PRODUCTION_FIXES.md
+- docs/QUICK_START.md
 - docs/README.md
 - docs/RELEASE_GUIDE.md
 - docs/SCHEMA_FIXES.md
 - docs/TESTING.md
+- docs/TEST_CHECKLIST.md
 - docs/TEST_UPDATES.md
 - docs/ruby_guide.md
 - examples/README.md
-- examples/advanced_complex_schemas.rb
-- examples/advanced_edge_cases.rb
-- examples/advanced_error_handling.rb
-- examples/advanced_multi_step_agent.rb
-- examples/advanced_performance_testing.rb
-- examples/chat_console.rb
-- examples/complete_workflow.rb
-- examples/dhan_console.rb
-- examples/dhanhq/README.md
-- examples/dhanhq/agents/base_agent.rb
-- examples/dhanhq/agents/data_agent.rb
-- examples/dhanhq/agents/orchestrator_agent.rb
-- examples/dhanhq/agents/technical_analysis_agent.rb
-- examples/dhanhq/agents/trading_agent.rb
-- examples/dhanhq/analysis/market_structure.rb
-- examples/dhanhq/analysis/pattern_recognizer.rb
-- examples/dhanhq/analysis/trend_analyzer.rb
-- examples/dhanhq/builders/market_context_builder.rb
-- examples/dhanhq/dhanhq_agent.rb
-- examples/dhanhq/indicators/technical_indicators.rb
-- examples/dhanhq/scanners/intraday_options_scanner.rb
-- examples/dhanhq/scanners/swing_scanner.rb
-- examples/dhanhq/schemas/agent_schemas.rb
-- examples/dhanhq/services/base_service.rb
-- examples/dhanhq/services/data_service.rb
-- examples/dhanhq/services/trading_service.rb
-- examples/dhanhq/technical_analysis_agentic_runner.rb
-- examples/dhanhq/technical_analysis_runner.rb
-- examples/dhanhq/test_tool_calling.rb
-- examples/dhanhq/test_tool_calling_verbose.rb
-- examples/dhanhq/utils/instrument_helper.rb
-- examples/dhanhq/utils/parameter_cleaner.rb
-- examples/dhanhq/utils/parameter_normalizer.rb
-- examples/dhanhq/utils/rate_limiter.rb
-- examples/dhanhq/utils/trading_parameter_normalizer.rb
-- examples/dhanhq_agent.rb
-- examples/dhanhq_tools.rb
-- examples/multi_step_agent_with_external_data.rb
-- examples/structured_outputs_chat.rb
-- examples/structured_tools.rb
-- examples/test_dhanhq_tool_calling.rb
-- examples/test_tool_calling.rb
-- examples/tool_calling_direct.rb
-- examples/tool_calling_pattern.rb
+- examples/basic_chat.rb
+- examples/basic_generate.rb
+- examples/mcp_executor.rb
+- examples/mcp_http_executor.rb
+- examples/tool_calling_parsing.rb
 - examples/tool_dto_example.rb
-- exe/dhan_console
 - exe/ollama-client
 - lib/ollama/agent/executor.rb
 - lib/ollama/agent/messages.rb
 - lib/ollama/agent/planner.rb
+- lib/ollama/chat_session.rb
 - lib/ollama/client.rb
 - lib/ollama/config.rb
 - lib/ollama/document_loader.rb
 - lib/ollama/dto.rb
 - lib/ollama/embeddings.rb
 - lib/ollama/errors.rb
+- lib/ollama/mcp.rb
+- lib/ollama/mcp/http_client.rb
+- lib/ollama/mcp/stdio_client.rb
+- lib/ollama/mcp/tools_bridge.rb
 - lib/ollama/options.rb
+- lib/ollama/personas.rb
 - lib/ollama/response.rb
 - lib/ollama/schema_validator.rb
 - lib/ollama/schemas/base.json

data/examples/advanced_complex_schemas.rb

@@ -1,366 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Advanced Example: Complex Nested Schemas and Validation
-# Demonstrates: Deep nesting, arrays of objects, conditional validation, real-world data structures
-
-require "json"
-require_relative "../lib/ollama_client"
-
-# Example 1: Financial Analysis Schema
-class FinancialAnalyzer
-  def initialize(client:)
-    @client = client
-    @schema = {
-      "type" => "object",
-      "required" => ["analysis_date", "summary", "metrics", "recommendations"],
-      "properties" => {
-        "analysis_date" => {
-          "type" => "string",
-          "format" => "date-time"
-        },
-        "summary" => {
-          "type" => "string",
-          "minLength" => 50,
-          "maxLength" => 500
-        },
-        "metrics" => {
-          "type" => "object",
-          "required" => ["revenue", "profit_margin", "growth_rate"],
-          "properties" => {
-            "revenue" => {
-              "type" => "number",
-              "minimum" => 0
-            },
-            "profit_margin" => {
-              "type" => "number",
-              "minimum" => 0,
-              "maximum" => 100,
-              "description" => "Profit margin as percentage (0 to 100)"
-            },
-            "growth_rate" => {
-              "type" => "number"
-            },
-            "trend" => {
-              "type" => "string",
-              "enum" => ["increasing", "stable", "decreasing"]
-            }
-          }
-        },
-        "recommendations" => {
-          "type" => "array",
-          "minItems" => 1,
-          "maxItems" => 10,
-          "items" => {
-            "type" => "object",
-            "required" => ["action", "priority", "rationale"],
-            "properties" => {
-              "action" => {
-                "type" => "string"
-              },
-              "priority" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high", "critical"]
-              },
-              "rationale" => {
-                "type" => "string"
-              },
-              "estimated_impact" => {
-                "type" => "object",
-                "properties" => {
-                  "revenue_impact" => {
-                    "type" => "number"
-                  },
-                  "risk_level" => {
-                    "type" => "string",
-                    "enum" => ["low", "medium", "high"]
-                  }
-                }
-              }
-            }
-          }
-        },
-        "risk_factors" => {
-          "type" => "array",
-          "items" => {
-            "type" => "object",
-            "required" => ["factor", "severity"],
-            "properties" => {
-              "factor" => { "type" => "string" },
-              "severity" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high", "critical"]
-              },
-              "mitigation" => { "type" => "string" }
-            }
-          }
-        }
-      }
-    }
-  end
-
-  def analyze(data:)
-    prompt = <<~PROMPT
-      Analyze this financial data: #{data}
-
-      Return JSON with: summary (50-500 chars), metrics (revenue, profit_margin, growth_rate, trend),
-      recommendations array (action, priority, rationale), and optional risk_factors array.
-    PROMPT
-
-    @client.generate(prompt: prompt, schema: @schema)
-  end
-end
-
-# Example 2: Code Review Schema
-class CodeReviewer
-  def initialize(client:)
-    @client = client
-    @schema = {
-      "type" => "object",
-      "required" => ["overall_score", "issues", "suggestions"],
-      "properties" => {
-        "overall_score" => {
-          "type" => "integer",
-          "minimum" => 0,
-          "maximum" => 100,
-          "description" => "Overall quality score (0 to 100)"
-        },
-        "issues" => {
-          "type" => "array",
-          "items" => {
-            "type" => "object",
-            "required" => ["type", "severity", "location", "description"],
-            "properties" => {
-              "type" => {
-                "type" => "string",
-                "enum" => ["bug", "security", "performance", "style", "maintainability"]
-              },
-              "severity" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high", "critical"]
-              },
-              "location" => {
-                "type" => "object",
-                "properties" => {
-                  "file" => { "type" => "string" },
-                  "line" => { "type" => "integer" },
-                  "column" => { "type" => "integer" }
-                }
-              },
-              "description" => { "type" => "string" },
-              "suggestion" => { "type" => "string" }
-            }
-          }
-        },
-        "suggestions" => {
-          "type" => "array",
-          "items" => {
-            "type" => "object",
-            "required" => ["category", "description"],
-            "properties" => {
-              "category" => {
-                "type" => "string",
-                "enum" => ["refactoring", "optimization", "documentation", "testing"]
-              },
-              "description" => { "type" => "string" },
-              "priority" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high"]
-              }
-            }
-          }
-        },
-        "strengths" => {
-          "type" => "array",
-          "items" => { "type" => "string" }
-        },
-        "estimated_effort" => {
-          "type" => "object",
-          "properties" => {
-            "hours" => { "type" => "number", "minimum" => 0 },
-            "complexity" => {
-              "type" => "string",
-              "enum" => ["simple", "moderate", "complex"]
-            }
-          }
-        }
-      }
-    }
-  end
-
-  def review(code:)
-    prompt = <<~PROMPT
-      Review this Ruby code: #{code}
-
-      Return JSON with: overall_score (0-100), issues array (type, severity, location, description),
-      suggestions array (category, description, priority), optional strengths array, optional estimated_effort.
-    PROMPT
-
-    @client.generate(prompt: prompt, schema: @schema)
-  end
-end
-
-# Example 3: Research Paper Analysis Schema
-class ResearchAnalyzer
-  def initialize(client:)
-    @client = client
-    @schema = {
-      "type" => "object",
-      "required" => ["title", "key_findings", "methodology", "citations"],
-      "properties" => {
-        "title" => { "type" => "string" },
-        "key_findings" => {
-          "type" => "array",
-          "minItems" => 3,
-          "maxItems" => 10,
-          "items" => {
-            "type" => "object",
-            "required" => ["finding", "significance"],
-            "properties" => {
-              "finding" => { "type" => "string" },
-              "significance" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high", "breakthrough"]
-              },
-              "evidence" => { "type" => "string" }
-            }
-          }
-        },
-        "methodology" => {
-          "type" => "object",
-          "required" => ["type", "description"],
-          "properties" => {
-            "type" => {
-              "type" => "string",
-              "enum" => ["experimental", "observational", "theoretical", "computational", "mixed"]
-            },
-            "description" => { "type" => "string" },
-            "limitations" => {
-              "type" => "array",
-              "items" => { "type" => "string" }
-            }
-          }
-        },
-        "citations" => {
-          "type" => "array",
-          "items" => {
-            "type" => "object",
-            "required" => ["author", "title", "year"],
-            "properties" => {
-              "author" => { "type" => "string" },
-              "title" => { "type" => "string" },
-              "year" => {
-                "type" => "integer",
-                "minimum" => 1900,
-                "maximum" => 2100
-              },
-              "relevance" => {
-                "type" => "string",
-                "enum" => ["low", "medium", "high"]
-              }
-            }
-          }
-        },
-        "reproducibility_score" => {
-          "type" => "number",
-          "minimum" => 0,
-          "maximum" => 1,
-          "description" => "Reproducibility score (0.0 to 1.0, where 1.0 means fully reproducible)"
-        }
-      }
-    }
-  end
-
-  def analyze(paper_text:)
-    prompt = <<~PROMPT
-      Analyze this research paper: #{paper_text}
-
-      Return JSON with: title, key_findings array (3-10 items: finding, significance, evidence),
-      methodology (type, description, limitations), citations array (author, title, year, relevance),
-      optional reproducibility_score (0-1).
-    PROMPT
-
-    @client.generate(prompt: prompt, schema: @schema)
-  end
-end
-
-# Run examples
-if __FILE__ == $PROGRAM_NAME
-  # Use longer timeout for complex schemas
-  config = Ollama::Config.new
-  config.timeout = 60 # 60 seconds for complex operations
-  client = Ollama::Client.new(config: config)
-
-  puts "=" * 60
-  puts "Example 1: Financial Analysis"
-  puts "=" * 60
-  financial_data = <<~DATA
-    Q4 2024 Financial Report:
-    - Revenue: $2.5M (up 15% from Q3)
-    - Operating expenses: $1.8M
-    - Net profit: $700K
-    - Customer base: 5,000 (up 20%)
-    - Churn rate: 2% (down from 3%)
-  DATA
-
-  analyzer = FinancialAnalyzer.new(client: client)
-  begin
-    puts "⏳ Analyzing financial data (this may take 30-60 seconds)..."
-    result = analyzer.analyze(data: financial_data)
-    puts JSON.pretty_generate(result)
-  rescue Ollama::TimeoutError => e
-    puts "⏱️  Timeout: #{e.message}"
-    puts "   Try increasing timeout or using a faster model"
-  rescue Ollama::Error => e
-    puts "❌ Error: #{e.message}"
-  end
-
-  puts "\n" + "=" * 60
-  puts "Example 2: Code Review"
-  puts "=" * 60
-  code_sample = <<~RUBY
-    def calculate_total(items)
-      total = 0
-      items.each do |item|
-        total += item.price
-      end
-      total
-    end
-  RUBY
-
-  reviewer = CodeReviewer.new(client: client)
-  begin
-    puts "⏳ Reviewing code (this may take 30-60 seconds)..."
-    result = reviewer.review(code: code_sample)
-    puts JSON.pretty_generate(result)
-  rescue Ollama::TimeoutError => e
-    puts "⏱️  Timeout: #{e.message}"
-    puts "   Try increasing timeout or using a faster model"
-  rescue Ollama::Error => e
-    puts "❌ Error: #{e.message}"
-  end
-
-  puts "\n" + "=" * 60
-  puts "Example 3: Research Paper Analysis"
-  puts "=" * 60
-  paper_abstract = <<~TEXT
-    This study investigates the impact of machine learning on financial forecasting.
-    We analyzed 10 years of market data using neural networks and found a 23% improvement
-    in prediction accuracy. The methodology involved training on historical data and
-    validating on out-of-sample periods. Key limitations include data quality and
-    model interpretability challenges.
-  TEXT
-
-  research_analyzer = ResearchAnalyzer.new(client: client)
-  begin
-    puts "⏳ Analyzing research paper (this may take 30-60 seconds)..."
-    result = research_analyzer.analyze(paper_text: paper_abstract)
-    puts JSON.pretty_generate(result)
-  rescue Ollama::TimeoutError => e
-    puts "⏱️  Timeout: #{e.message}"
-    puts "   Try increasing timeout or using a faster model"
-  rescue Ollama::Error => e
-    puts "❌ Error: #{e.message}"
-  end
-end
-