gemlings 0.3.0

data/lib/gemlings/ui.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+begin
+  require "lipgloss"
+rescue LoadError
+  # lipgloss unavailable (e.g. JRuby) -- NullStyle handles fallback below
+end
+
+require "rouge"
+
+module Gemlings
+  LIPGLOSS_AVAILABLE = defined?(Lipgloss)
+
+  module UI
+    SPINNER_FRAMES = %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏].freeze
+
+    # Passthrough style used when lipgloss is unavailable
+    class NullStyle
+      def render(text)
+        text
+      end
+    end
+
+    module Styles
+      if LIPGLOSS_AVAILABLE
+        def self.label
+          @label ||= Lipgloss::Style.new.faint(true)
+        end
+
+        def self.plan_label
+          @plan_label ||= Lipgloss::Style.new
+            .bold(true)
+            .foreground("#011627")
+            .background("#FF9F1C")
+            .padding(0, 1)
+        end
+
+        def self.plan_box
+          @plan_box ||= Lipgloss::Style.new
+            .border(:rounded)
+            .border_foreground("#FF9F1C")
+            .padding(0, 2)
+        end
+
+        def self.final_answer
+          @final_answer ||= Lipgloss::Style.new
+            .bold(true)
+            .foreground("#2EC4B6")
+        end
+
+        def self.error
+          @error ||= Lipgloss::Style.new
+            .bold(true)
+            .foreground("#FF0000")
+        end
+
+        def self.dim
+          @dim ||= Lipgloss::Style.new.faint(true)
+        end
+
+        def self.spinner_style
+          @spinner_style ||= Lipgloss::Style.new
+            .foreground("#7B61FF")
+        end
+
+        def self.success_dot
+          @success_dot ||= Lipgloss::Style.new.foreground("#00CC00")
+        end
+
+        def self.error_dot
+          @error_dot ||= Lipgloss::Style.new.foreground("#FF0000")
+        end
+      else
+        def self.label;         NullStyle.new; end
+        def self.plan_label;    NullStyle.new; end
+        def self.plan_box;      NullStyle.new; end
+        def self.final_answer;  NullStyle.new; end
+        def self.error;         NullStyle.new; end
+        def self.dim;           NullStyle.new; end
+        def self.spinner_style; NullStyle.new; end
+        def self.success_dot;   NullStyle.new; end
+        def self.error_dot;     NullStyle.new; end
+      end
+    end
+
+    class Spinner
+      def initialize(message)
+        @message = message
+        @running = false
+        @frame = 0
+      end
+
+      def start
+        @running = true
+        @thread = Thread.new do
+          while @running
+            char = SPINNER_FRAMES[@frame % SPINNER_FRAMES.size]
+            frame = Styles.spinner_style.render(char)
+            $stderr.print "\r\e[K#{frame} #{@message}"
+            @frame += 1
+            sleep 0.08
+          end
+          $stderr.print "\r\e[K"
+        end
+      end
+
+      def stop
+        @running = false
+        @thread&.join
+      end
+    end
+
+    class StatusLine
+      def initialize(message)
+        @message = message
+        @running = false
+        @frame = 0
+      end
+
+      def start
+        @running = true
+        @thread = Thread.new do
+          while @running
+            char = SPINNER_FRAMES[@frame % SPINNER_FRAMES.size]
+            styled = Styles.spinner_style.render(char)
+            print "\r\e[K#{styled} #{Styles.dim.render(@message)}"
+            $stdout.flush
+            @frame += 1
+            sleep 0.08
+          end
+        end
+        self
+      end
+
+      def success!(text)
+        finish!
+        display = text.length > 200 ? text[0...200] + Styles.dim.render("... (truncated)") : text
+        puts Styles.success_dot.render("● ") + Styles.label.render("Result: ") + display
+      end
+
+      def error!(text)
+        finish!
+        puts Styles.error_dot.render("● ") + Styles.error.render("Error: ") + text
+      end
+
+      private
+
+      def finish!
+        @running = false
+        @thread&.join
+        print "\r\e[K"
+        $stdout.flush
+      end
+    end
+
+    class << self
+      def thought(text)
+        puts Styles.label.render("Thought: ") + text
+      end
+
+      def code(source)
+        puts
+        highlighted = rouge_formatter.format(rouge_lexer.lex(source))
+        highlighted.each_line { |line| puts "  #{line.rstrip}" }
+        puts
+      end
+
+      def observation(text)
+        puts Styles.label.render("Result: ") + truncate(text, 200)
+      end
+
+      def error(text)
+        puts Styles.error.render("Error: ") + text
+      end
+
+      def status(message)
+        StatusLine.new(message)
+      end
+
+      def plan(text)
+        label = Styles.plan_label.render(" Plan ")
+        body = Styles.plan_box.render(text)
+        puts "\n#{label}\n#{body}\n"
+      end
+
+      def step_metrics(duration:, token_usage:)
+        parts = []
+        parts << format("%.1fs", duration) if duration > 0
+        parts << token_usage.to_s if token_usage
+        return if parts.empty?
+
+        puts Styles.dim.render(parts.join(" | "))
+        puts
+      end
+
+      def run_summary(total_steps:, total_duration:, total_tokens:)
+        parts = ["#{total_steps} #{total_steps == 1 ? "step" : "steps"}", format("%.1fs total", total_duration)]
+        parts << total_tokens.to_s if total_tokens.total_tokens > 0
+        puts Styles.dim.render(parts.join(" | "))
+      end
+
+      def final_answer(text)
+        puts
+        puts Styles.final_answer.render("Final answer: ") + text.to_s
+      end
+
+      def spinner(message)
+        Spinner.new(message)
+      end
+
+      def welcome
+        if LIPGLOSS_AVAILABLE
+          title = Lipgloss::Style.new
+            .bold(true)
+            .foreground("#7B61FF")
+            .render("gemlings")
+
+          version = Styles.dim.render("v#{VERSION}")
+          puts "#{title} #{version}"
+          puts Styles.dim.render("Code-first AI agents for Ruby")
+        else
+          puts "gemlings v#{VERSION}"
+          puts "Code-first AI agents for Ruby"
+        end
+        puts
+      end
+
+      private
+
+      def rouge_lexer
+        @rouge_lexer ||= Rouge::Lexers::Ruby.new
+      end
+
+      def rouge_formatter
+        @rouge_formatter ||= Rouge::Formatters::Terminal256.new(Rouge::Themes::Monokai.new)
+      end
+
+      def truncate(text, max)
+        return text if text.length <= max
+        text[0...max] + Styles.dim.render("... (truncated)")
+      end
+
+    end
+  end
+end

data/lib/gemlings/version.rb

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

data/lib/gemlings.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "gemlings/version"
+require_relative "gemlings/errors"
+
+module Gemlings
+end
+
+require_relative "gemlings/tool"
+require_relative "gemlings/model"
+require_relative "gemlings/models/ruby_llm_adapter"
+require_relative "gemlings/memory"
+require_relative "gemlings/prompt"
+require_relative "gemlings/sandbox"
+require_relative "gemlings/ui"
+require_relative "gemlings/callback"
+require_relative "gemlings/agent"
+require_relative "gemlings/code_agent"
+require_relative "gemlings/tool_calling_agent"
+require_relative "gemlings/mcp"
+require_relative "gemlings/cli"

metadata

@@ -0,0 +1,219 @@
+--- !ruby/object:Gem::Specification
+name: gemlings
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Chris Hasiński
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lipgloss
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: reverse_markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: json-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Agents that write and execute Ruby code. Inspired by smolagents. LLMs
+  write executable code, not JSON blobs.
+email:
+- krzysztof.hasinski@gmail.com
+executables:
+- gemlings
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- ROADMAP.md
+- Rakefile
+- demo.gif
+- examples/custom_tool.rb
+- examples/fibonacci.rb
+- examples/with_tools.rb
+- exe/gemlings
+- gemlings.gemspec
+- lib/gemlings.rb
+- lib/gemlings/agent.rb
+- lib/gemlings/callback.rb
+- lib/gemlings/cli.rb
+- lib/gemlings/code_agent.rb
+- lib/gemlings/errors.rb
+- lib/gemlings/mcp.rb
+- lib/gemlings/memory.rb
+- lib/gemlings/model.rb
+- lib/gemlings/models/ruby_llm_adapter.rb
+- lib/gemlings/prompt.rb
+- lib/gemlings/sandbox.rb
+- lib/gemlings/tool.rb
+- lib/gemlings/tool_calling_agent.rb
+- lib/gemlings/tools/file_read.rb
+- lib/gemlings/tools/file_write.rb
+- lib/gemlings/tools/list_gems.rb
+- lib/gemlings/tools/user_input.rb
+- lib/gemlings/tools/visit_webpage.rb
+- lib/gemlings/tools/web_search.rb
+- lib/gemlings/ui.rb
+- lib/gemlings/version.rb
+homepage: https://github.com/khasinski/gemlings
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/khasinski/gemlings
+  source_code_uri: https://github.com/khasinski/gemlings
+  changelog_uri: https://github.com/khasinski/gemlings/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.2
+specification_version: 4
+summary: A radically simple, code-first AI agent framework for Ruby
+test_files: []