slk 0.4.0 → 0.4.2

data/lib/slk/support/inline_images.rb

@@ -2,11 +2,17 @@
 
 module Slk
   module Support
-    # Shared module for inline image display in iTerm2/WezTerm/Mintty terminals
+    # Shared module for inline image display in terminals supporting
+    # iTerm2 protocol (iTerm2/WezTerm/Mintty) or Kitty graphics protocol (Ghostty/Kitty)
     # Includes special handling for tmux passthrough sequences
     module InlineImages
-      # Check if terminal supports iTerm2 inline image protocol
+      # Check if terminal supports any inline image protocol
       def inline_images_supported?
+        iterm2_protocol_supported? || kitty_graphics_supported?
+      end
+
+      # Check if terminal supports iTerm2 inline image protocol
+      def iterm2_protocol_supported?
         # iTerm2, WezTerm, Mintty support inline images
         # LC_TERMINAL persists through tmux/ssh
         ['iTerm.app', 'WezTerm'].include?(ENV.fetch('TERM_PROGRAM', nil)) ||
@@ -15,31 +21,88 @@ module Slk
           ENV['TERM'] == 'mintty'
       end
 
+      # Check if terminal supports Kitty graphics protocol (Ghostty, Kitty)
+      def kitty_graphics_supported?
+        ENV['TERM_PROGRAM'] == 'ghostty' ||
+          ENV['GHOSTTY_RESOURCES_DIR'] ||
+          ENV['TERM']&.include?('kitty') ||
+          tmux_client_is_kitty_compatible?
+      end
+
+      # Check if tmux client terminal supports Kitty graphics
+      def tmux_client_is_kitty_compatible?
+        return false unless in_tmux?
+
+        @tmux_client_is_kitty_compatible ||= begin
+          output = begin
+            `tmux display-message -p '\#{client_termname}'`.chomp
+          rescue StandardError
+            ''
+          end
+          output.include?('ghostty') || output.include?('kitty')
+        end
+      end
+
       # Check if running inside tmux
       def in_tmux?
         # tmux sets TERM to screen-* or tmux-*
         ENV['TERM']&.include?('screen') || ENV['TERM']&.start_with?('tmux')
       end
 
-      # Print an inline image using iTerm2 protocol
+      # Print an inline image using the appropriate protocol
       # In tmux, uses passthrough sequence and cursor positioning
       def print_inline_image(path, height: 1)
-        data = read_image_data(path)
+        data = read_image_data_for_protocol(path)
         return unless data
 
         encoded = [data].pack('m0')
-        in_tmux? ? print_tmux_image(encoded, height) : print_iterm_image(encoded, height)
+
+        if kitty_graphics_supported?
+          in_tmux? ? print_tmux_kitty_image(encoded, height) : print_kitty_image(encoded, height)
+        else
+          in_tmux? ? print_tmux_iterm_image(encoded, height) : print_iterm_image(encoded, height)
+        end
       end
 
-      def read_image_data(path)
+      def read_image_data_for_protocol(path)
         return nil unless File.exist?(path)
 
-        File.binread(path)
+        data = File.binread(path)
+        return nil unless data
+
+        # Kitty protocol requires PNG format; convert GIF/JPEG if needed
+        if kitty_graphics_supported? && !png_data?(data)
+          convert_to_png(path)
+        else
+          data
+        end
       rescue IOError, SystemCallError
         nil
       end
 
-      def print_tmux_image(encoded, height)
+      def png_data?(data)
+        # PNG files start with magic bytes: 137 80 78 71 13 10 26 10
+        data[0, 8]&.bytes == [137, 80, 78, 71, 13, 10, 26, 10]
+      end
+
+      def convert_to_png(path)
+        # Use sips (macOS) to convert to PNG
+        require 'tempfile'
+        temp = Tempfile.new(['emoji', '.png'])
+        temp.close
+
+        system('sips', '-s', 'format', 'png', path, '--out', temp.path,
+               out: File::NULL, err: File::NULL)
+
+        return nil unless File.exist?(temp.path) && File.size(temp.path).positive?
+
+        File.binread(temp.path)
+      ensure
+        temp&.unlink
+      end
+
+      # iTerm2 protocol methods
+      def print_tmux_iterm_image(encoded, height)
         fmt = "\ePtmux;\e\e]1337;File=inline=1;preserveAspectRatio=0;" \
               "size=%<size>d;height=%<height>d:%<data>s\a\e\\\n "
         printf fmt, size: encoded.length, height: height, data: encoded
@@ -49,6 +112,26 @@ module Slk
         printf "\e]1337;File=inline=1;height=%<height>d:%<data>s\a", height: height, data: encoded
       end
 
+      # Kitty graphics protocol methods (Ghostty, Kitty)
+      # a=T: transmit and display, q=1: suppress OK response, f=100: PNG, r=rows, m=0: no more chunks
+      def print_kitty_image(encoded, height)
+        printf "\e_Ga=T,q=1,f=100,r=%<height>d,m=0;%<data>s\e\\", height: height, data: encoded
+      end
+
+      # Kitty graphics with Unicode placeholders for tmux (images clear/scroll with text)
+      # See: https://sw.kovidgoyal.net/kitty/graphics-protocol/#unicode-placeholders
+      def print_tmux_kitty_image(encoded, _height)
+        @kitty_image_id ||= 30
+        @kitty_image_id = (@kitty_image_id % 255) + 1
+        image_id = @kitty_image_id
+
+        # tmux passthrough: transmit image with Unicode placeholder mode (U=1), 2 cols x 1 row
+        $stdout.print "\ePtmux;\e\e_Ga=T,U=1,q=1,f=100,i=#{image_id},c=2,r=1,m=0;#{encoded}\e\e\\\e\\"
+        # Output placeholder cells (U+10EEEE + row/col diacritics) with foreground color = image_id
+        $stdout.print "\e[38;5;#{image_id}m\u{10EEEE}\u0305\u0305\u{10EEEE}\u0305\u030D\e[39m"
+        $stdout.flush
+      end
+
       # Print inline image with name on same line
       # Handles tmux cursor positioning to keep image and text on same line
       def print_inline_image_with_text(path, text, height: 1) # rubocop:disable Naming/PredicateMethod
@@ -56,11 +139,12 @@ module Slk
 
         print_inline_image(path, height: height)
 
-        if in_tmux?
-          # tmux: image ends with \n + space, cursor on next line
+        if in_tmux? && !kitty_graphics_supported?
+          # iTerm2 in tmux: image ends with \n + space, cursor on next line
           # Move up 1 line, right 3 cols (past image), then print text
           print "\e[1A\e[3C#{text}\n"
         else
+          # Direct output or Unicode placeholders (regular text, just print after)
           puts " #{text}"
         end
 

data/lib/slk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Slk
-  VERSION = '0.4.0'
+  VERSION = '0.4.2'
 end

data/lib/slk.rb

@@ -33,6 +33,7 @@ module Slk
     autoload :Channel, 'slk/models/channel'
     autoload :Preset, 'slk/models/preset'
     autoload :SearchResult, 'slk/models/search_result'
+    autoload :SavedItem, 'slk/models/saved_item'
   end
 
   # Application services for configuration, caching, and API communication
@@ -54,11 +55,13 @@ module Slk
     autoload :TargetResolver, 'slk/services/target_resolver'
     autoload :SetupWizard, 'slk/services/setup_wizard'
     autoload :UserLookup, 'slk/services/user_lookup'
+    autoload :MessageResolver, 'slk/services/message_resolver'
   end
 
   # Output formatters for messages, durations, and emoji
   module Formatters
     autoload :Output, 'slk/formatters/output'
+    autoload :MarkdownOutput, 'slk/formatters/markdown_output'
     autoload :DurationFormatter, 'slk/formatters/duration_formatter'
     autoload :MentionReplacer, 'slk/formatters/mention_replacer'
     autoload :EmojiReplacer, 'slk/formatters/emoji_replacer'
@@ -69,6 +72,8 @@ module Slk
     autoload :AttachmentFormatter, 'slk/formatters/attachment_formatter'
     autoload :BlockFormatter, 'slk/formatters/block_formatter'
     autoload :SearchFormatter, 'slk/formatters/search_formatter'
+    autoload :SavedItemFormatter, 'slk/formatters/saved_item_formatter'
+    autoload :TextProcessor, 'slk/formatters/text_processor'
   end
 
   # CLI commands implementing user-facing functionality
@@ -89,6 +94,7 @@ module Slk
     autoload :Emoji, 'slk/commands/emoji'
     autoload :Config, 'slk/commands/config'
     autoload :Help, 'slk/commands/help'
+    autoload :Later, 'slk/commands/later'
   end
 
   # Thin wrappers around Slack API endpoints
@@ -103,6 +109,7 @@ module Slk
     autoload :Usergroups, 'slk/api/usergroups'
     autoload :Activity, 'slk/api/activity'
     autoload :Search, 'slk/api/search'
+    autoload :Saved, 'slk/api/saved'
   end
 
   # Utility classes for paths, parsing, and helpers

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slk
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Eric Boehs
@@ -32,6 +32,7 @@ files:
 - lib/slk/api/conversations.rb
 - lib/slk/api/dnd.rb
 - lib/slk/api/emoji.rb
+- lib/slk/api/saved.rb
 - lib/slk/api/search.rb
 - lib/slk/api/threads.rb
 - lib/slk/api/usergroups.rb
@@ -45,6 +46,7 @@ files:
 - lib/slk/commands/dnd.rb
 - lib/slk/commands/emoji.rb
 - lib/slk/commands/help.rb
+- lib/slk/commands/later.rb
 - lib/slk/commands/messages.rb
 - lib/slk/commands/presence.rb
 - lib/slk/commands/preset.rb
@@ -60,16 +62,20 @@ files:
 - lib/slk/formatters/duration_formatter.rb
 - lib/slk/formatters/emoji_replacer.rb
 - lib/slk/formatters/json_message_formatter.rb
+- lib/slk/formatters/markdown_output.rb
 - lib/slk/formatters/mention_replacer.rb
 - lib/slk/formatters/message_formatter.rb
 - lib/slk/formatters/output.rb
 - lib/slk/formatters/reaction_formatter.rb
+- lib/slk/formatters/saved_item_formatter.rb
 - lib/slk/formatters/search_formatter.rb
+- lib/slk/formatters/text_processor.rb
 - lib/slk/models/channel.rb
 - lib/slk/models/duration.rb
 - lib/slk/models/message.rb
 - lib/slk/models/preset.rb
 - lib/slk/models/reaction.rb
+- lib/slk/models/saved_item.rb
 - lib/slk/models/search_result.rb
 - lib/slk/models/status.rb
 - lib/slk/models/user.rb
@@ -83,6 +89,7 @@ files:
 - lib/slk/services/emoji_searcher.rb
 - lib/slk/services/encryption.rb
 - lib/slk/services/gemoji_sync.rb
+- lib/slk/services/message_resolver.rb
 - lib/slk/services/preset_store.rb
 - lib/slk/services/reaction_enricher.rb
 - lib/slk/services/setup_wizard.rb
@@ -111,12 +118,6 @@ metadata:
   source_code_uri: https://github.com/ericboehs/slk
   changelog_uri: https://github.com/ericboehs/slk/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message: |
-  slk 0.2.0: Config directory changed from slack-cli to slk
-
-  If upgrading from 0.1.x, migrate your config:
-    mv ${XDG_CONFIG_HOME:-~/.config}/slack-cli ${XDG_CONFIG_HOME:-~/.config}/slk
-    mv ${XDG_CACHE_HOME:-~/.cache}/slack-cli ${XDG_CACHE_HOME:-~/.cache}/slk
 rdoc_options: []
 require_paths:
 - lib