ticuna 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 559816faa31497288f44f3c2174199ad15af23dceb2c7e373b2f9b7446c87725
-  data.tar.gz: 8758245018266453979599a0428b94bcbaaba288c6455c113f40c7e39abb97dd
+  metadata.gz: 55e07fd5840706e2936718a07ad6e6e6be5ae8681b6c8b763bac6c9c073d632f
+  data.tar.gz: '0118e2253d49b82acbbe08ed17145997330a9c42f30f276e87b7ff01136710d9'
 SHA512:
-  metadata.gz: 76171e5dc940d98159fb8b94119facf7cc9b23f08f30a37cda59ad57483e91915a261e694c50f2135eb17fa20955e05092358a98382e763ed762de1c610ee827
-  data.tar.gz: ec1bf63e151eec143d2d1a8ded518cef4ca7b9a64654612f54eeaf3d7695b99e9ca83b7485e9d239c587c19930b8259a65f1c9c1a245fb6ade3e4426fc5be175
+  metadata.gz: 90467485b1691fdf24b14c442945f82f8b58db85b4ff47ee1f2403adf96b3fdd5efcd54fc94cd3c88068151037ac220058536797c9b407f2acd83b2a7edbab3e
+  data.tar.gz: d60b05c8b3e1306835c9996e91b88accfe8ca2fe7d1f47c0358d7ae2903a4c7b2bc2e6949007c6294cda3a312c9c5bbea81f9d9cc40095d830eea04c8c657031

data/CHANGELOG.md

@@ -31,4 +31,8 @@
 - Add `errors?` method
 
 ## [0.2.6] - 2025-10-22
-- Add `context` method
+- 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,12 +10,11 @@ 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 = []
@@ -52,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.6"
+  VERSION = "0.2.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ticuna
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - Chirana