glaip-sdk 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

glaip_sdk/cli/commands/agents.py

@@ -994,7 +994,7 @@ def _handle_command_exception(ctx: Any, e: Exception) -> None:
     handle_json_output(ctx, error=e)
     if get_ctx_value(ctx, "view") != "json":
         print_api_error(e)
-    raise click.ClickException(str(e)) from e
+    raise click.exceptions.Exit(1) from e
 
 
 def _handle_creation_exception(ctx: Any, e: Exception) -> None:

glaip_sdk/cli/commands/configure.py

@@ -11,7 +11,6 @@ from rich.console import Console
 from rich.text import Text
 
 from glaip_sdk import Client
-from glaip_sdk._version import __version__ as _SDK_VERSION
 from glaip_sdk.branding import (
     ACCENT_STYLE,
     ERROR_STYLE,
@@ -24,7 +23,7 @@ from glaip_sdk.branding import (
 )
 from glaip_sdk.cli.config import CONFIG_FILE, load_config, save_config
 from glaip_sdk.cli.rich_helpers import markup_text
-from glaip_sdk.cli.utils import command_hint, format_command_hint
+from glaip_sdk.cli.utils import command_hint, format_command_hint, sdk_version
 from glaip_sdk.icons import ICON_TOOL
 from glaip_sdk.rich_components import AIPTable
 
@@ -196,7 +195,7 @@ def _render_config_table(config: dict[str, str]) -> None:
 
 
 def _render_configuration_header() -> None:
-    branding = AIPBranding.create_from_sdk(sdk_version=_SDK_VERSION, package_name="glaip-sdk")
+    branding = AIPBranding.create_from_sdk(sdk_version=sdk_version(), package_name="glaip-sdk")
     heading = "[bold]>_ GDP Labs AI Agents Package (AIP CLI)[/bold]"
     console.print(heading)
     console.print()

glaip_sdk/cli/display.py

@@ -117,7 +117,12 @@ def print_api_error(e: Exception) -> None:
         console.print(f"[{ERROR_STYLE}]Error: {e}[/]")
         return
 
-    console.print(f"[{ERROR_STYLE}]API Error: {e}[/]")
+    error_text = str(e).strip()
+    if not error_text:
+        error_text = "Unknown error"
+    if "\n" in error_text:
+        error_text = error_text.splitlines()[0]
+    console.print(f"[{ERROR_STYLE}]API Error: {error_text}[/]")
     status_code = getattr(e, "status_code", None)
     if status_code is not None:
         console.print(f"[{WARNING_STYLE}]Status: {status_code}[/]")

glaip_sdk/cli/main.py

@@ -13,7 +13,6 @@ import click
 from rich.console import Console
 
 from glaip_sdk import Client
-from glaip_sdk._version import __version__ as _SDK_VERSION
 from glaip_sdk.branding import (
     ERROR,
     ERROR_STYLE,
@@ -38,7 +37,7 @@ from glaip_sdk.cli.commands.update import update_command
 from glaip_sdk.cli.config import load_config
 from glaip_sdk.cli.transcript import get_transcript_cache_stats
 from glaip_sdk.cli.update_notifier import maybe_notify_update
-from glaip_sdk.cli.utils import in_slash_mode, spinner_context, update_spinner
+from glaip_sdk.cli.utils import in_slash_mode, sdk_version, spinner_context, update_spinner
 from glaip_sdk.config.constants import (
     DEFAULT_AGENT_RUN_TIMEOUT,
 )
@@ -75,7 +74,7 @@ def _format_size(num: int) -> str:
 
 
 @click.group(invoke_without_command=True)
-@click.version_option(version=_SDK_VERSION, prog_name="aip")
+@click.version_option(package_name="glaip-sdk", prog_name="aip")
 @click.option(
     "--api-url",
     envvar="AIP_API_URL",
@@ -136,7 +135,7 @@ def main(
     if not ctx.resilient_parsing and ctx.obj["tty"] and not launching_slash:
         console = Console()
         maybe_notify_update(
-            _SDK_VERSION,
+            sdk_version(),
             console=console,
             ctx=ctx,
             slash_command="update",
@@ -215,7 +214,7 @@ def _validate_config_and_show_error(config: dict, console: Console) -> None:
                 border_style=ERROR,
             )
         )
-        console.print(f"\n[{SUCCESS_STYLE}]✅ AIP - Ready[/] (SDK v{_SDK_VERSION}) - Configure to connect")
+        console.print(f"\n[{SUCCESS_STYLE}]✅ AIP - Ready[/] (SDK v{sdk_version()}) - Configure to connect")
         sys.exit(1)
 
 
@@ -233,7 +232,7 @@ def _render_status_heading(console: Console, slash_mode: bool) -> None:
     del slash_mode  # heading now consistent across invocation contexts
     console.print(f"[{INFO_STYLE}]GL AIP status[/]")
     console.print()
-    console.print(f"[{SUCCESS_STYLE}]✅ GL AIP ready[/] (SDK v{_SDK_VERSION})")
+    console.print(f"[{SUCCESS_STYLE}]✅ GL AIP ready[/] (SDK v{sdk_version()})")
 
 
 def _collect_cache_summary() -> tuple[str | None, str | None]:
@@ -391,7 +390,7 @@ def status(ctx: Any) -> None:
 @main.command()
 def version() -> None:
     """Show version information."""
-    branding = AIPBranding.create_from_sdk(sdk_version=_SDK_VERSION, package_name="glaip-sdk")
+    branding = AIPBranding.create_from_sdk(sdk_version=sdk_version(), package_name="glaip-sdk")
     branding.display_version_panel()
 
 

glaip_sdk/cli/transcript/capture.py

@@ -8,8 +8,11 @@ from __future__ import annotations
 
 import json
 from dataclasses import dataclass
+from io import StringIO
 from typing import Any
 
+from rich.console import Console
+
 from glaip_sdk.cli.transcript.cache import (
     TranscriptPayload,
     TranscriptStoreResult,
@@ -164,6 +167,38 @@ def _format_step_display_name(name: str) -> str:
         return name
 
 
+def _extract_step_summary_lines(renderer: Any) -> list[str]:
+    """Render the live steps summary to plain text lines."""
+    if not hasattr(renderer, "_render_steps_text"):
+        return []
+
+    try:
+        renderable = renderer._render_steps_text()
+    except Exception:
+        return []
+
+    buffer = StringIO()
+    console = Console(file=buffer, record=True, force_terminal=False, width=120)
+    try:
+        console.print(renderable)
+    except Exception:
+        return []
+
+    text = console.export_text() or buffer.getvalue()
+    lines = [line.rstrip() for line in text.splitlines()]
+    half = len(lines) // 2
+    if half and lines[:half] == lines[half : half * 2]:
+        return lines[:half]
+    start = 0
+    prefixes = ("🤖", "🔧", "💭", "├", "└", "│", "•")
+    for idx, line in enumerate(lines):
+        if line.lstrip().startswith(prefixes):
+            start = idx
+            break
+    trimmed = lines[start:]
+    return [line for line in trimmed if line]
+
+
 def _collect_renderer_outputs(
     renderer: Any, final_result: Any
 ) -> tuple[
@@ -203,6 +238,10 @@ def _derive_transcript_meta(
     if step_summaries:
         meta["transcript_steps"] = step_summaries
 
+    step_lines = _extract_step_summary_lines(renderer)
+    if step_lines:
+        meta["transcript_step_lines"] = step_lines
+
     stream_processor = getattr(renderer, "stream_processor", None)
     stream_started_at = (
         getattr(stream_processor, "streaming_started_at", None) if stream_processor is not None else None

glaip_sdk/cli/transcript/viewer.py

@@ -25,7 +25,7 @@ except Exception:  # pragma: no cover - optional dependency
     Choice = None  # type: ignore[assignment]
 
 from glaip_sdk.cli.transcript.cache import suggest_filename
-from glaip_sdk.icons import ICON_DELEGATE, ICON_TOOL_STEP
+from glaip_sdk.icons import ICON_AGENT, ICON_DELEGATE, ICON_TOOL_STEP
 from glaip_sdk.rich_components import AIPPanel
 from glaip_sdk.utils.rendering.formatting import (
     build_connector_prefix,
@@ -355,12 +355,16 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
         self.console.print()
 
     def _render_steps_summary(self) -> None:
-        tree_text = self._build_tree_summary_text()
-        if tree_text is not None:
-            body = tree_text
+        stored_lines = self.ctx.meta.get("transcript_step_lines")
+        if stored_lines:
+            body = Text("\n".join(stored_lines), style="dim")
         else:
-            panel_content = self._format_steps_summary(self._build_step_summary())
-            body = Text(panel_content, style="dim")
+            tree_text = self._build_tree_summary_text()
+            if tree_text is not None:
+                body = tree_text
+            else:
+                panel_content = self._format_steps_summary(self._build_step_summary())
+                body = Text(panel_content, style="dim")
         panel = AIPPanel(body, title="Steps", border_style="blue")
         self.console.print(panel)
         self.console.print()
@@ -477,6 +481,8 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
         if not lines:
             return None
 
+        self._decorate_root_presentation(manager, roots[0], lines)
+
         return Text("\n".join(lines), style="dim")
 
     def _render_tree_branch(
@@ -491,7 +497,6 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
         step = manager.by_id.get(step_id)
         if not step:
             return
-
         suppress = self._should_hide_step(step)
         children = manager.children.get(step_id, [])
 
@@ -518,15 +523,34 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
             )
 
     def _should_hide_step(self, step: Any) -> bool:
-        if getattr(step, "parent_id", None) is not None:
+        if getattr(step, "parent_id", None) is None:
             return False
-        if getattr(step, "kind", None) == "thinking":
-            return True
-        if getattr(step, "kind", None) == "agent":
-            return True
         name = getattr(step, "name", "") or ""
         return self._looks_like_uuid(name)
 
+    def _decorate_root_presentation(
+        self,
+        manager: StepManager,
+        root_id: str,
+        lines: list[str],
+    ) -> None:
+        if not lines:
+            return
+
+        root_step = manager.by_id.get(root_id)
+        if not root_step:
+            return
+
+        original_label = getattr(root_step, "display_label", None)
+        root_step.display_label = self._friendly_root_label(root_step, original_label)
+        lines[0] = self._format_tree_line(root_step, ())
+        if original_label is not None:
+            root_step.display_label = original_label
+
+        query = self._get_user_query()
+        if query:
+            lines.insert(1, f"     {query}")
+
     def _coerce_step_event(self, event: dict[str, Any]) -> dict[str, Any] | None:
         metadata = event.get("metadata")
         if not isinstance(metadata, dict):
@@ -567,6 +591,18 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
 
         return line
 
+    def _friendly_root_label(self, step: Any, fallback: str | None) -> str:
+        agent_name = self.ctx.manifest_entry.get("agent_name") or (self.ctx.meta or {}).get("agent_name")
+        agent_id = self.ctx.manifest_entry.get("agent_id") or getattr(step, "name", "")
+
+        if not agent_name:
+            return fallback or agent_id or ICON_AGENT
+
+        parts = [ICON_AGENT, agent_name]
+        if agent_id and agent_id != agent_name:
+            parts.append(f"({agent_id})")
+        return " ".join(parts)
+
     @staticmethod
     def _format_duration_badge(step: Any) -> str | None:
         duration_ms = getattr(step, "duration_ms", None)
@@ -602,7 +638,7 @@ class PostRunViewer:  # pragma: no cover - interactive flows are not unit tested
 
     @staticmethod
     def _looks_like_uuid(value: str) -> bool:
-        stripped = value.replace("-", "")
+        stripped = value.replace("-", "").replace(" ", "")
         if len(stripped) not in {32, 36}:
             return False
         return all(ch in "0123456789abcdefABCDEF" for ch in stripped)

glaip_sdk/cli/utils.py

@@ -21,6 +21,7 @@ from rich.console import Console, Group
 from rich.markdown import Markdown
 from rich.pretty import Pretty
 
+from glaip_sdk import _version as _version_module
 from glaip_sdk.branding import (
     ACCENT_STYLE,
     HINT_COMMAND_STYLE,
@@ -74,6 +75,8 @@ from glaip_sdk.utils.rendering.renderer import (
 console = Console()
 pager.console = console
 logger = logging.getLogger("glaip_sdk.cli.utils")
+_version_logger = logging.getLogger("glaip_sdk.cli.version")
+_WARNED_SDK_VERSION_FALLBACK = False
 
 
 # ----------------------------- Context helpers ---------------------------- #
@@ -151,6 +154,20 @@ def format_command_hint(
     return highlighted
 
 
+def sdk_version() -> str:
+    """Return the current SDK version, warning if metadata is unavailable."""
+    version = getattr(_version_module, "__version__", None)
+    if isinstance(version, str) and version:
+        return version
+
+    global _WARNED_SDK_VERSION_FALLBACK
+    if not _WARNED_SDK_VERSION_FALLBACK:
+        _version_logger.warning("Unable to resolve glaip-sdk version metadata; using fallback '0.0.0'.")
+        _WARNED_SDK_VERSION_FALLBACK = True
+
+    return "0.0.0"
+
+
 def spinner_context(
     ctx: Any | None,
     message: str,
@@ -917,7 +934,6 @@ def build_renderer(
     _ctx: Any,
     *,
     save_path: str | os.PathLike[str] | None,
-    theme: str = "dark",
     verbose: bool = False,
     _tty_enabled: bool = True,
     live: bool | None = None,
@@ -928,7 +944,6 @@ def build_renderer(
     Args:
         _ctx: Click context object for CLI operations.
         save_path: Path to save output to (enables capturing console).
-        theme: Color theme ("dark" or "light").
         verbose: Whether to enable verbose mode.
         _tty_enabled: Whether TTY is available for interactive features.
         live: Whether to enable live rendering mode (overrides verbose default).
@@ -942,11 +957,7 @@ def build_renderer(
 
     # Configure renderer based on verbose mode and explicit overrides
     live_enabled = bool(live) if live is not None else not verbose
-    style = "debug" if verbose else "pretty"
-
     renderer_cfg = RendererConfig(
-        theme=theme,
-        style=style,
         live=live_enabled,
         append_finished_snapshots=bool(snapshots)
         if snapshots is not None

glaip_sdk/client/run_rendering.py

@@ -149,8 +149,6 @@ class AgentRunRenderingManager:
 
     def _create_verbose_renderer(self) -> RichStreamRenderer:
         verbose_config = RendererConfig(
-            theme="dark",
-            style="debug",
             live=False,
             append_finished_snapshots=False,
         )

glaip_sdk/utils/rendering/renderer/base.py

@@ -50,7 +50,11 @@ from glaip_sdk.utils.rendering.renderer.progress import (
     is_delegation_tool,
 )
 from glaip_sdk.utils.rendering.renderer.stream import StreamProcessor
-from glaip_sdk.utils.rendering.steps import StepManager
+from glaip_sdk.utils.rendering.renderer.summary_window import clamp_step_nodes
+from glaip_sdk.utils.rendering.steps import UNKNOWN_STEP_DETAIL, StepManager
+
+DEFAULT_RENDERER_THEME = "dark"
+_NO_STEPS_TEXT = Text("No steps yet", style="dim")
 
 # Configure logger
 logger = logging.getLogger("glaip_sdk.run_renderer")
@@ -344,6 +348,32 @@ class RichStreamRenderer:
         if query:
             self.console.print(self._build_user_query_panel(query))
 
+    def _render_summary_after_transcript_toggle(self) -> None:
+        """Render the summary panel after leaving transcript mode."""
+        if self.state.finalizing_ui:
+            self._render_final_summary_panels()
+        elif self.live:
+            self._refresh_live_panels()
+        else:
+            self._render_static_summary_panels()
+
+    def _render_final_summary_panels(self) -> None:
+        """Render a static summary and disable live mode for final output."""
+        self.cfg.live = False
+        self.live = None
+        self._render_static_summary_panels()
+
+    def _render_static_summary_panels(self) -> None:
+        """Render the steps and main panels in a static (non-live) layout."""
+        steps_renderable = self._render_steps_text()
+        steps_panel = AIPPanel(
+            steps_renderable,
+            title="Steps",
+            border_style="blue",
+        )
+        self.console.print(steps_panel)
+        self.console.print(self._render_main_panel())
+
     def _ensure_streaming_started_baseline(self, timestamp: float) -> None:
         """Synchronize streaming start state across renderer components."""
         self.state.streaming_started_at = timestamp
@@ -872,7 +902,7 @@ class RichStreamRenderer:
             final_panel = create_final_panel(
                 body,
                 title=self._final_panel_title(),
-                theme=self.cfg.theme,
+                theme=DEFAULT_RENDERER_THEME,
             )
             self.console.print(final_panel)
             self.state.printed_final_output = True
@@ -1023,11 +1053,11 @@ class RichStreamRenderer:
                 return create_final_panel(
                     final_content,
                     title=title,
-                    theme=self.cfg.theme,
+                    theme=DEFAULT_RENDERER_THEME,
                 )
         # Dynamic title with spinner + elapsed/hints
         title = self._format_enhanced_main_title()
-        return create_main_panel(body, title, self.cfg.theme)
+        return create_main_panel(body, title, DEFAULT_RENDERER_THEME)
 
     def _final_panel_title(self) -> str:
         """Compose title for the final result panel including duration."""
@@ -1042,8 +1072,6 @@ class RichStreamRenderer:
             return
 
         self.verbose = verbose
-        self.cfg.style = "debug" if verbose else "pretty"
-
         desired_live = not verbose
         if desired_live != self.cfg.live:
             self.cfg.live = desired_live
@@ -1089,26 +1117,16 @@ class RichStreamRenderer:
             self._transcript_header_printed = False
             self._transcript_enabled_message_printed = False
             self._clear_console_safe()
-            self._render_summary_static_sections()
-            summary_notice = (
-                "[dim]Returning to the summary view. Streaming will continue here.[/dim]"
-                if not self.state.finalizing_ui
-                else "[dim]Returning to the summary view.[/dim]"
-            )
-            self.console.print(summary_notice)
-            if self.live:
-                self._refresh_live_panels()
-            else:
-                steps_renderable = self._render_steps_text()
-                steps_panel = AIPPanel(
-                    steps_renderable,
-                    title="Steps",
-                    border_style="blue",
-                )
-                self.console.print(steps_panel)
-                self.console.print(self._render_main_panel())
-            if not self.state.finalizing_ui:
-                self._print_summary_hint(force=True)
+        self._render_summary_static_sections()
+        summary_notice = (
+            "[dim]Returning to the summary view. Streaming will continue here.[/dim]"
+            if not self.state.finalizing_ui
+            else "[dim]Returning to the summary view.[/dim]"
+        )
+        self.console.print(summary_notice)
+        self._render_summary_after_transcript_toggle()
+        if not self.state.finalizing_ui:
+            self._print_summary_hint(force=True)
 
     def _clear_console_safe(self) -> None:
         """Best-effort console clear that ignores platform quirks."""
@@ -1529,7 +1547,7 @@ class RichStreamRenderer:
             title=adjusted_title,
             content=body_text or "(no output)",
             status="finished",
-            theme=self.cfg.theme,
+            theme=DEFAULT_RENDERER_THEME,
             is_delegation=is_delegation_tool(finished_tool_name),
         )
 
@@ -1774,7 +1792,7 @@ class RichStreamRenderer:
             return normalise_display_label(label)
 
         if not (step.name or "").strip():
-            return "Unknown step detail"
+            return UNKNOWN_STEP_DETAIL
 
         icon = self._get_step_icon(step.kind)
         base_name = self._get_step_display_name(step)
@@ -2111,21 +2129,69 @@ class RichStreamRenderer:
     def _render_steps_text(self) -> Any:
         """Render the steps panel content."""
         if not (self.steps.order or self.steps.children):
-            return Text("No steps yet", style="dim")
+            return _NO_STEPS_TEXT.copy()
+
+        nodes = list(self.steps.iter_tree())
+        if not nodes:
+            return _NO_STEPS_TEXT.copy()
+
+        window = self._summary_window_size()
+        display_nodes, header_notice, footer_notice = clamp_step_nodes(
+            nodes,
+            window=window,
+            get_label=self._get_step_label,
+            get_parent=self._get_step_parent,
+        )
+        step_renderables = self._build_step_renderables(display_nodes)
+
+        if not step_renderables and not header_notice and not footer_notice:
+            return _NO_STEPS_TEXT.copy()
+
+        return self._assemble_step_renderables(step_renderables, header_notice, footer_notice)
+
+    def _get_step_label(self, step_id: str) -> str:
+        """Get label for a step by ID."""
+        step = self.steps.by_id.get(step_id)
+        if step:
+            return self._resolve_step_label(step)
+        return UNKNOWN_STEP_DETAIL
+
+    def _get_step_parent(self, step_id: str) -> str | None:
+        """Get parent ID for a step by ID."""
+        step = self.steps.by_id.get(step_id)
+        return step.parent_id if step else None
 
+    def _summary_window_size(self) -> int:
+        """Return the active window size for step display."""
+        if self.state.finalizing_ui:
+            return 0
+        return int(self.cfg.summary_display_window or 0)
+
+    def _assemble_step_renderables(self, step_renderables: list[Any], header_notice: Any, footer_notice: Any) -> Any:
+        """Assemble step renderables with header and footer into final output."""
         renderables: list[Any] = []
-        for step_id, branch_state in self.steps.iter_tree():
+        if header_notice is not None:
+            renderables.append(header_notice)
+        renderables.extend(step_renderables)
+        if footer_notice is not None:
+            renderables.append(footer_notice)
+
+        if len(renderables) == 1:
+            return renderables[0]
+
+        return Group(*renderables)
+
+    def _build_step_renderables(self, display_nodes: list[tuple[str, tuple[bool, ...]]]) -> list[Any]:
+        """Convert step nodes to renderables for the steps panel."""
+        renderables: list[Any] = []
+        for step_id, branch_state in display_nodes:
             step = self.steps.by_id.get(step_id)
             if not step:
                 continue
             renderable = self._compose_step_renderable(step, branch_state)
             if renderable is not None:
                 renderables.append(renderable)
-
-        if not renderables:
-            return Text("No steps yet", style="dim")
-
-        return Group(*renderables)
+        return renderables
 
     def _update_final_duration(self, duration: float | None, *, overwrite: bool = False) -> None:
         """Store formatted duration for eventual final panels."""

glaip_sdk/utils/rendering/renderer/config.py

@@ -13,16 +13,12 @@ from dataclasses import dataclass
 class RendererConfig:
     """Configuration for the RichStreamRenderer."""
 
-    # Style and layout
-    theme: str = "dark"  # dark|light
-    style: str = "pretty"  # pretty|debug|minimal
-
     # Performance
-    think_threshold: float = 0.7
     refresh_debounce: float = 0.25
     render_thinking: bool = True
     live: bool = True
     persist_live: bool = True
+    summary_display_window: int = 20
 
     # Scrollback/append options
     summary_max_steps: int = 0

glaip_sdk/utils/rendering/renderer/stream.py

@@ -156,27 +156,6 @@ class StreamProcessor:
         if context_id:
             self.last_event_time_by_ctx[context_id] = monotonic()
 
-    def should_insert_thinking_gap(self, task_id: str | None, context_id: str | None, think_threshold: float) -> bool:
-        """Determine if a thinking gap should be inserted.
-
-        Args:
-            task_id: Task identifier
-            context_id: Context identifier
-            think_threshold: Threshold for thinking gap
-
-        Returns:
-            True if thinking gap should be inserted
-        """
-        if not task_id or not context_id:
-            return False
-
-        last_time = self.last_event_time_by_ctx.get(context_id)
-        if last_time is None:
-            return True
-
-        elapsed = monotonic() - last_time
-        return elapsed >= think_threshold
-
     def track_tools_and_agents(
         self,
         tool_name: str | None,

glaip_sdk/utils/rendering/renderer/summary_window.py

@@ -0,0 +1,79 @@
+"""Helpers for clamping the steps summary view to a rolling window.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+
+from rich.text import Text
+
+Node = tuple[str, tuple[bool, ...]]
+LabelFn = Callable[[str], str]
+ParentFn = Callable[[str], str | None]
+
+
+def clamp_step_nodes(
+    nodes: list[Node],
+    *,
+    window: int,
+    get_label: LabelFn,
+    get_parent: ParentFn,
+) -> tuple[list[Node], Text | None, Text | None]:
+    """Return a windowed slice of nodes plus optional header/footer notices."""
+    if window <= 0 or len(nodes) <= window:
+        return nodes, None, None
+
+    start_index = len(nodes) - window
+    first_visible_step_id = nodes[start_index][0]
+    header = _build_header(first_visible_step_id, window, len(nodes), get_label, get_parent)
+    footer = _build_footer(len(nodes) - window)
+    return nodes[start_index:], header, footer
+
+
+def _build_header(
+    step_id: str,
+    window: int,
+    total: int,
+    get_label: LabelFn,
+    get_parent: ParentFn,
+) -> Text:
+    """Construct the leading notice for a truncated window."""
+    parts = [f"… (latest {window} of {total} steps shown"]
+    path = _collect_path_labels(step_id, get_label, get_parent)
+    if path:
+        parts.append("; continuing with ")
+        parts.append(" / ".join(path))
+    parts.append(")")
+    return Text("".join(parts), style="dim")
+
+
+def _build_footer(hidden_count: int) -> Text:
+    """Construct the footer notice indicating hidden steps."""
+    noun = "step" if hidden_count == 1 else "steps"
+    message = f"{hidden_count} earlier {noun} hidden. Press Ctrl+T to inspect the full transcript."
+    return Text(message, style="dim")
+
+
+def _collect_path_labels(
+    step_id: str,
+    get_label: LabelFn,
+    get_parent: ParentFn,
+) -> list[str]:
+    """Collect labels for the ancestry of the provided step."""
+    labels: list[str] = []
+    seen: set[str] = set()
+    current = step_id
+    while current and current not in seen:
+        seen.add(current)
+        label = get_label(current)
+        if label:
+            labels.append(label)
+        parent = get_parent(current)
+        if not parent:
+            break
+        current = parent
+    labels.reverse()
+    return labels

{glaip_sdk-0.1.2.dist-info → glaip_sdk-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: glaip-sdk
-Version: 0.1.2
+Version: 0.1.4
 Summary: Python SDK for GL AIP (GDP Labs AI Agent Package) - Simplified CLI Design
 License: MIT
 Author: Raymond Christopher

{glaip_sdk-0.1.2.dist-info → glaip_sdk-0.1.4.dist-info}/RECORD

@@ -5,17 +5,17 @@ glaip_sdk/cli/__init__.py,sha256=xCCfuF1Yc7mpCDcfhHZTX0vizvtrDSLeT8MJ3V7m5A0,156
 glaip_sdk/cli/agent_config.py,sha256=YAbFKrTNTRqNA6b0i0Q3pH-01rhHDRi5v8dxSFwGSwM,2401
 glaip_sdk/cli/auth.py,sha256=oZLgZTqVgx_o2ppcp1ueFwuu88acOUPUr9ed1WDe_HY,15860
 glaip_sdk/cli/commands/__init__.py,sha256=N2go38u3C0MPxfDXk-K2zz93OnqSTpQyOE6dIC82lHg,191
-glaip_sdk/cli/commands/agents.py,sha256=l2Uy6tN8SCZ4CEY7P__Wx3CrcIcaG51exbqUh63-cVs,43901
-glaip_sdk/cli/commands/configure.py,sha256=7dmMSs-rMRETtpWgUDEGeNedSJl04yrp6VCRiLEpBUI,9074
+glaip_sdk/cli/commands/agents.py,sha256=t80p_olOL4htn8VZJSBizj5ajeKomVaeN72iP1fk72I,43897
+glaip_sdk/cli/commands/configure.py,sha256=xBOvT5FkfAxPMoaT8we9gltY5jjcIs1j0w33OH8Gk-A,9029
 glaip_sdk/cli/commands/mcps.py,sha256=oYzL52gUImi5x5mx8grbWkTwUTpAp7VoYGalOzEyLqU,37465
 glaip_sdk/cli/commands/models.py,sha256=CQrjIwVeZED6AQXJ321UVB8IvmGrEjOIWrtlgDBu6HI,1775
 glaip_sdk/cli/commands/tools.py,sha256=5y0ec1K1sNvLv0MwvEY0ggb5xiU2k2O2FsWL6k9NDxI,19102
 glaip_sdk/cli/commands/update.py,sha256=rIZo_x-tvpvcwpQLpwYwso1ix6qTHuNNTL4egmn5fEM,1812
 glaip_sdk/cli/config.py,sha256=sZLG0wPlLegl71g_J4PZxWb46wCZJgtEQQ5ppsr45CU,1297
 glaip_sdk/cli/context.py,sha256=M4weRf8dmp5bMtPLRF3w1StnRB7Lo8FPFq2GQMv3Rv8,3617
-glaip_sdk/cli/display.py,sha256=22L3dt8exPd4_dtjpTmg1vwYqoNLLkTB_8GLukMfkyg,11209
+glaip_sdk/cli/display.py,sha256=AIB81s85ejMg-nM-CIAQ5s3pmVDo6oNykUW680rluJw,11385
 glaip_sdk/cli/io.py,sha256=_7qHA3K4VfzNXP7NYHShby_Bw9xigJ26oIaESXYDAQ8,3678
-glaip_sdk/cli/main.py,sha256=ESxVe_m5NDXPUc9XMHhgneH4MtBVOZpxdwPyYDtNz64,17110
+glaip_sdk/cli/main.py,sha256=JFhFFxTx2gkC2Pjm5oJpDviG1dYCKaUsTYrOM_fTG00,17072
 glaip_sdk/cli/masking.py,sha256=BOZjwUqxQf3LQlYgUMwq7UYgve8x4_1Qk04ixiJJPZ8,4399
 glaip_sdk/cli/mcp_validators.py,sha256=cwbz7p_p7_9xVuuF96OBQOdmEgo5UObU6iWWQ2X03PI,10047
 glaip_sdk/cli/pager.py,sha256=Cp1t47ViCUW3T3IkHdRBF2yNOrVLrnIBIemTxBso17Q,8049
@@ -29,12 +29,12 @@ glaip_sdk/cli/slash/prompt.py,sha256=4rCGSu56EEj24J42vHWAuJNwiUE5Cb6AK3gOhpms38k
 glaip_sdk/cli/slash/session.py,sha256=A8xO4gKZENmEwVGp6BN8791kuo2cjEJlaLlhsITc5vI,41191
 glaip_sdk/cli/transcript/__init__.py,sha256=zQNgAETJsj2tO3OmuINgXiCQCmh_ODzI6HQPPmxMXVs,1816
 glaip_sdk/cli/transcript/cache.py,sha256=1jZdrLo9CebXuKnD1tIiMJy2-6D-zjf0WmJcBJ5gOvE,9760
-glaip_sdk/cli/transcript/capture.py,sha256=d3WZW13NQ3Xq_8qt-WScveFXzV06iV89IPqZBAGIGIc,8221
+glaip_sdk/cli/transcript/capture.py,sha256=1Oguv9syhp7n4eb42-gw90X19RqEe4phnrq9T1oj8Pw,9397
 glaip_sdk/cli/transcript/export.py,sha256=reCvrZVzli8_LzYe5ZNdaa-MwZ1ov2RjnDzKZWr_6-E,1117
 glaip_sdk/cli/transcript/launcher.py,sha256=z5ivkPXDQJpATIqtRLUK8jH3p3WIZ72PvOPqYRDMJvw,2327
-glaip_sdk/cli/transcript/viewer.py,sha256=goQiIAAR2nL0jWnRggFTcpSQE0rts7O8nfHDtSGV78c,26698
+glaip_sdk/cli/transcript/viewer.py,sha256=dsEPki92XuVICneXZSfVq73rED_ryjxpu4_mY40qgwM,28030
 glaip_sdk/cli/update_notifier.py,sha256=4h3F7q2DoMGyJSp8tu5NJHt8yeCVBOL-3A0ZyHyvRpw,9532
-glaip_sdk/cli/utils.py,sha256=JTcfMIJr-aN_g3iI2VD33h9W9Ai06TEzaVqzWhd6MGQ,40750
+glaip_sdk/cli/utils.py,sha256=P-gpIfwiMe5h5nkXaQXawo8gqscajVm5GVqPWTtAj0U,41222
 glaip_sdk/cli/validators.py,sha256=Squ2W-fMz9kfvhtTt7pCcAYnzFU28ZxxTEqH1vF9r00,5620
 glaip_sdk/client/__init__.py,sha256=nYLXfBVTTWwKjP0e63iumPYO4k5FifwWaELQPaPIKIg,188
 glaip_sdk/client/_agent_payloads.py,sha256=QjaSqXZvDNX0bQVKC7Eb5nHj7KxhU0zLSfNUQiKf2J8,16269
@@ -42,7 +42,7 @@ glaip_sdk/client/agents.py,sha256=hRkt-D2ZRkeWamPqKsqKwl74ZjScKL4UHLbbVezGCWc,37
 glaip_sdk/client/base.py,sha256=ikW33raz2M6rXzo3JmhttfXXuVdMv5zBRKEZkU1F-4I,18176
 glaip_sdk/client/main.py,sha256=tELAA36rzthnNKTgwZ6lLPb3Au8Wh1mF8Kz-9N-YtCg,8652
 glaip_sdk/client/mcps.py,sha256=GQ1EBTSVc-WrFigyw8iocK34DT3TMW85XtnDeOawP9E,8945
-glaip_sdk/client/run_rendering.py,sha256=T6NF3SjTWSV6IpU2TexBq8AFKU1yq98NLsTp1N4B2yk,12209
+glaip_sdk/client/run_rendering.py,sha256=gtXdOow1U-eol17l3kOf_EjaBwcuqHoKlgiQfuyI10w,12156
 glaip_sdk/client/tools.py,sha256=xCPqDqtVNePCBeJvbKDqzZI-jbaduIeWd-6XbCSg_2Y,17324
 glaip_sdk/client/validators.py,sha256=ioF9VCs-LG2yLkaRDd7Hff74lojDZZ0_Q3CiLbdm1RY,8381
 glaip_sdk/config/constants.py,sha256=B9CSlYG8LYjQuo_vNpqy-eSks3ej37FMcvJMy6d_F4U,888
@@ -62,13 +62,14 @@ glaip_sdk/utils/rendering/__init__.py,sha256=vXjwk5rPhhfPyD8S0DnV4GFFEtPJp4HCCg1
 glaip_sdk/utils/rendering/formatting.py,sha256=PBT1jD6pxpkiUSs5RQOVWImmKgAwbWuQCUpgu0PNs3Q,8828
 glaip_sdk/utils/rendering/models.py,sha256=wB9QtEiwN-AaY8k_YKBBT2qMQSBNMv27VcaZH88DdCM,2823
 glaip_sdk/utils/rendering/renderer/__init__.py,sha256=gQEbZhZl9qXEVKDDTy0ijd-RnHWdqcazcJyOmORDwEk,2843
-glaip_sdk/utils/rendering/renderer/base.py,sha256=yQbZv5iihsL-Nov9N0Ko80NrIXV60T9kEakL2RoDPNg,82992
-glaip_sdk/utils/rendering/renderer/config.py,sha256=ePomLA3iBHkjk5bJftvuMx_qVtT83nbj4YrFSZqGRAs,734
+glaip_sdk/utils/rendering/renderer/base.py,sha256=Obm5J9UopxgPfYZSfXwU6AqhGDGNyFqsmiMVKGzgUZg,85660
+glaip_sdk/utils/rendering/renderer/config.py,sha256=FgSAZpG1g7Atm2MXg0tY0lOEciY90MR-RO6YuGFhp0E,626
 glaip_sdk/utils/rendering/renderer/console.py,sha256=4cLOw4Q1fkHkApuj6dWW8eYpeYdcT0t2SO5MbVt5UTc,1844
 glaip_sdk/utils/rendering/renderer/debug.py,sha256=_qPP03RicGhCCCAEEJ2zoSEJaUT2ZvgL4xOF5ikg9Uw,5569
 glaip_sdk/utils/rendering/renderer/panels.py,sha256=tbExgFXzK6NHlvuJlVwsejznGJY1ALwTi9KfIej9aWM,3784
 glaip_sdk/utils/rendering/renderer/progress.py,sha256=iwAx76q0hdnjDrHMF_MB2AYQ2kAA4pwfIn0FiSAEkyg,4068
-glaip_sdk/utils/rendering/renderer/stream.py,sha256=41JF-0rj-Tbp_ze7WVbHxDINf7bQRTu5sFzRjluQIBk,8545
+glaip_sdk/utils/rendering/renderer/stream.py,sha256=Y0egKCdWSdM5kGiiDG5Bwc1VQuimI-NUlal2kDojb08,7862
+glaip_sdk/utils/rendering/renderer/summary_window.py,sha256=ffBsVHaUyy2RfIuXLjhfiO31HeeprVcPP_pe4cjDLsU,2286
 glaip_sdk/utils/rendering/renderer/toggle.py,sha256=N3LB4g1r8EdDkQyItQdrP5gig6Sszz9uZ6WJuD0KUmk,5396
 glaip_sdk/utils/rendering/step_tree_state.py,sha256=EItKFTV2FYvm5pSyHbXk7lkzJ-0DW_s-VENIBZe8sp4,4062
 glaip_sdk/utils/rendering/steps.py,sha256=J9qEZLnGqxeEWrlsDczvAJS1pbCN19sjD5_OZbMoinA,42275
@@ -76,7 +77,7 @@ glaip_sdk/utils/resource_refs.py,sha256=OpwJxTCKq3RIqLAmKE0xspJplD4IhKqLCo0OqPaf
 glaip_sdk/utils/run_renderer.py,sha256=d_VMI6LbvHPUUeRmGqh5wK_lHqDEIAcym2iqpbtDad0,1365
 glaip_sdk/utils/serialization.py,sha256=cvlPQ73y4jhsbJeQ6Bv7vaq0NV8uZ27p2vD_R-nyiRQ,12646
 glaip_sdk/utils/validation.py,sha256=NPDexNgGUIoLkEIz6hl3K6EG7ZKSEkcNLDElqm8-Ng4,7019
-glaip_sdk-0.1.2.dist-info/METADATA,sha256=VQWPGOU1y8-yuf8bUrODnK24DVrobD9GJ_wJxAfhybk,6023
-glaip_sdk-0.1.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-glaip_sdk-0.1.2.dist-info/entry_points.txt,sha256=EGs8NO8J1fdFMWA3CsF7sKBEvtHb_fujdCoNPhfMouE,47
-glaip_sdk-0.1.2.dist-info/RECORD,,
+glaip_sdk-0.1.4.dist-info/METADATA,sha256=lNUe3-_HnPLjOtB1hlourCsQG4bnl2FpDfThEcKRJnQ,6023
+glaip_sdk-0.1.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+glaip_sdk-0.1.4.dist-info/entry_points.txt,sha256=EGs8NO8J1fdFMWA3CsF7sKBEvtHb_fujdCoNPhfMouE,47
+glaip_sdk-0.1.4.dist-info/RECORD,,