agentic-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-01-28
+
+### Added
+
+- **Task Progress Display**: Thinking box now shows dynamic task progress with status icons (◐ ☐ ✓ ✗)
+- `TASK_PROGRESS` event type for signaling task graph updates
+- `TaskGraph.to_compact_display()` for condensed status display
+
+### Changed
+
+- **Background Initialization**: Workflow manager now initializes services in background, eliminating first-message lag
+- Simplified LangGraph imports - removed `_import_langgraph` helper in favor of direct imports
+
 ## [0.3.0] - 2025-01-27
 
 ### Added

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: A framework for building domain-specific agentic CLI applications
 Project-URL: Homepage, https://github.com/shoom1/agentic-cli
 Project-URL: Repository, https://github.com/shoom1/agentic-cli
@@ -60,6 +60,8 @@ Agentic CLI provides the core infrastructure for building interactive CLI applic
 │  - Terminal UI (thinking-prompt)                                    │
 │  - Command registry (/help, /status, /clear, etc.)                  │
 │  - Message history                                                  │
+│  - Background initialization (no first-message lag)                 │
+│  - Task progress display in thinking box                            │
 └─────────────────────────────────────────────────────────────────────┘
                                  │
                                  ▼
@@ -430,6 +432,7 @@ WorkflowEvent types for UI integration:
 | `CODE_EXECUTION` | Code execution result | outcome |
 | `ERROR` | Error message | recoverable, error_code |
 | `USER_INPUT_REQUIRED` | Tool needs user input | request_id, prompt |
+| `TASK_PROGRESS` | Task graph update | current_task_description, progress |
 
 ### Processing Events
 
@@ -445,6 +448,24 @@ async for event in manager.process(message, user_id="user1"):
         print(f"Result: {event.metadata['result']}")
 ```
 
+### Task Progress Display
+
+When using a task graph for planning, the CLI thinking box dynamically shows task progress:
+
+```
+Calling: search_web
+─── Tasks: 2/5 ───
+◐ Researching topic
+☐ Analyzing results
+☐ Writing summary
+```
+
+Status icons:
+- `◐` In progress
+- `☐` Pending
+- `✓` Completed
+- `✗` Failed
+
 ## Examples
 
 See the `examples/` directory for complete working examples:

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/README.md

@@ -21,6 +21,8 @@ Agentic CLI provides the core infrastructure for building interactive CLI applic
 │  - Terminal UI (thinking-prompt)                                    │
 │  - Command registry (/help, /status, /clear, etc.)                  │
 │  - Message history                                                  │
+│  - Background initialization (no first-message lag)                 │
+│  - Task progress display in thinking box                            │
 └─────────────────────────────────────────────────────────────────────┘
                                  │
                                  ▼
@@ -391,6 +393,7 @@ WorkflowEvent types for UI integration:
 | `CODE_EXECUTION` | Code execution result | outcome |
 | `ERROR` | Error message | recoverable, error_code |
 | `USER_INPUT_REQUIRED` | Tool needs user input | request_id, prompt |
+| `TASK_PROGRESS` | Task graph update | current_task_description, progress |
 
 ### Processing Events
 
@@ -406,6 +409,24 @@ async for event in manager.process(message, user_id="user1"):
         print(f"Result: {event.metadata['result']}")
 ```
 
+### Task Progress Display
+
+When using a task graph for planning, the CLI thinking box dynamically shows task progress:
+
+```
+Calling: search_web
+─── Tasks: 2/5 ───
+◐ Researching topic
+☐ Analyzing results
+☐ Writing summary
+```
+
+Status icons:
+- `◐` In progress
+- `☐` Pending
+- `✓` Completed
+- `✗` Failed
+
 ## Examples
 
 See the `examples/` directory for complete working examples:

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentic-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "A framework for building domain-specific agentic CLI applications"
 readme = "README.md"
 license = "MIT"

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/__init__.py

@@ -107,4 +107,4 @@ __all__ = [
     "FullFeaturesMixin",
 ]
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/cli/app.py

@@ -513,7 +513,12 @@ class BaseCLIApp:
         self.command_registry.register(SettingsCommand())
 
     async def _background_init(self) -> None:
-        """Initialize workflow manager in background thread."""
+        """Initialize workflow manager in background.
+
+        Creates the workflow manager and calls initialize_services() to
+        preload LLM, build graph, and set up checkpointing. This avoids
+        lag on the first user message.
+        """
         loop = asyncio.get_running_loop()
 
         def _create_workflow() -> "BaseWorkflowManager":
@@ -521,10 +526,16 @@ class BaseCLIApp:
 
         try:
             logger.debug("background_init_starting")
+
+            # Step 1: Create workflow manager (sync, in thread pool)
             self._workflow = await loop.run_in_executor(
                 _init_executor, _create_workflow
             )
 
+            # Step 2: Initialize services (async - builds graph, loads LLM, etc.)
+            # This is the expensive part that was previously deferred to first message
+            await self._workflow.initialize_services()
+
             # Update status bar to show ready
             model = self._workflow.model
             self.session.status_text = f"{model} | Ctrl+C: cancel | /help: commands"
@@ -674,7 +685,7 @@ class BaseCLIApp:
         if self._settings.log_activity:
             self.message_history.add(message, MessageType.USER)
 
-        # Status line for thinking box (single line updates)
+        # Status line for thinking box (multi-line with task progress)
         status_line = "Processing..."
         thinking_started = False
 
@@ -683,7 +694,26 @@ class BaseCLIApp:
         response_content: list[str] = []
 
         def get_status() -> str:
-            return status_line
+            """Build status display with current action and task progress."""
+            lines = [status_line]
+
+            # Add task progress if task graph exists and has tasks
+            task_graph = getattr(self.workflow, "task_graph", None)
+            if task_graph is not None:
+                progress = task_graph.get_progress()
+                if progress["total"] > 0:
+                    # Add separator and progress bar
+                    completed = progress["completed"]
+                    total = progress["total"]
+                    in_progress = progress["in_progress"]
+                    lines.append(f"─── Tasks: {completed}/{total} ───")
+
+                    # Add compact task list
+                    compact_display = task_graph.to_compact_display(max_tasks=5)
+                    if compact_display:
+                        lines.append(compact_display)
+
+            return "\n".join(lines)
 
         try:
             self.session.start_thinking(get_status)
@@ -758,6 +788,13 @@ class BaseCLIApp:
                     # Update status with file info
                     status_line = f"File: {event.content}"
 
+                elif event.type == EventType.TASK_PROGRESS:
+                    # Task progress update - status is rebuilt dynamically by get_status()
+                    # Just update the status line with current task info if available
+                    current_task = event.metadata.get("current_task_description")
+                    if current_task:
+                        status_line = f"Working on: {current_task}"
+
             # Finish thinking box (don't add status to history)
             if thinking_started:
                 self.session.finish_thinking(add_to_history=False)

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/planning/task_graph.py

@@ -314,6 +314,69 @@ class TaskGraph:
 
         return "\n".join(lines)
 
+    def to_compact_display(self, max_tasks: int = 5, max_desc_len: int = 30) -> str:
+        """Generate a compact display suitable for the thinking box status line.
+
+        Shows task progress in a condensed format with truncated descriptions.
+        Prioritizes showing in-progress tasks, then pending tasks.
+
+        Args:
+            max_tasks: Maximum number of tasks to display
+            max_desc_len: Maximum length for task descriptions
+
+        Returns:
+            A compact string representation with status icons.
+        """
+        if not self._tasks:
+            return ""
+
+        lines = []
+
+        # Find root tasks (no parent), sorted by status priority
+        root_tasks = [t for t in self._tasks.values() if t.parent is None]
+
+        # Sort: in_progress first, then pending, then others
+        status_order = {
+            TaskStatus.IN_PROGRESS: 0,
+            TaskStatus.PENDING: 1,
+            TaskStatus.BLOCKED: 2,
+            TaskStatus.COMPLETED: 3,
+            TaskStatus.FAILED: 4,
+            TaskStatus.SKIPPED: 5,
+        }
+        root_tasks.sort(key=lambda t: status_order.get(t.status, 99))
+
+        def format_task_compact(task: Task, indent: int = 0) -> None:
+            if len(lines) >= max_tasks:
+                return
+            icon = STATUS_ICONS.get(task.status, "?")
+            prefix = "  " * indent
+            desc = task.description
+            if len(desc) > max_desc_len:
+                desc = desc[: max_desc_len - 1] + "…"
+            lines.append(f"{prefix}{icon} {desc}")
+
+            # Format subtasks (limited)
+            for subtask_id in task.subtasks:
+                if len(lines) >= max_tasks:
+                    break
+                subtask = self._tasks.get(subtask_id)
+                if subtask:
+                    format_task_compact(subtask, indent + 1)
+
+        for task in root_tasks:
+            if len(lines) >= max_tasks:
+                break
+            format_task_compact(task)
+
+        # Add overflow indicator if needed
+        total = len(self._tasks)
+        if total > max_tasks:
+            remaining = total - len(lines)
+            lines.append(f"  ... +{remaining} more")
+
+        return "\n".join(lines)
+
     def revise(self, changes: list[dict[str, Any]]) -> None:
         """Apply a list of changes to the task graph.
 

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/workflow/events.py

@@ -41,6 +41,7 @@ class EventType(Enum):
     FILE_DATA = "file_data"
     ERROR = "error"
     USER_INPUT_REQUIRED = "user_input_required"
+    TASK_PROGRESS = "task_progress"
 
 
 @dataclass
@@ -251,3 +252,36 @@ class WorkflowEvent:
             content=prompt,
             metadata=metadata,
         )
+
+    @classmethod
+    def task_progress(
+        cls,
+        display: str,
+        progress: dict[str, int],
+        current_task_id: str | None = None,
+        current_task_description: str | None = None,
+    ) -> "WorkflowEvent":
+        """Create a task progress event for updating the thinking box.
+
+        This event signals that the task graph has been updated and the UI
+        should refresh its display of task progress.
+
+        Args:
+            display: Formatted string representation of the task graph
+            progress: Progress statistics (total, pending, completed, etc.)
+            current_task_id: ID of the task currently being worked on
+            current_task_description: Description of the current task
+        """
+        metadata: dict[str, Any] = {
+            "progress": progress,
+        }
+        if current_task_id is not None:
+            metadata["current_task_id"] = current_task_id
+        if current_task_description is not None:
+            metadata["current_task_description"] = current_task_description
+
+        return cls(
+            type=EventType.TASK_PROGRESS,
+            content=display,
+            metadata=metadata,
+        )

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/workflow/langgraph/manager.py

@@ -33,22 +33,6 @@ if TYPE_CHECKING:
 logger = Loggers.workflow()
 
 
-# Lazy imports for LangGraph dependencies
-def _import_langgraph():
-    """Lazily import LangGraph dependencies."""
-    try:
-        from langgraph.graph import StateGraph, END
-        from langgraph.checkpoint.memory import MemorySaver
-        from langgraph.types import RetryPolicy
-
-        return StateGraph, END, MemorySaver, RetryPolicy
-    except ImportError as e:
-        raise ImportError(
-            "LangGraph dependencies not installed. "
-            "Install with: pip install agentic-cli[langgraph]"
-        ) from e
-
-
 class LangGraphWorkflowManager(BaseWorkflowManager):
     """LangGraph-based workflow manager for agentic applications.
 
@@ -305,7 +289,7 @@ class LangGraphWorkflowManager(BaseWorkflowManager):
         Returns:
             RetryPolicy configured with settings values for retry behavior.
         """
-        StateGraph, END, MemorySaver, RetryPolicy = _import_langgraph()
+        from langgraph.types import RetryPolicy
 
         return RetryPolicy(
             max_attempts=self._settings.retry_max_attempts,
@@ -319,7 +303,7 @@ class LangGraphWorkflowManager(BaseWorkflowManager):
         Creates a graph where each agent config becomes a node,
         with edges based on sub_agent relationships.
         """
-        StateGraph, END, MemorySaver, RetryPolicy = _import_langgraph()
+        from langgraph.graph import StateGraph, END
         from agentic_cli.workflow.langgraph.state import AgentState
 
         # Build config map

{agentic_cli-0.3.0 → agentic_cli-0.3.1}/src/agentic_cli/workflow/langgraph_manager.py

@@ -24,11 +24,9 @@ warnings.warn(
 from agentic_cli.workflow.langgraph.manager import (
     LangGraphWorkflowManager,
     LangGraphManager,
-    _import_langgraph,
 )
 
 __all__ = [
     "LangGraphWorkflowManager",
     "LangGraphManager",
-    "_import_langgraph",
 ]