ticuna 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8a828730dc99a8d166af1e48f840301001cbfed6951f50d29c235d4cbbdb1bfa
+  data.tar.gz: 47d9fb80dfd2b817eeed4c613990eef38acf0c25d75ef350c88ef845e57aa794
+SHA512:
+  metadata.gz: f8be7fd49108471209f87b519c0cf6201d16923b1b148106b3a5e3530d7954de6767d974889dada6da9f220093f26b362b93e054f9cc249e97c744d778db8496
+  data.tar.gz: ab30ecd88ab19200b9a3445443e8a8badb57d9120db141a3a132d4503ab9a991cc62cd89eb3d95ab48d69237300096aa563f8b93da82841782fc4ac6e05ed907

data/.env.example

@@ -0,0 +1,5 @@
+OPENAI_API_KEY=
+MISTRAL_API_KEY=
+ANTHROPIC_API_KEY=
+GEMINI_API_KEY=
+DEEPSEEK_API_KEY=

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.0.1.0] - 2025-10-02
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Chirana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,3 @@
+# Ticuna
+
+This is must be a Ruby Agent with AI gem

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/generators/ticuna/install/install_generator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Ticuna
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Install Ticuna"
+
+      def copy_initializer
+        template "ticuna.rb", "config/initializers/ticuna.rb"
+      end
+    end
+  end
+end

data/lib/generators/ticuna/install/templates/ticuna.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+Ticuna.config do |c|
+  # Configure your API Keys here
+  # c.openai_token   = ENV["OPENAI_API_KEY"]
+  # c.anthropic_token = ENV["ANTHROPIC_API_KEY"]
+  # c.deepseek_token  = ENV["DEEPSEEK_API_KEY"]
+  # c.mistral_token   = ENV["MISTRAL_API_KEY"]
+end

data/lib/ticuna/base_provider.rb

@@ -0,0 +1,21 @@
+require "faraday"
+require "json"
+
+module Ticuna
+  class BaseProvider
+    attr_reader :api_key, :base_url, :connection
+
+    def initialize(api_key:, base_url:)
+      @api_key = api_key
+      @base_url = base_url
+
+      @connection = Faraday.new(
+        url: base_url,
+        headers: {
+          "Content-Type" => "application/json",
+          "Authorization" => "Bearer #{api_key}"
+        }
+      )
+    end
+  end
+end

data/lib/ticuna/config.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Ticuna
+  class Config
+    attr_accessor :openai_token, :anthropic_token, :deepseek_token, :mistral_token
+
+    def initialize
+      @openai_token = nil
+      @anthropic_token = nil
+      @deepseek_token  = nil
+      @mistral_token   = nil
+    end
+
+    def openai_token=(token)
+      @openai_token = token
+    end
+
+    def anthropic_token=(token)
+      @anthropic_token = token
+    end
+
+    def deepseek_token=(token)
+      @deepseek_token = token
+    end
+
+    def mistral_token=(token)
+      @mistral_token = token
+    end
+  end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.config
+    self.configuration ||= Config.new
+    yield(configuration) if block_given?
+    configuration
+  end
+end

data/lib/ticuna/llm.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "ticuna/providers/openai"
+require "ticuna/config"
+
+module Ticuna
+  class LLM
+    PROVIDERS_ENV = {
+      openai: -> { Ticuna.config.openai_token },
+      anthropic: -> { Ticuna.config.anthropic_token },
+      deepseek: -> { Ticuna.config.deepseek_token },
+      mistral: -> { Ticuna.config.mistral_token }
+    }.freeze
+
+    PROVIDERS_CLIENT = {
+      openai: -> { Ticuna::Providers::OpenAI.new(api_key: PROVIDERS_ENV[:openai].call) }
+      # anthropic: -> { Ticuna::Providers::Anthropic.new(api_key: PROVIDERS_ENV[:anthropic].call) },
+      # deepseek: -> { Ticuna::Providers::DeepSeek.new(api_key: PROVIDERS_ENV[:deepseek].call) },
+      # mistral: -> { Ticuna::Providers::Mistral.new(api_key: PROVIDERS_ENV[:mistral].call) }
+    }.freeze
+
+    def self.new(provider = nil)
+      provider_key = detect_provider(provider)
+      provider_client = PROVIDERS_CLIENT[provider_key].call
+      new_instance = allocate
+      new_instance.send(:initialize_llm, provider_client)
+      new_instance
+    end
+
+    def initialize_llm(provider_client)
+      @provider = provider_client
+      @tools = []
+    end
+
+    def tool(klass)
+      @tools << klass.new
+      self
+    end
+
+    def ask(message, stream: false, model: "gpt-4.1-nano", &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}"
+                         }
+                       end
+
+      messages = if system_message
+                   [system_message, { role: "user", content: message }]
+                 else
+                   [{ role: "user", content: message }]
+                 end
+      @provider.ask_with_messages(messages, stream: stream, model: model, &block)
+    end
+
+    private
+
+    def self.detect_provider(provider)
+      return provider.to_sym if provider
+
+      valid = PROVIDERS_ENV.reject { |_, env_var| env_var.call&.strip.to_s == "" }
+
+      case valid.size
+      when 0
+        raise "Provider not found. Define at least one ENV with token."
+      when 1
+        valid.keys.firstraise
+      else
+        raise "Multiple providers detected: #{valid.keys.join(", ")}. Define one in Ticuna::LLM.new(provider: :provider_name)."
+      end
+    end
+  end
+end

data/lib/ticuna/providers/openai.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require_relative "../base_provider"
+
+module Ticuna
+  module Providers
+    class OpenAI < BaseProvider
+      def initialize(api_key:)
+        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)
+      end
+
+      def ask_with_messages(messages, stream: false, model: "gpt-4.1-nano", &block)
+        send_request_to(messages:, stream:, model:, &block)
+      end
+
+      private
+
+      def send_request_to(messages:, model: nil, stream: false, &block)
+        body = {
+          model: model,
+          messages: messages,
+          stream: stream
+        }
+
+        post("chat/completions", body, stream: stream, &block)
+      end
+
+      def post(path, body, stream: false, &block)
+        if stream
+          full_text = String.new
+
+          @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:")
+
+                data = line.sub("data:", "").strip
+                next if data.empty? || data == "[DONE]"
+
+                begin
+                  json = JSON.parse(data)
+                rescue JSON::ParserError
+                  next
+                end
+
+                delta = json.dig("choices", 0, "delta", "content")
+                full_text << delta if delta
+
+                yield json if block_given?
+              end
+            end
+          end
+
+          {
+            "id" => "streamed_completion_#{Time.now.to_i}",
+            "object" => "chat.completion",
+            "model" => body[:model],
+            "choices" => [
+              {
+                "index" => 0,
+                "message" => {
+                  "role" => "assistant",
+                  "content" => full_text
+                },
+                "finish_reason" => "stop"
+              }
+            ]
+          }
+        else
+          resp = @connection.post(path, body.to_json)
+          JSON.parse(resp.body)
+        end
+      end
+    end
+  end
+end

data/lib/ticuna/tool.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Ticuna
+  class Tool
+    class << self
+      attr_reader :_context
+
+      def context(value = nil)
+        if value
+          @_context = value
+        else
+          @_context
+        end
+      end
+    end
+
+    def context
+      self.class._context
+    end
+
+    def execute(*args)
+      raise NotImplementedError, "Tool must implement #execute"
+    end
+  end
+end

data/lib/ticuna/version.rb

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

data/lib/ticuna.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "ticuna/version"
+require_relative "ticuna/llm"
+require_relative "ticuna/tool"
+# require "generators/ticuna/install/install_generator"
+
+
+module Ticuna
+  class Error < StandardError; end
+end

data/sig/ticuna.rbs

@@ -0,0 +1,4 @@
+module Ticuna
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: ticuna
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chirana
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+description: Ruby Agents with AI
+email:
+- engsw.thiago@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.example"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/generators/ticuna/install/install_generator.rb
+- lib/generators/ticuna/install/templates/ticuna.rb
+- lib/ticuna.rb
+- lib/ticuna/base_provider.rb
+- lib/ticuna/config.rb
+- lib/ticuna/llm.rb
+- lib/ticuna/providers/openai.rb
+- lib/ticuna/tool.rb
+- lib/ticuna/version.rb
+- sig/ticuna.rbs
+homepage: https://github.com/thiagochirana/ticuna
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/thiagochirana/ticuna
+  source_code_uri: https://github.com/thiagochirana/ticuna
+  changelog_uri: https://github.com/thiagochirana/ticuna/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby Agents with AI
+test_files: []