hud-python 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

hud/utils/design.py

@@ -28,96 +28,111 @@ DIM = "dim"
 class HUDDesign:
     """Design system for HUD CLI output."""
 
-    def __init__(self, console: Console | None = None, stderr: bool = False) -> None:
-        """Initialize the design system.
+    def __init__(self) -> None:
+        """Initialize the design system."""
+        self._stdout_console = Console(stderr=False)
+        self._stderr_console = Console(stderr=True)
 
-        Args:
-            console: Rich console instance. Creates new one if not provided.
-            stderr: If True, output to stderr instead of stdout.
-        """
-        self.console = console or Console(stderr=stderr)
-
-    def header(self, title: str, icon: str = "🚀") -> None:
+    def header(self, title: str, icon: str = "🚀", stderr: bool = True) -> None:
         """Print a header panel with gold border.
 
         Args:
             title: The title text
             icon: Optional emoji icon
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(Panel.fit(f"{icon} [bold]{title}[/bold]", border_style=GOLD))
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(Panel.fit(f"{icon} [bold]{title}[/bold]", border_style=GOLD))
 
-    def section_title(self, title: str) -> None:
+    def section_title(self, title: str, stderr: bool = True) -> None:
         """Print a section title in gold.
 
         Args:
             title: The section title
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"\n[bold {GOLD}]{title}[/bold {GOLD}]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"\n[bold {GOLD}]{title}[/bold {GOLD}]")
 
-    def success(self, message: str) -> None:
+    def success(self, message: str, stderr: bool = True) -> None:
         """Print a success message.
 
         Args:
             message: The success message
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[{GREEN} not bold]✅ {message}[/{GREEN} not bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[{GREEN} not bold]✅ {message}[/{GREEN} not bold]")
 
-    def error(self, message: str) -> None:
+    def error(self, message: str, stderr: bool = True) -> None:
         """Print an error message.
 
         Args:
             message: The error message
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[{RED} not bold]❌ {message}[/{RED} not bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[{RED} not bold]❌ {message}[/{RED} not bold]")
 
-    def warning(self, message: str) -> None:
+    def warning(self, message: str, stderr: bool = True) -> None:
         """Print a warning message.
 
         Args:
             message: The warning message
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[yellow]⚠️  {message}[/yellow]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[yellow]⚠️  {message}[/yellow]")
 
-    def info(self, message: str) -> None:
+    def info(self, message: str, stderr: bool = True) -> None:
         """Print an info message.
 
         Args:
             message: The info message
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[default not bold]{message}[/default not bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[default not bold]{message}[/default not bold]")
 
-    def dim_info(self, label: str, value: str) -> None:
+    def dim_info(self, label: str, value: str, stderr: bool = True) -> None:
         """Print dimmed info with a label.
 
         Args:
             label: The label text
             value: The value text
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[{DIM}]{label}[/{DIM}] [default]{value}[/default]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[{DIM}]{label}[/{DIM}] [default]{value}[/default]")
 
-    def link(self, url: str) -> None:
+    def link(self, url: str, stderr: bool = True) -> None:
         """Print an underlined link.
 
         Args:
             url: The URL to display
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[default not bold underline]{url}[/default not bold underline]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[default not bold underline]{url}[/default not bold underline]")
 
-    def json_config(self, json_str: str) -> None:
+    def json_config(self, json_str: str, stderr: bool = True) -> None:
         """Print JSON configuration with light theme.
 
         Args:
             json_str: JSON string to display
+            stderr: If True, output to stderr (default), otherwise stdout
         """
         # Just print the JSON as plain text to avoid any syntax coloring
-        self.console.print(f"[default not bold]{json_str}[/default not bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[default not bold]{json_str}[/default not bold]")
 
-    def key_value_table(self, data: dict[str, str], show_header: bool = False) -> None:
+    def key_value_table(self, data: dict[str, str], show_header: bool = False, stderr: bool = True) -> None:
         """Print a key-value table.
 
         Args:
             data: Dictionary of key-value pairs
             show_header: Whether to show table header
+            stderr: If True, output to stderr (default), otherwise stdout
         """
         table = Table(show_header=show_header, box=None, padding=(0, 1))
         table.add_column("Key", style=DIM, no_wrap=True)
@@ -126,42 +141,95 @@ class HUDDesign:
         for key, value in data.items():
             table.add_row(key, value)
 
-        self.console.print(table)
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(table)
 
-    def progress_message(self, message: str) -> None:
+    def progress_message(self, message: str, stderr: bool = True) -> None:
         """Print a progress message.
 
         Args:
             message: The progress message
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[{DIM} not bold]{message}[/{DIM} not bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[{DIM} not bold]{message}[/{DIM} not bold]")
 
-    def phase(self, phase_num: int, title: str) -> None:
+    def phase(self, phase_num: int, title: str, stderr: bool = True) -> None:
         """Print a phase header (for debug command).
 
         Args:
             phase_num: Phase number
             title: Phase title
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"\n{'=' * 80}", style=GOLD)
-        self.console.print(f"[bold {GOLD}]PHASE {phase_num}: {title}[/bold {GOLD}]")
-        self.console.print(f"{'=' * 80}", style=GOLD)
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"\n{'=' * 80}", style=GOLD)
+        console.print(f"[bold {GOLD}]PHASE {phase_num}: {title}[/bold {GOLD}]")
+        console.print(f"{'=' * 80}", style=GOLD)
 
-    def command(self, cmd: list[str]) -> None:
+    def command(self, cmd: list[str], stderr: bool = True) -> None:
         """Print a command being executed.
 
         Args:
             cmd: Command parts as list
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"[bold]$ {' '.join(cmd)}[/bold]")
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"[bold]$ {' '.join(cmd)}[/bold]")
 
-    def hint(self, hint: str) -> None:
+    def hint(self, hint: str, stderr: bool = True) -> None:
         """Print a hint message.
 
         Args:
             hint: The hint text
+            stderr: If True, output to stderr (default), otherwise stdout
+        """
+        console = self._stderr_console if stderr else self._stdout_console
+        console.print(f"\n[yellow]💡 Hint: {hint}[/yellow]")
+
+    def status_item(self, label: str, value: str, status: str = "success", primary: bool = False, stderr: bool = True) -> None:
+        """Print a status item with indicator.
+
+        Args:
+            label: The label text
+            value: The value text
+            status: Status type - "success" (✓), "error" (✗), "warning" (⚠), "info" (•)
+            primary: If True, highlight the value as primary
+            stderr: If True, output to stderr (default), otherwise stdout
+        """
+        indicators = {
+            "success": f"[{GREEN} not bold]✓[/{GREEN} not bold]",
+            "error": f"[{RED} not bold]✗[/{RED} not bold]",
+            "warning": "[yellow]⚠[/yellow]",
+            "info": f"[{DIM}]•[/{DIM}]"
+        }
+        
+        indicator = indicators.get(status, indicators["info"])
+        console = self._stderr_console if stderr else self._stdout_console
+        
+        if primary:
+            console.print(f"{indicator} {label}: [bold cyan]{value}[/bold cyan]")
+        else:
+            console.print(f"{indicator} {label}: {value}")
+
+    def command_example(self, command: str, description: str | None = None, stderr: bool = True) -> None:
+        """Print a command example with cyan highlighting.
+
+        Args:
+            command: The command to show
+            description: Optional description after the command
+            stderr: If True, output to stderr (default), otherwise stdout
         """
-        self.console.print(f"\n[yellow]💡 Hint: {hint}[/yellow]")
+        console = self._stderr_console if stderr else self._stdout_console
+        if description:
+            console.print(f"  [cyan]{command}[/cyan]  # {description}")
+        else:
+            console.print(f"  [cyan]{command}[/cyan]")
+
+    @property
+    def console(self) -> Console:
+        """Get the stderr console for direct access when needed."""
+        return self._stderr_console
 
 
 # Global design instance for convenience

hud/utils/mcp.py

@@ -20,7 +20,7 @@ def patch_mcp_config(mcp_config: dict[str, dict[str, Any]], patch: MCPConfigPatc
 
     for server_cfg in mcp_config.values():
         url = server_cfg.get("url", "")
-
+        
         # 1) HTTP header lane (only for hud MCP servers)
         if hud_mcp_url in url and patch.headers:
             for key, value in patch.headers.items():

hud/utils/tests/test_version.py

@@ -5,4 +5,4 @@ def test_import():
     """Test that the package can be imported."""
     import hud
 
-    assert hud.__version__ == "0.4.2"
+    assert hud.__version__ == "0.4.4"

hud/version.py

@@ -4,4 +4,4 @@ Version information for the HUD SDK.
 
 from __future__ import annotations
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"

{hud_python-0.4.2.dist-info → hud_python-0.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hud-python
-Version: 0.4.2
+Version: 0.4.4
 Summary: SDK for the HUD platform.
 Project-URL: Homepage, https://github.com/hud-evals/hud-python
 Project-URL: Bug Tracker, https://github.com/hud-evals/hud-python/issues
@@ -202,7 +202,7 @@ The above example let's the agent play 2048 ([See replay](https://app.hud.so/tra
 
 ## Reinforcement Learning with GRPO
 
-This is a Qwen-2.5-3B agent training a policy on the [`text-2048`](environments/text_2048/) environment (see above) using [Verifiers](rl/README):
+This is a Qwen-2.5-3B agent training a policy on the [`text-2048`](environments/text_2048/) environment (see above) using [Verifiers](rl/):
 
 ![RL curve](https://raw.githubusercontent.com/hud-evals/hud-python/main/docs/src/images/rl_2.png)
 

{hud_python-0.4.2.dist-info → hud_python-0.4.4.dist-info}/RECORD

@@ -1,16 +1,16 @@
 hud/__init__.py,sha256=BjAhZtsHbGN371Q8t3o4v4jltedkmDE85xW0yOILU9g,397
-hud/datasets.py,sha256=3QIZyAdbzlSghE44EIhehWOAoE8CPvLyS40FM2X2a4U,11892
+hud/datasets.py,sha256=8lqC840kcNx01D2CcWZCd1j0eZTpepILmQrvohZIZYU,12056
 hud/settings.py,sha256=WIJDsyrfwBZGcaGT46YUOpW8xjBZl3siXXprd92ASAg,2039
 hud/types.py,sha256=pQWOPYXUZ2hhK0h-AHBc3DCj5tkbRXHqKZnsQQIcSFA,4237
-hud/version.py,sha256=npIZLGW0QouBuUp2GO8yLq33HW7-l4Zd9UXWHtiYJos,104
+hud/version.py,sha256=QEfeo6B5z3dSkp5MkR5F8LT9XsfB07YYIiqrl2l0xTQ,104
 hud/agents/__init__.py,sha256=UoIkljWdbq4bM0LD-mSaw6w826EqdEjOk7r6glNYwYQ,286
 hud/agents/base.py,sha256=OdvuPMMZFGMft5PEkImjs_nWi-05hJyGJMBSOGbtxBo,22258
 hud/agents/claude.py,sha256=snbYFPW-KAkw4n9Rdz7dC2f46RuSHJKC53HPm8SucFM,14273
-hud/agents/langchain.py,sha256=FTofalIKYZEM7W2AQ1OErk8Jdo47V4tDT7xaiR8RDsA,9129
+hud/agents/langchain.py,sha256=_2ZJT1S1yREI0p2WSQkgcTmECaLXwnmSOURQrNXTxkk,9524
 hud/agents/openai.py,sha256=kHG73mohO4uru49qmQiygUFt0eDCGJU06weqIUwTO3Y,14323
 hud/agents/openai_chat_generic.py,sha256=jTJ-KY6HkglPK0iwZH5v3PVnaUjDsWc9IbRo3AbXlyE,5322
 hud/agents/misc/__init__.py,sha256=BYi4Ytp9b_vycpZFXnr5Oyw6ncKLNNGml8Jrb7bWUb4,136
-hud/agents/misc/response_agent.py,sha256=qqvRSH-e5NaLXXUFSt3aXZauDE8JlWAabMymrJr9bd4,3036
+hud/agents/misc/response_agent.py,sha256=MsnIVElXM4ABrSJfEc_MMYp1Y_Rxmkq4kEGJ9vDX7hw,3098
 hud/agents/tests/__init__.py,sha256=W-O-_4i34d9TTyEHV-O_q1Ai1gLhzwDaaPo02_TWQIY,34
 hud/agents/tests/test_base.py,sha256=F39ajSqASGUbPyPoWSY9KARFav62qNTK74W11Tr1Tg4,28970
 hud/agents/tests/test_claude.py,sha256=wqEKlzEvx8obz1sSm4NY0j-Zyt1qWNfDOmRqYIuAEd0,13069
@@ -20,16 +20,16 @@ hud/cli/__init__.py,sha256=IsP148YyCod5gC-CduIN6MGGCLsITBe-kEtzE4NqbLo,21734
 hud/cli/__main__.py,sha256=fDH7XITyuDITwSDIVwRso06aouADO0CzTHKqp5TOwJE,143
 hud/cli/analyze.py,sha256=G-tjT1xLPLcYhDhZEaI7TAIS0z0OACUksnGFoAWd2ag,14416
 hud/cli/analyze_metadata.py,sha256=Mgs_je-XbPulG6noRLRNXe3_3a1eb20Cvxz5OQJ2NeU,8262
-hud/cli/build.py,sha256=4wMigENf6dpL9Eu0wN9SvgGWMHIh85IEJ1WKuNyVrfs,14263
+hud/cli/build.py,sha256=7GWBte4x6X24hZghEMC4Q0IBrBaFIf_eWZodkEHFba0,16693
 hud/cli/clone.py,sha256=AwVDIuhr8mHb1oT2Af2HrD25SiTdwATpE6zd93vzLgA,6099
 hud/cli/cursor.py,sha256=fy850p0rVp5k_1wwOCI7rK1SggbselJrywFInSQ2gio,3009
 hud/cli/debug.py,sha256=pa24bP4KVE0vdvrODuN57i2t8YDHxKJgwzXy7eD2tBE,13613
 hud/cli/docker_utils.py,sha256=5k5sXtI4V5d4VWRJR6lzVRy_Hu8Wf1nLsmW-dBNW0cM,2695
-hud/cli/init.py,sha256=wbGfKx-A17mSYw1aubRT3Ggt12A3PIkvZL6aW0AxoxU,7780
+hud/cli/init.py,sha256=Jb9h4MJPMNiUhr9GmmJjwjjmGQQOOMG1GadXIEsvKKk,7702
 hud/cli/interactive.py,sha256=w1fAoefizNKqjcl5Fi5EgEsUdPpXKcCFuU-Z-S3CL9o,12863
-hud/cli/mcp_server.py,sha256=ZdJA8M8DtLvda4xQOQ0MuEOTvRR8_ZEIaIW-Qs8DfZ0,29609
-hud/cli/pull.py,sha256=SmbaHXaDKgazovYbw4we1og1qtT-B4opEjiDOlaNZcs,11939
-hud/cli/push.py,sha256=Cbjiy0AAcvgFcatAz3H2t3IhxsHMbLlc0WcdQwXe9V0,14163
+hud/cli/mcp_server.py,sha256=kqXlHPm7ABVtP_MTJON5OgUAeVcXRuM-NrqqjBWYgd0,28221
+hud/cli/pull.py,sha256=8caEpiCsvHHMsQ9K7QRfZ8dC5Zq3G_OLF5YrUGHUP6E,11721
+hud/cli/push.py,sha256=MBee7EtcrzAHzmVWneT7hvHV9aF_hgxVRPoc1U1Oi1c,15626
 hud/cli/remote_runner.py,sha256=X01x6DeVkyc9HgxVCGEZJxEhhVPvHpAMoeYR44R8_BQ,9405
 hud/cli/runner.py,sha256=ukEr6ZmD5rs-taoEBu0P_-hr275d-ZE5_WAR-dvSqrw,4888
 hud/cli/utils.py,sha256=ZgjjKVPAa7dcfJ6SMBrdfZ63d1UnnhYC-zeh7gFBXsI,8841
@@ -44,9 +44,9 @@ hud/cli/tests/test_mcp_server.py,sha256=e5fh6AUcqdv0jp0rJ8VL-DdJ-1nNgS85N8Ua53eh
 hud/cli/tests/test_utils.py,sha256=dKmHgyLtDEqKVXlvs5tyNHyHhpBlZHUpmJF-iUraBVM,13466
 hud/clients/README.md,sha256=XNE3mch95ozDgVqfwCGcrhlHY9CwT1GKfNANNboowto,3826
 hud/clients/__init__.py,sha256=bcPIa7dwH5ENsjh7CzjsJ84fm7Ma93NBc2lGfSjGAKM,328
-hud/clients/base.py,sha256=vm8pQS7lwbfhOUyZsti94yzig6dcWIa6NOO3wwhl39w,13497
-hud/clients/fastmcp.py,sha256=kpVwgyltQB_gCeoD0kU9HYC1RHELaib-675qPztwfRg,8125
-hud/clients/mcp_use.py,sha256=G7jnfsFvGgye-LxyEMobgL47wxZ-Id1aq_5AQLuEaBE,11024
+hud/clients/base.py,sha256=y2yH8H4-cefWiI3oey_YPKLpDM2OwZ-hgvpjoOpEb8c,13459
+hud/clients/fastmcp.py,sha256=kocw7fpLbTnFmeE39XrPd5yyl5KY8kvtB_udLzQVRtg,9168
+hud/clients/mcp_use.py,sha256=Q1h3Hb9R1SVeue2CqhC5W7PqnQzuuAQf5T9O8GhzpbI,11981
 hud/clients/tests/__init__.py,sha256=sKOtJFFa4mDIXh1U6O8ZUHjigE8CiRMQ2PzJTIBZuVE,33
 hud/clients/tests/test_client_integration.py,sha256=kohU6jfCNfwSnAushHeB1_CmDlRfQc7VBL0GEdJYSeI,4198
 hud/clients/tests/test_fastmcp.py,sha256=4q3TzDjuieTZa89taiNJIrzbUncNkYOG4MaubypA21k,13030
@@ -113,8 +113,8 @@ hud/tools/tests/test_tools.py,sha256=paz28V98Am-oR7MBJPDgY-BRV14HQo_0F6X5JIC8aic
 hud/tools/tests/test_utils.py,sha256=oYxEnLpSA5sEeYFGUTj74QRNv0AHP3AjmYYHXgIW0BY,5496
 hud/utils/__init__.py,sha256=ckuIzwqgTxkzASa04XTPsOu_TqsRYUKBWUYfcSi3Xnc,164
 hud/utils/async_utils.py,sha256=5cKrJcnaHV2eJNxeyx0r7fPcdPTDBK7kM9-nLaF51X4,2409
-hud/utils/design.py,sha256=JZu4Fgfr_sOpH90oi1pu__woV56jPutCKsKAcmkHsUc,4987
-hud/utils/mcp.py,sha256=0r9_ffRObfAb6Zx6PRDJP6ibOTewOsQxJU0K-6JPveM,1847
+hud/utils/design.py,sha256=8-GHAegyJelQMdSSnY-MKXks2m3GVYHSW2Dlf17-daM,8965
+hud/utils/mcp.py,sha256=SQgEemHpIc0LshA0ImZw4nMzPPn1SE6qEO0dpNLwxy4,1855
 hud/utils/progress.py,sha256=suikwFM8sdSfkV10nAOEaInDhG4XKgOSvFePg4jSj1A,5927
 hud/utils/telemetry.py,sha256=hrVIx2rUjSGyy9IVxTZ_3Jii83PiHjyFRd5ls2whimM,1863
 hud/utils/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -122,10 +122,10 @@ hud/utils/tests/test_async_utils.py,sha256=RkdSnYErRV3Jn7dfg6CPlcE1RSUL__2B627oI
 hud/utils/tests/test_init.py,sha256=2QLQSGgyP9wJhOvPCusm_zjJad0qApOZi1BXpxcdHXQ,383
 hud/utils/tests/test_progress.py,sha256=QSF7Kpi03Ff_l3mAeqW9qs1nhK50j9vBiSobZq7T4f4,7394
 hud/utils/tests/test_telemetry.py,sha256=5jl7bEx8C8b-FfFUko5pf4UY-mPOR-9HaeL98dGtVHM,2781
-hud/utils/tests/test_version.py,sha256=jy8VM-qboqR_TWjmFy3hCw93dCZsguyIgBsqNmUtzM4,159
+hud/utils/tests/test_version.py,sha256=J1HkpyCuUnhq-6sqLntxJjgi5Y3W8jH3x3qcpPaxS9Y,159
 hud/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hud_python-0.4.2.dist-info/METADATA,sha256=fTLXYCnwj5LOHUKjMeKQmmRFJ2BgWYCrcPBWD4c2Fng,19675
-hud_python-0.4.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hud_python-0.4.2.dist-info/entry_points.txt,sha256=jJbodNFg1m0-CDofe5AHvB4zKBq7sSdP97-ohaQ3ae4,63
-hud_python-0.4.2.dist-info/licenses/LICENSE,sha256=yIzBheVUf86FC1bztAcr7RYWWNxyd3B-UJQ3uddg1HA,1078
-hud_python-0.4.2.dist-info/RECORD,,
+hud_python-0.4.4.dist-info/METADATA,sha256=CEYI7xppDnxlMpiEPdiV330PPkzryUmAuzUt1xWjazw,19669
+hud_python-0.4.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hud_python-0.4.4.dist-info/entry_points.txt,sha256=jJbodNFg1m0-CDofe5AHvB4zKBq7sSdP97-ohaQ3ae4,63
+hud_python-0.4.4.dist-info/licenses/LICENSE,sha256=yIzBheVUf86FC1bztAcr7RYWWNxyd3B-UJQ3uddg1HA,1078
+hud_python-0.4.4.dist-info/RECORD,,