openclacky 0.6.0 → 0.6.2

data/lib/clacky/utils/file_processor.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+require "base64"
+
+module Clacky
+  module Utils
+    # File processing utilities for binary files, images, and PDFs
+    class FileProcessor
+      # Maximum file size for binary files (5MB)
+      MAX_FILE_SIZE = 5 * 1024 * 1024
+
+      # Supported image formats
+      IMAGE_FORMATS = {
+        "png" => "image/png",
+        "jpg" => "image/jpeg",
+        "jpeg" => "image/jpeg",
+        "gif" => "image/gif",
+        "webp" => "image/webp"
+      }.freeze
+
+      # Supported document formats
+      DOCUMENT_FORMATS = {
+        "pdf" => "application/pdf"
+      }.freeze
+
+      # All supported formats
+      SUPPORTED_FORMATS = IMAGE_FORMATS.merge(DOCUMENT_FORMATS).freeze
+
+      # File signatures (magic bytes) for format detection
+      FILE_SIGNATURES = {
+        "\x89PNG\r\n\x1a\n".b => "png",
+        "\xFF\xD8\xFF".b => "jpg",
+        "GIF87a".b => "gif",
+        "GIF89a".b => "gif",
+        "%PDF".b => "pdf"
+      }.freeze
+
+      class << self
+        # Convert image file path to base64 data URL
+        # @param path [String] File path to image
+        # @return [String] base64 data URL (e.g., "data:image/png;base64,...")
+        # @raise [ArgumentError] If file not found or unsupported format
+        def image_path_to_data_url(path)
+          unless File.exist?(path)
+            raise ArgumentError, "Image file not found: #{path}"
+          end
+
+          # Check file size
+          file_size = File.size(path)
+          if file_size > MAX_FILE_SIZE
+            raise ArgumentError, "File too large: #{file_size} bytes (max: #{MAX_FILE_SIZE} bytes)"
+          end
+
+          # Read file as binary
+          image_data = File.binread(path)
+
+          # Detect MIME type from file extension or content
+          mime_type = detect_mime_type(path, image_data)
+
+          # Verify it's an image format
+          unless IMAGE_FORMATS.values.include?(mime_type)
+            raise ArgumentError, "Unsupported image format: #{mime_type}"
+          end
+
+          # Encode to base64
+          base64_data = Base64.strict_encode64(image_data)
+
+          "data:#{mime_type};base64,#{base64_data}"
+        end
+
+        # Convert file to base64 with format detection
+        # @param path [String] File path
+        # @return [Hash] Hash with :format, :mime_type, :base64_data, :size_bytes
+        # @raise [ArgumentError] If file not found or too large
+        def file_to_base64(path)
+          unless File.exist?(path)
+            raise ArgumentError, "File not found: #{path}"
+          end
+
+          # Check file size
+          file_size = File.size(path)
+          if file_size > MAX_FILE_SIZE
+            raise ArgumentError, "File too large: #{file_size} bytes (max: #{MAX_FILE_SIZE} bytes)"
+          end
+
+          # Read file as binary
+          file_data = File.binread(path)
+
+          # Detect format and MIME type
+          format = detect_format(path, file_data)
+          mime_type = detect_mime_type(path, file_data)
+
+          # Encode to base64
+          base64_data = Base64.strict_encode64(file_data)
+
+          {
+            format: format,
+            mime_type: mime_type,
+            base64_data: base64_data,
+            size_bytes: file_size
+          }
+        end
+
+        # Detect file format from path and content
+        # @param path [String] File path
+        # @param data [String] Binary file data
+        # @return [String] Format (e.g., "png", "jpg", "pdf")
+        def detect_format(path, data)
+          # Try to detect from file extension first
+          ext = File.extname(path).downcase.delete_prefix(".")
+          return ext if SUPPORTED_FORMATS.key?(ext)
+
+          # Try to detect from file signature (magic bytes)
+          FILE_SIGNATURES.each do |signature, format|
+            return format if data.start_with?(signature)
+          end
+
+          # Special case for WebP (RIFF format)
+          if data.start_with?("RIFF".b) && data[8..11] == "WEBP".b
+            return "webp"
+          end
+
+          nil
+        end
+
+        # Detect MIME type from file path and content
+        # @param path [String] File path
+        # @param data [String] Binary file data
+        # @return [String] MIME type (e.g., "image/png")
+        def detect_mime_type(path, data)
+          format = detect_format(path, data)
+          return SUPPORTED_FORMATS[format] if format && SUPPORTED_FORMATS[format]
+
+          # Default to application/octet-stream for unknown formats
+          "application/octet-stream"
+        end
+
+        # Check if file is a supported binary format
+        # @param path [String] File path
+        # @return [Boolean] True if supported binary format
+        def supported_binary_file?(path)
+          return false unless File.exist?(path)
+
+          ext = File.extname(path).downcase.delete_prefix(".")
+          SUPPORTED_FORMATS.key?(ext)
+        end
+
+        # Check if file is an image
+        # @param path [String] File path
+        # @return [Boolean] True if image format
+        def image_file?(path)
+          return false unless File.exist?(path)
+
+          ext = File.extname(path).downcase.delete_prefix(".")
+          IMAGE_FORMATS.key?(ext)
+        end
+
+        # Check if file is a PDF
+        # @param path [String] File path
+        # @return [Boolean] True if PDF format
+        def pdf_file?(path)
+          return false unless File.exist?(path)
+
+          ext = File.extname(path).downcase.delete_prefix(".")
+          ext == "pdf"
+        end
+
+        # Check if file is binary (not text)
+        # @param data [String] File content
+        # @param sample_size [Integer] Number of bytes to check (default: 8192)
+        # @return [Boolean] True if file appears to be binary
+        def binary_file?(data, sample_size: 8192)
+          # Check first N bytes for null bytes or high ratio of non-printable characters
+          sample = data[0, sample_size] || ""
+          return false if sample.empty?
+
+          # Check for known binary signatures first
+          FILE_SIGNATURES.each do |signature, _format|
+            return true if sample.start_with?(signature)
+          end
+
+          # Check for WebP (RIFF format)
+          if sample.start_with?("RIFF".b) && sample.length >= 12 && sample[8..11] == "WEBP".b
+            return true
+          end
+
+          # If contains null bytes, it's binary
+          return true if sample.include?("\x00")
+
+          # Count non-printable characters (excluding common whitespace)
+          non_printable = sample.bytes.count do |byte|
+            byte < 32 && ![9, 10, 13].include?(byte) || byte >= 127
+          end
+
+          # If more than 30% non-printable, consider it binary
+          (non_printable.to_f / sample.size) > 0.3
+        end
+      end
+    end
+  end
+end

data/lib/clacky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Clacky
-  VERSION = "0.6.0"
+  VERSION = "0.6.2"
 end

data/scripts/install.sh

@@ -0,0 +1,249 @@
+#!/bin/bash
+# OpenClacky Installation Script
+# This script automatically detects your system and installs OpenClacky
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Print colored messages
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_step() {
+    echo -e "\n${BLUE}==>${NC} $1"
+}
+
+# Detect OS
+detect_os() {
+    case "$(uname -s)" in
+        Linux*)     OS=Linux;;
+        Darwin*)    OS=macOS;;
+        CYGWIN*)    OS=Windows;;
+        MINGW*)     OS=Windows;;
+        *)          OS=Unknown;;
+    esac
+    print_info "Detected OS: $OS"
+}
+
+# Check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Compare version strings
+version_ge() {
+    # Returns 0 (true) if $1 >= $2
+    printf '%s\n%s\n' "$2" "$1" | sort -V -C
+}
+
+# Check Ruby version
+check_ruby() {
+    if command_exists ruby; then
+        RUBY_VERSION=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+        print_info "Found Ruby version: $RUBY_VERSION"
+        
+        if version_ge "$RUBY_VERSION" "3.1.0"; then
+            print_success "Ruby version is compatible (>= 3.1.0)"
+            return 0
+        else
+            print_warning "Ruby version $RUBY_VERSION is too old (need >= 3.1.0)"
+            return 1
+        fi
+    else
+        print_warning "Ruby is not installed"
+        return 1
+    fi
+}
+
+# Install via Homebrew
+install_via_homebrew() {
+    print_step "Installing via Homebrew..."
+    
+    if ! command_exists brew; then
+        print_error "Homebrew is not installed"
+        print_info "Install Homebrew from: https://brew.sh"
+        return 1
+    fi
+    
+    print_info "Adding OpenClacky tap..."
+    brew tap clacky-ai/openclacky 2>/dev/null || {
+        print_warning "Tap not found or already added, trying direct installation..."
+    }
+    
+    print_info "Installing OpenClacky..."
+    brew install openclacky
+    
+    if [ $? -eq 0 ]; then
+        print_success "OpenClacky installed successfully via Homebrew!"
+        return 0
+    else
+        print_error "Homebrew installation failed"
+        return 1
+    fi
+}
+
+# Install via RubyGems
+install_via_gem() {
+    print_step "Installing via RubyGems..."
+    
+    if ! command_exists gem; then
+        print_error "RubyGems is not available"
+        return 1
+    fi
+    
+    print_info "Installing OpenClacky gem..."
+    gem install openclacky
+    
+    if [ $? -eq 0 ]; then
+        print_success "OpenClacky installed successfully via gem!"
+        return 0
+    else
+        print_error "Gem installation failed"
+        return 1
+    fi
+}
+
+# Suggest Ruby installation
+suggest_ruby_installation() {
+    print_step "Ruby Installation Options"
+    echo ""
+    
+    if [ "$OS" = "macOS" ]; then
+        print_info "Option 1: Install Ruby via Homebrew (Recommended)"
+        echo "  brew install ruby@3.3"
+        echo "  export PATH=\"/usr/local/opt/ruby@3.3/bin:\$PATH\""
+        echo ""
+        print_info "Option 2: Use rbenv"
+        echo "  brew install rbenv ruby-build"
+        echo "  rbenv install 3.3.0"
+        echo "  rbenv global 3.3.0"
+        
+    elif [ "$OS" = "Linux" ]; then
+        print_info "Option 1: Use rbenv"
+        echo "  curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-installer | bash"
+        echo "  rbenv install 3.3.0"
+        echo "  rbenv global 3.3.0"
+        echo ""
+        print_info "Option 2: Use RVM"
+        echo "  curl -sSL https://get.rvm.io | bash -s stable --ruby"
+        echo ""
+        print_info "Option 3: Use system package manager"
+        echo "  # Ubuntu/Debian:"
+        echo "  sudo apt-get update"
+        echo "  sudo apt-get install ruby-full"
+        echo ""
+        echo "  # Fedora:"
+        echo "  sudo dnf install ruby ruby-devel"
+    fi
+    
+    echo ""
+    print_info "After installing Ruby, run this script again or use:"
+    echo "  gem install openclacky"
+}
+
+
+
+# Main installation logic
+main() {
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║   🤖 OpenClacky Installation Script                      ║"
+    echo "║                                                           ║"
+    echo "║   AI Agent CLI with Tool Use Capabilities                ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+    
+    detect_os
+    
+    # Strategy 1: On macOS, try Homebrew first if available
+    if [ "$OS" = "macOS" ] && command_exists brew; then
+        print_info "Homebrew detected, using it for installation (recommended)"
+        if install_via_homebrew; then
+            show_post_install_info
+            exit 0
+        fi
+        print_warning "Homebrew installation failed, trying Ruby gem installation..."
+    fi
+    
+    # Strategy 2: Check Ruby and install via gem
+    if check_ruby; then
+        if install_via_gem; then
+            show_post_install_info
+            exit 0
+        fi
+    fi
+    
+    # Strategy 3: Suggest installation options
+    print_error "Could not install OpenClacky automatically"
+    echo ""
+    print_step "Available Installation Options:"
+    echo ""
+    
+    if [ "$OS" = "macOS" ]; then
+        if ! command_exists brew; then
+            print_info "Option 1: Install via Homebrew (Recommended)"
+            echo "  If you have Homebrew, install it from: https://brew.sh"
+            echo "  Then run:"
+            echo "    brew tap clacky-ai/openclacky"
+            echo "    brew install openclacky"
+            echo ""
+        fi
+    fi
+    
+    suggest_ruby_installation
+    echo ""
+    
+    print_info "For more information, visit: https://github.com/clacky-ai/open-clacky"
+    exit 1
+}
+
+# Post-installation information
+show_post_install_info() {
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║   ✨ OpenClacky Installed Successfully!                   ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+    print_step "Quick Start Guide:"
+    echo ""
+    print_info "1. Configure your API key:"
+    echo "   clacky config set"
+    echo ""
+    print_info "2. Start chatting:"
+    echo "   clacky chat"
+    echo ""
+    print_info "3. Use AI agent mode:"
+    echo "   clacky agent"
+    echo ""
+    print_info "4. Get help:"
+    echo "   clacky help"
+    echo ""
+    print_success "Happy coding! 🚀"
+    echo ""
+}
+
+# Run main installation
+main

data/scripts/uninstall.sh

@@ -0,0 +1,146 @@
+#!/bin/bash
+# OpenClacky Uninstallation Script
+# This script removes OpenClacky from your system
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_step() {
+    echo -e "\n${BLUE}==>${NC} $1"
+}
+
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Check if OpenClacky is installed
+check_installation() {
+    if command_exists clacky || command_exists openclacky; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+# Uninstall via Homebrew
+uninstall_homebrew() {
+    if command_exists brew; then
+        if brew list openclacky >/dev/null 2>&1; then
+            print_step "Uninstalling via Homebrew..."
+            brew uninstall openclacky
+            
+            # Optionally untap
+            if brew tap | grep -q "clacky-ai/openclacky"; then
+                read -p "$(echo -e ${YELLOW}?${NC}) Remove Homebrew tap (clacky-ai/openclacky)? [y/N] " -n 1 -r
+                echo
+                if [[ $REPLY =~ ^[Yy]$ ]]; then
+                    brew untap clacky-ai/openclacky
+                    print_success "Tap removed"
+                fi
+            fi
+            
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Uninstall via gem
+uninstall_gem() {
+    if command_exists gem; then
+        if gem list -i openclacky >/dev/null 2>&1; then
+            print_step "Uninstalling via RubyGems..."
+            gem uninstall openclacky -x
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Remove configuration files
+remove_config() {
+    CONFIG_DIR="$HOME/.clacky"
+    
+    if [ -d "$CONFIG_DIR" ]; then
+        print_warning "Configuration directory found: $CONFIG_DIR"
+        read -p "$(echo -e ${YELLOW}?${NC}) Remove configuration files (including API keys)? [y/N] " -n 1 -r
+        echo
+        
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            rm -rf "$CONFIG_DIR"
+            print_success "Configuration removed"
+        else
+            print_info "Configuration preserved at: $CONFIG_DIR"
+        fi
+    fi
+}
+
+# Main uninstallation
+main() {
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║   🗑️  OpenClacky Uninstallation                          ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+    
+    if ! check_installation; then
+        print_warning "OpenClacky does not appear to be installed"
+        exit 0
+    fi
+    
+    UNINSTALLED=false
+    
+    # Try Homebrew first
+    if uninstall_homebrew; then
+        UNINSTALLED=true
+    fi
+    
+    # Try gem
+    if uninstall_gem; then
+        UNINSTALLED=true
+    fi
+    
+    if [ "$UNINSTALLED" = false ]; then
+        print_error "Could not automatically uninstall OpenClacky"
+        print_info "You may need to uninstall manually:"
+        echo "  - Via Homebrew: brew uninstall openclacky"
+        echo "  - Via RubyGems: gem uninstall openclacky"
+        exit 1
+    fi
+    
+    print_success "OpenClacky uninstalled successfully"
+    
+    # Ask about config removal
+    remove_config
+    
+    echo ""
+    print_success "Uninstallation complete!"
+    print_info "Thank you for using OpenClacky 👋"
+    echo ""
+}
+
+main

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.2
 platform: ruby
 authors:
 - windy
@@ -107,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: tty-markdown
+  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: base64
   requirement: !ruby/object:Gem::Requirement
@@ -145,6 +159,8 @@ files:
 - clacky-legacy/clacky.gemspec
 - clacky-legacy/clarky.gemspec
 - docs/ui2-architecture.md
+- homebrew/README.md
+- homebrew/openclacky.rb
 - lib/clacky.rb
 - lib/clacky/agent.rb
 - lib/clacky/agent_config.rb
@@ -179,12 +195,12 @@ files:
 - lib/clacky/ui2/components/inline_input.rb
 - lib/clacky/ui2/components/input_area.rb
 - lib/clacky/ui2/components/message_component.rb
-- lib/clacky/ui2/components/output_area.rb
 - lib/clacky/ui2/components/todo_area.rb
 - lib/clacky/ui2/components/tool_component.rb
 - lib/clacky/ui2/components/welcome_banner.rb
 - lib/clacky/ui2/layout_manager.rb
 - lib/clacky/ui2/line_editor.rb
+- lib/clacky/ui2/markdown_renderer.rb
 - lib/clacky/ui2/screen_buffer.rb
 - lib/clacky/ui2/theme_manager.rb
 - lib/clacky/ui2/themes/base_theme.rb
@@ -194,9 +210,12 @@ files:
 - lib/clacky/ui2/view_renderer.rb
 - lib/clacky/utils/arguments_parser.rb
 - lib/clacky/utils/file_ignore_helper.rb
+- lib/clacky/utils/file_processor.rb
 - lib/clacky/utils/limit_stack.rb
 - lib/clacky/utils/path_helper.rb
 - lib/clacky/version.rb
+- scripts/install.sh
+- scripts/uninstall.sh
 - sig/clacky.rbs
 homepage: https://github.com/yafeilee/clacky
 licenses: