vibecore 0.2.0__py3-none-any.whl

vibecore/main.py

@@ -0,0 +1,506 @@
+import asyncio
+import traceback
+from collections import deque
+from typing import ClassVar, Literal
+
+from agents import (
+    Agent,
+    ModelSettings,
+    Runner,
+    RunResultStreaming,
+    StreamEvent,
+    TResponseInputItem,
+)
+from openai.types import Reasoning
+from openai.types.responses.response_output_message import Content
+from textual import log, work
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.reactive import reactive
+from textual.widgets import Header
+from textual.worker import Worker
+
+from vibecore.context import VibecoreContext
+from vibecore.handlers import AgentStreamHandler
+from vibecore.session import JSONLSession
+from vibecore.session.loader import SessionLoader
+from vibecore.settings import settings
+from vibecore.utils.text import TextExtractor
+from vibecore.widgets.core import AppFooter, MainScroll, MyTextArea
+from vibecore.widgets.info import Welcome
+from vibecore.widgets.messages import AgentMessage, BaseMessage, MessageStatus, SystemMessage, UserMessage
+
+AgentStatus = Literal["idle", "running"]
+
+
+def detect_reasoning_effort(prompt: str) -> Literal["low", "medium", "high"] | None:
+    """Detect reasoning effort level from user prompt keywords.
+
+    Args:
+        prompt: User input text
+
+    Returns:
+        Reasoning effort level or None if no keywords detected
+    """
+    prompt_lower = prompt.lower()
+
+    # Check for highest priority keywords first
+    if "ultrathink" in prompt_lower:
+        return "high"
+    elif "think hard" in prompt_lower:
+        return "medium"
+    elif "think" in prompt_lower:
+        return "low"
+
+    return None
+
+
+class VibecoreApp(App):
+    """A Textual app to manage stopwatches."""
+
+    CSS_PATH: ClassVar = [
+        "widgets/core.tcss",
+        "widgets/messages.tcss",
+        "widgets/tool_messages.tcss",
+        "widgets/expandable.tcss",
+        "widgets/info.tcss",
+        "main.tcss",
+    ]
+    BINDINGS: ClassVar = [
+        ("ctrl+shift+d", "toggle_dark", "Toggle dark mode"),
+        Binding("escape", "cancel_agent", "Cancel agent", show=False),
+        Binding("ctrl+d", "exit_confirm", "Exit", show=False),
+    ]
+
+    agent_status = reactive[AgentStatus]("idle")
+    _exit_confirmation_active = False
+    _exit_confirmation_task: asyncio.Task | None = None
+
+    def __init__(
+        self,
+        context: VibecoreContext,
+        agent: Agent,
+        session_id: str | None = None,
+        print_mode: bool = False,
+    ) -> None:
+        """Initialize the Vibecore app with context and agent.
+
+        Args:
+            context: The VibecoreContext instance
+            agent: The Agent instance to use
+            session_id: Optional session ID to load existing session
+            print_mode: Whether to run in print mode (useful for pipes)
+        """
+        self.context = context
+        self.context.app = self  # Set the app reference in context
+        self.agent = agent
+        self.input_items: list[TResponseInputItem] = []
+        self.current_result: RunResultStreaming | None = None
+        self.current_worker: Worker[None] | None = None
+        self._session_id_provided = session_id is not None  # Track if continuing session
+        self.print_mode = print_mode
+        self.message_queue: deque[str] = deque()  # Queue for user messages
+
+        # Initialize session based on settings
+        if settings.session.storage_type == "jsonl":
+            if session_id is None:
+                # Generate a new session ID based on current date/time
+                import datetime
+
+                session_id = f"chat-{datetime.datetime.now().strftime('%Y%m%d-%H%M%S')}"
+
+            self.session = JSONLSession(
+                session_id=session_id,
+                project_path=None,  # Will use current working directory
+                base_dir=settings.session.base_dir,
+            )
+        else:
+            raise NotImplementedError("SQLite session support will be added later")
+
+        super().__init__()
+
+    def compose(self) -> ComposeResult:
+        """Create child widgets for the app."""
+        yield Header()
+        yield AppFooter()
+        with MainScroll(id="messages"):
+            yield Welcome()
+
+    async def on_mount(self) -> None:
+        """Called when the app is mounted."""
+        # Connect to MCP servers if configured
+        if self.context.mcp_manager:
+            try:
+                await self.context.mcp_manager.connect()
+                log(f"Connected to {len(self.context.mcp_manager.servers)} MCP servers")
+            except Exception as e:
+                log(f"Failed to connect to MCP servers: {e}")
+                # Continue without MCP servers rather than crashing
+
+        # Load session history if we're continuing from a previous session
+        if self._session_id_provided:
+            await self.load_session_history()
+
+    async def on_unmount(self) -> None:
+        """Called when the app is being unmounted (shutdown)."""
+        # Cleanup MCP servers during unmount
+        if self.context.mcp_manager:
+            try:
+                log("Disconnecting from MCP servers...")
+                await self.context.mcp_manager.disconnect()
+                log("Disconnected from MCP servers")
+            except Exception as e:
+                log(f"Error disconnecting from MCP servers during unmount: {e}")
+
+    def extract_text_from_content(self, content: list[Content]) -> str:
+        """Extract text from various content formats."""
+        return TextExtractor.extract_from_content(content)
+
+    async def add_message(self, message: BaseMessage) -> None:
+        """Add a message widget to the main scroll area.
+
+        Args:
+            message: The message to add
+        """
+        main_scroll = self.query_one("#messages", MainScroll)
+        await main_scroll.mount(message)
+
+    async def handle_agent_message(self, message: BaseMessage) -> None:
+        """Add a message widget to the main scroll area."""
+        await self.add_message(message)
+
+    async def handle_agent_update(self, new_agent: Agent) -> None:
+        """Handle agent updates."""
+        log(f"Agent updated: {new_agent.name}")
+        self.agent = new_agent
+
+    async def handle_agent_error(self, error: Exception) -> None:
+        """Handle errors during streaming."""
+        log(f"Error during agent response: {type(error).__name__}: {error!s}")
+
+        # Create an error message for the user
+        error_msg = f"❌ Error: {type(error).__name__}"
+        if str(error):
+            error_msg += f"\n\n{error!s}"
+
+        error_msg += f"\n\n```\n{traceback.format_exc()}\n```"
+
+        # Display the error to the user
+        # TODO(serialx): Use a dedicated error message widget
+        error_agent_msg = AgentMessage(error_msg, status=MessageStatus.ERROR)
+        await self.add_message(error_agent_msg)
+
+    async def handle_agent_finished(self) -> None:
+        """Handle when the agent has finished processing."""
+        # Remove the last agent message if it is still executing (which means the agent run was cancelled)
+        main_scroll = self.query_one("#messages", MainScroll)
+        try:
+            last_message = main_scroll.query_one("BaseMessage:last-child", BaseMessage)
+            if last_message.status == MessageStatus.EXECUTING:
+                last_message.remove()
+        except Exception:
+            # No messages to clean up
+            pass
+
+    async def load_session_history(self) -> None:
+        """Load and display messages from session history."""
+        loader = SessionLoader(self.session)
+        messages = await loader.load_history()
+
+        # Remove Welcome widget if we have messages
+        if messages:
+            welcome = self.query_one("#messages").query("Welcome")
+            if welcome:
+                welcome.first().remove()
+
+        # Add all messages to the UI
+        for message in messages:
+            await self.add_message(message)
+
+    def watch_agent_status(self, _old_status: AgentStatus, new_status: AgentStatus) -> None:
+        """React to agent_status changes."""
+        footer = self.query_one(AppFooter)
+        if new_status == "running":
+            footer.show_loading()
+        else:
+            footer.hide_loading()
+
+    async def on_my_text_area_user_message(self, event: MyTextArea.UserMessage) -> None:
+        """Handle user messages from the text area."""
+        if event.text:
+            # Check for special commands
+            text_strip = event.text.strip()
+            if text_strip == "/clear":
+                await self.handle_clear_command()
+                return
+            elif text_strip == "/help":
+                help_text = "Available commands:\n"
+                help_text += "• /clear - Clear the current session and start a new one\n"
+                help_text += "• /help - Show this help message\n\n"
+                help_text += "Keyboard shortcuts:\n"
+                help_text += "• Esc - Cancel current agent operation\n"
+                help_text += "• Ctrl+Shift+D - Toggle dark/light mode\n"
+                help_text += "• Up/Down arrows - Navigate message history\n"
+                await self.add_message(SystemMessage(help_text))
+                return
+
+            user_message = UserMessage(event.text)
+            await self.add_message(user_message)
+            user_message.scroll_visible()
+
+            # If agent is running, queue the message
+            if self.agent_status == "running":
+                self.message_queue.append(event.text)
+                log(f"Message queued: {event.text}")
+                footer = self.query_one(AppFooter)
+                # Update the loading message to show queued messages
+                queued_count = len(self.message_queue)
+                footer.show_loading(
+                    status="Generating…", metadata=f"{queued_count} message{'s' if queued_count > 1 else ''} queued"
+                )
+            else:
+                # Detect reasoning effort from prompt keywords
+                detected_effort = detect_reasoning_effort(event.text)
+                reasoning_effort = detected_effort or settings.reasoning_effort
+
+                # Create agent with appropriate reasoning effort
+                agent_to_use = self.agent
+                if reasoning_effort is not None:
+                    # Create a copy of the agent with updated model settings
+                    current_settings = self.agent.model_settings or ModelSettings()
+                    new_reasoning = Reasoning(effort=reasoning_effort, summary="auto")
+                    updated_settings = ModelSettings(
+                        include_usage=current_settings.include_usage,
+                        reasoning=new_reasoning,
+                    )
+                    agent_to_use = Agent[VibecoreContext](
+                        name=self.agent.name,
+                        handoff_description=self.agent.handoff_description,
+                        instructions=self.agent.instructions,
+                        tools=self.agent.tools,
+                        model=self.agent.model,
+                        model_settings=updated_settings,
+                        handoffs=self.agent.handoffs,
+                        mcp_servers=self.agent.mcp_servers,
+                    )
+
+                # Process the message immediately
+                result = Runner.run_streamed(
+                    agent_to_use,
+                    input=event.text,  # Pass string directly when using session
+                    context=self.context,
+                    max_turns=settings.max_turns,
+                    session=self.session,
+                )
+
+                self.current_worker = self.handle_streamed_response(result)
+
+    @work(exclusive=True)
+    async def handle_streamed_response(self, result: RunResultStreaming) -> None:
+        self.agent_status = "running"
+        self.current_result = result
+
+        self.agent_stream_handler = AgentStreamHandler(self)
+        await self.agent_stream_handler.process_stream(result)
+
+        used = result.context_wrapper.usage.total_tokens
+        max_ctx = self._get_model_context_window()
+        log(f"Context usage: {used} / {max_ctx} total tokens")
+        self.context.context_fullness = min(1.0, float(used) / float(max_ctx))
+        footer = self.query_one(AppFooter)
+        footer.set_context_progress(self.context.context_fullness)
+
+        self.agent_status = "idle"
+        self.current_result = None
+        self.current_worker = None
+
+        await self.process_message_queue()
+
+    async def process_message_queue(self) -> None:
+        """Process any messages that were queued while the agent was running."""
+        if self.message_queue:
+            # Get the next message from the queue
+            next_message = self.message_queue.popleft()
+            log(f"Processing queued message: {next_message}")
+
+            # Process the message
+            result = Runner.run_streamed(
+                self.agent,
+                input=next_message,
+                context=self.context,
+                max_turns=settings.max_turns,
+                session=self.session,
+            )
+
+            self.current_worker = self.handle_streamed_response(result)
+
+    def on_click(self) -> None:
+        self.query_one("#input-textarea").focus()
+
+    def _get_model_context_window(self) -> int:
+        from vibecore.settings import settings
+
+        model_name = settings.default_model
+        log(f"Getting context window for model: {model_name}")
+        return 200000
+
+    def action_toggle_dark(self) -> None:
+        """An action to toggle dark mode."""
+        self.theme = "textual-dark" if self.theme == "textual-light" else "textual-light"
+
+    def action_cancel_agent(self) -> None:
+        """Cancel the current agent run."""
+        if self.agent_status == "running":
+            log("Cancelling agent run")
+            if self.current_result:
+                self.current_result.cancel()
+            if self.current_worker:
+                self.current_worker.cancel()
+
+    async def action_exit_confirm(self) -> None:
+        """Handle Ctrl-D press for exit confirmation."""
+        if self._exit_confirmation_active:
+            # Second Ctrl-D within the timeframe - exit the app
+            self.exit()
+        else:
+            # First Ctrl-D - show confirmation message
+            self._exit_confirmation_active = True
+
+            # Cancel any existing confirmation task
+            if self._exit_confirmation_task and not self._exit_confirmation_task.done():
+                self._exit_confirmation_task.cancel()
+
+            # Show confirmation message
+            confirmation_msg = SystemMessage("Press Ctrl-D again to exit")
+            await self.add_message(confirmation_msg)
+
+            # Start the 1-second timer
+            self._exit_confirmation_task = asyncio.create_task(self._reset_exit_confirmation(confirmation_msg))
+
+    async def _reset_exit_confirmation(self, confirmation_msg: SystemMessage) -> None:
+        """Reset exit confirmation after 1 second and remove the message."""
+        try:
+            # Wait for 1 second
+            await asyncio.sleep(1.0)
+
+            # Reset confirmation state
+            self._exit_confirmation_active = False
+
+            # Remove the confirmation message
+            confirmation_msg.remove()
+        except asyncio.CancelledError:
+            # Task was cancelled (new Ctrl-D pressed)
+            pass
+
+    async def run_print(self, prompt: str | None = None) -> str:
+        """Run the agent and return the raw output for printing.
+
+        Args:
+            prompt: Optional prompt text. If not provided, reads from stdin.
+
+        Returns:
+            The agent's text output as a string
+        """
+        import sys
+
+        # Use provided prompt or read from stdin
+        input_text = prompt.strip() if prompt else sys.stdin.read().strip()
+
+        if not input_text:
+            return ""
+
+        # Import needed event types
+        from agents import RawResponsesStreamEvent
+        from openai.types.responses import ResponseTextDeltaEvent
+
+        if self.context.mcp_manager:
+            await self.context.mcp_manager.connect()
+
+        # Run the agent
+        result = Runner.run_streamed(
+            self.agent,
+            input=input_text,
+            context=self.context,
+            max_turns=settings.max_turns,
+            session=self.session,
+        )
+
+        # Collect all agent text output
+        agent_output = ""
+
+        async for event in result.stream_events():
+            # Handle text output from agent
+            match event:
+                case RawResponsesStreamEvent(data=data):
+                    match data:
+                        case ResponseTextDeltaEvent(delta=delta) if delta:
+                            agent_output += delta
+
+        if self.context.mcp_manager:
+            await self.context.mcp_manager.disconnect()
+
+        return agent_output.strip()
+
+    async def handle_task_tool_event(self, tool_name: str, tool_call_id: str, event: StreamEvent) -> None:
+        """Handle streaming events from task tool sub-agents.
+
+        Args:
+            tool_name: Name of the tool (e.g., "task")
+            tool_call_id: Unique identifier for this tool call
+            event: The streaming event from the sub-agent
+
+        Note: The main app receives this event from the agent's task tool handler.
+        """
+        await self.agent_stream_handler.handle_task_tool_event(tool_name, tool_call_id, event)
+
+    async def handle_clear_command(self) -> None:
+        """Handle the /clear command to create a new session and clear the UI."""
+        log("Clearing session and creating new session")
+
+        # Cancel any running agent
+        if self.agent_status == "running":
+            self.action_cancel_agent()
+
+        # Clear message queue
+        self.message_queue.clear()
+
+        # Generate a new session ID
+        import datetime
+
+        new_session_id = f"chat-{datetime.datetime.now().strftime('%Y%m%d-%H%M%S')}"
+
+        # Create new session
+        if settings.session.storage_type == "jsonl":
+            self.session = JSONLSession(
+                session_id=new_session_id,
+                project_path=None,  # Will use current working directory
+                base_dir=settings.session.base_dir,
+            )
+        else:
+            raise NotImplementedError("SQLite session support will be added later")
+
+        # Reset context state
+        self.context.reset_state()
+
+        # Clear input items
+        self.input_items.clear()
+
+        # Clear the UI - remove all messages and add welcome back
+        main_scroll = self.query_one("#messages", MainScroll)
+
+        # Remove all existing messages
+        for message in main_scroll.query("BaseMessage"):
+            message.remove()
+
+        # Remove welcome if it exists
+        for welcome in main_scroll.query("Welcome"):
+            welcome.remove()
+
+        # Add welcome widget back
+        await main_scroll.mount(Welcome())
+
+        # Show system message to confirm the clear operation
+        system_message = SystemMessage(f"✨ Session cleared! Started new session: {new_session_id}")
+        await main_scroll.mount(system_message)
+
+        log(f"New session created: {new_session_id}")

vibecore/mcp/__init__.py

@@ -0,0 +1,6 @@
+"""MCP (Model Context Protocol) integration for Vibecore."""
+
+from .manager import MCPManager
+from .server_wrapper import NameOverridingMCPServer
+
+__all__ = ["MCPManager", "NameOverridingMCPServer"]

vibecore/mcp/manager.py

@@ -0,0 +1,167 @@
+"""MCP server management for Vibecore."""
+
+from typing import TYPE_CHECKING, Any
+
+from agents import Tool
+from agents.mcp import (
+    MCPServer,
+    MCPServerSse,
+    MCPServerSseParams,
+    MCPServerStdio,
+    MCPServerStdioParams,
+    MCPServerStreamableHttp,
+    MCPServerStreamableHttpParams,
+    MCPUtil,
+    create_static_tool_filter,
+)
+from agents.run_context import RunContextWrapper
+from textual import log
+
+from vibecore.settings import MCPServerConfig
+
+from .server_wrapper import NameOverridingMCPServer
+
+if TYPE_CHECKING:
+    from agents import AgentBase
+
+
+class MCPManager:
+    """Manages MCP server connections and tool discovery."""
+
+    def __init__(self, server_configs: list[MCPServerConfig]):
+        """Initialize the MCP manager.
+
+        Args:
+            server_configs: List of MCP server configurations.
+        """
+        self.server_configs = server_configs
+        self.servers: list[MCPServer] = []
+        self._connected = False
+        self._server_contexts: list[Any] = []  # Store context managers
+
+        # Create servers immediately and wrap them
+        for config in self.server_configs:
+            actual_server = self._create_server(config)
+            # Wrap the server to override tool names
+            wrapped_server = NameOverridingMCPServer(actual_server)
+            self.servers.append(wrapped_server)
+
+    async def connect(self) -> None:
+        """Connect to all configured MCP servers."""
+        if self._connected:
+            return
+
+        for server in self.servers:
+            await server.connect()
+
+        self._connected = True
+
+    async def disconnect(self) -> None:
+        """Disconnect from all MCP servers."""
+        if not self._connected:
+            return
+
+        # Disconnect all servers sequentially to avoid anyio cancel scope issues
+        # anyio doesn't allow cancel scopes to be exited in a different task
+        for server in self.servers:
+            try:
+                log(f"Disconnecting from MCP server: {server.name}")
+                # Give each server 3 seconds to cleanup gracefully
+                # await asyncio.wait_for(server.cleanup(), timeout=3.0)
+                await server.cleanup()
+                log(f"Disconnected from MCP server: {server.name}")
+            except TimeoutError:
+                log(f"Timeout disconnecting from MCP server: {server.name}")
+            except Exception as e:
+                log(f"Error disconnecting from MCP server {server.name}: {e}")
+
+        # Clear the servers list to prevent any further operations
+        # self.servers.clear()
+        self._connected = False
+
+    async def get_tools(self, run_context: RunContextWrapper[Any], agent: "AgentBase") -> list[Tool]:
+        """Get all tools from connected MCP servers.
+
+        Args:
+            run_context: The current run context.
+            agent: The agent requesting tools.
+
+        Returns:
+            List of tools from all connected MCP servers.
+        """
+        if not self._connected:
+            await self.connect()
+
+        # Get all tools using MCPUtil which handles the wrapped servers
+        return await MCPUtil.get_all_function_tools(
+            servers=self.servers,
+            convert_schemas_to_strict=True,
+            run_context=run_context,
+            agent=agent,
+        )
+
+    def _create_server(self, config: MCPServerConfig) -> MCPServer:
+        """Create an MCP server instance from configuration.
+
+        Args:
+            config: MCP server configuration.
+
+        Returns:
+            Configured MCP server instance.
+        """
+        tool_filter = create_static_tool_filter(
+            allowed_tool_names=config.allowed_tools,
+            blocked_tool_names=config.blocked_tools,
+        )
+
+        if config.type == "stdio":
+            if not config.command:
+                raise ValueError(f"stdio server '{config.name}' requires a command")
+
+            return MCPServerStdio(
+                name=config.name,
+                params=MCPServerStdioParams(
+                    command=config.command,
+                    args=config.args,
+                    env=config.env,
+                ),
+                cache_tools_list=config.cache_tools,
+                client_session_timeout_seconds=config.timeout_seconds,
+                tool_filter=tool_filter,
+            )
+
+        elif config.type == "sse":
+            if not config.url:
+                raise ValueError(f"SSE server '{config.name}' requires a URL")
+
+            return MCPServerSse(
+                name=config.name,
+                params=MCPServerSseParams(url=config.url),
+                cache_tools_list=config.cache_tools,
+                client_session_timeout_seconds=config.timeout_seconds,
+                tool_filter=tool_filter,
+            )
+
+        elif config.type == "http":
+            if not config.url:
+                raise ValueError(f"HTTP server '{config.name}' requires a URL")
+
+            return MCPServerStreamableHttp(
+                name=config.name,
+                params=MCPServerStreamableHttpParams(url=config.url),
+                cache_tools_list=config.cache_tools,
+                client_session_timeout_seconds=config.timeout_seconds,
+                tool_filter=tool_filter,
+            )
+
+        else:
+            raise ValueError(f"Unknown MCP server type: {config.type}")
+
+    async def __aenter__(self) -> "MCPManager":
+        """Enter async context manager."""
+        await self.connect()
+        return self
+
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
+        """Exit async context manager."""
+        await self.disconnect()