Timmy-time-dashboard/src/timmy/cli.py

import logging
import subprocess
import sys

import typer

from timmy.agent import create_timmy
from timmy.prompts import STATUS_PROMPT
from timmy.tool_safety import format_action_description, get_impact_level, is_allowlisted

logger = logging.getLogger(__name__)

app = typer.Typer(help="Timmy — sovereign AI agent")

# Stable session ID — Agno persists conversation history in SQLite keyed on this.
# Every `timmy chat` invocation reuses the same session so context carries over.
_CLI_SESSION_ID = "cli"

# Shared option definitions (reused across commands for consistency).
_BACKEND_OPTION = typer.Option(
    None,
    "--backend",
    "-b",
    help="Inference backend: 'ollama' (default) | 'airllm' | 'auto'",
)
_MODEL_SIZE_OPTION = typer.Option(
    None,
    "--model-size",
    "-s",
    help="AirLLM model size when --backend airllm: '8b' | '70b' | '405b'",
)


def _is_interactive() -> bool:
    """Return True if stdin is a real terminal (human present)."""
    return hasattr(sys.stdin, "isatty") and sys.stdin.isatty()


def _handle_tool_confirmation(agent, run_output, session_id: str, *, autonomous: bool = False):
    """Prompt user to approve/reject dangerous tool calls.

    When Agno pauses a run because a tool requires confirmation, this
    function displays the action, asks for approval via stdin, and
    resumes or rejects the run accordingly.

    When autonomous=True (or stdin is not a terminal), tool calls are
    checked against config/allowlist.yaml instead of prompting.
    Allowlisted calls are auto-approved; everything else is auto-rejected.

    Returns the final RunOutput after all confirmations are resolved.
    """
    interactive = _is_interactive() and not autonomous

    max_rounds = 10  # safety limit
    for _ in range(max_rounds):
        status = getattr(run_output, "status", None)
        is_paused = status == "PAUSED" or str(status) == "RunStatus.paused"
        if not is_paused:
            return run_output

        reqs = getattr(run_output, "active_requirements", None) or []
        if not reqs:
            return run_output

        for req in reqs:
            if not getattr(req, "needs_confirmation", False):
                continue

            te = req.tool_execution
            tool_name = getattr(te, "tool_name", "unknown")
            tool_args = getattr(te, "tool_args", {}) or {}

            if interactive:
                # Human present — prompt for approval
                description = format_action_description(tool_name, tool_args)
                impact = get_impact_level(tool_name)

                typer.echo()
                typer.echo(typer.style("Tool confirmation required", bold=True))
                typer.echo(f"  Impact: {impact.upper()}")
                typer.echo(f"  {description}")
                typer.echo()

                approved = typer.confirm("Allow this action?", default=False)
                if approved:
                    req.confirm()
                    logger.info("CLI: approved %s", tool_name)
                else:
                    req.reject(note="User rejected from CLI")
                    logger.info("CLI: rejected %s", tool_name)
            else:
                # Autonomous mode — check allowlist
                if is_allowlisted(tool_name, tool_args):
                    req.confirm()
                    logger.info("AUTO-APPROVED (allowlist): %s", tool_name)
                else:
                    req.reject(note="Auto-rejected: not in allowlist")
                    logger.info(
                        "AUTO-REJECTED (not allowlisted): %s %s", tool_name, str(tool_args)[:100]
                    )

        # Resume the run so the agent sees the confirmation result
        try:
            run_output = agent.continue_run(
                run_response=run_output, stream=False, session_id=session_id
            )
        except Exception as exc:
            logger.error("CLI: continue_run failed: %s", exc)
            typer.echo(f"Error resuming: {exc}", err=True)
            return run_output

    return run_output


@app.command()
def tick(
    prompt: str | None = typer.Argument(
        None, help="Optional journal prompt for Timmy to reflect on"
    ),
):
    """Run one thinking cycle. Pass a prompt to ask Timmy a specific question."""
    import asyncio

    from timmy.thinking import thinking_engine

    thought = asyncio.run(thinking_engine.think_once(prompt=prompt))
    if thought:
        typer.echo(f"[{thought.seed_type}] {thought.content}")
    else:
        typer.echo("No thought produced (thinking disabled or Ollama down).")


@app.command()
def think(
    topic: str = typer.Argument(..., help="Topic to reason about"),
    backend: str | None = _BACKEND_OPTION,
    model_size: str | None = _MODEL_SIZE_OPTION,
):
    """Ask Timmy to think carefully about a topic."""
    timmy = create_timmy(backend=backend, model_size=model_size, session_id=_CLI_SESSION_ID)
    timmy.print_response(f"Think carefully about: {topic}", stream=True, session_id=_CLI_SESSION_ID)


@app.command()
def chat(
    message: str = typer.Argument(..., help="Message to send"),
    backend: str | None = _BACKEND_OPTION,
    model_size: str | None = _MODEL_SIZE_OPTION,
    new_session: bool = typer.Option(
        False,
        "--new",
        "-n",
        help="Start a fresh conversation (ignore prior context)",
    ),
    session_id: str | None = typer.Option(
        None,
        "--session-id",
        help="Use a specific session ID for this conversation",
    ),
    autonomous: bool = typer.Option(
        False,
        "--autonomous",
        "-a",
        help="Autonomous mode: auto-approve allowlisted tools, reject the rest (no stdin prompts)",
    ),
):
    """Send a message to Timmy.

    Conversation history persists across invocations. Use --new to start fresh,
    or --session-id to use a specific session.

    Use --autonomous for non-interactive contexts (scripts, dev loops). Tool
    calls are checked against config/allowlist.yaml — allowlisted operations
    execute automatically, everything else is safely rejected.
    """
    import uuid

    if session_id is not None:
        pass  # use the provided value
    elif new_session:
        session_id = str(uuid.uuid4())
    else:
        session_id = _CLI_SESSION_ID
    timmy = create_timmy(backend=backend, model_size=model_size, session_id=session_id)

    # Use agent.run() so we can intercept paused runs for tool confirmation.
    run_output = timmy.run(message, stream=False, session_id=session_id)

    # Handle paused runs — dangerous tools need user approval
    run_output = _handle_tool_confirmation(timmy, run_output, session_id, autonomous=autonomous)

    # Print the final response
    content = run_output.content if hasattr(run_output, "content") else str(run_output)
    if content:
        from timmy.session import _clean_response

        typer.echo(_clean_response(content))


@app.command()
def status(
    backend: str | None = _BACKEND_OPTION,
    model_size: str | None = _MODEL_SIZE_OPTION,
):
    """Print Timmy's operational status."""
    timmy = create_timmy(backend=backend, model_size=model_size, session_id=_CLI_SESSION_ID)
    timmy.print_response(STATUS_PROMPT, stream=False, session_id=_CLI_SESSION_ID)


@app.command()
def interview(
    backend: str | None = _BACKEND_OPTION,
    model_size: str | None = _MODEL_SIZE_OPTION,
):
    """Initialize Timmy and run a structured interview.

    Asks Timmy a series of questions about his identity, capabilities,
    values, and operation to verify he is working correctly.
    """
    import asyncio

    from timmy.interview import InterviewEntry, format_transcript, run_interview
    from timmy.session import chat

    typer.echo("Initializing Timmy for interview...\n")

    # Use a single persistent event loop for the entire interview.
    # Calling asyncio.run() per question kills the loop between calls,
    # orphaning MCP stdio transports and causing "Event loop is closed."
    loop = asyncio.new_event_loop()
    asyncio.set_event_loop(loop)

    try:
        # Force agent creation by calling chat once with a warm-up prompt
        try:
            loop.run_until_complete(
                chat("Hello, Timmy. We're about to start your interview.", session_id="interview")
            )
        except Exception as exc:
            typer.echo(f"Warning: Initialization issue — {exc}", err=True)

        def _on_answer(entry: InterviewEntry) -> None:
            typer.echo(f"[{entry.category}]")
            typer.echo(f"  Q: {entry.question}")
            typer.echo(f"  A: {entry.answer}")
            typer.echo()

        typer.echo("Starting interview...\n")
        transcript = run_interview(
            chat_fn=lambda msg: loop.run_until_complete(chat(msg, session_id="interview")),
            on_answer=_on_answer,
        )

        # Print full transcript at the end
        typer.echo("\n" + format_transcript(transcript))
    finally:
        # Clean shutdown: close MCP sessions, then the loop
        try:
            from timmy.mcp_tools import close_mcp_sessions

            loop.run_until_complete(close_mcp_sessions())
        except Exception as exc:
            logger.warning("MCP session close failed: %s", exc)
            pass
        loop.close()


@app.command()
def up(
    dev: bool = typer.Option(False, "--dev", help="Enable hot-reload for development"),
    build: bool = typer.Option(True, "--build/--no-build", help="Rebuild images before starting"),
):
    """Start Timmy Time in Docker (dashboard + agents)."""
    cmd = ["docker", "compose"]
    if dev:
        cmd += ["-f", "docker-compose.yml", "-f", "docker-compose.dev.yml"]
    cmd += ["up", "-d"]
    if build:
        cmd.append("--build")

    mode = "dev mode (hot-reload active)" if dev else "production mode"
    typer.echo(f"Starting Timmy Time in {mode}...")
    result = subprocess.run(cmd)
    if result.returncode == 0:
        typer.echo(f"\n  Timmy Time running at http://localhost:8000  ({mode})\n")
    else:
        typer.echo("Failed to start. Is Docker running?", err=True)
        raise typer.Exit(1)


@app.command()
def down():
    """Stop all Timmy Time Docker containers."""
    subprocess.run(["docker", "compose", "down"], check=True)


@app.command()
def voice(
    whisper_model: str = typer.Option(
        "base.en", "--whisper", "-w", help="Whisper model: tiny.en, base.en, small.en, medium.en"
    ),
    use_say: bool = typer.Option(False, "--say", help="Use macOS `say` instead of Piper TTS"),
    threshold: float = typer.Option(
        0.015, "--threshold", "-t", help="Mic silence threshold (RMS). Lower = more sensitive."
    ),
    silence: float = typer.Option(1.5, "--silence", help="Seconds of silence to end recording"),
    backend: str | None = _BACKEND_OPTION,
    model_size: str | None = _MODEL_SIZE_OPTION,
):
    """Start the sovereign voice loop — listen, think, speak.

    Everything runs locally: Whisper for STT, Ollama for LLM, Piper for TTS.
    No cloud, no network calls, no microphone data leaves your machine.
    """
    from timmy.voice_loop import VoiceConfig, VoiceLoop

    config = VoiceConfig(
        whisper_model=whisper_model,
        use_say_fallback=use_say,
        silence_threshold=threshold,
        silence_duration=silence,
        backend=backend,
        model_size=model_size,
    )
    loop = VoiceLoop(config=config)
    loop.run()


@app.command()
def route(
    message: str = typer.Argument(..., help="Message to route"),
):
    """Show which agent would handle a message (debug routing)."""
    from timmy.agents.loader import route_request_with_match

    agent_id, matched_pattern = route_request_with_match(message)
    if agent_id:
        typer.echo(f"→ {agent_id} (matched: {matched_pattern})")
    else:
        typer.echo("→ orchestrator (no pattern match)")


def main():
    app()