code-puppy 0.0.749__tar.gz → 0.0.751__tar.gz

{code_puppy-0.0.749 → code_puppy-0.0.751}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-puppy
-Version: 0.0.749
+Version: 0.0.751
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: <3.15,>=3.11
 Requires-Dist: agent-client-protocol<0.12,>=0.11.0
-Requires-Dist: anthropic>=0.108.0
+Requires-Dist: anthropic<1,>=0.108.0
 Requires-Dist: anyio>=4.7.0
 Requires-Dist: azure-identity>=1.15.0
 Requires-Dist: boto3>=1.43.9

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/agents/_builder.py

@@ -637,10 +637,15 @@ def build_pydantic_agent(
     model_settings = make_model_settings(resolved_model_name)
     history_processor = make_history_processor(agent)
     steer_processor = make_steer_history_processor(agent)
+    logical_agent_name = getattr(agent, "name", None) or agent.__class__.__name__
 
     def _new_pydantic_agent(toolsets: List[Any]) -> PydanticAgent:
         return PydanticAgent(
             model=model,
+            # Explicit name: without it pydantic-ai infers one from the
+            # caller's frame variables, so observability spans read
+            # "invoke_agent pydantic_agent" instead of the logical agent name.
+            name=logical_agent_name,
             instructions=instructions,
             output_type=output_type,
             retries=3,
@@ -667,7 +672,6 @@ def build_pydantic_agent(
     # tool registry actually produced, and filter MCP to avoid name clashes.
     probe_agent = _new_pydantic_agent(toolsets=[])
     agent_tools = agent.get_available_tools()
-    logical_agent_name = getattr(agent, "name", None) or agent.__class__.__name__
     register_tools_for_agent(
         probe_agent,
         agent_tools,

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/agents/_runtime.py

@@ -693,6 +693,20 @@ async def _run_with_mcp_impl(
         # Hook failures must never block the run.
         pass
 
+    # Let a ``model_select`` hook route THIS turn to a different model (e.g.
+    # small-vs-large by complexity) before the pydantic agent is built. This
+    # resets any prior turn's auto choice, respects an explicit runtime
+    # override, and invalidates the cached agent when the model changes so the
+    # build below picks it up. No-op (and near-zero cost) if no plugin
+    # registered the hook.
+    try:
+        from code_puppy.model_switching import resolve_run_model_selection
+
+        resolve_run_model_selection(agent, prompt, agent._message_history, group_id)
+    except Exception:
+        # Selection must never block a run.
+        pass
+
     if agent._code_generation_agent is None:
         build_pydantic_agent(agent)
     pydantic_agent = agent._code_generation_agent

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/agents/base_agent.py

@@ -72,6 +72,11 @@ class BaseAgent(ABC):
         self._last_model_name: Optional[str] = None
         self._runtime_model_name_override: Optional[str] = None
         self._runtime_system_prompt_additions: List[str] = []
+        # Model chosen by a ``model_select`` hook for the current run. Slots
+        # below an explicit runtime override but above pinned/JSON/global, and
+        # is reset at the start of every run (see resolve_run_model_selection),
+        # so it never leaks across turns.
+        self._auto_model_override: Optional[str] = None
         self._puppy_rules: Optional[str] = None
         self._mcp_servers: List[Any] = []
         self.cur_model: Optional[pydantic_ai.models.Model] = None
@@ -125,6 +130,14 @@ class BaseAgent(ABC):
         """
         self._runtime_model_name_override = model_name
 
+    def get_auto_model_override(self) -> Optional[str]:
+        """Return the model chosen by a ``model_select`` hook for this run."""
+        return self._auto_model_override
+
+    def set_auto_model_override(self, model_name: Optional[str]) -> None:
+        """Set the ``model_select``-chosen model for this run (not persisted)."""
+        self._auto_model_override = model_name
+
     @contextmanager
     def temporary_model_name_override(
         self, model_name: Optional[str]
@@ -154,6 +167,9 @@ class BaseAgent(ABC):
         override = self.get_runtime_model_name_override()
         if override:
             return override
+        auto = self.get_auto_model_override()
+        if auto:
+            return auto
         pinned = get_agent_pinned_model(self.name)
         return pinned if pinned else get_global_model_name()
 

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/agents/json_agent.py

@@ -220,6 +220,13 @@ class JSONAgent(BaseAgent):
         if override:
             return override
 
+        # A ``model_select`` hook choice outranks the JSON ``model`` field so
+        # per-turn routing works for JSON agents too (see get_model_name in
+        # BaseAgent for the full precedence ladder).
+        auto = self.get_auto_model_override()
+        if auto:
+            return auto
+
         result = self._config.get("model")
         if result is None or (isinstance(result, str) and not result.strip()):
             result = super().get_model_name()

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/callbacks.py

@@ -46,6 +46,7 @@ PhaseType = Literal[
     "agent_run_start",
     "agent_run_end",
     "agent_run_result",
+    "model_select",
     "register_mcp_catalog_servers",
     "register_browser_types",
     "register_model_providers",
@@ -132,6 +133,7 @@ _callbacks: Dict[PhaseType, List[CallbackFunc]] = {
     "agent_run_start": [],
     "agent_run_end": [],
     "agent_run_result": [],
+    "model_select": [],
     "register_mcp_catalog_servers": [],
     "register_browser_types": [],
     "register_model_providers": [],
@@ -1154,6 +1156,50 @@ async def on_agent_run_start(
     )
 
 
+def on_model_select(
+    *,
+    agent_name: str,
+    current_model: str | None,
+    prompt: str,
+    messages: List[Any],
+    session_id: str | None = None,
+) -> str | None:
+    """Ask plugins to choose the model for the current run.
+
+    Fires once per run, before the pydantic agent is (re)built. Lets a plugin
+    route each turn to a different model based on the agent, the effective
+    ("would-be") model, and the message history -- e.g. a small model for
+    trivial turns and a frontier model when it matters, or a cost/latency/
+    failover policy.
+
+    Precedence: an explicit runtime override still wins over this hook; this
+    hook wins over the pinned / JSON / global model. The first callback to
+    return a non-empty string wins; return ``None`` to defer.
+
+    Args:
+        agent_name: Name of the agent about to run.
+        current_model: The model that would be used absent any hook.
+        prompt: The current user prompt after submission hooks have rewritten it.
+        messages: The agent's prior message history for this run.
+        session_id: Optional per-run identifier.
+
+    Returns:
+        A model name to use for this run, or ``None`` to keep ``current_model``.
+    """
+    results = _trigger_callbacks_sync(
+        "model_select",
+        agent_name=agent_name,
+        current_model=current_model,
+        prompt=prompt,
+        messages=messages,
+        session_id=session_id,
+    )
+    for result in results:
+        if isinstance(result, str) and result.strip():
+            return result
+    return None
+
+
 async def on_agent_run_end(
     agent_name: str,
     model_name: str,

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/cli_runner.py

@@ -274,14 +274,19 @@ async def main():
         try:
             import pyfiglet
 
+            # Width-aware banner: full CODE PUPPY when it fits, PUP when
+            # the terminal is too narrow (phones, tight splits).
+            banner_columns = display_console.width
             intro_lines = pyfiglet.figlet_format(
-                startup_banner_text(), font="ansi_shadow"
+                startup_banner_text(banner_columns), font="ansi_shadow"
             ).split("\n")
 
             # Simple blue to green gradient (top to bottom)
             gradient_colors = ["bright_blue", "bright_cyan", "bright_green"]
             display_console.print("\n")
 
+            # Left-justified on purpose -- the full-screen splash handles
+            # the centered spectacle; this banner tops the scrollback.
             lines = []
             for line_num, line in enumerate(intro_lines):
                 if line.strip():

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/model_switching.py

@@ -2,11 +2,65 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Any, List, Optional
 
 from code_puppy.config import set_model_name
 
 
+def resolve_run_model_selection(
+    agent: Any,
+    prompt: str,
+    messages: List[Any],
+    session_id: Optional[str] = None,
+) -> Optional[str]:
+    """Apply the ``model_select`` hook for one run and return the chosen model.
+
+    Called once at the start of every run, BEFORE the pydantic agent is built.
+
+    Behaviour / precedence:
+    * The per-run auto override is always cleared first, so a choice never
+      leaks into a later turn.
+    * An explicit runtime override (e.g. ``invoke_agent_with_model``) wins and
+      short-circuits the hook entirely.
+    * Otherwise the hook is asked to pick a model. If it returns a name that
+      differs from the effective model, we install it as the run's auto
+      override and invalidate the cached pydantic agent so the build picks up
+      the new model.
+
+    Returns the chosen model name if the hook changed it, else ``None``.
+    Never raises -- a misbehaving selector must not break a run.
+    """
+    try:
+        # Reset any previous turn's auto choice so it can't leak forward.
+        if agent.get_auto_model_override():
+            agent.set_auto_model_override(None)
+            agent._code_generation_agent = None
+
+        # Explicit runtime override always wins -- don't even ask the hook.
+        if agent.get_runtime_model_name_override():
+            return None
+
+        from code_puppy.callbacks import on_model_select
+
+        current = agent.get_model_name()
+        selected = on_model_select(
+            agent_name=getattr(agent, "name", None),
+            current_model=current,
+            prompt=prompt,
+            messages=messages or [],
+            session_id=session_id,
+        )
+        if selected and selected != current:
+            agent.set_auto_model_override(selected)
+            # Force a rebuild so the new model is actually used this turn.
+            agent._code_generation_agent = None
+            return selected
+    except Exception:
+        # A broken selector must never block the agent run.
+        pass
+    return None
+
+
 def _get_effective_agent_model(agent) -> Optional[str]:
     """Safely fetch the effective model name for an agent."""
     try:

code_puppy-0.0.751/code_puppy/platform_utils.py

@@ -0,0 +1,42 @@
+"""Small platform-detection helpers shared by UI entry points."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import sys
+
+# ``CODE PUPPY`` rendered in pyfiglet's ansi_shadow spans 79 columns
+# (pinned by tests/test_platform_utils.py). Baked so banner selection
+# stays import-light -- no pyfiglet needed just to pick a label.
+_FULL_BANNER = "CODE PUPPY"
+_FULL_BANNER_WIDTH = 79
+_COMPACT_BANNER = "PUP"
+
+
+def is_android() -> bool:
+    """Return whether Code Puppy is running on Android or in Termux.
+
+    Current Android Python builds expose an ``android`` platform name, while
+    older Termux builds may report ``linux``. Environment markers cover that
+    compatibility gap without making each UI entry point invent its own check.
+    """
+    if sys.platform.startswith("android"):
+        return True
+
+    return bool(
+        os.environ.get("TERMUX_VERSION")
+        or (os.environ.get("ANDROID_ROOT") and os.environ.get("ANDROID_DATA"))
+    )
+
+
+def startup_banner_text(columns: int | None = None) -> str:
+    """Return the widest startup banner label the terminal can fit.
+
+    Width-based rather than platform-based: a phone terminal in landscape
+    earns the full banner, and a squeezed desktop split gets the compact
+    one. ``columns`` defaults to the detected terminal width.
+    """
+    if columns is None:
+        columns = shutil.get_terminal_size(fallback=(80, 24)).columns
+    return _FULL_BANNER if columns >= _FULL_BANNER_WIDTH else _COMPACT_BANNER

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/splash.py

@@ -7,10 +7,11 @@ and stop it the moment they finish. Do not import anything from
 ``code_puppy`` here -- that would defeat the entire point.
 
 The animation is pure art (no text), so it stays outside the i18n seam.
-Every frame repaints its full region with line-clears, which also absorbs
-any stray import-time output (e.g. plugin warnings emitted while
-``cli_runner`` loads). Everything fails soft: a broken terminal gets a
-no-op splash, never a crashed CLI.
+It runs full-screen on the alternate screen buffer, centered both axes;
+leaving the alt screen on stop() restores the user's terminal exactly as
+it was. Stray import-time output (e.g. plugin warnings emitted while
+``cli_runner`` loads) is buffered and replayed afterwards. Everything
+fails soft: a broken terminal gets a no-op splash, never a crashed CLI.
 """
 
 from __future__ import annotations
@@ -49,33 +50,40 @@ _PYRAMID = (
 _CHARS = (" ", "\u2591", "\u2592", "\u2588")
 _PYRAMID_WIDTH = 44
 
-# "Powered by" / "Pydantic" pre-rendered in pyfiglet's ansi_shadow (the same
-# font as the main CODE PUPPY banner). Baked as constants: pyfiglet is not
-# stdlib and this module must stay import-light. Solid blocks render as the
-# neon core tier; the box-drawing shadow trim renders as the mid glow tier.
-_TAGLINE_TOP = (
-    "\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557    \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557     \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557",
-    "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551    \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255a\u2588\u2588\u2557 \u2588\u2588\u2554\u255d",
-    "\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551  \u2588\u2588\u2551    \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d \u255a\u2588\u2588\u2588\u2588\u2554\u255d",
-    "\u2588\u2588\u2554\u2550\u2550\u2550\u255d \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255d  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255d  \u2588\u2588\u2551  \u2588\u2588\u2551    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557  \u255a\u2588\u2588\u2554\u255d",
-    "\u2588\u2588\u2551     \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u255a\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d    \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d   \u2588\u2588\u2551",
-    "\u255a\u2550\u255d      \u255a\u2550\u2550\u2550\u2550\u2550\u255d  \u255a\u2550\u2550\u255d\u255a\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u255d  \u255a\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u255d     \u255a\u2550\u2550\u2550\u2550\u2550\u255d    \u255a\u2550\u255d",
+# "CODE PUPPY" / "PUP" pre-rendered in pyfiglet's ansi_shadow (the same
+# font as the scrollback banner). Baked as constants: pyfiglet is not
+# stdlib and this module must stay import-light. Solid blocks render as
+# the neon core tier; the box-drawing shadow trim renders as the mid
+# glow tier.
+_BANNER_FULL = (
+    " \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557    \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557",
+    "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255a\u2588\u2588\u2557 \u2588\u2588\u2554\u255d",
+    "\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557      \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d \u255a\u2588\u2588\u2588\u2588\u2554\u255d",
+    "\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255d      \u2588\u2588\u2554\u2550\u2550\u2550\u255d \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255d \u2588\u2588\u2554\u2550\u2550\u2550\u255d   \u255a\u2588\u2588\u2554\u255d",
+    "\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557    \u2588\u2588\u2551     \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551     \u2588\u2588\u2551        \u2588\u2588\u2551",
+    " \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d    \u255a\u2550\u255d      \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d     \u255a\u2550\u255d        \u255a\u2550\u255d",
 )
-_TAGLINE_TOP_WIDTH = 80
-_TAGLINE_BOTTOM = (
-    "\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557",
-    "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255a\u2588\u2588\u2557 \u2588\u2588\u2554\u255d\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u255a\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255d\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d",
-    "\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d \u255a\u2588\u2588\u2588\u2588\u2554\u255d \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551",
-    "\u2588\u2588\u2554\u2550\u2550\u2550\u255d   \u255a\u2588\u2588\u2554\u255d  \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255a\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551",
-    "\u2588\u2588\u2551        \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551 \u255a\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
-    "\u255a\u2550\u255d        \u255a\u2550\u255d   \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d  \u255a\u2550\u255d\u255a\u2550\u255d  \u255a\u2550\u2550\u2550\u255d   \u255a\u2550\u255d   \u255a\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d",
+_BANNER_FULL_WIDTH = 79
+_BANNER_COMPACT = (
+    "\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+    "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
+    "\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d",
+    "\u2588\u2588\u2554\u2550\u2550\u2550\u255d \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255d",
+    "\u2588\u2588\u2551     \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551",
+    "\u255a\u2550\u255d      \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d",
 )
-_TAGLINE_BOTTOM_WIDTH = 63
+_BANNER_COMPACT_WIDTH = 25
 _SHADOW_TRIM = frozenset("\u2550\u2551\u2554\u2557\u255a\u255d")
 
 _RESET = "\x1b[0m"
 _HIDE_CURSOR = "\x1b[?25l"
 _SHOW_CURSOR = "\x1b[?25h"
+# Alternate screen buffer (like vim/less): the splash owns a blank
+# full-screen canvas, and leaving it restores the user's scrollback
+# untouched -- no erase bookkeeping needed on the way out.
+_ALT_SCREEN_ON = "\x1b[?1049h"
+_ALT_SCREEN_OFF = "\x1b[?1049l"
+_CLEAR_SCREEN = "\x1b[2J"
 # Synchronized output (DEC 2026): terminals that support it (iTerm2, kitty,
 # WezTerm, Ghostty, Alacritty, ...) render the whole frame atomically --
 # zero flicker. Terminals that don't simply ignore the markers.
@@ -119,13 +127,13 @@ def _compose_rows(columns: int, lines: int):
 
     Returns a list of (kind, content) rows: ``art`` rows are pyramid tier
     digits, ``text`` rows are literal figlet glyphs. Degrades gracefully:
-    full "Powered by / Pydantic" -> "Pydantic" only -> pyramid only.
+    pyramid + "CODE PUPPY" -> pyramid + "PUP" -> pyramid only.
     """
-    top = [(line, _TAGLINE_TOP_WIDTH) for line in _TAGLINE_TOP]
-    bottom = [(line, _TAGLINE_BOTTOM_WIDTH) for line in _TAGLINE_BOTTOM]
+    full = [(line, _BANNER_FULL_WIDTH) for line in _BANNER_FULL]
+    compact = [(line, _BANNER_COMPACT_WIDTH) for line in _BANNER_COMPACT]
     variants = (
-        (top + [("", 0)] + bottom, _TAGLINE_TOP_WIDTH),
-        (bottom, _TAGLINE_BOTTOM_WIDTH),
+        (full, _BANNER_FULL_WIDTH),
+        (compact, _BANNER_COMPACT_WIDTH),
         ([], _PYRAMID_WIDTH),
     )
     for text_rows, text_width in variants:
@@ -146,6 +154,22 @@ def _compose_rows(columns: int, lines: int):
     return rows
 
 
+def _center_rows(rows, columns: int):
+    """Pad every row so the artwork block sits horizontally centered.
+
+    Art rows pad with '0' (the empty glow tier) and text rows with spaces,
+    so ``_build_frame`` needs no knowledge of centering at all.
+    """
+    block_width = max((len(content) for _, content in rows), default=0)
+    pad = max(0, (columns - block_width) // 2)
+    if not pad:
+        return list(rows)
+    return [
+        (kind, ("0" * pad if kind == "art" else " " * pad) + content)
+        for kind, content in rows
+    ]
+
+
 def _build_frame(phase: int, truecolor: bool, rows) -> str:
     """Render one frame as newline-joined lines with NO trailing newline.
 
@@ -249,20 +273,25 @@ class _Splash:
             target=self._run, name="code-puppy-splash", daemon=True
         )
         size = shutil.get_terminal_size(fallback=(80, 24))
-        self._rows = _compose_rows(size.columns, size.lines)
+        self._rows = _center_rows(_compose_rows(size.columns, size.lines), size.columns)
         self._height = len(self._rows)
+        # 1-based row where the frame starts, vertically centering the art.
+        self._top_row = max(1, (size.lines - self._height) // 2 + 1)
         self._stopped = False
         self._thread.start()
 
     def _run(self) -> None:
         phase = 0
-        # Reposition to frame top: carriage return + cursor-up (height-1).
-        # The frame has no trailing newline, so nothing ever scrolls and the
-        # cursor parks at the end of the last row between frames.
-        reposition = f"\r\x1b[{self._height - 1}A"
+        # The alt screen is ours alone, so every frame repaints from the
+        # same absolute, vertically-centered origin. The frame has no
+        # trailing newline, so nothing ever scrolls.
+        reposition = f"\x1b[{self._top_row};1H"
         try:
             first = _build_frame(phase, self._truecolor, self._rows)
-            self._stream.write(f"{_HIDE_CURSOR}{_SYNC_START}{first}{_SYNC_END}")
+            self._stream.write(
+                f"{_ALT_SCREEN_ON}{_HIDE_CURSOR}{_CLEAR_SCREEN}"
+                f"{_SYNC_START}{reposition}{first}{_SYNC_END}"
+            )
             self._stream.flush()
             while not self._stop_event.wait(_FRAME_SECONDS):
                 phase = (phase + 2) % _SHEEN_PERIOD
@@ -289,8 +318,9 @@ class _Splash:
         self._stop_event.set()
         self._thread.join(timeout=1.0)
         try:
-            # Back to frame top, erase to end of screen, restore cursor.
-            self._stream.write(f"\r\x1b[{self._height - 1}A\x1b[0J{_SHOW_CURSOR}")
+            # Leaving the alt screen restores the pre-splash terminal
+            # content and cursor position in one move; nothing to erase.
+            self._stream.write(f"{_ALT_SCREEN_OFF}{_SHOW_CURSOR}")
             self._stream.flush()
         except Exception:
             pass
@@ -358,6 +388,12 @@ def start_splash(
                 return _NullSplash()
             if not _wants_splash(sys.argv):
                 return _NullSplash()
+            # _compose_rows degrades CODE PUPPY -> PUP -> bare pyramid,
+            # but below even the pyramid's footprint there is nothing
+            # honest left to draw: stay silent, never clip art.
+            size = shutil.get_terminal_size(fallback=(80, 24))
+            if size.columns < _PYRAMID_WIDTH + 2 or size.lines < len(_PYRAMID) + 2:
+                return _NullSplash()
         if not _enable_windows_vt(stream):
             return _NullSplash()
         return _Splash(stream, min_seconds=min_seconds)

{code_puppy-0.0.749 → code_puppy-0.0.751}/code_puppy/tools/subagent_invocation.py

@@ -406,6 +406,11 @@ async def _invoke_agent_impl(
             # (e.g. DBOS) may swap them via the agent_run_context hook.
             temp_agent = Agent(
                 model=model,
+                # Explicit name: without it pydantic-ai infers one from the
+                # caller's frame variables, so every sub-agent's observability
+                # span reads "invoke_agent temp_agent" instead of the logical
+                # agent name (e.g. "invoke_agent web-retriever").
+                name=agent_name,
                 instructions=instructions,
                 output_type=str,
                 retries=3,

{code_puppy-0.0.749 → code_puppy-0.0.751}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "code-puppy"
-version = "0.0.749"
+version = "0.0.751"
 description = "Code generation agent"
 readme = "README.md"
 requires-python = ">=3.11,<3.15"
@@ -32,7 +32,7 @@ dependencies = [
     "termflow-md>=0.1.11",
     "Pillow>=10.0.0",
     "azure-identity>=1.15.0",
-    "anthropic>=0.108.0",
+    "anthropic>=0.108.0,<1",
     "boto3>=1.43.9",
     "keyring>=24.0.0",
     "agent-client-protocol>=0.11.0,<0.12",

code_puppy-0.0.749/code_puppy/platform_utils.py

@@ -1,27 +0,0 @@
-"""Small platform-detection helpers shared by UI entry points."""
-
-from __future__ import annotations
-
-import os
-import sys
-
-
-def is_android() -> bool:
-    """Return whether Code Puppy is running on Android or in Termux.
-
-    Current Android Python builds expose an ``android`` platform name, while
-    older Termux builds may report ``linux``. Environment markers cover that
-    compatibility gap without making each UI entry point invent its own check.
-    """
-    if sys.platform.startswith("android"):
-        return True
-
-    return bool(
-        os.environ.get("TERMUX_VERSION")
-        or (os.environ.get("ANDROID_ROOT") and os.environ.get("ANDROID_DATA"))
-    )
-
-
-def startup_banner_text() -> str:
-    """Return the platform-appropriate startup banner label."""
-    return "PUP" if is_android() else "CODE PUPPY"