tunacode-cli 0.0.17__py3-none-any.whl → 0.0.19__py3-none-any.whl

tunacode/tools/read_file.py

@@ -7,14 +7,8 @@ Provides safe file reading with size limits and proper error handling.
 
 import os
 
-from tunacode.constants import (
-    ERROR_FILE_DECODE,
-    ERROR_FILE_DECODE_DETAILS,
-    ERROR_FILE_NOT_FOUND,
-    ERROR_FILE_TOO_LARGE,
-    MAX_FILE_SIZE,
-    MSG_FILE_SIZE_LIMIT,
-)
+from tunacode.constants import (ERROR_FILE_DECODE, ERROR_FILE_DECODE_DETAILS, ERROR_FILE_NOT_FOUND,
+                                ERROR_FILE_TOO_LARGE, MAX_FILE_SIZE, MSG_FILE_SIZE_LIMIT)
 from tunacode.exceptions import ToolExecutionError
 from tunacode.tools.base import FileBasedTool
 from tunacode.types import ToolResult

tunacode/tools/run_command.py

@@ -7,17 +7,10 @@ Provides controlled shell command execution with output capture and truncation.
 
 import subprocess
 
-from tunacode.constants import (
-    CMD_OUTPUT_FORMAT,
-    CMD_OUTPUT_NO_ERRORS,
-    CMD_OUTPUT_NO_OUTPUT,
-    CMD_OUTPUT_TRUNCATED,
-    COMMAND_OUTPUT_END_SIZE,
-    COMMAND_OUTPUT_START_INDEX,
-    COMMAND_OUTPUT_THRESHOLD,
-    ERROR_COMMAND_EXECUTION,
-    MAX_COMMAND_OUTPUT,
-)
+from tunacode.constants import (CMD_OUTPUT_FORMAT, CMD_OUTPUT_NO_ERRORS, CMD_OUTPUT_NO_OUTPUT,
+                                CMD_OUTPUT_TRUNCATED, COMMAND_OUTPUT_END_SIZE,
+                                COMMAND_OUTPUT_START_INDEX, COMMAND_OUTPUT_THRESHOLD,
+                                ERROR_COMMAND_EXECUTION, MAX_COMMAND_OUTPUT)
 from tunacode.exceptions import ToolExecutionError
 from tunacode.tools.base import BaseTool
 from tunacode.types import ToolResult

tunacode/tools/update_file.py

@@ -21,9 +21,7 @@ class UpdateFileTool(FileBasedTool):
     def tool_name(self) -> str:
         return "Update"
 
-    async def _execute(
-        self, filepath: str, target: str, patch: str
-    ) -> ToolResult:
+    async def _execute(self, filepath: str, target: str, patch: str) -> ToolResult:
         """Update an existing file by replacing a target text block with a patch.
 
         Args:
@@ -73,9 +71,7 @@ class UpdateFileTool(FileBasedTool):
 
         return f"File '{filepath}' updated successfully."
 
-    def _format_args(
-        self, filepath: str, target: str = None, patch: str = None
-    ) -> str:
+    def _format_args(self, filepath: str, target: str = None, patch: str = None) -> str:
         """Format arguments, truncating target and patch for display."""
         args = [repr(filepath)]
 

tunacode/ui/completers.py

@@ -11,53 +11,52 @@ from ..cli.commands import CommandRegistry
 
 class CommandCompleter(Completer):
     """Completer for slash commands."""
-    
+
     def __init__(self, command_registry: Optional[CommandRegistry] = None):
         self.command_registry = command_registry
-    
+
     def get_completions(
         self, document: Document, complete_event: CompleteEvent
     ) -> Iterable[Completion]:
         """Get completions for slash commands."""
         # Get the text before cursor
         text = document.text_before_cursor
-        
+
         # Check if we're at the start of a line or after whitespace
-        if text and not text.isspace() and text[-1] != '\n':
+        if text and not text.isspace() and text[-1] != "\n":
             # Only complete commands at the start of input or after a newline
-            last_newline = text.rfind('\n')
-            line_start = text[last_newline + 1:] if last_newline >= 0 else text
-            
+            last_newline = text.rfind("\n")
+            line_start = text[last_newline + 1 :] if last_newline >= 0 else text
+
             # Skip if not at the beginning of a line
-            if line_start and not line_start.startswith('/'):
+            if line_start and not line_start.startswith("/"):
                 return
-        
+
         # Get the word before cursor
         word_before_cursor = document.get_word_before_cursor(WORD=True)
-        
+
         # Only complete if word starts with /
-        if not word_before_cursor.startswith('/'):
+        if not word_before_cursor.startswith("/"):
             return
-            
+
         # Get command names from registry
         if self.command_registry:
             command_names = self.command_registry.get_command_names()
         else:
             # Fallback list of commands
-            command_names = ['/help', '/clear', '/dump', '/yolo', 
-                           '/branch', '/compact', '/model']
-        
+            command_names = ["/help", "/clear", "/dump", "/yolo", "/branch", "/compact", "/model"]
+
         # Get the partial command (without /)
         partial = word_before_cursor[1:].lower()
-        
+
         # Yield completions for matching commands
         for cmd in command_names:
-            if cmd.startswith('/') and cmd[1:].lower().startswith(partial):
+            if cmd.startswith("/") and cmd[1:].lower().startswith(partial):
                 yield Completion(
                     text=cmd,
                     start_position=-len(word_before_cursor),
                     display=cmd,
-                    display_meta='command'
+                    display_meta="command",
                 )
 
 
@@ -70,14 +69,14 @@ class FileReferenceCompleter(Completer):
         """Get completions for @file references."""
         # Get the word before cursor
         word_before_cursor = document.get_word_before_cursor(WORD=True)
-        
+
         # Check if we're in an @file reference
         if not word_before_cursor.startswith("@"):
             return
-            
+
         # Get the path part after @
         path_part = word_before_cursor[1:]  # Remove @
-        
+
         # Determine directory and prefix
         if "/" in path_part:
             # Path includes directory
@@ -87,18 +86,18 @@ class FileReferenceCompleter(Completer):
             # Just filename, search in current directory
             dir_path = "."
             prefix = path_part
-            
+
         # Get matching files
         try:
             if os.path.exists(dir_path) and os.path.isdir(dir_path):
                 for item in sorted(os.listdir(dir_path)):
                     if item.startswith(prefix):
                         full_path = os.path.join(dir_path, item) if dir_path != "." else item
-                        
+
                         # Skip hidden files unless explicitly requested
                         if item.startswith(".") and not prefix.startswith("."):
                             continue
-                            
+
                         # Add / for directories
                         if os.path.isdir(full_path):
                             display = item + "/"
@@ -106,15 +105,15 @@ class FileReferenceCompleter(Completer):
                         else:
                             display = item
                             completion = full_path
-                            
+
                         # Calculate how much to replace
                         start_position = -len(path_part)
-                        
+
                         yield Completion(
                             text=completion,
                             start_position=start_position,
                             display=display,
-                            display_meta="dir" if os.path.isdir(full_path) else "file"
+                            display_meta="dir" if os.path.isdir(full_path) else "file",
                         )
         except (OSError, PermissionError):
             # Silently ignore inaccessible directories
@@ -123,7 +122,9 @@ class FileReferenceCompleter(Completer):
 
 def create_completer(command_registry: Optional[CommandRegistry] = None) -> Completer:
     """Create a merged completer for both commands and file references."""
-    return merge_completers([
-        CommandCompleter(command_registry),
-        FileReferenceCompleter(),
-    ])
+    return merge_completers(
+        [
+            CommandCompleter(command_registry),
+            FileReferenceCompleter(),
+        ]
+    )

tunacode/ui/console.py

@@ -9,8 +9,9 @@ from rich.markdown import Markdown
 # Import and re-export all functions from specialized modules
 from .input import formatted_text, input, multiline_input
 from .keybindings import create_key_bindings
-from .output import (banner, clear, info, line, muted, print, show_update_message, spinner, success,
-                     sync_print, update_available, usage, version, warning)
+from .output import (banner, clear, info, line, muted, print, spinner, success, sync_print,
+                     update_available, usage, version, warning)
+# Patch banner to use sync fast version
 from .panels import (agent, dump_messages, error, help, models, panel, sync_panel,
                      sync_tool_confirm, tool_confirm)
 from .prompt_manager import PromptConfig, PromptManager
@@ -46,7 +47,6 @@ __all__ = [
     "line",
     "muted",
     "print",
-    "show_update_message",
     "spinner",
     "success",
     "sync_print",

tunacode/ui/input.py

@@ -72,7 +72,9 @@ async def input(
     return await manager.get_input(session_key, pretext, config)
 
 
-async def multiline_input(state_manager: Optional[StateManager] = None, command_registry=None) -> str:
+async def multiline_input(
+    state_manager: Optional[StateManager] = None, command_registry=None
+) -> str:
     """Get multiline input from the user with @file completion and highlighting."""
     kb = create_key_bindings()
     placeholder = formatted_text(
@@ -85,11 +87,12 @@ async def multiline_input(state_manager: Optional[StateManager] = None, command_
         )
     )
     return await input(
-        "multiline", 
-        key_bindings=kb, 
-        multiline=True, 
+        "multiline",
+        pretext="❯ ",  # Default prompt
+        key_bindings=kb,
+        multiline=True,
         placeholder=placeholder,
         completer=create_completer(command_registry),
         lexer=FileReferenceLexer(),
-        state_manager=state_manager
+        state_manager=state_manager,
     )

tunacode/ui/keybindings.py

@@ -7,8 +7,6 @@ def create_key_bindings() -> KeyBindings:
     """Create and configure key bindings for the UI."""
     kb = KeyBindings()
 
-    
-
     @kb.add("enter")
     def _submit(event):
         """Submit the current buffer."""
@@ -18,7 +16,7 @@ def create_key_bindings() -> KeyBindings:
     def _newline(event):
         """Insert a newline character."""
         event.current_buffer.insert_text("\n")
-    
+
     @kb.add("escape", "enter")
     def _escape_enter(event):
         """Insert a newline when escape then enter is pressed."""

tunacode/ui/lexers.py

@@ -8,39 +8,39 @@ from prompt_toolkit.lexers import Lexer
 
 class FileReferenceLexer(Lexer):
     """Lexer that highlights @file references in light blue."""
-    
+
     # Pattern to match @file references
-    FILE_REF_PATTERN = re.compile(r'@([\w./_-]+)')
-    
+    FILE_REF_PATTERN = re.compile(r"@([\w./_-]+)")
+
     def lex_document(self, document):
         """Return a formatted text list for the given document."""
-        lines = document.text.split('\n')
-        
+        lines = document.text.split("\n")
+
         def get_line_tokens(line_number):
             """Get tokens for a specific line."""
             if line_number >= len(lines):
                 return []
-                
+
             line = lines[line_number]
             tokens = []
             last_end = 0
-            
+
             # Find all @file references in the line
             for match in self.FILE_REF_PATTERN.finditer(line):
                 start, end = match.span()
-                
+
                 # Add text before the match
                 if start > last_end:
-                    tokens.append(('', line[last_end:start]))
-                
+                    tokens.append(("", line[last_end:start]))
+
                 # Add the @file reference with styling
-                tokens.append(('class:file-reference', match.group(0)))
+                tokens.append(("class:file-reference", match.group(0)))
                 last_end = end
-            
+
             # Add remaining text
             if last_end < len(line):
-                tokens.append(('', line[last_end:]))
-                
+                tokens.append(("", line[last_end:]))
+
             return tokens
-        
-        return get_line_tokens
+
+        return get_line_tokens

tunacode/ui/output.py

@@ -72,9 +72,9 @@ async def version() -> None:
 
 async def banner() -> None:
     """Display the application banner."""
-    console.clear()
+    await run_in_terminal(lambda: console.clear())
     banner_padding = Padding(BANNER, (2, 0, 1, 0))
-    await print(banner_padding)
+    await run_in_terminal(lambda: console.print(banner_padding))
 
 
 async def clear() -> None:

tunacode/ui/panels.py

@@ -11,10 +11,10 @@ from rich.table import Table
 
 from tunacode.configuration.models import ModelRegistry
 from tunacode.constants import (APP_NAME, CMD_CLEAR, CMD_COMPACT, CMD_DUMP, CMD_EXIT, CMD_HELP,
-                                CMD_MODEL, CMD_YOLO, DESC_CLEAR, DESC_COMPACT, DESC_DUMP,
-                                DESC_EXIT, DESC_HELP, DESC_MODEL, DESC_MODEL_DEFAULT,
-                                DESC_MODEL_SWITCH, DESC_YOLO, PANEL_AVAILABLE_COMMANDS,
-                                PANEL_ERROR, PANEL_MESSAGE_HISTORY, PANEL_MODELS, UI_COLORS)
+                                CMD_MODEL, CMD_YOLO, DESC_CLEAR, DESC_COMPACT, DESC_DUMP, DESC_EXIT,
+                                DESC_HELP, DESC_MODEL, DESC_MODEL_DEFAULT, DESC_MODEL_SWITCH,
+                                DESC_YOLO, PANEL_AVAILABLE_COMMANDS, PANEL_ERROR,
+                                PANEL_MESSAGE_HISTORY, PANEL_MODELS, UI_COLORS)
 from tunacode.core.state import StateManager
 from tunacode.utils.file_utils import DotDict
 
@@ -39,12 +39,12 @@ async def panel(
     """Display a rich panel with modern styling."""
     border_style = border_style or kwargs.get("style") or colors.border
     panel_obj = Panel(
-        Padding(text, (0, 1, 0, 1)), 
-        title=f"[bold]{title}[/bold]", 
-        title_align="left", 
+        Padding(text, (0, 1, 0, 1)),
+        title=f"[bold]{title}[/bold]",
+        title_align="left",
         border_style=border_style,
         padding=(0, 1),
-        box=ROUNDED  # Use ROUNDED box style
+        box=ROUNDED,  # Use ROUNDED box style
     )
     await print(Padding(panel_obj, (top, right, bottom, left)), **kwargs)
 

tunacode/ui/prompt_manager.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass
 from typing import Optional
 
 from prompt_toolkit.completion import Completer
-from prompt_toolkit.formatted_text import FormattedText
+from prompt_toolkit.formatted_text import HTML, FormattedText
 from prompt_toolkit.key_binding import KeyBindings
 from prompt_toolkit.lexers import Lexer
 from prompt_toolkit.shortcuts import PromptSession
@@ -42,12 +42,14 @@ class PromptManager:
         self.state_manager = state_manager
         self._temp_sessions = {}  # For when no state manager is available
         self._style = self._create_style()
-    
+
     def _create_style(self) -> Style:
         """Create the style for the prompt with file reference highlighting."""
-        return Style.from_dict({
-            'file-reference': UI_COLORS.get('file_ref', 'light_blue'),
-        })
+        return Style.from_dict(
+            {
+                "file-reference": UI_COLORS.get("file_ref", "light_blue"),
+            }
+        )
 
     def get_session(self, session_key: str, config: PromptConfig) -> PromptSession:
         """Get or create a prompt session.
@@ -98,10 +100,20 @@ class PromptManager:
         """
         session = self.get_session(session_key, config)
 
+        # Create a custom prompt that changes based on input
+        def get_prompt():
+            # Check if current buffer starts with "!"
+            if hasattr(session.app, "current_buffer") and session.app.current_buffer:
+                text = session.app.current_buffer.text
+                if text.startswith("!"):
+                    # Use bright yellow background with black text for high visibility
+                    return HTML('<style bg="#ffcc00" fg="black"><b> ◆ BASH MODE ◆ </b></style> ')
+            return HTML(prompt) if isinstance(prompt, str) else prompt
+
         try:
-            # Get user input
+            # Get user input with dynamic prompt
             response = await session.prompt_async(
-                prompt,
+                get_prompt,
                 is_password=config.is_password,
                 validator=config.validator,
                 multiline=config.multiline,

tunacode/utils/import_cache.py

@@ -0,0 +1,11 @@
+"""Utility for import caching and lazy importing heavy modules."""
+
+import importlib
+
+_import_cache = {}
+
+
+def lazy_import(module_name: str):
+    if module_name not in _import_cache:
+        _import_cache[module_name] = importlib.import_module(module_name)
+    return _import_cache[module_name]

tunacode/utils/user_configuration.py

@@ -18,12 +18,34 @@ if TYPE_CHECKING:
     from tunacode.core.state import StateManager
 
 
+import hashlib
+
+_config_fingerprint = None
+_config_cache = None
+
+
+def compute_config_fingerprint(config_obj) -> str:
+    """Returns a short hash/fingerprint for a config object/searchable for fastpath usage."""
+    b = json.dumps(config_obj, sort_keys=True).encode()
+    return hashlib.sha1(b).hexdigest()[:12]
+
+
 def load_config() -> Optional[UserConfig]:
-    """Load user config from file"""
+    """Load user config from file, using fingerprint fast path if available."""
+    global _config_fingerprint, _config_cache
     app_settings = ApplicationSettings()
     try:
         with open(app_settings.paths.config_file, "r") as f:
-            return json.load(f)
+            raw = f.read()
+            loaded = json.loads(raw)
+            new_fp = hashlib.sha1(raw.encode()).hexdigest()[:12]
+            # If hash matches, return in-memory cached config object
+            if new_fp == _config_fingerprint and _config_cache is not None:
+                return _config_cache
+            # else, update fast path
+            _config_fingerprint = new_fp
+            _config_cache = loaded
+            return loaded
     except FileNotFoundError:
         return None
     except JSONDecodeError:

{tunacode_cli-0.0.17.dist-info → tunacode_cli-0.0.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.17
+Version: 0.0.19
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License-Expression: MIT
@@ -58,14 +58,20 @@ Dynamic: license-file
 
 ---
 
-### Recent Updates (v0.0.14)
-
-- **🔧 JSON Tool Parsing Fallback**: Automatic recovery when API providers fail with structured tool calling
-- **⚡ Enhanced Reliability**: Fixed parameter naming issues that caused tool schema errors
-- **🔄 Configuration Management**: New `/refresh` command to reload config without restart
-- **🧠 Improved ReAct Reasoning**: Enhanced iteration limits (now defaults to 20) and better thought processing
-- **🛠️ New Debug Commands**: `/parsetools` for manual JSON parsing, `/iterations` for controlling reasoning depth
-- **📊 Better Error Recovery**: Multiple fallback mechanisms for various failure scenarios
+### Recent Updates (v0.0.18)
+
+- **Advanced Agent Orchestration**: New orchestrator system for complex multi-step tasks with planning visibility
+- **Background Task Manager**: Asynchronous background processing for long-running operations
+- **Read-Only Agent**: Specialized agent for safe codebase exploration without modification risks
+- **Planning Transparency**: See the AI's planning process before execution with detailed task breakdowns
+- **Shell Command Support**: Execute shell commands directly with `!command` or open interactive shell with `!`
+- **Enhanced Bash Tool**: Advanced bash execution with timeouts, working directory, and environment variables
+- **JSON Tool Parsing Fallback**: Automatic recovery when API providers fail with structured tool calling
+- **Enhanced Reliability**: Fixed parameter naming issues that caused tool schema errors
+- **Configuration Management**: New `/refresh` command to reload config without restart
+- **Improved ReAct Reasoning**: Enhanced iteration limits (now defaults to 20) and better thought processing
+- **New Debug Commands**: `/parsetools` for manual JSON parsing, `/iterations` for controlling reasoning depth
+- **Better Error Recovery**: Multiple fallback mechanisms for various failure scenarios
 
 ### Core Features
 
@@ -84,6 +90,7 @@ Dynamic: license-file
 ### **Developer Tools**
 
 - 6 core tools: bash, grep, read_file, write_file, update_file, run_command
+- Direct shell command execution with `!` prefix
 - MCP (Model Context Protocol) support
 - File operation confirmations with diffs
 - Per-project context guides (TUNACODE.md)
@@ -284,6 +291,8 @@ Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/)
 | `/model <provider:name> default` | Set default model                |
 | `/branch <name>`                 | Create and switch Git branch     |
 | `/dump`                          | Show message history (debug)     |
+| `!<command>`                     | Run shell command                |
+| `!`                              | Open interactive shell           |
 | `exit`                           | Exit application                 |
 
 ### Debug & Recovery Commands
@@ -298,6 +307,42 @@ Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/)
 
 ---
 
+## Available Tools
+
+### Bash Tool
+The enhanced bash tool provides advanced shell command execution with safety features:
+
+- **Working Directory Support**: Execute commands in specific directories
+- **Environment Variables**: Set custom environment variables for commands
+- **Timeout Control**: Configurable timeouts (1-300 seconds) to prevent hanging
+- **Output Capture**: Full stdout/stderr capture with truncation for large outputs
+- **Safety Checks**: Warns about potentially destructive commands
+- **Error Guidance**: Helpful error messages for common issues (command not found, permission denied, etc.)
+
+**Example usage by the AI:**
+```python
+# Simple command
+await bash("ls -la")
+
+# With working directory
+await bash("npm install", cwd="/path/to/project")
+
+# With timeout for long operations
+await bash("npm run build", timeout=120)
+
+# With environment variables
+await bash("python script.py", env={"API_KEY": "secret"})
+```
+
+### Other Core Tools
+- **grep**: Fast parallel content search across files
+- **read_file**: Read file contents with line numbers
+- **write_file**: Create new files (fails if file exists)
+- **update_file**: Modify existing files with precise replacements
+- **run_command**: Basic command execution (simpler than bash)
+
+---
+
 ## Reliability Features
 
 ### JSON Tool Parsing Fallback
@@ -360,7 +405,14 @@ src/tunacode/
 │
 ├── core/                 # Core Application Logic
 │   ├── agents/           # AI Agent System
-│   │   └── main.py       # Primary agent implementation (pydantic-ai)
+│   │   ├── main.py       # Primary agent implementation (pydantic-ai)
+│   │   ├── orchestrator.py # Complex task orchestration and planning
+│   │   ├── planner_schema.py # Planning data models
+│   │   └── readonly.py   # Read-only agent for safe exploration
+│   ├── background/       # Background Task Management
+│   │   └── manager.py    # Async background task execution
+│   ├── llm/              # LLM Integration
+│   │   └── planner.py    # LLM-based task planning
 │   ├── setup/            # Application Setup & Initialization
 │   │   ├── agent_setup.py     # Agent configuration
 │   │   ├── base.py           # Setup step base class
@@ -409,7 +461,7 @@ src/tunacode/
 ├── exceptions.py      # Custom exceptions
 ├── types.py           # Type definitions
 └── prompts/
-    └── system.txt     # System prompts for AI agent
+    └── system.md      # System prompts for AI agent
 ```
 
 ### Key Components
@@ -418,6 +470,8 @@ src/tunacode/
 | -------------------- | ------------------------ | ------------------------------- |
 | **CLI Layer**        | Command parsing and REPL | `cli/main.py`, `cli/repl.py`    |
 | **Agent System**     | AI-powered assistance    | `core/agents/main.py`           |
+| **Orchestrator**     | Complex task planning    | `core/agents/orchestrator.py`   |
+| **Background Tasks** | Async task execution     | `core/background/manager.py`    |
 | **Tool System**      | File/command operations  | `tools/*.py`                    |
 | **State Management** | Session state tracking   | `core/state.py`                 |
 | **UI Framework**     | Rich terminal interface  | `ui/output.py`, `ui/console.py` |
@@ -482,6 +536,9 @@ While TunaCode builds on the foundation of sidekick-cli, we've made several arch
 
 - **JSON Tool Parsing Fallback**: Added fallback parsing for when API providers fail with structured tool calling
 - **Parallel Search Tools**: New `bash` and `grep` tools with parallel execution for codebase navigation
+- **Agent Orchestration**: Advanced orchestrator for complex multi-step tasks with planning transparency
+- **Background Processing**: Asynchronous task manager for long-running operations
+- **Read-Only Agent**: Safe exploration mode that prevents accidental modifications
 - **ReAct Reasoning**: Implemented ReAct (Reasoning + Acting) patterns with configurable iteration limits
 - **Dynamic Configuration**: Added `/refresh` command and modified configuration management
 - **Safety Changes**: Removed automatic git commits and `/undo` command - requires explicit git usage