@mediar-ai/terminator 0.24.12 → 0.24.14

package/index.d.ts

@@ -526,6 +526,27 @@ export interface ComputerUseResult {
   /** Execution ID for finding screenshots (e.g., "20251205_134500_geminiComputerUse_msedge") */
   executionId?: string
 }
+/** Result of closing a browser tab */
+export interface CloseTabResult {
+  closed: boolean
+  tab: ClosedTabInfo
+}
+/** Information about a closed tab */
+export interface ClosedTabInfo {
+  id: number
+  url?: string
+  title?: string
+  windowId?: number
+}
+/** Options for closing a browser tab */
+export interface CloseTabOptions {
+  /** Specific Chrome tab ID to close */
+  tabId?: number
+  /** URL to match (partial match supported) */
+  url?: string
+  /** Title to match (case-insensitive partial match) */
+  title?: string
+}
 /** Information about a window */
 export interface WindowInfo {
   /** Window handle */
@@ -973,6 +994,40 @@ export declare class Desktop {
    * @returns {Promise<string>} The result of script execution.
    */
   executeBrowserScript(script: string, process: string, timeoutMs?: number | undefined | null): Promise<string>
+  /**
+   * (async) Close a browser tab safely.
+   *
+   * This method can identify the tab to close by:
+   * - tabId: Close a specific tab by its Chrome tab ID
+   * - url: Find and close a tab matching this URL (partial match supported)
+   * - title: Find and close a tab matching this title (case-insensitive partial match)
+   * - If none provided, closes the currently active tab
+   *
+   * Returns information about the closed tab for verification.
+   * Returns null if no browser extension is connected or tab couldn't be found.
+   *
+   * Safety:
+   * - Will NOT close protected browser pages (chrome://, edge://, about:, etc.)
+   * - Returns the closed tab's URL/title so you can verify the correct tab was closed
+   *
+   * @param {number} [tabId] - Specific Chrome tab ID to close.
+   * @param {string} [url] - URL to match (partial match supported).
+   * @param {string} [title] - Title to match (case-insensitive partial match).
+   * @returns {Promise<CloseTabResult | null>} Info about closed tab, or null if no extension/tab found.
+   *
+   * @example
+   * // Close by URL
+   * const result = await desktop.closeTab({ url: "example.com" });
+   *
+   * @example
+   * // Close by title
+   * const result = await desktop.closeTab({ title: "My Page" });
+   *
+   * @example
+   * // Close active tab
+   * const result = await desktop.closeTab();
+   */
+  closeTab(options?: CloseTabOptions | undefined | null): Promise<CloseTabResult | null>
   /**
    * (async) Delay execution for a specified number of milliseconds.
    * Useful for waiting between actions to ensure UI stability.

package/package.json

@@ -4,12 +4,12 @@
     "url": "https://github.com/mediar-ai/terminator/issues"
   },
   "dependencies": {
-    "@mediar-ai/kv": "^0.23.30",
-    "esbuild": "^0.25.11"
+    "@mediar-ai/kv": "^0.23.30"
   },
   "description": "Node.js/TypeScript bindings for the Terminator Rust library (via napi-rs)",
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.4"
+    "@napi-rs/cli": "^2.18.4",
+    "esbuild": "^0.25.11"
   },
   "engines": {
     "node": ">= 10"
@@ -38,8 +38,8 @@
     }
   },
   "optionalDependencies": {
-    "@mediar-ai/terminator-win32-arm64-msvc": "0.24.12",
-    "@mediar-ai/terminator-win32-x64-msvc": "0.24.12"
+    "@mediar-ai/terminator-win32-arm64-msvc": "0.24.14",
+    "@mediar-ai/terminator-win32-x64-msvc": "0.24.14"
   },
   "repository": {
     "type": "git",
@@ -57,5 +57,5 @@
     "test-hook": "powershell.exe -ExecutionPolicy Bypass -File \"../../.git/hooks/pre-push.ps1\""
   },
   "types": "wrapper.d.ts",
-  "version": "0.24.12"
+  "version": "0.24.14"
 }

package/src/desktop.rs

@@ -12,6 +12,17 @@ use napi_derive::napi;
 use std::sync::{Arc, Once};
 use terminator::Desktop as TerminatorDesktop;
 
+/// Normalize key format to ensure curly brace syntax for special keys.
+/// If key already contains `{`, assume it's correctly formatted.
+/// Otherwise, wrap the entire key in `{}` to ensure it's treated as a special key press.
+fn normalize_key(key: &str) -> String {
+    if key.contains('{') {
+        key.to_string()
+    } else {
+        format!("{{{}}}", key)
+    }
+}
+
 /// Result of screenshot capture operations
 #[derive(Default)]
 struct ScreenshotPaths {
@@ -2398,7 +2409,18 @@ impl Desktop {
         include_window_screenshot: Option<bool>,
         include_monitor_screenshots: Option<bool>,
     ) -> napi::Result<()> {
-        let result = self.inner.press_key(&key).await.map_err(map_error);
+        // Normalize key to ensure curly brace format (e.g., "Enter" -> "{Enter}")
+        let normalized_key = normalize_key(&key);
+        tracing::debug!(
+            "[TS SDK] desktop.press_key: normalized key: {} -> {}",
+            key,
+            normalized_key
+        );
+        let result = self
+            .inner
+            .press_key(&normalized_key)
+            .await
+            .map_err(map_error);
 
         // Get PID from process name if provided
         let pid = process

package/src/element.rs

@@ -13,6 +13,17 @@ use crate::{
 use crate::Selector;
 use napi::bindgen_prelude::Either;
 
+/// Normalize key format to ensure curly brace syntax for special keys.
+/// If key already contains `{`, assume it's correctly formatted.
+/// Otherwise, wrap the entire key in `{}` to ensure it's treated as a special key press.
+fn normalize_key(key: &str) -> String {
+    if key.contains('{') {
+        key.to_string()
+    } else {
+        format!("{{{}}}", key)
+    }
+}
+
 /// Click position within element bounds as percentages (0-100)
 #[napi(object)]
 #[derive(Default, Clone)]
@@ -646,8 +657,15 @@ impl Element {
         let _ = self.inner.activate_window();
         let try_focus_before = opts.try_focus_before.unwrap_or(true);
         let try_click_before = opts.try_click_before.unwrap_or(true);
+        // Normalize key to ensure curly brace format (e.g., "Enter" -> "{Enter}")
+        let normalized_key = normalize_key(&key);
+        tracing::debug!(
+            "[TS SDK] press_key: normalized key: {} -> {}",
+            key,
+            normalized_key
+        );
         self.inner
-            .press_key_with_state_and_focus(&key, try_focus_before, try_click_before)
+            .press_key_with_state_and_focus(&normalized_key, try_focus_before, try_click_before)
             .map_err(map_error)?;
 
         // Capture screenshots if requested