tunacode-cli 0.0.55__py3-none-any.whl → 0.0.78.6__py3-none-any.whl

tunacode/core/setup/config_wizard.py

@@ -0,0 +1,230 @@
+"""Module: tunacode.core.setup.config_wizard
+
+Wizard-style onboarding helpers extracted from ConfigSetup to reduce file size
+and keep responsibilities focused.
+"""
+
+import json
+from pathlib import Path
+from typing import Dict, Optional
+
+from tunacode.constants import UI_COLORS
+from tunacode.exceptions import ConfigurationError
+from tunacode.ui import console as ui
+from tunacode.utils import user_configuration
+
+
+class ConfigWizard:
+    """Encapsulates the interactive configuration wizard flow."""
+
+    def __init__(self, state_manager, model_registry, config_file: Path):
+        self.state_manager = state_manager
+        self.model_registry = model_registry
+        self.config_file = config_file
+        self._wizard_selected_provider: Optional[Dict[str, str]] = None
+
+    async def run_onboarding(self) -> None:
+        """Run enhanced wizard-style onboarding process for new users."""
+        initial_config = json.dumps(self.state_manager.session.user_config, sort_keys=True)
+
+        # Welcome message with provider guidance
+        await ui.panel(
+            "Welcome to TunaCode Setup Wizard!",
+            "This guided setup will help you configure TunaCode in under 5 minutes.\n"
+            "We'll help you choose a provider, set up your API keys, and configure your "
+            "preferred model.",
+            border_style=UI_COLORS["primary"],
+        )
+
+        # Steps
+        await self._step1_provider_selection()
+        await self._step2_api_key_setup()
+        await self._step3_model_selection()
+        await self._step4_optional_settings()
+
+        # Save configuration and finish
+        current_config = json.dumps(self.state_manager.session.user_config, sort_keys=True)
+        if initial_config != current_config:
+            try:
+                user_configuration.save_config(self.state_manager)
+                await ui.panel(
+                    "Setup Complete!",
+                    f"Configuration saved to: [bold]{self.config_file}[/bold]\n\n"
+                    "You're ready to start using TunaCode!\n"
+                    "Use [green]/quickstart[/green] anytime for a tutorial.",
+                    border_style=UI_COLORS["success"],
+                )
+            except ConfigurationError as e:
+                await ui.error(str(e))
+
+    async def _step1_provider_selection(self) -> None:
+        """Wizard step 1: Provider selection with detailed explanations."""
+        provider_info = {
+            "1": {
+                "name": "OpenRouter",
+                "description": "Access to multiple models (GPT-4, Claude, Gemini, etc.)",
+                "signup": "https://openrouter.ai/",
+                "key_name": "OPENROUTER_API_KEY",
+            },
+            "2": {
+                "name": "OpenAI",
+                "description": "GPT-4 models",
+                "signup": "https://platform.openai.com/signup",
+                "key_name": "OPENAI_API_KEY",
+            },
+            "3": {
+                "name": "Anthropic",
+                "description": "Claude-3 models",
+                "signup": "https://console.anthropic.com/",
+                "key_name": "ANTHROPIC_API_KEY",
+            },
+            "4": {
+                "name": "Google",
+                "description": "Gemini models",
+                "signup": "https://ai.google.dev/",
+                "key_name": "GEMINI_API_KEY",
+            },
+        }
+
+        message = "Choose your AI provider:\n\n"
+        for key, info in provider_info.items():
+            message += f"  {key} - {info['name']}: {info['description']}\n"
+
+        await ui.panel("Provider Selection", message, border_style=UI_COLORS["primary"])
+
+        while True:
+            choice = await ui.input(
+                "wizard_provider",
+                pretext="  Choose provider (1-4): ",
+                state_manager=self.state_manager,
+            )
+
+            if choice.strip() in provider_info:
+                selected = provider_info[choice.strip()]
+                self._wizard_selected_provider = selected
+
+                await ui.success(f"Selected: {selected['name']}")
+                await ui.info(f"Sign up at: {selected['signup']}")
+                break
+            else:
+                await ui.error("Please enter 1, 2, 3, or 4")
+
+    async def _step2_api_key_setup(self) -> None:
+        """Wizard step 2: API key setup with provider-specific guidance."""
+        provider = self._wizard_selected_provider
+
+        message = f"Enter your {provider['name']} API key:\n\n"
+        message += f"Get your key from: {provider['signup']}\n"
+        message += "Your key will be stored securely in your local config"
+
+        await ui.panel(f"{provider['name']} API Key", message, border_style=UI_COLORS["primary"])
+
+        while True:
+            api_key = await ui.input(
+                "wizard_api_key",
+                pretext=f"  {provider['name']} API Key: ",
+                is_password=True,
+                state_manager=self.state_manager,
+            )
+
+            if api_key.strip():
+                # Ensure env dict exists
+                if "env" not in self.state_manager.session.user_config:
+                    self.state_manager.session.user_config["env"] = {}
+
+                self.state_manager.session.user_config["env"][provider["key_name"]] = (
+                    api_key.strip()
+                )
+                await ui.success("API key saved successfully!")
+                break
+            else:
+                await ui.error("API key cannot be empty")
+
+    async def _step3_model_selection(self) -> None:
+        """Wizard step 3: Model selection with smart recommendations."""
+        provider = self._wizard_selected_provider
+
+        # Provide smart recommendations based on provider
+        recommendations = {
+            "OpenAI": [
+                ("openai:gpt-4o", "GPT-4o flagship multimodal model (recommended)"),
+                ("openai:gpt-4.1", "Latest GPT-4.1 with enhanced coding"),
+                ("openai:o3", "Advanced reasoning model for complex tasks"),
+            ],
+            "Anthropic": [
+                ("anthropic:claude-sonnet-4", "Claude Sonnet 4 latest generation (recommended)"),
+                ("anthropic:claude-opus-4.1", "Most capable Claude with extended thinking"),
+                ("anthropic:claude-3.5-sonnet", "Claude 3.5 Sonnet proven performance"),
+            ],
+            "OpenRouter": [
+                (
+                    "openrouter:anthropic/claude-sonnet-4",
+                    "Claude Sonnet 4 via OpenRouter (recommended)",
+                ),
+                ("openrouter:openai/gpt-4.1", "GPT-4.1 via OpenRouter"),
+                ("openrouter:google/gemini-2.5-flash", "Google Gemini 2.5 Flash latest"),
+            ],
+            "Google": [
+                (
+                    "google:gemini-2.5-pro",
+                    "Gemini 2.5 Pro with thinking capabilities (recommended)",
+                ),
+                ("google:gemini-2.5-flash", "Gemini 2.5 Flash best price-performance"),
+                ("google:gemini-2.0-flash", "Gemini 2.0 Flash with native tool use"),
+            ],
+        }
+
+        models = recommendations.get(provider["name"], [])
+        message = f"Choose your default {provider['name']} model:\n\n"
+
+        for i, (model_id, description) in enumerate(models, 1):
+            message += f"  {i} - {description}\n"
+
+        message += "\nYou can change this later with [green]/model[/green]"
+
+        await ui.panel("Model Selection", message, border_style=UI_COLORS["primary"])
+
+        while True:
+            choice = await ui.input(
+                "wizard_model",
+                pretext=f"  Choose model (1-{len(models)}): ",
+                state_manager=self.state_manager,
+            )
+
+            try:
+                index = int(choice.strip()) - 1
+                if 0 <= index < len(models):
+                    selected_model = models[index][0]
+                    self.state_manager.session.user_config["default_model"] = selected_model
+                    await ui.success(f"Selected: {selected_model}")
+                    break
+                else:
+                    await ui.error(f"Please enter a number between 1 and {len(models)}")
+            except ValueError:
+                await ui.error("Please enter a valid number")
+
+    async def _step4_optional_settings(self) -> None:
+        """Wizard step 4: Optional settings configuration."""
+        message = "Configure optional settings:\n\n"
+        message += "• Tutorial: Enable interactive tutorial for new users\n"
+        message += "\nSkip this step to use recommended defaults"
+
+        await ui.panel("Optional Settings", message, border_style=UI_COLORS["primary"])
+
+        # Ask about tutorial
+        tutorial_choice = await ui.input(
+            "wizard_tutorial",
+            pretext="  Enable tutorial for new users? [Y/n]: ",
+            state_manager=self.state_manager,
+        )
+
+        enable_tutorial = tutorial_choice.strip().lower() not in ["n", "no", "false"]
+
+        if "settings" not in self.state_manager.session.user_config:
+            self.state_manager.session.user_config["settings"] = {}
+
+        self.state_manager.session.user_config["settings"]["enable_tutorial"] = enable_tutorial
+
+        # Streaming is always enabled - no user choice needed
+
+        await ui.info("Optional settings configured!")

tunacode/core/setup/coordinator.py

@@ -22,8 +22,8 @@ class SetupCoordinator:
         """Register a setup step to be run."""
         self.setup_steps.append(step)
 
-    async def run_setup(self, force_setup: bool = False) -> None:
-        """Run all registered setup steps concurrently if possible."""
+    async def run_setup(self, force_setup: bool = False, wizard_mode: bool = False) -> None:
+        """Run all registered setup steps with proper dependency order."""
         # Run should_run checks sequentially (they may depend on order)
         steps_to_run = []
         for step in self.setup_steps:
@@ -35,11 +35,20 @@ class SetupCoordinator:
                     f"Setup failed at step '{getattr(step, 'name', repr(step))}': {str(e)}"
                 )
                 raise
-        # Run all .execute(force_setup) in parallel where possible (independent steps)
-        from asyncio import gather
 
         try:
-            await gather(*(step.execute(force_setup) for step in steps_to_run))
+            # Run steps sequentially to respect dependencies
+            # (ConfigSetup must complete before EnvironmentSetup)
+            for step in steps_to_run:
+                # Check if the step's execute method supports wizard_mode
+                import inspect
+
+                sig = inspect.signature(step.execute)
+                if "wizard_mode" in sig.parameters:
+                    await step.execute(force_setup, wizard_mode=wizard_mode)
+                else:
+                    await step.execute(force_setup)
+
             # Now validate all sequentially: if any fail, raise error
             for step in steps_to_run:
                 if not await step.validate():

tunacode/core/state.py

@@ -10,13 +10,13 @@ import uuid
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Optional
 
+from tunacode.configuration.defaults import DEFAULT_USER_CONFIG
 from tunacode.types import (
     DeviceId,
     InputSessions,
     MessageHistory,
     ModelName,
     SessionId,
-    TodoItem,
     ToolName,
     UserConfig,
 )
@@ -37,7 +37,8 @@ class SessionState:
     )  # Keep as dict[str, Any] for agent instances
     messages: MessageHistory = field(default_factory=list)
     total_cost: float = 0.0
-    current_model: ModelName = "openai:gpt-4o"
+    # Keep session default in sync with configuration default
+    current_model: ModelName = DEFAULT_USER_CONFIG["default_model"]
     spinner: Optional[Any] = None
     tool_ignore: list[ToolName] = field(default_factory=list)
     yolo: bool = False
@@ -47,7 +48,10 @@ class SessionState:
     device_id: Optional[DeviceId] = None
     input_sessions: InputSessions = field(default_factory=dict)
     current_task: Optional[Any] = None
-    todos: list[TodoItem] = field(default_factory=list)
+    # CLAUDE_ANCHOR[react-scratchpad]: Session scratchpad for ReAct tooling
+    react_scratchpad: dict[str, Any] = field(default_factory=lambda: {"timeline": []})
+    react_forced_calls: int = 0
+    react_guidance: list[str] = field(default_factory=list)
     # Operation state tracking
     operation_cancelled: bool = False
     # Enhanced tracking for thoughts display
@@ -111,19 +115,6 @@ class StateManager:
     def set_tool_handler(self, handler: "ToolHandler") -> None:
         self._tool_handler = handler
 
-    def add_todo(self, todo: TodoItem) -> None:
-        self._session.todos.append(todo)
-
-    def update_todo(self, todo_id: str, status: str) -> None:
-        from datetime import datetime
-
-        for todo in self._session.todos:
-            if todo.id == todo_id:
-                todo.status = status
-                if status == "completed" and not todo.completed_at:
-                    todo.completed_at = datetime.now()
-                break
-
     def push_recursive_context(self, context: dict[str, Any]) -> None:
         """Push a new context onto the recursive execution stack."""
         self._session.recursive_context_stack.append(context)
@@ -158,11 +149,16 @@ class StateManager:
         self._session.iteration_budgets.clear()
         self._session.recursive_context_stack.clear()
 
-    def remove_todo(self, todo_id: str) -> None:
-        self._session.todos = [todo for todo in self._session.todos if todo.id != todo_id]
+    # React scratchpad helpers
+    def get_react_scratchpad(self) -> dict[str, Any]:
+        return self._session.react_scratchpad
+
+    def append_react_entry(self, entry: dict[str, Any]) -> None:
+        timeline = self._session.react_scratchpad.setdefault("timeline", [])
+        timeline.append(entry)
 
-    def clear_todos(self) -> None:
-        self._session.todos = []
+    def clear_react_scratchpad(self) -> None:
+        self._session.react_scratchpad = {"timeline": []}
 
     def reset_session(self) -> None:
         """Reset the session to a fresh state."""

tunacode/core/token_usage/usage_tracker.py

@@ -37,10 +37,10 @@ class UsageTracker(UsageTrackerProtocol):
             # 2. Calculate the cost
             cost = self._calculate_cost(parsed_data)
 
-            # 3. Update the session state
+            # 3. Update the session state (always done to track totals for session cost display)
             self._update_state(parsed_data, cost)
 
-            # 4. Display the summary if enabled
+            # 4. Display detailed per-call summary only if debugging enabled
             if self.state_manager.session.show_thoughts:
                 await self._display_summary()
 
@@ -136,8 +136,10 @@ class UsageTracker(UsageTrackerProtocol):
         last_cost_safe = last_cost if last_cost is not None else 0.0
         session_cost_safe = session_cost if session_cost is not None else 0.0
 
+        total_tokens = prompt_safe + completion_safe
         usage_summary = (
-            f"[ Tokens: {prompt_safe + completion_safe:,} (P: {prompt_safe:,}, C: {completion_safe:,}) | "
+            f"[ Tokens: {total_tokens:,} "
+            f"(P: {prompt_safe:,}, C: {completion_safe:,}) | "
             f"Cost: ${last_cost_safe:.4f} | "
             f"Session Total: ${session_cost_safe:.4f} ]"
         )