ticuna 0.2.5 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad184878c7d2fd8d8ee366a2de9996588b74ed1729bc21cc0b22fab7ffe7abb5
-  data.tar.gz: 4f4fae314169358a091dbb9dfafdc712807ec3f35b27634434d06b587d6080b6
+  metadata.gz: 55e07fd5840706e2936718a07ad6e6e6be5ae8681b6c8b763bac6c9c073d632f
+  data.tar.gz: '0118e2253d49b82acbbe08ed17145997330a9c42f30f276e87b7ff01136710d9'
 SHA512:
-  metadata.gz: c5a0f5ced928c16bcefd52df2a904fa07c895f724aa49eb4621b99b97247034da6a8b64167297bc480e322faf667b5e8c3864f0dc8a4d31099a535c721159464
-  data.tar.gz: e7d4fe0589f6d82554968f2a095048ac41c33f16c7ffb078e96d95024d3ddc52d13c6ab6dd218650ebbd1eec2d28e2f30d95c1820f63168ea6948ac68013f721
+  metadata.gz: 90467485b1691fdf24b14c442945f82f8b58db85b4ff47ee1f2403adf96b3fdd5efcd54fc94cd3c88068151037ac220058536797c9b407f2acd83b2a7edbab3e
+  data.tar.gz: d60b05c8b3e1306835c9996e91b88accfe8ca2fe7d1f47c0358d7ae2903a4c7b2bc2e6949007c6294cda3a312c9c5bbea81f9d9cc40095d830eea04c8c657031

data/CHANGELOG.md

@@ -28,4 +28,11 @@
 
 ## [0.2.5] - 2025-10-13
 - Better messages
-- Add `errors?` method
+- Add `errors?` method
+
+## [0.2.6] - 2025-10-22
+- Add `context` method
+
+## [0.2.7] - 2025-10-22
+- Add modular response, to attend any LLM model
+- Add `.response` method in Ticuna::Response to ease access to the real response

data/lib/ticuna/llm.rb

@@ -10,14 +10,14 @@ module Ticuna
     def self.new(provider = nil)
       provider_key = detect_provider(provider)
       provider_client = Ticuna::Providers::CLIENTS[provider_key].call
-      new_instance = allocate
-      new_instance.send(:initialize_llm, provider_client)
-      new_instance
+      allocate.tap { |instance| instance.send(:initialize_llm, provider_key, provider_client) }
     end
 
-    def initialize_llm(provider_client)
+    def initialize_llm(provider_key, provider_client)
+      @provider_key = provider_key
       @provider = provider_client
       @tools = []
+      @contexts = []
     end
 
     def tool(klass)
@@ -25,13 +25,21 @@ module Ticuna
       self
     end
 
+    def context(value = nil, &block)
+      value = block.call if block
+      @contexts << value if value
+      self
+    end
+
     def ask(message, stream: false, model: :gpt_4_1, output_format: :text, &block)
-      tool_contexts = @tools.map(&:context).compact.join("\n\n")
+      tool_contexts = @tools.map(&:context).compact
+      direct_contexts = @contexts.compact
+      combined_contexts = (tool_contexts + direct_contexts).reject { |ctx| ctx.to_s.strip.empty? }
 
-      system_message = if tool_contexts.empty?
+      system_message = if combined_contexts.empty?
                          nil
                        else
-                         { role: "developer", content: tool_contexts }
+                         { role: "developer", content: combined_contexts.join("\n\n") }
                        end
 
       messages = if system_message
@@ -43,7 +51,8 @@ module Ticuna
       model_string = detect_llm_model(model)
 
       Ticuna::Response.new(
-        @provider.ask_with_messages(messages, stream: stream, model: model_string, output_format: output_format, &block)
+        @provider.ask_with_messages(messages, stream: stream, model: model_string, output_format: output_format, &block),
+        provider: @provider_key
       )
     end
 

data/lib/ticuna/providers/openai.rb

@@ -7,6 +7,8 @@ module Ticuna
     class OpenAI < BaseProvider
       def initialize(api_key:)
         super(api_key: api_key, base_url: "https://api.openai.com/v1/")
+        @response = String.new
+        @raw_response = String.new
       end
 
       def ask(message, stream: false, model: "gpt-4.1-nano", output_format: :text, &block)
@@ -67,7 +69,8 @@ module Ticuna
             end
           end
 
-          {
+          @response = full_text
+          @raw_response = {
             "id" => "streamed_completion_#{Time.now.to_i}",
             "object" => "chat.completion",
             "model" => body[:model],
@@ -81,9 +84,13 @@ module Ticuna
           }
         else
           resp = @connection.post(path, body.to_json)
-          JSON.parse(resp.body)
+          @raw_response = JSON.parse(resp.body)
+          @response = @raw_response.dig("choices", 0, "message", "content")
         end
+
+        @raw_response
       end
+      attr_reader :response, :raw_response
     end
   end
 end

data/lib/ticuna/providers.rb

@@ -24,5 +24,9 @@ module Ticuna
       # deepseek: -> { Ticuna::Providers::DeepSeek.new(api_key: ENVS[:deepseek].call) },
       # mistral: -> { Ticuna::Providers::Mistral.new(api_key: ENVS[:mistral].call) }
     }.freeze
+
+    RESPONSE_EXTRACTORS = {
+      openai: ->(data) { data.dig(:choices, 0, :message, :content) }
+    }.freeze
   end
 end

data/lib/ticuna/response.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "json"
+require "ticuna/providers"
 
 module Ticuna
   class Response
-    attr_reader :data, :errors, :parsed
+    attr_reader :data, :errors, :parsed, :raw_response, :response, :provider
 
-    def initialize(raw)
+    def initialize(raw, provider: nil)
+      @provider = provider
+      @raw_response = raw
       @parsed =
         case raw
         when String
@@ -22,7 +25,14 @@ module Ticuna
         end
 
       @data = deep_symbolize_keys(@parsed)
-      @errors = deep_symbolize_keys(@parsed["error"] || [])
+      error_payload =
+        if @parsed.is_a?(Hash)
+          @parsed["error"] || @parsed[:error] || []
+        else
+          []
+        end
+      @errors = deep_symbolize_keys(error_payload)
+      @response = resolve_response
     end
 
     def [](key)
@@ -70,12 +80,36 @@ module Ticuna
     def wrap(value)
       case value
       when Hash
-        self.class.new(value)
+        self.class.new(value, provider: provider)
       when Array
         value.map { |v| wrap(v) }
       else
         value
       end
     end
+
+    def resolve_response
+      from_provider = extract_from_provider
+      return from_provider unless blank?(from_provider)
+
+      fallback =
+        if @data.is_a?(Hash)
+          @data[:content] || @data[:response]
+        end
+      return fallback unless blank?(fallback)
+
+      @parsed if @parsed.is_a?(String)
+    end
+
+    def blank?(value)
+      value.respond_to?(:empty?) ? value.empty? : !value
+    end
+
+    def extract_from_provider
+      return unless provider
+
+      extractor = Ticuna::Providers::RESPONSE_EXTRACTORS[provider]
+      extractor&.call(@data)
+    end
   end
 end

data/lib/ticuna/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ticuna
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.7
 platform: ruby
 authors:
 - Chirana
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-13 00:00:00.000000000 Z
+date: 2025-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday