aru-code 0.24.1__tar.gz → 0.25.0__tar.gz

{aru_code-0.24.1/aru_code.egg-info → aru_code-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aru-code
-Version: 0.24.1
+Version: 0.25.0
 Summary: A Claude Code clone built with Agno agents
 Author-email: Estevao <estevaofon@gmail.com>
 License-Expression: MIT
@@ -53,7 +53,7 @@ An intelligent coding assistant for the terminal, powered by LLMs and [Agno](htt
 
 ## Highlights
 
-- **Multi-Agent Architecture** — Specialized agents for planning, execution, and conversation
+- **Multi-Agent Architecture** — Specialized agents for planning, execution, exploration, and conversation
 - **Interactive CLI** — Streaming responses, multi-line paste, session management
 - **Image Support** — Attach images via `@` mentions for multimodal analysis (Claude, GPT-4o, Gemini)
 - **11 Integrated Tools** — File operations, code search, shell, web search, task delegation
@@ -513,12 +513,13 @@ Aru can load tools from MCP servers. Configure in `.aru/mcp_config.json`:
 | **Planner** | Analyzes codebase, creates structured implementation plans | Read-only tools, search, web |
 | **Executor** | Implements code changes based on plans or instructions | All tools including delegation |
 | **General** | Handles conversation and simple operations | All tools including delegation |
+| **Explorer** | Fast, read-only codebase exploration and search | Read-only tools, search, bash (read-only) |
 
 ## Tools
 
 ### File Operations
 - `read_file` — Reads files with line range support and binary detection
-- `read_file_smart` — Answers specific questions about a file without returning raw content
+- `read_files` — Reads multiple files in parallel (single batched call)
 - `write_file` — Writes content to files, creating directories as needed
 - `edit_file` — Find-and-replace edits on files
 
@@ -553,7 +554,8 @@ aru-code/
 │   ├── permissions.py      # Granular permission system (allow/ask/deny)
 │   ├── agents/
 │   │   ├── planner.py      # Planning agent
-│   │   └── executor.py     # Execution agent
+│   │   ├── executor.py     # Execution agent
+│   │   └── explorer.py     # Explorer agent (fast, read-only codebase search)
 │   └── tools/
 │       ├── codebase.py     # 11 core tools
 │       ├── ast_tools.py    # Tree-sitter code analysis

{aru_code-0.24.1 → aru_code-0.25.0}/README.md

@@ -6,7 +6,7 @@ An intelligent coding assistant for the terminal, powered by LLMs and [Agno](htt
 
 ## Highlights
 
-- **Multi-Agent Architecture** — Specialized agents for planning, execution, and conversation
+- **Multi-Agent Architecture** — Specialized agents for planning, execution, exploration, and conversation
 - **Interactive CLI** — Streaming responses, multi-line paste, session management
 - **Image Support** — Attach images via `@` mentions for multimodal analysis (Claude, GPT-4o, Gemini)
 - **11 Integrated Tools** — File operations, code search, shell, web search, task delegation
@@ -466,12 +466,13 @@ Aru can load tools from MCP servers. Configure in `.aru/mcp_config.json`:
 | **Planner** | Analyzes codebase, creates structured implementation plans | Read-only tools, search, web |
 | **Executor** | Implements code changes based on plans or instructions | All tools including delegation |
 | **General** | Handles conversation and simple operations | All tools including delegation |
+| **Explorer** | Fast, read-only codebase exploration and search | Read-only tools, search, bash (read-only) |
 
 ## Tools
 
 ### File Operations
 - `read_file` — Reads files with line range support and binary detection
-- `read_file_smart` — Answers specific questions about a file without returning raw content
+- `read_files` — Reads multiple files in parallel (single batched call)
 - `write_file` — Writes content to files, creating directories as needed
 - `edit_file` — Find-and-replace edits on files
 
@@ -506,7 +507,8 @@ aru-code/
 │   ├── permissions.py      # Granular permission system (allow/ask/deny)
 │   ├── agents/
 │   │   ├── planner.py      # Planning agent
-│   │   └── executor.py     # Execution agent
+│   │   ├── executor.py     # Execution agent
+│   │   └── explorer.py     # Explorer agent (fast, read-only codebase search)
 │   └── tools/
 │       ├── codebase.py     # 11 core tools
 │       ├── ast_tools.py    # Tree-sitter code analysis

aru_code-0.25.0/aru/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.25.0"

{aru_code-0.24.1 → aru_code-0.25.0}/aru/agents/base.py

@@ -66,8 +66,8 @@ Every tool call accumulates its result in your context window. Use the minimum n
 
 1. **Find files/patterns** → `grep_search(pattern, file_glob="*.py")` or `glob_search`. \
 Default shows 10 lines of context — use `context_lines=30` for full function bodies.
-2. **Understand a file** → `read_file_smart(file_path, query)` — returns a concise answer, not raw content
-3. **Need raw content** → `read_file(file_path)` — returns first chunk + outline for large files
+2. **Need raw content** → `read_file(file_path)` — returns first chunk + outline for large files
+3. **Need several files at once** → `read_files(paths)` — parallel batch read
 
 **Batch independent tool calls**: When you need answers from multiple independent sources, \
 emit ALL those tool calls in a single response.
@@ -148,10 +148,10 @@ split into subtasks grouped by concern (e.g. "Create model files", "Create route
 
 ## Reading strategy — read, edit, test
 
-1. **Know the file + have a question?** → `read_file_smart(file_path, query)`
-2. **Need a specific pattern?** → `grep_search(pattern, file_glob="*.py")` — default 10 lines context. \
+1. **Need a specific pattern?** → `grep_search(pattern, file_glob="*.py")` — default 10 lines context. \
 Use `context_lines=30` for full function bodies.
-3. **Need lines for editing?** → `read_file(file_path, start_line=N, end_line=M)` using line numbers from grep
+2. **Need lines for editing?** → `read_file(file_path, start_line=N, end_line=M)` using line numbers from grep
+3. **Need several files at once?** → `read_files(paths)` — parallel batch read
 4. **Need the whole file?** → `read_file(file_path)` — returns first chunk + outline for large files
 5. **Need the COMPLETE file (>60KB)?** → `read_file(file_path, max_size=0)` — reads in chunks. Use rarely.
 
@@ -194,10 +194,9 @@ Skip exploration when the task is clear and the relevant files are obvious.
 
 Every tool call accumulates its result in your context window. Use the minimum needed:
 
-1. **Don't know which file?** → `grep_search` / `glob_search` for patterns, \
-`read_file_smart(file_path, query)` when you know the file.
-2. **Know the file + have a question?** → `read_file_smart(file_path, query)`
-3. **Need specific lines?** → `read_file(file_path, start_line=N, end_line=M)`
+1. **Don't know which file?** → `grep_search` / `glob_search` for patterns.
+2. **Need specific lines?** → `read_file(file_path, start_line=N, end_line=M)`
+3. **Need several files at once?** → `read_files(paths)` — parallel batch read.
 4. **Need the whole file?** → `read_file(file_path)` — returns first chunk + outline for large files.
 
 **NEVER read the same file twice.** Check if you already have the content in context.
@@ -218,7 +217,7 @@ For simple, directed lookups (one known file, one specific symbol) use \
 
 For **anything broader** — understanding a system, researching before implementing, \
 analyzing multiple files, writing specs or documentation — **always use explorer agents**. \
-Every `read_file` / `read_file_smart` / `grep_search` result you call directly accumulates \
+Every `read_file` / `read_files` / `grep_search` result you call directly accumulates \
 in YOUR context window and stays there forever. Explorer agents read files in their own \
 isolated context and return only a concise summary. This is critical: \
 **3 explorer summaries < 8 raw file reads** in context cost.

{aru_code-0.24.1 → aru_code-0.25.0}/aru/agents/explorer.py

@@ -7,24 +7,26 @@ from agno.agent import Agent
 from aru.providers import create_model
 from aru.runtime import get_ctx
 from aru.tools.codebase import (
+    _glob_search_tool,
+    _grep_search_tool,
+    _list_directory_tool,
+    _rank_files_tool,
+    _read_file_tool,
     bash,
-    glob_search,
-    grep_search,
-    list_directory,
-    rank_files,
-    read_file,
-    read_file_smart,
+    read_files,
 )
 
-# Read-only tools only — no write/edit/delegate (prevents recursion and mutations)
+# Read-only tools only — no write/edit/delegate (prevents recursion and mutations).
+# All wrappers are async so the Explorer's "multi-parallel tool calls" prompt
+# actually matches runtime behavior — Agno can await them concurrently.
 EXPLORER_TOOLS = [
-    read_file,
-    read_file_smart,
-    glob_search,
-    grep_search,
-    list_directory,
+    _read_file_tool,
+    read_files,
+    _glob_search_tool,
+    _grep_search_tool,
+    _list_directory_tool,
     bash,
-    rank_files,
+    _rank_files_tool,
 ]
 
 EXPLORER_ROLE = """\
@@ -52,7 +54,7 @@ Guidelines:
 - Use glob_search for broad file pattern matching
 - Use grep_search for searching file contents with regex
 - Use read_file when you know the specific file path you need to read
-- Use read_file_smart when you know the file and have a specific question about it
+- Use read_files (batch) when you need to pull several files at once
 - Use bash ONLY for read-only operations (ls, git status, git log, git diff, find, cat, head, tail)
 - NEVER use bash for: mkdir, touch, rm, cp, mv, git add, git commit, npm install, pip install, \
 or any file creation/modification

{aru_code-0.24.1 → aru_code-0.25.0}/aru/agents/planner.py

@@ -6,7 +6,11 @@ from agno.compression.manager import CompressionManager
 from aru.agents.base import build_instructions
 from aru.providers import create_model
 from aru.tools.codebase import (
-    glob_search, grep_search, list_directory, read_file, read_file_smart,
+    _glob_search_tool,
+    _grep_search_tool,
+    _list_directory_tool,
+    _read_file_tool,
+    read_files,
 )
 from aru.runtime import get_ctx
 
@@ -34,8 +38,8 @@ Return ONLY the markdown plan. No explanation, no preamble.\
 
 # Planner uses read-only tools only — no write/edit/bash
 PLANNER_TOOLS = [
-    read_file, read_file_smart,
-    glob_search, grep_search, list_directory,
+    _read_file_tool, read_files,
+    _glob_search_tool, _grep_search_tool, _list_directory_tool,
 ]
 
 

{aru_code-0.24.1 → aru_code-0.25.0}/aru/display.py

@@ -161,6 +161,10 @@ class StatusBar:
         self._index = 0
         self._last_switch = time.monotonic()
         self._override: str | None = None
+        # A single persistent Spinner — Rich's Spinner tracks frames via
+        # (time - start_time), so instantiating a new one per render would
+        # reset start_time each frame and make the animation look frozen.
+        self._spinner = Spinner("dots", text="", style="cyan")
 
     @property
     def current_text(self) -> str:
@@ -187,8 +191,8 @@ class StatusBar:
 
     def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
         self._maybe_rotate()
-        spinner = Spinner("dots", text=f"[dim]{self.current_text}[/dim]", style="cyan")
-        yield from spinner.__rich_console__(console, options)
+        self._spinner.update(text=Text(self.current_text, style="dim"))
+        yield from self._spinner.__rich_console__(console, options)
 
     def __rich_measure__(self, console: Console, options: ConsoleOptions) -> Measurement:
         return Measurement(1, options.max_width)
@@ -196,7 +200,7 @@ class StatusBar:
 
 TOOL_DISPLAY_NAMES = {
     "read_file": "Read",
-    "read_file_smart": "ReadSmart",
+    "read_files": "ReadBatch",
     "write_file": "Write",
     "edit_file": "Edit",
     "glob_search": "Glob",
@@ -209,7 +213,7 @@ TOOL_DISPLAY_NAMES = {
 
 TOOL_PRIMARY_ARG = {
     "read_file": "file_path",
-    "read_file_smart": "file_path",
+    "read_files": "paths",
     "write_file": "file_path",
     "edit_file": "file_path",
     "glob_search": "pattern",
@@ -253,6 +257,34 @@ def _format_tool_label(tool_name: str, tool_args: dict | None) -> str:
     return display
 
 
+def subagent_progress(label: str, tool_name: str, tool_args: dict | None,
+                      duration: float | None = None):
+    """Print sub-agent tool completion into the active Live context (or console).
+
+    Only called on tool completion — shows a single ✓ line per tool call,
+    keeping the output compact (no duplicate start/complete lines).
+    """
+    from aru.runtime import get_ctx
+    try:
+        ctx = get_ctx()
+    except LookupError:
+        return
+    tool_label = _format_tool_label(tool_name, tool_args)
+    dur_str = f" {duration:.1f}s" if duration and duration >= 0.5 else ""
+    line = Text.assemble(
+        ("    ", ""),
+        ("\u2713 ", "bold green"),
+        (f"[{label}] ", "dim"),
+        (tool_label, "dim"),
+        (dur_str, "dim cyan"),
+    )
+    target = ctx.live if ctx.live else None
+    if target:
+        target.console.print(line)
+    else:
+        ctx.console.print(line)
+
+
 class ToolTracker:
     """Tracks active tool calls with timing, displayed inside the Live area."""
 

{aru_code-0.24.1 → aru_code-0.25.0}/aru/runner.py

@@ -462,6 +462,24 @@ def _build_file_context(file_paths: list[str], max_total: int = 20_000) -> str:
     return "## Pre-loaded file contents (do NOT re-read these files)\n\n" + "\n\n".join(parts)
 
 
+_MODIFY_VERBS = frozenset({
+    "add", "create", "write", "edit", "modify", "update", "implement",
+    "fix", "replace", "rename", "move", "refactor", "remove", "delete",
+})
+_MUTATION_LABELS = frozenset({"Write", "Edit", "Bash"})
+
+
+def _step_expected_mutation(description: str) -> bool:
+    """Check if step description implies file modifications."""
+    first_word = description.strip().split()[0].lower().rstrip(":")
+    return first_word in _MODIFY_VERBS
+
+
+def _has_mutation_tool(tool_calls: list[str]) -> bool:
+    """Check if any tool call is a write/edit/bash operation."""
+    return any(tc.split("(")[0] in _MUTATION_LABELS for tc in tool_calls)
+
+
 async def execute_plan_steps(session, executor_factory) -> str | None:
     """Execute plan steps one by one with live progress tracking."""
     plan_files = _extract_plan_file_paths(session.current_plan)
@@ -586,12 +604,57 @@ async def execute_plan_steps(session, executor_factory) -> str | None:
                 )
 
             if step_failed:
-                step.status = "failed"
+                # Auto-retry once with error context before asking the user
                 fail_msg = content[:200] if content else f"{tasks_failed}/{tasks_total} subtasks failed"
-                console.print(f"\n[red]Step {step.index} failed: {fail_msg}[/red]")
-                if not get_skip_permissions() and not ask_yes_no("Continue with remaining steps?"):
-                    break
-            elif content or tasks_all_done:
+                console.print(f"\n[yellow]Step {step.index} failed, retrying automatically...[/yellow]")
+                reset_task_store()
+                retry_prompt = (
+                    step_prompt
+                    + f"\n\n## Previous Attempt Failed\nError: {fail_msg}\n"
+                    + "Fix the issues from the previous attempt. Do NOT repeat the same mistake."
+                )
+                executor = executor_factory()
+                retry_result = await run_agent_capture(executor, retry_prompt, session, lightweight=True)
+                content = retry_result.content
+                run_result = retry_result
+
+                # Re-evaluate after retry
+                store = get_task_store()
+                all_tasks = store.get_all()
+                tasks_completed = sum(1 for t in all_tasks if t["status"] == "completed")
+                tasks_failed = sum(1 for t in all_tasks if t["status"] == "failed")
+                tasks_total = len(all_tasks)
+                tasks_all_done = tasks_total > 0 and (tasks_completed + tasks_failed == tasks_total)
+
+                still_failed = False
+                if tasks_all_done and tasks_failed > 0 and tasks_completed == 0:
+                    still_failed = True
+                elif content:
+                    still_failed = (
+                        content.startswith("Error")
+                        or "Error from OpenAI API" in content
+                        or "Error in Agent run" in content
+                    )
+
+                if still_failed:
+                    step.status = "failed"
+                    fail_msg = content[:200] if content else f"{tasks_failed}/{tasks_total} subtasks failed"
+                    console.print(f"\n[red]Step {step.index} failed after retry: {fail_msg}[/red]")
+                    if not get_skip_permissions() and not ask_yes_no("Continue with remaining steps?"):
+                        break
+                else:
+                    # Retry succeeded — fall through to success handling
+                    step_failed = False
+
+            # Mutation validation warning (non-blocking)
+            if not step_failed and not run_result.stalled:
+                if _step_expected_mutation(step.description) and not _has_mutation_tool(run_result.tool_calls):
+                    console.print(
+                        f"[yellow]\u26a0 Step {step.index} was expected to modify files "
+                        f"but no write tools were called.[/yellow]"
+                    )
+
+            if not step_failed and (content or tasks_all_done):
                 step.status = "completed"
                 summary = content or f"All {tasks_completed} subtasks completed."
                 step_text = f"### Step {step.index}: {step.description}\n{summary}"
@@ -609,8 +672,26 @@ async def execute_plan_steps(session, executor_factory) -> str | None:
             if not get_skip_permissions() and not ask_yes_no("Continue with remaining steps?"):
                 break
         except Exception as e:
+            # Auto-retry once on exception
+            console.print(f"\n[yellow]Step {step.index} error: {e}. Retrying...[/yellow]")
+            try:
+                reset_task_store()
+                retry_prompt = (
+                    step_prompt
+                    + f"\n\n## Previous Attempt Error\n{e}\n"
+                    + "Fix the issues and complete this step."
+                )
+                executor = executor_factory()
+                retry_result = await run_agent_capture(executor, retry_prompt, session, lightweight=True)
+                if retry_result.content and not retry_result.content.startswith("Error"):
+                    step.status = "completed"
+                    all_results.append(f"### Step {step.index}: {step.description}\n{retry_result.content}")
+                    completed_context += f"\n- Step {step.index} ({step.description}): Done (after retry)"
+                    continue
+            except Exception:
+                pass
             step.status = "failed"
-            console.print(f"\n[red]Step {step.index} failed: {e}[/red]")
+            console.print(f"\n[red]Step {step.index} failed after retry: {e}[/red]")
             if not get_skip_permissions() and not ask_yes_no("Continue with remaining steps?"):
                 break