kward 0.81.0 → 0.82.0

data/lib/kward/terminal_image_support.rb

@@ -0,0 +1,116 @@
+require_relative "terminal_sequences"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Terminal capability detection for inline image protocols.
+  module TerminalImageSupport
+    KITTY = :kitty
+    ITERM2 = :iterm2
+    PROBE_TIMEOUT = 0.3
+    KITTY_PROBE = "#{TerminalSequences.kitty_query}\e[c".freeze
+    KITTY_OK_RESPONSE = "\e_Gi=31;OK\e\\".freeze
+    DA1_RESPONSE_PATTERN = /\e\[\?[0-9;]*c/.freeze
+
+    module_function
+
+    def detect(env: ENV, input: nil, output: nil, timeout: PROBE_TIMEOUT, probe_result: :auto)
+      return static_protocol(env) if input.nil? && output.nil? && probe_result == :auto
+      return nil unless tty?(input) && tty?(output)
+
+      probe_result = probe_kitty(input, output, env: env, timeout: timeout) if probe_result == :auto
+      return KITTY if probe_result == true
+
+      fallback = static_protocol(env)
+      return fallback if probe_result.nil? || fallback
+
+      nil
+    end
+
+    def static_protocol(env)
+      return KITTY if kitty_hint?(env)
+      return ITERM2 if iterm2_hint?(env)
+
+      nil
+    end
+
+    def probe_kitty(input, output, env: ENV, timeout: PROBE_TIMEOUT)
+      return nil unless tty?(input) && tty?(output)
+      return nil unless input.respond_to?(:raw)
+      return nil unless output.respond_to?(:write) && output.respond_to?(:flush)
+
+      query = env["TMUX"].to_s.empty? ? KITTY_PROBE : TerminalSequences.tmux_passthrough(KITTY_PROBE)
+      input.raw do
+        output.write(query)
+        output.flush
+        read_probe_response(input, timeout: timeout)
+      end
+    rescue StandardError
+      nil
+    end
+
+    def read_probe_response(input, timeout: PROBE_TIMEOUT)
+      buffer = +""
+      deadline = monotonic_now + timeout.to_f
+      loop do
+        break if da1_response?(buffer)
+
+        remaining = deadline - monotonic_now
+        break if remaining <= 0
+
+        ready = IO.select([input], nil, nil, remaining)
+        break unless ready
+
+        chunk = input.read_nonblock(256, exception: false)
+        break if chunk == :wait_readable || chunk.nil? || chunk.empty?
+
+        buffer << chunk
+      end
+
+      kitty_probe_success?(buffer)
+    rescue IOError, SystemCallError
+      false
+    end
+
+    def kitty_probe_success?(response)
+      da1_response?(response) && response.to_s.include?(KITTY_OK_RESPONSE)
+    end
+
+    def da1_response?(response)
+      response.to_s.match?(DA1_RESPONSE_PATTERN)
+    end
+
+    def kitty_hint?(env)
+      value = normalized_environment(env)
+      return true if value["KITTY_WINDOW_ID"] && !value["KITTY_WINDOW_ID"].empty?
+
+      program = value.fetch("TERM_PROGRAM", "")
+      term = value.fetch("TERM", "")
+      program == "kitty" || program == "ghostty" || term.include?("kitty") || term.include?("ghostty")
+    end
+
+    def iterm2_hint?(env)
+      value = normalized_environment(env)
+      program = value.fetch("TERM_PROGRAM", "")
+      return true if program == "iterm.app" || program == "wezterm"
+      return true if value.fetch("TERM_FEATURES", "").include?("f")
+
+      value["WEZTERM_PANE"] && !value["WEZTERM_PANE"].empty?
+    end
+
+    def normalized_environment(env)
+      env.to_h.each_with_object({}) do |(key, value), normalized|
+        normalized[key.to_s] = value.to_s.strip.downcase
+      end
+    end
+
+    def tty?(io)
+      io.respond_to?(:tty?) && io.tty?
+    rescue IOError, SystemCallError
+      false
+    end
+
+    def monotonic_now
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
+  end
+end

data/lib/kward/terminal_sequences.rb

@@ -18,6 +18,7 @@ module Kward
     CURSOR_SHAPE_BAR = "\e[6 q".freeze
     MOUSE_REPORTING_ENABLE = "\e[?1003h\e[?1006h".freeze
     MOUSE_REPORTING_DISABLE = "\e[?1006l\e[?1003l".freeze
+    SGR_RESET = "\e[0m".freeze
     SGR_INVERSE = "\e[7m".freeze
     SGR_INVERSE_OFF = "\e[27m".freeze
 
@@ -35,8 +36,50 @@ module Kward
       "\e[#{row};#{col}H"
     end
 
+    def move_to_column(column)
+      "\e[#{column}G"
+    end
+
     def osc52(text)
       "\e]52;c;#{Base64.strict_encode64(text.to_s)}\a"
     end
+
+    def kitty_graphics(data, image_id:, columns: nil, rows: nil, move_cursor: true)
+      payload = data.to_s
+      chunks = payload.scan(/.{1,4096}/m)
+      chunks = [""] if chunks.empty?
+
+      chunks.each_with_index.map do |chunk, index|
+        more = index < chunks.length - 1 ? 1 : 0
+        params = index.zero? ? ["a=T", "f=100", "t=d"] : []
+        params << "i=#{image_id}" if index.zero? && image_id
+        params << "c=#{columns.to_i}" if index.zero? && columns
+        params << "r=#{rows.to_i}" if index.zero? && rows
+        params << "C=1" if index.zero? && !move_cursor
+        params << "q=2" if index == chunks.length - 1
+        params << "m=#{more}"
+        "\e_G#{params.join(",")};#{chunk}\e\\"
+      end.join
+    end
+
+    def kitty_query(image_id = 31)
+      "\e_Gi=#{image_id},s=1,v=1,a=q,t=d,f=24;AAAA\e\\"
+    end
+
+    def kitty_delete(image_id)
+      "\e_Ga=d,d=I,i=#{image_id},q=2;\e\\"
+    end
+
+    def tmux_passthrough(sequence)
+      "\ePtmux;#{sequence.to_s.gsub("\e", "\e\e")}\e\\"
+    end
+
+    def iterm2_image(data, name: nil, width: nil, height: nil)
+      params = ["inline=1", "preserveAspectRatio=1"]
+      params << "width=#{width}" if width
+      params << "height=#{height}" if height
+      params << "name=#{Base64.strict_encode64(File.basename(name))}" if name
+      "\e]1337;File=#{params.join(";")}:#{data}\a"
+    end
   end
 end

data/lib/kward/version.rb

@@ -1,5 +1,5 @@
 # Namespace for the Kward CLI agent runtime.
 module Kward
   # Current gem version.
-  VERSION = "0.81.0"
+  VERSION = "0.82.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kward
 version: !ruby/object:Gem::Version
-  version: 0.81.0
+  version: 0.82.0
 platform: ruby
 authors:
 - Kai Wood
@@ -116,8 +116,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/ci.yml"
-- ".github/workflows/pages.yml"
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
@@ -170,6 +168,7 @@ files:
 - exe/kward
 - kward.gemspec
 - lib/kward.rb
+- lib/kward/adaptive_pty_output_sink.rb
 - lib/kward/agent.rb
 - lib/kward/ansi.rb
 - lib/kward/auth/anthropic_oauth.rb
@@ -315,6 +314,8 @@ files:
 - lib/kward/prompts.rb
 - lib/kward/prompts/commands.rb
 - lib/kward/prompts/templates.rb
+- lib/kward/pty_output_sink.rb
+- lib/kward/pty_transcript_normalizer.rb
 - lib/kward/question_contract.rb
 - lib/kward/rpc/attachment_normalizer.rb
 - lib/kward/rpc/auth_manager.rb
@@ -346,6 +347,7 @@ files:
 - lib/kward/sandbox/runner_factory.rb
 - lib/kward/sandbox/unavailable_runner.rb
 - lib/kward/scratchpad_runner.rb
+- lib/kward/session_catalog.rb
 - lib/kward/session_diff.rb
 - lib/kward/session_naming.rb
 - lib/kward/session_store.rb
@@ -363,6 +365,7 @@ files:
 - lib/kward/tab_store.rb
 - lib/kward/telemetry/logger.rb
 - lib/kward/telemetry/stats.rb
+- lib/kward/terminal_image_support.rb
 - lib/kward/terminal_keys.rb
 - lib/kward/terminal_sequences.rb
 - lib/kward/text_boundary.rb
@@ -436,7 +439,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.6.9
 specification_version: 4
 summary: An extendable Ruby CLI coding agent.
 test_files: []

data/.github/workflows/ci.yml

@@ -1,48 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby-version: ['3.4', 'ruby']
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby-version }}
-          bundler-cache: true
-
-      - name: Install sandbox test dependency
-        run: sudo apt-get update && sudo apt-get install --yes bubblewrap
-
-      - name: Enable Bubblewrap namespaces
-        run: |
-          sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
-          sudo sysctl -w kernel.unprivileged_userns_clone=1
-          bwrap --ro-bind / / --unshare-net true
-
-      - name: Check syntax
-        run: find lib test -name '*.rb' -print0 | xargs -0 ruby -c
-
-      - name: Check runtime warnings
-        run: bundle exec ruby -w -Ilib -e 'require "kward"'
-
-      - name: Run tests
-        env:
-          KWARD_RUN_BUBBLEWRAP_TESTS: "1"
-        run: bundle exec rake test

data/.github/workflows/pages.yml

@@ -1,48 +0,0 @@
-name: Deploy documentation
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: pages
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.4'
-          bundler-cache: true
-
-      - name: Build documentation
-        run: bundle exec rake docs:build
-
-      - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: _yardoc
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4