"""
JARVIS — Tools API Route
POST /api/tools/execute   — run a tool directly
GET  /api/tools/list      — list available tools
"""

from fastapi import APIRouter, HTTPException
from pydantic import BaseModel
from typing import Optional, Any

from app.tools.tool_executor import execute_tool, TOOL_DEFINITIONS


router = APIRouter()


class ToolRequest(BaseModel):
    tool_name: str
    argument:  str

    class Config:
        json_schema_extra = {
            "example": {
                "tool_name": "calculator",
                "argument": "sqrt(144) + 2**8",
            }
        }


class ToolResponse(BaseModel):
    success:   bool
    result:    str
    tool:      str
    argument:  str
    value:     Optional[Any] = None


@router.post("/execute", response_model=ToolResponse)
async def execute_tool_endpoint(request: ToolRequest):
    """Execute a named tool with an argument."""
    if request.tool_name not in TOOL_DEFINITIONS:
        raise HTTPException(
            status_code=400,
            detail=f"Unknown tool '{request.tool_name}'. Available: {list(TOOL_DEFINITIONS.keys())}",
        )

    result = execute_tool(request.tool_name, request.argument)
    return ToolResponse(
        success=result.get("success", False),
        result=result.get("result", ""),
        tool=result.get("tool", request.tool_name),
        argument=result.get("argument", request.argument),
        value=result.get("value"),
    )


@router.get("/list")
async def list_tools():
    """List all available tools with descriptions."""
    return {
        "tools": [
            {
                "name": t["name"],
                "description": t["description"],
                "example": t["example"],
            }
            for t in TOOL_DEFINITIONS.values()
        ]
    }