claude-sdk-tutor 0.1.6__tar.gz → 0.1.7__tar.gz

{claude_sdk_tutor-0.1.6 → claude_sdk_tutor-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-sdk-tutor
-Version: 0.1.6
+Version: 0.1.7
 Summary: Add your description here
 License-File: LICENSE
 Requires-Python: >=3.13

{claude_sdk_tutor-0.1.6 → claude_sdk_tutor-0.1.7}/app.py

@@ -11,7 +11,8 @@ from rich.markdown import Markdown as RichMarkdown
 from rich.panel import Panel
 from textual.app import App, ComposeResult
 from textual.containers import Vertical
-from textual.widgets import Static, Footer, Input, RichLog, LoadingIndicator
+from rich.box import ROUNDED
+from textual.widgets import Static, Footer, Input, RichLog
 
 from claude.claude_agent import (
     connect_client,
@@ -21,10 +22,21 @@ from claude.claude_agent import (
 from claude.history import CommandHistory
 from claude.mcp_commands import McpAsyncCommand, McpCommandHandler
 from claude.mcp_config import McpConfigManager
-from claude.widgets import HistoryInput
+from claude.widgets import ASCIISpinner, HistoryInput, StatusBar
+
+
+# Message border colors (vivid)
+USER_COLOR = "#00aaff"      # Vivid cyan-blue
+CLAUDE_COLOR = "#ff3333"    # Vivid red
+TOOL_COLOR = "#cccccc"      # Bright grey
+SYSTEM_COLOR = "#33ff66"    # Vivid green
+
+HEADER_TEXT = "Claude SDK Tutor"
 
 
 class MyApp(App):
+    CSS_PATH = "phosphor.tcss"
+
     def __init__(self):
         super().__init__()
         self.tutor_mode = True
@@ -44,66 +56,71 @@ class MyApp(App):
             mcp_servers=self.mcp_config.get_enabled_servers_for_sdk(),
         )
 
-    CSS = """
-    #main {
-        height: 100%;
-    }
-    Input {
-        height: auto;
-        margin-top: 1;
-        margin-left: 3;
-        margin-right: 3;
-        margin-bottom: 1;
-    }
-    #header {
-        content-align: center middle;
-        width: 100%;
-        margin-top: 1;
-        margin-bottom: 1;
-        height: auto;
-    }
-    RichLog {
-        background: $boost;
-        margin-left: 3;
-        margin-right: 3;
-        height: 1fr;
-    }
-    LoadingIndicator {
-        height: auto;
-        margin-left: 3;
-        margin-right: 3;
-    }
-    """
-
     def compose(self) -> ComposeResult:
         with Vertical(id="main"):
-            yield Static("Welcome to claude SDK tutor!", id="header")
+            yield Static(HEADER_TEXT, id="header")
+            yield StatusBar(id="status-bar")
             yield RichLog(markup=True, highlight=True)
-            yield LoadingIndicator(id="spinner")
-            yield HistoryInput(history=self.history)
+            yield ASCIISpinner(id="spinner")
+            yield HistoryInput(
+                history=self.history,
+                placeholder="Type a message or /help for commands...",
+            )
         yield Footer()
 
     async def on_mount(self) -> None:
-        self.query_one("#spinner", LoadingIndicator).display = False
+        self.query_one("#spinner", ASCIISpinner).display = False
+        self._update_status_bar()
         await connect_client(self.client)
 
+    def _update_status_bar(self) -> None:
+        """Update the status bar with current mode states."""
+        status_bar = self.query_one("#status-bar", StatusBar)
+        status_bar.tutor_on = self.tutor_mode
+        status_bar.web_on = self.web_search_enabled
+        status_bar.mcp_count = len(self.mcp_config.get_enabled_servers_for_sdk())
+
     def write_user_message(self, message: str) -> None:
         log = self.query_one(RichLog)
-        log.write(Panel(RichMarkdown(message), title="You", border_style="dodger_blue1"))
+        log.write(Panel(
+            RichMarkdown(message),
+            title="You",
+            border_style=USER_COLOR,
+            box=ROUNDED,
+            padding=(1, 2),
+        ))
 
     def write_system_message(self, message: str) -> None:
         log = self.query_one(RichLog)
-        log.write(Panel(RichMarkdown(message), title="Claude", border_style="red"))
+        log.write(Panel(
+            RichMarkdown(message),
+            title="Claude",
+            border_style=CLAUDE_COLOR,
+            box=ROUNDED,
+            padding=(1, 2),
+        ))
 
     def write_tool_message(self, name: str, input: dict) -> None:
         log = self.query_one(RichLog)
         input_str = json.dumps(input, indent=2)
         content = f"**{name}**\n```json\n{input_str}\n```"
-        log.write(Panel(RichMarkdown(content), title="Tool", border_style="grey50"))
+        log.write(Panel(
+            RichMarkdown(content),
+            title="Tool",
+            border_style=TOOL_COLOR,
+            box=ROUNDED,
+            padding=(1, 2),
+        ))
 
     def write_slash_message(self, message: str) -> None:
         log = self.query_one(RichLog)
-        log.write(Panel(RichMarkdown(message), title="Slash", border_style="green"))
+        log.write(Panel(
+            RichMarkdown(message),
+            title="System",
+            border_style=SYSTEM_COLOR,
+            box=ROUNDED,
+            padding=(1, 2),
+        ))
 
     def on_input_submitted(self, event: Input.Submitted) -> None:
         command = event.value.strip()
@@ -136,7 +153,7 @@ class MyApp(App):
             self._handle_mcp_command(command)
             return
         self.write_user_message(event.value)
-        self.query_one("#spinner", LoadingIndicator).display = True
+        self.query_one("#spinner", ASCIISpinner).start("Processing query...")
         self._query_running = True
         self.run_worker(self.get_response(event.value))
 
@@ -144,6 +161,7 @@ class MyApp(App):
         self.query_one(RichLog).clear()
         self.client = self._create_client()
         await connect_client(self.client)
+        self._update_status_bar()
         self.write_slash_message("Context cleared")
 
     async def toggle_tutor_mode(self) -> None:
@@ -151,7 +169,8 @@ class MyApp(App):
         self.query_one(RichLog).clear()
         self.client = self._create_client()
         await connect_client(self.client)
-        status = "on" if self.tutor_mode else "off"
+        self._update_status_bar()
+        status = "enabled" if self.tutor_mode else "disabled"
         self.write_slash_message(f"Tutor mode {status}")
 
     async def toggle_web_search(self) -> None:
@@ -159,7 +178,8 @@ class MyApp(App):
         self.query_one(RichLog).clear()
         self.client = self._create_client()
         await connect_client(self.client)
-        status = "on" if self.web_search_enabled else "off"
+        self._update_status_bar()
+        status = "enabled" if self.web_search_enabled else "disabled"
         self.write_slash_message(f"Web search {status}")
 
     def show_help(self) -> None:
@@ -183,7 +203,7 @@ class MyApp(App):
             )
         elif isinstance(result, McpAsyncCommand):
             # Async command needs connection testing
-            self.query_one("#spinner", LoadingIndicator).display = True
+            self.query_one("#spinner", ASCIISpinner).start("Testing MCP connections...")
             self.run_worker(self._test_mcp_connections(result))
         else:
             self.write_slash_message(result)
@@ -236,7 +256,7 @@ class MyApp(App):
         except Exception as e:
             self.write_slash_message(f"**Error** testing MCP connections: {e}")
         finally:
-            self.query_one("#spinner", LoadingIndicator).display = False
+            self.query_one("#spinner", ASCIISpinner).stop()
 
     def _handle_mcp_add_step(self, user_input: str) -> None:
         """Handle a step in the interactive MCP add wizard."""
@@ -330,7 +350,7 @@ class MyApp(App):
                 elif isinstance(message, ResultMessage):
                     pass  # Might want to add logging later
         finally:
-            self.query_one("#spinner", LoadingIndicator).display = False
+            self.query_one("#spinner", ASCIISpinner).stop()
             self._query_running = False
 
     def action_cancel_query(self) -> None:
@@ -347,7 +367,7 @@ class MyApp(App):
             pass  # Ignore errors if not connected or no active query
         finally:
             self._query_running = False
-            self.query_one("#spinner", LoadingIndicator).display = False
+            self.query_one("#spinner", ASCIISpinner).stop()
 
 
 def main():

claude_sdk_tutor-0.1.7/phosphor.tcss

@@ -0,0 +1,122 @@
+/* MINIMAL Theme - Clean, Modern, Professional */
+
+/* Color Variables */
+$bg-primary: #1a1a1a;
+$bg-secondary: #242424;
+$bg-elevated: #2a2a2a;
+$text-primary: #e0e0e0;
+$text-muted: #888888;
+$accent: #5c9fd4;
+$accent-dim: #4a7fa8;
+$border: #333333;
+$border-focus: #555555;
+$success: #6fbf73;
+$warning: #d4a05c;
+
+/* Global App Styling */
+Screen {
+    background: $bg-primary;
+}
+
+/* Main Container */
+#main {
+    height: 100%;
+    background: $bg-primary;
+}
+
+/* Header */
+#header {
+    content-align: center middle;
+    width: 100%;
+    padding: 1 0;
+    height: auto;
+    color: $text-primary;
+    text-style: bold;
+    background: $bg-primary;
+}
+
+/* Status Bar */
+#status-bar {
+    content-align: center middle;
+    width: 100%;
+    height: auto;
+    padding-bottom: 1;
+    color: $text-muted;
+    background: $bg-primary;
+}
+
+/* Message Log */
+RichLog {
+    background: $bg-secondary;
+    margin-left: 2;
+    margin-right: 2;
+    height: 1fr;
+    border: round $border;
+    scrollbar-color: $border;
+    scrollbar-color-hover: $border-focus;
+    scrollbar-color-active: $accent;
+}
+
+/* Spinner */
+#spinner {
+    height: auto;
+    margin-left: 2;
+    margin-right: 2;
+    color: $text-muted;
+    background: $bg-primary;
+}
+
+/* Input Field */
+HistoryInput {
+    height: auto;
+    margin-top: 1;
+    margin-left: 2;
+    margin-right: 2;
+    margin-bottom: 1;
+    background: $bg-elevated;
+    color: $text-primary;
+    border: round $border;
+}
+
+HistoryInput:focus {
+    border: round $accent-dim;
+}
+
+HistoryInput > .input--cursor {
+    color: $bg-primary;
+    background: $accent;
+}
+
+HistoryInput > .input--placeholder {
+    color: $text-muted;
+}
+
+/* Footer */
+Footer {
+    background: $bg-secondary;
+    color: $text-muted;
+}
+
+Footer > .footer--key {
+    background: $bg-elevated;
+    color: $text-primary;
+}
+
+Footer > .footer--description {
+    color: $text-muted;
+}
+
+FooterKey {
+    background: $bg-elevated;
+    color: $text-primary;
+}
+
+FooterKey:hover {
+    background: $accent-dim;
+    color: $bg-primary;
+}
+
+/* Hide the default loading indicator */
+LoadingIndicator {
+    display: none;
+}

{claude_sdk_tutor-0.1.6 → claude_sdk_tutor-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-sdk-tutor"
-version = "0.1.6"
+version = "0.1.7"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.13"

claude_sdk_tutor-0.1.7/src/claude/widgets.py

@@ -0,0 +1,87 @@
+from textual.binding import Binding
+from textual.reactive import reactive
+from textual.widgets import Input, Static
+
+from claude.history import CommandHistory
+
+
+class StatusBar(Static):
+    """Reactive status bar showing tutor/web/mcp states."""
+
+    tutor_on: reactive[bool] = reactive(True)
+    web_on: reactive[bool] = reactive(False)
+    mcp_count: reactive[int] = reactive(0)
+
+    def render(self) -> str:
+        tutor = "on" if self.tutor_on else "off"
+        web = "on" if self.web_on else "off"
+        mcp = f"{self.mcp_count} server{'s' if self.mcp_count != 1 else ''}"
+        return f"tutor: {tutor}  ·  web: {web}  ·  mcp: {mcp}"
+
+
+class ASCIISpinner(Static):
+    """Minimal spinner that cycles through frames with a label."""
+
+    SPINNER_FRAMES = ["·  ", "·· ", "···", " ··", "  ·", "   "]
+
+    _frame: reactive[int] = reactive(0)
+    _label: reactive[str] = reactive("")
+    _running: reactive[bool] = reactive(False)
+
+    def __init__(self, label: str = "Processing...", **kwargs):
+        super().__init__(**kwargs)
+        self._label = label
+        self._timer = None
+
+    def render(self) -> str:
+        if not self._running:
+            return ""
+        frame = self.SPINNER_FRAMES[self._frame % len(self.SPINNER_FRAMES)]
+        return f"{frame} {self._label}"
+
+    def start(self, label: str = "Processing query...") -> None:
+        """Start the spinner animation."""
+        self._label = label
+        self._running = True
+        self._frame = 0
+        self.display = True
+        if self._timer is None:
+            self._timer = self.set_interval(0.1, self._advance_frame)
+
+    def stop(self) -> None:
+        """Stop the spinner animation."""
+        self._running = False
+        self.display = False
+        if self._timer is not None:
+            self._timer.stop()
+            self._timer = None
+
+    def _advance_frame(self) -> None:
+        """Advance to the next spinner frame."""
+        if self._running:
+            self._frame = (self._frame + 1) % len(self.SPINNER_FRAMES)
+
+
+class HistoryInput(Input):
+    """Input widget with command history navigation."""
+
+    BINDINGS = [
+        Binding("up", "history_previous", "Previous command", show=False),
+        Binding("down", "history_next", "Next command", show=False),
+        Binding("escape", "app.cancel_query", "Cancel", show=False),
+        Binding("ctrl+c", "app.cancel_query", "Cancel", show=False),
+    ]
+
+    def __init__(self, history: CommandHistory, **kwargs):
+        super().__init__(**kwargs)
+        self.history = history
+
+    def action_history_previous(self) -> None:
+        """Navigate to previous command in history."""
+        self.value = self.history.navigate_up(self.value)
+        self.cursor_position = len(self.value)
+
+    def action_history_next(self) -> None:
+        """Navigate to next command in history."""
+        self.value = self.history.navigate_down(self.value)
+        self.cursor_position = len(self.value)

{claude_sdk_tutor-0.1.6 → claude_sdk_tutor-0.1.7}/uv.lock

@@ -206,7 +206,7 @@ wheels = [
 
 [[package]]
 name = "claude-sdk-tutor"
-version = "0.1.5"
+version = "0.1.6"
 source = { editable = "." }
 dependencies = [
     { name = "claude-agent-sdk" },

claude_sdk_tutor-0.1.6/src/claude/widgets.py

@@ -1,29 +0,0 @@
-from textual.binding import Binding
-from textual.widgets import Input
-
-from claude.history import CommandHistory
-
-
-class HistoryInput(Input):
-    """Input widget with command history navigation."""
-
-    BINDINGS = [
-        Binding("up", "history_previous", "Previous command", show=False),
-        Binding("down", "history_next", "Next command", show=False),
-        Binding("escape", "app.cancel_query", "Cancel", show=False),
-        Binding("ctrl+c", "app.cancel_query", "Cancel", show=False),
-    ]
-
-    def __init__(self, history: CommandHistory, **kwargs):
-        super().__init__(**kwargs)
-        self.history = history
-
-    def action_history_previous(self) -> None:
-        """Navigate to previous command in history."""
-        self.value = self.history.navigate_up(self.value)
-        self.cursor_position = len(self.value)
-
-    def action_history_next(self) -> None:
-        """Navigate to next command in history."""
-        self.value = self.history.navigate_down(self.value)
-        self.cursor_position = len(self.value)