terminator-mcp-agent 0.15.19 → 0.16.3

package/README.md

@@ -233,9 +233,9 @@ The Terminator MCP agent offers two primary workflows for automating desktop tas
 This is the most powerful and flexible method. You build a workflow step-by-step, using MCP tools to inspect the UI and refine your actions.
 
 1.  **Inspect the UI**: Start by using `get_focused_window_tree` to understand the structure of your target application. This gives you the roles, names, and IDs of all elements. For performance optimization:
-    - Use `include_tree: { max_depth: 2 }` to limit tree depth when you only need shallow inspection
-    - Use `include_tree: { from_selector: "role:Dialog" }` to get subtree from a specific element
-    - Use `include_tree: { from_selector: "true" }` to start from the currently focused element
+    - Use `tree_max_depth: 2` to limit tree depth when you only need shallow inspection
+    - Use `tree_from_selector: "role:Dialog"` to get subtree from a specific element
+    - Use `tree_from_selector: "true"` to start from the currently focused element
 2.  **Build a Sequence**: Create an `execute_sequence` tool call with a series of actions (`click_element`, `type_into_element`, etc.). Use robust selectors (like `role|name` or stable `properties:AutomationId:value` selectors) whenever possible.
 3.  **Capture the Final State**: Ensure the last step in your sequence is an action that returns a UI tree. The `wait_for_element` tool with `include_tree: true` is perfect for this, as it captures the application's state after your automation has run.
 4.  **Extract Structured Data with `output_parser`**: Add the `output_parser` argument to your `execute_sequence` call. Write JavaScript code to parse the final UI tree and extract structured data. If successful, the tool result will contain a `parsed_output` field with your clean JSON data.
@@ -717,9 +717,9 @@ The virtual display manager creates a memory-based display context that satisfie
 - Implement delays between rapid operations
 - Consider using `include_tree: false` for intermediate steps
 - For tree extraction tools, optimize with:
-  - `include_tree: { max_depth: 2 }` - Limit depth for large trees
-  - `include_tree: { from_selector: "role:List" }` - Get subtree from specific element
-  - `include_tree: { from_selector: "true" }` - Start from focused element
+  - `tree_max_depth: 2` - Limit depth for large trees
+  - `tree_from_selector: "role:List"` - Get subtree from specific element
+  - `tree_from_selector: "true"` - Start from focused element
 
 **JavaScript Performance**:
 
@@ -907,19 +907,16 @@ steps:
 - tool_name: get_window_tree
   arguments:
     pid: 1234
-    include_tree:
-      max_depth: 2  # Only get 2 levels deep
+    tree_max_depth: 2  # Only get 2 levels deep
 
 - tool_name: get_focused_window_tree
   arguments:
-    include_tree:
-      from_selector: "role:Dialog"  # Start tree from first dialog
-      max_depth: 3  # Limit depth from that point
+    tree_from_selector: "role:Dialog"  # Start tree from first dialog
+    tree_max_depth: 3  # Limit depth from that point
 
 - tool_name: get_focused_window_tree
   arguments:
-    include_tree:
-      from_selector: "true"  # Start from focused element
+    tree_from_selector: "true"  # Start from focused element
 
 # Backward compatible - still works
 - tool_name: get_window_tree

package/index.js

@@ -185,10 +185,58 @@ if (argv.includes("--add-to-app")) {
   process.on("SIGTERM", shutdown);
   process.on("exit", shutdown);
 
-  child.on("exit", (code) => {
-    if (code !== 0) {
-      console.error(`[MCP exited with code ${code}]`);
+  let restartAttempts = 0;
+  const MAX_RESTART_ATTEMPTS = 3;
+  const RESTART_DELAY = 1000; // 1 second
+
+  child.on("exit", (code, signal) => {
+    // Check for stack overflow exit code on Windows (3221225725 = 0xC00000FD)
+    const isStackOverflow = code === 3221225725 || code === -1073741571;
+
+    if (code !== 0 && !shuttingDown) {
+      console.error(`[MCP exited with code ${code}${signal ? ` (signal: ${signal})` : ''}]`);
+
+      // Auto-restart on crash if under max attempts
+      if (restartAttempts < MAX_RESTART_ATTEMPTS) {
+        restartAttempts++;
+
+        if (isStackOverflow) {
+          console.error(`[Stack overflow detected - this often happens with deeply nested UI trees]`);
+        }
+
+        console.error(`[Attempting to restart MCP server (attempt ${restartAttempts}/${MAX_RESTART_ATTEMPTS})...]`);
+
+        setTimeout(() => {
+          console.error(`[Restarting MCP server...]`);
+
+          // Spawn new process
+          const newChild = spawn(binary, agentArgs, {
+            stdio: ["pipe", "pipe", "pipe"],
+            shell: false,
+            detached: process.platform !== "win32",
+          });
+
+          // Reconnect pipes
+          process.stdin.unpipe(child.stdin);
+          process.stdin.pipe(newChild.stdin);
+          newChild.stdout.pipe(process.stdout);
+          newChild.stderr.pipe(process.stderr);
+
+          // Replace child reference
+          child = newChild;
+
+          // Reattach exit handler with same logic
+          child.on("exit", arguments.callee);
+
+          console.error(`[MCP server restarted successfully]`);
+        }, RESTART_DELAY);
+
+        return; // Don't exit the wrapper process
+      } else {
+        console.error(`[Max restart attempts reached. Exiting.]`);
+      }
     }
+
     process.exit(code);
   });
 }

package/package.json

@@ -3,7 +3,8 @@
     "terminator-mcp-agent": "index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.3"
+    "@modelcontextprotocol/sdk": "^1.17.3",
+    "node-fetch": "^2.7.0"
   },
   "description": "Cross-platform Model Context Protocol (MCP) agent for Terminator",
   "engines": {
@@ -15,10 +16,10 @@
   ],
   "name": "terminator-mcp-agent",
   "optionalDependencies": {
-    "terminator-mcp-darwin-arm64": "0.15.19",
-    "terminator-mcp-darwin-x64": "0.15.19",
-    "terminator-mcp-linux-x64-gnu": "0.15.19",
-    "terminator-mcp-win32-x64-msvc": "0.15.19"
+    "terminator-mcp-darwin-arm64": "0.16.3",
+    "terminator-mcp-darwin-x64": "0.16.3",
+    "terminator-mcp-linux-x64-gnu": "0.16.3",
+    "terminator-mcp-win32-x64-msvc": "0.16.3"
   },
   "repository": {
     "type": "git",
@@ -30,5 +31,5 @@
     "sync-version": "node ./utils/sync-version.js",
     "update-badges": "node ./utils/update-badges.js"
   },
-  "version": "0.15.19"
+  "version": "0.16.3"
 }