glaip-sdk 0.7.10__py3-none-any.whl → 0.7.11__py3-none-any.whl

glaip_sdk/cli/slash/tui/context.py

@@ -44,17 +44,20 @@ class TUIContext:
     clipboard: ClipboardAdapter | None = None
 
     @classmethod
-    async def create(cls) -> TUIContext:
+    async def create(cls, *, detect_osc11: bool = True) -> TUIContext:
         """Create a TUIContext instance with detected terminal capabilities.
 
         This factory method detects terminal capabilities asynchronously and
         returns a populated TUIContext instance with all services initialized
         (keybinds, theme, toasts, clipboard).
 
+        Args:
+            detect_osc11: When False, skip OSC 11 background detection.
+
         Returns:
             TUIContext instance with all services initialized.
         """
-        terminal = await TerminalCapabilities.detect()
+        terminal = await TerminalCapabilities.detect(detect_osc11=detect_osc11)
         store = get_account_store()
         settings = load_tui_settings(store=store)
 

glaip_sdk/cli/slash/tui/layouts/__init__.py

@@ -0,0 +1,14 @@
+"""Layout components for TUI applications.
+
+This package provides reusable layout components following the Harlequin pattern
+for multi-pane data-rich screens.
+"""
+
+from __future__ import annotations
+
+try:  # pragma: no cover - optional dependency
+    from glaip_sdk.cli.slash.tui.layouts.harlequin import HarlequinScreen
+except Exception:  # pragma: no cover - optional dependency
+    HarlequinScreen = None  # type: ignore[assignment, misc]
+
+__all__ = ["HarlequinScreen"]

glaip_sdk/cli/slash/tui/layouts/harlequin.py

@@ -0,0 +1,160 @@
+"""Harlequin layout base class for multi-pane TUI screens.
+
+This module provides the HarlequinScreen base class, which implements a modern
+multi-pane "Harlequin" layout pattern for data-rich TUI screens. The layout uses
+a 25/75 split with a list on the left and detail content on the right.
+
+The Harlequin pattern is inspired by the Harlequin SQL client and provides:
+- Left Pane (25%): ListView or compact table for item selection
+- Right Pane (75%): Detail dashboard showing all fields, status, and action buttons
+- Black background (#000000) that overrides terminal transparency
+- Primary Blue borders (#005CB8)
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+try:  # pragma: no cover - optional dependency
+    from textual.containers import Container, Horizontal, Vertical
+    from textual.screen import Screen
+except Exception:  # pragma: no cover - optional dependency
+
+    class Screen:  # type: ignore[no-redef]
+        """Fallback Screen stub when Textual is unavailable."""
+
+        def __class_getitem__(cls, _):
+            """Return the class for typing subscripts."""
+            return cls
+
+    Horizontal = None  # type: ignore[assignment]
+    Vertical = None  # type: ignore[assignment]
+    Container = None  # type: ignore[assignment]
+
+if TYPE_CHECKING:
+    from glaip_sdk.cli.slash.tui.context import TUIContext
+
+try:  # pragma: no cover - optional dependency
+    from glaip_sdk.cli.slash.tui.toast import Toast
+except Exception:  # pragma: no cover - optional dependency
+    Toast = None  # type: ignore[assignment, misc]
+
+# GDP Labs Brand Palette
+PRIMARY_BLUE = "#005CB8"
+BLACK_BACKGROUND = "#000000"
+
+
+class HarlequinScreen(Screen[None]):  # type: ignore[misc]
+    """Base class for Harlequin-style multi-pane screens.
+
+    This screen provides a 25/75 split layout with a left pane for navigation
+    and a right pane for details. The layout uses a black background that
+    overrides terminal transparency and primary blue borders.
+
+    Subclasses should override `compose()` to add their specific widgets to
+    the left and right panes. Use the container IDs "left-pane" and "right-pane"
+    to target specific panes in CSS or when querying widgets.
+
+    Example:
+        ```python
+        class AccountHarlequinScreen(HarlequinScreen):
+            def compose(self) -> ComposeResult:
+                yield from super().compose()
+                # Add widgets to left and right panes
+                self.query_one("#left-pane").mount(AccountListView())
+                self.query_one("#right-pane").mount(AccountDetailView())
+        ```
+
+    CSS:
+        The screen includes default styling for the Harlequin layout:
+        - Black background (#000000) for the entire screen
+        - Primary blue borders (#005CB8) for panes
+        - 25% width for left pane, 75% width for right pane
+    """
+
+    CSS = """
+    HarlequinScreen {
+        background: #000000;
+        layers: base toasts;
+    }
+
+    #harlequin-container {
+        width: 100%;
+        height: 100%;
+    }
+
+    #left-pane {
+        width: 25%;
+        border: solid #005CB8;
+        background: #000000;
+    }
+
+    #right-pane {
+        width: 75%;
+        border: solid #005CB8;
+        background: #000000;
+    }
+
+    #toast-container {
+        width: 100%;
+        height: auto;
+        dock: top;
+        align: right top;
+        layer: toasts;
+    }
+    """
+
+    def __init__(
+        self,
+        *,
+        ctx: TUIContext | None = None,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+    ) -> None:
+        """Initialize the Harlequin screen.
+
+        Args:
+            ctx: Optional TUI context for accessing services (keybinds, theme, toasts, clipboard).
+            name: Optional name for the screen.
+            id: Optional ID for the screen.
+            classes: Optional CSS classes for the screen.
+        """
+        super().__init__(name=name, id=id, classes=classes)
+        self._ctx: TUIContext | None = ctx
+
+    def compose(self) -> Any:
+        """Compose the Harlequin layout with left and right panes.
+
+        This method creates the base 25/75 split layout. Subclasses should
+        call `super().compose()` and then add their specific widgets to the
+        left and right panes.
+
+        Returns:
+            ComposeResult yielding the base layout containers.
+        """
+        if Horizontal is None or Vertical is None or Container is None:
+            return
+
+        # Main container with horizontal split (25/75)
+        yield Horizontal(
+            Vertical(id="left-pane"),
+            Vertical(id="right-pane"),
+            id="harlequin-container",
+        )
+
+        # Toast container for notifications
+        if Toast is not None and Container is not None:
+            yield Container(Toast(), id="toast-container")
+
+    @property
+    def ctx(self) -> TUIContext | None:
+        """Get the TUI context if available.
+
+        Returns:
+            TUIContext instance or None if not provided.
+        """
+        return self._ctx

glaip_sdk/cli/slash/tui/terminal.py

@@ -71,7 +71,7 @@ class TerminalCapabilities:
         return "light" if luminance > 0.5 else "dark"
 
     @classmethod
-    async def detect(cls) -> TerminalCapabilities:
+    async def detect(cls, *, detect_osc11: bool = True) -> TerminalCapabilities:
         """Detect terminal capabilities asynchronously with fast timeout.
 
         This method performs capability detection including OSC 11 background
@@ -80,6 +80,9 @@ class TerminalCapabilities:
         if the terminal doesn't respond within the timeout; use
         detect_terminal_background() for full 1-second timeout when needed.
 
+        Args:
+            detect_osc11: When False, skip OSC 11 background detection.
+
         Returns:
             TerminalCapabilities instance with detected capabilities.
         """
@@ -93,8 +96,10 @@ class TerminalCapabilities:
         mouse = tty_available and term not in ("dumb", "")
         truecolor = colorterm in ("truecolor", "24bit")
 
-        # OSC 11 detection: use fast path (<100ms timeout)
-        osc11_bg: str | None = await _detect_osc11_fast()
+        osc11_bg: str | None = None
+        if detect_osc11 and tty_available and sys.stdin.isatty():
+            # OSC 11 detection: use fast path (<100ms timeout)
+            osc11_bg = await _detect_osc11_fast()
 
         return cls(
             tty=tty_available,

{glaip_sdk-0.7.10.dist-info → glaip_sdk-0.7.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glaip-sdk
-Version: 0.7.10
+Version: 0.7.11
 Summary: Python SDK and CLI for GL AIP (GDP Labs AI Agent Package) - Build, run, and manage AI agents
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 License: MIT

{glaip_sdk-0.7.10.dist-info → glaip_sdk-0.7.11.dist-info}/RECORD

@@ -1,6 +1,6 @@
 glaip_sdk/__init__.py,sha256=YpePGKbCjwqCwvb8yig8cc64z876ch1oSlTlu-CiWfs,1722
 glaip_sdk/_version.py,sha256=5CHGCxx_36fgmMWuEx6jJ2CzzM-i9eBFyQWFwBi23XE,2259
-glaip_sdk/branding.py,sha256=tLqYCIHMkUf8p2smpuAGNptwaKUN38G4mlh0A0DOl_w,7823
+glaip_sdk/branding.py,sha256=uF_-c-cg_rFjzJr0NibLiE1Dvv0DpXBXN63wl-Ej88c,11651
 glaip_sdk/exceptions.py,sha256=iAChFClkytXRBLP0vZq1_YjoZxA9i4m4bW1gDLiGR1g,2321
 glaip_sdk/icons.py,sha256=J5THz0ReAmDwIiIooh1_G3Le-mwTJyEjhJDdJ13KRxM,524
 glaip_sdk/rich_components.py,sha256=44Z0V1ZQleVh9gUDGwRR5mriiYFnVGOhm7fFxZYbP8c,4052
@@ -78,18 +78,20 @@ glaip_sdk/cli/slash/accounts_shared.py,sha256=Mq5HxlI0YsVEQ0KKISWvyBZhzOFFWCzwRb
 glaip_sdk/cli/slash/agent_session.py,sha256=tuVOme-NbEyr6rwJvsBEKZYWQmsaRf4piJeRvIGu0ns,11384
 glaip_sdk/cli/slash/prompt.py,sha256=q4f1c2zr7ZMUeO6AgOBF2Nz4qgMOXrVPt6WzPRQMbAM,8501
 glaip_sdk/cli/slash/remote_runs_controller.py,sha256=iLl4a-mu9QU7dcedgEILewPtDIVtFUJkbKGtcx1F66U,21445
-glaip_sdk/cli/slash/session.py,sha256=Zn2hXND_Tfameh_PI8g4VIMd7GPWxwhtPNMN9p6cF7M,65081
+glaip_sdk/cli/slash/session.py,sha256=YJ7UIeWyged1znmBVnGweOzH2l4NKeF5lT9VGdDvQWo,75998
 glaip_sdk/cli/slash/tui/__init__.py,sha256=oBUzeoslYwPKVlhqhgg4I7480b77vQNc9ec0NgdTC1s,977
-glaip_sdk/cli/slash/tui/accounts.tcss,sha256=w_9w2dXxjopMed-3_SWZ3KJiOYNa8hReW6DEKRprcic,1344
-glaip_sdk/cli/slash/tui/accounts_app.py,sha256=hYpxOTG3zwS_t41WaCv9K-fPYL6b380EeAUCjNUtbJo,43520
+glaip_sdk/cli/slash/tui/accounts.tcss,sha256=eqFMAuN3PI3YVNDUbrCQpO1-Ko5WZpempPq75_Aejq0,2159
+glaip_sdk/cli/slash/tui/accounts_app.py,sha256=thS4r1NELB9K_OoEI4uJdDGSkRyhzek_2Y0k0yoPvss,71799
 glaip_sdk/cli/slash/tui/background_tasks.py,sha256=SAe1mV2vXB3mJcSGhelU950vf8Lifjhws9iomyIVFKw,2422
 glaip_sdk/cli/slash/tui/clipboard.py,sha256=7fEshhTwHYaj-n7n0W0AsWTs8W0RLZw_9luXxrFTrtw,6227
-glaip_sdk/cli/slash/tui/context.py,sha256=XgHsXPl8LDDwIueP_jhP6xqpx_zHOk0FF19rWob_z5Q,3128
+glaip_sdk/cli/slash/tui/context.py,sha256=v7XOdRtk5AQ4ZE-QWUhc1s9xVROu8_JjdjVnKx0X9p8,3270
 glaip_sdk/cli/slash/tui/keybind_registry.py,sha256=_rK05BxTxNudYc4iJ9gDxpgeUkjDAq8rarIT-9A-jyM,6739
 glaip_sdk/cli/slash/tui/loading.py,sha256=nW5pv_Tnl9FUOPR3Qf2O5gt1AGHSo3b5-Uofg34F6AE,1909
 glaip_sdk/cli/slash/tui/remote_runs_app.py,sha256=DOmUHeaBg8puERn-htDnYAJgcUHETl457HamQkd0nxY,28550
-glaip_sdk/cli/slash/tui/terminal.py,sha256=iC31XChTL34gXY6vXdSIX3HmD36tuA9EYTPZ2Sn4uOI,12108
+glaip_sdk/cli/slash/tui/terminal.py,sha256=ZAC3sB17TGpl-GFeRVm_nI8DQTN3pyti3ynlZ41wT_A,12323
 glaip_sdk/cli/slash/tui/toast.py,sha256=QLL6BBBMjEagzpSEPf3PNBNzQG_EdN5JeAigk66AjVs,11920
+glaip_sdk/cli/slash/tui/layouts/__init__.py,sha256=KT77pZHa7Wz84QlHYT2mfhQ_AXUA-T0eHv_HtAvc1ac,473
+glaip_sdk/cli/slash/tui/layouts/harlequin.py,sha256=pR5BHdWCVK0QZCyr8q6O-vCL_MTZKjMVASdYzkFUkt4,5122
 glaip_sdk/cli/slash/tui/theme/__init__.py,sha256=rtM2ik83YNCRcI1qh_Sf3rnxco2OvCNNT3NbHY6cLvw,432
 glaip_sdk/cli/slash/tui/theme/catalog.py,sha256=G52eU3h8YI9D8XUALVg1KVZ4Lq65VnZdgPS3F_P7XLE,2544
 glaip_sdk/cli/slash/tui/theme/manager.py,sha256=LBnxEMIwz-8cAlZGYk5tIoAJbOJyGYsmDlyuGJ-LlX4,3945
@@ -210,8 +212,8 @@ glaip_sdk/utils/rendering/steps/format.py,sha256=Chnq7OBaj8XMeBntSBxrX5zSmrYeGcO
 glaip_sdk/utils/rendering/steps/manager.py,sha256=BiBmTeQMQhjRMykgICXsXNYh1hGsss-fH9BIGVMWFi0,13194
 glaip_sdk/utils/rendering/viewer/__init__.py,sha256=XrxmE2cMAozqrzo1jtDFm8HqNtvDcYi2mAhXLXn5CjI,457
 glaip_sdk/utils/rendering/viewer/presenter.py,sha256=mlLMTjnyeyPVtsyrAbz1BJu9lFGQSlS-voZ-_Cuugv0,5725
-glaip_sdk-0.7.10.dist-info/METADATA,sha256=2UcLS7TmXIdgiLE6Ab3U_FtpompLMq4bshiGrqRi3jI,8528
-glaip_sdk-0.7.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-glaip_sdk-0.7.10.dist-info/entry_points.txt,sha256=NkhO6FfgX9Zrjn63GuKphf-dLw7KNJvucAcXc7P3aMk,54
-glaip_sdk-0.7.10.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
-glaip_sdk-0.7.10.dist-info/RECORD,,
+glaip_sdk-0.7.11.dist-info/METADATA,sha256=gciVvZkveuvBnlisXPXr-XdATU28Dm0PPZpzfsqaTAk,8528
+glaip_sdk-0.7.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+glaip_sdk-0.7.11.dist-info/entry_points.txt,sha256=NkhO6FfgX9Zrjn63GuKphf-dLw7KNJvucAcXc7P3aMk,54
+glaip_sdk-0.7.11.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
+glaip_sdk-0.7.11.dist-info/RECORD,,