ollama-client 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86bef7e3dc6197748e9d75572705cec97bc94a24da8c9e8f7402d9b5db1e1dc8
-  data.tar.gz: 1ae799bfc340896179b3819350b81fe852c8f2b944f6987cf4f8c76b61791153
+  metadata.gz: 9b126aae11a2fd7f0ff26e53e90e12222eb88e23fa6ecf622215c4a9317fe6ce
+  data.tar.gz: 2656544e1ce4bfa852dc687108bdde17084773c3a1e76c53ae9ed59d77604256
 SHA512:
-  metadata.gz: 1b4a54c4625c0bcb947d74e914bedc0f974e6b0bbaad6f4f46673b8dce5eb6956c5a3bc75745845ccd7f79830149a24ad1e49c54bc03ef165c39ed71d14a92db
-  data.tar.gz: e2ce9114ab3396d65a3075f80c1d273e0d414d2d8be0d4bae4b5e1717fdc62451d2a57590d59e191be86613280fbbd925201ba9d1285a95a2d0cdfabdafc25c3
+  metadata.gz: 5cbd78f768412b8e413e9222b4b0b2ef68e094280546742a0bd8191269072a6281ae4182d591e889ba3829c5b047b0e053c2410fa7734dc4cf1dfe320b527239
+  data.tar.gz: 2f1c2eafa75910646ed2300c8ad5ab312aefe56bb03d6e4797356e219543a57532058c2b2f3fc31b773caf0e7e0d26b3a71a6f9887b1a40955f5b818ffe6e227

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+- Add tag-triggered GitHub Actions release workflow for RubyGems publishing.
+
+## [0.2.3] - 2026-01-17
+
+- Add per-call `model:` override for `Ollama::Client#generate`.
+- Document `generate` model override usage in README.
+- Add spec to cover per-call `model:` in 404 error path.
+
 ## [0.2.0] - 2026-01-12
 
 - Add `Ollama::Agent::Planner` (stateless `/api/generate`)

data/README.md

@@ -287,6 +287,7 @@ schema = {
 # 2. Call the LLM with your schema
 begin
   result = client.generate(
+    model: "llama3.1:8b",
     prompt: "Your prompt here",
     schema: schema
   )
@@ -877,7 +878,12 @@ ruby examples/advanced_multi_step_agent.rb
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+To release a new version, update `lib/ollama/version.rb` and `CHANGELOG.md`, then commit. You can:
+
+- Run `bundle exec rake release` locally to create the tag, push commits/tags, and publish to [rubygems.org](https://rubygems.org).
+- Push a tag `vX.Y.Z` to trigger the GitHub Actions release workflow, which builds and publishes the gem using the `RUBYGEMS_API_KEY` secret.
 
 ## Contributing
 

data/docs/CLOUD.md

@@ -0,0 +1,29 @@
+# Cloud Agent Guide
+
+This repository is a Ruby gem. It has no database and does not require
+application secrets for the default test suite.
+
+## Required Commands
+- `bundle install`
+- `bundle exec rubocop`
+- `bundle exec rspec`
+
+## Agent Prompt Template
+You are operating on a Ruby gem repository.
+Task:
+1. Run `bundle exec rubocop`.
+2. Fix all RuboCop offenses.
+3. Re-run RuboCop until clean.
+4. Run `bundle exec rspec`.
+5. Fix all failing specs.
+6. Re-run RSpec until green.
+
+Rules:
+- Do not skip failures.
+- Do not change public APIs without reporting.
+- Do not bump gem version unless explicitly told.
+- Stop if blocked and explain why.
+
+## Guardrails
+- Keep API surface stable and backward compatible.
+- Update specs when behavior changes.

data/docs/CONSOLE_IMPROVEMENTS.md

@@ -0,0 +1,256 @@
+# Console Improvements
+
+## Overview
+
+Enhanced the interactive console experiences (`chat_console.rb` and `dhan_console.rb`) to provide better user feedback and cleaner output formatting.
+
+## Chat Console (`chat_console.rb`)
+
+### Problem
+
+When the LLM was processing a response, the `llm>` prompt appeared immediately, making it look like it was waiting for user input. This caused confusion where users would start typing, thinking it was a prompt.
+
+### Solution
+
+Added a **thinking indicator** that shows while waiting for the API response:
+
+**Before:**
+```
+you> Hi
+llm> [cursor blinks here - looks like a prompt!]
+[user types something]
+[then response appears]
+```
+
+**After:**
+```
+you> Hi
+... [thinking indicator in cyan]
+llm> Hey! How can I help you?
+you> [clear prompt for next input]
+```
+
+### Implementation
+
+```ruby
+def chat_response(client, messages, config)
+  content = +""
+  prompt_printed = false
+
+  # Show thinking indicator
+  print "#{COLOR_LLM}...#{COLOR_RESET}"
+  $stdout.flush
+
+  client.chat_raw(...) do |chunk|
+    token = chunk.dig("message", "content").to_s
+    next if token.empty?
+
+    # Replace thinking indicator with llm> on first token
+    unless prompt_printed
+      print "\r#{LLM_PROMPT}"
+      prompt_printed = true
+    end
+
+    content << token
+    print token
+    $stdout.flush
+  end
+
+  puts
+  content
+end
+```
+
+**Key Changes:**
+- `\r` (carriage return) replaces `...` with `llm>` when first token arrives
+- `$stdout.flush` ensures immediate visual feedback
+- Clear visual state: thinking → responding → ready for input
+
+## DhanHQ Console (`dhan_console.rb`)
+
+### Problem
+
+Tool results were displayed as raw JSON dumps, making it hard to quickly understand:
+- **Which tool** was called
+- **What data** was retrieved
+- **Key information** from the response
+
+**Before:**
+```
+Tool Results:
+- get_live_ltp
+{
+  "action": "get_live_ltp",
+  "params": {
+    "security_id": "13",
+    "symbol": "NIFTY",
+    "exchange_segment": "IDX_I"
+  },
+  "result": {
+    "security_id": "13",
+    "exchange_segment": "IDX_I",
+    "ltp": 25694.35,
+    "ltp_data": {
+      "last_price": 25694.35
+    },
+    "symbol": "NIFTY"
+  }
+}
+```
+
+### Solution
+
+Implemented **formatted, human-readable tool results** that extract and display key information:
+
+**After:**
+```
+🔧 Tool Called: get_live_ltp
+   → NIFTY (IDX_I)
+   → Last Price: ₹25694.35
+
+llm> The current price of NIFTY is 25694.35.
+```
+
+### Formatted Output by Tool
+
+#### 1. Live LTP (`get_live_ltp`)
+```
+🔧 Tool Called: get_live_ltp
+   → NIFTY (IDX_I)
+   → Last Price: ₹25694.35
+```
+
+#### 2. Market Quote (`get_market_quote`)
+```
+🔧 Tool Called: get_market_quote
+   → RELIANCE
+   → LTP: ₹1457.9
+   → OHLC: O:1458.8 H:1480.0 L:1455.1 C:1457.9
+   → Volume: 17167161
+```
+
+#### 3. Historical Data (`get_historical_data`)
+
+**Regular data:**
+```
+🔧 Tool Called: get_historical_data
+   → Historical data: 30 records
+   → Interval: 5
+```
+
+**With indicators:**
+```
+🔧 Tool Called: get_historical_data
+   → Technical Indicators:
+   →   Current Price: ₹25694.35
+   →   RSI(14): 56.32
+   →   MACD: 12.45
+   →   SMA(20): ₹25680.12
+   →   SMA(50): ₹25550.45
+```
+
+#### 4. Option Chain (`get_option_chain`)
+```
+🔧 Tool Called: get_option_chain
+   → Spot: ₹25694.35
+   → Strikes: 15
+   → (Filtered: ATM/OTM/ITM with both CE & PE)
+```
+
+#### 5. Expiry List (`get_expiry_list`)
+```
+🔧 Tool Called: get_expiry_list
+   → Available expiries: 12
+   → Next expiry: 2026-01-20
+   → Expiries: 2026-01-20, 2026-01-27, 2026-02-03, 2026-02-10, 2026-02-17...
+```
+
+#### 6. Find Instrument (`find_instrument`)
+```
+🔧 Tool Called: find_instrument
+   → Found: NIFTY
+   → Security ID: 13
+   → Exchange: IDX_I
+```
+
+### Implementation
+
+```ruby
+def print_formatted_result(tool_name, content)
+  result = content.dig("result") || content
+
+  case tool_name
+  when "get_live_ltp"
+    print_ltp_result(result)
+  when "get_market_quote"
+    print_quote_result(result)
+  when "get_historical_data"
+    print_historical_result(result, content)
+  # ... other tool formatters
+  end
+end
+```
+
+Each tool has a dedicated formatter that:
+1. Extracts key information from the result
+2. Formats it in a human-readable way
+3. Uses color coding for better readability
+4. Shows relevant details without overwhelming the user
+
+## Benefits
+
+### Chat Console
+✅ **Clear visual feedback** - Users know when the LLM is thinking vs responding
+✅ **No confusion** - Thinking indicator prevents accidental typing
+✅ **Better UX** - Immediate response to user input
+
+### DhanHQ Console
+✅ **Instant comprehension** - See what tool was called at a glance
+✅ **Key data highlighted** - Important values (price, volume) are prominent
+✅ **Less noise** - No JSON clutter, just the facts
+✅ **Consistent formatting** - Each tool type has predictable output
+✅ **Professional appearance** - Clean, organized display with icons
+
+## Configuration
+
+Both consoles support environment variables:
+
+**Chat Console:**
+```bash
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=llama3.1:8b
+OLLAMA_TEMPERATURE=0.7
+OLLAMA_SYSTEM="You are a helpful assistant"
+```
+
+**DhanHQ Console:**
+```bash
+# All chat console vars, plus:
+DHANHQ_CLIENT_ID=your_client_id
+DHANHQ_ACCESS_TOKEN=your_token
+SHOW_PLAN=true              # Show planning step
+ALLOW_NO_TOOL_OUTPUT=false  # Require tool calls
+```
+
+## Testing
+
+```bash
+# Test chat console with thinking indicator
+ruby examples/chat_console.rb
+
+# Test DhanHQ console with formatted results
+ruby examples/dhan_console.rb
+```
+
+Try queries like:
+- "What is NIFTY price?" → See formatted LTP
+- "Get RELIANCE quote" → See formatted quote with OHLC
+- "Show me historical data for NIFTY" → See record count
+- "Get option chain for NIFTY" → See filtered strikes
+
+## Related Files
+
+- `examples/chat_console.rb` - Simple chat with thinking indicator
+- `examples/dhan_console.rb` - Market data with formatted tool results
+- `examples/dhanhq_tools.rb` - Underlying DhanHQ tool implementations
+- `docs/TESTING.md` - Testing guide