deepparallel 0.2.0__py3-none-any.whl

deepparallel/branding.py

@@ -0,0 +1,211 @@
+"""Compact Rich UI for the DeepParallel CLI.
+
+Brand-forward: leads with "DeepParallel" and attributes Crowe Logic. Keeps
+the underlying model and Azure/Foundry transport internals out of the surface.
+
+Identity accent stays cyan (DP_ACCENT); the glyph alphabet, gutter layout, and
+status colors follow the Crowe Logic CLI family patterns.
+"""
+
+from __future__ import annotations
+
+from rich import box
+from rich.console import Console, Group
+from rich.markdown import Markdown
+from rich.padding import Padding
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+DP_ACCENT = "bright_cyan"
+CROWE_ACCENT = "bright_green"
+DIM = "grey50"
+
+GREEN_HEX = "#6fbf73"
+RED_HEX = "#bf6f6f"
+AMBER_HEX = "#d4a645"
+BLUE_HEX = "#8fa4bf"
+WHITE_HEX = "#ffffff"
+
+MARK = "◆"
+RULE = "─"
+DOT = "·"
+BAR = "│"
+CHECK = "✓"
+CROSS = "✗"
+ARROW = "›"
+GUTTER = 2
+TRANSCRIPT_MAX_WIDTH = 96
+
+
+def welcome(backend_label: str) -> None:
+    title = Text("DeepParallel", style=f"bold {DP_ACCENT}")
+    body = Text()
+    body.append("served via ", style=DIM)
+    body.append("Crowe Logic\n", style=f"bold {CROWE_ACCENT}")
+    body.append("Backend: ", style=DIM)
+    body.append(backend_label, style="white")
+    body.append("\n\nType your question. ", style=DIM)
+    body.append("/help", style="bold")
+    body.append(" for commands, ", style=DIM)
+    body.append("/quit", style="bold")
+    body.append(" to exit.", style=DIM)
+    console.print(Panel(body, title=title, border_style=DP_ACCENT, box=box.ROUNDED))
+
+
+def user_prefix() -> str:
+    return f"[bold {CROWE_ACCENT}]you[/] "
+
+
+def model_prefix() -> str:
+    return f"[bold {DP_ACCENT}]DeepParallel[/] "
+
+
+def thinking(text: str) -> None:
+    console.print(f"[{DIM}]{text}[/]", end="", soft_wrap=True, highlight=False)
+
+
+def info(msg: str) -> None:
+    console.print(f"[{DIM}]{msg}[/]")
+
+
+def error(msg: str) -> None:
+    console.print(f"[bold red]error[/] {msg}")
+
+
+def attribution_footer() -> None:
+    console.print(
+        f"[{DIM}]DeepParallel - served via Crowe Logic infrastructure. https://crowelogic.com[/]"
+    )
+
+
+def preview_tool_args(args: str, limit: int = 84) -> str:
+    """Compact a tool argument/result string to a single truncated line."""
+    s = " ".join(str(args).split())
+    if len(s) > limit:
+        return s[:limit] + "..."
+    return s
+
+
+def _gutter(renderable):
+    return Padding(renderable, (0, 0, 0, GUTTER))
+
+
+def render_tool_card(
+    console: Console,
+    name: str,
+    args: str,
+    status: str,
+    result: str = "",
+    duration_ms: int = 0,
+) -> None:
+    """Render a tool call as a running line, or a done/failed panel."""
+    if status == "running":
+        line = Text()
+        line.append(f"{ARROW} ", style=DP_ACCENT)
+        line.append("ACTION ", style=AMBER_HEX)
+        line.append(name, style=f"bold {DP_ACCENT}")
+        if args:
+            line.append("  " + preview_tool_args(args), style=DIM)
+        console.print(_gutter(line))
+        return
+
+    ok = status == "ok"
+    glyph = CHECK if ok else CROSS
+    accent = GREEN_HEX if ok else RED_HEX
+    header = Text()
+    header.append(f"{glyph} ", style=accent)
+    header.append(name, style=f"bold {DP_ACCENT}")
+    header.append(f"  {DOT} {duration_ms / 1000:.1f}s", style=DIM)
+    parts = [header]
+    if args:
+        parts.append(Text(preview_tool_args(args), style=DIM))
+    if result:
+        parts.append(Text(preview_tool_args(result, limit=200), style=WHITE_HEX))
+    group = Group(*parts) if len(parts) > 1 else header
+    console.print(_gutter(Panel(group, border_style=accent, box=box.ROUNDED)))
+
+
+def render_error(console: Console, title: str, detail: str = "") -> None:
+    """Render a red error block with an optional detail body."""
+    header = Text()
+    header.append(f"{CROSS} ", style=RED_HEX)
+    header.append(title, style=f"bold {RED_HEX}")
+    group = Group(header, Text(detail, style=DIM)) if detail else header
+    console.print(_gutter(Panel(group, border_style=RED_HEX, box=box.ROUNDED)))
+
+
+def render_confirm_body(console: Console, action_title: str, detail: str) -> None:
+    """Render the confirmation panel (title + detail + y/n hint). The y/n read
+    happens in the renderer, not here, so this stays pure and testable."""
+    body = Text()
+    body.append(action_title + "\n", style=f"bold {AMBER_HEX}")
+    for line in detail.splitlines():
+        body.append(line + "\n", style=DIM)
+    body.append(f"{ARROW} approve? [y/n]", style=AMBER_HEX)
+    console.print(_gutter(Panel(body, border_style=AMBER_HEX, box=box.ROUNDED)))
+
+
+def build_transcript_markdown(console: Console, text: str, title: str = "answer"):
+    """Build a bordered markdown panel for an answer block."""
+    return _gutter(
+        Panel(
+            Markdown(text or ""),
+            title=Text(f"{MARK} {title}", style=DP_ACCENT),
+            title_align="left",
+            border_style=DP_ACCENT,
+            box=box.ROUNDED,
+        )
+    )
+
+
+_WORDMARK = (
+    "████  █████ █████ ████  ████  █████ ████  █████ █     █     █████ █    \n"
+    "█   █ █     █     █   █ █   █ █   █ █   █ █   █ █     █     █     █    \n"
+    "█   █ ████  ████  ████  ████  █████ ████  █████ █     █     ████  █    \n"
+    "█   █ █     █     █     █     █   █ █  █  █   █ █     █     █     █    \n"
+    "████  █████ █████ █     █     █   █ █   █ █   █ █████ █████ █████ █████"
+)
+
+
+def wordmark_lines() -> list[str]:
+    """The full DEEPPARALLEL block-letter banner, one string per row.
+
+    The D, both P stems, and the parallel 'll' share a left vertical stroke,
+    so the letters align into a rhythm of parallel vertical bars - the logo
+    performs the brand (parallel models, one verdict).
+    """
+    return _WORDMARK.split("\n")
+
+
+def status_text(
+    *, version: str, tool_count: int, fusion_modes: tuple[str, ...], backend_label: str
+):
+    """Build the intro status + tips block shown under the wordmark."""
+    fusion = " · ".join(fusion_modes) if fusion_modes else "off"
+    body = Text()
+    body.append("DeepParallel", style=f"bold {DP_ACCENT}")
+    body.append(f"  {DOT} v{version}  {DOT} ", style=DIM)
+    body.append("served via Crowe Logic\n", style=f"bold {CROWE_ACCENT}")
+    body.append(f"{tool_count} tools", style=WHITE_HEX)
+    body.append(f"  {DOT} fusion: {fusion}\n", style=DIM)
+    body.append("Backend: ", style=DIM)
+    body.append(f"{backend_label}\n\n", style="white")
+    body.append("/help", style="bold")
+    body.append("  /tools  /fast //deep //fuse  ", style=DIM)
+    body.append("/quit", style="bold")
+    return _gutter(body)
+
+
+def build_reasoning_panel(console: Console, text: str):
+    """Build a dim reasoning panel, visually distinct from the answer."""
+    return _gutter(
+        Panel(
+            Text(text or "", style=DIM),
+            title=Text(f"{MARK} reasoning", style=DIM),
+            title_align="left",
+            border_style=DIM,
+            box=box.ROUNDED,
+        )
+    )