terminator-mcp-agent 0.13.4 → 0.13.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +40 -0
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -530,6 +530,46 @@ terminator mcp run workflow.json # JSON
530
530
  - Install required packages: `sudo apt-get install at-spi2-core`
531
531
  - Check desktop environment compatibility (GNOME, KDE, XFCE supported)
532
532
 
533
+ ### Virtual Display Support (Headless VMs)
534
+
535
+ Terminator MCP Agent includes virtual display support for running on headless VMs without requiring RDP connections. This enables scalable automation on cloud platforms like Azure, AWS, and GCP.
536
+
537
+ **How It Works**:
538
+
539
+ The agent automatically detects headless environments and initializes a virtual display context that Windows UI Automation APIs can interact with. This allows full UI automation capabilities even when no physical display or RDP session is active.
540
+
541
+ **Activation**:
542
+
543
+ Virtual display activates automatically when:
544
+ - Environment variable `TERMINATOR_HEADLESS=true` is set
545
+ - No console window is available (common in VM/container scenarios)
546
+ - Running as a Windows service or scheduled task
547
+
548
+ **Configuration**:
549
+
550
+ ```bash
551
+ # Enable virtual display mode
552
+ export TERMINATOR_HEADLESS=true
553
+
554
+ # Run the MCP agent
555
+ npx -y terminator-mcp-agent
556
+ ```
557
+
558
+ **Use Cases**:
559
+
560
+ - Running multiple automation agents on VMs without RDP overhead
561
+ - CI/CD pipelines in cloud environments
562
+ - Scalable automation farms on Azure/AWS/GCP
563
+ - Containerized automation workloads
564
+
565
+ **Requirements**:
566
+
567
+ - Windows Server 2016+ or Windows 10/11
568
+ - .NET Framework 4.7.2+
569
+ - UI Automation APIs available (included in Windows)
570
+
571
+ The virtual display manager creates a memory-based display context that satisfies Windows UI Automation requirements, enabling terminator to enumerate and interact with UI elements as if a physical display were present.
572
+
533
573
  ### Performance Optimization
534
574
 
535
575
  **Large UI Trees**:
package/package.json CHANGED
@@ -15,10 +15,10 @@
15
15
  ],
16
16
  "name": "terminator-mcp-agent",
17
17
  "optionalDependencies": {
18
- "terminator-mcp-darwin-arm64": "0.13.4",
19
- "terminator-mcp-darwin-x64": "0.13.4",
20
- "terminator-mcp-linux-x64-gnu": "0.13.4",
21
- "terminator-mcp-win32-x64-msvc": "0.13.4"
18
+ "terminator-mcp-darwin-arm64": "0.13.6",
19
+ "terminator-mcp-darwin-x64": "0.13.6",
20
+ "terminator-mcp-linux-x64-gnu": "0.13.6",
21
+ "terminator-mcp-win32-x64-msvc": "0.13.6"
22
22
  },
23
23
  "repository": {
24
24
  "type": "git",
@@ -30,5 +30,5 @@
30
30
  "sync-version": "node ./utils/sync-version.js",
31
31
  "update-badges": "node ./utils/update-badges.js"
32
32
  },
33
- "version": "0.13.4"
33
+ "version": "0.13.6"
34
34
  }