feat: add performance controls for large browser ops

- Add throttled large-operation handling for tab, group, and session commands.
- Introduce performance profiles, audible-tab aware gentle mode, and job progress tracking.
- Support background session restores with status/cancel commands and lazy placeholders.
- Expose new perf and extension CLI groups plus matching Python SDK methods.
- Preserve pinned tabs during session snapshots and debounce auto-save updates.
- Bump browser-cli and extension versions to 0.10.0 and add pytest-cov to dev deps.
- Add coverage for performance controls, background jobs, lazy restores, and tab metadata.

browser_cli/commands/tabs.py

@@ -66,9 +66,10 @@ def tabs_list():
 @click.argument("tab_id", type=int, required=False)
 @click.option("--inactive", is_flag=True, help="Close all inactive tabs")
 @click.option("--duplicates", is_flag=True, help="Close duplicate tabs (keep first)")
-def tabs_close(tab_id, inactive, duplicates):
+@click.option("--gentle-mode", type=click.Choice(["auto", "normal", "gentle", "ultra"]), default="auto", show_default=True, help="Throttle mode for large close operations.")
+def tabs_close(tab_id, inactive, duplicates, gentle_mode):
     """Close a tab, all inactive tabs, or all duplicate tabs."""
-    result = _handle("tabs.close", {"tabId": tab_id, "inactive": inactive, "duplicates": duplicates})
+    result = _handle("tabs.close", {"tabId": tab_id, "inactive": inactive, "duplicates": duplicates, "gentleMode": gentle_mode})
     count = result.get("closed", 0) if isinstance(result, dict) else 1
     console.print(f"[green]Closed {count} tab(s)[/green]")
 
@@ -171,25 +172,28 @@ def tabs_html(tab_id):
 
 
 @tabs_group.command("dedupe")
-def tabs_dedupe():
+@click.option("--gentle-mode", type=click.Choice(["auto", "normal", "gentle", "ultra"]), default="auto", show_default=True, help="Throttle mode for large dedupe operations.")
+def tabs_dedupe(gentle_mode):
     """Close duplicate tabs (keep the first occurrence of each URL)."""
-    result = _handle("tabs.dedupe")
+    result = _handle("tabs.dedupe", {"gentleMode": gentle_mode})
     count = result.get("closed", 0) if isinstance(result, dict) else 0
     console.print(f"[green]Closed {count} duplicate tab(s)[/green]")
 
 
 @tabs_group.command("sort")
 @click.option("--by", type=click.Choice(["domain", "title", "time"]), default="domain", show_default=True)
-def tabs_sort(by):
+@click.option("--gentle-mode", type=click.Choice(["auto", "normal", "gentle", "ultra"]), default="auto", show_default=True, help="Throttle mode for large sort operations.")
+def tabs_sort(by, gentle_mode):
     """Sort tabs within each window."""
-    _handle("tabs.sort", {"by": by})
+    _handle("tabs.sort", {"by": by, "gentleMode": gentle_mode})
     console.print(f"[green]Tabs sorted by {by}[/green]")
 
 
 @tabs_group.command("merge-windows")
-def tabs_merge_windows():
+@click.option("--gentle-mode", type=click.Choice(["auto", "normal", "gentle", "ultra"]), default="auto", show_default=True, help="Throttle mode for large merge operations.")
+def tabs_merge_windows(gentle_mode):
     """Move all tabs into the focused window."""
-    result = _handle("tabs.merge_windows")
+    result = _handle("tabs.merge_windows", {"gentleMode": gentle_mode})
     count = result.get("moved", 0) if isinstance(result, dict) else 0
     console.print(f"[green]Merged — moved {count} tab(s) into current window[/green]")