stackops 26.6.3__tar.gz → 26.6.5__tar.gz

stackops-26.6.5/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.6.5
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: joblib>=1.5.3
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: typer>=0.24.1
+Provides-Extra: windows
+Provides-Extra: plot
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.6.5/README.md

@@ -0,0 +1,118 @@
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.6.5/pyproject.toml

@@ -0,0 +1,166 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.6.5"
+description = "Developer Stack Manager"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "joblib>=1.5.3",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "typer>=0.24.1",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+preview = "stackops.scripts.python.preview:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json", "utils/schemas/**/*.yaml"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.4.1",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.1",
+    "gdown>=5.2.1",
+    "griffe>=2.0.2",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "kaleido>=1.2.0",
+    "marimo>=0.21.1",
+    "matplotlib>=3.10.8",
+    "mkdocstrings>=1.0.3",
+    "mkdocstrings-python>=2.0.3",
+    "mypy>=1.19.1",
+    "numpy>=2.4.3",
+    "pandas>=3.0.1",
+    "paramiko>=5.0.0",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "pre-commit>=4.5.1",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.0",
+    "pydantic>=2.12.5",
+    "pydeps>=3.0.2",
+    "pyinstaller>=6.19.0",
+    "pylint>=4.0.5",
+    "pylsp-mypy>=0.7.1",
+    "pymupdf>=1.27.2.2",
+    "pypdf>=6.9.2",
+    "pyrefly>=0.58.0",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.7",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.48",
+    "textual>=8.1.1",
+    "trogon>=0.6.0",
+    "ty>=0.0.25",
+    "types-mysqlclient>=2.2.0.20250915",
+    "types-paramiko>=4.0.0.20260322",
+    "types-pytz>=2026.1.1.20260304",
+    "types-pyyaml>=6.0.12.20250915",
+    "types-requests>=2.32.4.20260324",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20240310",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.29",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.1",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "jupyterlab>=4.5.6",
+    "kaleido>=1.2.0",
+    "matplotlib>=3.10.8",
+    "nbformat>=5.10.4",
+    "numpy>=2.4.3",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.48",
+]
+
+
+# [tool.uv]
+# default-groups = []
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-26.6.5/src/manual/test_dotfile_mapper_assets.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+import yaml
+
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+MAPPER_PATH = REPO_ROOT / "src" / "stackops" / "utils" / "schemas" / "mapper" / "dotfiles.yaml"
+SETTINGS_ROOT = REPO_ROOT / "src" / "stackops" / "settings"
+CONFIG_SETTINGS_PREFIX = "CONFIG_ROOT/settings/"
+
+
+def test_library_mapper_config_settings_targets_are_packaged() -> None:
+    mapper = yaml.safe_load(MAPPER_PATH.read_text(encoding="utf-8")) or {}
+    missing_assets: list[str] = []
+
+    for program_name, entries in mapper.items():
+        for entry_name, entry in entries.items():
+            self_managed = entry["self_managed"]
+            if not self_managed.startswith(CONFIG_SETTINGS_PREFIX):
+                continue
+
+            relative_asset_path = self_managed.removeprefix(CONFIG_SETTINGS_PREFIX)
+            packaged_asset_path = SETTINGS_ROOT / relative_asset_path
+            if not packaged_asset_path.exists():
+                missing_assets.append(
+                    f"{program_name}.{entry_name}: {self_managed} -> {packaged_asset_path.relative_to(REPO_ROOT)}"
+                )
+
+    assert missing_assets == [], "Missing packaged settings assets:\n" + "\n".join(missing_assets)

stackops-26.6.5/src/manual/test_stackops_skill_refs.py

@@ -0,0 +1,129 @@
+from datetime import date
+
+from typer.testing import CliRunner
+
+from stackops.scripts.python.graph.cli_graph_apps import load_app_model
+from stackops.scripts.python.graph.cli_graph_nodes import build_children
+from stackops.scripts.python.graph.cli_graph_shared import AppRef
+from stackops.scripts.python.helpers.helpers_devops import cli_self_assets, stackops_skill_refs
+
+
+SAMPLE_GRAPH = {
+    "root": {
+        "kind": "root",
+        "name": "stackops",
+        "source": {"file": "src/stackops/scripts/python/stackops_entry.py"},
+        "children": [
+            {
+                "kind": "group",
+                "name": "devops",
+                "fullPath": "devops",
+                "source": {
+                    "file": "src/stackops/scripts/python/stackops_entry.py",
+                    "dispatches_to": "stackops.scripts.python.devops.get_app",
+                },
+                "aliases": [{"name": "d", "hidden": True}],
+                "children": [
+                    {
+                        "kind": "command",
+                        "name": "install",
+                        "fullPath": "devops install",
+                        "source": {"file": "src/stackops/scripts/python/devops.py", "callable": "install"},
+                    },
+                    {
+                        "kind": "group",
+                        "name": "data",
+                        "fullPath": "devops data",
+                        "source": {
+                            "file": "src/stackops/scripts/python/devops.py",
+                            "dispatches_to": "stackops.scripts.python.helpers.helpers_devops.cli_data.get_app",
+                        },
+                        "children": [
+                            {
+                                "kind": "command",
+                                "name": "sync",
+                                "fullPath": "devops data sync",
+                                "source": {
+                                    "file": "src/stackops/scripts/python/helpers/helpers_devops/cli_data.py",
+                                    "callable": "sync",
+                                },
+                            }
+                        ],
+                    },
+                ],
+            },
+            {
+                "kind": "group",
+                "name": "type-fix",
+                "fullPath": "utils pyproject type-fix",
+                "source": {
+                    "file": "src/stackops/scripts/python/helpers/helpers_utils/pyproject_utils_app.py",
+                    "dispatches_to": "stackops.scripts.python.helpers.helpers_utils.type_fix.get_app",
+                },
+                "children": [],
+            },
+        ],
+    }
+}
+
+
+def test_cli_map_uses_high_level_references_without_alias_nodes() -> None:
+    rendered = stackops_skill_refs.render_cli_map(
+        cli_graph_payload=SAMPLE_GRAPH,
+        project_scripts={"devops": "stackops.scripts.python.devops:main"},
+        generated_on=date(2026, 6, 9),
+    )
+
+    assert "Regenerated from `src/stackops/scripts/python/graph/cli_graph.json` on 2026-06-09." in rendered
+    assert "- `devops` -> `stackops.scripts.python.devops:main`" in rendered
+    assert "- `UV_CACHE_DIR=/tmp/uv-cache uv run stackops --help`" in rendered
+    assert "- `UV_CACHE_DIR=/tmp/uv-cache uv run devops --help`" in rendered
+    assert "devops install" not in rendered
+    assert "devops data sync" not in rendered
+    assert "commands/command--" not in rendered
+    assert "\n- [`d`" not in rendered
+
+
+def test_source_map_links_root_entrypoints_only() -> None:
+    rendered = stackops_skill_refs.render_source_map(cli_graph_payload=SAMPLE_GRAPH, generated_on=date(2026, 6, 9))
+
+    assert (
+        "- `devops` -> `src/stackops/scripts/python/stackops_entry.py` -> "
+        "`stackops.scripts.python.devops.get_app` via `devops`"
+    ) in rendered
+    assert "devops install" not in rendered
+    assert "devops data sync" not in rendered
+    assert "commands/command--" not in rendered
+    assert "commands/command--" not in rendered
+
+
+def test_update_skill_refs_command_is_registered() -> None:
+    result = CliRunner().invoke(cli_self_assets.get_app(), ["--help"])
+
+    assert result.exit_code == 0
+    assert "update-skill-refs" in result.stdout
+
+
+def test_cli_graph_expands_static_loop_command_registrations() -> None:
+    app_model = load_app_model(
+        AppRef(
+            module="stackops.scripts.python.helpers.helpers_devops.cli_config_tmux",
+            factory="get_app",
+        )
+    )
+
+    children = build_children(
+        app_model=app_model,
+        parent_full_tokens=("devops", "config", "terminal", "tmux-style"),
+        parent_short_tokens=("d", "c", "t", "s"),
+    )
+    child_names = {child["name"] for child in children}
+
+    assert {
+        "install-oh-my-tmux",
+        "apply-stackops-local",
+        "preset",
+        "set-option",
+        "reload",
+        "status",
+    } <= child_names

stackops-26.6.5/src/stackops/cluster/sessions_managers/helpers/enhanced_command_runner.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""Enhanced command execution utilities with Rich formatting."""
+
+import subprocess
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+console = Console()
+
+
+def run_enhanced_command(
+    command: str,
+    description: str | None,
+    show_progress: bool,
+    timeout: int | None,
+) -> dict[str, object]:
+    if description is None:
+        description = f"Executing: {command[:50]}..."
+
+    try:
+        if show_progress:
+            with Progress(SpinnerColumn(), TextColumn("[progress.description]{task.description}"), console=console, transient=True) as progress:
+                task = progress.add_task(f"[cyan]{description}[/cyan]", total=None)
+
+                result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=timeout)
+
+                progress.update(task, completed=True)
+        else:
+            result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=timeout)
+
+        stdout = result.stdout.strip() if result.stdout else ""
+        stderr = result.stderr.strip() if result.stderr else ""
+
+        if "Session:" in stdout and "successfully deleted" in stdout:
+            console.print(f"[bold red]{stdout}[/bold red]")
+
+        if "Pseudo-terminal will not be allocated" in stderr:
+            console.print("[dim yellow]ℹ️  Note: Running in non-interactive mode[/dim yellow]")
+            stderr = stderr.replace("Pseudo-terminal will not be allocated because stdin is not a terminal.\n", "")
+
+        if result.returncode == 0:
+            if stdout and "Session:" not in stdout:
+                console.print(f"[green]{stdout}[/green]")
+            return {"success": True, "returncode": result.returncode, "stdout": stdout, "stderr": stderr}
+        else:
+            if stderr:
+                console.print(f"[bold red]Error:[/bold red] [red]{stderr}[/red]")
+            return {"success": False, "returncode": result.returncode, "stdout": stdout, "stderr": stderr}
+
+    except subprocess.TimeoutExpired:
+        console.print(f"[bold red]⏰ Command timed out after {timeout} seconds[/bold red]")
+        return {"success": False, "error": "Timeout", "timeout": timeout}
+    except Exception as exc:
+        console.print(f"[bold red]💥 Unexpected error:[/bold red] [red]{str(exc)}[/red]")
+        return {"success": False, "error": str(exc)}
+
+
+if __name__ == "__main__":
+    # Demo the enhanced command execution
+    console.print(Panel.fit("🎨 Enhanced Command Execution Demo", style="bold cyan"))
+
+    # Test with a simple command
+    result = run_enhanced_command("echo 'Hello, Rich world!'", "Testing enhanced output", True, None)
+    console.print(f"Result: {result}")

stackops-26.6.5/src/stackops/cluster/sessions_managers/monitoring_types.py

@@ -0,0 +1,42 @@
+from typing import NotRequired, TypedDict
+
+
+class ProcessInfo(TypedDict):
+    pid: int
+    name: str
+    cmdline: list[str]
+    status: str
+    cmdline_str: NotRequired[str]
+    create_time: NotRequired[float]
+    is_direct_command: NotRequired[bool]
+    verified_alive: NotRequired[bool]
+    memory_mb: NotRequired[float]
+
+
+class CommandStatus(TypedDict):
+    status: str
+    running: bool
+    processes: list[ProcessInfo]
+    command: str
+    tab_name: str
+    cwd: NotRequired[str]
+    error: NotRequired[str]
+    pid: NotRequired[int]
+    remote: NotRequired[str]
+    check_timestamp: NotRequired[str | float]
+    method: NotRequired[str]
+    raw_output: NotRequired[str]
+    verification_method: NotRequired[str]
+
+
+class StartResult(TypedDict):
+    success: bool
+    message: NotRequired[str]
+    error: NotRequired[str]
+
+
+class ActiveSessionInfo(TypedDict):
+    session_name: str
+    is_active: bool
+    tab_count: int
+    tabs: list[str]