deepagent-code 0.1.3__tar.gz → 0.1.4__tar.gz

{deepagent_code-0.1.3 → deepagent_code-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.3
+Version: 0.1.4
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -95,7 +95,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory

{deepagent_code-0.1.3 → deepagent_code-0.1.4}/README.md

@@ -63,7 +63,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory

{deepagent_code-0.1.3 → deepagent_code-0.1.4}/deepagent_code/cli.py

@@ -7,6 +7,7 @@ import importlib.util
 import json
 import os
 import re
+import subprocess
 import sys
 import threading
 import time
@@ -53,7 +54,7 @@ SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇",
 
 
 # Version info
-__version__ = "0.1.3"
+__version__ = "0.1.4"
 
 
 # Slash command registry
@@ -256,8 +257,87 @@ def get_agent_name(graph) -> str:
     return "AgentCode"
 
 
-def print_header_box(agent_name: str, cwd: str):
-    """Print an elegant header with the agent name and version."""
+def get_agent_description(graph) -> Optional[str]:
+    """Extract agent description from graph object, if available."""
+    # Try common attribute names for agent description
+    for attr in ('description', 'agent_description', '_description', '__doc__'):
+        if hasattr(graph, attr):
+            desc = getattr(graph, attr)
+            if desc and isinstance(desc, str) and desc.strip():
+                return desc.strip()
+    # Check if it's a compiled graph with a description in builder
+    if hasattr(graph, 'builder') and hasattr(graph.builder, 'description'):
+        desc = graph.builder.description
+        if desc and isinstance(desc, str) and desc.strip():
+            return desc.strip()
+    return None
+
+
+def text_to_ascii_art(text: str) -> List[str]:
+    """Convert text to ASCII art using a clean block font.
+
+    Returns a list of strings, one per line of the ASCII art.
+    All characters are exactly 3 chars wide for consistent spacing.
+    """
+    # Clean 3-line block font - each char is exactly 3 wide
+    FONT = {
+        'A': ['▄▀▄', '█▀█', '▀ ▀'],
+        'B': ['█▀▄', '█▀▄', '▀▀▀'],
+        'C': ['▄▀▀', '█  ', '▀▀▀'],
+        'D': ['█▀▄', '█ █', '▀▀▀'],
+        'E': ['█▀▀', '█▀▀', '▀▀▀'],
+        'F': ['█▀▀', '█▀▀', '▀  '],
+        'G': ['▄▀▀', '█▀█', '▀▀▀'],
+        'H': ['█ █', '█▀█', '▀ ▀'],
+        'I': ['▀█▀', ' █ ', '▀▀▀'],
+        'J': ['▀▀█', '  █', '▀▀▀'],
+        'K': ['█ █', '█▀▄', '▀ ▀'],
+        'L': ['█  ', '█  ', '▀▀▀'],
+        'M': ['█▄█', '█ █', '▀ ▀'],
+        'N': ['█▀█', '█ █', '▀ ▀'],
+        'O': ['▄▀▄', '█ █', '▀▀▀'],
+        'P': ['█▀▄', '█▀▀', '▀  '],
+        'Q': ['▄▀▄', '█ █', '▀▀█'],
+        'R': ['█▀▄', '█▀▄', '▀ ▀'],
+        'S': ['▄▀▀', '▀▀▄', '▀▀▀'],
+        'T': ['▀█▀', ' █ ', ' ▀ '],
+        'U': ['█ █', '█ █', '▀▀▀'],
+        'V': ['█ █', '█ █', ' ▀ '],
+        'W': ['█ █', '█▀█', '▀ ▀'],
+        'X': ['▀▄▀', ' █ ', '▀ ▀'],
+        'Y': ['█ █', ' █ ', ' ▀ '],
+        'Z': ['▀▀█', ' █ ', '█▀▀'],
+        '0': ['▄▀▄', '█ █', '▀▀▀'],
+        '1': ['▄█ ', ' █ ', '▀▀▀'],
+        '2': ['▀▀█', '▄▀▀', '▀▀▀'],
+        '3': ['▀▀█', ' ▀█', '▀▀▀'],
+        '4': ['█ █', '▀▀█', '  ▀'],
+        '5': ['█▀▀', '▀▀▄', '▀▀▀'],
+        '6': ['▄▀▀', '█▀█', '▀▀▀'],
+        '7': ['▀▀█', '  █', '  ▀'],
+        '8': ['▄▀▄', '█▀█', '▀▀▀'],
+        '9': ['▄▀█', '▀▀█', '▀▀▀'],
+        ' ': ['   ', '   ', '   '],
+        '-': ['   ', '▀▀▀', '   '],
+        '_': ['   ', '   ', '▀▀▀'],
+        '.': ['   ', '   ', ' ▀ '],
+    }
+
+    # Default char for unknown characters
+    DEFAULT = ['   ', ' █ ', '   ']
+
+    lines = ['', '', '']
+    for char in text.upper():
+        char_art = FONT.get(char, DEFAULT)
+        for i in range(3):
+            lines[i] += char_art[i] + ' '
+
+    # Remove only the final trailing space we added (not internal spaces from chars like T, P)
+    return [line[:-1] if line.endswith(' ') else line for line in lines]
+
+
+def print_header_box(agent_name: str, cwd: str, description: Optional[str] = None):
+    """Print an elegant header with ASCII art agent name, optional description, and cwd."""
     term_width = get_terminal_width()
 
     # Box drawing characters
@@ -267,15 +347,41 @@ def print_header_box(agent_name: str, cwd: str):
     # Calculate inner width (accounting for borders and padding)
     inner_width = term_width - 4  # 2 for borders, 2 for padding
 
-    # Build the header content
-    title_line = agent_name.center(inner_width)
-    cwd_display = cwd if len(cwd) <= inner_width else "..." + cwd[-(inner_width - 3):]
-    cwd_line = cwd_display.center(inner_width)
+    # Generate ASCII art for agent name
+    ascii_lines = text_to_ascii_art(agent_name)
+    ascii_width = max(len(line) for line in ascii_lines) if ascii_lines else 0
+
+    # Use ASCII art if it fits in terminal width
+    use_ascii = ascii_width <= inner_width
+
+    # Build cwd line with label
+    cwd_label = "cwd: "
+    max_cwd_len = inner_width - len(cwd_label)
+    cwd_display = cwd if len(cwd) <= max_cwd_len else "..." + cwd[-(max_cwd_len - 3):]
+    cwd_with_label = f"{cwd_label}{cwd_display}"
+    cwd_line = cwd_with_label.center(inner_width)
 
     # Print the box with gradient-style coloring
     print()
     print(f"{BRIGHT_CYAN}{TL}{H * (term_width - 2)}{TR}{RESET}")
-    print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{title_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+
+    if use_ascii:
+        # Print ASCII art lines centered
+        for line in ascii_lines:
+            centered_line = line.center(inner_width)
+            print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{centered_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+    else:
+        # Fall back to plain text if ASCII art doesn't fit
+        title_line = agent_name.center(inner_width)
+        print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{title_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+
+    # Print description line if available
+    if description:
+        # Truncate description if too long
+        desc_display = description if len(description) <= inner_width else description[:inner_width - 3] + "..."
+        desc_line = desc_display.center(inner_width)
+        print(f"{CYAN}{V}{RESET} {DIM}{ITALIC}{desc_line}{RESET} {CYAN}{V}{RESET}")
+
     print(f"{CYAN}{V}{RESET} {DIM}{cwd_line}{RESET} {CYAN}{V}{RESET}")
     print(f"{CYAN}{BL}{H * (term_width - 2)}{BR}{RESET}")
 
@@ -298,7 +404,7 @@ def render_markdown(text: str) -> str:
 
 def parse_agent_spec(agent_spec: str) -> Tuple[str, str]:
     """
-    Parse DEEPAGENT_AGENT_SPEC format: path/to/file.py:variable_name.
+    Parse agent spec format: path/to/file.py:variable_name.
 
     Args:
         agent_spec: Agent specification string
@@ -1090,6 +1196,7 @@ def run_conversation_loop(
     graph,
     config: Dict[str, Any],
     agent_name: str = "AgentCode",
+    agent_description: Optional[str] = None,
     use_async: bool = False,
     interactive: bool = True,
     verbose: bool = False,
@@ -1103,8 +1210,8 @@ def run_conversation_loop(
     # Set up tab completion for slash commands
     setup_readline_completion()
 
-    # Print box-drawn header with agent name
-    print_header_box(agent_name, os.getcwd())
+    # Print box-drawn header with agent name and description
+    print_header_box(agent_name, os.getcwd(), agent_description)
 
     # Print welcome message with tips
     print_welcome()
@@ -1167,6 +1274,28 @@ def run_conversation_loop(
                         print(f"{DIM}Type /help to see available commands{RESET}")
                 continue
 
+            # Handle bang commands (!) - execute bash directly
+            if user_input.startswith("!"):
+                bash_cmd = user_input[1:].strip()
+                if bash_cmd:
+                    print()
+                    try:
+                        result = subprocess.run(
+                            bash_cmd,
+                            shell=True,
+                            capture_output=True,
+                            text=True,
+                        )
+                        if result.stdout:
+                            print(result.stdout, end="")
+                        if result.stderr:
+                            print(f"{RED}{result.stderr}{RESET}", end="")
+                        if result.returncode != 0:
+                            print(f"{DIM}Exit code: {result.returncode}{RESET}")
+                    except Exception as e:
+                        print(f"{RED}Error executing command: {e}{RESET}")
+                continue
+
             # Handle "exit" as a special case (without slash)
             if user_input.lower() == "exit":
                 break
@@ -1253,7 +1382,7 @@ def main(
     Supports environment variables for configuration:
 
     \b
-    - DEEPAGENT_AGENT_SPEC: Agent location (same formats as above)
+    - DEEPAGENT_SPEC: Agent location (same formats as above)
     - DEEPAGENT_WORKSPACE_ROOT: Working directory for the agent
     - DEEPAGENT_CONFIG: Configuration JSON string or path to JSON file
     - DEEPAGENT_STREAM_MODE: Stream mode for LangGraph (updates or values)
@@ -1268,8 +1397,8 @@ def main(
         deepagent-code -m "Hello, agent!"
     """
     try:
-        # Get environment variables
-        env_agent_spec = os.getenv('DEEPAGENT_AGENT_SPEC')
+        # Get environment variables (DEEPAGENT_SPEC preferred, DEEPAGENT_AGENT_SPEC for backwards compat)
+        env_agent_spec = os.getenv('DEEPAGENT_SPEC') or os.getenv('DEEPAGENT_AGENT_SPEC')
         env_workspace_root = os.getenv('DEEPAGENT_WORKSPACE_ROOT')
         env_config = os.getenv('DEEPAGENT_CONFIG')
         env_stream_mode = os.getenv('DEEPAGENT_STREAM_MODE', 'updates')
@@ -1288,7 +1417,7 @@ def main(
                 print(f"\n{DIM}Usage:{RESET}")
                 print(f"  deepagent-code path/to/agent.py:graph")
                 print(f"  deepagent-code mypackage.module:agent")
-                print(f"\n{DIM}Or set DEEPAGENT_AGENT_SPEC environment variable{RESET}")
+                print(f"\n{DIM}Or set DEEPAGENT_SPEC environment variable{RESET}")
                 sys.exit(1)
 
         # Change to workspace root if specified
@@ -1331,14 +1460,16 @@ def main(
         if "thread_id" not in config_dict["configurable"]:
             config_dict["configurable"]["thread_id"] = str(uuid.uuid4())
 
-        # Extract agent name from graph object
+        # Extract agent name and description from graph object
         agent_name = get_agent_name(graph)
+        agent_description = get_agent_description(graph)
 
         # Run the conversation loop
         run_conversation_loop(
             graph=graph,
             config=config_dict,
             agent_name=agent_name,
+            agent_description=agent_description,
             use_async=use_async,
             interactive=interactive,
             verbose=verbose,

{deepagent_code-0.1.3 → deepagent_code-0.1.4}/deepagent_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.3
+Version: 0.1.4
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -95,7 +95,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory

{deepagent_code-0.1.3 → deepagent_code-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepagent-code"
-version = "0.1.3"
+version = "0.1.4"
 description = "A Claude Code-style CLI for running LangGraph agents from the terminal"
 readme = "README.md"
 requires-python = ">=3.11"