tui-td 0.2.9 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0062b5242a5e1ec97546b733761ce7a7fe559ee85d2e413cdce25798fa0861d
-  data.tar.gz: 2fbf22c11937739e51bc303d4ddbaedd6edb1015ef829046dc9d42bc5a1f2bf8
+  metadata.gz: 3eb2dc4db4af2ddbcbe377f8a3d6bddf8e1a45f3c78c85a25d8480d1e740e9f7
+  data.tar.gz: 31a65006ceb299ba4487446932bf74305ecb92d4241288f82d7d11a0283e6bf6
 SHA512:
-  metadata.gz: 306311eefc1fc30811cd630ac23f35f02ce7d14250c9bdd1cc63a7508a199193af475947fed85bc24198b3060903ce38b392f056ddba326fc22741b3ba28568c
-  data.tar.gz: 90bcfdd7d9f9f9357758deb5f7ebb8b3a7f20ca919f398909ecd03801106998fcf190c5341141324ec427618e9a32ad40cfbc117ae7bb474b5421e1677b4980e
+  metadata.gz: 706d849d8c35380fabf149bcf6cee5441d92a71b228d7ac4bc0bbba3852be4443496d9d6ae79afd15daa5217b9ede798d6ce2d15dee2cbeb5f6a0901b5269722
+  data.tar.gz: 9595ce52cd78959dfb49f314d3272d6cf2c065dd215467e204c862b48da2a88525ab8a9dad0ab98ccdd7b7fc142e700eab4ca65ea6a8c2b90d53aefbe8eca922

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

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/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.9"
+  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.9
+  version: 0.2.10
 platform: ruby
 authors:
 - Haluk Durmus