webbee 0.4.1__tar.gz → 0.4.2__tar.gz

{webbee-0.4.1 → webbee-0.4.2}/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.4.2
+
+**Webbee v0.4.2: Universal `shell` Action Across Windows/macOS/Linux, Interactive TUI Modals, Cloud Voice STT & Complete Hover Engine.**
+
+This release introduces the cross-platform `shell` tool (replacing the platform-specific `bash` terminology for complete Windows, macOS, and Linux clarity), brings responsive modal dialogs (`Attach File`, `Voice Note`, `Session Menu`) with fluid mouse hover highlights and keyboard navigation, integrates zero-dependency cloud speech-to-text (STT) via `/v1/voice/stt`, and guarantees zero mouse escape garbage in the prompt.
+
+### Highlights & New Capabilities
+
+* **Universal Cross-Platform `shell` Tool**:
+  - Renamed the core command execution tool from `bash` to `shell` to accurately reflect universal execution across Windows (`cmd`/`PowerShell`), macOS (`zsh`), and Linux (`bash`/`sh`).
+  - Retains transparent backward compatibility for existing scripts, tests, and model tool calls with aliased dispatch.
+  - Automatic UTF-8 environment forcing, path resolution for Homebrew (Apple Silicon + Intel) and Linuxbrew, and fail-soft non-interactive safeguards against password prompt deadlocks.
+
+* **Interactive TUI Modals & Dialog System (`webbee.modals`)**:
+  - Responsive, centered modal dialogs for **File Attachment** (`📎`), **Voice Recording** (`🎤`), and **Session / Remote Routing** (`⋮`).
+  - Adaptive layout dynamically scaling to terminal dimensions (compact on 80-column terminals, comfortably expansive on ultra-wide screens).
+  - Native OS File Picker integration (macOS Finder, Linux Zenity/Kdialog, Windows PowerShell file dialog) with terminal list fallback.
+
+* **Fluid Mouse Hover Engine & Keyboard Navigation**:
+  - Full support for `?1003h` any-event mouse tracking during active interactive sessions.
+  - Distinct 3-tier visual hierarchy: idle controls (`class:button`), crisp white hover highlight on pointer hover (`class:button.hover`), and signature Imperal yellow keyboard focus (`class:button.focused`).
+  - Interactive hover support enabled across tabs, tab close buttons (`✕`), new tab button (`+`), prompt action icons (`📎`, `🎤`, `⋮`), and footer mode/tier chips.
+
+* **Cloud-Native Speech-To-Text (STT) Voice Notes**:
+  - In-terminal audio recording directly from default system microphones (Apple Silicon / Intel AVFoundation, Linux ALSA/PulseAudio, Windows DirectShow).
+  - Audio payloads sent to Imperal Core STT endpoint `/v1/voice/stt` and transcribed directly into clean conversational text in the input buffer before turn dispatch.
+
+* **Zero-Garbage Prompt Protection (`scrub_mouse_residue`)**:
+  - Hardened input buffer against stray VT100 / DEC escape sequence leaks (`[<...` mouse coordinates or `` / `` focus reports).
+  - Reactive `on_text_changed` filter and modal-close buffer sanitizer instantly scrub residue before rendering.
+
+---
+
 ## 0.4.1
 
 **Webbee v0.4.1: Cross-Platform Clipboard Resilience, Icon Gutter Alignment & Refined Terminal UX.**

{webbee-0.4.1 → webbee-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webbee
-Version: 0.4.1
+Version: 0.4.2
 Summary: Webbee 🐝 — the Imperal Cloud coding agent in your terminal
 Project-URL: Homepage, https://imperal.io
 Project-URL: Documentation, https://docs.imperal.io
@@ -16,12 +16,15 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
-Requires-Python: >=3.11
+Requires-Python: >=3.9
 Requires-Dist: httpx-sse>=0.4
 Requires-Dist: httpx>=0.27
 Requires-Dist: imperal-mcp>=0.5.0
@@ -120,7 +123,7 @@ Inside the interactive terminal:
 | 📖 | `read_file` | Read text and source files byte-exact, with offset/limit paging |
 | ✏️ | `write_file` | Create or overwrite files atomically with snapshot tracking |
 | 🔧 | `edit_file` / `multi_edit` | Precise find-and-replace edits across one or multiple files |
-| ⚡ | `bash` | Execute shell commands in the workspace root with real-time streaming |
+| ⚡ | `shell` | Execute shell/terminal commands across Windows, macOS and Linux with streaming |
 | 🔎 | `grep` / `glob` | Fast regex code search and workspace file pattern matching |
 | 🌐 | `web_search` / `read_url` | Search the web and read web documentation in clean Markdown |
 | 🖼️ | `view_image` | Inspect images with native multimodal vision + OCR fallback |

{webbee-0.4.1 → webbee-0.4.2}/README.md

@@ -73,7 +73,7 @@ Inside the interactive terminal:
 | 📖 | `read_file` | Read text and source files byte-exact, with offset/limit paging |
 | ✏️ | `write_file` | Create or overwrite files atomically with snapshot tracking |
 | 🔧 | `edit_file` / `multi_edit` | Precise find-and-replace edits across one or multiple files |
-| ⚡ | `bash` | Execute shell commands in the workspace root with real-time streaming |
+| ⚡ | `shell` | Execute shell/terminal commands across Windows, macOS and Linux with streaming |
 | 🔎 | `grep` / `glob` | Fast regex code search and workspace file pattern matching |
 | 🌐 | `web_search` / `read_url` | Search the web and read web documentation in clean Markdown |
 | 🖼️ | `view_image` | Inspect images with native multimodal vision + OCR fallback |

{webbee-0.4.1 → webbee-0.4.2}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "webbee"
-version = "0.4.1"
+version = "0.4.2"
 description = "Webbee 🐝 — the Imperal Cloud coding agent in your terminal"
 readme = "README.md"
 license = "GPL-3.0-or-later"
 license-files = ["LICENSE"]
-requires-python = ">=3.11"
+requires-python = ">=3.9"
 authors = [{ name = "Imperal, Inc.", email = "hello@imperal.io" }]
 dependencies = [
     "imperal-mcp>=0.5.0",
@@ -41,9 +41,12 @@ classifiers = [
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
     "Topic :: Software Development",
     "Topic :: Utilities",

webbee-0.4.2/src/webbee/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.2"

{webbee-0.4.1 → webbee-0.4.2}/src/webbee/clipboard.py

@@ -60,15 +60,35 @@ def _local_copy_cmd() -> list[str] | None:
 
 def _try_local_copy(text: str) -> bool:
     """Feed `text` to the local clipboard tool via stdin. True only on a
-    clean (returncode 0) run — never raises."""
+    clean (returncode 0) run — never raises.
+    On Linux desktop (Pop!_OS / GNOME / Cosmic), also mirrors to the primary
+    selection buffer so middle-click paste and Shift+Insert work seamlessly
+    alongside Ctrl+Shift+V."""
     cmd = _local_copy_cmd()
     if cmd is None:
         return False
+    payload = text.encode("utf-8", "replace")
+    success = False
     try:
-        proc = subprocess.run(cmd, input=text.encode("utf-8", "replace"), timeout=2)
-        return proc.returncode == 0
+        proc = subprocess.run(cmd, input=payload, timeout=2)
+        success = (proc.returncode == 0)
     except Exception:
-        return False
+        success = False
+
+    if success and sys.platform not in ("darwin", "win32"):
+        # Linux primary selection dual-write
+        try:
+            from webbee.clipboard_session import is_wayland_session
+            if is_wayland_session() and shutil.which("wl-copy"):
+                subprocess.run(["wl-copy", "--primary"], input=payload, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=1)
+            elif shutil.which("xclip"):
+                subprocess.run(["xclip", "-selection", "primary"], input=payload, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=1)
+            elif shutil.which("xsel"):
+                subprocess.run(["xsel", "--primary", "--input"], input=payload, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=1)
+        except Exception:
+            pass
+
+    return success
 
 
 def _osc52_emit(text: str) -> bool:

webbee-0.4.2/src/webbee/media.py

@@ -0,0 +1,137 @@
+"""Enterprise Cross-Platform Audio Playback & Terminal Image Viewer for Webbee Code.
+
+Provides robust, zero-crash audio playback and in-terminal image viewing across:
+- macOS (afplay, AVFoundation, iTerm2/Kitty image protocol)
+- Linux (paplay, aplay, pw-play, ffplay, Sixel, Kitty, ANSI half-blocks)
+- Windows (PowerShell System.Media.SoundPlayer, Windows Media Player, WT inline)
+- Universal ANSI/Half-block fallback for any terminal on any OS.
+"""
+from __future__ import annotations
+
+import base64
+import os
+import shutil
+import subprocess
+import sys
+import threading
+from typing import Optional, Tuple
+
+
+def play_audio_file(file_path: str, *, block: bool = False) -> Optional[subprocess.Popen]:
+    """Play an audio file (.wav, .mp3, .m4a, .ogg) across macOS, Linux, and Windows.
+
+    Non-blocking by default (runs in background process).
+    """
+    if not os.path.exists(file_path):
+        return None
+
+    cmd = []
+    if sys.platform == "darwin":
+        if shutil.which("afplay"):
+            cmd = ["afplay", file_path]
+        elif shutil.which("ffplay"):
+            cmd = ["ffplay", "-nodisp", "-autoexit", "-loglevel", "quiet", file_path]
+    elif sys.platform.startswith("linux"):
+        if shutil.which("paplay") and file_path.endswith(".wav"):
+            cmd = ["paplay", file_path]
+        elif shutil.which("pw-play"):
+            cmd = ["pw-play", file_path]
+        elif shutil.which("aplay") and file_path.endswith(".wav"):
+            cmd = ["aplay", "-q", file_path]
+        elif shutil.which("ffplay"):
+            cmd = ["ffplay", "-nodisp", "-autoexit", "-loglevel", "quiet", file_path]
+        elif shutil.which("mpv"):
+            cmd = ["mpv", "--no-video", "--really-quiet", file_path]
+    elif sys.platform in ("win32", "cygwin"):
+        ps = shutil.which("powershell") or shutil.which("pwsh")
+        if ps:
+            abs_p = os.path.abspath(file_path).replace("'", "''")
+            cmd = [ps, "-c", f"(New-Object System.Media.SoundPlayer '{abs_p}').PlaySync()"]
+        elif shutil.which("ffplay"):
+            cmd = ["ffplay", "-nodisp", "-autoexit", "-loglevel", "quiet", file_path]
+
+    if not cmd:
+        return None
+
+    try:
+        if block:
+            subprocess.run(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            return None
+        proc = subprocess.Popen(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        return proc
+    except Exception:
+        return None
+
+
+def render_image_in_terminal(image_path: str, max_cols: int = 60, max_rows: int = 30) -> str:
+    """Render an image directly inside the terminal.
+
+    Supported rendering protocols:
+    1. iTerm2 / WezTerm / Ghostty inline image protocol (OSC 1337)
+    2. Kitty terminal graphics protocol (APC G ...)
+    3. High-quality ANSI half-block (▀ / ▄) TrueColor fallback using PIL if available
+    4. Text description fallback if binary / non-renderable
+    """
+    if not os.path.exists(image_path):
+        return f"[Image not found: {image_path}]"
+
+    # Check terminal protocol support
+    term = os.environ.get("TERM", "").lower()
+    term_prog = os.environ.get("TERM_PROGRAM", "").lower()
+    lc_term = os.environ.get("LC_TERMINAL", "").lower()
+
+    # 1. iTerm2 / WezTerm / Ghostty OSC 1337 Inline Image Protocol
+    if "iterm" in term_prog or "wezterm" in term_prog or "ghostty" in term_prog or "iterm" in lc_term:
+        try:
+            with open(image_path, "rb") as f:
+                b64_data = base64.b64encode(f.read()).decode("ascii")
+            filename_b64 = base64.b64encode(os.path.basename(image_path).encode("utf-8")).decode("ascii")
+            # OSC 1337 ; File=name=...;inline=1;width=auto;height=auto : <base64> ^G
+            return f"\033]1337;File=name={filename_b64};inline=1;width=auto;height={max_rows}:{b64_data}\007"
+        except Exception:
+            pass
+
+    # 2. Kitty Graphics Protocol
+    if "kitty" in term or "kitty" in term_prog:
+        try:
+            with open(image_path, "rb") as f:
+                b64_data = base64.b64encode(f.read()).decode("ascii")
+            # Kitty chunked graphics transmission
+            return f"\033_Ga=T,f=100,t=d;{b64_data}\033\\"
+        except Exception:
+            pass
+
+    # 3. ANSI TrueColor Half-Block Fallback (Works in ANY 24-bit terminal on macOS, Linux, Windows)
+    try:
+        from PIL import Image
+        img = Image.open(image_path).convert("RGB")
+        # Scale to max_cols x (max_rows * 2) because each character cell has 2 vertical subpixels (▀)
+        w, h = img.size
+        aspect = w / max(1, h)
+        target_w = min(max_cols, w)
+        target_h = int(target_w / max(0.1, aspect * 2))
+        target_h = min(max_rows, max(1, target_h)) * 2
+
+        img = img.resize((target_w, target_h), Image.Resampling.BILINEAR)
+        pix = img.load()
+
+        lines = []
+        for y in range(0, target_h, 2):
+            line_parts = []
+            for x in range(target_w):
+                r_top, g_top, b_top = pix[x, y]
+                if y + 1 < target_h:
+                    r_bot, g_bot, b_bot = pix[x, y + 1]
+                    # ▀ with fg=top, bg=bot
+                    line_parts.append(f"\033[38;2;{r_top};{g_top};{b_top}m\033[48;2;{r_bot};{g_bot};{b_bot}m▀")
+                else:
+                    line_parts.append(f"\033[38;2;{r_top};{g_top};{b_top}m▀")
+            line_parts.append("\033[0m")
+            lines.append("".join(line_parts))
+        return "\n".join(lines)
+    except Exception:
+        pass
+
+    # 4. Graceful metadata banner
+    size_kb = os.path.getsize(image_path) / 1024.0
+    return f"🖼️ [Image: {os.path.basename(image_path)} ({size_kb:.1f} KB)]"