ticuna 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25afb92c6ab2ba62fe78323b2c25e8a6f87d08d0297139ea4433e52de1156426
-  data.tar.gz: 90d7976a68c9ae75c972bda54765e11d4dd9050c32d2f6433852b15a607f2b11
+  metadata.gz: '058bd0a97b93a756f03650373f98ba045b49a7b72499d8fd259d3520ab375fcd'
+  data.tar.gz: 1377d3415e111d5ed72cee4e68f9ff9b98f4a1d947c6bbb854820d8abe82e765
 SHA512:
-  metadata.gz: 368e1eefe0937908dbbaf2dec05aaafc5ebd2f2e818d7fd5f445a3631b644d05e1ce22426861f9754b7e10e2177db4fb7dd3badebf70050bd1a9e81a6a674897
-  data.tar.gz: 13e403ca060db22f7427a33df32cddb4b255a15c27865a6080c714292bec45a307c39c632e403aa2483e5581ee5dc75fcda3be090d29438fe6531ef31ffaae68
+  metadata.gz: 41144c5b7ba4226d026d055f33a960174dc7cde8e726dc68f19d2abc44dfda5cbf14fac3fe1f7bbdbd4c8b51d126712200fba3902f9d4e88dc1846f9eede7355
+  data.tar.gz: a1d5312ecfb22e1f7fa99ae35bc1057a9aff4e5aae60faa227dbbe8d95f59eb31526126da0aa0cbdf2ac51e34b9958abfe03749064fe59058dfd42686f01bf07

data/CHANGELOG.md

@@ -3,3 +3,16 @@
 ## [0.0.1.0] - 2025-10-02
 
 - Initial release
+- Starting develop this gem
+
+## [0.1.0] - 2025-10-06
+- Add support for OpenAI
+
+## [0.2.0] - 2025-10-06
+- Add Ticuna::Response [commit here](https://github.com/thiagochirana/ticuna/commit/04ee12ee4caa3c7d30962a117777ef101607eba6)
+
+## [0.2.1] - 2025-10-06
+- Add Ticuna::Response to attend hash and string responses, [commit here](https://github.com/thiagochirana/ticuna/commit/0c7cb8a9e843f37eab41cda35252c10163dc3c9b)
+
+## [0.2.2] - 2025-10-06
+- Add support for OpenAI with stream and output_format (json or text), [PR here](https://github.com/thiagochirana/ticuna/pull/2)

data/lib/ticuna/llm.rb

@@ -38,16 +38,13 @@ module Ticuna
       self
     end
 
-    def ask(message, stream: false, model: "gpt-4.1-nano", &block)
+    def ask(message, stream: false, model: "gpt-4.1-nano", output_format: :text, &block)
       tool_contexts = @tools.map(&:context).compact.join("\n\n")
 
       system_message = if tool_contexts.empty?
                          nil
                        else
-                         {
-                           role: "system",
-                           content: "Tools contexts:\n\n#{tool_contexts}"
-                         }
+                         { role: "system", content: "Tools contexts:\n\n#{tool_contexts}" }
                        end
 
       messages = if system_message
@@ -56,7 +53,9 @@ module Ticuna
                    [{ role: "user", content: message }]
                  end
 
-      Ticuna::Response.new(@provider.ask_with_messages(messages, stream: stream, model: model, &block))
+      Ticuna::Response.new(
+        @provider.ask_with_messages(messages, stream: stream, model: model, output_format: output_format, &block)
+      )
     end
 
     private

data/lib/ticuna/providers/openai.rb

@@ -9,24 +9,36 @@ module Ticuna
         super(api_key: api_key, base_url: "https://api.openai.com/v1/")
       end
 
-      def ask(message, stream: false, model: "gpt-4.1-nano", &block)
-        send_request_to(messages: [{ role: "user", content: message }], stream:, model:, &block)
+      def ask(message, stream: false, model: "gpt-4.1-nano", output_format: :text, &block)
+        send_request_to(
+          messages: [{ role: "user", content: message }],
+          stream:,
+          model:,
+          output_format:,
+          &block
+        )
       end
 
-      def ask_with_messages(messages, stream: false, model: "gpt-4.1-nano", &block)
-        send_request_to(messages:, stream:, model:, &block)
+      def ask_with_messages(messages, stream: false, model: "gpt-4.1-nano", output_format: :text, &block)
+        send_request_to(messages:, stream:, model:, output_format:, &block)
       end
 
       private
 
-      def send_request_to(messages:, model: nil, stream: false, &block)
+      def send_request_to(messages:, model: nil, stream: false, output_format: :text, &block)
+        raise ArgumentError, "Invalid output_format: #{output_format}" unless %i[text json].include?(output_format)
+
         body = {
           model: model,
           messages: messages,
           stream: stream
         }
 
+        body[:response_format] = { type: "json_object" } if output_format == :json
+
         post("chat/completions", body, stream: stream, &block)
+      rescue Faraday::BadRequestError => e
+        raise "response_format not supported by #{model}" unless e.message.include?("response_format")
       end
 
       def post(path, body, stream: false, &block)
@@ -35,7 +47,6 @@ module Ticuna
 
           @connection.post(path) do |req|
             req.body = body.to_json
-
             req.options.on_data = proc do |chunk, _bytes|
               chunk.each_line do |line|
                 next unless line.start_with?("data:")
@@ -51,7 +62,6 @@ module Ticuna
 
                 delta = json.dig("choices", 0, "delta", "content")
                 full_text << delta if delta
-
                 yield json if block_given?
               end
             end
@@ -64,10 +74,7 @@ module Ticuna
             "choices" => [
               {
                 "index" => 0,
-                "message" => {
-                  "role" => "assistant",
-                  "content" => full_text
-                },
+                "message" => { "role" => "assistant", "content" => full_text },
                 "finish_reason" => "stop"
               }
             ]

data/lib/ticuna/response.rb

@@ -1,11 +1,27 @@
 # frozen_string_literal: true
 
+require "json"
+
 module Ticuna
   class Response
     attr_reader :data
 
-    def initialize(data)
-      @data = deep_symbolize_keys(data)
+    def initialize(raw)
+      parsed =
+        case raw
+        when String
+          begin
+            JSON.parse(raw)
+          rescue JSON::ParserError
+            { content: raw }
+          end
+        when Hash
+          raw
+        else
+          raise ArgumentError, "Ticuna::Response only accepts Hash or String, received: #{raw.class}"
+        end
+
+      @data = deep_symbolize_keys(parsed)
     end
 
     def [](key)
@@ -16,14 +32,13 @@ module Ticuna
       @data
     end
 
-    def inspect
-      "#<Ticuna::Response #{@data.inspect}>"
+    def to_s
+      @data.inspect
     end
 
     def method_missing(name, *args, &block)
       value = @data[name]
       return wrap(value) if @data.key?(name)
-
       super
     end
 

data/lib/ticuna/version.rb

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

metadata

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