agentropic 0.2.1__tar.gz → 0.2.2__tar.gz

{agentropic-0.2.1 → agentropic-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentropic
-Version: 0.2.1
+Version: 0.2.2
 Summary: A minimal, hackable agentic framework: LLM calls via litellm, @tool-decorated functions, and MCP server support.
 Author-email: Vishal Tiwari <vishaltiwari.up2019@gmail.com>
 License: MIT

{agentropic-0.2.1 → agentropic-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentropic"
-version = "0.2.1"
+version = "0.2.2"
 description = "A minimal, hackable agentic framework: LLM calls via litellm, @tool-decorated functions, and MCP server support."
 readme = "README.md"
 requires-python = ">=3.9"

{agentropic-0.2.1 → agentropic-0.2.2}/src/agentropic/__init__.py

@@ -3,6 +3,7 @@ from .tools import tool, Tool, ToolRegistry
 from .llm import LLMClient, LLMResponse
 from .memory import Memory
 from .mcp.client import MCPConnection, StdioServer, SSEServer, MCPServerConfig
+from .tracing import AgentTracer, NullTracer
 
 __version__ = "0.2.0"
 
@@ -21,4 +22,6 @@ __all__ = [
     "StdioServer",
     "SSEServer",
     "MCPServerConfig",
+    "AgentTracer",
+    "NullTracer",
 ]

{agentropic-0.2.1 → agentropic-0.2.2}/src/agentropic/tracing.py

@@ -90,6 +90,11 @@ def _display_width(text: str) -> int:
 # Tracer
 # --------------------------------------------------------------------------
 
+# Module-level so the welcome banner shows exactly once per process,
+# no matter how many Agent/AgentTracer instances get created.
+_WELCOME_SHOWN = False
+
+
 class AgentTracer:
     """Renders one Agent run as a live, colorized trace in the terminal.
 
@@ -119,31 +124,71 @@ class AgentTracer:
         width = _term_width()
         return f"{self._c(color)}{char * width}{self._c(C.RESET)}"
 
-    def _box(self, title: str, lines: list[str], color: str, title_color: str = "") -> None:
+    def _box(
+        self,
+        title: str,
+        lines: list[str],
+        color: str,
+        title_color: str = "",
+        center_title: bool = False,
+        center_lines: bool = False,
+    ) -> None:
         width = _term_width()
         inner = width - 4
         title_color = title_color or color
         top = f"{self._c(color)}╭{'─' * (width - 2)}╮{self._c(C.RESET)}"
         bot = f"{self._c(color)}╰{'─' * (width - 2)}╯{self._c(C.RESET)}"
-        head = f"{self._c(color)}│ {self._c(C.RESET)}{self._c(C.BOLD)}{self._c(title_color)}{title}{self._c(C.RESET)}"
-        head_pad = width - 4 - _display_width(title)
-        head += " " * max(head_pad, 0) + f"{self._c(color)} │{self._c(C.RESET)}"
+
+        if center_title:
+            left_pad = max((inner - _display_width(title)) // 2, 0)
+            right_pad = max(inner - _display_width(title) - left_pad, 0)
+        else:
+            left_pad, right_pad = 0, max(inner - _display_width(title), 0)
+
+        head = (
+            f"{self._c(color)}│ {self._c(C.RESET)}{' ' * left_pad}"
+            f"{self._c(C.BOLD)}{self._c(title_color)}{title}{self._c(C.RESET)}"
+            f"{' ' * right_pad}{self._c(color)} │{self._c(C.RESET)}"
+        )
         self._print(top)
         self._print(head)
         if lines:
             self._print(f"{self._c(color)}├{'─' * (width - 2)}┤{self._c(C.RESET)}")
             for raw in lines:
                 for wrapped in _wrap(raw, inner) or [""]:
-                    pad = inner - _display_width(wrapped)
+                    w = _display_width(wrapped)
+                    if center_lines:
+                        lp = max((inner - w) // 2, 0)
+                        rp = max(inner - w - lp, 0)
+                    else:
+                        lp, rp = 0, max(inner - w, 0)
                     self._print(
-                        f"{self._c(color)}│ {self._c(C.RESET)}{wrapped}"
-                        f"{' ' * max(pad, 0)}{self._c(color)} │{self._c(C.RESET)}"
+                        f"{self._c(color)}│ {self._c(C.RESET)}{' ' * lp}{wrapped}"
+                        f"{' ' * rp}{self._c(color)} │{self._c(C.RESET)}"
                     )
         self._print(bot)
 
     # -- lifecycle events ---------------------------------------------------
 
+    def welcome_banner(self, force: bool = False) -> None:
+        """Prints a one-time 'Welcome to Agentropic' banner. Shown
+        automatically before the first run in a process; call with
+        force=True to show it again (e.g. at the very start of a script)."""
+        global _WELCOME_SHOWN
+        if _WELCOME_SHOWN and not force:
+            return
+        _WELCOME_SHOWN = True
+        self._print()
+        self._box(
+            "🚀  Welcome to Agentropic — Agentic AI System",
+            [f"{self._c(C.DIM)}Powered by your agents, tools, and memory.{self._c(C.RESET)}"],
+            color=C.MAGENTA,
+            center_title=True,
+            center_lines=True,
+        )
+
     def run_start(self, user_input: str) -> None:
+        self.welcome_banner()
         self._run_started = time.monotonic()
         self._print()
         self._box(