soothe-cli 0.1.0__py3-none-any.whl

soothe_cli/tui/app.tcss

@@ -0,0 +1,302 @@
+/* Deep Agents CLI Textual Stylesheet */
+
+/* Define layers for z-ordering */
+Screen {
+    layout: vertical;
+    layers: base autocomplete;
+}
+
+/* Thin scrollbars app-wide */
+* {
+    scrollbar-size-vertical: 1;
+}
+
+/* Main content goes on base layer by default */
+
+/* Chat area - main scrollable messages area */
+#chat {
+    height: 1fr;
+    padding: 1 2;
+    background: $background;
+}
+
+/* Welcome banner */
+#welcome-banner {
+    height: auto;
+    margin-bottom: 1;
+}
+
+/* Messages area — uses undocumented "stream" layout (Textual ≥5.2.0) for
+   O(1) append performance via incremental placement caching. */
+#messages {
+    layout: stream;
+    height: auto;
+}
+
+/* Bottom app container - holds ChatInput (now inside scroll) */
+#bottom-app-container {
+    height: auto;
+    margin-top: 1;
+    padding: 0 1;
+}
+
+/* Sticky thinking row directly above input box */
+#thinking-status {
+    height: auto;
+    min-height: 1;
+    margin-bottom: 0;
+}
+
+/* Input area */
+#input-area {
+    height: auto;
+    min-height: 3;
+    max-height: 25;
+}
+
+/* Approval Menu - inline in messages area */
+.approval-menu {
+    height: auto;
+    margin: 1 0;
+    padding: 0 1;
+    background: $surface;
+    border: solid $warning;
+}
+
+/* Placeholder shown while the user is actively typing (approval deferred) */
+.approval-placeholder {
+    height: auto;
+    margin: 1 0;
+    padding: 0 1;
+    border: solid $panel;
+    color: $text-muted;
+    text-style: italic;
+}
+
+.approval-menu .approval-title {
+    text-style: bold;
+    color: $warning;
+    margin-bottom: 0;
+}
+
+.approval-menu .approval-info {
+    height: auto;
+    color: $text-muted;
+    margin-bottom: 1;
+}
+
+.approval-menu .approval-option {
+    height: 1;
+    padding: 0 1;
+}
+
+.approval-menu .approval-option-selected {
+    background: $primary;
+    text-style: bold;
+}
+
+.approval-menu .approval-help {
+    color: $text-muted;
+    text-style: italic;
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+/* Status bar */
+#status-bar {
+    height: 1;
+    dock: bottom;
+    margin-bottom: 1;
+}
+
+/* Tool approval widgets */
+.tool-approval-widget {
+    height: auto;
+}
+
+.approval-description {
+    color: $text-muted;
+}
+
+/* Diff styling — used by EditFileApprovalWidget (fg + bg + padding) */
+.diff-removed {
+    height: auto;
+    color: $text-error;
+    background: $error-muted;
+    padding: 0 1;
+}
+
+.diff-added {
+    height: auto;
+    color: $text-success;
+    background: $success-muted;
+    padding: 0 1;
+}
+
+.diff-context {
+    height: auto;
+    color: $text-muted;
+    padding: 0 1;
+}
+
+/* Diff line backgrounds — used by compose_diff_lines (bg only, fg via Content) */
+.diff-line-removed {
+    background: $error-muted;
+}
+
+.diff-line-added {
+    background: $success-muted;
+}
+
+/* Mode-specific borders for UserMessage */
+UserMessage.-mode-shell {
+    border-left: wide $mode-bash;
+}
+
+UserMessage.-mode-command {
+    border-left: wide $mode-command;
+}
+
+/* ASCII border overrides */
+UserMessage.-ascii {
+    border-left: ascii $primary;
+}
+
+UserMessage.-ascii.-mode-shell {
+    border-left: ascii $mode-bash;
+}
+
+UserMessage.-ascii.-mode-command {
+    border-left: ascii $mode-command;
+}
+
+QueuedUserMessage.-ascii {
+    border-left: ascii $panel;
+}
+
+ToolCallMessage.-ascii {
+    border-left: ascii $panel;
+}
+
+ToolCallMessage.-ascii:hover {
+    border-left: ascii $secondary;
+}
+
+/* Approval command — warning color for shell commands */
+.approval-menu .approval-command {
+    height: auto;
+    margin: 0 0 1 0;
+    padding: 0 1;
+    color: $warning;
+}
+
+/* Separator line between tool details and options */
+.approval-menu .approval-separator {
+    height: 1;
+    color: $warning;
+    margin: 0;
+}
+
+/* Scrollable tool info area in approval menu */
+.approval-menu .tool-info-scroll {
+    height: auto;
+    max-height: 10;
+    margin-top: 0;
+}
+
+/* Inner container for tool info - allows content to expand for scrolling */
+.approval-menu .tool-info-container {
+    height: auto;
+}
+
+/* Options container with background */
+.approval-menu .approval-options-container {
+    height: auto;
+    background: $surface-darken-1;
+    padding: 0 1;
+    margin-top: 0;
+}
+
+/* Ask user widget */
+.ask-user-menu {
+    height: auto;
+    margin: 1 0;
+    padding: 0 1;
+    background: $surface;
+    border: solid $success;
+}
+
+.ask-user-menu .ask-user-title {
+    text-style: bold;
+    color: $success;
+    margin-bottom: 0;
+}
+
+.ask-user-menu .ask-user-help {
+    color: $text-muted;
+    text-style: italic;
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+.ask-user-menu .ask-user-questions {
+    height: auto;
+    padding: 0 1;
+}
+
+.ask-user-menu .ask-user-question {
+    height: auto;
+    margin-bottom: 1;
+}
+
+.ask-user-menu .ask-user-question-active {
+    border-left: thick $success;
+    padding-left: 1;
+}
+
+.ask-user-menu .ask-user-question-inactive {
+    opacity: 0.5;
+    padding-left: 2;
+}
+
+.ask-user-menu .ask-user-question-text {
+    margin: 0 0 0 2;
+    padding: 0;
+}
+
+.ask-user-menu .ask-user-choice {
+    height: 1;
+    padding: 0 1;
+}
+
+.ask-user-menu .ask-user-text-input {
+    margin: 1 1 0 1;
+}
+
+.ask-user-menu .ask-user-other-input {
+    margin: 1 1 0 1;
+}
+
+/* ChatTextArea: override TextArea's built-in $surface background */
+ChatTextArea {
+    background: transparent;
+
+    & .text-area--cursor-line {
+        background: transparent;
+    }
+
+    & .text-area--cursor-gutter {
+        background: transparent;
+    }
+}
+
+/* Completion popup styling (used by ChatInput) - appears BELOW input */
+#completion-popup {
+    height: auto;
+    max-height: 12;
+    width: 100%;
+    margin-left: 3;
+    margin-top: 0;
+    padding: 0;
+    color: $text;
+}

soothe_cli/tui/command_registry.py

@@ -0,0 +1,310 @@
+"""Unified slash-command registry.
+
+Every slash command is declared once as a `SlashCommand` entry in `COMMANDS`.
+Bypass-tier frozensets and autocomplete tuples are derived automatically — no
+other file should hard-code command metadata.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from soothe_cli.tui.skills.load import ExtendedSkillMetadata
+
+
+class BypassTier(StrEnum):
+    """Classification that controls whether a command can skip the message queue."""
+
+    ALWAYS = "always"
+    """Execute regardless of any busy state, including mid-thread-switch."""
+
+    CONNECTING = "connecting"
+    """Bypass only during initial server connection, not during agent/shell."""
+
+    IMMEDIATE_UI = "immediate_ui"
+    """Open modal UI immediately; real work deferred via `_defer_action` callback."""
+
+    SIDE_EFFECT_FREE = "side_effect_free"
+    """Execute the side effect immediately; defer chat output until idle."""
+
+    QUEUED = "queued"
+    """Must wait in the queue when the app is busy."""
+
+
+@dataclass(frozen=True, slots=True, kw_only=True)
+class SlashCommand:
+    """A single slash-command definition."""
+
+    name: str
+    """Canonical command name (e.g. `/quit`)."""
+
+    description: str
+    """Short user-facing description."""
+
+    bypass_tier: BypassTier
+    """Queue-bypass classification."""
+
+    hidden_keywords: str = ""
+    """Space-separated terms for fuzzy matching (never displayed)."""
+
+    aliases: tuple[str, ...] = ()
+    """Alternative names (e.g. `("/q",)` for `/quit`)."""
+
+
+COMMANDS: tuple[SlashCommand, ...] = (
+    SlashCommand(
+        name="/autopilot",
+        description="Open autopilot dashboard",
+        bypass_tier=BypassTier.IMMEDIATE_UI,
+        hidden_keywords="goals autonomous",
+    ),
+    SlashCommand(
+        name="/clear",
+        description="Clear chat and start new thread",
+        bypass_tier=BypassTier.QUEUED,
+        hidden_keywords="reset",
+    ),
+    SlashCommand(
+        name="/editor",
+        description="Open prompt in external editor ($EDITOR)",
+        bypass_tier=BypassTier.QUEUED,
+    ),
+    SlashCommand(
+        name="/mcp",
+        description="Show active MCP servers and tools",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+        hidden_keywords="servers",
+    ),
+    SlashCommand(
+        name="/model",
+        description="Switch or configure model (--model-params, --default)",
+        bypass_tier=BypassTier.IMMEDIATE_UI,
+    ),
+    SlashCommand(
+        name="/notifications",
+        description="Configure startup warning preferences",
+        bypass_tier=BypassTier.IMMEDIATE_UI,
+        hidden_keywords="warnings alerts suppress",
+    ),
+    SlashCommand(  # Static alias; not auto-generated from skill discovery
+        name="/remember",
+        description="Update memory and skills from conversation",
+        bypass_tier=BypassTier.QUEUED,
+    ),
+    SlashCommand(
+        name="/threads",
+        description="Browse and resume previous threads",
+        bypass_tier=BypassTier.IMMEDIATE_UI,
+        hidden_keywords="continue history sessions",
+    ),
+    SlashCommand(
+        name="/trace",
+        description="Open current thread in LangSmith",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+    ),
+    SlashCommand(
+        name="/tokens",
+        description="Token usage",
+        bypass_tier=BypassTier.QUEUED,
+        hidden_keywords="cost",
+    ),
+    SlashCommand(
+        name="/reload",
+        description="Reload config from environment variables and .env",
+        bypass_tier=BypassTier.QUEUED,
+        hidden_keywords="refresh",
+    ),
+    SlashCommand(
+        name="/theme",
+        description="Switch color theme",
+        bypass_tier=BypassTier.IMMEDIATE_UI,
+        hidden_keywords="dark light color appearance",
+    ),
+    SlashCommand(
+        name="/update",
+        description="Check for and install updates",
+        bypass_tier=BypassTier.QUEUED,
+        hidden_keywords="upgrade",
+    ),
+    SlashCommand(
+        name="/auto-update",
+        description="Toggle automatic updates on or off",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+    ),
+    SlashCommand(
+        name="/changelog",
+        description="Open changelog in browser",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+    ),
+    SlashCommand(
+        name="/version",
+        description="Show version",
+        bypass_tier=BypassTier.CONNECTING,
+    ),
+    SlashCommand(
+        name="/feedback",
+        description="Submit a bug report or feature request",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+    ),
+    SlashCommand(
+        name="/docs",
+        description="Open documentation in browser",
+        bypass_tier=BypassTier.SIDE_EFFECT_FREE,
+    ),
+    SlashCommand(
+        name="/help",
+        description="Show help",
+        bypass_tier=BypassTier.QUEUED,
+    ),
+    SlashCommand(
+        name="/quit",
+        description="Exit app",
+        bypass_tier=BypassTier.ALWAYS,
+        hidden_keywords="close leave",
+        aliases=("/q",),
+    ),
+)
+"""All slash commands."""
+
+
+# ---------------------------------------------------------------------------
+# Derived bypass-tier frozensets
+# ---------------------------------------------------------------------------
+
+
+def _build_bypass_set(tier: BypassTier) -> frozenset[str]:
+    """Build a frozenset of command names (including aliases) for a tier.
+
+    Args:
+        tier: The bypass tier to collect.
+
+    Returns:
+        Frozenset of all names and aliases that belong to `tier`.
+    """
+    names: set[str] = set()
+    for cmd in COMMANDS:
+        if cmd.bypass_tier == tier:
+            names.add(cmd.name)
+            names.update(cmd.aliases)
+    return frozenset(names)
+
+
+ALWAYS_IMMEDIATE: frozenset[str] = _build_bypass_set(BypassTier.ALWAYS)
+"""Commands that execute regardless of any busy state."""
+
+BYPASS_WHEN_CONNECTING: frozenset[str] = _build_bypass_set(BypassTier.CONNECTING)
+"""Commands that bypass only during initial server connection."""
+
+IMMEDIATE_UI: frozenset[str] = _build_bypass_set(BypassTier.IMMEDIATE_UI)
+"""Commands that open modal UI immediately, deferring real work."""
+
+SIDE_EFFECT_FREE: frozenset[str] = _build_bypass_set(BypassTier.SIDE_EFFECT_FREE)
+"""Commands whose side effect fires immediately; chat output deferred until idle."""
+
+QUEUE_BOUND: frozenset[str] = _build_bypass_set(BypassTier.QUEUED)
+"""Commands that must wait in the queue when the app is busy."""
+
+HIDDEN_DEBUG: frozenset[str] = frozenset({"/debug-error"})
+"""Hidden debug commands not exposed in autocomplete or help."""
+
+ALL_CLASSIFIED: frozenset[str] = (
+    ALWAYS_IMMEDIATE
+    | BYPASS_WHEN_CONNECTING
+    | IMMEDIATE_UI
+    | SIDE_EFFECT_FREE
+    | QUEUE_BOUND
+    | HIDDEN_DEBUG
+)
+"""Union of all tiers plus hidden debug commands — used by drift tests."""
+
+
+# ---------------------------------------------------------------------------
+# Autocomplete tuples
+# ---------------------------------------------------------------------------
+
+SLASH_COMMANDS: list[tuple[str, str, str]] = [
+    (cmd.name, cmd.description, cmd.hidden_keywords) for cmd in COMMANDS
+]
+"""`(name, description, hidden_keywords)` tuples for `SlashCommandController`."""
+
+
+def parse_skill_command(command: str) -> tuple[str, str]:
+    """Extract skill name and args from a `/skill:<name>` command.
+
+    Args:
+        command: The full command string (e.g., `/skill:web-research find X`).
+
+    Returns:
+        Tuple of `(skill_name, args)`.
+
+            The skill name is normalized to lowercase. Both are empty strings
+            when the command has no skill name after the prefix.
+    """
+    after_prefix = command[len("/skill:") :].strip()
+    parts = after_prefix.split(maxsplit=1)
+    if not parts or not parts[0]:
+        return "", ""
+    skill_name = parts[0].lower()
+    args = parts[1] if len(parts) > 1 else ""
+    return skill_name, args
+
+
+_STATIC_SKILL_ALIASES: frozenset[str] = frozenset({"remember"})
+"""Built-in skill names that have a dedicated top-level slash command.
+
+Only list skills whose `/skill:<name>` form is redundant because a `/<name>`
+convenience alias exists in `COMMANDS`.  Do **not** add every command name
+here — that would silently suppress unrelated user skills that happen to share a
+name with a slash command (e.g., a user skill called `model` should still
+appear as `/skill:model`).
+"""
+
+
+def build_skill_commands_from_wire(
+    rows: list[dict[str, Any]],
+) -> list[tuple[str, str, str]]:
+    """Build autocomplete tuples from daemon ``skills_list_response`` rows.
+
+    Args:
+        rows: Wire-safe dicts with at least ``name`` and optional ``description``.
+
+    Returns:
+        Sorted list of ``(name, description, hidden_keywords)`` tuples.
+    """
+    tuples: list[tuple[str, str, str]] = []
+    for row in rows:
+        name = str(row.get("name", "")).strip().lower()
+        if not name or name in _STATIC_SKILL_ALIASES:
+            continue
+        desc = str(row.get("description", "")).strip()
+        tuples.append((f"/skill:{name}", desc, name))
+    tuples.sort(key=lambda t: t[0].lower())
+    return tuples
+
+
+def build_skill_commands(
+    skills: list[ExtendedSkillMetadata],
+) -> list[tuple[str, str, str]]:
+    """Build autocomplete tuples for discovered skills.
+
+    Each skill becomes a `/skill:<name>` entry with its description
+    and the skill name as a hidden keyword for fuzzy matching.
+
+    Skills that already have a dedicated slash command in `COMMANDS`
+    (e.g., `remember` → `/remember`) are excluded to avoid duplicate
+    autocomplete entries.
+
+    Args:
+        skills: List of discovered skill metadata.
+
+    Returns:
+        List of `(name, description, hidden_keywords)` tuples.
+    """
+    return [
+        (f"/skill:{skill['name']}", skill["description"], skill["name"])
+        for skill in skills
+        if skill["name"] not in _STATIC_SKILL_ALIASES
+    ]