tui-td 0.2.8 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebeda13c1510dfd65ec0dd5e45a330ed9100c3dd5a0919dfcedb13340e01a280
-  data.tar.gz: fe33d4368ae7b516f18b7cc30974124408214dbd116f6e300986b05a967e4835
+  metadata.gz: 3eb2dc4db4af2ddbcbe377f8a3d6bddf8e1a45f3c78c85a25d8480d1e740e9f7
+  data.tar.gz: 31a65006ceb299ba4487446932bf74305ecb92d4241288f82d7d11a0283e6bf6
 SHA512:
-  metadata.gz: f1c7051f157319f46d96f371654d276ada570e2aea06d4871659cf989734f5c3d65c0da163a23d56ebb844d3c3cb3b5087b6fcc60f8dcebfdbec0d35ab317720
-  data.tar.gz: 2f74615955a3434efe4d06427099ae18eca2c43bdefe93b6c8b2465ebb2eb28f84024ecbcfcbda39cedec4e5ac0373141d6f6ec0ac31aff6a64f7cf8b9ebb781
+  metadata.gz: 706d849d8c35380fabf149bcf6cee5441d92a71b228d7ac4bc0bbba3852be4443496d9d6ae79afd15daa5217b9ede798d6ce2d15dee2cbeb5f6a0901b5269722
+  data.tar.gz: 9595ce52cd78959dfb49f314d3272d6cf2c065dd215467e204c862b48da2a88525ab8a9dad0ab98ccdd7b7fc142e700eab4ca65ea6a8c2b90d53aefbe8eca922

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## 0.2.10
+
+- Three new MCP tools: `tui_wait_for_exit` (wait for process to end), `tui_exit_status` (get exit code), `tui_find_text` (search terminal state for text/regex matches)
+- Document `tui_html_render` MCP tool in README (was already implemented but missing from docs)
+- Smoke test expanded to 63 assertions covering all 13 MCP tools including new ones
+
+## 0.2.9
+
+- Fix: `wait_for_stable` uses parsed terminal grid comparison instead of raw byte arrival, preventing interactive TUIs that repaint cell-by-cell (e.g., glow) from timing out
+- Fix: `cmd_capture` catches timeout for interactive TUIs and proceeds with whatever was rendered
+- New tests for `driver.rb` (39), `cli.rb` (19), and `mcp/server.rb` (27) — 85 new tests total
+
+## 0.2.8
+
+- Unicode bitmap font in screenshot renderer: 2766 glyphs from GNU Unifont 17.0.04 covering Latin, Greek, Cyrillic, Arabic, Turkish, Math, Arrows, Box Drawing, Symbols, and Dingbats
+- Cairo renderer as optional fallback for characters not in Unifont (e.g. CJK), with 3x supersampling and box-filter downsampling for sharp edges
+- Rendering priority: Spleen (ASCII 33–126) → Unifont (127+, 2766 glyphs) → Cairo (fallback)
+- Full test coverage for Unifont glyphs and Cairo renderer
+
 ## 0.2.7
 
 - Screenshot rendering for 23 special characters: blocks (▀ ▄ █), triangles (▲ ▼), arrows (↑ ↓ → ←), half blocks (▌ ▐)

data/README.md

@@ -369,6 +369,10 @@ tui-td serve
 | `tui_state` | Get terminal state: AI-friendly compact mode (default), `full` grid, or `text` only. |
 | `tui_plain_text` | Get plain text content, ANSI stripped. |
 | `tui_screenshot` | Capture a PNG screenshot of the current terminal. |
+| `tui_html_render` | Render terminal state as a self-contained HTML document. Returns HTML inline or saves to file. |
+| `tui_wait_for_exit` | Wait until the TUI process exits. Returns exit status. |
+| `tui_exit_status` | Get the exit status code (nil if still running). |
+| `tui_find_text` | Search for text or regex in terminal state. Returns positions of all matches. |
 | `tui_close` | Close the TUI and clean up. |
 
 ### MCP configuration
@@ -407,7 +411,18 @@ Add to your MCP client configuration:
 // 6. Take screenshot if needed
 {"method": "tools/call", "params": {"name": "tui_screenshot", "arguments": {"path": "/tmp/proof.png"}}}
 
-// 7. Clean up
+// 7. Render as HTML (save to file or get inline)
+{"method": "tools/call", "params": {"name": "tui_html_render", "arguments": {"path": "/tmp/proof.html"}}}
+// Or without path to get HTML inline:
+// {"method": "tools/call", "params": {"name": "tui_html_render", "arguments": {}}}
+
+// 8. Search for text in the terminal
+{"method": "tools/call", "params": {"name": "tui_find_text", "arguments": {"pattern": "error|fail"}}}
+
+// 9. Check exit status (or wait for exit)
+{"method": "tools/call", "params": {"name": "tui_exit_status", "arguments": {}}}
+
+// 10. Clean up
 {"method": "tools/call", "params": {"name": "tui_close", "arguments": {}}}
 ```
 

data/lib/tui_td/cli.rb

@@ -211,8 +211,18 @@ module TUITD
       cmd = args.join(" ")
 
       driver = Driver.new(cmd, **globals.slice(:rows, :cols, :timeout, :chdir))
-      driver.start
-      driver.wait_for_stable
+      begin
+        driver.start
+      rescue TimeoutError
+        # Interactive TUI that never stabilizes (e.g., glow without -p).
+        # Proceed with whatever was rendered before the timeout.
+        driver.refresh
+      end
+      begin
+        driver.wait_for_stable
+      rescue TimeoutError
+        # Ignored — already have rendered state from start
+      end
 
       case globals[:format]
       when :json

data/lib/tui_td/driver.rb

@@ -96,17 +96,28 @@ module TUITD
       refresh_state!
     end
 
-    # Wait for output to stabilize (no new data for N milliseconds)
+    # Wait for output to stabilize (grid content unchanged for N milliseconds)
     def wait_for_stable(stable_ms: 300)
       deadline = monotonic + @timeout
       last_change = monotonic
+      last_grid = nil
 
       loop do
         raise TimeoutError, "Timeout waiting for stable output" if monotonic > deadline
 
-        if read_available!
-          last_change = monotonic
-        elsif (monotonic - last_change) * 1000 >= stable_ms
+        had_data = read_available!
+        process_alive = process_alive?
+
+        if had_data
+          current_grid = parse_grid_snapshot
+          if current_grid != last_grid
+            last_grid = current_grid
+            last_change = monotonic
+          end
+        elsif !process_alive
+          # Process exited and no more data — final state reached
+          break
+        elsif last_grid && (monotonic - last_change) * 1000 >= stable_ms
           break
         end
 
@@ -246,6 +257,19 @@ module TUITD
       end
     end
 
+    def parse_grid_snapshot
+      @output_mutex.synchronize do
+        ANSIParser.parse(@output_buffer, @rows, @cols)[:rows]
+      end
+    end
+
+    def process_alive?
+      return false unless @pid
+      Process.waitpid(@pid, Process::WNOHANG).nil?
+    rescue Errno::ECHILD
+      false
+    end
+
     def monotonic
       Process.clock_gettime(Process::CLOCK_MONOTONIC)
     end

data/lib/tui_td/mcp/server.rb

@@ -250,6 +250,36 @@ module TUITD
                   }
                 }
               },
+              {
+                name: "tui_wait_for_exit",
+                description: "Wait until the TUI process exits. Returns the exit status code (0 = success, non-zero = error).",
+                inputSchema: {
+                  type: "object",
+                  properties: {}
+                }
+              },
+              {
+                name: "tui_exit_status",
+                description: "Get the exit status of the TUI process. Returns nil if still running, otherwise the exit code.",
+                inputSchema: {
+                  type: "object",
+                  properties: {}
+                }
+              },
+              {
+                name: "tui_find_text",
+                description: "Search for text or regex pattern in the current terminal state. Returns positions of all matches with surrounding context.",
+                inputSchema: {
+                  type: "object",
+                  properties: {
+                    pattern: {
+                      type: "string",
+                      description: "Text or regex pattern to search for (e.g., 'error', 'ERROR|FAIL')"
+                    }
+                  },
+                  required: ["pattern"]
+                }
+              },
               {
                 name: "tui_close",
                 description: "Close the TUI application and clean up the PTY session. Call this when finished.",
@@ -278,6 +308,9 @@ module TUITD
                  when "tui_plain_text" then call_tui_plain_text
                  when "tui_screenshot" then call_tui_screenshot(args)
                  when "tui_html_render" then call_tui_html_render(args)
+                 when "tui_wait_for_exit" then call_tui_wait_for_exit
+                 when "tui_exit_status" then call_tui_exit_status
+                 when "tui_find_text" then call_tui_find_text(args)
                  when "tui_close"     then call_tui_close
                  else
                    return error_response(id, -32602, "Unknown tool: #{tool_name}")
@@ -416,6 +449,40 @@ module TUITD
         end
       end
 
+      def call_tui_wait_for_exit
+        ensure_driver!
+        @driver.wait_for_exit
+        status = @driver.exitstatus
+        "OK: Process exited with status #{status}"
+      end
+
+      def call_tui_exit_status
+        ensure_driver!
+        status = @driver.exitstatus
+        if status.nil?
+          "Process is still running"
+        else
+          "Exit status: #{status}"
+        end
+      end
+
+      def call_tui_find_text(args)
+        ensure_driver!
+        pattern = args["pattern"] or return "ERROR: 'pattern' argument is required"
+        state = TUITD::State.new(@driver.state_data)
+        matches = state.find_text(pattern)
+
+        if matches.empty?
+          "No matches found for: #{pattern}"
+        else
+          lines = ["Found #{matches.size} match(es) for: #{pattern}"]
+          matches.each do |m|
+            lines << "  row #{m[:row]}, col #{m[:col]}: #{m[:full_line].strip}"
+          end
+          lines.join("\n")
+        end
+      end
+
       def call_tui_close
         @driver&.close
         @driver = nil

data/lib/tui_td/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TUITD
-  VERSION = "0.2.8"
+  VERSION = "0.2.10"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tui-td
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.2.10
 platform: ruby
 authors:
 - Haluk Durmus